workos 0.0.24 → 0.1.0

package/dist/src/lib/workos-management.js

@@ -0,0 +1,142 @@
+import { WIZARD_INTERACTION_EVENT_NAME } from './constants.js';
+import { analytics } from '../utils/analytics.js';
+import clack from '../utils/clack.js';
+import { getCallbackPath } from './port-detection.js';
+const WORKOS_API_BASE = 'https://api.workos.com';
+async function workosRequest(method, endpoint, apiKey, body) {
+    return fetch(`${WORKOS_API_BASE}${endpoint}`, {
+        method,
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+}
+async function parseFetchError(response) {
+    let data;
+    try {
+        data = await response.json();
+    }
+    catch {
+        // Response wasn't JSON
+    }
+    return {
+        status: response.status,
+        message: typeof data === 'object' && data && 'message' in data ? String(data.message) : '',
+        data,
+    };
+}
+/**
+ * Create a redirect URI in WorkOS.
+ * Returns success on 201 or 409 (already exists).
+ */
+async function createRedirectUri(apiKey, uri) {
+    const response = await workosRequest('POST', '/user_management/redirect_uris', apiKey, { uri });
+    if (response.ok) {
+        return { success: true, alreadyExists: false };
+    }
+    const error = await parseFetchError(response);
+    // WorkOS returns 422 (not 409) when URI already exists
+    if (error.status === 409 || (error.status === 422 && error.message.includes('already exists'))) {
+        return { success: true, alreadyExists: true };
+    }
+    throw new Error(error.message || `HTTP ${error.status}`);
+}
+/**
+ * Create a CORS origin in WorkOS.
+ * Returns success on 201 or 409 (already exists).
+ */
+async function createCorsOrigin(apiKey, origin) {
+    const response = await workosRequest('POST', '/user_management/cors_origins', apiKey, { origin });
+    if (response.ok) {
+        return { success: true, alreadyExists: false };
+    }
+    const error = await parseFetchError(response);
+    // WorkOS returns 422 (not 409) when origin already exists
+    if (error.status === 409 || (error.status === 422 && error.message.includes('already exists'))) {
+        return { success: true, alreadyExists: true };
+    }
+    throw new Error(error.message || `HTTP ${error.status}`);
+}
+/**
+ * Set the app homepage URL in WorkOS.
+ */
+async function setHomepageUrl(apiKey, url) {
+    const response = await workosRequest('PUT', '/user_management/app_homepage_url', apiKey, { url });
+    if (!response.ok) {
+        const error = await parseFetchError(response);
+        throw new Error(error.message || `HTTP ${error.status}`);
+    }
+    return { success: true };
+}
+/**
+ * Auto-configure WorkOS dashboard settings for local development.
+ * Sets redirect URI, CORS origin, and homepage URL via the WorkOS API.
+ *
+ * @param apiKey - WorkOS API key (sk_xxx)
+ * @param integration - Framework integration type
+ * @param port - Detected or default dev server port
+ * @param options - Optional overrides for homepage URL and redirect URI
+ *
+ * Non-blocking: failures are logged but don't stop the wizard.
+ */
+export async function autoConfigureWorkOSEnvironment(apiKey, integration, port, options = {}) {
+    const baseUrl = `http://localhost:${port}`;
+    const callbackPath = getCallbackPath(integration);
+    const callbackUrl = options.redirectUri || `${baseUrl}${callbackPath}`;
+    const homepageUrlValue = options.homepageUrl || baseUrl;
+    clack.log.step('Configuring WorkOS dashboard settings via API...');
+    clack.log.info(`  Redirect URI: ${callbackUrl}`);
+    clack.log.info(`  CORS origin: ${baseUrl}`);
+    clack.log.info(`  Homepage URL: ${homepageUrlValue}`);
+    try {
+        const [redirectUri, corsOrigin, homepageUrl] = await Promise.all([
+            createRedirectUri(apiKey, callbackUrl),
+            createCorsOrigin(apiKey, baseUrl),
+            setHomepageUrl(apiKey, homepageUrlValue),
+        ]);
+        const results = { redirectUri, corsOrigin, homepageUrl };
+        analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {
+            action: 'workos environment auto-configured',
+            integration,
+            port,
+            redirectUri: redirectUri.alreadyExists ? 'existed' : 'created',
+            corsOrigin: corsOrigin.alreadyExists ? 'existed' : 'created',
+        });
+        // Build user feedback
+        const messages = [];
+        messages.push(redirectUri.alreadyExists
+            ? `Redirect URI: ${callbackUrl} (already existed)`
+            : `Redirect URI: ${callbackUrl} (created)`);
+        messages.push(corsOrigin.alreadyExists ? `CORS origin: ${baseUrl} (already existed)` : `CORS origin: ${baseUrl} (created)`);
+        messages.push(`Homepage URL: ${homepageUrlValue} (updated)`);
+        clack.log.success('WorkOS dashboard configured:\n  ' + messages.join('\n  '));
+        return results;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        // Provide specific guidance for common errors
+        if (message.includes('401') || message.includes('Invalid API key')) {
+            clack.log.warn('Could not configure WorkOS dashboard: Invalid API key');
+        }
+        else if (message.includes('403') || message.includes('permission')) {
+            clack.log.warn('Could not configure WorkOS dashboard: API key lacks permission');
+        }
+        else if (message.includes('422') || message.includes('Validation')) {
+            clack.log.warn(`Could not configure WorkOS dashboard: Validation error`);
+            clack.log.info(`  Error: ${message}`);
+        }
+        else {
+            clack.log.warn(`Could not configure WorkOS dashboard: ${message}`);
+        }
+        clack.log.info('You can configure these settings manually in the WorkOS dashboard.');
+        analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {
+            action: 'workos environment auto-config failed',
+            integration,
+            error: message,
+        });
+        return null;
+    }
+}
+//# sourceMappingURL=workos-management.js.map

package/dist/src/lib/workos-management.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workos-management.js","sourceRoot":"","sources":["../../../src/lib/workos-management.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Integration } from './constants.js';\nimport { WIZARD_INTERACTION_EVENT_NAME } from './constants.js';\nimport { analytics } from '../utils/analytics.js';\nimport clack from '../utils/clack.js';\nimport { getCallbackPath } from './port-detection.js';\n\nconst WORKOS_API_BASE = 'https://api.workos.com';\n\nexport interface AutoConfigResult {\n  redirectUri: { success: boolean; alreadyExists: boolean };\n  corsOrigin: { success: boolean; alreadyExists: boolean };\n  homepageUrl: { success: boolean };\n}\n\ninterface FetchError {\n  status: number;\n  message: string;\n  data?: unknown;\n}\n\nasync function workosRequest(\n  method: 'POST' | 'PUT',\n  endpoint: string,\n  apiKey: string,\n  body: Record<string, string>,\n): Promise<Response> {\n  return fetch(`${WORKOS_API_BASE}${endpoint}`, {\n    method,\n    headers: {\n      Authorization: `Bearer ${apiKey}`,\n      'Content-Type': 'application/json',\n    },\n    body: JSON.stringify(body),\n  });\n}\n\nasync function parseFetchError(response: Response): Promise<FetchError> {\n  let data: unknown;\n  try {\n    data = await response.json();\n  } catch {\n    // Response wasn't JSON\n  }\n  return {\n    status: response.status,\n    message: typeof data === 'object' && data && 'message' in data ? String((data as { message: string }).message) : '',\n    data,\n  };\n}\n\n/**\n * Create a redirect URI in WorkOS.\n * Returns success on 201 or 409 (already exists).\n */\nasync function createRedirectUri(apiKey: string, uri: string): Promise<{ success: boolean; alreadyExists: boolean }> {\n  const response = await workosRequest('POST', '/user_management/redirect_uris', apiKey, { uri });\n\n  if (response.ok) {\n    return { success: true, alreadyExists: false };\n  }\n\n  const error = await parseFetchError(response);\n  // WorkOS returns 422 (not 409) when URI already exists\n  if (error.status === 409 || (error.status === 422 && error.message.includes('already exists'))) {\n    return { success: true, alreadyExists: true };\n  }\n\n  throw new Error(error.message || `HTTP ${error.status}`);\n}\n\n/**\n * Create a CORS origin in WorkOS.\n * Returns success on 201 or 409 (already exists).\n */\nasync function createCorsOrigin(apiKey: string, origin: string): Promise<{ success: boolean; alreadyExists: boolean }> {\n  const response = await workosRequest('POST', '/user_management/cors_origins', apiKey, { origin });\n\n  if (response.ok) {\n    return { success: true, alreadyExists: false };\n  }\n\n  const error = await parseFetchError(response);\n  // WorkOS returns 422 (not 409) when origin already exists\n  if (error.status === 409 || (error.status === 422 && error.message.includes('already exists'))) {\n    return { success: true, alreadyExists: true };\n  }\n\n  throw new Error(error.message || `HTTP ${error.status}`);\n}\n\n/**\n * Set the app homepage URL in WorkOS.\n */\nasync function setHomepageUrl(apiKey: string, url: string): Promise<{ success: boolean }> {\n  const response = await workosRequest('PUT', '/user_management/app_homepage_url', apiKey, { url });\n\n  if (!response.ok) {\n    const error = await parseFetchError(response);\n    throw new Error(error.message || `HTTP ${error.status}`);\n  }\n\n  return { success: true };\n}\n\nexport interface AutoConfigOptions {\n  /** Custom homepage URL (defaults to http://localhost:{port}) */\n  homepageUrl?: string;\n  /** Custom redirect URI (defaults to framework convention) */\n  redirectUri?: string;\n}\n\n/**\n * Auto-configure WorkOS dashboard settings for local development.\n * Sets redirect URI, CORS origin, and homepage URL via the WorkOS API.\n *\n * @param apiKey - WorkOS API key (sk_xxx)\n * @param integration - Framework integration type\n * @param port - Detected or default dev server port\n * @param options - Optional overrides for homepage URL and redirect URI\n *\n * Non-blocking: failures are logged but don't stop the wizard.\n */\nexport async function autoConfigureWorkOSEnvironment(\n  apiKey: string,\n  integration: Integration,\n  port: number,\n  options: AutoConfigOptions = {},\n): Promise<AutoConfigResult | null> {\n  const baseUrl = `http://localhost:${port}`;\n  const callbackPath = getCallbackPath(integration);\n  const callbackUrl = options.redirectUri || `${baseUrl}${callbackPath}`;\n  const homepageUrlValue = options.homepageUrl || baseUrl;\n\n  clack.log.step('Configuring WorkOS dashboard settings via API...');\n  clack.log.info(`  Redirect URI: ${callbackUrl}`);\n  clack.log.info(`  CORS origin: ${baseUrl}`);\n  clack.log.info(`  Homepage URL: ${homepageUrlValue}`);\n\n  try {\n    const [redirectUri, corsOrigin, homepageUrl] = await Promise.all([\n      createRedirectUri(apiKey, callbackUrl),\n      createCorsOrigin(apiKey, baseUrl),\n      setHomepageUrl(apiKey, homepageUrlValue),\n    ]);\n\n    const results: AutoConfigResult = { redirectUri, corsOrigin, homepageUrl };\n\n    analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {\n      action: 'workos environment auto-configured',\n      integration,\n      port,\n      redirectUri: redirectUri.alreadyExists ? 'existed' : 'created',\n      corsOrigin: corsOrigin.alreadyExists ? 'existed' : 'created',\n    });\n\n    // Build user feedback\n    const messages: string[] = [];\n    messages.push(\n      redirectUri.alreadyExists\n        ? `Redirect URI: ${callbackUrl} (already existed)`\n        : `Redirect URI: ${callbackUrl} (created)`,\n    );\n    messages.push(\n      corsOrigin.alreadyExists ? `CORS origin: ${baseUrl} (already existed)` : `CORS origin: ${baseUrl} (created)`,\n    );\n    messages.push(`Homepage URL: ${homepageUrlValue} (updated)`);\n\n    clack.log.success('WorkOS dashboard configured:\\n  ' + messages.join('\\n  '));\n\n    return results;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Unknown error';\n\n    // Provide specific guidance for common errors\n    if (message.includes('401') || message.includes('Invalid API key')) {\n      clack.log.warn('Could not configure WorkOS dashboard: Invalid API key');\n    } else if (message.includes('403') || message.includes('permission')) {\n      clack.log.warn('Could not configure WorkOS dashboard: API key lacks permission');\n    } else if (message.includes('422') || message.includes('Validation')) {\n      clack.log.warn(`Could not configure WorkOS dashboard: Validation error`);\n      clack.log.info(`  Error: ${message}`);\n    } else {\n      clack.log.warn(`Could not configure WorkOS dashboard: ${message}`);\n    }\n\n    clack.log.info('You can configure these settings manually in the WorkOS dashboard.');\n\n    analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {\n      action: 'workos environment auto-config failed',\n      integration,\n      error: message,\n    });\n\n    return null;\n  }\n}\n"]}

package/dist/src/nextjs/nextjs-wizard-agent.d.ts

@@ -0,0 +1,6 @@
+import type { WizardOptions } from '../utils/types.js';
+/**
+ * Next.js wizard powered by the universal agent runner.
+ * @returns Summary of what was done, or empty string if version check fails
+ */
+export declare function runNextjsWizardAgent(options: WizardOptions): Promise<string>;

package/dist/src/nextjs/nextjs-wizard-agent.js

@@ -0,0 +1,97 @@
+import { enableDebugLogs } from '../utils/debug.js';
+import { runAgentWizard } from '../lib/agent-runner.js';
+import { Integration } from '../lib/constants.js';
+import { getPackageVersion } from '../utils/package-json.js';
+import { getPackageDotJson } from '../utils/clack-utils.js';
+import clack from '../utils/clack.js';
+import chalk from 'chalk';
+import * as semver from 'semver';
+import { getNextJsRouter, getNextJsVersionBucket, getNextJsRouterName, NextJsRouter } from './utils.js';
+/**
+ * Next.js framework configuration for the universal agent runner.
+ */
+const MINIMUM_NEXTJS_VERSION = '15.3.0';
+const NEXTJS_AGENT_CONFIG = {
+    metadata: {
+        name: 'Next.js',
+        integration: Integration.nextjs,
+        docsUrl: 'https://workos.com/docs/user-management/authkit/nextjs',
+        unsupportedVersionDocsUrl: 'https://workos.com/docs/user-management/authkit/nextjs',
+        skillName: 'workos-authkit-nextjs',
+        gatherContext: async (options) => {
+            const router = await getNextJsRouter(options);
+            return { router };
+        },
+    },
+    detection: {
+        packageName: 'next',
+        packageDisplayName: 'Next.js',
+        getVersion: (packageJson) => getPackageVersion('next', packageJson),
+        getVersionBucket: getNextJsVersionBucket,
+    },
+    environment: {
+        uploadToHosting: true,
+        requiresApiKey: true, // Server-side framework
+        getEnvVars: (apiKey, clientId) => ({
+            WORKOS_API_KEY: apiKey,
+            WORKOS_CLIENT_ID: clientId,
+        }),
+    },
+    analytics: {
+        getTags: (context) => {
+            const router = context.router;
+            return {
+                router: router === NextJsRouter.APP_ROUTER ? 'app' : 'pages',
+            };
+        },
+    },
+    prompts: {
+        getAdditionalContextLines: (context) => {
+            const router = context.router;
+            const routerType = router === NextJsRouter.APP_ROUTER ? 'app' : 'pages';
+            return [`Router: ${routerType}`];
+        },
+    },
+    ui: {
+        successMessage: 'WorkOS AuthKit integration complete',
+        getOutroChanges: (context) => {
+            const router = context.router;
+            const routerName = getNextJsRouterName(router);
+            return [
+                `Analyzed your Next.js project structure (${routerName})`,
+                `Created and configured WorkOS AuthKit`,
+                `Integrated authentication into your application`,
+            ];
+        },
+        getOutroNextSteps: () => {
+            return [
+                'Start your development server to test authentication',
+                'Visit the WorkOS Dashboard to manage users and settings',
+            ];
+        },
+    },
+};
+/**
+ * Next.js wizard powered by the universal agent runner.
+ * @returns Summary of what was done, or empty string if version check fails
+ */
+export async function runNextjsWizardAgent(options) {
+    if (options.debug) {
+        enableDebugLogs();
+    }
+    // Check Next.js version - agent wizard requires >= 15.3.0
+    const packageJson = await getPackageDotJson(options);
+    const nextVersion = getPackageVersion('next', packageJson);
+    if (nextVersion) {
+        const coercedVersion = semver.coerce(nextVersion);
+        if (coercedVersion && semver.lt(coercedVersion, MINIMUM_NEXTJS_VERSION)) {
+            const docsUrl = NEXTJS_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ?? NEXTJS_AGENT_CONFIG.metadata.docsUrl;
+            clack.log.warn(`Sorry: the wizard can't help you with Next.js ${nextVersion}. Upgrade to Next.js ${MINIMUM_NEXTJS_VERSION} or later, or check out the manual setup guide.`);
+            clack.log.info(`Setup Next.js manually: ${chalk.cyan(docsUrl)}`);
+            clack.outro('WorkOS AuthKit wizard will see you next time!');
+            return '';
+        }
+    }
+    return runAgentWizard(NEXTJS_AGENT_CONFIG, options);
+}
+//# sourceMappingURL=nextjs-wizard-agent.js.map

package/dist/src/nextjs/nextjs-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-wizard-agent.js","sourceRoot":"","sources":["../../../src/nextjs/nextjs-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Simplified Next.js wizard using Claude Agent SDK with WorkOS MCP */\nimport type { WizardOptions } from '../utils/types.js';\nimport { enableDebugLogs } from '../utils/debug.js';\nimport { runAgentWizard } from '../lib/agent-runner.js';\nimport { Integration } from '../lib/constants.js';\nimport { getPackageVersion } from '../utils/package-json.js';\nimport { getPackageDotJson } from '../utils/clack-utils.js';\nimport clack from '../utils/clack.js';\nimport chalk from 'chalk';\nimport * as semver from 'semver';\nimport { getNextJsRouter, getNextJsVersionBucket, getNextJsRouterName, NextJsRouter } from './utils.js';\n\n/**\n * Next.js framework configuration for the universal agent runner.\n */\nconst MINIMUM_NEXTJS_VERSION = '15.3.0';\n\nconst NEXTJS_AGENT_CONFIG = {\n  metadata: {\n    name: 'Next.js',\n    integration: Integration.nextjs,\n    docsUrl: 'https://workos.com/docs/user-management/authkit/nextjs',\n    unsupportedVersionDocsUrl: 'https://workos.com/docs/user-management/authkit/nextjs',\n    skillName: 'workos-authkit-nextjs',\n    gatherContext: async (options: WizardOptions) => {\n      const router = await getNextJsRouter(options);\n      return { router };\n    },\n  },\n\n  detection: {\n    packageName: 'next',\n    packageDisplayName: 'Next.js',\n    getVersion: (packageJson: any) => getPackageVersion('next', packageJson),\n    getVersionBucket: getNextJsVersionBucket,\n  },\n\n  environment: {\n    uploadToHosting: true,\n    requiresApiKey: true, // Server-side framework\n    getEnvVars: (apiKey: string, clientId: string) => ({\n      WORKOS_API_KEY: apiKey,\n      WORKOS_CLIENT_ID: clientId,\n    }),\n  },\n\n  analytics: {\n    getTags: (context: any) => {\n      const router = context.router as NextJsRouter;\n      return {\n        router: router === NextJsRouter.APP_ROUTER ? 'app' : 'pages',\n      };\n    },\n  },\n\n  prompts: {\n    getAdditionalContextLines: (context: any) => {\n      const router = context.router as NextJsRouter;\n      const routerType = router === NextJsRouter.APP_ROUTER ? 'app' : 'pages';\n      return [`Router: ${routerType}`];\n    },\n  },\n\n  ui: {\n    successMessage: 'WorkOS AuthKit integration complete',\n    getOutroChanges: (context: any) => {\n      const router = context.router as NextJsRouter;\n      const routerName = getNextJsRouterName(router);\n      return [\n        `Analyzed your Next.js project structure (${routerName})`,\n        `Created and configured WorkOS AuthKit`,\n        `Integrated authentication into your application`,\n      ];\n    },\n    getOutroNextSteps: () => {\n      return [\n        'Start your development server to test authentication',\n        'Visit the WorkOS Dashboard to manage users and settings',\n      ];\n    },\n  },\n};\n\n/**\n * Next.js wizard powered by the universal agent runner.\n * @returns Summary of what was done, or empty string if version check fails\n */\nexport async function runNextjsWizardAgent(options: WizardOptions): Promise<string> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  // Check Next.js version - agent wizard requires >= 15.3.0\n  const packageJson = await getPackageDotJson(options);\n  const nextVersion = getPackageVersion('next', packageJson);\n\n  if (nextVersion) {\n    const coercedVersion = semver.coerce(nextVersion);\n    if (coercedVersion && semver.lt(coercedVersion, MINIMUM_NEXTJS_VERSION)) {\n      const docsUrl = NEXTJS_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ?? NEXTJS_AGENT_CONFIG.metadata.docsUrl;\n\n      clack.log.warn(\n        `Sorry: the wizard can't help you with Next.js ${nextVersion}. Upgrade to Next.js ${MINIMUM_NEXTJS_VERSION} or later, or check out the manual setup guide.`,\n      );\n      clack.log.info(`Setup Next.js manually: ${chalk.cyan(docsUrl)}`);\n      clack.outro('WorkOS AuthKit wizard will see you next time!');\n      return '';\n    }\n  }\n\n  return runAgentWizard(NEXTJS_AGENT_CONFIG, options);\n}\n"]}

package/dist/src/nextjs/utils.d.ts

@@ -0,0 +1,8 @@
+import type { WizardOptions } from '../utils/types.js';
+export declare function getNextJsVersionBucket(version: string | undefined): string;
+export declare enum NextJsRouter {
+    APP_ROUTER = "app-router",
+    PAGES_ROUTER = "pages-router"
+}
+export declare function getNextJsRouter({ installDir }: Pick<WizardOptions, 'installDir'>): Promise<NextJsRouter>;
+export declare const getNextJsRouterName: (router: NextJsRouter) => "app router" | "pages router";

package/dist/src/nextjs/utils.js

@@ -0,0 +1,53 @@
+import fg from 'fast-glob';
+import { abortIfCancelled } from '../utils/clack-utils.js';
+import clack from '../utils/clack.js';
+import { getVersionBucket } from '../utils/semver.js';
+import { IGNORE_PATTERNS, Integration } from '../lib/constants.js';
+export function getNextJsVersionBucket(version) {
+    return getVersionBucket(version, 11);
+}
+export var NextJsRouter;
+(function (NextJsRouter) {
+    NextJsRouter["APP_ROUTER"] = "app-router";
+    NextJsRouter["PAGES_ROUTER"] = "pages-router";
+})(NextJsRouter || (NextJsRouter = {}));
+export async function getNextJsRouter({ installDir }) {
+    const pagesMatches = await fg('**/pages/_app.@(ts|tsx|js|jsx)', {
+        dot: true,
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    const hasPagesDir = pagesMatches.length > 0;
+    const appMatches = await fg('**/app/**/layout.@(ts|tsx|js|jsx)', {
+        dot: true,
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    const hasAppDir = appMatches.length > 0;
+    if (hasPagesDir && !hasAppDir) {
+        clack.log.info(`Detected ${getNextJsRouterName(NextJsRouter.PAGES_ROUTER)} 📃`);
+        return NextJsRouter.PAGES_ROUTER;
+    }
+    if (hasAppDir && !hasPagesDir) {
+        clack.log.info(`Detected ${getNextJsRouterName(NextJsRouter.APP_ROUTER)} 📱`);
+        return NextJsRouter.APP_ROUTER;
+    }
+    const result = await abortIfCancelled(clack.select({
+        message: 'What router are you using?',
+        options: [
+            {
+                label: getNextJsRouterName(NextJsRouter.APP_ROUTER),
+                value: NextJsRouter.APP_ROUTER,
+            },
+            {
+                label: getNextJsRouterName(NextJsRouter.PAGES_ROUTER),
+                value: NextJsRouter.PAGES_ROUTER,
+            },
+        ],
+    }), Integration.nextjs);
+    return result;
+}
+export const getNextJsRouterName = (router) => {
+    return router === NextJsRouter.APP_ROUTER ? 'app router' : 'pages router';
+};
+//# sourceMappingURL=utils.js.map

package/dist/src/nextjs/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/nextjs/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,UAAU,sBAAsB,CAAC,OAA2B;IAChE,OAAO,gBAAgB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,yCAAyB,CAAA;IACzB,6CAA6B,CAAA;AAC/B,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAE,UAAU,EAAqC;IACrF,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,gCAAgC,EAAE;QAC9D,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,eAAe;KACxB,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAE5C,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,mCAAmC,EAAE;QAC/D,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,eAAe;KACxB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAExC,IAAI,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,mBAAmB,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAChF,OAAO,YAAY,CAAC,YAAY,CAAC;IACnC,CAAC;IAED,IAAI,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,mBAAmB,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC9E,OAAO,YAAY,CAAC,UAAU,CAAC;IACjC,CAAC;IAED,MAAM,MAAM,GAAiB,MAAM,gBAAgB,CACjD,KAAK,CAAC,MAAM,CAAC;QACX,OAAO,EAAE,4BAA4B;QACrC,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,mBAAmB,CAAC,YAAY,CAAC,UAAU,CAAC;gBACnD,KAAK,EAAE,YAAY,CAAC,UAAU;aAC/B;YACD;gBACE,KAAK,EAAE,mBAAmB,CAAC,YAAY,CAAC,YAAY,CAAC;gBACrD,KAAK,EAAE,YAAY,CAAC,YAAY;aACjC;SACF;KACF,CAAC,EACF,WAAW,CAAC,MAAM,CACnB,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAoB,EAAE,EAAE;IAC1D,OAAO,MAAM,KAAK,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC;AAC5E,CAAC,CAAC","sourcesContent":["import fg from 'fast-glob';\nimport { abortIfCancelled } from '../utils/clack-utils.js';\nimport clack from '../utils/clack.js';\nimport { getVersionBucket } from '../utils/semver.js';\nimport type { WizardOptions } from '../utils/types.js';\nimport { IGNORE_PATTERNS, Integration } from '../lib/constants.js';\n\nexport function getNextJsVersionBucket(version: string | undefined): string {\n  return getVersionBucket(version, 11);\n}\n\nexport enum NextJsRouter {\n  APP_ROUTER = 'app-router',\n  PAGES_ROUTER = 'pages-router',\n}\n\nexport async function getNextJsRouter({ installDir }: Pick<WizardOptions, 'installDir'>): Promise<NextJsRouter> {\n  const pagesMatches = await fg('**/pages/_app.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  const hasPagesDir = pagesMatches.length > 0;\n\n  const appMatches = await fg('**/app/**/layout.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  const hasAppDir = appMatches.length > 0;\n\n  if (hasPagesDir && !hasAppDir) {\n    clack.log.info(`Detected ${getNextJsRouterName(NextJsRouter.PAGES_ROUTER)} 📃`);\n    return NextJsRouter.PAGES_ROUTER;\n  }\n\n  if (hasAppDir && !hasPagesDir) {\n    clack.log.info(`Detected ${getNextJsRouterName(NextJsRouter.APP_ROUTER)} 📱`);\n    return NextJsRouter.APP_ROUTER;\n  }\n\n  const result: NextJsRouter = await abortIfCancelled(\n    clack.select({\n      message: 'What router are you using?',\n      options: [\n        {\n          label: getNextJsRouterName(NextJsRouter.APP_ROUTER),\n          value: NextJsRouter.APP_ROUTER,\n        },\n        {\n          label: getNextJsRouterName(NextJsRouter.PAGES_ROUTER),\n          value: NextJsRouter.PAGES_ROUTER,\n        },\n      ],\n    }),\n    Integration.nextjs,\n  );\n\n  return result;\n}\n\nexport const getNextJsRouterName = (router: NextJsRouter) => {\n  return router === NextJsRouter.APP_ROUTER ? 'app router' : 'pages router';\n};\n"]}

package/dist/src/react/react-wizard-agent.d.ts

@@ -0,0 +1,2 @@
+import type { WizardOptions } from '../utils/types.js';
+export declare function runReactWizardAgent(options: WizardOptions): Promise<string>;

package/dist/src/react/react-wizard-agent.js

@@ -0,0 +1,47 @@
+import { enableDebugLogs } from '../utils/debug.js';
+import { runAgentWizard } from '../lib/agent-runner.js';
+import { Integration } from '../lib/constants.js';
+const REACT_AGENT_CONFIG = {
+    metadata: {
+        name: 'React',
+        integration: Integration.react,
+        docsUrl: 'https://workos.com/docs/user-management/authkit/react',
+        unsupportedVersionDocsUrl: 'https://workos.com/docs/user-management/authkit/react',
+        skillName: 'workos-authkit-react',
+    },
+    detection: {
+        packageName: 'react',
+        packageDisplayName: 'React',
+        getVersion: (packageJson) => packageJson.dependencies?.react || packageJson.devDependencies?.react,
+    },
+    environment: {
+        uploadToHosting: false,
+        requiresApiKey: false, // Client-only SPA
+        getEnvVars: (_apiKey, clientId) => ({
+            WORKOS_CLIENT_ID: clientId, // Only client ID needed
+        }),
+    },
+    analytics: {
+        getTags: () => ({}),
+    },
+    prompts: {},
+    ui: {
+        successMessage: 'WorkOS AuthKit integration complete',
+        getOutroChanges: () => [
+            'Analyzed your React project structure',
+            'Created and configured WorkOS AuthKit',
+            'Integrated authentication into your application',
+        ],
+        getOutroNextSteps: () => [
+            'Start your development server to test authentication',
+            'Visit the WorkOS Dashboard to manage users and settings',
+        ],
+    },
+};
+export async function runReactWizardAgent(options) {
+    if (options.debug) {
+        enableDebugLogs();
+    }
+    return runAgentWizard(REACT_AGENT_CONFIG, options);
+}
+//# sourceMappingURL=react-wizard-agent.js.map

package/dist/src/react/react-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-wizard-agent.js","sourceRoot":"","sources":["../../../src/react/react-wizard-agent.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,kBAAkB,GAAoB;IAC1C,QAAQ,EAAE;QACR,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,WAAW,CAAC,KAAK;QAC9B,OAAO,EAAE,uDAAuD;QAChE,yBAAyB,EAAE,uDAAuD;QAClF,SAAS,EAAE,sBAAsB;KAClC;IAED,SAAS,EAAE;QACT,WAAW,EAAE,OAAO;QACpB,kBAAkB,EAAE,OAAO;QAC3B,UAAU,EAAE,CAAC,WAAgB,EAAE,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,KAAK,IAAI,WAAW,CAAC,eAAe,EAAE,KAAK;KACxG;IAED,WAAW,EAAE;QACX,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK,EAAE,kBAAkB;QACzC,UAAU,EAAE,CAAC,OAAe,EAAE,QAAgB,EAAE,EAAE,CAAC,CAAC;YAClD,gBAAgB,EAAE,QAAQ,EAAE,wBAAwB;SACrD,CAAC;KACH;IAED,SAAS,EAAE;QACT,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;KACpB;IAED,OAAO,EAAE,EAAE;IAEX,EAAE,EAAE;QACF,cAAc,EAAE,qCAAqC;QACrD,eAAe,EAAE,GAAG,EAAE,CAAC;YACrB,uCAAuC;YACvC,uCAAuC;YACvC,iDAAiD;SAClD;QACD,iBAAiB,EAAE,GAAG,EAAE,CAAC;YACvB,sDAAsD;YACtD,yDAAyD;SAC1D;KACF;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAsB;IAC9D,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;IACpB,CAAC;IAED,OAAO,cAAc,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC","sourcesContent":["/* React SPA wizard using Claude Agent SDK */\nimport type { WizardOptions } from '../utils/types.js';\nimport type { FrameworkConfig } from '../lib/framework-config.js';\nimport { enableDebugLogs } from '../utils/debug.js';\nimport { runAgentWizard } from '../lib/agent-runner.js';\nimport { Integration } from '../lib/constants.js';\n\nconst REACT_AGENT_CONFIG: FrameworkConfig = {\n  metadata: {\n    name: 'React',\n    integration: Integration.react,\n    docsUrl: 'https://workos.com/docs/user-management/authkit/react',\n    unsupportedVersionDocsUrl: 'https://workos.com/docs/user-management/authkit/react',\n    skillName: 'workos-authkit-react',\n  },\n\n  detection: {\n    packageName: 'react',\n    packageDisplayName: 'React',\n    getVersion: (packageJson: any) => packageJson.dependencies?.react || packageJson.devDependencies?.react,\n  },\n\n  environment: {\n    uploadToHosting: false,\n    requiresApiKey: false, // Client-only SPA\n    getEnvVars: (_apiKey: string, clientId: string) => ({\n      WORKOS_CLIENT_ID: clientId, // Only client ID needed\n    }),\n  },\n\n  analytics: {\n    getTags: () => ({}),\n  },\n\n  prompts: {},\n\n  ui: {\n    successMessage: 'WorkOS AuthKit integration complete',\n    getOutroChanges: () => [\n      'Analyzed your React project structure',\n      'Created and configured WorkOS AuthKit',\n      'Integrated authentication into your application',\n    ],\n    getOutroNextSteps: () => [\n      'Start your development server to test authentication',\n      'Visit the WorkOS Dashboard to manage users and settings',\n    ],\n  },\n};\n\nexport async function runReactWizardAgent(options: WizardOptions): Promise<string> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  return runAgentWizard(REACT_AGENT_CONFIG, options);\n}\n"]}

package/dist/src/react-router/react-router-wizard-agent.d.ts

@@ -0,0 +1,6 @@
+import type { WizardOptions } from '../utils/types.js';
+/**
+ * React Router wizard powered by the universal agent runner.
+ * @returns Summary of what was done, or empty string if version check fails
+ */
+export declare function runReactRouterWizardAgent(options: WizardOptions): Promise<string>;

package/dist/src/react-router/react-router-wizard-agent.js

@@ -0,0 +1,103 @@
+import { enableDebugLogs } from '../utils/debug.js';
+import { runAgentWizard } from '../lib/agent-runner.js';
+import { Integration } from '../lib/constants.js';
+import { getPackageVersion } from '../utils/package-json.js';
+import { getPackageDotJson } from '../utils/clack-utils.js';
+import clack from '../utils/clack.js';
+import chalk from 'chalk';
+import * as semver from 'semver';
+import { getReactRouterMode, getReactRouterModeName, getReactRouterVersionBucket, ReactRouterMode } from './utils.js';
+/**
+ * React Router framework configuration for the universal agent runner.
+ */
+const MINIMUM_REACT_ROUTER_VERSION = '6.0.0';
+const REACT_ROUTER_AGENT_CONFIG = {
+    metadata: {
+        name: 'React Router',
+        integration: Integration.reactRouter,
+        docsUrl: 'https://workos.com/docs/user-management/authkit/react-router',
+        unsupportedVersionDocsUrl: 'https://workos.com/docs/user-management/authkit/react-router',
+        skillName: 'workos-authkit-react-router',
+        gatherContext: async (options) => {
+            const routerMode = await getReactRouterMode(options);
+            return { routerMode };
+        },
+    },
+    detection: {
+        packageName: 'react-router',
+        packageDisplayName: 'React Router',
+        getVersion: (packageJson) => getPackageVersion('react-router', packageJson),
+        getVersionBucket: getReactRouterVersionBucket,
+    },
+    environment: {
+        uploadToHosting: false,
+        requiresApiKey: true, // Can do SSR
+        getEnvVars: (apiKey, clientId) => ({
+            WORKOS_API_KEY: apiKey,
+            WORKOS_CLIENT_ID: clientId,
+        }),
+    },
+    analytics: {
+        getTags: (context) => {
+            const routerMode = context.routerMode;
+            return {
+                routerMode: routerMode || 'unknown',
+            };
+        },
+    },
+    prompts: {
+        getAdditionalContextLines: (context) => {
+            const routerMode = context.routerMode;
+            const modeName = routerMode ? getReactRouterModeName(routerMode) : 'unknown';
+            // Map router mode to framework ID for MCP docs resource
+            const frameworkIdMap = {
+                [ReactRouterMode.V6]: 'react-react-router-6',
+                [ReactRouterMode.V7_FRAMEWORK]: 'react-react-router-7-framework',
+                [ReactRouterMode.V7_DATA]: 'react-react-router-7-data',
+                [ReactRouterMode.V7_DECLARATIVE]: 'react-react-router-7-declarative',
+            };
+            const frameworkId = routerMode ? frameworkIdMap[routerMode] : ReactRouterMode.V7_FRAMEWORK;
+            return [`Router mode: ${modeName}`, `Framework docs ID: ${frameworkId}`];
+        },
+    },
+    ui: {
+        successMessage: 'WorkOS AuthKit integration complete',
+        getOutroChanges: (context) => {
+            const routerMode = context.routerMode;
+            const modeName = routerMode ? getReactRouterModeName(routerMode) : 'React Router';
+            return [
+                `Analyzed your React Router project structure (${modeName})`,
+                `Created and configured WorkOS AuthKit`,
+                `Integrated authentication into your application`,
+            ];
+        },
+        getOutroNextSteps: () => [
+            'Start your development server to test authentication',
+            'Visit the WorkOS Dashboard to manage users and settings',
+        ],
+    },
+};
+/**
+ * React Router wizard powered by the universal agent runner.
+ * @returns Summary of what was done, or empty string if version check fails
+ */
+export async function runReactRouterWizardAgent(options) {
+    if (options.debug) {
+        enableDebugLogs();
+    }
+    // Check React Router version - agent wizard requires >= 6.0.0
+    const packageJson = await getPackageDotJson(options);
+    const reactRouterVersion = getPackageVersion('react-router', packageJson);
+    if (reactRouterVersion) {
+        const coercedVersion = semver.coerce(reactRouterVersion);
+        if (coercedVersion && semver.lt(coercedVersion, MINIMUM_REACT_ROUTER_VERSION)) {
+            const docsUrl = REACT_ROUTER_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ?? REACT_ROUTER_AGENT_CONFIG.metadata.docsUrl;
+            clack.log.warn(`Sorry: the wizard can't help you with React Router ${reactRouterVersion}. Upgrade to React Router ${MINIMUM_REACT_ROUTER_VERSION} or later, or check out the manual setup guide.`);
+            clack.log.info(`Setup React Router manually: ${chalk.cyan(docsUrl)}`);
+            clack.outro('WorkOS AuthKit wizard will see you next time!');
+            return '';
+        }
+    }
+    return runAgentWizard(REACT_ROUTER_AGENT_CONFIG, options);
+}
+//# sourceMappingURL=react-router-wizard-agent.js.map

package/dist/src/react-router/react-router-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-router-wizard-agent.js","sourceRoot":"","sources":["../../../src/react-router/react-router-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* React Router wizard using Claude Agent SDK with WorkOS MCP */\nimport type { WizardOptions } from '../utils/types.js';\nimport type { FrameworkConfig } from '../lib/framework-config.js';\nimport { enableDebugLogs } from '../utils/debug.js';\nimport { runAgentWizard } from '../lib/agent-runner.js';\nimport { Integration } from '../lib/constants.js';\nimport { getPackageVersion } from '../utils/package-json.js';\nimport { getPackageDotJson } from '../utils/clack-utils.js';\nimport clack from '../utils/clack.js';\nimport chalk from 'chalk';\nimport * as semver from 'semver';\nimport { getReactRouterMode, getReactRouterModeName, getReactRouterVersionBucket, ReactRouterMode } from './utils.js';\n\n/**\n * React Router framework configuration for the universal agent runner.\n */\nconst MINIMUM_REACT_ROUTER_VERSION = '6.0.0';\n\nconst REACT_ROUTER_AGENT_CONFIG: FrameworkConfig = {\n  metadata: {\n    name: 'React Router',\n    integration: Integration.reactRouter,\n    docsUrl: 'https://workos.com/docs/user-management/authkit/react-router',\n    unsupportedVersionDocsUrl: 'https://workos.com/docs/user-management/authkit/react-router',\n    skillName: 'workos-authkit-react-router',\n    gatherContext: async (options: WizardOptions) => {\n      const routerMode = await getReactRouterMode(options);\n      return { routerMode };\n    },\n  },\n\n  detection: {\n    packageName: 'react-router',\n    packageDisplayName: 'React Router',\n    getVersion: (packageJson: any) => getPackageVersion('react-router', packageJson),\n    getVersionBucket: getReactRouterVersionBucket,\n  },\n\n  environment: {\n    uploadToHosting: false,\n    requiresApiKey: true, // Can do SSR\n    getEnvVars: (apiKey: string, clientId: string) => ({\n      WORKOS_API_KEY: apiKey,\n      WORKOS_CLIENT_ID: clientId,\n    }),\n  },\n\n  analytics: {\n    getTags: (context: any) => {\n      const routerMode = context.routerMode as ReactRouterMode;\n      return {\n        routerMode: routerMode || 'unknown',\n      };\n    },\n  },\n\n  prompts: {\n    getAdditionalContextLines: (context: any) => {\n      const routerMode = context.routerMode as ReactRouterMode;\n      const modeName = routerMode ? getReactRouterModeName(routerMode) : 'unknown';\n\n      // Map router mode to framework ID for MCP docs resource\n      const frameworkIdMap: Record<ReactRouterMode, string> = {\n        [ReactRouterMode.V6]: 'react-react-router-6',\n        [ReactRouterMode.V7_FRAMEWORK]: 'react-react-router-7-framework',\n        [ReactRouterMode.V7_DATA]: 'react-react-router-7-data',\n        [ReactRouterMode.V7_DECLARATIVE]: 'react-react-router-7-declarative',\n      };\n\n      const frameworkId = routerMode ? frameworkIdMap[routerMode] : ReactRouterMode.V7_FRAMEWORK;\n\n      return [`Router mode: ${modeName}`, `Framework docs ID: ${frameworkId}`];\n    },\n  },\n\n  ui: {\n    successMessage: 'WorkOS AuthKit integration complete',\n    getOutroChanges: (context: any) => {\n      const routerMode = context.routerMode as ReactRouterMode;\n      const modeName = routerMode ? getReactRouterModeName(routerMode) : 'React Router';\n      return [\n        `Analyzed your React Router project structure (${modeName})`,\n        `Created and configured WorkOS AuthKit`,\n        `Integrated authentication into your application`,\n      ];\n    },\n    getOutroNextSteps: () => [\n      'Start your development server to test authentication',\n      'Visit the WorkOS Dashboard to manage users and settings',\n    ],\n  },\n};\n\n/**\n * React Router wizard powered by the universal agent runner.\n * @returns Summary of what was done, or empty string if version check fails\n */\nexport async function runReactRouterWizardAgent(options: WizardOptions): Promise<string> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  // Check React Router version - agent wizard requires >= 6.0.0\n  const packageJson = await getPackageDotJson(options);\n  const reactRouterVersion = getPackageVersion('react-router', packageJson);\n\n  if (reactRouterVersion) {\n    const coercedVersion = semver.coerce(reactRouterVersion);\n    if (coercedVersion && semver.lt(coercedVersion, MINIMUM_REACT_ROUTER_VERSION)) {\n      const docsUrl =\n        REACT_ROUTER_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ?? REACT_ROUTER_AGENT_CONFIG.metadata.docsUrl;\n\n      clack.log.warn(\n        `Sorry: the wizard can't help you with React Router ${reactRouterVersion}. Upgrade to React Router ${MINIMUM_REACT_ROUTER_VERSION} or later, or check out the manual setup guide.`,\n      );\n      clack.log.info(`Setup React Router manually: ${chalk.cyan(docsUrl)}`);\n      clack.outro('WorkOS AuthKit wizard will see you next time!');\n      return '';\n    }\n  }\n\n  return runAgentWizard(REACT_ROUTER_AGENT_CONFIG, options);\n}\n"]}

package/dist/src/react-router/utils.d.ts

@@ -0,0 +1,19 @@
+import type { WizardOptions } from '../utils/types.js';
+export declare enum ReactRouterMode {
+    V6 = "v6",// React Router v6
+    V7_FRAMEWORK = "v7-framework",// React Router v7 with react-router.config.ts
+    V7_DATA = "v7-data",// React Router v7 with createBrowserRouter
+    V7_DECLARATIVE = "v7-declarative"
+}
+/**
+ * Get React Router version bucket for analytics
+ */
+export declare function getReactRouterVersionBucket(version: string | undefined): string;
+/**
+ * Detect React Router mode
+ */
+export declare function getReactRouterMode(options: WizardOptions): Promise<ReactRouterMode>;
+/**
+ * Get human-readable name for React Router mode
+ */
+export declare function getReactRouterModeName(mode: ReactRouterMode): string;