Production release – merge develop branch

.dockerignore

@@ -1,5 +1,20 @@
+# Ignore dependencies and build outputs
 node_modules
 dist
+coverage
+
+# Ignore environment and config files
+.env
+
+# Ignore Docker files themselves (optional)
 Dockerfile
+Dockerfile.dev
+docker-compose.yml
+dev.compose.yml
 .dockerignore
-.env
+
+# Ignore local database or test assets
+database
+
+# Ignore local API testing/debugging tools like Bruno collections
+BrainBytes

.env.template

@@ -0,0 +1,8 @@
+PORT=
+NODE_ENV=
+
+JWT_SECRET=
+IS_DOCKERIZED=
+MONGO_URI_ATLAS=
+MONGO_URI_DOCKER=
+GEMINI_KEY=

.github/workflows/ci.yml

@@ -0,0 +1,104 @@
+name: BrainBytes CI
+
+on:
+  push:
+    branches: [master, develop]
+    paths-ignore:
+      - "**.md"
+      - "docs/**"
+  pull_request:
+    branches: [master, develop]
+    paths-ignore:
+      - "**.md"
+      - "docs/**"
+  workflow_dispatch:
+
+jobs:
+  lint:
+    name: Check Code Quality
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: "10.10.0"
+
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24.1.0"
+          cache: "pnpm"
+
+      - name: Install dependencies
+        working-directory: ./src
+        run: pnpm install --no-frozen-lockfile
+
+      - name: Lint source code
+        working-directory: ./src
+        run: pnpm lint
+
+  test:
+    name: Run Tests
+    needs: lint
+    runs-on: ubuntu-latest
+    environment: GitHub actions
+    env:
+      JWT_SECRET: ${{secrets.JWT_SECRET}}
+      MONGO_URI_DOCKER: ${{secrets.MONGO_URI_DOCKER}}
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: "10.10.0"
+
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24.1.0"
+          cache: "pnpm"
+
+      - name: Install dependencies
+        working-directory: ./src
+        run: pnpm install --no-frozen-lockfile
+
+      - name: Run backend tests
+        working-directory: ./src
+        run: pnpm test
+
+  build:
+    name: Build Docker Image
+    needs: ["lint", "test"]
+    runs-on: ubuntu-latest
+    environment: GitHub actions
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GHCR_PAT }}
+
+      - name: Build and push Image
+        uses: docker/build-push-action@v4
+        with:
+          file: ./Dockerfile.prod
+          push: true
+          tags: ghcr.io/${{ github.repository_owner }}/brainbytes-api:latest
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.gitignore

@@ -1,2 +1,20 @@
+# Ignore dependencies and build outputs
 node_modules
-.env
+dist
+coverage
+
+# Ignore environment and config files
+.env
+
+# Ignore Docker files themselves (optional)
+Dockerfile
+Dockerfile.dev
+docker-compose.yml
+dev.compose.yml
+.dockerignore
+
+# Ignore local database or test assets
+database
+
+# Ignore local API testing/debugging tools like Bruno collections
+BrainBytes

Dockerfile.prod

@@ -0,0 +1,31 @@
+# Stage 1: Build
+FROM node:24-alpine AS builder
+
+WORKDIR /app
+
+# Install pnpm globally
+RUN npm install -g pnpm
+
+# Copy only package files first (to cache install layers)
+COPY package.json pnpm-lock.yaml ./
+
+RUN pnpm install
+
+# Then copy rest of the source
+COPY . .
+
+RUN pnpm build
+
+# Stage 2: Run only compiled code
+FROM node:24-alpine
+
+WORKDIR /app
+
+# Copy only the necessary runtime files from the first stage into the second stage
+COPY --from=builder /app/package.json ./
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/dist ./dist
+
+EXPOSE 8000
+
+CMD ["node", "dist/index.js"]

docker-compose.yaml → dev.compose.yaml

@@ -1,15 +1,21 @@
-# Use docker compose file format version 3.8
-version: "3.8"
-
 # Define all services (containers)
 services:
+  # MongoDB service
+  mongodb:
+    # Use official mongoDB image
+    image: mongo:latest
+    # Always restart unless forcibly stop the process.
+    restart: unless-stopped
+    ports:
+      - "27017:27017"
+    # Create volume within src directory
+    volumes:
+      - ./database/mongodb-data:/data/db
   # Backend service
-  backend:
+  expressjs:
     # Build the docker image from the dockerfile in the current dir
-    build: .
-
-    # Set custom container name
-    container_name: brainbytes-server
+    build:
+      dockerfile: Dockerfile.dev
 
     # Map port 8000 inside the container to port 8000 on the host machine
     ports:
@@ -24,23 +30,7 @@ services:
 
     # Wait for mongo servvice to start
     depends_on:
-      - mongo
+      - mongodb
 
     # Override the default command and run npm start
     command: pnpm start
-
-  # MongoDB service
-  mongo:
-    # Use official mongoDB image
-    image: mongo:latest
-
-    container_name: brainbytes-db
-    restart: unless-stopped
-    ports:
-      - "27017:27017"
-
-    volumes:
-      - mongo-data:/data/db
-
-volumes:
-  mongo-data:

eslint.config.mjs

@@ -0,0 +1,11 @@
+import js from "@eslint/js";
+import globals from "globals";
+import tseslint from "typescript-eslint";
+import { defineConfig } from "eslint/config";
+
+
+export default defineConfig([
+  { files: ["**/*.{js,mjs,cjs,ts,mts,cts}"], plugins: { js }, extends: ["js/recommended"] },
+  { files: ["**/*.{js,mjs,cjs,ts,mts,cts}"], languageOptions: { globals: globals.browser } },
+  tseslint.configs.recommended,
+]);

jest.config.js

@@ -0,0 +1,7 @@
+export default {
+  preset: "ts-jest",
+  testEnvironment: "node",
+  testMatch: ["**/test/**/*test.ts"],
+  testPathIgnorePatterns: ["/node_modules"],
+  testTimeout: 30000,
+};

package.json

@@ -1,37 +1,56 @@
 {
-  "name": "brainbytes",
+  "name": "brainbytes-api",
   "version": "1.0.0",
   "description": "",
   "main": "src/index.ts",
   "scripts": {
-    "start": "tsx src/index.ts",
+    "start": "node dist/index.js",
     "dev": "tsx watch src/index.ts",
-    "compose": "docker-compose up --build"
+    "compose": "docker-compose -f dev.compose.yaml up",
+    "compose:build": "docker-compose -f dev.compose.yaml up --build",
+    "compose:down": "docker-compose -f dev.compose.yaml down",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "build": "tsc",
+    "clean": "rmdir /s /q dist"
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
   "packageManager": "pnpm@10.10.0",
   "dependencies": {
-    "@google/genai": "^1.0.1",
+    "@google/genai": "^1.5.1",
     "bcryptjs": "^3.0.2",
-    "body-parser": "^2.2.0",
     "cookie-parser": "^1.4.7",
-    "cors": "^2.8.5",
     "express": "^5.1.0",
     "express-validator": "^7.2.1",
     "jsonwebtoken": "^9.0.2",
-    "mongodb": "^6.16.0",
-    "mongoose": "^8.15.0"
+    "mongodb": "^6.17.0",
+    "mongoose": "^8.16.0",
+    "morgan": "^1.10.0",
+    "winston": "^3.17.0"
   },
   "devDependencies": {
-    "@types/body-parser": "^1.19.5",
-    "@types/cookie-parser": "^1.4.8",
-    "@types/cors": "^2.8.18",
-    "@types/express": "^5.0.2",
-    "@types/jsonwebtoken": "^9.0.9",
-    "@types/node": "^22.15.21",
+    "@eslint/js": "^9.29.0",
+    "@types/cookie-parser": "^1.4.9",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.3",
+    "@types/jest": "^30.0.0",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/morgan": "^1.9.10",
+    "@types/node": "^24.0.3",
+    "@types/supertest": "^6.0.3",
     "dotenv": "^16.5.0",
-    "tsx": "^4.20.3"
+    "eslint": "^9.29.0",
+    "globals": "^16.2.0",
+    "jest": "^30.0.2",
+    "mongodb-memory-server": "^10.1.4",
+    "supertest": "^7.1.1",
+    "ts-jest": "^29.4.0",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.34.1"
   }
 }