test(e2e): move integration tests into suite directories

.claude/skills/clerk-monorepo/SKILL.md

@@ -150,8 +150,10 @@ How the cache key is built:
   `@clerk/clerk-js`, `@clerk/ui` and `@clerk/testing`, plus the framework packages that suite's apps
   add. Turbo folds those build hashes into the suite hash, and package builds already depend on
   `^build`, so transitive packages such as `@clerk/shared` are covered without being listed.
-- `inputs` covers the harness, the top-level test files, the test directories the suite's tagged tests
-  live in (and import from), and the templates its apps copy. Other suites' directories are not inputs.
+- `inputs` covers the harness, the test directories the suite's tagged tests live in (and import
+  from), and the templates its apps copy. Other suites' directories are not inputs. Tests live under
+  `integration/tests/<suite>/`; a test tagged for several suites lives in `generic/`, and tests no
+  suite runs live in `unscheduled/`.
 - `scripts/integration-deps.test.mjs` derives both lists from `integration/presets` and the tagged
   tests and fails when `turbo.json` drifts. Its failure message prints the block to paste.
 

integration/tests/billing-hooks.test.ts → integration/tests/billing/billing-hooks.test.ts

@@ -1,7 +1,7 @@
 import { expect, test } from '@playwright/test';
 
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({})('billing hooks @billing', ({ app }) => {
   test.describe.configure({ mode: 'parallel' });

integration/tests/per-seat-pricing.test.ts → integration/tests/billing/per-seat-pricing.test.ts

@@ -1,7 +1,7 @@
 import { expect, test } from '@playwright/test';
 
-import type { FakeOrganization, FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import type { FakeOrganization, FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 const INVITEE_EMAIL = 'one+clerk_test@clerk.dev';
 

integration/tests/pricing-table.test.ts → integration/tests/billing/pricing-table.test.ts

@@ -1,8 +1,8 @@
 import type { Locator } from '@playwright/test';
 import { expect, test } from '@playwright/test';
 
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({})('pricing table @billing', ({ app }) => {
   test.describe.configure({ mode: 'parallel' });

integration/tests/cache-components.test.ts → integration/tests/cache-components/cache-components.test.ts

@@ -1,8 +1,8 @@
 import { expect, test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({ withEnv: [appConfigs.envs.withEmailCodes], withPattern: ['next.cacheComponents'] })(
   'Next.js Cache Components @cache-components',

integration/tests/client-trust.test.ts → integration/tests/generic/client-trust.test.ts

@@ -1,8 +1,8 @@
 import { expect, test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({ withEnv: [appConfigs.envs.withNeedsClientTrust] })(
   'client trust flow @generic @nextjs',

integration/tests/components.test.ts → integration/tests/generic/components.test.ts

@@ -1,8 +1,8 @@
 import { expect, test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import type { FakeOrganization, FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import type { FakeOrganization, FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({ withEnv: [appConfigs.envs.withEmailCodes] })('component smoke tests @generic', ({ app }) => {
   let fakeUser: FakeUser;

integration/tests/composed-components.test.ts → integration/tests/generic/composed-components.test.ts

@@ -1,11 +1,11 @@
 import { type BrowserContext, expect, type Page, test } from '@playwright/test';
 
-import type { Application } from '../models/application';
-import { appConfigs } from '../presets';
-import { PKGLAB } from '../presets/utils';
-import type { FakeOrganization, FakeUser } from '../testUtils';
-import { createTestUtils } from '../testUtils';
-import { stringPhoneNumber } from '../testUtils/phoneUtils';
+import type { Application } from '../../models/application';
+import { appConfigs } from '../../presets';
+import { PKGLAB } from '../../presets/utils';
+import type { FakeOrganization, FakeUser } from '../../testUtils';
+import { createTestUtils } from '../../testUtils';
+import { stringPhoneNumber } from '../../testUtils/phoneUtils';
 
 /**
  * E2E parity coverage for the experimental composed exports from `@clerk/ui/experimental`.

integration/tests/custom-pages.test.ts → integration/tests/generic/custom-pages.test.ts

@@ -1,9 +1,9 @@
 /* eslint-disable turbo/no-undeclared-env-vars */
 import { expect, test } from '@playwright/test';
 
-import type { Application } from '../models/application';
-import type { CreateAppPageObjectArgs, FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import type { Application } from '../../models/application';
+import type { CreateAppPageObjectArgs, FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 const CUSTOM_PROFILE_PAGE = '/custom-user-profile';
 const CUSTOM_BUTTON_PAGE = '/custom-user-button';

integration/tests/dev-browser-partitioned-cookies.test.ts → integration/tests/generic/dev-browser-partitioned-cookies.test.ts

@@ -1,9 +1,9 @@
 import { expect, test } from '@playwright/test';
 import { parsePublishableKey } from '@clerk/shared/keys';
 
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({ withEnv: [appConfigs.envs.withEmailCodes] })(
   'dev browser partitioned cookies @generic',

integration/tests/email-code.test.ts → integration/tests/generic/email-code.test.ts

@@ -1,9 +1,9 @@
 import { expect, test } from '@playwright/test';
 
-import type { Application } from '../models/application';
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils } from '../testUtils';
+import type { Application } from '../../models/application';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils } from '../../testUtils';
 
 test.describe('sign up and sign in with email code @generic', () => {
   const configs = [appConfigs.next.appRouter, appConfigs.react.vite];

integration/tests/handshake.test.ts → integration/tests/generic/handshake.test.ts

@@ -2,10 +2,10 @@ import * as http from 'node:http';
 
 import { expect, test } from '@playwright/test';
 
-import type { OrganizationSyncOptions } from '../../packages/backend/src/tokens/types';
-import type { Application } from '../models/application';
-import { appConfigs } from '../presets';
-import { generateConfig, getJwksFromSecretKey } from '../testUtils/handshake';
+import type { OrganizationSyncOptions } from '../../../packages/backend/src/tokens/types';
+import type { Application } from '../../models/application';
+import { appConfigs } from '../../presets';
+import { generateConfig, getJwksFromSecretKey } from '../../testUtils/handshake';
 
 const PORT = 4199;
 

integration/tests/impersonation-flow.test.ts → integration/tests/generic/impersonation-flow.test.ts

@@ -1,9 +1,9 @@
 import type { User } from '@clerk/backend';
 import { expect, test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({ withEnv: [appConfigs.envs.withEmailCodes] })('Impersonation Flow @generic', ({ app }) => {
   test.describe.configure({ mode: 'serial' });

integration/tests/last-authentication-strategy.test.ts → integration/tests/generic/last-authentication-strategy.test.ts

@@ -2,8 +2,8 @@ import type { LastAuthenticationStrategy } from '@clerk/shared/types';
 import type { Page } from '@playwright/test';
 import { expect, test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 const mockLastAuthenticationStrategyResponse = async (
   page: Page,

integration/tests/legal-consent.test.ts → integration/tests/generic/legal-consent.test.ts

@@ -1,7 +1,7 @@
 import { expect, test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({ withEnv: [appConfigs.envs.withLegalConsent] })(
   'sign up flow with legal consent @generic @nextjs',

integration/tests/navigation.test.ts → integration/tests/generic/navigation.test.ts

@@ -1,7 +1,7 @@
 import { test } from '@playwright/test';
 
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({ withPattern: ['next.appRouter.withEmailCodes'] })('navigation modes @generic', ({ app }) => {
   test.describe.configure({ mode: 'serial' });

integration/tests/non-secure-context.test.ts → integration/tests/generic/non-secure-context.test.ts

@@ -16,9 +16,9 @@ import type { Server } from 'node:http';
 
 import { test } from '@playwright/test';
 
-import { createProxyServer } from '../scripts/proxyServer';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { createProxyServer } from '../../scripts/proxyServer';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 // This NEEDS to be a domain that points to localhost
 // and is not listed in the HSTS preload list

integration/tests/offline-session-persistence.test.ts → integration/tests/generic/offline-session-persistence.test.ts

@@ -1,8 +1,8 @@
 import { expect, test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({ withEnv: [appConfigs.envs.withEmailCodes] })(
   'offline session persistence @generic',

integration/tests/passkeys.test.ts → integration/tests/generic/passkeys.test.ts

@@ -1,10 +1,10 @@
 import type { BrowserContext, Page } from '@playwright/test';
 import { expect, test } from '@playwright/test';
 
-import type { Application } from '../models/application';
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils } from '../testUtils';
+import type { Application } from '../../models/application';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils } from '../../testUtils';
 
 type SavedCredential = {
   id: string;

integration/tests/protect-check.test.ts → integration/tests/generic/protect-check.test.ts

@@ -1,10 +1,10 @@
 import type { Page } from '@playwright/test';
 import { expect, test } from '@playwright/test';
 
-import type { Application } from '../models/application';
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils } from '../testUtils';
+import type { Application } from '../../models/application';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils } from '../../testUtils';
 
 const waitForProtectCheckSubmit = (page: Page) =>
   page.waitForResponse(

integration/tests/protect-service.test.ts → integration/tests/generic/protect-service.test.ts

@@ -2,8 +2,8 @@ import type { ProtectConfigJSON } from '@clerk/shared/types';
 import type { Page } from '@playwright/test';
 import { expect, test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 const mockProtectSettings = async (page: Page, config?: ProtectConfigJSON) => {
   await page.route('*/**/v1/environment*', async route => {

integration/tests/resiliency.test.ts → integration/tests/generic/resiliency.test.ts

@@ -1,8 +1,8 @@
 import { expect, test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 const make429ClerkResponse = () => ({
   status: 429,

integration/tests/safari-itp.test.ts → integration/tests/generic/safari-itp.test.ts

@@ -1,8 +1,8 @@
 import { expect, test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 /**
  * Tests Safari ITP (Intelligent Tracking Prevention) workaround

integration/tests/sign-in-flow.test.ts → integration/tests/generic/sign-in-flow.test.ts

@@ -1,8 +1,8 @@
 import { expect, test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({ withEnv: [appConfigs.envs.withEmailCodes] })('sign in flow @generic @nextjs', ({ app }) => {
   test.describe.configure({ mode: 'serial' });

integration/tests/sign-out-smoke.test.ts → integration/tests/generic/sign-out-smoke.test.ts

@@ -1,8 +1,8 @@
 import { expect, test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({ withEnv: [appConfigs.envs.withEmailCodes] })('sign out smoke test @generic', ({ app }) => {
   test.describe.configure({ mode: 'serial' });

integration/tests/sign-up-flow.test.ts → integration/tests/generic/sign-up-flow.test.ts

@@ -1,7 +1,7 @@
 import { expect, test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({ withEnv: [appConfigs.envs.withEmailCodes] })('sign up flow @generic @nextjs', ({ app }) => {
   test.describe.configure({ mode: 'parallel' });

integration/tests/update-props.test.ts → integration/tests/generic/update-props.test.ts

@@ -1,7 +1,7 @@
 import { test } from '@playwright/test';
 
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({ withPattern: ['react.vite.withEmailCodes'] })('sign in flow @generic', ({ app }) => {
   test.describe.configure({ mode: 'serial' });

integration/tests/user-avatar.test.ts → integration/tests/generic/user-avatar.test.ts

@@ -1,8 +1,8 @@
 import { test } from '@playwright/test';
 
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils, testAgainstRunningApps } from '../testUtils';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils, testAgainstRunningApps } from '../../testUtils';
 
 testAgainstRunningApps({
   withEnv: [appConfigs.envs.withEmailCodes],

integration/tests/user-profile.test.ts → integration/tests/generic/user-profile.test.ts

@@ -1,10 +1,10 @@
 import { expect, test } from '@playwright/test';
 
-import type { Application } from '../models/application';
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils } from '../testUtils';
-import { stringPhoneNumber } from '../testUtils/phoneUtils';
+import type { Application } from '../../models/application';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils } from '../../testUtils';
+import { stringPhoneNumber } from '../../testUtils/phoneUtils';
 
 test.describe('user profile @generic', () => {
   test.describe.configure({ mode: 'serial' });

integration/tests/whatsapp-phone-code.test.ts → integration/tests/generic/whatsapp-phone-code.test.ts

@@ -2,10 +2,10 @@
 import type { Page } from '@playwright/test';
 import { expect, test } from '@playwright/test';
 
-import type { Application } from '../models/application';
-import { appConfigs } from '../presets';
-import type { FakeUser } from '../testUtils';
-import { createTestUtils } from '../testUtils';
+import type { Application } from '../../models/application';
+import { appConfigs } from '../../presets';
+import type { FakeUser } from '../../testUtils';
+import { createTestUtils } from '../../testUtils';
 
 const clickSendCodeViaSmsInstead = async (page: Page, verificationHeading: RegExp) => {
   await page.getByRole('heading', { name: verificationHeading }).waitFor();

integration/tests/api-keys-component.test.ts → integration/tests/machine/api-keys-component.test.ts

@@ -1,10 +1,10 @@
 import type { Page } from '@playwright/test';
 import { expect, test } from '@playwright/test';
 
-import type { Application } from '../models/application';
-import { appConfigs } from '../presets';
-import type { FakeOrganization, FakeUser } from '../testUtils';
-import { createTestUtils } from '../testUtils';
+import type { Application } from '../../models/application';
+import { appConfigs } from '../../presets';
+import type { FakeOrganization, FakeUser } from '../../testUtils';
+import { createTestUtils } from '../../testUtils';
 
 const mockAPIKeysEnvironmentSettings = async (
   page: Page,