ci: API tests in CI, demo-based, Firestore-aware skip

.github/workflows/ci.yml

@@ -46,6 +46,18 @@ jobs:
         run: npx playwright install-deps chromium
       - run: node test/smoke-test.js
 
+  api:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 24
+      - run: npm install
+      - name: API tests (no Firestore)
+        run: bash scripts/test-api-local.sh
+
   codeql:
     runs-on: ubuntu-latest
     steps:

docker-compose.test.yml

@@ -0,0 +1,14 @@
+services:
+  firestore:
+    image: google/cloud-sdk:slim
+    command: >
+      gcloud emulators firestore start
+      --host-port=0.0.0.0:8686
+      --project=casecomp-test
+    ports:
+      - "8686:8686"
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:8686/"]
+      interval: 2s
+      timeout: 5s
+      retries: 10

firebase.json

@@ -0,0 +1,11 @@
+{
+  "emulators": {
+    "firestore": {
+      "port": 8686,
+      "host": "localhost"
+    },
+    "ui": {
+      "enabled": false
+    }
+  }
+}

package.json

@@ -13,6 +13,7 @@
     "test:unit": "node test/unit-test.js",
     "test:api": "node test/api-test.js",
     "test:live": "API_URL=https://api.casecomp.xyz node test/api-test.js",
+    "test:api:local": "bash scripts/test-api-local.sh",
     "test:smoke": "node test/smoke-test.js",
     "scan": "node scan.js",
     "psa": "node scripts/psa-report.js",

scripts/test-api-local.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+set -e
+
+PORT=3033
+
+cleanup() {
+  echo "Cleaning up..."
+  [ -n "$SERVER_PID" ] && kill $SERVER_PID 2>/dev/null
+  wait $SERVER_PID 2>/dev/null
+  echo "Done."
+}
+trap cleanup EXIT
+
+echo "Starting API server on :$PORT..."
+API_PORT=$PORT node api.js 2>/dev/null &
+SERVER_PID=$!
+SERVER_PID=$!
+
+echo "Waiting for server..."
+for i in $(seq 1 15); do
+  if curl -sf "http://localhost:$PORT/api/health" >/dev/null 2>&1; then
+    echo "Server ready."
+    break
+  fi
+  if [ "$i" -eq 15 ]; then
+    echo "Server failed to start"
+    exit 1
+  fi
+  sleep 1
+done
+
+# Run tests
+echo ""
+echo "Running API tests..."
+API_URL="http://localhost:$PORT" node test/api-test.js