Add firebase emulator, Add registration script, Add signup spec (#22)

* add firebase emulator, add registration script, add signup spec

* Upgrade firebase emulator and make it pass the E2E tests

---------

Co-authored-by: MartinBraquet <[email protected]>

Author: n3c777

.env.example

@@ -1,3 +1,9 @@
+
+# use firebase emulator for running e2e tests
+NEXT_PUBLIC_FIREBASE_EMULATOR=false
+FIREBASE_AUTH_EMULATOR_HOST=127.0.0.1:9099
+FIREBASE_STORAGE_EMULATOR_HOST=127.0.0.1:9199
+
 # You already have access to basic local functionality (UI, authentication, database read access).
 
 # openssl enc -aes-256-cbc -salt -pbkdf2 -iter 100000 -in backend/shared/src/googleApplicationCredentials-dev.json -out secrets/googleApplicationCredentials-dev.json.enc

.github/workflows/ci.yml

@@ -45,37 +45,18 @@ jobs:
 #          "common/coverage/lcov.info" \
 #          "web/coverage/lcov.info" \
 #          > coverage/lcov.info
-  
-  
-
-  #      - name: Build app
-#        env:
-#          DATABASE_URL: ${{ secrets.DATABASE_URL }}
-#        run: npm run build
 
       # Optional: Playwright E2E tests
       - name: Install Playwright deps
         run: |
-          npx playwright install --with-deps
+          npx playwright install chromium
+#          npx playwright install --with-deps
 #          npm install @playwright/test
 
       - name: Run E2E tests
-        env:
-          NEXT_PUBLIC_API_URL: localhost:8088
-          NEXT_PUBLIC_FIREBASE_ENV: DEV
-          NEXT_PUBLIC_FIREBASE_API_KEY: ${{ secrets.NEXT_PUBLIC_FIREBASE_API_KEY }}
-          NEXT_PUBLIC_SUPABASE_KEY: ${{ secrets.NEXT_PUBLIC_SUPABASE_KEY }}
         run: |
-          npx nyc --reporter=lcov yarn --cwd=web serve &
-          npx nyc --reporter=lcov yarn --cwd=backend/api dev &
-          npx wait-on http://localhost:3000
-          npx playwright test tests/e2e
-          SERVER_PID=$(fuser -k 3000/tcp)
-          echo $SERVER_PID
-          kill $SERVER_PID
-          SERVER_PID=$(fuser -k 8088/tcp)
-          echo $SERVER_PID
-          kill $SERVER_PID
+          chmod +x scripts/e2e.sh
+          ./scripts/e2e.sh
 
       - name: Upload coverage to Codecov
         uses: codecov/codecov-action@v5

backend/api/src/helpers/endpoint.ts

@@ -76,6 +76,8 @@ export const parseCredentials = async (req: Request): Promise<Credentials> => {
       try {
         return {kind: 'jwt', data: await auth.verifyIdToken(payload)}
       } catch (err) {
+        const raw = payload.split(".")[0];
+        console.log("JWT header:", JSON.parse(Buffer.from(raw, "base64").toString()));
         // This is somewhat suspicious, so get it into the firebase console
         console.error('Error verifying Firebase JWT: ', err, scheme, payload)
         throw new APIError(500, 'Error validating token.')

backend/shared/src/init-admin.ts

@@ -1,15 +1,22 @@
 import * as admin from 'firebase-admin'
-
-
 import {getServiceAccountCredentials} from "shared/firebase-utils";
 import {IS_LOCAL} from "common/hosting/constants";
+import {IS_FIREBASE_EMULATOR} from "common/envs/constants";
 
-// Locally initialize Firebase Admin.
 export const initAdmin = () => {
+
+  if (IS_LOCAL && IS_FIREBASE_EMULATOR) {
+    console.log("Using Firebase Emulator Suite.")
+    return admin.initializeApp({
+      projectId: "compass-57c3c",
+      storageBucket: "compass-130ba-public",
+    })
+  }
+
   if (IS_LOCAL) {
     try {
       const serviceAccount = getServiceAccountCredentials()
-      // console.debug(serviceAccount)
+
       if (!serviceAccount.project_id) {
         console.debug(`GOOGLE_APPLICATION_CREDENTIALS not set, skipping admin firebase init.`)
         return
@@ -27,4 +34,4 @@ export const initAdmin = () => {
 
   console.debug(`Initializing connection to default Firebase...`)
   return admin.initializeApp()
-}
+}

common/src/envs/constants.ts

@@ -41,6 +41,9 @@ console.debug(`Running in ${HOSTING_ENV} (${ENV})`,);
 //   throw new MissingKeyError('firebaseConfig.apiKey')
 // }
 
+export const IS_FIREBASE_EMULATOR = process.env.NEXT_PUBLIC_FIREBASE_EMULATOR === "true"
+if (IS_FIREBASE_EMULATOR) console.log("Using Firebase emulator.")
+
 export const LOCAL_WEB_DOMAIN = `localhost:3000`
 export const LOCAL_BACKEND_DOMAIN = `${IS_WEBVIEW_DEV_PHONE ? '192.168.1.3' : IS_LOCAL_ANDROID ? '10.0.2.2' : 'localhost'}:8088`
 

firebase.json

@@ -8,5 +8,14 @@
       "bucket": "compass-130ba-private",
       "rules": "private-storage.rules"
     }
-  ]
+  ],
+  "emulators": {
+    "auth": {
+      "port": 9099
+    },
+    "ui": {
+      "enabled": true,
+      "port": 4000
+    }
 }
+}

package.json

@@ -29,7 +29,8 @@
     "playwright:ui": "playwright test --ui",
     "playwright:debug": "playwright test --debug",
     "playwright:report": "npx playwright show-report tests/reports/playwright-report",
-    "postinstall": "./scripts/post_install.sh"
+    "postinstall": "./scripts/post_install.sh",
+    "emulate": "firebase emulators:start --only auth --project compass-57c3c"
   },
   "dependencies": {
     "@capacitor/app": "7.1.0",
@@ -65,6 +66,7 @@
     "eslint": "8.57.0",
     "eslint-plugin-lodash": "^7.4.0",
     "eslint-plugin-unused-imports": "4.1.4",
+    "firebase-tools": "^14.26.0",
     "jest": "29.3.1",
     "nodemon": "2.0.20",
     "prettier": "3.6.2",

playwright.config.ts

@@ -1,5 +1,4 @@
 import { defineConfig, devices } from '@playwright/test';
-import path from 'path';
 
 export default defineConfig({
   testDir: './tests/e2e',
@@ -27,5 +26,6 @@ export default defineConfig({
     //   use: { ...devices['Desktop Safari'] },
     // },
   ],
+  timeout: 60000,
 
 });

scripts/e2e.sh

@@ -1,22 +1,42 @@
 #!/bin/bash
 
-# set -e
+set -euo pipefail
+
+# Function to clean up background processes
+cleanup() {
+  echo "Stopping background processes..."
+  for pid in "${PIDS[@]:-}"; do
+    if kill -0 "$pid" 2>/dev/null; then
+      kill "$pid" || true
+      wait "$pid" 2>/dev/null || true
+      echo "Killed PID $pid"
+    fi
+  done
+}
+
+# Trap EXIT, INT, TERM to run cleanup automatically
+trap cleanup EXIT INT TERM
 
 cd "$(dirname "$0")"/..
 
 npx playwright install chromium
 
 export NEXT_PUBLIC_API_URL=localhost:8088
 export NEXT_PUBLIC_FIREBASE_ENV=DEV
+export NEXT_PUBLIC_FIREBASE_EMULATOR=true
+export FIREBASE_AUTH_EMULATOR_HOST=127.0.0.1:9099
+export FIREBASE_STORAGE_EMULATOR_HOST=127.0.0.1:9199
+
+# Start servers in background and store their PIDs
+PIDS=()
+npx nyc --reporter=lcov yarn --cwd=web serve & PIDS+=($!)
+npx nyc --reporter=lcov yarn --cwd=backend/api dev & PIDS+=($!)
+yarn emulate & PIDS+=($!)
 
-npx nyc --reporter=lcov yarn --cwd=web serve &
-npx nyc --reporter=lcov yarn --cwd=backend/api dev &
 npx wait-on http://localhost:3000
-npx playwright test tests/e2e --headed
-SERVER_PID=$(fuser -k 3000/tcp)
-echo $SERVER_PID
-kill $SERVER_PID
-
-SERVER_PID=$(fuser -k 8088/tcp)
-echo $SERVER_PID
-kill $SERVER_PID
+
+npx tsx scripts/setup-auth.ts
+
+npx playwright test tests/e2e
+
+exit ${TEST_FAILED:-0}

scripts/setup-auth.ts

@@ -0,0 +1,16 @@
+import axios from 'axios';
+import { config } from '../tests/e2e/web/SPEC_CONFIG.js';
+
+async function createAuth() {
+  const base = 'http://localhost:9099/identitytoolkit.googleapis.com/v1';
+
+  await axios.post(`${base}/accounts:signUp?key=fake-api-key`, {
+    email: config.USERS.DEV_1.EMAIL,
+    password: config.USERS.DEV_1.PASSWORD,
+    returnSecureToken: true
+  });
+
+  console.log('Auth created', config.USERS.DEV_1.EMAIL)
+
+}
+createAuth();