workos 0.4.5 → 0.5.0

package/dist/react-router/utils.js

@@ -1,210 +1,5 @@
-import { major } from 'semver';
-import fg from 'fast-glob';
-import { abortIfCancelled, getPackageDotJson } 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';
-import { getPackageVersion } from '../utils/package-json.js';
-import chalk from 'chalk';
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import * as semver from 'semver';
-export var ReactRouterMode;
-(function (ReactRouterMode) {
-    ReactRouterMode["V6"] = "v6";
-    ReactRouterMode["V7_FRAMEWORK"] = "v7-framework";
-    ReactRouterMode["V7_DATA"] = "v7-data";
-    ReactRouterMode["V7_DECLARATIVE"] = "v7-declarative";
-})(ReactRouterMode || (ReactRouterMode = {}));
 /**
- * Get React Router version bucket for analytics
+ * @deprecated Import from 'src/integrations/react-router/utils.js' instead.
  */
-export function getReactRouterVersionBucket(version) {
-    return getVersionBucket(version, 6);
-}
-/**
- * Check if react-router.config.ts exists (indicates framework mode - React Router v7)
- */
-async function hasReactRouterConfig({ installDir }) {
-    const configMatches = await fg('**/react-router.config.@(ts|js|tsx|jsx)', {
-        dot: true,
-        cwd: installDir,
-        ignore: IGNORE_PATTERNS,
-    });
-    return configMatches.length > 0;
-}
-/**
- * Search for createBrowserRouter usage in source files
- */
-async function hasCreateBrowserRouter({ installDir }) {
-    const sourceFiles = await fg('**/*.@(ts|tsx|js|jsx)', {
-        dot: true,
-        cwd: installDir,
-        ignore: IGNORE_PATTERNS,
-    });
-    for (const file of sourceFiles) {
-        try {
-            const filePath = path.join(installDir, file);
-            const content = fs.readFileSync(filePath, 'utf-8');
-            // Check for createBrowserRouter import or usage
-            if (content.includes('createBrowserRouter')) {
-                return true;
-            }
-        }
-        catch {
-            // Skip files that can't be read
-            continue;
-        }
-    }
-    return false;
-}
-/**
- * Search for declarative BrowserRouter usage
- */
-async function hasDeclarativeRouter({ installDir }) {
-    const sourceFiles = await fg('**/*.@(ts|tsx|js|jsx)', {
-        dot: true,
-        cwd: installDir,
-        ignore: IGNORE_PATTERNS,
-    });
-    for (const file of sourceFiles) {
-        try {
-            const filePath = path.join(installDir, file);
-            const content = fs.readFileSync(filePath, 'utf-8');
-            // Check for BrowserRouter usage (JSX or import)
-            if (content.includes('<BrowserRouter') ||
-                (content.includes('BrowserRouter') &&
-                    (content.includes('from "react-router-dom"') || content.includes("from 'react-router-dom'")))) {
-                return true;
-            }
-        }
-        catch {
-            // Skip files that can't be read
-            continue;
-        }
-    }
-    return false;
-}
-/**
- * Detect React Router mode
- */
-export async function getReactRouterMode(options) {
-    const { installDir } = options;
-    // First, get the React Router version
-    const packageJson = await getPackageDotJson(options);
-    const reactRouterVersion = getPackageVersion('react-router-dom', packageJson) || getPackageVersion('react-router', packageJson);
-    if (!reactRouterVersion) {
-        // If we can't detect version, ask the user
-        clack.log.info(`Learn more about React Router modes: ${chalk.cyan('https://reactrouter.com/start/modes')}`);
-        const result = await abortIfCancelled(clack.select({
-            message: 'What React Router version and mode are you using?',
-            options: [
-                {
-                    label: 'React Router v6',
-                    value: ReactRouterMode.V6,
-                },
-                {
-                    label: 'React Router v7 - Framework mode',
-                    value: ReactRouterMode.V7_FRAMEWORK,
-                },
-                {
-                    label: 'React Router v7 - Data mode',
-                    value: ReactRouterMode.V7_DATA,
-                },
-                {
-                    label: 'React Router v7 - Declarative mode',
-                    value: ReactRouterMode.V7_DECLARATIVE,
-                },
-            ],
-        }), Integration.reactRouter);
-        return result;
-    }
-    const coercedVersion = semver.coerce(reactRouterVersion);
-    const majorVersion = coercedVersion ? major(coercedVersion) : null;
-    // If v6, return V6
-    if (majorVersion === 6) {
-        clack.log.info('Detected React Router v6');
-        return ReactRouterMode.V6;
-    }
-    // If v7, detect the mode
-    if (majorVersion === 7) {
-        // First check for framework mode (react-router.config.ts)
-        const hasConfig = await hasReactRouterConfig({ installDir });
-        if (hasConfig) {
-            clack.log.info('Detected React Router v7 - Framework mode');
-            return ReactRouterMode.V7_FRAMEWORK;
-        }
-        // Check for data mode (createBrowserRouter)
-        const hasDataMode = await hasCreateBrowserRouter({ installDir });
-        if (hasDataMode) {
-            clack.log.info('Detected React Router v7 - Data mode');
-            return ReactRouterMode.V7_DATA;
-        }
-        // Check for declarative mode (BrowserRouter)
-        const hasDeclarative = await hasDeclarativeRouter({ installDir });
-        if (hasDeclarative) {
-            clack.log.info('Detected React Router v7 - Declarative mode');
-            return ReactRouterMode.V7_DECLARATIVE;
-        }
-        // If v7 but can't detect mode, ask the user
-        clack.log.info(`Learn more about React Router modes: ${chalk.cyan('https://reactrouter.com/start/modes')}`);
-        const result = await abortIfCancelled(clack.select({
-            message: 'What React Router v7 mode are you using?',
-            options: [
-                {
-                    label: 'Framework mode',
-                    value: ReactRouterMode.V7_FRAMEWORK,
-                },
-                {
-                    label: 'Data mode',
-                    value: ReactRouterMode.V7_DATA,
-                },
-                {
-                    label: 'Declarative mode',
-                    value: ReactRouterMode.V7_DECLARATIVE,
-                },
-            ],
-        }), Integration.reactRouter);
-        return result;
-    }
-    // If version is not 6 or 7, default to asking
-    clack.log.info(`Learn more about React Router modes: ${chalk.cyan('https://reactrouter.com/start/modes')}`);
-    const result = await abortIfCancelled(clack.select({
-        message: 'What React Router version and mode are you using?',
-        options: [
-            {
-                label: 'React Router v6',
-                value: ReactRouterMode.V6,
-            },
-            {
-                label: 'React Router v7 - Framework mode',
-                value: ReactRouterMode.V7_FRAMEWORK,
-            },
-            {
-                label: 'React Router v7 - Data mode',
-                value: ReactRouterMode.V7_DATA,
-            },
-            {
-                label: 'React Router v7 - Declarative mode',
-                value: ReactRouterMode.V7_DECLARATIVE,
-            },
-        ],
-    }), Integration.reactRouter);
-    return result;
-}
-/**
- * Get human-readable name for React Router mode
- */
-export function getReactRouterModeName(mode) {
-    switch (mode) {
-        case ReactRouterMode.V6:
-            return 'v6';
-        case ReactRouterMode.V7_FRAMEWORK:
-            return 'v7 Framework mode';
-        case ReactRouterMode.V7_DATA:
-            return 'v7 Data mode';
-        case ReactRouterMode.V7_DECLARATIVE:
-            return 'v7 Declarative mode';
-    }
-}
+export { ReactRouterMode, getReactRouterVersionBucket, getReactRouterMode, getReactRouterModeName, } from '../integrations/react-router/utils.js';
 //# sourceMappingURL=utils.js.map

package/dist/react-router/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/react-router/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { major } from 'semver';\nimport fg from 'fast-glob';\nimport { abortIfCancelled, getPackageDotJson } from '../utils/clack-utils.js';\nimport clack from '../utils/clack.js';\nimport { getVersionBucket } from '../utils/semver.js';\nimport type { InstallerOptions } from '../utils/types.js';\nimport { IGNORE_PATTERNS, Integration } from '../lib/constants.js';\nimport { getPackageVersion } from '../utils/package-json.js';\nimport chalk from 'chalk';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport * as semver from 'semver';\n\nexport enum ReactRouterMode {\n  V6 = 'v6', // React Router v6\n  V7_FRAMEWORK = 'v7-framework', // React Router v7 with react-router.config.ts\n  V7_DATA = 'v7-data', // React Router v7 with createBrowserRouter\n  V7_DECLARATIVE = 'v7-declarative', // React Router v7 with BrowserRouter\n}\n\n/**\n * Get React Router version bucket for analytics\n */\nexport function getReactRouterVersionBucket(version: string | undefined): string {\n  return getVersionBucket(version, 6);\n}\n\n/**\n * Check if react-router.config.ts exists (indicates framework mode - React Router v7)\n */\nasync function hasReactRouterConfig({ installDir }: Pick<InstallerOptions, 'installDir'>): Promise<boolean> {\n  const configMatches = await fg('**/react-router.config.@(ts|js|tsx|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  return configMatches.length > 0;\n}\n\n/**\n * Search for createBrowserRouter usage in source files\n */\nasync function hasCreateBrowserRouter({ installDir }: Pick<InstallerOptions, 'installDir'>): Promise<boolean> {\n  const sourceFiles = await fg('**/*.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  for (const file of sourceFiles) {\n    try {\n      const filePath = path.join(installDir, file);\n      const content = fs.readFileSync(filePath, 'utf-8');\n\n      // Check for createBrowserRouter import or usage\n      if (content.includes('createBrowserRouter')) {\n        return true;\n      }\n    } catch {\n      // Skip files that can't be read\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Search for declarative BrowserRouter usage\n */\nasync function hasDeclarativeRouter({ installDir }: Pick<InstallerOptions, 'installDir'>): Promise<boolean> {\n  const sourceFiles = await fg('**/*.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  for (const file of sourceFiles) {\n    try {\n      const filePath = path.join(installDir, file);\n      const content = fs.readFileSync(filePath, 'utf-8');\n\n      // Check for BrowserRouter usage (JSX or import)\n      if (\n        content.includes('<BrowserRouter') ||\n        (content.includes('BrowserRouter') &&\n          (content.includes('from \"react-router-dom\"') || content.includes(\"from 'react-router-dom'\")))\n      ) {\n        return true;\n      }\n    } catch {\n      // Skip files that can't be read\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Detect React Router mode\n */\nexport async function getReactRouterMode(options: InstallerOptions): Promise<ReactRouterMode> {\n  const { installDir } = options;\n\n  // First, get the React Router version\n  const packageJson = await getPackageDotJson(options);\n  const reactRouterVersion =\n    getPackageVersion('react-router-dom', packageJson) || getPackageVersion('react-router', packageJson);\n\n  if (!reactRouterVersion) {\n    // If we can't detect version, ask the user\n    clack.log.info(`Learn more about React Router modes: ${chalk.cyan('https://reactrouter.com/start/modes')}`);\n    const result: ReactRouterMode = await abortIfCancelled(\n      clack.select({\n        message: 'What React Router version and mode are you using?',\n        options: [\n          {\n            label: 'React Router v6',\n            value: ReactRouterMode.V6,\n          },\n          {\n            label: 'React Router v7 - Framework mode',\n            value: ReactRouterMode.V7_FRAMEWORK,\n          },\n          {\n            label: 'React Router v7 - Data mode',\n            value: ReactRouterMode.V7_DATA,\n          },\n          {\n            label: 'React Router v7 - Declarative mode',\n            value: ReactRouterMode.V7_DECLARATIVE,\n          },\n        ],\n      }),\n      Integration.reactRouter,\n    );\n    return result;\n  }\n\n  const coercedVersion = semver.coerce(reactRouterVersion);\n  const majorVersion = coercedVersion ? major(coercedVersion) : null;\n\n  // If v6, return V6\n  if (majorVersion === 6) {\n    clack.log.info('Detected React Router v6');\n    return ReactRouterMode.V6;\n  }\n\n  // If v7, detect the mode\n  if (majorVersion === 7) {\n    // First check for framework mode (react-router.config.ts)\n    const hasConfig = await hasReactRouterConfig({ installDir });\n    if (hasConfig) {\n      clack.log.info('Detected React Router v7 - Framework mode');\n      return ReactRouterMode.V7_FRAMEWORK;\n    }\n\n    // Check for data mode (createBrowserRouter)\n    const hasDataMode = await hasCreateBrowserRouter({ installDir });\n    if (hasDataMode) {\n      clack.log.info('Detected React Router v7 - Data mode');\n      return ReactRouterMode.V7_DATA;\n    }\n\n    // Check for declarative mode (BrowserRouter)\n    const hasDeclarative = await hasDeclarativeRouter({ installDir });\n    if (hasDeclarative) {\n      clack.log.info('Detected React Router v7 - Declarative mode');\n      return ReactRouterMode.V7_DECLARATIVE;\n    }\n\n    // If v7 but can't detect mode, ask the user\n    clack.log.info(`Learn more about React Router modes: ${chalk.cyan('https://reactrouter.com/start/modes')}`);\n    const result: ReactRouterMode = await abortIfCancelled(\n      clack.select({\n        message: 'What React Router v7 mode are you using?',\n        options: [\n          {\n            label: 'Framework mode',\n            value: ReactRouterMode.V7_FRAMEWORK,\n          },\n          {\n            label: 'Data mode',\n            value: ReactRouterMode.V7_DATA,\n          },\n          {\n            label: 'Declarative mode',\n            value: ReactRouterMode.V7_DECLARATIVE,\n          },\n        ],\n      }),\n      Integration.reactRouter,\n    );\n    return result;\n  }\n\n  // If version is not 6 or 7, default to asking\n  clack.log.info(`Learn more about React Router modes: ${chalk.cyan('https://reactrouter.com/start/modes')}`);\n  const result: ReactRouterMode = await abortIfCancelled(\n    clack.select({\n      message: 'What React Router version and mode are you using?',\n      options: [\n        {\n          label: 'React Router v6',\n          value: ReactRouterMode.V6,\n        },\n        {\n          label: 'React Router v7 - Framework mode',\n          value: ReactRouterMode.V7_FRAMEWORK,\n        },\n        {\n          label: 'React Router v7 - Data mode',\n          value: ReactRouterMode.V7_DATA,\n        },\n        {\n          label: 'React Router v7 - Declarative mode',\n          value: ReactRouterMode.V7_DECLARATIVE,\n        },\n      ],\n    }),\n    Integration.reactRouter,\n  );\n  return result;\n}\n\n/**\n * Get human-readable name for React Router mode\n */\nexport function getReactRouterModeName(mode: ReactRouterMode): string {\n  switch (mode) {\n    case ReactRouterMode.V6:\n      return 'v6';\n    case ReactRouterMode.V7_FRAMEWORK:\n      return 'v7 Framework mode';\n    case ReactRouterMode.V7_DATA:\n      return 'v7 Data mode';\n    case ReactRouterMode.V7_DECLARATIVE:\n      return 'v7 Declarative mode';\n  }\n}\n"]}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/react-router/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,uCAAuC,CAAC","sourcesContent":["/**\n * @deprecated Import from 'src/integrations/react-router/utils.js' instead.\n */\nexport {\n  ReactRouterMode,\n  getReactRouterVersionBucket,\n  getReactRouterMode,\n  getReactRouterModeName,\n} from '../integrations/react-router/utils.js';\n"]}

package/dist/tanstack-start/tanstack-start-installer-agent.d.ts

@@ -1,2 +1,4 @@
-import type { InstallerOptions } from '../utils/types.js';
-export declare function runTanstackStartInstallerAgent(options: InstallerOptions): Promise<string>;
+/**
+ * @deprecated Import from 'src/integrations/tanstack-start/index.js' instead.
+ */
+export { run as runTanstackStartInstallerAgent, config as TANSTACK_START_AGENT_CONFIG, } from '../integrations/tanstack-start/index.js';

package/dist/tanstack-start/tanstack-start-installer-agent.js

@@ -1,49 +1,5 @@
-import { enableDebugLogs } from '../utils/debug.js';
-import { runAgentInstaller } 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 runTanstackStartInstallerAgent(options) {
-    if (options.debug) {
-        enableDebugLogs();
-    }
-    return runAgentInstaller(TANSTACK_START_AGENT_CONFIG, options);
-}
+/**
+ * @deprecated Import from 'src/integrations/tanstack-start/index.js' instead.
+ */
+export { run as runTanstackStartInstallerAgent, config as TANSTACK_START_AGENT_CONFIG, } from '../integrations/tanstack-start/index.js';
 //# sourceMappingURL=tanstack-start-installer-agent.js.map

package/dist/tanstack-start/tanstack-start-installer-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"tanstack-start-installer-agent.js","sourceRoot":"","sources":["../../src/tanstack-start/tanstack-start-installer-agent.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,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,8BAA8B,CAAC,OAAyB;IAC5E,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;IACpB,CAAC;IAED,OAAO,iBAAiB,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC","sourcesContent":["/* TanStack Start wizard using Claude Agent SDK */\nimport type { InstallerOptions } from '../utils/types.js';\nimport type { FrameworkConfig } from '../lib/framework-config.js';\nimport { enableDebugLogs } from '../utils/debug.js';\nimport { runAgentInstaller } 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 runTanstackStartInstallerAgent(options: InstallerOptions): Promise<string> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  return runAgentInstaller(TANSTACK_START_AGENT_CONFIG, options);\n}\n"]}
+{"version":3,"file":"tanstack-start-installer-agent.js","sourceRoot":"","sources":["../../src/tanstack-start/tanstack-start-installer-agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,GAAG,IAAI,8BAA8B,EACrC,MAAM,IAAI,2BAA2B,GACtC,MAAM,yCAAyC,CAAC","sourcesContent":["/**\n * @deprecated Import from 'src/integrations/tanstack-start/index.js' instead.\n */\nexport {\n  run as runTanstackStartInstallerAgent,\n  config as TANSTACK_START_AGENT_CONFIG,\n} from '../integrations/tanstack-start/index.js';\n"]}

package/dist/vanilla-js/vanilla-js-installer-agent.d.ts

@@ -1,2 +1,4 @@
-import type { InstallerOptions } from '../utils/types.js';
-export declare function runVanillaJsInstallerAgent(options: InstallerOptions): Promise<string>;
+/**
+ * @deprecated Import from 'src/integrations/vanilla-js/index.js' instead.
+ */
+export { run as runVanillaJsInstallerAgent, config as VANILLA_JS_AGENT_CONFIG, } from '../integrations/vanilla-js/index.js';

package/dist/vanilla-js/vanilla-js-installer-agent.js

@@ -1,47 +1,5 @@
-import { enableDebugLogs } from '../utils/debug.js';
-import { runAgentInstaller } from '../lib/agent-runner.js';
-import { Integration } from '../lib/constants.js';
-const VANILLA_JS_AGENT_CONFIG = {
-    metadata: {
-        name: 'Vanilla JavaScript',
-        integration: Integration.vanillaJs,
-        docsUrl: 'https://workos.com/docs/user-management/authkit/javascript',
-        unsupportedVersionDocsUrl: 'https://workos.com/docs/user-management/authkit/javascript',
-        skillName: 'workos-authkit-vanilla-js',
-    },
-    detection: {
-        packageName: 'workos',
-        packageDisplayName: 'Vanilla JavaScript',
-        getVersion: () => undefined,
-    },
-    environment: {
-        uploadToHosting: false,
-        requiresApiKey: false, // Client-only
-        getEnvVars: (apiKey, clientId) => ({
-            WORKOS_CLIENT_ID: clientId, // Only client ID needed
-        }),
-    },
-    analytics: {
-        getTags: () => ({}),
-    },
-    prompts: {},
-    ui: {
-        successMessage: 'WorkOS AuthKit integration complete',
-        getOutroChanges: () => [
-            'Created WorkOS AuthKit integration',
-            'Added authentication to your JavaScript application',
-            'Set up login/logout functionality',
-        ],
-        getOutroNextSteps: () => [
-            'Start your development server to test authentication',
-            'Visit the WorkOS Dashboard to manage users and settings',
-        ],
-    },
-};
-export async function runVanillaJsInstallerAgent(options) {
-    if (options.debug) {
-        enableDebugLogs();
-    }
-    return runAgentInstaller(VANILLA_JS_AGENT_CONFIG, options);
-}
+/**
+ * @deprecated Import from 'src/integrations/vanilla-js/index.js' instead.
+ */
+export { run as runVanillaJsInstallerAgent, config as VANILLA_JS_AGENT_CONFIG, } from '../integrations/vanilla-js/index.js';
 //# sourceMappingURL=vanilla-js-installer-agent.js.map

package/dist/vanilla-js/vanilla-js-installer-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"vanilla-js-installer-agent.js","sourceRoot":"","sources":["../../src/vanilla-js/vanilla-js-installer-agent.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,uBAAuB,GAAoB;IAC/C,QAAQ,EAAE;QACR,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,WAAW,CAAC,SAAS;QAClC,OAAO,EAAE,4DAA4D;QACrE,yBAAyB,EAAE,4DAA4D;QACvF,SAAS,EAAE,2BAA2B;KACvC;IAED,SAAS,EAAE;QACT,WAAW,EAAE,QAAQ;QACrB,kBAAkB,EAAE,oBAAoB;QACxC,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS;KAC5B;IAED,WAAW,EAAE;QACX,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK,EAAE,cAAc;QACrC,UAAU,EAAE,CAAC,MAAc,EAAE,QAAgB,EAAE,EAAE,CAAC,CAAC;YACjD,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,oCAAoC;YACpC,qDAAqD;YACrD,mCAAmC;SACpC;QACD,iBAAiB,EAAE,GAAG,EAAE,CAAC;YACvB,sDAAsD;YACtD,yDAAyD;SAC1D;KACF;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,OAAyB;IACxE,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;IACpB,CAAC;IAED,OAAO,iBAAiB,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC","sourcesContent":["/* Vanilla JS wizard using Claude Agent SDK */\nimport type { InstallerOptions } from '../utils/types.js';\nimport type { FrameworkConfig } from '../lib/framework-config.js';\nimport { enableDebugLogs } from '../utils/debug.js';\nimport { runAgentInstaller } from '../lib/agent-runner.js';\nimport { Integration } from '../lib/constants.js';\n\nconst VANILLA_JS_AGENT_CONFIG: FrameworkConfig = {\n  metadata: {\n    name: 'Vanilla JavaScript',\n    integration: Integration.vanillaJs,\n    docsUrl: 'https://workos.com/docs/user-management/authkit/javascript',\n    unsupportedVersionDocsUrl: 'https://workos.com/docs/user-management/authkit/javascript',\n    skillName: 'workos-authkit-vanilla-js',\n  },\n\n  detection: {\n    packageName: 'workos',\n    packageDisplayName: 'Vanilla JavaScript',\n    getVersion: () => undefined,\n  },\n\n  environment: {\n    uploadToHosting: false,\n    requiresApiKey: false, // Client-only\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      'Created WorkOS AuthKit integration',\n      'Added authentication to your JavaScript application',\n      'Set up login/logout functionality',\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 runVanillaJsInstallerAgent(options: InstallerOptions): Promise<string> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  return runAgentInstaller(VANILLA_JS_AGENT_CONFIG, options);\n}\n"]}
+{"version":3,"file":"vanilla-js-installer-agent.js","sourceRoot":"","sources":["../../src/vanilla-js/vanilla-js-installer-agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,GAAG,IAAI,0BAA0B,EACjC,MAAM,IAAI,uBAAuB,GAClC,MAAM,qCAAqC,CAAC","sourcesContent":["/**\n * @deprecated Import from 'src/integrations/vanilla-js/index.js' instead.\n */\nexport {\n  run as runVanillaJsInstallerAgent,\n  config as VANILLA_JS_AGENT_CONFIG,\n} from '../integrations/vanilla-js/index.js';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workos",
-  "version": "0.4.5",
+  "version": "0.5.0",
   "type": "module",
   "description": "The Official Workos CLI",
   "repository": {
@@ -73,8 +73,7 @@
   "engines": {
     "node": ">=20.20"
   },
-  "author": "WorkOS",
-  "license": "MIT",
+  "packageManager": "pnpm@10.28.2",
   "scripts": {
     "clean": "rm -rf ./dist",
     "prebuild": "pnpm clean",
@@ -95,5 +94,7 @@
     "eval:prune": "tsx tests/evals/index.ts prune",
     "eval:logs": "tsx tests/evals/index.ts logs",
     "eval:show": "tsx tests/evals/index.ts show"
-  }
-}
+  },
+  "author": "WorkOS",
+  "license": "MIT"
+}

package/skills/workos-authkit-sveltekit/SKILL.md

@@ -0,0 +1,160 @@
+---
+name: workos-authkit-sveltekit
+description: Integrate WorkOS AuthKit with SvelteKit. Server-side authentication with hooks and file-based routing.
+---
+
+# WorkOS AuthKit for SvelteKit
+
+## Step 1: Fetch SDK Documentation (BLOCKING)
+
+**STOP. Do not proceed until complete.**
+
+WebFetch: `https://github.com/workos/authkit-sveltekit/blob/main/README.md`
+
+The README is the source of truth. If this skill conflicts with README, follow README.
+
+## Step 2: Pre-Flight Validation
+
+### Project Structure
+
+- Confirm `svelte.config.js` (or `svelte.config.ts`) exists
+- Confirm `package.json` contains `@sveltejs/kit` dependency
+- Confirm `src/routes/` directory exists
+
+### Environment Variables
+
+Check `.env` or `.env.local` for:
+
+- `WORKOS_API_KEY` - starts with `sk_`
+- `WORKOS_CLIENT_ID` - starts with `client_`
+- `WORKOS_REDIRECT_URI` - valid callback URL
+- `WORKOS_COOKIE_PASSWORD` - 32+ characters
+
+SvelteKit uses `$env/static/private` and `$env/dynamic/private` natively. The agent should write env vars to `.env` (SvelteKit's default) or `.env.local`.
+
+## Step 3: Install SDK
+
+Detect package manager, install SDK package from README.
+
+```
+pnpm-lock.yaml? → pnpm add @workos-inc/authkit-sveltekit
+yarn.lock? → yarn add @workos-inc/authkit-sveltekit
+bun.lockb? → bun add @workos-inc/authkit-sveltekit
+else → npm install @workos-inc/authkit-sveltekit
+```
+
+**Verify:** SDK package exists in node_modules before continuing.
+
+## Step 4: Configure Server Hooks
+
+SvelteKit uses `src/hooks.server.ts` for server-side middleware. This is where the AuthKit handler is registered.
+
+Create or update `src/hooks.server.ts` with the authkit handle function from the README.
+
+### Existing Hooks (IMPORTANT)
+
+If `src/hooks.server.ts` already exists with custom logic, use SvelteKit's `sequence()` helper to compose hooks:
+
+```typescript
+import { sequence } from '@sveltejs/kit/hooks';
+import { authkitHandle } from '@workos-inc/authkit-sveltekit'; // Check README for exact export
+
+export const handle = sequence(authkitHandle, yourExistingHandle);
+```
+
+Check README for the exact export name and usage pattern.
+
+## Step 5: Create Callback Route
+
+Parse `WORKOS_REDIRECT_URI` to determine route path:
+
+```
+URI path          --> Route location
+/callback         --> src/routes/callback/+server.ts
+/auth/callback    --> src/routes/auth/callback/+server.ts
+```
+
+Use the SDK's callback handler from the README. Do not write custom OAuth logic.
+
+**Critical:** SvelteKit uses `+server.ts` for API routes, not `+page.server.ts`.
+
+## Step 6: Layout Setup
+
+Update `src/routes/+layout.server.ts` to load the auth session and pass it to all pages.
+
+Check README for the exact pattern — typically a `load` function that returns the user session from locals.
+
+```typescript
+// src/routes/+layout.server.ts
+import type { LayoutServerLoad } from './$types';
+
+export const load: LayoutServerLoad = async (event) => {
+  // Check README for exact API — session is typically on event.locals
+  return {
+    user: event.locals.user, // or similar from README
+  };
+};
+```
+
+## Step 7: UI Integration
+
+Add auth UI to `src/routes/+page.svelte` using the session data from the layout.
+
+- Show user info when authenticated
+- Show sign-in link/button when not authenticated
+- Add sign-out functionality
+
+Check README for sign-in URL generation and sign-out patterns.
+
+## Verification Checklist (ALL MUST PASS)
+
+Run these commands to confirm integration. **Do not mark complete until all pass:**
+
+```bash
+# 1. Check hooks.server.ts exists and has authkit
+grep -i "workos\|authkit" src/hooks.server.ts || echo "FAIL: authkit missing from hooks.server.ts"
+
+# 2. Check callback route exists
+find src/routes -name "+server.ts" -path "*/callback/*"
+
+# 3. Check layout loads auth session
+grep -i "user\|auth\|session" src/routes/+layout.server.ts || echo "FAIL: auth session missing from layout"
+
+# 4. Build succeeds
+pnpm build || npm run build
+```
+
+## Error Recovery
+
+### "Cannot find module '@workos-inc/authkit-sveltekit'"
+
+- Check: SDK installed before writing imports
+- Check: SDK package directory exists in node_modules
+- Re-run install if missing
+
+### hooks.server.ts not taking effect
+
+- Check: File is at `src/hooks.server.ts`, not `src/hooks.ts` or elsewhere
+- Check: Named export is `handle` (SvelteKit requirement)
+- Check: If using `sequence()`, all handles are properly composed
+
+### Callback route not found (404)
+
+- Check: File uses `+server.ts` (not `+page.server.ts`)
+- Check: Route path matches `WORKOS_REDIRECT_URI` path exactly
+- Check: Exports `GET` handler (SvelteKit convention)
+
+### "locals" type errors
+
+- Check: App.Locals interface is augmented in `src/app.d.ts`
+- Check README for TypeScript setup instructions
+
+### Cookie password error
+
+- Verify `WORKOS_COOKIE_PASSWORD` is 32+ characters
+- Generate new: `openssl rand -base64 32`
+
+### Auth state not available in pages
+
+- Check: `+layout.server.ts` load function returns user data
+- Check: Pages access data via `export let data` (Svelte 4) or `$page.data` (Svelte 5)