Some backend boilerplate

Author: AHGIJMKLKKZNPJKQR

deep-sea-stories/package.json

@@ -1,22 +1,22 @@
 {
-  "name": "deep-sea-stories",
-  "packageManager": "yarn@4.9.2",
-  "private": true,
-  "workspaces": [
-    "packages/*"
-  ],
-  "devDependencies": {
-    "@biomejs/biome": "2.2.4",
-    "typescript": "^5.9.2"
-  },
-  "scripts": {
-    "format": "biome format --write",
-    "format:check": "biome format",
-    "lint": "biome lint",
-    "check": "biome check --write",
-    "typecheck": "yarn workspaces foreach -A -p run typecheck"
-  },
-  "engines": {
-    "node": ">= 24.0.0"
-  }
+	"name": "deep-sea-stories",
+	"packageManager": "yarn@4.9.2",
+	"private": true,
+	"workspaces": [
+		"packages/*"
+	],
+	"devDependencies": {
+		"@biomejs/biome": "2.2.4",
+		"typescript": "^5.9.2"
+	},
+	"scripts": {
+		"format": "biome format --write",
+		"format:check": "biome format",
+		"lint": "biome lint",
+		"check": "biome check --write",
+		"typecheck": "yarn workspaces foreach -A -p run typecheck"
+	},
+	"engines": {
+		"node": ">= 24.0.0"
+	}
 }

deep-sea-stories/packages/backend/.env.example

@@ -0,0 +1,2 @@
+FISHJAM_ID="your-fishjam-id"
+FISHJAM_MANAGEMENT_TOKEN="your-management-token"

deep-sea-stories/packages/backend/package.json

@@ -1,20 +1,25 @@
 {
-  "name": "backend",
-  "private": true,
-  "main": "./src/main.ts",
-  "type": "module",
-  "dependencies": {
-    "fastify": "^5.6.1",
-    "pino-pretty": "^13.1.1"
-  },
-  "devDependencies": {
-    "@tsconfig/node24": "^24.0.1",
-    "@types/node": "^24.5.2",
-    "tsx": "^4.20.6"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "start": "tsx watch src/main.ts",
-    "typecheck": "tsc --noEmit"
-  }
+	"name": "backend",
+	"private": true,
+	"main": "./src/main.ts",
+	"type": "module",
+	"dependencies": {
+		"@fishjam-cloud/js-server-sdk": "^0.21.0",
+		"dotenv": "^17.2.3",
+		"fastify": "^5.6.1",
+		"fastify-plugin": "^5.1.0",
+		"fastify-type-provider-zod": "^6.0.0",
+		"pino-pretty": "^13.1.1",
+		"zod": "^4.1.11"
+	},
+	"devDependencies": {
+		"@tsconfig/node24": "^24.0.1",
+		"@types/node": "^24.5.2",
+		"tsx": "^4.20.6"
+	},
+	"scripts": {
+		"build": "tsc -p tsconfig.json",
+		"start": "tsx watch src/main.ts",
+		"typecheck": "tsc --noEmit"
+	}
 }

deep-sea-stories/packages/backend/src/config.ts

@@ -0,0 +1,25 @@
+import dotenv from 'dotenv';
+import type { FastifyInstance } from 'fastify';
+import fp from 'fastify-plugin';
+import z from 'zod';
+
+dotenv.config();
+
+declare module 'fastify' {
+	interface FastifyInstance {
+		config: ConfigSchema;
+	}
+}
+
+export const configSchema = z.object({
+	PORT: z.coerce.number().int().default(8000),
+	FISHJAM_ID: z.string(),
+	FISHJAM_URL: z.string().optional(),
+	FISHJAM_MANAGEMENT_TOKEN: z.string(),
+});
+
+type ConfigSchema = z.infer<typeof configSchema>;
+
+export const fastifyConfig = fp((fastify: FastifyInstance) => {
+	fastify.decorate('config', configSchema.parse(process.env));
+});

deep-sea-stories/packages/backend/src/controllers/rooms.ts

@@ -0,0 +1,9 @@
+import type { FishjamClient, RoomId } from '@fishjam-cloud/js-server-sdk';
+
+export async function createRoom(fishjam: FishjamClient) {
+	return await fishjam.createRoom();
+}
+
+export async function getRoom(fishjam: FishjamClient, roomId: RoomId) {
+	return await fishjam.getRoom(roomId);
+}

deep-sea-stories/packages/backend/src/main.ts

@@ -1,35 +1,29 @@
-import Fastify, {
-	type FastifyInstance,
-	type RouteShorthandOptions,
-} from 'fastify';
+import Fastify from 'fastify';
+import {
+	serializerCompiler,
+	validatorCompiler,
+	type ZodTypeProvider,
+} from 'fastify-type-provider-zod';
+import { fastifyConfig } from './config.js';
+import { fishjamPlugin } from './plugins/fishjam.js';
+import routes from './routes/index.js';
 
-const server: FastifyInstance = Fastify({
+const fastify = Fastify({
 	logger: { transport: { target: 'pino-pretty' } },
-});
-const port = 3000;
+}).withTypeProvider<ZodTypeProvider>();
 
-const opts: RouteShorthandOptions = {
-	schema: {
-		response: {
-			200: {
-				type: 'object',
-				properties: {
-					pong: {
-						type: 'string',
-					},
-				},
-			},
-		},
-	},
-};
+fastify.setValidatorCompiler(validatorCompiler);
+fastify.setSerializerCompiler(serializerCompiler);
 
-server.get('/ping', opts, async (_request, _reply) => {
-	return { pong: 'it worked!' };
-});
+fastify.register(fastifyConfig);
+fastify.register(fishjamPlugin);
+
+fastify.register(routes, { prefix: '/api/v1' });
 
 try {
-	await server.listen({ port });
+	await fastify.ready();
+	await fastify.listen({ port: fastify.config.PORT });
 } catch (err) {
-	server.log.error(err);
+	fastify.log.error(err);
 	process.exit(1);
 }

deep-sea-stories/packages/backend/src/plugins/fishjam.ts

@@ -0,0 +1,29 @@
+import {
+	FishjamBaseException,
+	FishjamClient,
+} from '@fishjam-cloud/js-server-sdk';
+import type { FastifyInstance } from 'fastify';
+import fp from 'fastify-plugin';
+
+declare module 'fastify' {
+	interface FastifyInstance {
+		fishjam: FishjamClient;
+	}
+}
+
+export const fishjamPlugin = fp(async (fastify: FastifyInstance) => {
+	const fishjamClient = new FishjamClient({
+		fishjamId: fastify.config.FISHJAM_ID,
+		fishjamUrl: fastify.config.FISHJAM_URL,
+		managementToken: fastify.config.FISHJAM_MANAGEMENT_TOKEN,
+	});
+
+	try {
+		await fishjamClient.getAllRooms();
+	} catch (e) {
+		if (e instanceof FishjamBaseException)
+			throw Error('Invalid Fishjam configuration provided.');
+	}
+
+	fastify.decorate('fishjam', fishjamClient);
+});

deep-sea-stories/packages/backend/src/routes/index.ts

@@ -0,0 +1,7 @@
+import type { FastifyInstance } from 'fastify';
+import rooms from './rooms.js';
+
+export default function routes(fastify: FastifyInstance) {
+	fastify.register(rooms, { prefix: '/rooms' });
+	fastify.get('/', () => 'dupa');
+}

deep-sea-stories/packages/backend/src/routes/rooms.ts

@@ -0,0 +1,38 @@
+import type { RoomId } from '@fishjam-cloud/js-server-sdk';
+import type { FastifyPluginAsyncZod } from 'fastify-type-provider-zod';
+import z from 'zod';
+import { createRoom, getRoom } from '../controllers/rooms.js';
+import { roomSchema } from '../schemas.js';
+
+const routes: FastifyPluginAsyncZod = async (fastify) => {
+	fastify.post(
+		'/',
+		{
+			schema: {
+				response: {
+					201: roomSchema,
+				},
+			},
+		},
+		async () => {
+			return await createRoom(fastify.fishjam);
+		},
+	);
+
+	fastify.get(
+		'/:roomId',
+		{
+			schema: {
+				params: z.object({
+					roomId: z.string(),
+				}),
+				response: {
+					200: roomSchema,
+				},
+			},
+		},
+		async (req) => await getRoom(fastify.fishjam, req.params.roomId as RoomId),
+	);
+};
+
+export default routes;

deep-sea-stories/packages/backend/src/schemas.ts

@@ -0,0 +1,10 @@
+import z from 'zod';
+
+export const peerSchema = z.object({
+	id: z.string(),
+});
+
+export const roomSchema = z.object({
+	id: z.string(),
+	peers: peerSchema.array(),
+});