workos 0.0.24 → 0.1.0

package/dist/src/lib/agent-runner.d.ts

@@ -0,0 +1,9 @@
+import { type FrameworkConfig } from './framework-config.js';
+import type { WizardOptions } from '../utils/types.js';
+/**
+ * Universal agent-powered wizard runner.
+ * Handles the complete flow for any framework using WorkOS MCP integration.
+ *
+ * @returns A detailed summary of what was done and next steps
+ */
+export declare function runAgentWizard(config: FrameworkConfig, options: WizardOptions): Promise<string>;

package/dist/src/lib/agent-runner.js

@@ -0,0 +1,213 @@
+import { SPINNER_MESSAGE } from './framework-config.js';
+import { validateInstallation } from './validation/index.js';
+import { ensurePackageIsInstalled, getOrAskForWorkOSCredentials, getPackageDotJson, isUsingTypeScript, } from '../utils/clack-utils.js';
+import { analytics } from '../utils/analytics.js';
+import { WIZARD_INTERACTION_EVENT_NAME } from './constants.js';
+import { initializeAgent, runAgent } from './agent-interface.js';
+import { uploadEnvironmentVariablesStep } from '../steps/index.js';
+import { autoConfigureWorkOSEnvironment } from './workos-management.js';
+import { detectPort, getCallbackPath } from './port-detection.js';
+import { writeEnvLocal } from './env-writer.js';
+/**
+ * Universal agent-powered wizard runner.
+ * Handles the complete flow for any framework using WorkOS MCP integration.
+ *
+ * @returns A detailed summary of what was done and next steps
+ */
+export async function runAgentWizard(config, options) {
+    // Emit status for UI adapters to render
+    options.emitter?.emit('status', {
+        message: `Setting up WorkOS AuthKit for ${config.metadata.name}`,
+    });
+    const typeScriptDetected = isUsingTypeScript(options);
+    // Git check is now handled by the state machine - no need to check here
+    // Framework detection and version
+    const packageJson = await getPackageDotJson(options);
+    await ensurePackageIsInstalled(packageJson, config.detection.packageName, config.detection.packageDisplayName);
+    const frameworkVersion = config.detection.getVersion(packageJson);
+    // Set analytics tags for framework version
+    if (frameworkVersion && config.detection.getVersionBucket) {
+        const versionBucket = config.detection.getVersionBucket(frameworkVersion);
+        analytics.setTag(`${config.metadata.integration}-version`, versionBucket);
+    }
+    analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {
+        action: 'started agent integration',
+        integration: config.metadata.integration,
+    });
+    // Get WorkOS credentials (API key optional for client-only SDKs)
+    const { apiKey, clientId } = await getOrAskForWorkOSCredentials(options, config.environment.requiresApiKey);
+    // Check if caller (state machine) already configured WorkOS environment
+    // If credentials were passed via options, the caller handled config+env writing
+    const callerHandledConfig = Boolean(options.apiKey || options.clientId);
+    // Auto-configure WorkOS environment (redirect URI, CORS, homepage)
+    // Skip if caller already handled this (prevents duplicate dashboard config output)
+    if (!callerHandledConfig && apiKey && config.environment.requiresApiKey) {
+        const port = detectPort(config.metadata.integration, options.installDir);
+        await autoConfigureWorkOSEnvironment(apiKey, config.metadata.integration, port, {
+            homepageUrl: options.homepageUrl,
+            redirectUri: options.redirectUri,
+        });
+    }
+    // Gather framework-specific context (e.g., Next.js router, React Native platform)
+    const frameworkContext = config.metadata.gatherContext ? await config.metadata.gatherContext(options) : {};
+    // Write environment variables to .env.local BEFORE agent runs
+    // Skip if caller already handled this (prevents double-writing)
+    if (!callerHandledConfig) {
+        const port = detectPort(config.metadata.integration, options.installDir);
+        const callbackPath = getCallbackPath(config.metadata.integration);
+        const redirectUri = options.redirectUri || `http://localhost:${port}${callbackPath}`;
+        // Next.js requires NEXT_PUBLIC_ prefix for client-side env vars
+        const redirectUriKey = config.metadata.integration === 'nextjs' ? 'NEXT_PUBLIC_WORKOS_REDIRECT_URI' : 'WORKOS_REDIRECT_URI';
+        writeEnvLocal(options.installDir, {
+            ...(apiKey ? { WORKOS_API_KEY: apiKey } : {}),
+            WORKOS_CLIENT_ID: clientId,
+            [redirectUriKey]: redirectUri,
+        });
+    }
+    // Set analytics tags from framework context
+    const contextTags = config.analytics.getTags(frameworkContext);
+    Object.entries(contextTags).forEach(([key, value]) => {
+        analytics.setTag(key, value);
+    });
+    // Build integration prompt (credentials are already in .env.local)
+    const integrationPrompt = buildIntegrationPrompt(config, {
+        frameworkVersion: frameworkVersion || 'latest',
+        typescript: typeScriptDetected,
+    }, frameworkContext);
+    // Initialize and run agent
+    // Spinner is now handled by adapters listening to agent:start/agent:progress events
+    const agent = await initializeAgent({
+        workingDirectory: options.installDir,
+        workOSApiKey: apiKey,
+        workOSApiHost: 'https://api.workos.com',
+    }, options);
+    // Run agent - errors will throw naturally with skill-based approach
+    const agentResult = await runAgent(agent, integrationPrompt, options, {
+        spinnerMessage: SPINNER_MESSAGE,
+        successMessage: config.ui.successMessage,
+        errorMessage: 'Integration failed',
+    }, options.emitter);
+    // If agent returned an error, throw so state machine can handle it
+    if (agentResult.error) {
+        await analytics.shutdown('error');
+        const message = agentResult.errorMessage || agentResult.error;
+        throw new Error(`Agent SDK error: ${message}`);
+    }
+    // Run post-installation validation
+    if (!options.noValidate) {
+        options.emitter?.emit('validation:start', { framework: config.metadata.integration });
+        const validationResult = await validateInstallation(config.metadata.integration, options.installDir, {
+            runBuild: true,
+        });
+        if (validationResult.issues.length > 0) {
+            options.emitter?.emit('validation:issues', { issues: validationResult.issues });
+        }
+        options.emitter?.emit('validation:complete', {
+            passed: validationResult.passed,
+            issueCount: validationResult.issues.length,
+            durationMs: validationResult.durationMs,
+        });
+    }
+    // Build environment variables from WorkOS credentials
+    const envVars = config.environment.getEnvVars(apiKey, clientId);
+    // Upload environment variables to hosting providers (if configured)
+    let uploadedEnvVars = [];
+    if (config.environment.uploadToHosting) {
+        uploadedEnvVars = await uploadEnvironmentVariablesStep(envVars, {
+            integration: config.metadata.integration,
+            options,
+        });
+    }
+    // Skip MCP server setup for now (WorkOS doesn't need it initially)
+    // await addMCPServerToClientsStep({ ... });
+    // Build outro message
+    const continueUrl = undefined; // No signup flow for WorkOS wizard
+    const changes = [
+        ...config.ui.getOutroChanges(frameworkContext),
+        Object.keys(envVars).length > 0 ? `Added environment variables to .env file` : '',
+        uploadedEnvVars.length > 0 ? `Uploaded environment variables to your hosting provider` : '',
+    ].filter(Boolean);
+    const nextSteps = [
+        ...config.ui.getOutroNextSteps(frameworkContext),
+        uploadedEnvVars.length === 0 && config.environment.uploadToHosting
+            ? `Upload your WorkOS credentials to your hosting provider`
+            : '',
+    ].filter(Boolean);
+    // Build detailed summary to return to caller (state machine)
+    const summary = buildCompletionSummary(config, changes, nextSteps, continueUrl);
+    await analytics.shutdown('success');
+    return summary;
+}
+/**
+ * Build the integration prompt for the agent.
+ * Uses skill-based approach where agent invokes framework-specific skill.
+ * Note: Credentials are pre-written to .env.local, so not included in prompt.
+ */
+function buildIntegrationPrompt(config, context, frameworkContext) {
+    const additionalLines = config.prompts.getAdditionalContextLines
+        ? config.prompts.getAdditionalContextLines(frameworkContext)
+        : [];
+    const additionalContext = additionalLines.length > 0 ? '\n' + additionalLines.map((line) => `- ${line}`).join('\n') : '';
+    const skillName = config.metadata.skillName;
+    if (!skillName) {
+        throw new Error(`Framework ${config.metadata.name} missing skillName in config`);
+    }
+    // Next.js uses NEXT_PUBLIC_ prefix for redirect URI
+    const redirectUriEnvVar = config.metadata.integration === 'nextjs' ? 'NEXT_PUBLIC_WORKOS_REDIRECT_URI' : 'WORKOS_REDIRECT_URI';
+    return `You are integrating WorkOS AuthKit into this ${config.metadata.name} application.
+
+## Project Context
+
+- Framework: ${config.metadata.name} ${context.frameworkVersion}
+- TypeScript: ${context.typescript ? 'Yes' : 'No'}${additionalContext}
+
+## Environment
+
+The following environment variables have been configured in .env.local:
+- WORKOS_API_KEY
+- WORKOS_CLIENT_ID
+- ${redirectUriEnvVar}
+- WORKOS_COOKIE_PASSWORD
+
+## Your Task
+
+Use the \`${skillName}\` skill to integrate WorkOS AuthKit into this application.
+
+The skill contains step-by-step instructions including:
+1. Fetching the SDK documentation
+2. Installing the SDK
+3. Creating the callback route
+4. Setting up middleware/auth handling
+5. Adding authentication UI to the home page
+
+Report your progress using [STATUS] prefixes.
+
+Begin by invoking the ${skillName} skill.`;
+}
+/**
+ * Build a completion summary for the event payload.
+ * This is a plain-text summary without styling (adapters handle presentation).
+ */
+function buildCompletionSummary(config, changes, nextSteps, continueUrl) {
+    const lines = [];
+    lines.push('Successfully installed WorkOS AuthKit!');
+    lines.push('');
+    if (changes.length > 0) {
+        lines.push('What the agent did:');
+        changes.forEach((change) => lines.push(`• ${change}`));
+        lines.push('');
+    }
+    if (nextSteps.length > 0) {
+        lines.push('Next steps:');
+        nextSteps.forEach((step) => lines.push(`• ${step}`));
+        lines.push('');
+    }
+    lines.push(`Learn more: ${config.metadata.docsUrl}`);
+    if (continueUrl) {
+        lines.push(`Continue onboarding: ${continueUrl}`);
+    }
+    lines.push('');
+    lines.push('Note: This wizard uses an LLM agent to analyze and modify your project. Please review the changes made.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=agent-runner.js.map

package/dist/src/lib/agent-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.js","sourceRoot":"","sources":["../../../src/lib/agent-runner.ts"],"names":[],"mappings":"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","sourcesContent":["import { SPINNER_MESSAGE, type FrameworkConfig } from './framework-config.js';\nimport { validateInstallation } from './validation/index.js';\nimport type { WizardOptions } from '../utils/types.js';\nimport {\n  ensurePackageIsInstalled,\n  getOrAskForWorkOSCredentials,\n  getPackageDotJson,\n  isUsingTypeScript,\n} from '../utils/clack-utils.js';\nimport { analytics } from '../utils/analytics.js';\nimport { WIZARD_INTERACTION_EVENT_NAME } from './constants.js';\nimport { initializeAgent, runAgent } from './agent-interface.js';\nimport { uploadEnvironmentVariablesStep } from '../steps/index.js';\nimport { autoConfigureWorkOSEnvironment } from './workos-management.js';\nimport { detectPort, getCallbackPath } from './port-detection.js';\nimport { writeEnvLocal } from './env-writer.js';\n\n/**\n * Universal agent-powered wizard runner.\n * Handles the complete flow for any framework using WorkOS MCP integration.\n *\n * @returns A detailed summary of what was done and next steps\n */\nexport async function runAgentWizard(config: FrameworkConfig, options: WizardOptions): Promise<string> {\n  // Emit status for UI adapters to render\n  options.emitter?.emit('status', {\n    message: `Setting up WorkOS AuthKit for ${config.metadata.name}`,\n  });\n\n  const typeScriptDetected = isUsingTypeScript(options);\n\n  // Git check is now handled by the state machine - no need to check here\n\n  // Framework detection and version\n  const packageJson = await getPackageDotJson(options);\n  await ensurePackageIsInstalled(packageJson, config.detection.packageName, config.detection.packageDisplayName);\n\n  const frameworkVersion = config.detection.getVersion(packageJson);\n\n  // Set analytics tags for framework version\n  if (frameworkVersion && config.detection.getVersionBucket) {\n    const versionBucket = config.detection.getVersionBucket(frameworkVersion);\n    analytics.setTag(`${config.metadata.integration}-version`, versionBucket);\n  }\n\n  analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {\n    action: 'started agent integration',\n    integration: config.metadata.integration,\n  });\n\n  // Get WorkOS credentials (API key optional for client-only SDKs)\n  const { apiKey, clientId } = await getOrAskForWorkOSCredentials(options, config.environment.requiresApiKey);\n\n  // Check if caller (state machine) already configured WorkOS environment\n  // If credentials were passed via options, the caller handled config+env writing\n  const callerHandledConfig = Boolean(options.apiKey || options.clientId);\n\n  // Auto-configure WorkOS environment (redirect URI, CORS, homepage)\n  // Skip if caller already handled this (prevents duplicate dashboard config output)\n  if (!callerHandledConfig && apiKey && config.environment.requiresApiKey) {\n    const port = detectPort(config.metadata.integration, options.installDir);\n    await autoConfigureWorkOSEnvironment(apiKey, config.metadata.integration, port, {\n      homepageUrl: options.homepageUrl,\n      redirectUri: options.redirectUri,\n    });\n  }\n\n  // Gather framework-specific context (e.g., Next.js router, React Native platform)\n  const frameworkContext = config.metadata.gatherContext ? await config.metadata.gatherContext(options) : {};\n\n  // Write environment variables to .env.local BEFORE agent runs\n  // Skip if caller already handled this (prevents double-writing)\n  if (!callerHandledConfig) {\n    const port = detectPort(config.metadata.integration, options.installDir);\n    const callbackPath = getCallbackPath(config.metadata.integration);\n    const redirectUri = options.redirectUri || `http://localhost:${port}${callbackPath}`;\n\n    // Next.js requires NEXT_PUBLIC_ prefix for client-side env vars\n    const redirectUriKey =\n      config.metadata.integration === 'nextjs' ? 'NEXT_PUBLIC_WORKOS_REDIRECT_URI' : 'WORKOS_REDIRECT_URI';\n\n    writeEnvLocal(options.installDir, {\n      ...(apiKey ? { WORKOS_API_KEY: apiKey } : {}),\n      WORKOS_CLIENT_ID: clientId,\n      [redirectUriKey]: redirectUri,\n    });\n  }\n\n  // Set analytics tags from framework context\n  const contextTags = config.analytics.getTags(frameworkContext);\n  Object.entries(contextTags).forEach(([key, value]) => {\n    analytics.setTag(key, value);\n  });\n\n  // Build integration prompt (credentials are already in .env.local)\n  const integrationPrompt = buildIntegrationPrompt(\n    config,\n    {\n      frameworkVersion: frameworkVersion || 'latest',\n      typescript: typeScriptDetected,\n    },\n    frameworkContext,\n  );\n\n  // Initialize and run agent\n  // Spinner is now handled by adapters listening to agent:start/agent:progress events\n  const agent = await initializeAgent(\n    {\n      workingDirectory: options.installDir,\n      workOSApiKey: apiKey,\n      workOSApiHost: 'https://api.workos.com',\n    },\n    options,\n  );\n\n  // Run agent - errors will throw naturally with skill-based approach\n  const agentResult = await runAgent(\n    agent,\n    integrationPrompt,\n    options,\n    {\n      spinnerMessage: SPINNER_MESSAGE,\n      successMessage: config.ui.successMessage,\n      errorMessage: 'Integration failed',\n    },\n    options.emitter,\n  );\n\n  // If agent returned an error, throw so state machine can handle it\n  if (agentResult.error) {\n    await analytics.shutdown('error');\n    const message = agentResult.errorMessage || agentResult.error;\n    throw new Error(`Agent SDK error: ${message}`);\n  }\n\n  // Run post-installation validation\n  if (!options.noValidate) {\n    options.emitter?.emit('validation:start', { framework: config.metadata.integration });\n\n    const validationResult = await validateInstallation(config.metadata.integration, options.installDir, {\n      runBuild: true,\n    });\n\n    if (validationResult.issues.length > 0) {\n      options.emitter?.emit('validation:issues', { issues: validationResult.issues });\n    }\n\n    options.emitter?.emit('validation:complete', {\n      passed: validationResult.passed,\n      issueCount: validationResult.issues.length,\n      durationMs: validationResult.durationMs,\n    });\n  }\n\n  // Build environment variables from WorkOS credentials\n  const envVars = config.environment.getEnvVars(apiKey, clientId);\n\n  // Upload environment variables to hosting providers (if configured)\n  let uploadedEnvVars: string[] = [];\n  if (config.environment.uploadToHosting) {\n    uploadedEnvVars = await uploadEnvironmentVariablesStep(envVars, {\n      integration: config.metadata.integration,\n      options,\n    });\n  }\n\n  // Skip MCP server setup for now (WorkOS doesn't need it initially)\n  // await addMCPServerToClientsStep({ ... });\n\n  // Build outro message\n  const continueUrl = undefined; // No signup flow for WorkOS wizard\n\n  const changes = [\n    ...config.ui.getOutroChanges(frameworkContext),\n    Object.keys(envVars).length > 0 ? `Added environment variables to .env file` : '',\n    uploadedEnvVars.length > 0 ? `Uploaded environment variables to your hosting provider` : '',\n  ].filter(Boolean);\n\n  const nextSteps = [\n    ...config.ui.getOutroNextSteps(frameworkContext),\n    uploadedEnvVars.length === 0 && config.environment.uploadToHosting\n      ? `Upload your WorkOS credentials to your hosting provider`\n      : '',\n  ].filter(Boolean);\n\n  // Build detailed summary to return to caller (state machine)\n  const summary = buildCompletionSummary(config, changes, nextSteps, continueUrl);\n\n  await analytics.shutdown('success');\n\n  return summary;\n}\n\n/**\n * Build the integration prompt for the agent.\n * Uses skill-based approach where agent invokes framework-specific skill.\n * Note: Credentials are pre-written to .env.local, so not included in prompt.\n */\nfunction buildIntegrationPrompt(\n  config: FrameworkConfig,\n  context: {\n    frameworkVersion: string;\n    typescript: boolean;\n  },\n  frameworkContext: Record<string, any>,\n): string {\n  const additionalLines = config.prompts.getAdditionalContextLines\n    ? config.prompts.getAdditionalContextLines(frameworkContext)\n    : [];\n\n  const additionalContext =\n    additionalLines.length > 0 ? '\\n' + additionalLines.map((line) => `- ${line}`).join('\\n') : '';\n\n  const skillName = config.metadata.skillName;\n  if (!skillName) {\n    throw new Error(`Framework ${config.metadata.name} missing skillName in config`);\n  }\n\n  // Next.js uses NEXT_PUBLIC_ prefix for redirect URI\n  const redirectUriEnvVar =\n    config.metadata.integration === 'nextjs' ? 'NEXT_PUBLIC_WORKOS_REDIRECT_URI' : 'WORKOS_REDIRECT_URI';\n\n  return `You are integrating WorkOS AuthKit into this ${config.metadata.name} application.\n\n## Project Context\n\n- Framework: ${config.metadata.name} ${context.frameworkVersion}\n- TypeScript: ${context.typescript ? 'Yes' : 'No'}${additionalContext}\n\n## Environment\n\nThe following environment variables have been configured in .env.local:\n- WORKOS_API_KEY\n- WORKOS_CLIENT_ID\n- ${redirectUriEnvVar}\n- WORKOS_COOKIE_PASSWORD\n\n## Your Task\n\nUse the \\`${skillName}\\` skill to integrate WorkOS AuthKit into this application.\n\nThe skill contains step-by-step instructions including:\n1. Fetching the SDK documentation\n2. Installing the SDK\n3. Creating the callback route\n4. Setting up middleware/auth handling\n5. Adding authentication UI to the home page\n\nReport your progress using [STATUS] prefixes.\n\nBegin by invoking the ${skillName} skill.`;\n}\n\n/**\n * Build a completion summary for the event payload.\n * This is a plain-text summary without styling (adapters handle presentation).\n */\nfunction buildCompletionSummary(\n  config: FrameworkConfig,\n  changes: string[],\n  nextSteps: string[],\n  continueUrl: string | undefined,\n): string {\n  const lines: string[] = [];\n\n  lines.push('Successfully installed WorkOS AuthKit!');\n  lines.push('');\n\n  if (changes.length > 0) {\n    lines.push('What the agent did:');\n    changes.forEach((change) => lines.push(`• ${change}`));\n    lines.push('');\n  }\n\n  if (nextSteps.length > 0) {\n    lines.push('Next steps:');\n    nextSteps.forEach((step) => lines.push(`• ${step}`));\n    lines.push('');\n  }\n\n  lines.push(`Learn more: ${config.metadata.docsUrl}`);\n\n  if (continueUrl) {\n    lines.push(`Continue onboarding: ${continueUrl}`);\n  }\n\n  lines.push('');\n  lines.push('Note: This wizard uses an LLM agent to analyze and modify your project. Please review the changes made.');\n\n  return lines.join('\\n');\n}\n"]}

package/dist/src/lib/api.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export declare const ApiUserSchema: z.ZodObject<{
+    distinct_id: z.ZodString;
+    organizations: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+    }, z.core.$strip>>;
+    team: z.ZodObject<{
+        id: z.ZodNumber;
+        organization: z.ZodUUID;
+    }, z.core.$strip>;
+    organization: z.ZodObject<{
+        id: z.ZodUUID;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const ApiProjectSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    uuid: z.ZodUUID;
+    organization: z.ZodUUID;
+    api_token: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+export type ApiUser = z.infer<typeof ApiUserSchema>;
+export type ApiProject = z.infer<typeof ApiProjectSchema>;
+export declare function fetchUserData(accessToken: string, baseUrl: string): Promise<ApiUser>;
+export declare function fetchProjectData(accessToken: string, projectId: number, baseUrl: string): Promise<ApiProject>;

package/dist/src/lib/api.js

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+import { analytics } from '../utils/analytics.js';
+export const ApiUserSchema = z.object({
+    distinct_id: z.string(),
+    organizations: z.array(z.object({
+        id: z.uuid(),
+    })),
+    team: z.object({
+        id: z.number(),
+        organization: z.uuid(),
+    }),
+    organization: z.object({
+        id: z.uuid(),
+    }),
+});
+export const ApiProjectSchema = z.object({
+    id: z.number(),
+    uuid: z.uuid(),
+    organization: z.uuid(),
+    api_token: z.string(),
+    name: z.string(),
+});
+class ApiError extends Error {
+    statusCode;
+    endpoint;
+    constructor(message, statusCode, endpoint) {
+        super(message);
+        this.statusCode = statusCode;
+        this.endpoint = endpoint;
+        this.name = 'ApiError';
+    }
+}
+export async function fetchUserData(accessToken, baseUrl) {
+    const endpoint = '/api/users/@me/';
+    try {
+        const response = await fetch(`${baseUrl}${endpoint}`, {
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+            },
+        });
+        if (!response.ok) {
+            throw await createFetchError(response, endpoint);
+        }
+        const data = await response.json();
+        return ApiUserSchema.parse(data);
+    }
+    catch (error) {
+        const apiError = handleApiError(error, 'fetch user data', endpoint);
+        analytics.captureException(apiError, {
+            endpoint,
+            baseUrl,
+        });
+        throw apiError;
+    }
+}
+export async function fetchProjectData(accessToken, projectId, baseUrl) {
+    const endpoint = `/api/projects/${projectId}/`;
+    try {
+        const response = await fetch(`${baseUrl}${endpoint}`, {
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+            },
+        });
+        if (!response.ok) {
+            throw await createFetchError(response, endpoint);
+        }
+        const data = await response.json();
+        return ApiProjectSchema.parse(data);
+    }
+    catch (error) {
+        const apiError = handleApiError(error, 'fetch project data', endpoint);
+        analytics.captureException(apiError, {
+            endpoint,
+            baseUrl,
+            projectId,
+        });
+        throw apiError;
+    }
+}
+async function createFetchError(response, endpoint) {
+    let detail;
+    try {
+        const data = await response.json();
+        if (typeof data === 'object' && data !== null && 'detail' in data) {
+            detail = String(data.detail);
+        }
+    }
+    catch {
+        // Response wasn't JSON
+    }
+    const error = new Error(`HTTP ${response.status}`);
+    error.status = response.status;
+    error.endpoint = endpoint;
+    error.detail = detail;
+    return error;
+}
+function isFetchError(error) {
+    return error instanceof Error && 'status' in error && typeof error.status === 'number';
+}
+function handleApiError(error, operation, endpoint) {
+    if (isFetchError(error)) {
+        const { status, detail } = error;
+        if (status === 401) {
+            return new ApiError(`Authentication failed while trying to ${operation}`, status, endpoint);
+        }
+        if (status === 403) {
+            return new ApiError(`Access denied while trying to ${operation}`, status, endpoint);
+        }
+        if (status === 404) {
+            return new ApiError(`Resource not found while trying to ${operation}`, status, endpoint);
+        }
+        const message = detail || `Failed to ${operation}`;
+        return new ApiError(message, status, endpoint);
+    }
+    if (error instanceof z.ZodError) {
+        return new ApiError(`Invalid response format while trying to ${operation}`);
+    }
+    return new ApiError(`Unexpected error while trying to ${operation}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+}
+//# sourceMappingURL=api.js.map

package/dist/src/lib/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/lib/api.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { analytics } from '../utils/analytics.js';\n\nexport const ApiUserSchema = z.object({\n  distinct_id: z.string(),\n  organizations: z.array(\n    z.object({\n      id: z.uuid(),\n    }),\n  ),\n  team: z.object({\n    id: z.number(),\n    organization: z.uuid(),\n  }),\n  organization: z.object({\n    id: z.uuid(),\n  }),\n});\n\nexport const ApiProjectSchema = z.object({\n  id: z.number(),\n  uuid: z.uuid(),\n  organization: z.uuid(),\n  api_token: z.string(),\n  name: z.string(),\n});\n\nexport type ApiUser = z.infer<typeof ApiUserSchema>;\nexport type ApiProject = z.infer<typeof ApiProjectSchema>;\n\nclass ApiError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    public readonly endpoint?: string,\n  ) {\n    super(message);\n    this.name = 'ApiError';\n  }\n}\n\nexport async function fetchUserData(accessToken: string, baseUrl: string): Promise<ApiUser> {\n  const endpoint = '/api/users/@me/';\n  try {\n    const response = await fetch(`${baseUrl}${endpoint}`, {\n      headers: {\n        Authorization: `Bearer ${accessToken}`,\n      },\n    });\n\n    if (!response.ok) {\n      throw await createFetchError(response, endpoint);\n    }\n\n    const data = await response.json();\n    return ApiUserSchema.parse(data);\n  } catch (error) {\n    const apiError = handleApiError(error, 'fetch user data', endpoint);\n    analytics.captureException(apiError, {\n      endpoint,\n      baseUrl,\n    });\n    throw apiError;\n  }\n}\n\nexport async function fetchProjectData(accessToken: string, projectId: number, baseUrl: string): Promise<ApiProject> {\n  const endpoint = `/api/projects/${projectId}/`;\n  try {\n    const response = await fetch(`${baseUrl}${endpoint}`, {\n      headers: {\n        Authorization: `Bearer ${accessToken}`,\n      },\n    });\n\n    if (!response.ok) {\n      throw await createFetchError(response, endpoint);\n    }\n\n    const data = await response.json();\n    return ApiProjectSchema.parse(data);\n  } catch (error) {\n    const apiError = handleApiError(error, 'fetch project data', endpoint);\n    analytics.captureException(apiError, {\n      endpoint,\n      baseUrl,\n      projectId,\n    });\n    throw apiError;\n  }\n}\n\ninterface FetchError extends Error {\n  status: number;\n  endpoint: string;\n  detail?: string;\n}\n\nasync function createFetchError(response: Response, endpoint: string): Promise<FetchError> {\n  let detail: string | undefined;\n  try {\n    const data: unknown = await response.json();\n    if (typeof data === 'object' && data !== null && 'detail' in data) {\n      detail = String((data as { detail: unknown }).detail);\n    }\n  } catch {\n    // Response wasn't JSON\n  }\n\n  const error = new Error(`HTTP ${response.status}`) as FetchError;\n  error.status = response.status;\n  error.endpoint = endpoint;\n  error.detail = detail;\n  return error;\n}\n\nfunction isFetchError(error: unknown): error is FetchError {\n  return error instanceof Error && 'status' in error && typeof (error as FetchError).status === 'number';\n}\n\nfunction handleApiError(error: unknown, operation: string, endpoint: string): ApiError {\n  if (isFetchError(error)) {\n    const { status, detail } = error;\n\n    if (status === 401) {\n      return new ApiError(`Authentication failed while trying to ${operation}`, status, endpoint);\n    }\n\n    if (status === 403) {\n      return new ApiError(`Access denied while trying to ${operation}`, status, endpoint);\n    }\n\n    if (status === 404) {\n      return new ApiError(`Resource not found while trying to ${operation}`, status, endpoint);\n    }\n\n    const message = detail || `Failed to ${operation}`;\n    return new ApiError(message, status, endpoint);\n  }\n\n  if (error instanceof z.ZodError) {\n    return new ApiError(`Invalid response format while trying to ${operation}`);\n  }\n\n  return new ApiError(\n    `Unexpected error while trying to ${operation}: ${error instanceof Error ? error.message : 'Unknown error'}`,\n  );\n}\n"]}

package/dist/src/lib/config.d.ts

@@ -0,0 +1,60 @@
+import type { WizardOptions } from '../utils/types.js';
+import { Integration } from './constants.js';
+export declare const INTEGRATION_CONFIG: {
+    readonly nextjs: {
+        readonly name: "Next.js";
+        readonly filterPatterns: ["**/*.{tsx,ts,jsx,js,mjs,cjs}"];
+        readonly ignorePatterns: ["node_modules", "dist", "build", "public", "static", "next-env.d.*"];
+        readonly detect: (options: Pick<WizardOptions, "installDir">) => Promise<boolean>;
+        readonly generateFilesRules: "";
+        readonly filterFilesRules: "";
+        readonly docsUrl: "https://workos.com/docs/user-management/authkit/nextjs";
+        readonly defaultChanges: "• Installed @workos/authkit-nextjs package\n• Initialized WorkOS AuthKit with your credentials\n• Created authentication routes and callbacks\n• Added login/logout UI components";
+        readonly nextSteps: "• Customize the auth UI to match your app design\n• Add protected routes using withAuth() middleware\n• Access user session with getUser() in your components";
+    };
+    readonly react: {
+        readonly name: "React (SPA)";
+        readonly filterPatterns: ["**/*.{tsx,ts,jsx,js}"];
+        readonly ignorePatterns: ["node_modules", "dist", "build", "public", "static", "assets"];
+        readonly detect: (options: Pick<WizardOptions, "installDir">) => Promise<boolean>;
+        readonly generateFilesRules: "";
+        readonly filterFilesRules: "";
+        readonly docsUrl: "https://workos.com/docs/user-management/authkit/react";
+        readonly defaultChanges: "• Installed @workos/authkit-react package\n• Added AuthKitProvider to wrap your app\n• Created login and callback components";
+        readonly nextSteps: "• Use useAuth() hook to access auth state in components\n• Add protected routes with conditional rendering\n• Customize auth UI to match your design";
+    };
+    readonly "tanstack-start": {
+        readonly name: "TanStack Start";
+        readonly filterPatterns: ["**/*.{tsx,ts,jsx,js}"];
+        readonly ignorePatterns: ["node_modules", "dist", "build", ".vinxi", ".output"];
+        readonly detect: (options: Pick<WizardOptions, "installDir">) => Promise<boolean>;
+        readonly generateFilesRules: "";
+        readonly filterFilesRules: "";
+        readonly docsUrl: "https://workos.com/docs/user-management/authkit/tanstack-start";
+        readonly defaultChanges: "• Installed WorkOS AuthKit SDK package\n• Added AuthKit middleware and routes\n• Created authentication components";
+        readonly nextSteps: "• Use useAuth() hook to access auth state\n• Add protected routes with authentication checks\n• Customize auth UI to match your app";
+    };
+    readonly "react-router": {
+        readonly name: "React Router";
+        readonly filterPatterns: ["**/*.{tsx,ts,jsx,js}"];
+        readonly ignorePatterns: ["node_modules", "dist", "build", "public", "static", "assets"];
+        readonly detect: (options: Pick<WizardOptions, "installDir">) => Promise<boolean>;
+        readonly generateFilesRules: "";
+        readonly filterFilesRules: "";
+        readonly docsUrl: "https://workos.com/docs/user-management/authkit/react-router";
+        readonly defaultChanges: "• Installed @workos/authkit-react-router package\n• Added AuthKitProvider with React Router integration\n• Created auth routes and loaders";
+        readonly nextSteps: "• Use useAuth() hook in your components\n• Add protected routes with loader functions\n• Customize auth flow to match your needs";
+    };
+    readonly "vanilla-js": {
+        readonly name: "Vanilla JavaScript";
+        readonly filterPatterns: ["**/*.{html,js,ts}"];
+        readonly ignorePatterns: ["node_modules", "dist", "build"];
+        readonly detect: (options: Pick<WizardOptions, "installDir">) => Promise<true>;
+        readonly generateFilesRules: "";
+        readonly filterFilesRules: "";
+        readonly docsUrl: "https://workos.com/docs/user-management/authkit/javascript";
+        readonly defaultChanges: "• Installed @workos/authkit-js package (or added CDN script)\n• Created auth initialization and callback handling\n• Added login button and auth state display";
+        readonly nextSteps: "• Integrate auth state into your existing UI\n• Add logout functionality where needed\n• Protect pages that require authentication";
+    };
+};
+export declare const INTEGRATION_ORDER: readonly [Integration.nextjs, Integration.tanstackStart, Integration.reactRouter, Integration.react, Integration.vanillaJs];

package/dist/src/lib/config.js

@@ -0,0 +1,88 @@
+import { getPackageDotJson } from '../utils/clack-utils.js';
+import { hasPackageInstalled } from '../utils/package-json.js';
+import { Integration } from './constants.js';
+export const INTEGRATION_CONFIG = {
+    [Integration.nextjs]: {
+        name: 'Next.js',
+        filterPatterns: ['**/*.{tsx,ts,jsx,js,mjs,cjs}'],
+        ignorePatterns: ['node_modules', 'dist', 'build', 'public', 'static', 'next-env.d.*'],
+        detect: async (options) => {
+            const packageJson = await getPackageDotJson(options);
+            return hasPackageInstalled('next', packageJson);
+        },
+        generateFilesRules: '',
+        filterFilesRules: '',
+        docsUrl: 'https://workos.com/docs/user-management/authkit/nextjs',
+        defaultChanges: '• Installed @workos/authkit-nextjs package\n• Initialized WorkOS AuthKit with your credentials\n• Created authentication routes and callbacks\n• Added login/logout UI components',
+        nextSteps: '• Customize the auth UI to match your app design\n• Add protected routes using withAuth() middleware\n• Access user session with getUser() in your components',
+    },
+    [Integration.react]: {
+        name: 'React (SPA)',
+        filterPatterns: ['**/*.{tsx,ts,jsx,js}'],
+        ignorePatterns: ['node_modules', 'dist', 'build', 'public', 'static', 'assets'],
+        detect: async (options) => {
+            const packageJson = await getPackageDotJson(options);
+            // Detect React without routing frameworks
+            const hasReact = hasPackageInstalled('react', packageJson);
+            const hasNext = hasPackageInstalled('next', packageJson);
+            const hasReactRouter = hasPackageInstalled('react-router', packageJson);
+            const hasTanstack = hasPackageInstalled('@tanstack/react-start', packageJson);
+            return hasReact && !hasNext && !hasReactRouter && !hasTanstack;
+        },
+        generateFilesRules: '',
+        filterFilesRules: '',
+        docsUrl: 'https://workos.com/docs/user-management/authkit/react',
+        defaultChanges: '• Installed @workos/authkit-react package\n• Added AuthKitProvider to wrap your app\n• Created login and callback components',
+        nextSteps: '• Use useAuth() hook to access auth state in components\n• Add protected routes with conditional rendering\n• Customize auth UI to match your design',
+    },
+    [Integration.tanstackStart]: {
+        name: 'TanStack Start',
+        filterPatterns: ['**/*.{tsx,ts,jsx,js}'],
+        ignorePatterns: ['node_modules', 'dist', 'build', '.vinxi', '.output'],
+        detect: async (options) => {
+            const packageJson = await getPackageDotJson(options);
+            return hasPackageInstalled('@tanstack/react-start', packageJson);
+        },
+        generateFilesRules: '',
+        filterFilesRules: '',
+        docsUrl: 'https://workos.com/docs/user-management/authkit/tanstack-start',
+        defaultChanges: '• Installed WorkOS AuthKit SDK package\n• Added AuthKit middleware and routes\n• Created authentication components',
+        nextSteps: '• Use useAuth() hook to access auth state\n• Add protected routes with authentication checks\n• Customize auth UI to match your app',
+    },
+    [Integration.reactRouter]: {
+        name: 'React Router',
+        filterPatterns: ['**/*.{tsx,ts,jsx,js}'],
+        ignorePatterns: ['node_modules', 'dist', 'build', 'public', 'static', 'assets'],
+        detect: async (options) => {
+            const packageJson = await getPackageDotJson(options);
+            return hasPackageInstalled('react-router', packageJson);
+        },
+        generateFilesRules: '',
+        filterFilesRules: '',
+        docsUrl: 'https://workos.com/docs/user-management/authkit/react-router',
+        defaultChanges: '• Installed @workos/authkit-react-router package\n• Added AuthKitProvider with React Router integration\n• Created auth routes and loaders',
+        nextSteps: '• Use useAuth() hook in your components\n• Add protected routes with loader functions\n• Customize auth flow to match your needs',
+    },
+    [Integration.vanillaJs]: {
+        name: 'Vanilla JavaScript',
+        filterPatterns: ['**/*.{html,js,ts}'],
+        ignorePatterns: ['node_modules', 'dist', 'build'],
+        detect: async (options) => {
+            // Fallback: if no framework detected, assume vanilla JS
+            return true;
+        },
+        generateFilesRules: '',
+        filterFilesRules: '',
+        docsUrl: 'https://workos.com/docs/user-management/authkit/javascript',
+        defaultChanges: '• Installed @workos/authkit-js package (or added CDN script)\n• Created auth initialization and callback handling\n• Added login button and auth state display',
+        nextSteps: '• Integrate auth state into your existing UI\n• Add logout functionality where needed\n• Protect pages that require authentication',
+    },
+};
+export const INTEGRATION_ORDER = [
+    Integration.nextjs,
+    Integration.tanstackStart,
+    Integration.reactRouter,
+    Integration.react,
+    Integration.vanillaJs, // fallback
+];
+//# sourceMappingURL=config.js.map

package/dist/src/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/lib/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { getPackageDotJson } from '../utils/clack-utils.js';\nimport { hasPackageInstalled } from '../utils/package-json.js';\nimport type { WizardOptions } from '../utils/types.js';\nimport { Integration } from './constants.js';\n\ntype IntegrationConfig = {\n  name: string;\n  filterPatterns: string[];\n  ignorePatterns: string[];\n  detect: (options: Pick<WizardOptions, 'installDir'>) => Promise<boolean>;\n  generateFilesRules: string;\n  filterFilesRules: string;\n  docsUrl: string;\n  nextSteps: string;\n  defaultChanges: string;\n};\n\nexport const INTEGRATION_CONFIG = {\n  [Integration.nextjs]: {\n    name: 'Next.js',\n    filterPatterns: ['**/*.{tsx,ts,jsx,js,mjs,cjs}'],\n    ignorePatterns: ['node_modules', 'dist', 'build', 'public', 'static', 'next-env.d.*'],\n    detect: async (options) => {\n      const packageJson = await getPackageDotJson(options);\n      return hasPackageInstalled('next', packageJson);\n    },\n    generateFilesRules: '',\n    filterFilesRules: '',\n    docsUrl: 'https://workos.com/docs/user-management/authkit/nextjs',\n    defaultChanges:\n      '• Installed @workos/authkit-nextjs package\\n• Initialized WorkOS AuthKit with your credentials\\n• Created authentication routes and callbacks\\n• Added login/logout UI components',\n    nextSteps:\n      '• Customize the auth UI to match your app design\\n• Add protected routes using withAuth() middleware\\n• Access user session with getUser() in your components',\n  },\n  [Integration.react]: {\n    name: 'React (SPA)',\n    filterPatterns: ['**/*.{tsx,ts,jsx,js}'],\n    ignorePatterns: ['node_modules', 'dist', 'build', 'public', 'static', 'assets'],\n    detect: async (options) => {\n      const packageJson = await getPackageDotJson(options);\n      // Detect React without routing frameworks\n      const hasReact = hasPackageInstalled('react', packageJson);\n      const hasNext = hasPackageInstalled('next', packageJson);\n      const hasReactRouter = hasPackageInstalled('react-router', packageJson);\n      const hasTanstack = hasPackageInstalled('@tanstack/react-start', packageJson);\n      return hasReact && !hasNext && !hasReactRouter && !hasTanstack;\n    },\n    generateFilesRules: '',\n    filterFilesRules: '',\n    docsUrl: 'https://workos.com/docs/user-management/authkit/react',\n    defaultChanges:\n      '• Installed @workos/authkit-react package\\n• Added AuthKitProvider to wrap your app\\n• Created login and callback components',\n    nextSteps:\n      '• Use useAuth() hook to access auth state in components\\n• Add protected routes with conditional rendering\\n• Customize auth UI to match your design',\n  },\n  [Integration.tanstackStart]: {\n    name: 'TanStack Start',\n    filterPatterns: ['**/*.{tsx,ts,jsx,js}'],\n    ignorePatterns: ['node_modules', 'dist', 'build', '.vinxi', '.output'],\n    detect: async (options) => {\n      const packageJson = await getPackageDotJson(options);\n      return hasPackageInstalled('@tanstack/react-start', packageJson);\n    },\n    generateFilesRules: '',\n    filterFilesRules: '',\n    docsUrl: 'https://workos.com/docs/user-management/authkit/tanstack-start',\n    defaultChanges:\n      '• Installed WorkOS AuthKit SDK package\\n• Added AuthKit middleware and routes\\n• Created authentication components',\n    nextSteps:\n      '• Use useAuth() hook to access auth state\\n• Add protected routes with authentication checks\\n• Customize auth UI to match your app',\n  },\n  [Integration.reactRouter]: {\n    name: 'React Router',\n    filterPatterns: ['**/*.{tsx,ts,jsx,js}'],\n    ignorePatterns: ['node_modules', 'dist', 'build', 'public', 'static', 'assets'],\n    detect: async (options) => {\n      const packageJson = await getPackageDotJson(options);\n      return hasPackageInstalled('react-router', packageJson);\n    },\n    generateFilesRules: '',\n    filterFilesRules: '',\n    docsUrl: 'https://workos.com/docs/user-management/authkit/react-router',\n    defaultChanges:\n      '• Installed @workos/authkit-react-router package\\n• Added AuthKitProvider with React Router integration\\n• Created auth routes and loaders',\n    nextSteps:\n      '• Use useAuth() hook in your components\\n• Add protected routes with loader functions\\n• Customize auth flow to match your needs',\n  },\n  [Integration.vanillaJs]: {\n    name: 'Vanilla JavaScript',\n    filterPatterns: ['**/*.{html,js,ts}'],\n    ignorePatterns: ['node_modules', 'dist', 'build'],\n    detect: async (options) => {\n      // Fallback: if no framework detected, assume vanilla JS\n      return true;\n    },\n    generateFilesRules: '',\n    filterFilesRules: '',\n    docsUrl: 'https://workos.com/docs/user-management/authkit/javascript',\n    defaultChanges:\n      '• Installed @workos/authkit-js package (or added CDN script)\\n• Created auth initialization and callback handling\\n• Added login button and auth state display',\n    nextSteps:\n      '• Integrate auth state into your existing UI\\n• Add logout functionality where needed\\n• Protect pages that require authentication',\n  },\n} as const satisfies Record<Integration, IntegrationConfig>;\n\nexport const INTEGRATION_ORDER = [\n  Integration.nextjs,\n  Integration.tanstackStart,\n  Integration.reactRouter,\n  Integration.react,\n  Integration.vanillaJs, // fallback\n] as const;\n"]}

package/dist/src/lib/constants.d.ts

@@ -0,0 +1,32 @@
+export declare enum Integration {
+    nextjs = "nextjs",
+    react = "react",
+    tanstackStart = "tanstack-start",
+    reactRouter = "react-router",
+    vanillaJs = "vanilla-js"
+}
+export declare function getIntegrationDescription(type: string): string;
+type IntegrationChoice = {
+    name: string;
+    value: string;
+};
+export declare function getIntegrationChoices(): IntegrationChoice[];
+export interface Args {
+    debug: boolean;
+    integration: Integration;
+}
+export declare const IS_DEV: boolean;
+export declare const DEBUG: boolean;
+export declare const WORKOS_DOCS_URL: string;
+export declare const WORKOS_DASHBOARD_URL: string;
+export declare const ISSUES_URL: string;
+export declare const ANALYTICS_ENABLED: boolean;
+export declare const WIZARD_INTERACTION_EVENT_NAME: string;
+export declare const WORKOS_TELEMETRY_ENABLED: boolean;
+export declare const OAUTH_PORT: number;
+/**
+ * Common glob patterns to ignore when searching for files.
+ * Used by both Next.js and React Router integrations.
+ */
+export declare const IGNORE_PATTERNS: string[];
+export {};