@nextsparkjs/core 0.1.0-beta.39 → 0.1.0-beta.40

package/templates/contents/themes/starter/tests/cypress/src/features/index.ts

@@ -0,0 +1,18 @@
+/**
+ * Starter Theme - Feature POM exports
+ *
+ * Specialized POMs for core features:
+ * - DashboardPOM: Dashboard navigation and shell
+ * - SettingsPOM: Settings area (profile, team, billing)
+ * - SuperadminPOM: Superadmin area
+ * - BillingPOM: Billing settings
+ * - DevtoolsPOM: Developer tools area
+ * - ScheduledActionsPOM: Scheduled actions devtools
+ */
+
+export { DashboardPOM } from './DashboardPOM'
+export { SettingsPOM } from './SettingsPOM'
+export { SuperadminPOM } from './SuperadminPOM'
+export { BillingPOM } from './BillingPOM'
+export { DevtoolsPOM } from './DevtoolsPOM'
+export { ScheduledActionsPOM } from './ScheduledActionsPOM'

package/templates/contents/themes/starter/tests/cypress/src/index.ts

@@ -0,0 +1,88 @@
+/**
+ * Starter Theme - Cypress POM Exports
+ *
+ * Centralized exports for all Starter theme Page Object Models and helpers.
+ *
+ * Architecture:
+ * - core/: Base classes (BasePOM, DashboardEntityPOM, BlockEditorBasePOM, AuthPOM)
+ * - components/: Generic UI components (EntityForm, EntityList, TeamSwitcherPOM)
+ * - entities/: Entity POMs extending DashboardEntityPOM (TasksPOM)
+ * - features/: Feature POMs (DashboardPOM, SettingsPOM, SuperadminPOM, etc.)
+ * - helpers/: Utility classes (ApiInterceptor)
+ *
+ * Usage:
+ *   import { TasksPOM, AuthPOM, DashboardPOM } from '../src'
+ *   const tasks = TasksPOM.create()
+ *   tasks.visitList().waitForList().clickAdd()
+ *
+ *   // Session helpers
+ *   import { loginAsOwner, loginAsMember } from '../src'
+ */
+
+// ============================================
+// CORE - Base Classes
+// ============================================
+export {
+  BasePOM,
+  DashboardEntityPOM,
+  BlockEditorBasePOM,
+  AuthPOM,
+  type EntityConfig,
+  type SignupData
+} from './core'
+
+// ============================================
+// COMPONENTS - Generic UI Components
+// ============================================
+export {
+  EntityList,
+  EntityForm,
+  TeamSwitcherPOM,
+  DevKeyringPOM,
+  type EntityListConfig,
+  type EntityFormConfig
+} from './components'
+
+// ============================================
+// ENTITIES - Entity POMs (extend DashboardEntityPOM)
+// ============================================
+export {
+  TasksPOM,
+  type TaskFormData
+} from './entities'
+
+// ============================================
+// FEATURES - Feature POMs
+// ============================================
+export {
+  DashboardPOM,
+  SettingsPOM,
+  SuperadminPOM,
+  BillingPOM,
+  DevtoolsPOM,
+  ScheduledActionsPOM
+} from './features'
+
+// ============================================
+// HELPERS
+// ============================================
+export { ApiInterceptor, type ApiInterceptorConfig } from './helpers/ApiInterceptor'
+
+// ============================================
+// SESSION HELPERS
+// ============================================
+export {
+  DEFAULT_THEME_USERS,
+  loginAsDefaultOwner,
+  loginAsDefaultAdmin,
+  loginAsDefaultMember,
+  loginAsDefaultEditor,
+  loginAsDefaultViewer,
+  loginAsOwner,
+  loginAsMember,
+  loginAsAdmin,
+  loginAsEditor,
+  loginAsViewer,
+  loginAsDefaultDeveloper,
+  loginAsDefaultSuperadmin,
+} from './session-helpers'

package/templates/contents/themes/starter/tests/cypress/src/session-helpers.ts

@@ -1,46 +1,68 @@
 /**
- * Starter Theme Session Helpers
+ * Default Theme Session Helpers
  *
- * Direct login functions for theme tests using theme-specific users.
+ * Direct login functions for Default theme tests using theme-specific users.
  * These helpers don't depend on ACTIVE_THEME environment variable.
  *
- * IMPORTANT: After login, this helper sets activeTeamId in localStorage.
- * This is required because all entity API calls include x-team-id header
- * which is read from localStorage.activeTeamId.
+ * EXPERIMENTAL: Uses API-based login instead of UI login.
+ * Hypothesis: API login is faster and more stable than DevKeyring UI login,
+ * especially with slow dev servers (Turbopack on-demand compilation).
  *
- * CONFIGURATION: Credentials can be customized via Cypress env variables:
- * - CYPRESS_DEVELOPER_EMAIL: Override developer user email
- * - CYPRESS_DEVELOPER_PASSWORD: Override developer user password
- * - CYPRESS_OWNER_EMAIL, CYPRESS_ADMIN_EMAIL, etc.: Override specific roles
+ * Test file: cypress/e2e/_experimental/api-login-test.cy.ts
+ * Fallback: If API fails, falls back to UI login with DevKeyring.
  *
- * Set these in cypress.config.ts env section or via CLI:
- *   pnpm cy:open --env DEVELOPER_EMAIL=myuser@example.com,DEVELOPER_PASSWORD=MyPass123
+ * IMPORTANT: After login, this helper sets activeTeamId in localStorage.
+ * This is required because all entity API calls include x-team-id header
+ * which is read from localStorage.activeTeamId (see core/lib/api/entities.ts).
+ * Without this, API calls return 400 "Team context required".
  */
 
+import { DevKeyringPOM as DevKeyring } from './components/DevKeyringPOM'
+
 /**
  * Environment-based Test Credentials
- * Fallback values use developer@nextspark.dev (pre-installed from core)
+ *
+ * These can be overridden via Cypress env variables (cypress.config.ts or CLI):
+ * - CYPRESS_DEVELOPER_EMAIL / CYPRESS_DEVELOPER_PASSWORD - Developer user
+ * - CYPRESS_SUPERADMIN_EMAIL / CYPRESS_SUPERADMIN_PASSWORD - Superadmin user
+ * - CYPRESS_OWNER_EMAIL, CYPRESS_ADMIN_EMAIL, etc. - Demo theme users
+ *
+ * Fallback values are the default users from core and theme sample data.
  */
+
+// Core system user credentials (configurable via env)
 const DEVELOPER_EMAIL = Cypress.env('DEVELOPER_EMAIL') || 'developer@nextspark.dev'
 const DEVELOPER_PASSWORD = Cypress.env('DEVELOPER_PASSWORD') || 'Pandora1234'
+const SUPERADMIN_PASSWORD = Cypress.env('SUPERADMIN_PASSWORD') || 'Pandora1234'
+
+// Demo user password (configurable via env)
+const TEST_PASSWORD = Cypress.env('TEST_PASSWORD') || 'Test1234'
 
 /**
- * Theme Test Users
- * Using developer@nextspark.dev which comes pre-installed from core
- * and has full platform access (superadmin + developer role)
+ * Default Theme Test Users
+ * Teams: Everpoint Labs, Ironvale Global, Riverstone Ventures
  *
- * All roles use the same user for simplicity in starter theme.
- * Customize via CYPRESS_DEVELOPER_EMAIL env variable.
+ * Note: These are fallback demo users. For selector tests, use CORE_USER (developer).
  */
-export const THEME_USERS = {
-  OWNER: Cypress.env('OWNER_EMAIL') || DEVELOPER_EMAIL,
-  ADMIN: Cypress.env('ADMIN_EMAIL') || DEVELOPER_EMAIL,
-  MEMBER: Cypress.env('MEMBER_EMAIL') || DEVELOPER_EMAIL,
-  VIEWER: Cypress.env('VIEWER_EMAIL') || DEVELOPER_EMAIL,
+export const DEFAULT_THEME_USERS = {
+  OWNER: Cypress.env('OWNER_EMAIL') || 'carlos.mendoza@nextspark.dev',
+  ADMIN: Cypress.env('ADMIN_EMAIL') || 'james.wilson@nextspark.dev',
+  MEMBER: Cypress.env('MEMBER_EMAIL') || 'emily.johnson@nextspark.dev',
+  EDITOR: Cypress.env('EDITOR_EMAIL') || 'diego.ramirez@nextspark.dev',
+  VIEWER: Cypress.env('VIEWER_EMAIL') || 'sarah.davis@nextspark.dev',
 } as const
 
-// Common password for all test users (configurable via env)
-const TEST_PASSWORD = DEVELOPER_PASSWORD
+/**
+ * Core System Users (from core/migrations/090_sample_data.sql)
+ * These users have special global roles, not team-based roles
+ *
+ * IMPORTANT: DEVELOPER is the recommended user for most tests.
+ * Configurable via CYPRESS_DEVELOPER_EMAIL env variable.
+ */
+export const CORE_USERS = {
+  SUPERADMIN: Cypress.env('SUPERADMIN_EMAIL') || 'superadmin@nextspark.dev',
+  DEVELOPER: DEVELOPER_EMAIL,
+} as const
 
 // Extended timeout for dev server compilation (60s for slow cold starts)
 const API_TIMEOUT = 60000
@@ -54,8 +76,10 @@ const API_TIMEOUT = 60000
  * 3. Calls /api/v1/teams/switch to set server-side team cookie
  *
  * Without this, all entity API calls return 400 "Team context required"
+ *
+ * @param preferredRole - Optional role to filter teams by (e.g., 'member' to select team where user is member)
  */
-function setupTeamContext() {
+function setupTeamContext(preferredRole?: string) {
   cy.request({
     method: 'GET',
     url: '/api/v1/teams',
@@ -63,10 +87,23 @@ function setupTeamContext() {
     failOnStatusCode: false
   }).then((teamsResponse) => {
     if (teamsResponse.status === 200 && teamsResponse.body?.data?.length > 0) {
-      const firstTeam = teamsResponse.body.data[0]
-      const teamId = firstTeam.id
+      const teams = teamsResponse.body.data
 
-      cy.log(`Setting active team: ${firstTeam.name} (${teamId})`)
+      // If preferredRole specified, find team where user has that role
+      let selectedTeam = teams[0]
+      if (preferredRole) {
+        const teamWithRole = teams.find((t: { role: string }) => t.role === preferredRole)
+        if (teamWithRole) {
+          selectedTeam = teamWithRole
+          cy.log(`✅ Found team with role "${preferredRole}": ${selectedTeam.name}`)
+        } else {
+          cy.log(`⚠️ No team found with role "${preferredRole}", using first team`)
+        }
+      }
+
+      const teamId = selectedTeam.id
+
+      cy.log(`✅ Setting active team: ${selectedTeam.name} (${teamId}) - role: ${selectedTeam.role}`)
 
       // Set in localStorage (used by frontend buildHeaders() to add x-team-id)
       cy.window().then((win) => {
@@ -82,7 +119,7 @@ function setupTeamContext() {
         failOnStatusCode: false
       })
     } else {
-      cy.log(`Warning: No teams found for user, API calls requiring team context will fail`)
+      cy.log(`⚠️ No teams found for user, API calls requiring team context will fail`)
     }
   })
 }
@@ -90,47 +127,64 @@ function setupTeamContext() {
 /**
  * Login via API (faster and more stable than UI)
  * Returns true if API login succeeded, false if fallback to UI was needed.
+ *
+ * @param email - User email to login
+ * @param password - Optional password (defaults to TEST_PASSWORD for demo users)
  */
-function apiLogin(email: string): Cypress.Chainable<boolean> {
+function apiLogin(email: string, password: string = TEST_PASSWORD): Cypress.Chainable<boolean> {
   return cy.request({
     method: 'POST',
     url: '/api/auth/sign-in/email',
-    body: { email, password: TEST_PASSWORD },
+    body: { email, password },
     timeout: API_TIMEOUT,
     failOnStatusCode: false
   }).then((response) => {
     if (response.status === 200) {
       return true
     } else {
-      cy.log(`Warning: API login failed with status ${response.status}, falling back to UI login`)
+      cy.log(`⚠️ API login failed with status ${response.status}, falling back to UI login`)
       // Fallback to UI login if API fails
       cy.visit('/login', { timeout: 60000 })
+      const devKeyring = new DevKeyring()
+      devKeyring.validateVisible()
+      devKeyring.quickLoginByEmail(email)
       return false
     }
   })
 }
 
 /**
- * Login as Owner
+ * Login as Default Theme Owner
  * Session is cached and reused across tests
+ *
+ * Flow:
+ * 1. API login (or UI fallback)
+ * 2. Visit dashboard to load page context
+ * 3. Setup team context (sets localStorage.activeTeamId)
  */
-export function loginAsOwner() {
-  cy.session('owner-session', () => {
-    apiLogin(THEME_USERS.OWNER).then((apiLoginSucceeded) => {
+export function loginAsDefaultOwner() {
+  cy.session('default-owner-session', () => {
+    apiLogin(DEFAULT_THEME_USERS.OWNER).then((apiLoginSucceeded) => {
+      // If API login succeeded, we need to visit a page before setting localStorage
       if (apiLoginSucceeded) {
         cy.visit('/dashboard', { timeout: 60000 })
       }
+      // URL assertion to ensure page loaded
       cy.url().should('include', '/dashboard')
+      // Setup team context (requires page to be loaded for localStorage)
       setupTeamContext()
     })
   }, {
     validate: () => {
+      // Validate auth session exists
       cy.request({
         url: '/api/auth/get-session',
         timeout: API_TIMEOUT,
         failOnStatusCode: false
       }).its('status').should('eq', 200)
 
+      // Validate team context exists in localStorage
+      // This ensures API calls will have x-team-id header
       cy.window().then((win) => {
         const teamId = win.localStorage.getItem('activeTeamId')
         expect(teamId, 'activeTeamId should exist in localStorage').to.not.be.null
@@ -141,12 +195,12 @@ export function loginAsOwner() {
 }
 
 /**
- * Login as Admin
+ * Login as Default Theme Admin
  * Session is cached and reused across tests
  */
-export function loginAsAdmin() {
-  cy.session('admin-session', () => {
-    apiLogin(THEME_USERS.ADMIN).then((apiLoginSucceeded) => {
+export function loginAsDefaultAdmin() {
+  cy.session('default-admin-session', () => {
+    apiLogin(DEFAULT_THEME_USERS.ADMIN).then((apiLoginSucceeded) => {
       if (apiLoginSucceeded) {
         cy.visit('/dashboard', { timeout: 60000 })
       }
@@ -165,17 +219,21 @@ export function loginAsAdmin() {
 }
 
 /**
- * Login as Member
+ * Login as Default Theme Member
  * Session is cached and reused across tests
+ *
+ * Note: Emily Johnson is member of Everpoint but admin of Riverstone.
+ * We explicitly select the team where she has 'member' role.
  */
-export function loginAsMember() {
-  cy.session('member-session', () => {
-    apiLogin(THEME_USERS.MEMBER).then((apiLoginSucceeded) => {
+export function loginAsDefaultMember() {
+  cy.session('default-member-session', () => {
+    apiLogin(DEFAULT_THEME_USERS.MEMBER).then((apiLoginSucceeded) => {
       if (apiLoginSucceeded) {
         cy.visit('/dashboard', { timeout: 60000 })
       }
       cy.url().should('include', '/dashboard')
-      setupTeamContext()
+      // Explicitly select team where user is member (not admin)
+      setupTeamContext('member')
     })
   }, {
     validate: () => {
@@ -189,12 +247,12 @@ export function loginAsMember() {
 }
 
 /**
- * Login as Viewer
+ * Login as Default Theme Viewer
  * Session is cached and reused across tests
  */
-export function loginAsViewer() {
-  cy.session('viewer-session', () => {
-    apiLogin(THEME_USERS.VIEWER).then((apiLoginSucceeded) => {
+export function loginAsDefaultViewer() {
+  cy.session('default-viewer-session', () => {
+    apiLogin(DEFAULT_THEME_USERS.VIEWER).then((apiLoginSucceeded) => {
       if (apiLoginSucceeded) {
         cy.visit('/dashboard', { timeout: 60000 })
       }
@@ -213,62 +271,248 @@ export function loginAsViewer() {
 }
 
 /**
- * Login with custom session management
- * Useful for specific email/password combinations
+ * Login as Default Theme Editor
+ * Session is cached and reused across tests
+ *
+ * Editor is a custom role with limited permissions:
+ * - Can view/list customers but cannot create/update/delete
+ * - Cannot access Admin or Dev Zone
  */
-export function loginWithSession(email: string, password: string) {
-  const sessionId = `session-${email.replace(/[@.]/g, '-')}`
-
-  cy.session(sessionId, () => {
-    cy.request({
-      method: 'POST',
-      url: '/api/auth/sign-in/email',
-      body: { email, password },
-      timeout: API_TIMEOUT,
-      failOnStatusCode: false
-    }).then((response) => {
-      if (response.status === 200) {
+export function loginAsDefaultEditor() {
+  cy.session('default-editor-session', () => {
+    apiLogin(DEFAULT_THEME_USERS.EDITOR).then((apiLoginSucceeded) => {
+      if (apiLoginSucceeded) {
         cy.visit('/dashboard', { timeout: 60000 })
-        cy.url().should('include', '/dashboard')
-        setupTeamContext()
-      } else {
-        throw new Error(`Login failed for ${email}: ${response.body?.error || 'Unknown error'}`)
       }
+      cy.url().should('include', '/dashboard')
+      setupTeamContext()
     })
+  }, {
+    validate: () => {
+      cy.request({
+        url: '/api/auth/get-session',
+        timeout: API_TIMEOUT,
+        failOnStatusCode: false
+      }).its('status').should('eq', 200)
+    }
   })
 }
 
 /**
- * Login as a specific role
+ * Login as Superadmin (core system user)
+ * Session is cached and reused across tests
+ *
+ * Superadmin has global access:
+ * - Full Admin access
+ * - Not team-based (no setupTeamContext needed)
  */
-export function loginAsRole(role: 'owner' | 'admin' | 'member' | 'viewer') {
-  const loginFunctions = {
-    owner: loginAsOwner,
-    admin: loginAsAdmin,
-    member: loginAsMember,
-    viewer: loginAsViewer,
-  }
-
-  const loginFn = loginFunctions[role]
-  if (loginFn) {
-    loginFn()
-  } else {
-    throw new Error(`Unknown role: ${role}`)
-  }
+export function loginAsDefaultSuperadmin() {
+  cy.session('default-superadmin-session', () => {
+    apiLogin(CORE_USERS.SUPERADMIN, SUPERADMIN_PASSWORD).then((apiLoginSucceeded) => {
+      if (apiLoginSucceeded) {
+        cy.visit('/superadmin', { timeout: 60000 })
+      }
+      // Superadmin should land on superadmin panel or dashboard
+      cy.url().should('satisfy', (url: string) => {
+        return url.includes('/superadmin') || url.includes('/dashboard')
+      })
+    })
+  }, {
+    validate: () => {
+      cy.request({
+        url: '/api/auth/get-session',
+        timeout: API_TIMEOUT,
+        failOnStatusCode: false
+      }).its('status').should('eq', 200)
+    }
+  })
 }
 
 /**
- * Clear all session data
+ * Login as Developer (core system user)
+ * Session is cached and reused across tests
+ *
+ * Developer has:
+ * - Dev Zone access
+ * - Not team-based (no setupTeamContext needed)
  */
-export function clearSession() {
-  cy.clearCookies()
-  cy.clearLocalStorage()
-  Cypress.session.clearAllSavedSessions()
+export function loginAsDefaultDeveloper() {
+  cy.session('default-developer-session', () => {
+    apiLogin(CORE_USERS.DEVELOPER, DEVELOPER_PASSWORD).then((apiLoginSucceeded) => {
+      if (apiLoginSucceeded) {
+        cy.visit('/devtools', { timeout: 60000 })
+      }
+      // Developer should land on devtools or dashboard
+      cy.url().should('satisfy', (url: string) => {
+        return url.includes('/devtools') || url.includes('/dashboard')
+      })
+    })
+  }, {
+    validate: () => {
+      cy.request({
+        url: '/api/auth/get-session',
+        timeout: API_TIMEOUT,
+        failOnStatusCode: false
+      }).its('status').should('eq', 200)
+    }
+  })
 }
 
+// Aliases for convenience
+export const loginAsOwner = loginAsDefaultOwner
+export const loginAsMember = loginAsDefaultMember
+export const loginAsAdmin = loginAsDefaultAdmin
+export const loginAsEditor = loginAsDefaultEditor
+export const loginAsViewer = loginAsDefaultViewer
+export const loginAsSuperadmin = loginAsDefaultSuperadmin
+export const loginAsDeveloper = loginAsDefaultDeveloper
+
 /**
  * Returns theme users for backwards compatibility with external helper pattern.
+ * Used by tests that import { getThemeUsers } from session-helpers.
  */
 export function getThemeUsers() {
-  return THEME_USERS
+  return DEFAULT_THEME_USERS
+}
+
+// ============================================================
+// BILLING TEST USERS
+// ============================================================
+
+/**
+ * Billing Test Users - Teams with different subscription plans
+ *
+ * These users/teams are used to test billing features from different plan perspectives:
+ * - Free Plan: Carlos's personal team (team-personal-carlos-001)
+ * - Pro Plan: Everpoint Labs (team-everpoint-001)
+ * - Enterprise Plan: Ironvale Global (team-ironvale-002)
+ */
+export const BILLING_TEAMS = {
+  FREE: {
+    teamId: 'team-personal-carlos-001',
+    name: 'Carlos Personal',
+    planSlug: 'free',
+    owner: 'carlos.mendoza@nextspark.dev'
+  },
+  PRO: {
+    teamId: 'team-everpoint-001',
+    name: 'Everpoint Labs',
+    planSlug: 'pro',
+    owner: 'carlos.mendoza@nextspark.dev'
+  },
+  ENTERPRISE: {
+    teamId: 'team-ironvale-002',
+    name: 'Ironvale Global',
+    planSlug: 'enterprise',
+    owner: 'ana.garcia@nextspark.dev'
+  }
+} as const
+
+/**
+ * Switch to a specific team after login
+ * @param teamId - Team ID to switch to
+ */
+function switchToTeam(teamId: string) {
+  cy.window().then((win) => {
+    win.localStorage.setItem('activeTeamId', teamId)
+  })
+
+  cy.request({
+    method: 'POST',
+    url: '/api/v1/teams/switch',
+    body: { teamId },
+    timeout: API_TIMEOUT,
+    failOnStatusCode: false
+  })
+}
+
+/**
+ * Login as Carlos and switch to Free plan team
+ * Used for testing Free plan restrictions
+ */
+export function loginAsFreePlanUser() {
+  cy.session('billing-free-plan-session', () => {
+    apiLogin(BILLING_TEAMS.FREE.owner).then((apiLoginSucceeded) => {
+      if (apiLoginSucceeded) {
+        cy.visit('/dashboard', { timeout: 60000, failOnStatusCode: false })
+      }
+      cy.url().should('include', '/dashboard')
+      // Switch to the Free team
+      switchToTeam(BILLING_TEAMS.FREE.teamId)
+    })
+  }, {
+    validate: () => {
+      cy.request({
+        url: '/api/auth/get-session',
+        timeout: API_TIMEOUT,
+        failOnStatusCode: false
+      }).its('status').should('eq', 200)
+
+      cy.window().then((win) => {
+        const teamId = win.localStorage.getItem('activeTeamId')
+        expect(teamId).to.eq(BILLING_TEAMS.FREE.teamId)
+      })
+    }
+  })
+}
+
+/**
+ * Login as Carlos and switch to Pro plan team (Everpoint)
+ * Used for testing Pro plan features
+ */
+export function loginAsProPlanUser() {
+  cy.session('billing-pro-plan-session', () => {
+    apiLogin(BILLING_TEAMS.PRO.owner).then((apiLoginSucceeded) => {
+      if (apiLoginSucceeded) {
+        cy.visit('/dashboard', { timeout: 60000, failOnStatusCode: false })
+      }
+      cy.url().should('include', '/dashboard')
+      // Switch to the Pro team
+      switchToTeam(BILLING_TEAMS.PRO.teamId)
+    })
+  }, {
+    validate: () => {
+      cy.request({
+        url: '/api/auth/get-session',
+        timeout: API_TIMEOUT,
+        failOnStatusCode: false
+      }).its('status').should('eq', 200)
+
+      cy.window().then((win) => {
+        const teamId = win.localStorage.getItem('activeTeamId')
+        expect(teamId).to.eq(BILLING_TEAMS.PRO.teamId)
+      })
+    }
+  })
+}
+
+/**
+ * Login as Ana and switch to Enterprise plan team (Ironvale)
+ * Used for testing Enterprise plan features
+ */
+export function loginAsEnterprisePlanUser() {
+  cy.session('billing-enterprise-plan-session', () => {
+    // Ana is owner of Ironvale
+    apiLogin(BILLING_TEAMS.ENTERPRISE.owner).then((apiLoginSucceeded) => {
+      if (apiLoginSucceeded) {
+        cy.visit('/dashboard', { timeout: 60000, failOnStatusCode: false })
+      }
+      cy.url().should('include', '/dashboard')
+      // Switch to the Enterprise team
+      switchToTeam(BILLING_TEAMS.ENTERPRISE.teamId)
+    })
+  }, {
+    validate: () => {
+      cy.request({
+        url: '/api/auth/get-session',
+        timeout: API_TIMEOUT,
+        failOnStatusCode: false
+      }).its('status').should('eq', 200)
+
+      cy.window().then((win) => {
+        const teamId = win.localStorage.getItem('activeTeamId')
+        expect(teamId).to.eq(BILLING_TEAMS.ENTERPRISE.teamId)
+      })
+    }
+  })
 }

package/templates/contents/themes/starter/tests/cypress.config.ts

@@ -10,8 +10,11 @@
 import { defineConfig } from 'cypress'
 import path from 'path'
 import fs from 'fs'
+import { fileURLToPath } from 'url'
 
-// __dirname works natively with CommonJS module resolution (tsconfig.cypress.json)
+// ESM-compatible __dirname
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
 
 // Paths relative to this config file
 const themeRoot = path.resolve(__dirname, '..')