workos 0.0.24 → 0.1.0

package/dist/src/steps/upload-environment-variables/index.js

@@ -0,0 +1,57 @@
+import { traceStep } from '../../telemetry.js';
+import { analytics } from '../../utils/analytics.js';
+import clack from '../../utils/clack.js';
+import { abortIfCancelled } from '../../utils/clack-utils.js';
+import { VercelEnvironmentProvider } from './providers/vercel.js';
+export const uploadEnvironmentVariablesStep = async (envVars, { integration, options, }) => {
+    const providers = [new VercelEnvironmentProvider(options)];
+    let provider = null;
+    for (const p of providers) {
+        if (await p.detect()) {
+            provider = p;
+            break;
+        }
+    }
+    if (!provider) {
+        analytics.capture('wizard interaction', {
+            action: 'not uploading environment variables',
+            reason: 'no environment provider found',
+            integration,
+        });
+        return [];
+    }
+    const upload = await abortIfCancelled(clack.select({
+        message: `It looks like you are using ${provider.name}. Would you like to upload the environment variables?`,
+        options: [
+            {
+                value: true,
+                label: 'Yes',
+                hint: `Upload the environment variables to ${provider.name}`,
+            },
+            {
+                value: false,
+                label: 'No',
+                hint: `Skip uploading environment variables to ${provider.name} - you can do this later`,
+            },
+        ],
+    }), integration);
+    if (!upload) {
+        analytics.capture('wizard interaction', {
+            action: 'not uploading environment variables',
+            reason: 'user declined to upload',
+            provider: provider.name,
+            integration,
+        });
+        return [];
+    }
+    const results = await traceStep('uploading environment variables', async () => {
+        return await provider.uploadEnvVars(envVars);
+    });
+    analytics.capture('wizard interaction', {
+        action: 'uploaded environment variables',
+        provider: provider.name,
+        integration,
+    });
+    return Object.keys(results).filter((key) => results[key]);
+};
+//# sourceMappingURL=index.js.map

package/dist/src/steps/upload-environment-variables/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/steps/upload-environment-variables/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,MAAM,sBAAsB,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,CAAC,MAAM,8BAA8B,GAAG,KAAK,EACjD,OAA+B,EAC/B,EACE,WAAW,EACX,OAAO,GAIR,EACkB,EAAE;IACrB,MAAM,SAAS,GAA0B,CAAC,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAC;IAElF,IAAI,QAAQ,GAA+B,IAAI,CAAC;IAEhD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACrB,QAAQ,GAAG,CAAC,CAAC;YACb,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,SAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE;YACtC,MAAM,EAAE,qCAAqC;YAC7C,MAAM,EAAE,+BAA+B;YACvC,WAAW;SACZ,CAAC,CAAC;QACH,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAY,MAAM,gBAAgB,CAC5C,KAAK,CAAC,MAAM,CAAC;QACX,OAAO,EAAE,+BAA+B,QAAQ,CAAC,IAAI,uDAAuD;QAC5G,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,IAAI;gBACX,KAAK,EAAE,KAAK;gBACZ,IAAI,EAAE,uCAAuC,QAAQ,CAAC,IAAI,EAAE;aAC7D;YACD;gBACE,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,2CAA2C,QAAQ,CAAC,IAAI,0BAA0B;aACzF;SACF;KACF,CAAC,EACF,WAAW,CACZ,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,SAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE;YACtC,MAAM,EAAE,qCAAqC;YAC7C,MAAM,EAAE,yBAAyB;YACjC,QAAQ,EAAE,QAAQ,CAAC,IAAI;YACvB,WAAW;SACZ,CAAC,CAAC;QACH,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC5E,OAAO,MAAM,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE;QACtC,MAAM,EAAE,gCAAgC;QACxC,QAAQ,EAAE,QAAQ,CAAC,IAAI;QACvB,WAAW;KACZ,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5D,CAAC,CAAC","sourcesContent":["import type { Integration } from '../../lib/constants.js';\nimport { traceStep } from '../../telemetry.js';\nimport { analytics } from '../../utils/analytics.js';\nimport clack from '../../utils/clack.js';\nimport { abortIfCancelled } from '../../utils/clack-utils.js';\nimport type { WizardOptions } from '../../utils/types.js';\nimport { EnvironmentProvider } from './EnvironmentProvider.js';\nimport { VercelEnvironmentProvider } from './providers/vercel.js';\n\nexport const uploadEnvironmentVariablesStep = async (\n  envVars: Record<string, string>,\n  {\n    integration,\n    options,\n  }: {\n    integration: Integration;\n    options: WizardOptions;\n  },\n): Promise<string[]> => {\n  const providers: EnvironmentProvider[] = [new VercelEnvironmentProvider(options)];\n\n  let provider: EnvironmentProvider | null = null;\n\n  for (const p of providers) {\n    if (await p.detect()) {\n      provider = p;\n      break;\n    }\n  }\n\n  if (!provider) {\n    analytics.capture('wizard interaction', {\n      action: 'not uploading environment variables',\n      reason: 'no environment provider found',\n      integration,\n    });\n    return [];\n  }\n\n  const upload: boolean = await abortIfCancelled(\n    clack.select({\n      message: `It looks like you are using ${provider.name}. Would you like to upload the environment variables?`,\n      options: [\n        {\n          value: true,\n          label: 'Yes',\n          hint: `Upload the environment variables to ${provider.name}`,\n        },\n        {\n          value: false,\n          label: 'No',\n          hint: `Skip uploading environment variables to ${provider.name} - you can do this later`,\n        },\n      ],\n    }),\n    integration,\n  );\n\n  if (!upload) {\n    analytics.capture('wizard interaction', {\n      action: 'not uploading environment variables',\n      reason: 'user declined to upload',\n      provider: provider.name,\n      integration,\n    });\n    return [];\n  }\n\n  const results = await traceStep('uploading environment variables', async () => {\n    return await provider.uploadEnvVars(envVars);\n  });\n\n  analytics.capture('wizard interaction', {\n    action: 'uploaded environment variables',\n    provider: provider.name,\n    integration,\n  });\n\n  return Object.keys(results).filter((key) => results[key]);\n};\n"]}

package/dist/src/steps/upload-environment-variables/providers/vercel.d.ts

@@ -0,0 +1,14 @@
+import { EnvironmentProvider } from '../EnvironmentProvider.js';
+import type { WizardOptions } from '../../../utils/types.js';
+export declare class VercelEnvironmentProvider extends EnvironmentProvider {
+    name: string;
+    environments: string[];
+    constructor(options: WizardOptions);
+    detect(): Promise<boolean>;
+    hasDotVercelDir(): boolean;
+    hasVercelCli(): boolean;
+    isProjectLinked(): boolean;
+    isAuthenticated(): boolean;
+    uploadEnvironmentVariable(key: string, value: string, environment: string): Promise<void>;
+    uploadEnvVars(vars: Record<string, string>): Promise<Record<string, boolean>>;
+}

package/dist/src/steps/upload-environment-variables/providers/vercel.js

@@ -0,0 +1,104 @@
+import { execSync, spawn, spawnSync } from 'child_process';
+import { EnvironmentProvider } from '../EnvironmentProvider.js';
+import * as fs from 'fs';
+import * as path from 'path';
+import clack from '../../../utils/clack.js';
+import chalk from 'chalk';
+import { analytics } from '../../../utils/analytics.js';
+export class VercelEnvironmentProvider extends EnvironmentProvider {
+    name = 'Vercel';
+    environments = ['production', 'preview', 'development'];
+    constructor(options) {
+        super(options);
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async detect() {
+        const vercelDetected = this.hasVercelCli() && this.isProjectLinked() && this.isAuthenticated();
+        analytics.setTag('vercel-detected', vercelDetected);
+        return vercelDetected;
+    }
+    hasDotVercelDir() {
+        const dotVercelDir = path.join(this.options.installDir, '.vercel');
+        return fs.existsSync(dotVercelDir);
+    }
+    hasVercelCli() {
+        try {
+            execSync('vercel --version', { stdio: 'ignore' });
+            analytics.setTag('vercel-cli-installed', true);
+            return true;
+        }
+        catch {
+            analytics.setTag('vercel-cli-installed', false);
+            return false;
+        }
+    }
+    isProjectLinked() {
+        const isProjectLinked = fs.existsSync(path.join(this.options.installDir, '.vercel', 'project.json'));
+        analytics.setTag('vercel-project-linked', isProjectLinked);
+        return isProjectLinked;
+    }
+    isAuthenticated() {
+        const result = spawnSync('vercel', ['whoami'], {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'], // suppress prompts
+            env: {
+                ...process.env,
+                FORCE_COLOR: '0', // avoid ANSI formatting
+                CI: '1', // hint to CLI that it's a non-interactive env
+            },
+        });
+        const output = (String(result.stdout) + String(result.stderr)).toLowerCase();
+        if (output.includes('log in to vercel') || output.includes('vercel login') || result.status !== 0) {
+            analytics.setTag('vercel-authenticated', false);
+            return false;
+        }
+        analytics.setTag('vercel-authenticated', true);
+        return true;
+    }
+    async uploadEnvironmentVariable(key, value, environment) {
+        await new Promise((resolve, reject) => {
+            const proc = spawn('vercel', ['env', 'add', key, environment], {
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            let stderr = '';
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            proc.stdin.write(value);
+            proc.stdin.end();
+            proc.on('close', (code) => {
+                if (stderr.includes('already exists') ||
+                    stderr.includes('already been added') ||
+                    stderr.includes('vercel env rm')) {
+                    reject(new Error(`❌ Environment variable ${chalk.cyan(key)} already exists in ${this.name}. Please upload it manually.`));
+                }
+                else if (code === 0) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`❌ Failed to upload environment variable ${chalk.cyan(key)} to ${this.name}. Please upload it manually.`));
+                }
+            });
+        });
+    }
+    async uploadEnvVars(vars) {
+        const results = {};
+        for (const [key, value] of Object.entries(vars)) {
+            const spinner = clack.spinner();
+            spinner.start(`Uploading ${chalk.cyan(key)} to ${this.name}...`);
+            await Promise.all(this.environments.map((environment) => this.uploadEnvironmentVariable(key, value, environment)))
+                .then(() => {
+                spinner.stop(`✅ Uploaded ${chalk.cyan(key)} to ${this.name}`);
+                results[key] = true;
+            })
+                .catch((err) => {
+                spinner.stop(err instanceof Error
+                    ? err.message
+                    : `❌ Failed to upload environment variables to ${this.name}. Please upload it manually.`);
+                results[key] = false;
+            });
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=vercel.js.map

package/dist/src/steps/upload-environment-variables/providers/vercel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.js","sourceRoot":"","sources":["../../../../../src/steps/upload-environment-variables/providers/vercel.ts"],"names":[],"mappings":"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","sourcesContent":["import { execSync, spawn, spawnSync } from 'child_process';\nimport { EnvironmentProvider } from '../EnvironmentProvider.js';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport type { WizardOptions } from '../../../utils/types.js';\nimport clack from '../../../utils/clack.js';\nimport chalk from 'chalk';\nimport { analytics } from '../../../utils/analytics.js';\n\nexport class VercelEnvironmentProvider extends EnvironmentProvider {\n  name = 'Vercel';\n  environments = ['production', 'preview', 'development'];\n\n  constructor(options: WizardOptions) {\n    super(options);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/require-await\n  async detect(): Promise<boolean> {\n    const vercelDetected = this.hasVercelCli() && this.isProjectLinked() && this.isAuthenticated();\n\n    analytics.setTag('vercel-detected', vercelDetected);\n\n    return vercelDetected;\n  }\n\n  hasDotVercelDir(): boolean {\n    const dotVercelDir = path.join(this.options.installDir, '.vercel');\n    return fs.existsSync(dotVercelDir);\n  }\n\n  hasVercelCli(): boolean {\n    try {\n      execSync('vercel --version', { stdio: 'ignore' });\n      analytics.setTag('vercel-cli-installed', true);\n      return true;\n    } catch {\n      analytics.setTag('vercel-cli-installed', false);\n      return false;\n    }\n  }\n\n  isProjectLinked(): boolean {\n    const isProjectLinked = fs.existsSync(path.join(this.options.installDir, '.vercel', 'project.json'));\n\n    analytics.setTag('vercel-project-linked', isProjectLinked);\n\n    return isProjectLinked;\n  }\n\n  isAuthenticated(): boolean {\n    const result = spawnSync('vercel', ['whoami'], {\n      encoding: 'utf-8',\n      stdio: ['pipe', 'pipe', 'pipe'], // suppress prompts\n      env: {\n        ...process.env,\n        FORCE_COLOR: '0', // avoid ANSI formatting\n        CI: '1', // hint to CLI that it's a non-interactive env\n      },\n    });\n\n    const output = (String(result.stdout) + String(result.stderr)).toLowerCase();\n\n    if (output.includes('log in to vercel') || output.includes('vercel login') || result.status !== 0) {\n      analytics.setTag('vercel-authenticated', false);\n      return false;\n    }\n\n    analytics.setTag('vercel-authenticated', true);\n\n    return true;\n  }\n\n  async uploadEnvironmentVariable(key: string, value: string, environment: string): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      const proc = spawn('vercel', ['env', 'add', key, environment], {\n        stdio: ['pipe', 'pipe', 'pipe'],\n      });\n\n      let stderr = '';\n      proc.stderr.on('data', (data) => {\n        stderr += data.toString();\n      });\n\n      proc.stdin.write(value);\n      proc.stdin.end();\n\n      proc.on('close', (code) => {\n        if (\n          stderr.includes('already exists') ||\n          stderr.includes('already been added') ||\n          stderr.includes('vercel env rm')\n        ) {\n          reject(\n            new Error(\n              `❌ Environment variable ${chalk.cyan(key)} already exists in ${this.name}. Please upload it manually.`,\n            ),\n          );\n        } else if (code === 0) {\n          resolve();\n        } else {\n          reject(\n            new Error(\n              `❌ Failed to upload environment variable ${chalk.cyan(key)} to ${this.name}. Please upload it manually.`,\n            ),\n          );\n        }\n      });\n    });\n  }\n\n  async uploadEnvVars(vars: Record<string, string>): Promise<Record<string, boolean>> {\n    const results: Record<string, boolean> = {};\n\n    for (const [key, value] of Object.entries(vars)) {\n      const spinner = clack.spinner();\n\n      spinner.start(`Uploading ${chalk.cyan(key)} to ${this.name}...`);\n      await Promise.all(this.environments.map((environment) => this.uploadEnvironmentVariable(key, value, environment)))\n        .then(() => {\n          spinner.stop(`✅ Uploaded ${chalk.cyan(key)} to ${this.name}`);\n          results[key] = true;\n        })\n        .catch((err) => {\n          spinner.stop(\n            err instanceof Error\n              ? err.message\n              : `❌ Failed to upload environment variables to ${this.name}. Please upload it manually.`,\n          );\n          results[key] = false;\n        });\n    }\n\n    return results;\n  }\n}\n"]}

package/dist/src/tanstack-start/tanstack-start-wizard-agent.d.ts

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

package/dist/src/tanstack-start/tanstack-start-wizard-agent.js

@@ -0,0 +1,49 @@
+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';
+const TANSTACK_START_AGENT_CONFIG = {
+    metadata: {
+        name: 'TanStack Start',
+        integration: Integration.tanstackStart,
+        docsUrl: 'https://workos.com/docs/user-management/authkit/tanstack-start',
+        unsupportedVersionDocsUrl: 'https://workos.com/docs/user-management/authkit/tanstack-start',
+        skillName: 'workos-authkit-tanstack-start',
+    },
+    detection: {
+        packageName: '@tanstack/react-start',
+        packageDisplayName: 'TanStack Start',
+        getVersion: (packageJson) => getPackageVersion('@tanstack/react-start', packageJson),
+    },
+    environment: {
+        uploadToHosting: false,
+        requiresApiKey: true, // Server-side framework
+        getEnvVars: (apiKey, clientId) => ({
+            WORKOS_API_KEY: apiKey,
+            WORKOS_CLIENT_ID: clientId,
+        }),
+    },
+    analytics: {
+        getTags: () => ({}),
+    },
+    prompts: {},
+    ui: {
+        successMessage: 'WorkOS AuthKit integration complete',
+        getOutroChanges: () => [
+            'Analyzed your TanStack Start 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 runTanstackStartWizardAgent(options) {
+    if (options.debug) {
+        enableDebugLogs();
+    }
+    return runAgentWizard(TANSTACK_START_AGENT_CONFIG, options);
+}
+//# sourceMappingURL=tanstack-start-wizard-agent.js.map

package/dist/src/tanstack-start/tanstack-start-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-start-wizard-agent.js","sourceRoot":"","sources":["../../../src/tanstack-start/tanstack-start-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;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,2BAA2B,GAAoB;IACnD,QAAQ,EAAE;QACR,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,WAAW,CAAC,aAAa;QACtC,OAAO,EAAE,gEAAgE;QACzE,yBAAyB,EAAE,gEAAgE;QAC3F,SAAS,EAAE,+BAA+B;KAC3C;IAED,SAAS,EAAE;QACT,WAAW,EAAE,uBAAuB;QACpC,kBAAkB,EAAE,gBAAgB;QACpC,UAAU,EAAE,CAAC,WAAgB,EAAE,EAAE,CAAC,iBAAiB,CAAC,uBAAuB,EAAE,WAAW,CAAC;KAC1F;IAED,WAAW,EAAE;QACX,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI,EAAE,wBAAwB;QAC9C,UAAU,EAAE,CAAC,MAAc,EAAE,QAAgB,EAAE,EAAE,CAAC,CAAC;YACjD,cAAc,EAAE,MAAM;YACtB,gBAAgB,EAAE,QAAQ;SAC3B,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,gDAAgD;YAChD,uCAAuC;YACvC,iDAAiD;SAClD;QACD,iBAAiB,EAAE,GAAG,EAAE,CAAC;YACvB,sDAAsD;YACtD,yDAAyD;SAC1D;KACF;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,OAAsB;IACtE,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;IACpB,CAAC;IAED,OAAO,cAAc,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC","sourcesContent":["/* TanStack Start 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';\nimport { getPackageVersion } from '../utils/package-json.js';\n\nconst TANSTACK_START_AGENT_CONFIG: FrameworkConfig = {\n  metadata: {\n    name: 'TanStack Start',\n    integration: Integration.tanstackStart,\n    docsUrl: 'https://workos.com/docs/user-management/authkit/tanstack-start',\n    unsupportedVersionDocsUrl: 'https://workos.com/docs/user-management/authkit/tanstack-start',\n    skillName: 'workos-authkit-tanstack-start',\n  },\n\n  detection: {\n    packageName: '@tanstack/react-start',\n    packageDisplayName: 'TanStack Start',\n    getVersion: (packageJson: any) => getPackageVersion('@tanstack/react-start', packageJson),\n  },\n\n  environment: {\n    uploadToHosting: false,\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: () => ({}),\n  },\n\n  prompts: {},\n\n  ui: {\n    successMessage: 'WorkOS AuthKit integration complete',\n    getOutroChanges: () => [\n      'Analyzed your TanStack Start 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 runTanstackStartWizardAgent(options: WizardOptions): Promise<string> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  return runAgentWizard(TANSTACK_START_AGENT_CONFIG, options);\n}\n"]}

package/dist/src/telemetry.d.ts

@@ -0,0 +1,2 @@
+export declare function traceStep<T>(step: string, callback: () => T): T;
+export declare function updateProgress(step: string): void;

package/dist/src/telemetry.js

@@ -0,0 +1,29 @@
+import { analytics } from './utils/analytics.js';
+export function traceStep(step, callback) {
+    const startTime = Date.now();
+    updateProgress(step);
+    try {
+        const result = callback();
+        if (result instanceof Promise) {
+            return result
+                .then((value) => {
+                analytics.stepCompleted(step, Date.now() - startTime, true);
+                return value;
+            })
+                .catch((error) => {
+                analytics.stepCompleted(step, Date.now() - startTime, false, error);
+                throw error;
+            });
+        }
+        analytics.stepCompleted(step, Date.now() - startTime, true);
+        return result;
+    }
+    catch (error) {
+        analytics.stepCompleted(step, Date.now() - startTime, false, error);
+        throw error;
+    }
+}
+export function updateProgress(step) {
+    analytics.setTag('progress', step);
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/src/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,UAAU,SAAS,CAAI,IAAY,EAAE,QAAiB;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,cAAc,CAAC,IAAI,CAAC,CAAC;IAErB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;QAE1B,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,OAAO,MAAM;iBACV,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gBACd,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,IAAI,CAAC,CAAC;gBAC5D,OAAO,KAAK,CAAC;YACf,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACf,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;gBACpE,MAAM,KAAK,CAAC;YACd,CAAC,CAAM,CAAC;QACZ,CAAC;QAED,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5D,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;QAC7E,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC","sourcesContent":["import { analytics } from './utils/analytics.js';\n\nexport function traceStep<T>(step: string, callback: () => T): T {\n  const startTime = Date.now();\n  updateProgress(step);\n\n  try {\n    const result = callback();\n\n    if (result instanceof Promise) {\n      return result\n        .then((value) => {\n          analytics.stepCompleted(step, Date.now() - startTime, true);\n          return value;\n        })\n        .catch((error) => {\n          analytics.stepCompleted(step, Date.now() - startTime, false, error);\n          throw error;\n        }) as T;\n    }\n\n    analytics.stepCompleted(step, Date.now() - startTime, true);\n    return result;\n  } catch (error) {\n    analytics.stepCompleted(step, Date.now() - startTime, false, error as Error);\n    throw error;\n  }\n}\n\nexport function updateProgress(step: string) {\n  analytics.setTag('progress', step);\n}\n"]}

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

@@ -0,0 +1,24 @@
+export declare class Analytics {
+    private tags;
+    private sessionId;
+    private sessionStartTime;
+    private distinctId?;
+    private totalInputTokens;
+    private totalOutputTokens;
+    private agentIterations;
+    constructor();
+    setDistinctId(distinctId: string): void;
+    setAccessToken(token: string): void;
+    setGatewayUrl(url: string): void;
+    setTag(key: string, value: string | boolean | number | null | undefined): void;
+    capture(eventName: string, properties?: Record<string, unknown>): void;
+    captureException(error: Error, properties?: Record<string, unknown>): void;
+    getFeatureFlag(_flagKey: string): Promise<string | boolean | undefined>;
+    sessionStart(mode: 'cli' | 'tui', version: string): void;
+    stepCompleted(name: string, durationMs: number, success: boolean, error?: Error): void;
+    toolCalled(toolName: string, durationMs: number, success: boolean): void;
+    llmRequest(model: string, inputTokens: number, outputTokens: number): void;
+    incrementAgentIterations(): void;
+    shutdown(status: 'success' | 'error' | 'cancelled'): Promise<void>;
+}
+export declare const analytics: Analytics;

package/dist/src/utils/analytics.js

@@ -0,0 +1,139 @@
+import { v4 as uuidv4 } from 'uuid';
+import { debug } from './debug.js';
+import { telemetryClient } from './telemetry-client.js';
+import { WORKOS_TELEMETRY_ENABLED } from '../lib/constants.js';
+export class Analytics {
+    tags = {};
+    sessionId;
+    sessionStartTime;
+    distinctId;
+    // Agent metrics tracking
+    totalInputTokens = 0;
+    totalOutputTokens = 0;
+    agentIterations = 0;
+    constructor() {
+        this.sessionId = uuidv4();
+        this.sessionStartTime = new Date();
+        this.tags = { $app_name: 'authkit-wizard' };
+    }
+    setDistinctId(distinctId) {
+        this.distinctId = distinctId;
+    }
+    setAccessToken(token) {
+        telemetryClient.setAccessToken(token);
+    }
+    setGatewayUrl(url) {
+        telemetryClient.setGatewayUrl(url);
+    }
+    setTag(key, value) {
+        this.tags[key] = value;
+    }
+    capture(eventName, properties) {
+        if (!WORKOS_TELEMETRY_ENABLED)
+            return;
+        debug(`[Analytics] capture: ${eventName}`, properties);
+        // Accumulate primitive values as tags for the session.end event
+        if (properties) {
+            for (const [key, value] of Object.entries(properties)) {
+                if (['string', 'number', 'boolean'].includes(typeof value)) {
+                    this.tags[key] = value;
+                }
+            }
+        }
+    }
+    captureException(error, properties = {}) {
+        if (!WORKOS_TELEMETRY_ENABLED)
+            return;
+        debug('[Analytics] captureException:', error.message, properties);
+        this.tags['error.type'] = error.name;
+        this.tags['error.message'] = error.message;
+    }
+    async getFeatureFlag(_flagKey) {
+        // Feature flags not implemented yet
+        return undefined;
+    }
+    sessionStart(mode, version) {
+        if (!WORKOS_TELEMETRY_ENABLED)
+            return;
+        const event = {
+            type: 'session.start',
+            sessionId: this.sessionId,
+            timestamp: this.sessionStartTime.toISOString(),
+            attributes: {
+                'wizard.version': version,
+                'wizard.mode': mode,
+                'workos.user_id': this.distinctId,
+            },
+        };
+        telemetryClient.queueEvent(event);
+    }
+    stepCompleted(name, durationMs, success, error) {
+        if (!WORKOS_TELEMETRY_ENABLED)
+            return;
+        const event = {
+            type: 'step',
+            sessionId: this.sessionId,
+            timestamp: new Date().toISOString(),
+            name,
+            durationMs,
+            success,
+            error: error ? { type: error.name, message: error.message } : undefined,
+        };
+        telemetryClient.queueEvent(event);
+    }
+    toolCalled(toolName, durationMs, success) {
+        if (!WORKOS_TELEMETRY_ENABLED)
+            return;
+        const event = {
+            type: 'agent.tool',
+            sessionId: this.sessionId,
+            timestamp: new Date().toISOString(),
+            toolName,
+            durationMs,
+            success,
+        };
+        telemetryClient.queueEvent(event);
+    }
+    llmRequest(model, inputTokens, outputTokens) {
+        if (!WORKOS_TELEMETRY_ENABLED)
+            return;
+        this.totalInputTokens += inputTokens;
+        this.totalOutputTokens += outputTokens;
+        const event = {
+            type: 'agent.llm',
+            sessionId: this.sessionId,
+            timestamp: new Date().toISOString(),
+            model,
+            inputTokens,
+            outputTokens,
+        };
+        telemetryClient.queueEvent(event);
+    }
+    incrementAgentIterations() {
+        this.agentIterations++;
+    }
+    async shutdown(status) {
+        if (!WORKOS_TELEMETRY_ENABLED)
+            return;
+        const duration = Date.now() - this.sessionStartTime.getTime();
+        // Filter out null/undefined tags
+        const extraAttributes = Object.fromEntries(Object.entries(this.tags).filter(([, v]) => v != null));
+        const event = {
+            type: 'session.end',
+            sessionId: this.sessionId,
+            timestamp: new Date().toISOString(),
+            attributes: {
+                'wizard.outcome': status,
+                'wizard.duration_ms': duration,
+                'wizard.agent.iterations': this.agentIterations,
+                'wizard.agent.tokens.input': this.totalInputTokens,
+                'wizard.agent.tokens.output': this.totalOutputTokens,
+                ...extraAttributes,
+            },
+        };
+        telemetryClient.queueEvent(event);
+        await telemetryClient.flush();
+    }
+}
+export const analytics = new Analytics();
+//# sourceMappingURL=analytics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../../src/utils/analytics.ts"],"names":[],"mappings":"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","sourcesContent":["import { v4 as uuidv4 } from 'uuid';\nimport { debug } from './debug.js';\nimport { telemetryClient } from './telemetry-client.js';\nimport type {\n  SessionStartEvent,\n  SessionEndEvent,\n  StepEvent,\n  AgentToolEvent,\n  AgentLLMEvent,\n} from './telemetry-types.js';\nimport { WORKOS_TELEMETRY_ENABLED } from '../lib/constants.js';\n\nexport class Analytics {\n  private tags: Record<string, string | boolean | number | null | undefined> = {};\n  private sessionId: string;\n  private sessionStartTime: Date;\n  private distinctId?: string;\n\n  // Agent metrics tracking\n  private totalInputTokens = 0;\n  private totalOutputTokens = 0;\n  private agentIterations = 0;\n\n  constructor() {\n    this.sessionId = uuidv4();\n    this.sessionStartTime = new Date();\n    this.tags = { $app_name: 'authkit-wizard' };\n  }\n\n  setDistinctId(distinctId: string) {\n    this.distinctId = distinctId;\n  }\n\n  setAccessToken(token: string) {\n    telemetryClient.setAccessToken(token);\n  }\n\n  setGatewayUrl(url: string) {\n    telemetryClient.setGatewayUrl(url);\n  }\n\n  setTag(key: string, value: string | boolean | number | null | undefined) {\n    this.tags[key] = value;\n  }\n\n  capture(eventName: string, properties?: Record<string, unknown>) {\n    if (!WORKOS_TELEMETRY_ENABLED) return;\n\n    debug(`[Analytics] capture: ${eventName}`, properties);\n\n    // Accumulate primitive values as tags for the session.end event\n    if (properties) {\n      for (const [key, value] of Object.entries(properties)) {\n        if (['string', 'number', 'boolean'].includes(typeof value)) {\n          this.tags[key] = value as string | number | boolean;\n        }\n      }\n    }\n  }\n\n  captureException(error: Error, properties: Record<string, unknown> = {}) {\n    if (!WORKOS_TELEMETRY_ENABLED) return;\n\n    debug('[Analytics] captureException:', error.message, properties);\n    this.tags['error.type'] = error.name;\n    this.tags['error.message'] = error.message;\n  }\n\n  async getFeatureFlag(_flagKey: string): Promise<string | boolean | undefined> {\n    // Feature flags not implemented yet\n    return undefined;\n  }\n\n  sessionStart(mode: 'cli' | 'tui', version: string) {\n    if (!WORKOS_TELEMETRY_ENABLED) return;\n\n    const event: SessionStartEvent = {\n      type: 'session.start',\n      sessionId: this.sessionId,\n      timestamp: this.sessionStartTime.toISOString(),\n      attributes: {\n        'wizard.version': version,\n        'wizard.mode': mode,\n        'workos.user_id': this.distinctId,\n      },\n    };\n\n    telemetryClient.queueEvent(event);\n  }\n\n  stepCompleted(name: string, durationMs: number, success: boolean, error?: Error) {\n    if (!WORKOS_TELEMETRY_ENABLED) return;\n\n    const event: StepEvent = {\n      type: 'step',\n      sessionId: this.sessionId,\n      timestamp: new Date().toISOString(),\n      name,\n      durationMs,\n      success,\n      error: error ? { type: error.name, message: error.message } : undefined,\n    };\n\n    telemetryClient.queueEvent(event);\n  }\n\n  toolCalled(toolName: string, durationMs: number, success: boolean) {\n    if (!WORKOS_TELEMETRY_ENABLED) return;\n\n    const event: AgentToolEvent = {\n      type: 'agent.tool',\n      sessionId: this.sessionId,\n      timestamp: new Date().toISOString(),\n      toolName,\n      durationMs,\n      success,\n    };\n\n    telemetryClient.queueEvent(event);\n  }\n\n  llmRequest(model: string, inputTokens: number, outputTokens: number) {\n    if (!WORKOS_TELEMETRY_ENABLED) return;\n\n    this.totalInputTokens += inputTokens;\n    this.totalOutputTokens += outputTokens;\n\n    const event: AgentLLMEvent = {\n      type: 'agent.llm',\n      sessionId: this.sessionId,\n      timestamp: new Date().toISOString(),\n      model,\n      inputTokens,\n      outputTokens,\n    };\n\n    telemetryClient.queueEvent(event);\n  }\n\n  incrementAgentIterations() {\n    this.agentIterations++;\n  }\n\n  async shutdown(status: 'success' | 'error' | 'cancelled') {\n    if (!WORKOS_TELEMETRY_ENABLED) return;\n\n    const duration = Date.now() - this.sessionStartTime.getTime();\n\n    // Filter out null/undefined tags\n    const extraAttributes = Object.fromEntries(Object.entries(this.tags).filter(([, v]) => v != null)) as Record<\n      string,\n      string | number | boolean\n    >;\n\n    const event: SessionEndEvent = {\n      type: 'session.end',\n      sessionId: this.sessionId,\n      timestamp: new Date().toISOString(),\n      attributes: {\n        'wizard.outcome': status,\n        'wizard.duration_ms': duration,\n        'wizard.agent.iterations': this.agentIterations,\n        'wizard.agent.tokens.input': this.totalInputTokens,\n        'wizard.agent.tokens.output': this.totalOutputTokens,\n        ...extraAttributes,\n      },\n    };\n\n    telemetryClient.queueEvent(event);\n    await telemetryClient.flush();\n  }\n}\n\nexport const analytics = new Analytics();\n"]}

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

@@ -0,0 +1,2 @@
+export declare function executeSync(command: string): string;
+export declare function execute(command: string): Promise<string>;

package/dist/src/utils/bash.js

@@ -0,0 +1,17 @@
+import * as child_process from 'child_process';
+export function executeSync(command) {
+    const output = child_process.execSync(command);
+    return output.toString();
+}
+export function execute(command) {
+    return new Promise((resolve, reject) => {
+        child_process.exec(command, (error, stdout, _) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+//# sourceMappingURL=bash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../../src/utils/bash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,eAAe,CAAC;AAE/C,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;YAC/C,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,OAAO;YACT,CAAC;YAED,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import * as child_process from 'child_process';\n\nexport function executeSync(command: string): string {\n  const output = child_process.execSync(command);\n  return output.toString();\n}\n\nexport function execute(command: string): Promise<string> {\n  return new Promise((resolve, reject) => {\n    child_process.exec(command, (error, stdout, _) => {\n      if (error) {\n        reject(error);\n        return;\n      }\n\n      resolve(stdout);\n    });\n  });\n}\n"]}

package/dist/src/utils/clack-utils.d.ts

@@ -0,0 +1,93 @@
+import { type PackageDotJson } from './package-json.js';
+import { type PackageManager } from './package-manager.js';
+import type { WizardOptions } from './types.js';
+import { type Integration } from '../lib/constants.js';
+export interface CliSetupConfig {
+    filename: string;
+    name: string;
+    gitignore: boolean;
+    likelyAlreadyHasAuthToken(contents: string): boolean;
+    tokenContent(authToken: string): string;
+    likelyAlreadyHasOrgAndProject(contents: string): boolean;
+    orgAndProjContent(org: string, project: string): string;
+    likelyAlreadyHasUrl?(contents: string): boolean;
+    urlContent?(url: string): string;
+}
+export interface CliSetupConfigContent {
+    authToken: string;
+    org?: string;
+    project?: string;
+    url?: string;
+}
+export declare function abort(message?: string, status?: number): Promise<never>;
+export declare function abortIfCancelled<T>(input: T | Promise<T>, integration?: Integration): Promise<Exclude<T, symbol>>;
+export declare function printWelcome(options: {
+    wizardName: string;
+    message?: string;
+}): void;
+export declare function confirmContinueIfNoOrDirtyGitRepo(options: Pick<WizardOptions, 'ci'>): Promise<void>;
+export declare function isInGitRepo(): boolean;
+export declare function getUncommittedOrUntrackedFiles(): string[];
+export declare function askForItemSelection(items: string[], message: string): Promise<{
+    value: string;
+    index: number;
+}>;
+export declare function confirmContinueIfPackageVersionNotSupported({ packageId, packageName, packageVersion, acceptableVersions, note, }: {
+    packageId: string;
+    packageName: string;
+    packageVersion: string;
+    acceptableVersions: string;
+    note?: string;
+}): Promise<void>;
+export declare function isReact19Installed({ installDir }: Pick<WizardOptions, 'installDir'>): Promise<boolean>;
+/**
+ * Installs or updates a package with the user's package manager.
+ *
+ * IMPORTANT: This function modifies the `package.json`! Be sure to re-read
+ * it if you make additional modifications to it after calling this function!
+ */
+export declare function installPackage({ packageName, alreadyInstalled, askBeforeUpdating, packageNameDisplayLabel, packageManager, forceInstall, integration, installDir, }: {
+    /** The string that is passed to the package manager CLI as identifier to install (e.g. `@workos-inc/authkit-nextjs`, or `@workos-inc/authkit-nextjs@^2.0.0`) */
+    packageName: string;
+    alreadyInstalled: boolean;
+    askBeforeUpdating?: boolean;
+    /** Overrides what is shown in the installation logs in place of the `packageName` option. Useful if the `packageName` is ugly */
+    packageNameDisplayLabel?: string;
+    packageManager?: PackageManager;
+    /** Add force install flag to command to skip install precondition fails */
+    forceInstall?: boolean;
+    /** The integration that is being used */
+    integration?: string;
+    /** The directory to install the package in */
+    installDir: string;
+}): Promise<{
+    packageManager?: PackageManager;
+}>;
+/**
+ * Checks if @param packageId is listed as a dependency in @param packageJson.
+ * If not, it will ask users if they want to continue without the package.
+ *
+ * Use this function to check if e.g. a the framework of the SDK is installed
+ *
+ * @param packageJson the package.json object
+ * @param packageId the npm name of the package
+ * @param packageName a human readable name of the package
+ */
+export declare function ensurePackageIsInstalled(packageJson: PackageDotJson, packageId: string, packageName: string, options?: Pick<WizardOptions, 'dashboard'>): Promise<void>;
+export declare function getPackageDotJson({ installDir }: Pick<WizardOptions, 'installDir'>): Promise<PackageDotJson>;
+export declare function updatePackageDotJson(packageDotJson: PackageDotJson, { installDir }: Pick<WizardOptions, 'installDir'>): Promise<void>;
+export declare function getPackageManager(options: Pick<WizardOptions, 'installDir'> & {
+    ci?: boolean;
+}): Promise<PackageManager>;
+export declare function isUsingTypeScript({ installDir }: Pick<WizardOptions, 'installDir'>): boolean;
+/**
+ * Get WorkOS credentials (API Key and Client ID) from user or CLI options
+ * @param requireApiKey - Whether API key is needed (false for client-only SDKs like React, Vanilla JS)
+ */
+export declare function getOrAskForWorkOSCredentials(_options: Pick<WizardOptions, 'ci' | 'apiKey' | 'clientId' | 'installDir' | 'dashboard'>, requireApiKey?: boolean): Promise<{
+    apiKey: string;
+    clientId: string;
+}>;
+/**
+ * Fetch project data using a personal API key (for CI mode)
+ */