NCTO-23 client server system for multiplayer

.dockerignore

@@ -5,3 +5,5 @@
 esling.config.js
 README.md
 license.txt
+dist
+node_modules

.gitattributes

@@ -0,0 +1 @@
+* text eolf=lf

.github/workflows/generate_ts_client.yml

@@ -0,0 +1,47 @@
+name: Generate TypeScript client for the frontend
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  generate_ts_client:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 25
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Generate Prisma client
+        run: npx prisma generate
+
+      - name: Generate Swagger JSON
+        run: npm run generate:swagger
+
+      - name: Generate TypeScript client
+        run: npm run generate:client
+
+      - name: Zip API client
+        run: |
+          mkdir -p artifacts
+          zip -r artifacts/api_ts_client_$(date +"%Y%m%d_%H%M%S").zip ./generated_client
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: api-client-artifacts
+          path: artifacts/api_ts_client_*.zip
+

.github/workflows/jest.yml

@@ -0,0 +1,55 @@
+name: Run Jest Tests
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    services:
+      postgres:
+        image: postgres:15
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: testdb
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    env:
+      DATABASE_URL: postgres://postgres:postgres@localhost:5432/testdb
+      NODE_ENV: test
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Generate Prisma client
+        run: npx prisma generate
+
+      - name: Run Prisma migrations
+        run: npx prisma migrate deploy
+
+      - name: Build project
+        run: npm run build
+
+      - name: Run Jest tests
+        run: npm run test -- --runInBand

.prettierrc

@@ -1,5 +1,6 @@
 {
   "singleQuote": false,
-  "trailingComma": "none",
-  "endOfLine": "crlf"
+  "endOfLine": "lf",
+  "tabWidth": 2,
+  "trailingComma": "none"
 }

Dockerfile

@@ -1,4 +1,4 @@
-FROM node:20-alpine
+FROM node:20-alpine AS base
 
 ARG BACKEND_PORT=3000
 ARG POSTGRES_HOST
@@ -9,16 +9,26 @@ ARG POSTGRES_DB
 
 WORKDIR /app
 
-RUN apk add --no-cache python3 make g++
+# If we need some dependencies that require native compilation (unlikely),
+# decomment this out:
+# RUN apk add --no-cache python3 make g++
 
 ENV DATABASE_URL="postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${POSTGRES_HOST}:${POSTGRES_PORT}/${POSTGRES_DB}"
 
 COPY package.json ./
+COPY prisma.config.ts ./
 COPY prisma ./prisma
 
 RUN npm install
 RUN npx prisma generate
+
+FROM base AS dev
+ENV PORT=${BACKEND_PORT}
 COPY . .
+CMD ["sh", "-c", "npx prisma migrate deploy && npm run start:dev"]
 
+FROM base AS prod
+COPY . .
+RUN npm run build
 ENV PORT=${BACKEND_PORT}
-CMD ["sh", "-c", "npx prisma migrate deploy && npm run start"]
+CMD ["sh", "-c", "npx prisma migrate deploy && npm run start:prod"]

dev.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+
+docker compose -f docker-compose.yml -f docker-compose.dev.yml watch

docker-compose.dev.yml

@@ -0,0 +1,33 @@
+networks:
+  naucto-dev:
+    name: naucto-dev
+    driver: bridge
+
+services:
+  db:
+    networks:
+      - naucto-dev
+
+  backend:
+    build:
+      target: dev
+    networks:
+      - naucto-dev
+    develop:
+      watch:
+        - action: sync
+          path: ./src
+          target: /app/src
+
+        - action: sync
+          path: ./prisma
+          target: /app/prisma
+          ignore:
+            - prisma/migrations
+
+        - action: rebuild
+          path: package.json
+
+        - action: rebuild
+          path: prisma/schema.prisma
+

docker-compose.yml

@@ -1,3 +1,8 @@
+networks:
+  naucto:
+    name: naucto
+    driver: bridge
+
 services:
   db:
     image: postgres
@@ -13,14 +18,16 @@ services:
       interval: 10s
       timeout: 5s
       retries: 5
+    networks:
+      - naucto
 
   backend:
     build:
       context: .
       dockerfile: Dockerfile
+      target: prod
       args:
         - BACKEND_PORT=${BACKEND_PORT}
-
         - POSTGRES_USER=${POSTGRES_USER}
         - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
         - POSTGRES_DB=${POSTGRES_DB}
@@ -33,9 +40,10 @@ services:
       - .env
     ports:
       - "${BACKEND_PORT}:3000"
-    volumes:
-      - .:/app
     restart: on-failure
+    networks:
+      - naucto
 
 volumes:
   db-data:
+

jest.config.ts

@@ -13,7 +13,7 @@ const config: Config = {
   testRegex: ".*\\.spec\\.ts$",
   moduleNameMapper: pathsToModuleNameMapper(compilerOptions.paths || {}, {
     prefix: "<rootDir>/",
-  }),
+  }) || {},
   transform: {
     "^.+\\.(t|j)s$": [
       "ts-jest",

openapi-ts.config.ts

@@ -0,0 +1,28 @@
+import { defineConfig } from "@hey-api/openapi-ts";
+
+export default defineConfig({
+  input: "swagger.json",
+  output: {
+    path: "generated_client",
+    postProcess: ["prettier"],
+  },
+  plugins: [
+    {
+      name: "@hey-api/client-axios",
+      // Bundle the client runtime inside generated_client so the frontend
+      // can drop it in as-is without an extra npm dependency.
+      bundle: true,
+    },
+    {
+      name: "@hey-api/sdk",
+      operations: { nesting: "operationId" },
+    },
+    {
+      name: "@hey-api/typescript",
+      // Emit runtime enum objects (e.g. ProjectResponseDtoStatus.COMPLETED)
+      // alongside the union types, giving callers a type-safe constant to
+      // reference instead of raw string literals.
+      enums: "javascript",
+    },
+  ],
+});