poc: create initial skeleton of api

apps/platform/api/.gitignore

@@ -0,0 +1,65 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules
+jspm_packages
+
+# Optional npm cache directory
+.npm
+
+# Optional REPL history
+.node_repl_history
+
+# 0x
+profile-*
+
+# mac files
+.DS_Store
+
+# vim swap files
+*.swp
+
+# webstorm
+.idea
+
+# vscode
+.vscode
+*code-workspace
+
+# clinic
+profile*
+*clinic*
+*flamegraph*
+
+# generated code
+examples/typescript-server.js
+test/types/index.js
+
+# compiled app
+dist

apps/platform/api/.prettierrc.js

@@ -0,0 +1,11 @@
+module.exports = {
+  printWidth: 100,
+  tabWidth: 2,
+  useTabs: false,
+  semi: true,
+  singleQuote: true,
+  trailingComma: 'all',
+  bracketSpacing: true,
+  jsxBracketSameLine: false,
+  arrowParens: 'always',
+};

apps/platform/api/.taprc

@@ -0,0 +1,5 @@
+test-env: [
+  TS_NODE_FILES=true,
+  TS_NODE_PROJECT=./test/tsconfig.json
+]
+timeout: 120

apps/platform/api/README.md

@@ -0,0 +1,23 @@
+# Getting Started with [Fastify-CLI](https://www.npmjs.com/package/fastify-cli)
+This project was bootstrapped with Fastify-CLI.
+
+## Available Scripts
+
+In the project directory, you can run:
+
+### `npm run dev`
+
+To start the app in dev mode.\
+Open [http://localhost:3000](http://localhost:3000) to view it in the browser.
+
+### `npm start`
+
+For production mode
+
+### `npm run test`
+
+Run the test cases.
+
+## Learn More
+
+To learn Fastify, check out the [Fastify documentation](https://www.fastify.io/docs/latest/).

apps/platform/api/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "api",
+  "version": "1.0.0",
+  "description": "This project was bootstrapped with Fastify-CLI.",
+  "main": "app.ts",
+  "directories": {
+    "test": "test"
+  },
+  "scripts": {
+    "test": "npm run build:ts && tsc -p test/tsconfig.json && tap --ts \"test/**/*.test.ts\"",
+    "start": "npm run build:ts && fastify start -l info dist/app.js",
+    "build:ts": "tsc",
+    "watch:ts": "tsc -w",
+    "dev": "npm run build:ts && concurrently -k -p \"[{name}]\" -n \"TypeScript,App\" -c \"yellow.bold,cyan.bold\" \"npm:watch:ts\" \"npm:dev:start\"",
+    "dev:start": "fastify start --ignore-watch=.ts$ -w -l info -P dist/app.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@fastify/autoload": "^5.0.0",
+    "@fastify/sensible": "^5.0.0",
+    "fastify": "^4.0.0",
+    "fastify-cli": "^5.8.0",
+    "fastify-plugin": "^4.0.0",
+    "kysely": "^0.26.3",
+    "pg": "^8.11.3",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.4.4",
+    "@types/pg": "^8.10.7",
+    "@types/tap": "^15.0.5",
+    "concurrently": "^7.0.0",
+    "fastify-tsconfig": "^1.0.1",
+    "kysely-codegen": "^0.11.0",
+    "prisma-kysely": "^1.7.1",
+    "tap": "^16.1.0",
+    "ts-node": "^10.4.0",
+    "typescript": "^5.2.2"
+  }
+}

apps/platform/api/src/app.ts

@@ -0,0 +1,32 @@
+import type { AutoloadPluginOptions } from '@fastify/autoload';
+import AutoLoad from '@fastify/autoload';
+import type { FastifyPluginAsync, FastifyServerOptions } from 'fastify';
+import { join } from 'path';
+
+export interface AppOptions extends FastifyServerOptions, Partial<AutoloadPluginOptions> {}
+// Pass --options via CLI arguments in command to enable these options.
+const options: AppOptions = {};
+
+const app: FastifyPluginAsync<AppOptions> = async (fastify, opts): Promise<void> => {
+  // Place here your custom code!
+
+  // Do not touch the following lines
+
+  // This loads all plugins defined in plugins
+  // those should be support plugins that are reused
+  // through your application
+  void fastify.register(AutoLoad, {
+    dir: join(__dirname, 'plugins'),
+    options: opts,
+  });
+
+  // This loads all plugins defined in routes
+  // define your routes in one of these
+  void fastify.register(AutoLoad, {
+    dir: join(__dirname, 'routes'),
+    options: opts,
+  });
+};
+
+export default app;
+export { app, options };

apps/platform/api/src/lib/db.ts

@@ -0,0 +1,21 @@
+import { Kysely, PostgresDialect } from 'kysely';
+import type { DB } from 'kysely-codegen';
+// this is the Database interface we defined earlier
+import { Pool } from 'pg';
+
+export const db = (function () {
+  const dialect = new PostgresDialect({
+    pool: new Pool({
+      database: 'calendso',
+      host: 'localhost',
+      user: 'postgres',
+      password: '',
+      ssl: false,
+      port: 5450,
+      max: 10,
+    }),
+  });
+  return new Kysely<DB>({
+    dialect,
+  });
+})();

apps/platform/api/src/plugins/README.md

@@ -0,0 +1,16 @@
+# Plugins Folder
+
+Plugins define behavior that is common to all the routes in your
+application. Authentication, caching, templates, and all the other cross
+cutting concerns should be handled by plugins placed in this folder.
+
+Files in this folder are typically defined through the
+[`fastify-plugin`](https://github.com/fastify/fastify-plugin) module,
+making them non-encapsulated. They can define decorators and set hooks
+that will then be used in the rest of your application.
+
+Check out:
+
+* [The hitchhiker's guide to plugins](https://www.fastify.io/docs/latest/Guides/Plugins-Guide/)
+* [Fastify decorators](https://www.fastify.io/docs/latest/Reference/Decorators/).
+* [Fastify lifecycle](https://www.fastify.io/docs/latest/Reference/Lifecycle/).

apps/platform/api/src/plugins/sensible.ts

@@ -0,0 +1,12 @@
+import type { SensibleOptions } from '@fastify/sensible';
+import sensible from '@fastify/sensible';
+import fp from 'fastify-plugin';
+
+/**
+ * This plugins adds some utilities to handle http errors
+ *
+ * @see https://github.com/fastify/fastify-sensible
+ */
+export default fp<SensibleOptions>(async (fastify) => {
+  fastify.register(sensible);
+});

apps/platform/api/src/plugins/support.ts

@@ -0,0 +1,20 @@
+import fp from 'fastify-plugin';
+
+export interface SupportPluginOptions {
+  example?: string;
+}
+
+// The use of fastify-plugin is required to be able
+// to export the decorators to the outer scope
+export default fp<SupportPluginOptions>(async (fastify, opts) => {
+  fastify.decorate('someSupport', function () {
+    return 'hugs';
+  });
+});
+
+// When using .decorate you have to specify added properties for Typescript
+declare module 'fastify' {
+  export interface FastifyInstance {
+    someSupport(): string;
+  }
+}

apps/platform/api/src/plugins/verifyApiKey.ts

@@ -0,0 +1,13 @@
+import fp from 'fastify-plugin';
+
+export default fp(async (fastify, opts) => {
+  fastify.addHook('preHandler', async (request, reply) => {
+    // Check for authentication here
+    const isAuthenticated = true;
+    if (!isAuthenticated) {
+      reply.code(401).send({ error: 'Unauthorized' });
+      return;
+    }
+    return;
+  });
+});

apps/platform/api/src/routes/README.md

@@ -0,0 +1,24 @@
+# Routes Folder
+
+Routes define endpoints within your application. Fastify provides an
+easy path to a microservice architecture, in the future you might want
+to independently deploy some of those.
+
+In this folder you should define all the routes that define the endpoints
+of your web application.
+Each service is a [Fastify
+plugin](https://www.fastify.io/docs/latest/Reference/Plugins/), it is
+encapsulated (it can have its own independent plugins) and it is
+typically stored in a file; be careful to group your routes logically,
+e.g. all `/users` routes in a `users.js` file. We have added
+a `root.js` file for you with a '/' root added.
+
+If a single file become too large, create a folder and add a `index.js` file there:
+this file must be a Fastify plugin, and it will be loaded automatically
+by the application. You can now add as many files as you want inside that folder.
+In this way you can create complex routes within a single monolith,
+and eventually extract them.
+
+If you need to share functionality between routes, place that
+functionality into the `plugins` folder, and share it via
+[decorators](https://www.fastify.io/docs/latest/Reference/Decorators/).

apps/platform/api/src/routes/root.ts

@@ -0,0 +1,9 @@
+import type { FastifyPluginAsync } from 'fastify';
+
+const root: FastifyPluginAsync = async (fastify, opts): Promise<void> => {
+  fastify.get('/', async function (request, reply) {
+    return { root: true };
+  });
+};
+
+export default root;

apps/platform/api/src/routes/users/get.ts

@@ -0,0 +1,28 @@
+import * as UserRepo from '../../users/repository/getUserById';
+import type { FastifyPluginAsync } from 'fastify';
+
+const get: FastifyPluginAsync = async (fastify, opts): Promise<void> => {
+  fastify.register(import('../../plugins/verifyApiKey'));
+
+  fastify.get<{ Params: { id: number } }>('/', async function (request, reply) {
+    try {
+      return `Users`;
+    } catch (err) {
+      console.error(err);
+      return 'error';
+    }
+  });
+
+  fastify.get<{ Params: { id: number } }>('/:id', async function (request, reply) {
+    try {
+      const { id } = request.params;
+      const user = await UserRepo.getUserById(id);
+      return `this is an getUserById: ${user?.name}`;
+    } catch (err) {
+      console.error(err);
+      return 'error';
+    }
+  });
+};
+
+export default get;

apps/platform/api/src/users/repository/getUserById.ts

@@ -0,0 +1,9 @@
+import { db } from '../../lib/db';
+
+export const getUserById = async (id: number) => {
+  return await db
+    .selectFrom('users')
+    .select(['name', 'email'])
+    .where('id', '=', id)
+    .executeTakeFirst();
+};

apps/platform/api/test/helper.ts

@@ -0,0 +1,32 @@
+// This file contains code that we reuse between our tests.
+import * as helper from 'fastify-cli/helper.js';
+import * as path from 'path';
+import type * as tap from 'tap';
+
+export type Test = (typeof tap)['Test']['prototype'];
+
+const AppPath = path.join(__dirname, '..', 'src', 'app.ts');
+
+// Fill in this config with all the configurations
+// needed for testing the application
+async function config() {
+  return {};
+}
+
+// Automatically build and tear down our instance
+async function build(t: Test) {
+  // you can set all the options supported by the fastify CLI command
+  const argv = [AppPath];
+
+  // fastify-plugin ensures that all decorators
+  // are exposed for testing purposes, this is
+  // different from the production setup
+  const app = await helper.build(argv, await config());
+
+  // Tear down our app after we are done
+  t.teardown(() => void app.close());
+
+  return app;
+}
+
+export { config, build };

apps/platform/api/test/plugins/support.test.ts

@@ -0,0 +1,11 @@
+import Support from '../../src/plugins/support';
+import Fastify from 'fastify';
+import { test } from 'tap';
+
+test('support works standalone', async (t) => {
+  const fastify = Fastify();
+  void fastify.register(Support);
+  await fastify.ready();
+
+  t.equal(fastify.someSupport(), 'hugs');
+});

apps/platform/api/test/routes/example.test.ts

@@ -0,0 +1,12 @@
+import { build } from '../helper';
+import { test } from 'tap';
+
+test('example is loaded', async (t) => {
+  const app = await build(t);
+
+  const res = await app.inject({
+    url: '/example',
+  });
+
+  t.equal(res.payload, 'this is an example');
+});

apps/platform/api/test/routes/root.test.ts

@@ -0,0 +1,11 @@
+import { build } from '../helper';
+import { test } from 'tap';
+
+test('default root route', async (t) => {
+  const app = await build(t);
+
+  const res = await app.inject({
+    url: '/',
+  });
+  t.same(JSON.parse(res.payload), { root: true });
+});

apps/platform/api/test/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "noEmit": true
+  },
+  "include": ["../src/**/*.ts", "**/*.ts"]
+}

apps/platform/api/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "fastify-tsconfig",
+  "compilerOptions": {
+    "outDir": "dist",
+    "sourceMap": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["./node_modules"]
+}