V0

.env.example

@@ -14,5 +14,6 @@ FASTIFY_CLOSE_GRACE_DELAY=1000
 LOG_LEVEL=info
 
 # Security
-JWT_SECRET=
+COOKIE_SECRET=
+COOKIE_NAME=
 RATE_LIMIT_MAX=

.github/workflows/ci.yml

@@ -9,6 +9,7 @@ on:
     paths-ignore:
       - "docs/**"
       - "*.md"
+      - "*.example"
   pull_request:
     paths-ignore:
       - "docs/**"
@@ -50,11 +51,10 @@ jobs:
       - name: Lint Code
         run: npm run lint
 
-      - name: Generate JWT Secret
-        id: gen-jwt
+      - name: Generate COOKIE Secret
         run: |
-          JWT_SECRET=$(openssl rand -hex 32)
-          echo "JWT_SECRET=$JWT_SECRET" >> $GITHUB_ENV
+          COOKIE_SECRET=$(openssl rand -hex 32)
+          echo "COOKIE_SECRET=$COOKIE_SECRET" >> $GITHUB_ENV
 
       - name: Generate dummy .env for scripts using -env-file=.env flag
         run: touch .env
@@ -66,6 +66,7 @@ jobs:
           MYSQL_DATABASE: test_db
           MYSQL_USER: test_user
           MYSQL_PASSWORD: test_password
-          # JWT_SECRET is dynamically generated and loaded from the environment
+          # COOKIE_SECRET is dynamically generated and loaded from the environment
+          COOKIE_NAME: 'sessid'
           RATE_LIMIT_MAX: 4
         run: npm run db:migrate && npm run test

docker-compose.yml

@@ -2,13 +2,19 @@ services:
   db:
     image: mysql:8.4
     environment:
-      MYSQL_DATABASE: ${MYSQL_DATABASE}
-      MYSQL_USER: ${MYSQL_USER}
-      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
+      MYSQL_ROOT_PASSWORD: root_password       
+      MYSQL_DATABASE: ${MYSQL_DATABASE}        
+      MYSQL_USER: ${MYSQL_USER}                
+      MYSQL_PASSWORD: ${MYSQL_PASSWORD} 
     ports:
       - 3306:3306
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-u${MYSQL_USER}", "-p${MYSQL_PASSWORD}"]
+      interval: 10s
+      timeout: 5s
+      retries: 3
     volumes:
       - db_data:/var/lib/mysql
-
+      
 volumes:
   db_data:

migrations/004.do.roles.sql

@@ -0,0 +1,4 @@
+CREATE TABLE roles (
+  id INT AUTO_INCREMENT PRIMARY KEY,
+  name VARCHAR(255) NOT NULL
+);

migrations/004.undo.roles.sql

@@ -0,0 +1 @@
+DROP TABLE IF EXISTS roles;

migrations/005.do.user_roles.sql

@@ -0,0 +1,7 @@
+CREATE TABLE user_roles (
+  id INT AUTO_INCREMENT PRIMARY KEY,
+  user_id INT NOT NULL,
+  role_id INT NOT NULL,
+  FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE,
+  FOREIGN KEY (role_id) REFERENCES roles(id) ON DELETE CASCADE
+);

migrations/005.undo.user_roles.sql

@@ -0,0 +1 @@
+DROP TABLE IF EXISTS user_roles;

package.json

@@ -9,29 +9,31 @@
   },
   "scripts": {
     "start": "npm run build && fastify start -l info dist/app.js",
-    "build": "tsc",
+    "build": "rm -rf ./dist && tsc",
     "watch": "tsc -w",
     "dev": "npm run build && concurrently -k -p \"[{name}]\" -n \"TypeScript,App\" -c \"yellow.bold,cyan.bold\" \"npm:watch\" \"npm:dev:start\"",
-    "dev:start": "fastify start --ignore-watch=.ts$ -w -l info -P dist/app.js",
+    "dev:start": "npm run build && fastify start --ignore-watch=.ts$ -w -l info -P dist/app.js",
     "test": "npm run db:seed && tap --jobs=1 test/**/*",
-    "standalone": "node --env-file=.env dist/server.js",
+    "standalone": "npm run build && node --env-file=.env dist/server.js",
     "lint": "eslint --ignore-pattern=dist",
     "lint:fix": "npm run lint -- --fix",
-    "db:migrate": "node --env-file=.env scripts/migrate.js",
-    "db:seed": "node --env-file=.env scripts/seed-database.js"
+    "db:create": "tsx --env-file=.env ./scripts/create-database.ts",
+    "db:drop": "tsx --env-file=.env ./scripts/drop-database.ts",
+    "db:migrate": "tsx --env-file=.env ./scripts/migrate.ts",
+    "db:seed": "tsx --env-file=.env ./scripts/seed-database.ts"
   },
   "keywords": [],
   "author": "Michelet Jean <[email protected]>",
   "license": "MIT",
   "dependencies": {
     "@fastify/autoload": "^6.0.0",
+    "@fastify/cookie": "^11.0.1",
     "@fastify/cors": "^10.0.0",
     "@fastify/env": "^5.0.1",
     "@fastify/helmet": "^12.0.0",
-    "@fastify/jwt": "^9.0.0",
-    "@fastify/mysql": "^5.0.1",
     "@fastify/rate-limit": "^10.0.1",
     "@fastify/sensible": "^6.0.1",
+    "@fastify/session": "^11.0.1",
     "@fastify/swagger": "^9.0.0",
     "@fastify/swagger-ui": "^5.0.1",
     "@fastify/type-provider-typebox": "^5.0.0",
@@ -41,15 +43,17 @@
     "fastify": "^5.0.0",
     "fastify-cli": "^7.0.0",
     "fastify-plugin": "^5.0.1",
+    "knex": "^3.1.0",
+    "mysql2": "^3.11.3",
     "postgrator": "^7.3.0"
   },
   "devDependencies": {
     "@types/node": "^22.5.5",
     "eslint": "^9.11.0",
     "fastify-tsconfig": "^2.0.0",
-    "mysql2": "^3.11.3",
     "neostandard": "^0.11.5",
     "tap": "^21.0.1",
+    "tsx": "^4.19.1",
     "typescript": "~5.6.2"
   }
 }

scripts/create-database.ts

@@ -0,0 +1,26 @@
+import { createConnection, Connection } from 'mysql2/promise'
+
+async function createDatabase () {
+  const connection: Connection = await createConnection({
+    host: process.env.MYSQL_HOST,
+    port: Number(process.env.MYSQL_PORT),
+    user: process.env.MYSQL_USER,
+    password: process.env.MYSQL_PASSWORD
+  })
+
+  try {
+    await createDB(connection)
+    console.log(`Database ${process.env.MYSQL_DATABASE} has been created successfully.`)
+  } catch (error) {
+    console.error('Error creating database:', error)
+  } finally {
+    await connection.end()
+  }
+}
+
+async function createDB (connection: Connection) {
+  await connection.query(`CREATE DATABASE IF NOT EXISTS \`${process.env.MYSQL_DATABASE}\``)
+  console.log(`Database ${process.env.MYSQL_DATABASE} created or already exists.`)
+}
+
+createDatabase()

scripts/drop-database.ts

@@ -0,0 +1,26 @@
+import { createConnection, Connection } from 'mysql2/promise'
+
+async function dropDatabase () {
+  const connection: Connection = await createConnection({
+    host: process.env.MYSQL_HOST,
+    port: Number(process.env.MYSQL_PORT),
+    user: process.env.MYSQL_USER,
+    password: process.env.MYSQL_PASSWORD
+  })
+
+  try {
+    await dropDB(connection)
+    console.log(`Database ${process.env.MYSQL_DATABASE} has been dropped successfully.`)
+  } catch (error) {
+    console.error('Error dropping database:', error)
+  } finally {
+    await connection.end()
+  }
+}
+
+async function dropDB (connection: Connection) {
+  await connection.query(`DROP DATABASE IF EXISTS \`${process.env.MYSQL_DATABASE}\``)
+  console.log(`Database ${process.env.MYSQL_DATABASE} dropped.`)
+}
+
+dropDatabase()

scripts/migrate.ts

@@ -0,0 +1,61 @@
+import mysql, { Connection } from 'mysql2/promise'
+import path from 'node:path'
+import fs from 'node:fs'
+import Postgrator from 'postgrator'
+
+interface PostgratorResult {
+  rows: any;
+  fields: any;
+}
+
+async function doMigration (): Promise<void> {
+  const connection: Connection = await mysql.createConnection({
+    multipleStatements: true,
+    host: process.env.MYSQL_HOST,
+    port: Number(process.env.MYSQL_PORT),
+    database: process.env.MYSQL_DATABASE,
+    user: process.env.MYSQL_USER,
+    password: process.env.MYSQL_PASSWORD
+  })
+
+  try {
+    const migrationDir = path.join(import.meta.dirname, '../migrations')
+
+    if (!fs.existsSync(migrationDir)) {
+      throw new Error(
+        `Migration directory "${migrationDir}" does not exist. Skipping migrations.`
+      )
+    }
+
+    const postgrator = new Postgrator({
+      migrationPattern: path.join(migrationDir, '*'),
+      driver: 'mysql',
+      database: process.env.MYSQL_DATABASE,
+      execQuery: async (query: string): Promise<PostgratorResult> => {
+        const [rows, fields] = await connection.query(query)
+        return { rows, fields }
+      },
+      schemaTable: 'schemaversion'
+    })
+
+    await postgrator.migrate()
+
+    console.log('Migration completed!')
+
+    await new Promise<void>((resolve, reject) => {
+      connection.end((err: unknown) => {
+        if (err) {
+          return reject(err)
+        }
+
+        resolve()
+      })
+    })
+  } catch (error) {
+    console.error(error)
+  } finally {
+    await connection.end()
+  }
+}
+
+doMigration()