feat(tests): add API route integration tests with supertest (#289)

.github/workflows/ci.yml

@@ -34,11 +34,37 @@ jobs:
       fail-fast: true
       matrix:
         node-version: [20, 22]
+    services:
+      postgres:
+        image: postgres:16-alpine
+        env:
+          POSTGRES_USER: ajosave
+          POSTGRES_PASSWORD: ajosave
+          POSTGRES_DB: ajosave_test
+        ports: ["5432:5432"]
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 5s
+          --health-timeout 5s
+          --health-retries 5
+      redis:
+        image: redis:7-alpine
+        ports: ["6379:6379"]
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 5s
+          --health-timeout 5s
+          --health-retries 5
+    env:
+      DATABASE_URL: postgresql://ajosave:ajosave@localhost:5432/ajosave_test
+      REDIS_URL: redis://localhost:6379
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with: { node-version: "${{ matrix.node-version }}", cache: npm }
       - run: npm ci
+      - name: Run migrations before tests
+        run: npm run migrate
       - name: Run tests with coverage
         run: npm run test:coverage -- --ci
       - name: Upload coverage to Codecov

jest.config.js

@@ -24,6 +24,24 @@ const config = {
       statements: 70,
     },
   },
+  // Integration tests require the Node environment (no DOM needed for supertest)
+  testEnvironmentOptions: {},
+  projects: [
+    {
+      displayName: "unit",
+      testEnvironment: "jest-environment-jsdom",
+      testPathPattern: "src/(?!__tests__/integration)",
+      setupFilesAfterEnv: ["<rootDir>/jest.setup.ts"],
+      moduleNameMapper: { "^@/(.*)$": "<rootDir>/src/$1" },
+    },
+    {
+      displayName: "integration",
+      testEnvironment: "node",
+      testPathPattern: "src/__tests__/integration/.*\\.test\\.ts$",
+      setupFilesAfterEnv: ["<rootDir>/jest.setup.ts"],
+      moduleNameMapper: { "^@/(.*)$": "<rootDir>/src/$1" },
+    },
+  ],
 };
 
 module.exports = createJestConfig(config);