support swappable cypress test environments

Author: jamesdabbs

packages/viewer/README.md

@@ -29,9 +29,11 @@ The developer panel (at `/dev`) has some utilities that may be helpful for contr
 Other helpful development commands
 
 ```bash
-$ npm run test:watch # run tests on change
-$ npm run test:cov   # run tests with coverage report
-$ npm run cy:open    # starts cypress
+$ npm run test:watch   # run tests on change
+$ npm run test:cov     # run tests with coverage report
+$ npm run cy:open      # start cypress against the local dev server
+$ npm run cy:open:prev # … preview for the current branch (or env.BRANCH, if set)
+$ npm run cy:open:prod # … or production
 ```
 
 ## Deployment

packages/viewer/cypress.config.ts

@@ -1,10 +1,34 @@
 import { defineConfig } from 'cypress'
+import { execSync } from 'child_process'
+
+function getCurrentBranch() {
+  try {
+    return execSync('git rev-parse --abbrev-ref HEAD').toString().trim()
+  } catch (error) {
+    throw new Error(`Could not determine current git branch: ${error}`)
+  }
+}
+
+function baseUrl({ CYPRESS_ENV = 'local' } = process.env) {
+  switch (CYPRESS_ENV) {
+    case 'local':
+      return 'http://localhost:5173'
+    case 'production':
+      return 'https://topology.pi-base.org'
+    case 'preview':
+      const branch = process.env.BRANCH || getCurrentBranch()
+      const domain = branch.toLowerCase().replaceAll('/', '-').slice(0, 28)
+      return `https://${domain}.topology.pages.dev`
+    default:
+      throw new Error(`Invalid environment: ${CYPRESS_ENV}`)
+  }
+}
 
 export default defineConfig({
   projectId: 'bkb3p8',
   chromeWebSecurity: false,
   e2e: {
-    baseUrl: 'http://localhost:5173',
+    baseUrl: baseUrl(),
     experimentalRunAllSpecs: true,
     specPattern: 'cypress/e2e/**/*.{ts,tsx}',
     supportFile: false,

packages/viewer/cypress/e2e/loading.spec.ts

@@ -8,9 +8,9 @@ describe('Loading', () => {
 
     cy.title().should(
       'eq',
-      'T2: Countably compact ⇒ Weakly Countably Compact | π-Base',
+      'T2: Countably compact ⇒ Weakly countably compact | π-Base',
     )
-    cy.contains('Countably compact ⇒ Weakly Countably Compact')
+    cy.contains('Countably compact ⇒ Weakly countably compact')
   })
 })
 

packages/viewer/package.json

@@ -7,7 +7,11 @@
   "scripts": {
     "build": "vite build --logLevel warn",
     "cy:open": "cypress open",
+    "cy:open:prev": "CYPRESS_ENV=preview cypress open",
+    "cy:open:prod": "CYPRESS_ENV=production cypress open",
     "cy:run": "cypress run",
+    "cy:run:prev": "CYPRESS_ENV=preview cypress run $@",
+    "cy:run:prod": "CYPRESS_ENV=production cypress run $@",
     "dev": "vite",
     "preview": "vite preview",
     "test": "vitest run",
@@ -44,7 +48,7 @@
     "@types/katex": "^0.16.7",
     "@types/page": "^1.11.9",
     "@types/unist": "^2.0.10",
-    "cypress": "^13.6.2",
+    "cypress": "^14.3.2",
     "svelte": "^4.2.8",
     "svelte-check": "^3.6.3",
     "svelte-preprocess": "^5.1.3",