test: add debug logging and bump CI workers to 4 for stress testing

Author: jacekradko

integration/playwright.config.ts

@@ -7,14 +7,17 @@ import * as path from 'path';
 
 config({ path: path.resolve(__dirname, '.env.local') });
 
+// Enable debug logging for @clerk/testing route handler
+process.env.CLERK_TESTING_DEBUG = '1';
+
 export const common: PlaywrightTestConfig = {
   testDir: './tests',
   snapshotDir: './tests/snapshots',
   fullyParallel: true,
   forbidOnly: !!process.env.CI,
   retries: process.env.CI ? 5 : 0,
   maxFailures: process.env.CI ? 5 : undefined,
-  workers: process.env.E2E_WORKERS ? Number(process.env.E2E_WORKERS) : process.env.CI ? '50%' : '70%',
+  workers: process.env.E2E_WORKERS ? Number(process.env.E2E_WORKERS) : process.env.CI ? 4 : '70%',
   use: {
     actionTimeout: 10_000,
     navigationTimeout: 30_000,

packages/testing/src/playwright/setupClerkTestingToken.ts

@@ -42,6 +42,9 @@ export const setupClerkTestingToken = async ({ context, options, page }: SetupCl
   }
 
   if (setupContexts.has(browserContext)) {
+    if (process.env.CLERK_TESTING_DEBUG) {
+      console.log('[Clerk Testing] Route handler already registered for this context, skipping duplicate setup');
+    }
     return;
   }
   setupContexts.add(browserContext);
@@ -72,6 +75,11 @@ export const setupClerkTestingToken = async ({ context, options, page }: SetupCl
         if (RETRYABLE_STATUS_CODES.has(status)) {
           if (attempt < MAX_ROUTE_RETRIES) {
             const delay = BASE_DELAY_MS * Math.pow(2, attempt) + Math.random() * JITTER_MAX_MS;
+            if (process.env.CLERK_TESTING_DEBUG) {
+              console.log(
+                `[Clerk Testing] FAPI returned ${status}, retrying (attempt ${attempt + 1}/${MAX_ROUTE_RETRIES}, delay ${Math.round(delay)}ms): ${route.request().url()}`,
+              );
+            }
             await new Promise(resolve => setTimeout(resolve, delay));
             continue;
           }
@@ -100,6 +108,12 @@ export const setupClerkTestingToken = async ({ context, options, page }: SetupCl
       } catch (error) {
         if (attempt < MAX_ROUTE_RETRIES) {
           const delay = BASE_DELAY_MS * Math.pow(2, attempt) + Math.random() * JITTER_MAX_MS;
+          if (process.env.CLERK_TESTING_DEBUG) {
+            console.log(
+              `[Clerk Testing] FAPI request error, retrying (attempt ${attempt + 1}/${MAX_ROUTE_RETRIES}, delay ${Math.round(delay)}ms): ${route.request().url()}`,
+              error,
+            );
+          }
           await new Promise(resolve => setTimeout(resolve, delay));
           continue;
         }