workos 0.0.24 → 0.1.0

package/dist/src/lib/constants.js

@@ -0,0 +1,53 @@
+import { getConfig } from './settings.js';
+export var Integration;
+(function (Integration) {
+    Integration["nextjs"] = "nextjs";
+    Integration["react"] = "react";
+    Integration["tanstackStart"] = "tanstack-start";
+    Integration["reactRouter"] = "react-router";
+    Integration["vanillaJs"] = "vanilla-js";
+})(Integration || (Integration = {}));
+export function getIntegrationDescription(type) {
+    switch (type) {
+        case Integration.nextjs:
+            return 'Next.js';
+        case Integration.react:
+            return 'React (SPA)';
+        case Integration.tanstackStart:
+            return 'TanStack Start';
+        case Integration.reactRouter:
+            return 'React Router';
+        case Integration.vanillaJs:
+            return 'Vanilla JavaScript';
+        default:
+            throw new Error(`Unknown integration ${type}`);
+    }
+}
+export function getIntegrationChoices() {
+    return Object.keys(Integration).map((type) => ({
+        name: getIntegrationDescription(type),
+        value: type,
+    }));
+}
+export const IS_DEV = ['test', 'development'].includes(process.env.NODE_ENV ?? '');
+const settings = getConfig();
+export const DEBUG = settings.logging.debugMode;
+export const WORKOS_DOCS_URL = settings.documentation.workosDocsUrl;
+export const WORKOS_DASHBOARD_URL = settings.documentation.dashboardUrl;
+export const ISSUES_URL = settings.documentation.issuesUrl;
+export const ANALYTICS_ENABLED = settings.telemetry.enabled;
+export const WIZARD_INTERACTION_EVENT_NAME = settings.telemetry.eventName;
+export const WORKOS_TELEMETRY_ENABLED = process.env.WORKOS_TELEMETRY !== 'false';
+export const OAUTH_PORT = settings.legacy.oauthPort;
+/**
+ * Common glob patterns to ignore when searching for files.
+ * Used by both Next.js and React Router integrations.
+ */
+export const IGNORE_PATTERNS = [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/public/**',
+    '**/.next/**',
+];
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/lib/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,8BAAe,CAAA;IACf,+CAAgC,CAAA;IAChC,2CAA4B,CAAA;IAC5B,uCAAwB,CAAA;AAC1B,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW,CAAC,MAAM;YACrB,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,aAAa,CAAC;QACvB,KAAK,WAAW,CAAC,aAAa;YAC5B,OAAO,gBAAgB,CAAC;QAC1B,KAAK,WAAW,CAAC,WAAW;YAC1B,OAAO,cAAc,CAAC;QACxB,KAAK,WAAW,CAAC,SAAS;YACxB,OAAO,oBAAoB,CAAC;QAC9B;YACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAOD,MAAM,UAAU,qBAAqB;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC;QACrC,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC,CAAC;AACN,CAAC;AAOD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;AAEnF,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC;AAE7B,MAAM,CAAC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC;AACpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC;AACxE,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC;AAC5D,MAAM,CAAC,MAAM,6BAA6B,GAAG,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC;AAC1E,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,OAAO,CAAC;AACjF,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAa;IACvC,oBAAoB;IACpB,YAAY;IACZ,aAAa;IACb,cAAc;IACd,aAAa;CACd,CAAC","sourcesContent":["import { getConfig } from './settings.js';\n\nexport enum Integration {\n  nextjs = 'nextjs',\n  react = 'react',\n  tanstackStart = 'tanstack-start',\n  reactRouter = 'react-router',\n  vanillaJs = 'vanilla-js',\n}\n\nexport function getIntegrationDescription(type: string): string {\n  switch (type) {\n    case Integration.nextjs:\n      return 'Next.js';\n    case Integration.react:\n      return 'React (SPA)';\n    case Integration.tanstackStart:\n      return 'TanStack Start';\n    case Integration.reactRouter:\n      return 'React Router';\n    case Integration.vanillaJs:\n      return 'Vanilla JavaScript';\n    default:\n      throw new Error(`Unknown integration ${type}`);\n  }\n}\n\ntype IntegrationChoice = {\n  name: string;\n  value: string;\n};\n\nexport function getIntegrationChoices(): IntegrationChoice[] {\n  return Object.keys(Integration).map((type: string) => ({\n    name: getIntegrationDescription(type),\n    value: type,\n  }));\n}\n\nexport interface Args {\n  debug: boolean;\n  integration: Integration;\n}\n\nexport const IS_DEV = ['test', 'development'].includes(process.env.NODE_ENV ?? '');\n\nconst settings = getConfig();\n\nexport const DEBUG = settings.logging.debugMode;\nexport const WORKOS_DOCS_URL = settings.documentation.workosDocsUrl;\nexport const WORKOS_DASHBOARD_URL = settings.documentation.dashboardUrl;\nexport const ISSUES_URL = settings.documentation.issuesUrl;\nexport const ANALYTICS_ENABLED = settings.telemetry.enabled;\nexport const WIZARD_INTERACTION_EVENT_NAME = settings.telemetry.eventName;\nexport const WORKOS_TELEMETRY_ENABLED = process.env.WORKOS_TELEMETRY !== 'false';\nexport const OAUTH_PORT = settings.legacy.oauthPort;\n\n/**\n * Common glob patterns to ignore when searching for files.\n * Used by both Next.js and React Router integrations.\n */\nexport const IGNORE_PATTERNS: string[] = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/build/**',\n  '**/public/**',\n  '**/.next/**',\n];\n"]}

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

@@ -0,0 +1,19 @@
+export interface Credentials {
+    accessToken: string;
+    expiresAt: number;
+    userId: string;
+    email?: string;
+}
+export declare function getCredentialsPath(): string;
+export declare function hasCredentials(): boolean;
+export declare function getCredentials(): Credentials | null;
+export declare function saveCredentials(creds: Credentials): void;
+export declare function clearCredentials(): void;
+/**
+ * Check if token is actually expired (hard expiry check).
+ */
+export declare function isTokenExpired(creds: Credentials): boolean;
+/**
+ * Get access token if available and not expired.
+ */
+export declare function getAccessToken(): string | null;

package/dist/src/lib/credentials.js

@@ -0,0 +1,55 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+function getCredentialsDir() {
+    return path.join(os.homedir(), '.workos');
+}
+export function getCredentialsPath() {
+    return path.join(getCredentialsDir(), 'credentials.json');
+}
+export function hasCredentials() {
+    return fs.existsSync(getCredentialsPath());
+}
+export function getCredentials() {
+    if (!hasCredentials())
+        return null;
+    try {
+        const content = fs.readFileSync(getCredentialsPath(), 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+export function saveCredentials(creds) {
+    const dir = getCredentialsDir();
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    fs.writeFileSync(getCredentialsPath(), JSON.stringify(creds, null, 2), {
+        mode: 0o600,
+    });
+}
+export function clearCredentials() {
+    if (hasCredentials()) {
+        fs.unlinkSync(getCredentialsPath());
+    }
+}
+/**
+ * Check if token is actually expired (hard expiry check).
+ */
+export function isTokenExpired(creds) {
+    return Date.now() >= creds.expiresAt;
+}
+/**
+ * Get access token if available and not expired.
+ */
+export function getAccessToken() {
+    const creds = getCredentials();
+    if (!creds)
+        return null;
+    if (isTokenExpired(creds))
+        return null;
+    return creds.accessToken;
+}
+//# sourceMappingURL=credentials.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../../src/lib/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AASzB,SAAS,iBAAiB;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,kBAAkB,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,EAAE,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,cAAc,EAAE;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAkB;IAChD,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,kBAAkB,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QACrE,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,cAAc,EAAE,EAAE,CAAC;QACrB,EAAE,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAkB;IAC/C,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,SAAS,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,cAAc,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,KAAK,CAAC,WAAW,CAAC;AAC3B,CAAC","sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport os from 'node:os';\n\nexport interface Credentials {\n  accessToken: string;\n  expiresAt: number;\n  userId: string;\n  email?: string;\n}\n\nfunction getCredentialsDir(): string {\n  return path.join(os.homedir(), '.workos');\n}\n\nexport function getCredentialsPath(): string {\n  return path.join(getCredentialsDir(), 'credentials.json');\n}\n\nexport function hasCredentials(): boolean {\n  return fs.existsSync(getCredentialsPath());\n}\n\nexport function getCredentials(): Credentials | null {\n  if (!hasCredentials()) return null;\n  try {\n    const content = fs.readFileSync(getCredentialsPath(), 'utf-8');\n    return JSON.parse(content);\n  } catch {\n    return null;\n  }\n}\n\nexport function saveCredentials(creds: Credentials): void {\n  const dir = getCredentialsDir();\n  if (!fs.existsSync(dir)) {\n    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });\n  }\n  fs.writeFileSync(getCredentialsPath(), JSON.stringify(creds, null, 2), {\n    mode: 0o600,\n  });\n}\n\nexport function clearCredentials(): void {\n  if (hasCredentials()) {\n    fs.unlinkSync(getCredentialsPath());\n  }\n}\n\n/**\n * Check if token is actually expired (hard expiry check).\n */\nexport function isTokenExpired(creds: Credentials): boolean {\n  return Date.now() >= creds.expiresAt;\n}\n\n/**\n * Get access token if available and not expired.\n */\nexport function getAccessToken(): string | null {\n  const creds = getCredentials();\n  if (!creds) return null;\n  if (isTokenExpired(creds)) return null;\n  return creds.accessToken;\n}\n"]}

package/dist/src/lib/env-writer.d.ts

@@ -0,0 +1,14 @@
+interface EnvVars {
+    WORKOS_API_KEY?: string;
+    WORKOS_CLIENT_ID: string;
+    WORKOS_REDIRECT_URI?: string;
+    NEXT_PUBLIC_WORKOS_REDIRECT_URI?: string;
+    WORKOS_COOKIE_PASSWORD?: string;
+}
+/**
+ * Write environment variables to .env.local before agent runs.
+ * Merges with existing .env.local if present (new vars take precedence).
+ * Auto-generates WORKOS_COOKIE_PASSWORD if not provided.
+ */
+export declare function writeEnvLocal(installDir: string, envVars: Partial<EnvVars>): void;
+export {};

package/dist/src/lib/env-writer.js

@@ -0,0 +1,39 @@
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { parseEnvFile } from '../utils/env-parser.js';
+/**
+ * Generate a cryptographically secure cookie password.
+ * Returns 32-char hex string (16 random bytes).
+ * Uses Web Crypto API available in Node.js 20+
+ */
+function generateCookiePassword() {
+    const array = new Uint8Array(16);
+    crypto.getRandomValues(array);
+    return Array.from(array, (byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+/**
+ * Write environment variables to .env.local before agent runs.
+ * Merges with existing .env.local if present (new vars take precedence).
+ * Auto-generates WORKOS_COOKIE_PASSWORD if not provided.
+ */
+export function writeEnvLocal(installDir, envVars) {
+    const envPath = join(installDir, '.env.local');
+    // Read existing env if present
+    let existingEnv = {};
+    if (existsSync(envPath)) {
+        const content = readFileSync(envPath, 'utf-8');
+        existingEnv = parseEnvFile(content);
+    }
+    // Merge with new vars (new vars take precedence)
+    const merged = { ...existingEnv, ...envVars };
+    // Generate cookie password if not provided
+    if (!merged.WORKOS_COOKIE_PASSWORD) {
+        merged.WORKOS_COOKIE_PASSWORD = generateCookiePassword();
+    }
+    // Write back
+    const content = Object.entries(merged)
+        .map(([key, value]) => `${key}=${value}`)
+        .join('\n');
+    writeFileSync(envPath, content + '\n');
+}
+//# sourceMappingURL=env-writer.js.map

package/dist/src/lib/env-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-writer.js","sourceRoot":"","sources":["../../../src/lib/env-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAUtD;;;;GAIG;AACH,SAAS,sBAAsB;IAC7B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAClF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,OAAyB;IACzE,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAE/C,+BAA+B;IAC/B,IAAI,WAAW,GAA2B,EAAE,CAAC;IAC7C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,iDAAiD;IACjD,MAAM,MAAM,GAAG,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC;IAE9C,2CAA2C;IAC3C,IAAI,CAAC,MAAM,CAAC,sBAAsB,EAAE,CAAC;QACnC,MAAM,CAAC,sBAAsB,GAAG,sBAAsB,EAAE,CAAC;IAC3D,CAAC;IAED,aAAa;IACb,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SACnC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;SACxC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;AACzC,CAAC","sourcesContent":["import { existsSync, readFileSync, writeFileSync } from 'fs';\nimport { join } from 'path';\nimport { parseEnvFile } from '../utils/env-parser.js';\n\ninterface EnvVars {\n  WORKOS_API_KEY?: string;\n  WORKOS_CLIENT_ID: string;\n  WORKOS_REDIRECT_URI?: string;\n  NEXT_PUBLIC_WORKOS_REDIRECT_URI?: string;\n  WORKOS_COOKIE_PASSWORD?: string;\n}\n\n/**\n * Generate a cryptographically secure cookie password.\n * Returns 32-char hex string (16 random bytes).\n * Uses Web Crypto API available in Node.js 20+\n */\nfunction generateCookiePassword(): string {\n  const array = new Uint8Array(16);\n  crypto.getRandomValues(array);\n  return Array.from(array, (byte) => byte.toString(16).padStart(2, '0')).join('');\n}\n\n/**\n * Write environment variables to .env.local before agent runs.\n * Merges with existing .env.local if present (new vars take precedence).\n * Auto-generates WORKOS_COOKIE_PASSWORD if not provided.\n */\nexport function writeEnvLocal(installDir: string, envVars: Partial<EnvVars>): void {\n  const envPath = join(installDir, '.env.local');\n\n  // Read existing env if present\n  let existingEnv: Record<string, string> = {};\n  if (existsSync(envPath)) {\n    const content = readFileSync(envPath, 'utf-8');\n    existingEnv = parseEnvFile(content);\n  }\n\n  // Merge with new vars (new vars take precedence)\n  const merged = { ...existingEnv, ...envVars };\n\n  // Generate cookie password if not provided\n  if (!merged.WORKOS_COOKIE_PASSWORD) {\n    merged.WORKOS_COOKIE_PASSWORD = generateCookiePassword();\n  }\n\n  // Write back\n  const content = Object.entries(merged)\n    .map(([key, value]) => `${key}=${value}`)\n    .join('\\n');\n\n  writeFileSync(envPath, content + '\\n');\n}\n"]}

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

@@ -0,0 +1,114 @@
+import { EventEmitter } from 'events';
+export interface WizardEvents {
+    status: {
+        message: string;
+    };
+    output: {
+        text: string;
+        isError?: boolean;
+    };
+    'file:write': {
+        path: string;
+        content: string;
+    };
+    'file:edit': {
+        path: string;
+        oldContent: string;
+        newContent: string;
+    };
+    'prompt:request': {
+        id: string;
+        message: string;
+        options?: string[];
+    };
+    'prompt:response': {
+        id: string;
+        value: string;
+    };
+    'confirm:request': {
+        id: string;
+        message: string;
+        warning?: string;
+        files?: string[];
+    };
+    'confirm:response': {
+        id: string;
+        confirmed: boolean;
+    };
+    'credentials:request': {
+        requiresApiKey: boolean;
+    };
+    'credentials:response': {
+        apiKey: string;
+        clientId: string;
+    };
+    complete: {
+        success: boolean;
+        summary?: string;
+    };
+    error: {
+        message: string;
+        stack?: string;
+    };
+    'state:enter': {
+        state: string;
+    };
+    'state:exit': {
+        state: string;
+    };
+    'auth:checking': Record<string, never>;
+    'auth:required': Record<string, never>;
+    'auth:success': Record<string, never>;
+    'auth:failure': {
+        message: string;
+    };
+    'detection:start': Record<string, never>;
+    'detection:complete': {
+        integration: string;
+    };
+    'detection:none': Record<string, never>;
+    'git:checking': Record<string, never>;
+    'git:clean': Record<string, never>;
+    'git:dirty': {
+        files: string[];
+    };
+    'git:dirty:confirmed': Record<string, never>;
+    'git:dirty:cancelled': Record<string, never>;
+    'credentials:gathering': {
+        requiresApiKey: boolean;
+    };
+    'credentials:found': Record<string, never>;
+    'config:start': Record<string, never>;
+    'config:complete': Record<string, never>;
+    'agent:start': Record<string, never>;
+    'agent:progress': {
+        step: string;
+        detail?: string;
+    };
+    'agent:success': {
+        summary?: string;
+    };
+    'agent:failure': {
+        message: string;
+        stack?: string;
+    };
+    'validation:start': {
+        framework: string;
+    };
+    'validation:issues': {
+        issues: import('./validation/types.js').ValidationIssue[];
+    };
+    'validation:complete': {
+        passed: boolean;
+        issueCount: number;
+        durationMs: number;
+    };
+}
+export type WizardEventName = keyof WizardEvents;
+export declare class WizardEventEmitter extends EventEmitter {
+    emit<K extends WizardEventName>(event: K, payload: WizardEvents[K]): boolean;
+    on<K extends WizardEventName>(event: K, listener: (payload: WizardEvents[K]) => void): this;
+    off<K extends WizardEventName>(event: K, listener: (payload: WizardEvents[K]) => void): this;
+    once<K extends WizardEventName>(event: K, listener: (payload: WizardEvents[K]) => void): this;
+}
+export declare function createWizardEventEmitter(): WizardEventEmitter;

package/dist/src/lib/events.js

@@ -0,0 +1,19 @@
+import { EventEmitter } from 'events';
+export class WizardEventEmitter extends EventEmitter {
+    emit(event, payload) {
+        return super.emit(event, payload);
+    }
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+}
+export function createWizardEventEmitter() {
+    return new WizardEventEmitter();
+}
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/lib/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AA8CtC,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,IAAI,CAA4B,KAAQ,EAAE,OAAwB;QAChE,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,EAAE,CAA4B,KAAQ,EAAE,QAA4C;QAClF,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAA4B,KAAQ,EAAE,QAA4C;QACnF,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAA4B,KAAQ,EAAE,QAA4C;QACpF,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,kBAAkB,EAAE,CAAC;AAClC,CAAC","sourcesContent":["import { EventEmitter } from 'events';\n\nexport interface WizardEvents {\n  status: { message: string };\n  output: { text: string; isError?: boolean };\n  'file:write': { path: string; content: string };\n  'file:edit': { path: string; oldContent: string; newContent: string };\n  'prompt:request': { id: string; message: string; options?: string[] };\n  'prompt:response': { id: string; value: string };\n  'confirm:request': { id: string; message: string; warning?: string; files?: string[] };\n  'confirm:response': { id: string; confirmed: boolean };\n  'credentials:request': { requiresApiKey: boolean };\n  'credentials:response': { apiKey: string; clientId: string };\n  complete: { success: boolean; summary?: string };\n  error: { message: string; stack?: string };\n\n  'state:enter': { state: string };\n  'state:exit': { state: string };\n  'auth:checking': Record<string, never>;\n  'auth:required': Record<string, never>;\n  'auth:success': Record<string, never>;\n  'auth:failure': { message: string };\n  'detection:start': Record<string, never>;\n  'detection:complete': { integration: string };\n  'detection:none': Record<string, never>;\n  'git:checking': Record<string, never>;\n  'git:clean': Record<string, never>;\n  'git:dirty': { files: string[] };\n  'git:dirty:confirmed': Record<string, never>;\n  'git:dirty:cancelled': Record<string, never>;\n  'credentials:gathering': { requiresApiKey: boolean };\n  'credentials:found': Record<string, never>;\n  'config:start': Record<string, never>;\n  'config:complete': Record<string, never>;\n  'agent:start': Record<string, never>;\n  'agent:progress': { step: string; detail?: string };\n  'agent:success': { summary?: string };\n  'agent:failure': { message: string; stack?: string };\n\n  'validation:start': { framework: string };\n  'validation:issues': { issues: import('./validation/types.js').ValidationIssue[] };\n  'validation:complete': { passed: boolean; issueCount: number; durationMs: number };\n}\n\nexport type WizardEventName = keyof WizardEvents;\n\nexport class WizardEventEmitter extends EventEmitter {\n  emit<K extends WizardEventName>(event: K, payload: WizardEvents[K]): boolean {\n    return super.emit(event, payload);\n  }\n\n  on<K extends WizardEventName>(event: K, listener: (payload: WizardEvents[K]) => void): this {\n    return super.on(event, listener);\n  }\n\n  off<K extends WizardEventName>(event: K, listener: (payload: WizardEvents[K]) => void): this {\n    return super.off(event, listener);\n  }\n\n  once<K extends WizardEventName>(event: K, listener: (payload: WizardEvents[K]) => void): this {\n    return super.once(event, listener);\n  }\n}\n\nexport function createWizardEventEmitter(): WizardEventEmitter {\n  return new WizardEventEmitter();\n}\n"]}

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

@@ -0,0 +1,108 @@
+import type { Integration } from './constants.js';
+import type { WizardOptions } from '../utils/types.js';
+/**
+ * Configuration interface for framework-specific agent integrations.
+ * Each framework exports a FrameworkConfig that the universal runner uses.
+ */
+export interface FrameworkConfig {
+    metadata: FrameworkMetadata;
+    detection: FrameworkDetection;
+    environment: EnvironmentConfig;
+    analytics: AnalyticsConfig;
+    prompts: PromptConfig;
+    ui: UIConfig;
+}
+/**
+ * Basic framework information and documentation
+ */
+export interface FrameworkMetadata {
+    /** Display name (e.g., "Next.js", "React") */
+    name: string;
+    /** Integration type from constants */
+    integration: Integration;
+    /** URL to framework-specific WorkOS AuthKit docs */
+    docsUrl: string;
+    /**
+     * Optional URL to docs for users with unsupported framework versions.
+     * If not provided, defaults to docsUrl.
+     */
+    unsupportedVersionDocsUrl?: string;
+    /**
+     * Optional function to gather framework-specific context before agent runs.
+     * For Next.js: detects router type
+     * For React Native: detects Expo vs bare
+     */
+    gatherContext?: (options: WizardOptions) => Promise<Record<string, any>>;
+    /**
+     * Name of the framework-specific skill for agent integration.
+     * Skills are located in .claude/skills/{skillName}/SKILL.md
+     * Will be populated per-framework in Phase 3.
+     */
+    skillName?: string;
+}
+/**
+ * Framework detection and version handling
+ */
+export interface FrameworkDetection {
+    /** Package name to check in package.json (e.g., "next", "react") */
+    packageName: string;
+    /** Human-readable name for error messages (e.g., "Next.js") */
+    packageDisplayName: string;
+    /** Extract version from package.json */
+    getVersion: (packageJson: any) => string | undefined;
+    /** Optional: Convert version to analytics bucket (e.g., "15.x") */
+    getVersionBucket?: (version: string) => string;
+}
+/**
+ * Environment variable configuration
+ */
+export interface EnvironmentConfig {
+    /** Whether to upload env vars to hosting providers post-agent */
+    uploadToHosting: boolean;
+    /** Whether this framework requires API key (false for client-only SDKs) */
+    requiresApiKey: boolean;
+    /**
+     * Build the environment variables object for this framework.
+     * Returns the exact variable names and values to upload to hosting providers.
+     */
+    getEnvVars: (apiKey: string, clientId: string) => Record<string, string>;
+}
+/**
+ * Analytics configuration
+ */
+export interface AnalyticsConfig {
+    /** Generate tags from context (e.g., { 'nextjs-version': '15.x', 'router': 'app' }) */
+    getTags: (context: any) => Record<string, any>;
+    /** Optional: Additional event properties */
+    getEventProperties?: (context: any) => Record<string, any>;
+}
+/**
+ * Prompt configuration
+ */
+export interface PromptConfig {
+    /**
+     * Optional: Additional context lines to append to base prompt
+     * For Next.js: "- Router: app"
+     * For React Native: "- Platform: Expo"
+     */
+    getAdditionalContextLines?: (context: any) => string[];
+}
+/**
+ * UI messaging configuration
+ */
+export interface UIConfig {
+    /** Success message when agent completes */
+    successMessage: string;
+    /** Generate "What the agent did" bullets from context */
+    getOutroChanges: (context: any) => string[];
+    /** Generate "Next steps" bullets from context */
+    getOutroNextSteps: (context: any) => string[];
+}
+/**
+ * Generate welcome message from framework name
+ */
+export declare function getWelcomeMessage(frameworkName: string): string;
+/**
+ * Shared spinner message for all frameworks
+ */
+export declare const SPINNER_MESSAGE = "Setting up WorkOS AuthKit with login, authentication, and session management...";

package/dist/src/lib/framework-config.js

@@ -0,0 +1,11 @@
+/**
+ * Generate welcome message from framework name
+ */
+export function getWelcomeMessage(frameworkName) {
+    return `WorkOS AuthKit ${frameworkName} wizard (agent-powered)`;
+}
+/**
+ * Shared spinner message for all frameworks
+ */
+export const SPINNER_MESSAGE = 'Setting up WorkOS AuthKit with login, authentication, and session management...';
+//# sourceMappingURL=framework-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"framework-config.js","sourceRoot":"","sources":["../../../src/lib/framework-config.ts"],"names":[],"mappings":"AAyHA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,aAAqB;IACrD,OAAO,kBAAkB,aAAa,yBAAyB,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,iFAAiF,CAAC","sourcesContent":["import type { Integration } from './constants.js';\nimport type { WizardOptions } from '../utils/types.js';\n\n/**\n * Configuration interface for framework-specific agent integrations.\n * Each framework exports a FrameworkConfig that the universal runner uses.\n */\nexport interface FrameworkConfig {\n  metadata: FrameworkMetadata;\n  detection: FrameworkDetection;\n  environment: EnvironmentConfig;\n  analytics: AnalyticsConfig;\n  prompts: PromptConfig;\n  ui: UIConfig;\n}\n\n/**\n * Basic framework information and documentation\n */\nexport interface FrameworkMetadata {\n  /** Display name (e.g., \"Next.js\", \"React\") */\n  name: string;\n\n  /** Integration type from constants */\n  integration: Integration;\n\n  /** URL to framework-specific WorkOS AuthKit docs */\n  docsUrl: string;\n\n  /**\n   * Optional URL to docs for users with unsupported framework versions.\n   * If not provided, defaults to docsUrl.\n   */\n  unsupportedVersionDocsUrl?: string;\n\n  /**\n   * Optional function to gather framework-specific context before agent runs.\n   * For Next.js: detects router type\n   * For React Native: detects Expo vs bare\n   */\n  gatherContext?: (options: WizardOptions) => Promise<Record<string, any>>;\n\n  /**\n   * Name of the framework-specific skill for agent integration.\n   * Skills are located in .claude/skills/{skillName}/SKILL.md\n   * Will be populated per-framework in Phase 3.\n   */\n  skillName?: string;\n}\n\n/**\n * Framework detection and version handling\n */\nexport interface FrameworkDetection {\n  /** Package name to check in package.json (e.g., \"next\", \"react\") */\n  packageName: string;\n\n  /** Human-readable name for error messages (e.g., \"Next.js\") */\n  packageDisplayName: string;\n\n  /** Extract version from package.json */\n  getVersion: (packageJson: any) => string | undefined;\n\n  /** Optional: Convert version to analytics bucket (e.g., \"15.x\") */\n  getVersionBucket?: (version: string) => string;\n}\n\n/**\n * Environment variable configuration\n */\nexport interface EnvironmentConfig {\n  /** Whether to upload env vars to hosting providers post-agent */\n  uploadToHosting: boolean;\n\n  /** Whether this framework requires API key (false for client-only SDKs) */\n  requiresApiKey: boolean;\n\n  /**\n   * Build the environment variables object for this framework.\n   * Returns the exact variable names and values to upload to hosting providers.\n   */\n  getEnvVars: (apiKey: string, clientId: string) => Record<string, string>;\n}\n\n/**\n * Analytics configuration\n */\nexport interface AnalyticsConfig {\n  /** Generate tags from context (e.g., { 'nextjs-version': '15.x', 'router': 'app' }) */\n  getTags: (context: any) => Record<string, any>;\n\n  /** Optional: Additional event properties */\n  getEventProperties?: (context: any) => Record<string, any>;\n}\n\n/**\n * Prompt configuration\n */\nexport interface PromptConfig {\n  /**\n   * Optional: Additional context lines to append to base prompt\n   * For Next.js: \"- Router: app\"\n   * For React Native: \"- Platform: Expo\"\n   */\n  getAdditionalContextLines?: (context: any) => string[];\n}\n\n/**\n * UI messaging configuration\n */\nexport interface UIConfig {\n  /** Success message when agent completes */\n  successMessage: string;\n\n  /** Generate \"What the agent did\" bullets from context */\n  getOutroChanges: (context: any) => string[];\n\n  /** Generate \"Next steps\" bullets from context */\n  getOutroNextSteps: (context: any) => string[];\n}\n\n/**\n * Generate welcome message from framework name\n */\nexport function getWelcomeMessage(frameworkName: string): string {\n  return `WorkOS AuthKit ${frameworkName} wizard (agent-powered)`;\n}\n\n/**\n * Shared spinner message for all frameworks\n */\nexport const SPINNER_MESSAGE = 'Setting up WorkOS AuthKit with login, authentication, and session management...';\n"]}

package/dist/src/lib/helper-functions.d.ts

@@ -0,0 +1 @@
+export declare const sleep: (ms: number) => Promise<unknown>;

package/dist/src/lib/helper-functions.js

@@ -0,0 +1,2 @@
+export const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+//# sourceMappingURL=helper-functions.js.map

package/dist/src/lib/helper-functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-functions.js","sourceRoot":"","sources":["../../../src/lib/helper-functions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC","sourcesContent":["export const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));\n"]}

package/dist/src/lib/port-detection.d.ts

@@ -0,0 +1,7 @@
+import type { Integration } from './constants.js';
+export declare function getCallbackPath(integration: Integration): string;
+/**
+ * Detect the dev server port for a framework.
+ * Checks config files first, falls back to framework default.
+ */
+export declare function detectPort(integration: Integration, installDir: string): number;

package/dist/src/lib/port-detection.js

@@ -0,0 +1,112 @@
+import * as fs from 'node:fs';
+import { join } from 'node:path';
+import { getConfig } from './settings.js';
+const settings = getConfig();
+const INTEGRATION_TO_SETTINGS_KEY = {
+    nextjs: 'nextjs',
+    react: 'react',
+    'tanstack-start': 'tanstackStart',
+    'react-router': 'reactRouter',
+    'vanilla-js': 'vanillaJs',
+};
+function getDefaultPort(integration) {
+    const settingsKey = INTEGRATION_TO_SETTINGS_KEY[integration];
+    return settings.frameworks[settingsKey].port;
+}
+export function getCallbackPath(integration) {
+    const settingsKey = INTEGRATION_TO_SETTINGS_KEY[integration];
+    return settings.frameworks[settingsKey].callbackPath;
+}
+/**
+ * Parse port from Vite config file.
+ * Looks for server.port in vite.config.{ts,js,mjs}
+ */
+function parseViteConfigPort(configPath) {
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        // Match: port: 3000 or port: "3000" or port: '3000'
+        const portMatch = content.match(/port\s*:\s*['"]?(\d+)['"]?/);
+        if (portMatch) {
+            return parseInt(portMatch[1], 10);
+        }
+    }
+    catch {
+        // File doesn't exist or can't be read
+    }
+    return null;
+}
+/**
+ * Parse port from Next.js package.json scripts.
+ * Next.js uses: "dev": "next dev -p 4000" or --port 4000
+ */
+function parseNextConfigPort(installDir) {
+    try {
+        const packageJsonPath = join(installDir, 'package.json');
+        const content = fs.readFileSync(packageJsonPath, 'utf-8');
+        const packageJson = JSON.parse(content);
+        const devScript = packageJson.scripts?.dev || '';
+        // Match: -p 4000, --port 4000, --port=4000
+        const portMatch = devScript.match(/-p\s+(\d+)|--port[=\s]+(\d+)/);
+        if (portMatch) {
+            return parseInt(portMatch[1] || portMatch[2], 10);
+        }
+    }
+    catch {
+        // Can't read package.json
+    }
+    return null;
+}
+/**
+ * Parse port from TanStack Start app.config.ts.
+ * Uses Vinxi: server: { port: N }
+ */
+function parseTanStackPort(installDir) {
+    const configPaths = [join(installDir, 'app.config.ts'), join(installDir, 'app.config.js')];
+    for (const configPath of configPaths) {
+        try {
+            const content = fs.readFileSync(configPath, 'utf-8');
+            // Match server config with port
+            const portMatch = content.match(/server\s*:\s*\{[^}]*port\s*:\s*(\d+)/);
+            if (portMatch) {
+                return parseInt(portMatch[1], 10);
+            }
+        }
+        catch {
+            // Config file doesn't exist
+        }
+    }
+    return null;
+}
+/**
+ * Detect the dev server port for a framework.
+ * Checks config files first, falls back to framework default.
+ */
+export function detectPort(integration, installDir) {
+    let detectedPort = null;
+    switch (integration) {
+        case 'nextjs':
+            detectedPort = parseNextConfigPort(installDir);
+            break;
+        case 'tanstack-start':
+            detectedPort = parseTanStackPort(installDir);
+            break;
+        case 'react':
+        case 'react-router':
+        case 'vanilla-js': {
+            // Vite-based frameworks
+            const viteConfigs = [
+                join(installDir, 'vite.config.ts'),
+                join(installDir, 'vite.config.js'),
+                join(installDir, 'vite.config.mjs'),
+            ];
+            for (const configPath of viteConfigs) {
+                detectedPort = parseViteConfigPort(configPath);
+                if (detectedPort)
+                    break;
+            }
+            break;
+        }
+    }
+    return detectedPort ?? getDefaultPort(integration);
+}
+//# sourceMappingURL=port-detection.js.map

package/dist/src/lib/port-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-detection.js","sourceRoot":"","sources":["../../../src/lib/port-detection.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'node:fs';\nimport { join } from 'node:path';\nimport type { Integration } from './constants.js';\nimport { getConfig } from './settings.js';\n\nconst settings = getConfig();\n\nconst INTEGRATION_TO_SETTINGS_KEY: Record<Integration, string> = {\n  nextjs: 'nextjs',\n  react: 'react',\n  'tanstack-start': 'tanstackStart',\n  'react-router': 'reactRouter',\n  'vanilla-js': 'vanillaJs',\n};\n\nfunction getDefaultPort(integration: Integration): number {\n  const settingsKey = INTEGRATION_TO_SETTINGS_KEY[integration];\n  return settings.frameworks[settingsKey].port;\n}\n\nexport function getCallbackPath(integration: Integration): string {\n  const settingsKey = INTEGRATION_TO_SETTINGS_KEY[integration];\n  return settings.frameworks[settingsKey].callbackPath;\n}\n\n/**\n * Parse port from Vite config file.\n * Looks for server.port in vite.config.{ts,js,mjs}\n */\nfunction parseViteConfigPort(configPath: string): number | null {\n  try {\n    const content = fs.readFileSync(configPath, 'utf-8');\n    // Match: port: 3000 or port: \"3000\" or port: '3000'\n    const portMatch = content.match(/port\\s*:\\s*['\"]?(\\d+)['\"]?/);\n    if (portMatch) {\n      return parseInt(portMatch[1], 10);\n    }\n  } catch {\n    // File doesn't exist or can't be read\n  }\n  return null;\n}\n\n/**\n * Parse port from Next.js package.json scripts.\n * Next.js uses: \"dev\": \"next dev -p 4000\" or --port 4000\n */\nfunction parseNextConfigPort(installDir: string): number | null {\n  try {\n    const packageJsonPath = join(installDir, 'package.json');\n    const content = fs.readFileSync(packageJsonPath, 'utf-8');\n    const packageJson = JSON.parse(content);\n\n    const devScript = packageJson.scripts?.dev || '';\n    // Match: -p 4000, --port 4000, --port=4000\n    const portMatch = devScript.match(/-p\\s+(\\d+)|--port[=\\s]+(\\d+)/);\n    if (portMatch) {\n      return parseInt(portMatch[1] || portMatch[2], 10);\n    }\n  } catch {\n    // Can't read package.json\n  }\n  return null;\n}\n\n/**\n * Parse port from TanStack Start app.config.ts.\n * Uses Vinxi: server: { port: N }\n */\nfunction parseTanStackPort(installDir: string): number | null {\n  const configPaths = [join(installDir, 'app.config.ts'), join(installDir, 'app.config.js')];\n\n  for (const configPath of configPaths) {\n    try {\n      const content = fs.readFileSync(configPath, 'utf-8');\n      // Match server config with port\n      const portMatch = content.match(/server\\s*:\\s*\\{[^}]*port\\s*:\\s*(\\d+)/);\n      if (portMatch) {\n        return parseInt(portMatch[1], 10);\n      }\n    } catch {\n      // Config file doesn't exist\n    }\n  }\n  return null;\n}\n\n/**\n * Detect the dev server port for a framework.\n * Checks config files first, falls back to framework default.\n */\nexport function detectPort(integration: Integration, installDir: string): number {\n  let detectedPort: number | null = null;\n\n  switch (integration) {\n    case 'nextjs':\n      detectedPort = parseNextConfigPort(installDir);\n      break;\n\n    case 'tanstack-start':\n      detectedPort = parseTanStackPort(installDir);\n      break;\n\n    case 'react':\n    case 'react-router':\n    case 'vanilla-js': {\n      // Vite-based frameworks\n      const viteConfigs = [\n        join(installDir, 'vite.config.ts'),\n        join(installDir, 'vite.config.js'),\n        join(installDir, 'vite.config.mjs'),\n      ];\n      for (const configPath of viteConfigs) {\n        detectedPort = parseViteConfigPort(configPath);\n        if (detectedPort) break;\n      }\n      break;\n    }\n  }\n\n  return detectedPort ?? getDefaultPort(integration);\n}\n"]}