workos 0.0.24 → 0.1.0

package/dist/src/utils/clack-utils.js

@@ -0,0 +1,397 @@
+import * as childProcess from 'node:child_process';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import { join } from 'node:path';
+import chalk from 'chalk';
+import { traceStep } from '../telemetry.js';
+import { debug } from './debug.js';
+import { parseEnvFile } from './env-parser.js';
+import { hasPackageInstalled } from './package-json.js';
+import { detectAllPackageManagers, packageManagers, NPM as npm } from './package-manager.js';
+import { fulfillsVersionRange } from './semver.js';
+import { getPackageVersion } from './package-json.js';
+import { ISSUES_URL } from '../lib/constants.js';
+import { analytics } from './analytics.js';
+import clack from './clack.js';
+import { INTEGRATION_CONFIG } from '../lib/config.js';
+export async function abort(message, status) {
+    await analytics.shutdown('cancelled');
+    clack.outro(message ?? 'Wizard setup cancelled.');
+    return process.exit(status ?? 1);
+}
+export async function abortIfCancelled(input, integration) {
+    await analytics.shutdown('cancelled');
+    const resolvedInput = await input;
+    if (clack.isCancel(resolvedInput) ||
+        (typeof resolvedInput === 'symbol' && resolvedInput.description === 'clack:cancel')) {
+        const docsUrl = integration ? INTEGRATION_CONFIG[integration].docsUrl : 'https://workos.com/docs/user-management';
+        clack.cancel(`Wizard setup cancelled. You can read the documentation for ${integration ?? 'WorkOS AuthKit'} at ${chalk.cyan(docsUrl)} to continue with the setup manually.`);
+        process.exit(0);
+    }
+    else {
+        return input;
+    }
+}
+export function printWelcome(options) {
+    // eslint-disable-next-line no-console
+    console.log('');
+    clack.intro(chalk.inverse(` ${options.wizardName} `));
+    const welcomeText = options.message ||
+        `The ${options.wizardName} will help you set up WorkOS AuthKit for your application.\nThank you for using WorkOS AuthKit :)`;
+    clack.note(welcomeText);
+}
+export async function confirmContinueIfNoOrDirtyGitRepo(options) {
+    return traceStep('check-git-status', async () => {
+        if (!isInGitRepo()) {
+            // CI mode: auto-continue without git
+            const continueWithoutGit = options.ci
+                ? true
+                : await abortIfCancelled(clack.confirm({
+                    message: 'You are not inside a git repository. The wizard will create and update files. Do you want to continue anyway?',
+                }));
+            analytics.setTag('continue-without-git', continueWithoutGit);
+            if (!continueWithoutGit) {
+                await abort(undefined, 0);
+            }
+            // return early to avoid checking for uncommitted files
+            return;
+        }
+        const uncommittedOrUntrackedFiles = getUncommittedOrUntrackedFiles();
+        if (uncommittedOrUntrackedFiles.length) {
+            // CI mode: auto-continue with dirty repo
+            if (options.ci) {
+                clack.log.info(`CI mode: continuing with uncommitted/untracked files in repo`);
+                analytics.setTag('continue-with-dirty-repo', true);
+                return;
+            }
+            clack.log.warn(`You have uncommitted or untracked files in your repo:
+
+${uncommittedOrUntrackedFiles.join('\n')}
+
+The wizard will create and update files.`);
+            const continueWithDirtyRepo = await abortIfCancelled(clack.confirm({
+                message: 'Do you want to continue anyway?',
+            }));
+            analytics.setTag('continue-with-dirty-repo', continueWithDirtyRepo);
+            if (!continueWithDirtyRepo) {
+                await abort(undefined, 0);
+            }
+        }
+    });
+}
+export function isInGitRepo() {
+    try {
+        childProcess.execSync('git rev-parse --is-inside-work-tree', {
+            stdio: 'ignore',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function getUncommittedOrUntrackedFiles() {
+    try {
+        const gitStatus = childProcess
+            .execSync('git status --porcelain=v1', {
+            // we only care about stdout
+            stdio: ['ignore', 'pipe', 'ignore'],
+        })
+            .toString();
+        const files = gitStatus
+            .split(os.EOL)
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .map((f) => `- ${f.split(/\s+/)[1]}`);
+        return files;
+    }
+    catch {
+        return [];
+    }
+}
+export async function askForItemSelection(items, message) {
+    const selection = await abortIfCancelled(clack.select({
+        maxItems: 12,
+        message: message,
+        options: items.map((item, index) => {
+            return {
+                value: { value: item, index: index },
+                label: item,
+            };
+        }),
+    }));
+    return selection;
+}
+export async function confirmContinueIfPackageVersionNotSupported({ packageId, packageName, packageVersion, acceptableVersions, note, }) {
+    return traceStep(`check-package-version`, async () => {
+        analytics.setTag(`${packageName.toLowerCase()}-version`, packageVersion);
+        const isSupportedVersion = fulfillsVersionRange({
+            acceptableVersions,
+            version: packageVersion,
+            canBeLatest: true,
+        });
+        if (isSupportedVersion) {
+            analytics.setTag(`${packageName.toLowerCase()}-supported`, true);
+            return;
+        }
+        clack.log.warn(`You have an unsupported version of ${packageName} installed:
+
+  ${packageId}@${packageVersion}`);
+        clack.note(note ?? `Please upgrade to ${acceptableVersions} if you wish to use the WorkOS AuthKit wizard.`);
+        const continueWithUnsupportedVersion = await abortIfCancelled(clack.confirm({
+            message: 'Do you want to continue anyway?',
+        }));
+        analytics.setTag(`${packageName.toLowerCase()}-continue-with-unsupported-version`, continueWithUnsupportedVersion);
+        if (!continueWithUnsupportedVersion) {
+            await abort(undefined, 0);
+        }
+    });
+}
+export async function isReact19Installed({ installDir }) {
+    try {
+        const packageJson = await getPackageDotJson({ installDir });
+        const reactVersion = getPackageVersion('react', packageJson);
+        if (!reactVersion) {
+            return false;
+        }
+        return fulfillsVersionRange({
+            version: reactVersion,
+            acceptableVersions: '>=19.0.0',
+            canBeLatest: true,
+        });
+    }
+    catch (error) {
+        return false;
+    }
+}
+/**
+ * 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 async function installPackage({ packageName, alreadyInstalled, askBeforeUpdating = true, packageNameDisplayLabel, packageManager, forceInstall = false, integration, installDir, }) {
+    return traceStep('install-package', async () => {
+        if (alreadyInstalled && askBeforeUpdating) {
+            const shouldUpdatePackage = await abortIfCancelled(clack.confirm({
+                message: `The ${chalk.bold.cyan(packageNameDisplayLabel ?? packageName)} package is already installed. Do you want to update it to the latest version?`,
+            }));
+            if (!shouldUpdatePackage) {
+                return {};
+            }
+        }
+        const sdkInstallSpinner = clack.spinner();
+        const pkgManager = packageManager || (await getPackageManager({ installDir }));
+        // Most packages aren't compatible with React 19 yet, skip strict peer dependency checks if needed.
+        const isReact19 = await isReact19Installed({ installDir });
+        const legacyPeerDepsFlag = isReact19 && pkgManager.name === 'npm' ? '--legacy-peer-deps' : '';
+        sdkInstallSpinner.start(`${alreadyInstalled ? 'Updating' : 'Installing'} ${chalk.bold.cyan(packageNameDisplayLabel ?? packageName)} with ${chalk.bold(pkgManager.label)}.`);
+        try {
+            await new Promise((resolve, reject) => {
+                childProcess.exec(`${pkgManager.installCommand} ${packageName} ${pkgManager.flags} ${forceInstall ? pkgManager.forceInstallFlag : ''} ${legacyPeerDepsFlag}`.trim(), { cwd: installDir }, (err, stdout, stderr) => {
+                    if (err) {
+                        // Write a log file so we can better troubleshoot issues
+                        fs.writeFileSync(join(process.cwd(), `workos-installation-error-${Date.now()}.log`), JSON.stringify({
+                            stdout,
+                            stderr,
+                        }), { encoding: 'utf8' });
+                        reject(err);
+                    }
+                    else {
+                        resolve();
+                    }
+                });
+            });
+        }
+        catch (e) {
+            sdkInstallSpinner.stop('Installation failed.');
+            clack.log.error(`${chalk.red('Encountered the following error during installation:')}\n\n${e}\n\n${chalk.dim(`The wizard has created an \`workos-installation-error-*.log\` file. If you think this issue is caused by the WorkOS AuthKit wizard, create an issue on GitHub and include the log file's content:\n${ISSUES_URL}`)}`);
+            await abort();
+        }
+        sdkInstallSpinner.stop(`${alreadyInstalled ? 'Updated' : 'Installed'} ${chalk.bold.cyan(packageNameDisplayLabel ?? packageName)} with ${chalk.bold(pkgManager.label)}.`);
+        analytics.capture('wizard interaction', {
+            action: 'package installed',
+            package_name: packageName,
+            package_manager: pkgManager.name,
+            integration,
+        });
+        return { packageManager: pkgManager };
+    });
+}
+/**
+ * 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 async function ensurePackageIsInstalled(packageJson, packageId, packageName, options) {
+    return traceStep('ensure-package-installed', async () => {
+        const installed = hasPackageInstalled(packageId, packageJson);
+        analytics.setTag(`${packageName.toLowerCase()}-installed`, installed);
+        if (!installed) {
+            // In dashboard mode, auto-continue (integration was already detected)
+            if (options?.dashboard) {
+                return;
+            }
+            const continueWithoutPackage = await abortIfCancelled(clack.confirm({
+                message: `${packageName} does not seem to be installed. Do you still want to continue?`,
+                initialValue: false,
+            }));
+            if (!continueWithoutPackage) {
+                await abort(undefined, 0);
+            }
+        }
+    });
+}
+export async function getPackageDotJson({ installDir }) {
+    const packageJsonFileContents = await fs.promises.readFile(join(installDir, 'package.json'), 'utf8').catch(() => {
+        clack.log.error('Could not find package.json. Make sure to run the wizard in the root of your app!');
+        return abort();
+    });
+    let packageJson = undefined;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        packageJson = JSON.parse(packageJsonFileContents);
+    }
+    catch {
+        clack.log.error(`Unable to parse your ${chalk.cyan('package.json')}. Make sure it has a valid format!`);
+        await abort();
+    }
+    return packageJson || {};
+}
+export async function updatePackageDotJson(packageDotJson, { installDir }) {
+    try {
+        await fs.promises.writeFile(join(installDir, 'package.json'), 
+        // TODO: maybe figure out the original indentation
+        JSON.stringify(packageDotJson, null, 2), {
+            encoding: 'utf8',
+            flag: 'w',
+        });
+    }
+    catch {
+        clack.log.error(`Unable to update your ${chalk.cyan('package.json')}.`);
+        await abort();
+    }
+}
+export async function getPackageManager(options) {
+    const detectedPackageManagers = detectAllPackageManagers({
+        installDir: options.installDir,
+    });
+    // If exactly one package manager detected, use it automatically
+    if (detectedPackageManagers.length === 1) {
+        const detectedPackageManager = detectedPackageManagers[0];
+        analytics.setTag('package-manager', detectedPackageManager.name);
+        return detectedPackageManager;
+    }
+    // CI mode: auto-select first detected or npm
+    if (options.ci) {
+        const selectedPackageManager = detectedPackageManagers.length > 0 ? detectedPackageManagers[0] : npm;
+        clack.log.info(`CI mode: auto-selected package manager: ${selectedPackageManager.label}`);
+        analytics.setTag('package-manager', selectedPackageManager.name);
+        return selectedPackageManager;
+    }
+    // If multiple or no package managers detected, prompt user to select
+    const pkgOptions = detectedPackageManagers.length > 0 ? detectedPackageManagers : packageManagers;
+    const message = detectedPackageManagers.length > 1
+        ? 'Multiple package managers detected. Please select one:'
+        : 'Please select your package manager.';
+    const selectedPackageManager = await abortIfCancelled(clack.select({
+        message,
+        options: pkgOptions.map((packageManager) => ({
+            value: packageManager,
+            label: packageManager.label,
+        })),
+    }));
+    analytics.setTag('package-manager', selectedPackageManager.name);
+    return selectedPackageManager;
+}
+export function isUsingTypeScript({ installDir }) {
+    try {
+        return fs.existsSync(join(installDir, 'tsconfig.json'));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 async function getOrAskForWorkOSCredentials(_options, requireApiKey = true) {
+    let apiKey = _options.apiKey;
+    let clientId = _options.clientId;
+    // If credentials provided via CLI (e.g., CI mode or dashboard mode), use them
+    if ((!requireApiKey || apiKey) && clientId) {
+        // Only log in non-dashboard mode
+        if (!_options.dashboard) {
+            clack.log.info('Using provided WorkOS credentials');
+        }
+        return { apiKey: apiKey || '', clientId };
+    }
+    // Check if credentials already exist in .env.local
+    const envPath = join(_options.installDir, '.env.local');
+    if (fs.existsSync(envPath)) {
+        try {
+            const envContent = fs.readFileSync(envPath, 'utf-8');
+            const envVars = parseEnvFile(envContent);
+            const existingApiKey = envVars.WORKOS_API_KEY;
+            const existingClientId = envVars.WORKOS_CLIENT_ID;
+            // Use existing credentials if both are present (or API key not required)
+            if (existingClientId && (!requireApiKey || existingApiKey)) {
+                if (!_options.dashboard) {
+                    clack.log.success(`Found existing WorkOS credentials in .env.local`);
+                }
+                return {
+                    apiKey: existingApiKey || '',
+                    clientId: existingClientId,
+                };
+            }
+        }
+        catch (error) {
+            // If we can't read/parse .env.local, just continue to prompt
+            debug('Failed to read .env.local:', error);
+        }
+    }
+    // Otherwise, prompt user for credentials
+    clack.log.step(`Get your credentials from ${chalk.cyan('https://dashboard.workos.com')}`);
+    if (requireApiKey && !apiKey) {
+        clack.log.info(`${chalk.dim('ℹ️ Your API key will be hidden for security and saved to .env.local')}`);
+        apiKey = (await abortIfCancelled(clack.password({
+            message: 'Enter your WorkOS API Key',
+            validate: (value) => {
+                if (!value)
+                    return 'API Key is required';
+                if (!value.startsWith('sk_')) {
+                    return 'API Key should start with sk_';
+                }
+                return undefined;
+            },
+        })));
+    }
+    else if (!requireApiKey) {
+        clack.log.info(`${chalk.dim('ℹ️ Client-only SDK - API key not required')}`);
+    }
+    if (!clientId) {
+        clientId = (await abortIfCancelled(clack.text({
+            message: 'Enter your WorkOS Client ID',
+            placeholder: 'client_...',
+            validate: (value) => {
+                if (!value)
+                    return 'Client ID is required';
+                if (!value.startsWith('client_')) {
+                    return 'Client ID should start with client_';
+                }
+                return undefined;
+            },
+        })));
+    }
+    return { apiKey: apiKey || '', clientId };
+}
+/**
+ * Fetch project data using a personal API key (for CI mode)
+ */
+//# sourceMappingURL=clack-utils.js.map

package/dist/src/utils/clack-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clack-utils.js","sourceRoot":"","sources":["../../../src/utils/clack-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import * as childProcess from 'node:child_process';\nimport * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport { basename, isAbsolute, join, relative } from 'node:path';\n\nimport chalk from 'chalk';\nimport { traceStep } from '../telemetry.js';\nimport { debug } from './debug.js';\nimport { parseEnvFile } from './env-parser.js';\nimport { type PackageDotJson, hasPackageInstalled } from './package-json.js';\nimport { type PackageManager, detectAllPackageManagers, packageManagers, NPM as npm } from './package-manager.js';\nimport { fulfillsVersionRange } from './semver.js';\nimport type { Feature, WizardOptions } from './types.js';\nimport { getPackageVersion } from './package-json.js';\nimport { ISSUES_URL, type Integration } from '../lib/constants.js';\nimport { analytics } from './analytics.js';\nimport clack from './clack.js';\nimport { INTEGRATION_CONFIG } from '../lib/config.js';\n\ninterface ProjectData {\n  projectApiKey: string;\n  accessToken: string;\n  host: string;\n  distinctId: string;\n  projectId: number;\n}\n\nexport interface CliSetupConfig {\n  filename: string;\n  name: string;\n  gitignore: boolean;\n\n  likelyAlreadyHasAuthToken(contents: string): boolean;\n  tokenContent(authToken: string): string;\n\n  likelyAlreadyHasOrgAndProject(contents: string): boolean;\n  orgAndProjContent(org: string, project: string): string;\n\n  likelyAlreadyHasUrl?(contents: string): boolean;\n  urlContent?(url: string): string;\n}\n\nexport interface CliSetupConfigContent {\n  authToken: string;\n  org?: string;\n  project?: string;\n  url?: string;\n}\n\nexport async function abort(message?: string, status?: number): Promise<never> {\n  await analytics.shutdown('cancelled');\n\n  clack.outro(message ?? 'Wizard setup cancelled.');\n  return process.exit(status ?? 1);\n}\n\nexport async function abortIfCancelled<T>(\n  input: T | Promise<T>,\n  integration?: Integration,\n): Promise<Exclude<T, symbol>> {\n  await analytics.shutdown('cancelled');\n  const resolvedInput = await input;\n\n  if (\n    clack.isCancel(resolvedInput) ||\n    (typeof resolvedInput === 'symbol' && resolvedInput.description === 'clack:cancel')\n  ) {\n    const docsUrl = integration ? INTEGRATION_CONFIG[integration].docsUrl : 'https://workos.com/docs/user-management';\n\n    clack.cancel(\n      `Wizard setup cancelled. You can read the documentation for ${\n        integration ?? 'WorkOS AuthKit'\n      } at ${chalk.cyan(docsUrl)} to continue with the setup manually.`,\n    );\n    process.exit(0);\n  } else {\n    return input as Exclude<T, symbol>;\n  }\n}\n\nexport function printWelcome(options: { wizardName: string; message?: string }): void {\n  // eslint-disable-next-line no-console\n  console.log('');\n  clack.intro(chalk.inverse(` ${options.wizardName} `));\n\n  const welcomeText =\n    options.message ||\n    `The ${options.wizardName} will help you set up WorkOS AuthKit for your application.\\nThank you for using WorkOS AuthKit :)`;\n\n  clack.note(welcomeText);\n}\n\nexport async function confirmContinueIfNoOrDirtyGitRepo(options: Pick<WizardOptions, 'ci'>): Promise<void> {\n  return traceStep('check-git-status', async () => {\n    if (!isInGitRepo()) {\n      // CI mode: auto-continue without git\n      const continueWithoutGit = options.ci\n        ? true\n        : await abortIfCancelled(\n            clack.confirm({\n              message:\n                'You are not inside a git repository. The wizard will create and update files. Do you want to continue anyway?',\n            }),\n          );\n\n      analytics.setTag('continue-without-git', continueWithoutGit);\n\n      if (!continueWithoutGit) {\n        await abort(undefined, 0);\n      }\n      // return early to avoid checking for uncommitted files\n      return;\n    }\n\n    const uncommittedOrUntrackedFiles = getUncommittedOrUntrackedFiles();\n    if (uncommittedOrUntrackedFiles.length) {\n      // CI mode: auto-continue with dirty repo\n      if (options.ci) {\n        clack.log.info(`CI mode: continuing with uncommitted/untracked files in repo`);\n        analytics.setTag('continue-with-dirty-repo', true);\n        return;\n      }\n\n      clack.log.warn(\n        `You have uncommitted or untracked files in your repo:\n\n${uncommittedOrUntrackedFiles.join('\\n')}\n\nThe wizard will create and update files.`,\n      );\n      const continueWithDirtyRepo = await abortIfCancelled(\n        clack.confirm({\n          message: 'Do you want to continue anyway?',\n        }),\n      );\n\n      analytics.setTag('continue-with-dirty-repo', continueWithDirtyRepo);\n\n      if (!continueWithDirtyRepo) {\n        await abort(undefined, 0);\n      }\n    }\n  });\n}\n\nexport function isInGitRepo() {\n  try {\n    childProcess.execSync('git rev-parse --is-inside-work-tree', {\n      stdio: 'ignore',\n    });\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport function getUncommittedOrUntrackedFiles(): string[] {\n  try {\n    const gitStatus = childProcess\n      .execSync('git status --porcelain=v1', {\n        // we only care about stdout\n        stdio: ['ignore', 'pipe', 'ignore'],\n      })\n      .toString();\n\n    const files = gitStatus\n      .split(os.EOL)\n      .map((line) => line.trim())\n      .filter(Boolean)\n      .map((f) => `- ${f.split(/\\s+/)[1]}`);\n\n    return files;\n  } catch {\n    return [];\n  }\n}\n\nexport async function askForItemSelection(items: string[], message: string): Promise<{ value: string; index: number }> {\n  const selection = await abortIfCancelled<{ value: string; index: number } | symbol>(\n    clack.select({\n      maxItems: 12,\n      message: message,\n      options: items.map((item, index) => {\n        return {\n          value: { value: item, index: index },\n          label: item,\n        };\n      }),\n    }),\n  );\n\n  return selection as { value: string; index: number };\n}\n\nexport async function confirmContinueIfPackageVersionNotSupported({\n  packageId,\n  packageName,\n  packageVersion,\n  acceptableVersions,\n  note,\n}: {\n  packageId: string;\n  packageName: string;\n  packageVersion: string;\n  acceptableVersions: string;\n  note?: string;\n}): Promise<void> {\n  return traceStep(`check-package-version`, async () => {\n    analytics.setTag(`${packageName.toLowerCase()}-version`, packageVersion);\n    const isSupportedVersion = fulfillsVersionRange({\n      acceptableVersions,\n      version: packageVersion,\n      canBeLatest: true,\n    });\n\n    if (isSupportedVersion) {\n      analytics.setTag(`${packageName.toLowerCase()}-supported`, true);\n      return;\n    }\n\n    clack.log.warn(\n      `You have an unsupported version of ${packageName} installed:\n\n  ${packageId}@${packageVersion}`,\n    );\n\n    clack.note(note ?? `Please upgrade to ${acceptableVersions} if you wish to use the WorkOS AuthKit wizard.`);\n    const continueWithUnsupportedVersion = await abortIfCancelled(\n      clack.confirm({\n        message: 'Do you want to continue anyway?',\n      }),\n    );\n    analytics.setTag(`${packageName.toLowerCase()}-continue-with-unsupported-version`, continueWithUnsupportedVersion);\n\n    if (!continueWithUnsupportedVersion) {\n      await abort(undefined, 0);\n    }\n  });\n}\n\nexport async function isReact19Installed({ installDir }: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  try {\n    const packageJson = await getPackageDotJson({ installDir });\n    const reactVersion = getPackageVersion('react', packageJson);\n\n    if (!reactVersion) {\n      return false;\n    }\n\n    return fulfillsVersionRange({\n      version: reactVersion,\n      acceptableVersions: '>=19.0.0',\n      canBeLatest: true,\n    });\n  } catch (error) {\n    return false;\n  }\n}\n\n/**\n * Installs or updates a package with the user's package manager.\n *\n * IMPORTANT: This function modifies the `package.json`! Be sure to re-read\n * it if you make additional modifications to it after calling this function!\n */\nexport async function installPackage({\n  packageName,\n  alreadyInstalled,\n  askBeforeUpdating = true,\n  packageNameDisplayLabel,\n  packageManager,\n  forceInstall = false,\n  integration,\n  installDir,\n}: {\n  /** 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`) */\n  packageName: string;\n  alreadyInstalled: boolean;\n  askBeforeUpdating?: boolean;\n  /** Overrides what is shown in the installation logs in place of the `packageName` option. Useful if the `packageName` is ugly */\n  packageNameDisplayLabel?: string;\n  packageManager?: PackageManager;\n  /** Add force install flag to command to skip install precondition fails */\n  forceInstall?: boolean;\n  /** The integration that is being used */\n  integration?: string;\n  /** The directory to install the package in */\n  installDir: string;\n}): Promise<{ packageManager?: PackageManager }> {\n  return traceStep('install-package', async () => {\n    if (alreadyInstalled && askBeforeUpdating) {\n      const shouldUpdatePackage = await abortIfCancelled(\n        clack.confirm({\n          message: `The ${chalk.bold.cyan(\n            packageNameDisplayLabel ?? packageName,\n          )} package is already installed. Do you want to update it to the latest version?`,\n        }),\n      );\n\n      if (!shouldUpdatePackage) {\n        return {};\n      }\n    }\n\n    const sdkInstallSpinner = clack.spinner();\n\n    const pkgManager = packageManager || (await getPackageManager({ installDir }));\n\n    // Most packages aren't compatible with React 19 yet, skip strict peer dependency checks if needed.\n    const isReact19 = await isReact19Installed({ installDir });\n    const legacyPeerDepsFlag = isReact19 && pkgManager.name === 'npm' ? '--legacy-peer-deps' : '';\n\n    sdkInstallSpinner.start(\n      `${alreadyInstalled ? 'Updating' : 'Installing'} ${chalk.bold.cyan(\n        packageNameDisplayLabel ?? packageName,\n      )} with ${chalk.bold(pkgManager.label)}.`,\n    );\n\n    try {\n      await new Promise<void>((resolve, reject) => {\n        childProcess.exec(\n          `${pkgManager.installCommand} ${packageName} ${pkgManager.flags} ${\n            forceInstall ? pkgManager.forceInstallFlag : ''\n          } ${legacyPeerDepsFlag}`.trim(),\n          { cwd: installDir },\n          (err, stdout, stderr) => {\n            if (err) {\n              // Write a log file so we can better troubleshoot issues\n              fs.writeFileSync(\n                join(process.cwd(), `workos-installation-error-${Date.now()}.log`),\n                JSON.stringify({\n                  stdout,\n                  stderr,\n                }),\n                { encoding: 'utf8' },\n              );\n\n              reject(err);\n            } else {\n              resolve();\n            }\n          },\n        );\n      });\n    } catch (e) {\n      sdkInstallSpinner.stop('Installation failed.');\n      clack.log.error(\n        `${chalk.red(\n          'Encountered the following error during installation:',\n          // eslint-disable-next-line @typescript-eslint/restrict-template-expressions\n        )}\\n\\n${e}\\n\\n${chalk.dim(\n          `The wizard has created an \\`workos-installation-error-*.log\\` file. If you think this issue is caused by the WorkOS AuthKit wizard, create an issue on GitHub and include the log file's content:\\n${ISSUES_URL}`,\n        )}`,\n      );\n      await abort();\n    }\n\n    sdkInstallSpinner.stop(\n      `${alreadyInstalled ? 'Updated' : 'Installed'} ${chalk.bold.cyan(\n        packageNameDisplayLabel ?? packageName,\n      )} with ${chalk.bold(pkgManager.label)}.`,\n    );\n\n    analytics.capture('wizard interaction', {\n      action: 'package installed',\n      package_name: packageName,\n      package_manager: pkgManager.name,\n      integration,\n    });\n\n    return { packageManager: pkgManager };\n  });\n}\n\n/**\n * Checks if @param packageId is listed as a dependency in @param packageJson.\n * If not, it will ask users if they want to continue without the package.\n *\n * Use this function to check if e.g. a the framework of the SDK is installed\n *\n * @param packageJson the package.json object\n * @param packageId the npm name of the package\n * @param packageName a human readable name of the package\n */\nexport async function ensurePackageIsInstalled(\n  packageJson: PackageDotJson,\n  packageId: string,\n  packageName: string,\n  options?: Pick<WizardOptions, 'dashboard'>,\n): Promise<void> {\n  return traceStep('ensure-package-installed', async () => {\n    const installed = hasPackageInstalled(packageId, packageJson);\n\n    analytics.setTag(`${packageName.toLowerCase()}-installed`, installed);\n\n    if (!installed) {\n      // In dashboard mode, auto-continue (integration was already detected)\n      if (options?.dashboard) {\n        return;\n      }\n\n      const continueWithoutPackage = await abortIfCancelled(\n        clack.confirm({\n          message: `${packageName} does not seem to be installed. Do you still want to continue?`,\n          initialValue: false,\n        }),\n      );\n\n      if (!continueWithoutPackage) {\n        await abort(undefined, 0);\n      }\n    }\n  });\n}\n\nexport async function getPackageDotJson({ installDir }: Pick<WizardOptions, 'installDir'>): Promise<PackageDotJson> {\n  const packageJsonFileContents = await fs.promises.readFile(join(installDir, 'package.json'), 'utf8').catch(() => {\n    clack.log.error('Could not find package.json. Make sure to run the wizard in the root of your app!');\n    return abort();\n  });\n\n  let packageJson: PackageDotJson | undefined = undefined;\n\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n    packageJson = JSON.parse(packageJsonFileContents);\n  } catch {\n    clack.log.error(`Unable to parse your ${chalk.cyan('package.json')}. Make sure it has a valid format!`);\n\n    await abort();\n  }\n\n  return packageJson || {};\n}\n\nexport async function updatePackageDotJson(\n  packageDotJson: PackageDotJson,\n  { installDir }: Pick<WizardOptions, 'installDir'>,\n): Promise<void> {\n  try {\n    await fs.promises.writeFile(\n      join(installDir, 'package.json'),\n      // TODO: maybe figure out the original indentation\n      JSON.stringify(packageDotJson, null, 2),\n      {\n        encoding: 'utf8',\n        flag: 'w',\n      },\n    );\n  } catch {\n    clack.log.error(`Unable to update your ${chalk.cyan('package.json')}.`);\n\n    await abort();\n  }\n}\n\nexport async function getPackageManager(\n  options: Pick<WizardOptions, 'installDir'> & { ci?: boolean },\n): Promise<PackageManager> {\n  const detectedPackageManagers = detectAllPackageManagers({\n    installDir: options.installDir,\n  });\n\n  // If exactly one package manager detected, use it automatically\n  if (detectedPackageManagers.length === 1) {\n    const detectedPackageManager = detectedPackageManagers[0];\n    analytics.setTag('package-manager', detectedPackageManager.name);\n    return detectedPackageManager;\n  }\n\n  // CI mode: auto-select first detected or npm\n  if (options.ci) {\n    const selectedPackageManager = detectedPackageManagers.length > 0 ? detectedPackageManagers[0] : npm;\n    clack.log.info(`CI mode: auto-selected package manager: ${selectedPackageManager.label}`);\n    analytics.setTag('package-manager', selectedPackageManager.name);\n    return selectedPackageManager;\n  }\n\n  // If multiple or no package managers detected, prompt user to select\n  const pkgOptions = detectedPackageManagers.length > 0 ? detectedPackageManagers : packageManagers;\n\n  const message =\n    detectedPackageManagers.length > 1\n      ? 'Multiple package managers detected. Please select one:'\n      : 'Please select your package manager.';\n\n  const selectedPackageManager = await abortIfCancelled<PackageManager | symbol>(\n    clack.select({\n      message,\n      options: pkgOptions.map((packageManager) => ({\n        value: packageManager,\n        label: packageManager.label,\n      })),\n    }),\n  );\n\n  analytics.setTag('package-manager', (selectedPackageManager as PackageManager).name);\n  return selectedPackageManager as PackageManager;\n}\n\nexport function isUsingTypeScript({ installDir }: Pick<WizardOptions, 'installDir'>) {\n  try {\n    return fs.existsSync(join(installDir, 'tsconfig.json'));\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Get WorkOS credentials (API Key and Client ID) from user or CLI options\n * @param requireApiKey - Whether API key is needed (false for client-only SDKs like React, Vanilla JS)\n */\nexport async function getOrAskForWorkOSCredentials(\n  _options: Pick<WizardOptions, 'ci' | 'apiKey' | 'clientId' | 'installDir' | 'dashboard'>,\n  requireApiKey: boolean = true,\n): Promise<{\n  apiKey: string;\n  clientId: string;\n}> {\n  let apiKey = _options.apiKey;\n  let clientId = _options.clientId;\n\n  // If credentials provided via CLI (e.g., CI mode or dashboard mode), use them\n  if ((!requireApiKey || apiKey) && clientId) {\n    // Only log in non-dashboard mode\n    if (!_options.dashboard) {\n      clack.log.info('Using provided WorkOS credentials');\n    }\n    return { apiKey: apiKey || '', clientId };\n  }\n\n  // Check if credentials already exist in .env.local\n  const envPath = join(_options.installDir, '.env.local');\n  if (fs.existsSync(envPath)) {\n    try {\n      const envContent = fs.readFileSync(envPath, 'utf-8');\n      const envVars = parseEnvFile(envContent);\n\n      const existingApiKey = envVars.WORKOS_API_KEY;\n      const existingClientId = envVars.WORKOS_CLIENT_ID;\n\n      // Use existing credentials if both are present (or API key not required)\n      if (existingClientId && (!requireApiKey || existingApiKey)) {\n        if (!_options.dashboard) {\n          clack.log.success(`Found existing WorkOS credentials in .env.local`);\n        }\n        return {\n          apiKey: existingApiKey || '',\n          clientId: existingClientId,\n        };\n      }\n    } catch (error) {\n      // If we can't read/parse .env.local, just continue to prompt\n      debug('Failed to read .env.local:', error);\n    }\n  }\n\n  // Otherwise, prompt user for credentials\n  clack.log.step(`Get your credentials from ${chalk.cyan('https://dashboard.workos.com')}`);\n\n  if (requireApiKey && !apiKey) {\n    clack.log.info(`${chalk.dim('ℹ️ Your API key will be hidden for security and saved to .env.local')}`);\n    apiKey = (await abortIfCancelled(\n      clack.password({\n        message: 'Enter your WorkOS API Key',\n        validate: (value: string) => {\n          if (!value) return 'API Key is required';\n          if (!value.startsWith('sk_')) {\n            return 'API Key should start with sk_';\n          }\n          return undefined;\n        },\n      }),\n    )) as string;\n  } else if (!requireApiKey) {\n    clack.log.info(`${chalk.dim('ℹ️ Client-only SDK - API key not required')}`);\n  }\n\n  if (!clientId) {\n    clientId = (await abortIfCancelled(\n      clack.text({\n        message: 'Enter your WorkOS Client ID',\n        placeholder: 'client_...',\n        validate: (value: string) => {\n          if (!value) return 'Client ID is required';\n          if (!value.startsWith('client_')) {\n            return 'Client ID should start with client_';\n          }\n          return undefined;\n        },\n      }),\n    )) as string;\n  }\n\n  return { apiKey: apiKey || '', clientId };\n}\n\n/**\n * Fetch project data using a personal API key (for CI mode)\n */\n"]}

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

@@ -0,0 +1,5 @@
+import * as clack from '@clack/prompts';
+export declare function setDashboardMode(enabled: boolean): void;
+export declare function isDashboardMode(): boolean;
+declare const clackProxy: typeof clack;
+export default clackProxy;

package/dist/src/utils/clack.js

@@ -0,0 +1,34 @@
+import * as clack from '@clack/prompts';
+// Dashboard mode flag - when true, suppress console output
+let dashboardMode = false;
+export function setDashboardMode(enabled) {
+    dashboardMode = enabled;
+}
+export function isDashboardMode() {
+    return dashboardMode;
+}
+// Create a proxy that suppresses log output in dashboard mode
+const clackProxy = new Proxy(clack, {
+    get(target, prop) {
+        const value = target[prop];
+        // Suppress log methods in dashboard mode
+        if (prop === 'log' && dashboardMode) {
+            return {
+                info: () => { },
+                success: () => { },
+                warn: () => { },
+                warning: () => { },
+                error: () => { },
+                step: () => { },
+                message: () => { },
+            };
+        }
+        // Suppress intro/outro in dashboard mode
+        if ((prop === 'intro' || prop === 'outro') && dashboardMode) {
+            return () => { };
+        }
+        return value;
+    },
+});
+export default clackProxy;
+//# sourceMappingURL=clack.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clack.js","sourceRoot":"","sources":["../../../src/utils/clack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AAExC,2DAA2D;AAC3D,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,aAAa,GAAG,OAAO,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE;IAClC,GAAG,CAAC,MAAM,EAAE,IAAI;QACd,MAAM,KAAK,GAAG,MAAM,CAAC,IAA0B,CAAC,CAAC;QAEjD,yCAAyC;QACzC,IAAI,IAAI,KAAK,KAAK,IAAI,aAAa,EAAE,CAAC;YACpC,OAAO;gBACL,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;gBACd,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;gBACjB,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;gBACd,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;gBACjB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;gBACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;gBACd,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;aAClB,CAAC;QACJ,CAAC;QAED,yCAAyC;QACzC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,CAAC,IAAI,aAAa,EAAE,CAAC;YAC5D,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC,CAAC;AAEH,eAAe,UAAU,CAAC","sourcesContent":["import * as clack from '@clack/prompts';\n\n// Dashboard mode flag - when true, suppress console output\nlet dashboardMode = false;\n\nexport function setDashboardMode(enabled: boolean): void {\n  dashboardMode = enabled;\n}\n\nexport function isDashboardMode(): boolean {\n  return dashboardMode;\n}\n\n// Create a proxy that suppresses log output in dashboard mode\nconst clackProxy = new Proxy(clack, {\n  get(target, prop) {\n    const value = target[prop as keyof typeof clack];\n\n    // Suppress log methods in dashboard mode\n    if (prop === 'log' && dashboardMode) {\n      return {\n        info: () => {},\n        success: () => {},\n        warn: () => {},\n        warning: () => {},\n        error: () => {},\n        step: () => {},\n        message: () => {},\n      };\n    }\n\n    // Suppress intro/outro in dashboard mode\n    if ((prop === 'intro' || prop === 'outro') && dashboardMode) {\n      return () => {};\n    }\n\n    return value;\n  },\n});\n\nexport default clackProxy;\n"]}

package/dist/src/utils/cli-symbols.d.ts

@@ -0,0 +1,32 @@
+export declare const symbols: {
+    readonly success: "✓" | "+";
+    readonly error: "✗" | "x";
+    readonly warning: "!";
+    readonly info: "i" | "ℹ";
+    readonly arrow: "→" | "->";
+    readonly bullet: "*" | "•";
+    readonly progressFilled: "#" | "▓";
+    readonly progressEmpty: "-" | "░";
+};
+/**
+ * Pre-styled output functions for consistent CLI formatting.
+ * Uses chalk for coloring with appropriate symbols.
+ */
+export declare const styled: {
+    /** Green checkmark with message */
+    readonly success: (text: string) => string;
+    /** Red X with message */
+    readonly error: (text: string) => string;
+    /** Yellow warning with message */
+    readonly warning: (text: string) => string;
+    /** Dim info text */
+    readonly info: (text: string) => string;
+    /** Cyan arrow for actions */
+    readonly action: (text: string) => string;
+    /** Label with value, label is dimmed */
+    readonly label: (label: string, value: string) => string;
+    /** Phase indicator with visual progress bar */
+    readonly phase: (num: number, total: number, name: string) => string;
+    /** Bullet point for lists */
+    readonly bullet: (text: string) => string;
+};

package/dist/src/utils/cli-symbols.js

@@ -0,0 +1,46 @@
+/**
+ * Centralized symbol and color definitions for CLI output.
+ *
+ * Provides consistent visual vocabulary across all CLI handlers.
+ * Supports both Unicode and ASCII fallback for terminal compatibility.
+ */
+import chalk from 'chalk';
+import { isUnicodeSupported } from './vendor/is-unicorn-supported.js';
+const unicode = isUnicodeSupported();
+export const symbols = {
+    success: unicode ? '✓' : '+',
+    error: unicode ? '✗' : 'x',
+    warning: '!',
+    info: unicode ? 'ℹ' : 'i',
+    arrow: unicode ? '→' : '->',
+    bullet: unicode ? '•' : '*',
+    progressFilled: unicode ? '▓' : '#',
+    progressEmpty: unicode ? '░' : '-',
+};
+/**
+ * Pre-styled output functions for consistent CLI formatting.
+ * Uses chalk for coloring with appropriate symbols.
+ */
+export const styled = {
+    /** Green checkmark with message */
+    success: (text) => chalk.green(`${symbols.success} ${text}`),
+    /** Red X with message */
+    error: (text) => chalk.red(`${symbols.error} ${text}`),
+    /** Yellow warning with message */
+    warning: (text) => chalk.yellow(`${symbols.warning} ${text}`),
+    /** Dim info text */
+    info: (text) => chalk.dim(`${symbols.info} ${text}`),
+    /** Cyan arrow for actions */
+    action: (text) => chalk.cyan(`${symbols.arrow} ${text}`),
+    /** Label with value, label is dimmed */
+    label: (label, value) => `${chalk.dim(label)} ${value}`,
+    /** Phase indicator with visual progress bar */
+    phase: (num, total, name) => {
+        const filled = symbols.progressFilled.repeat(num);
+        const empty = symbols.progressEmpty.repeat(total - num);
+        return `${chalk.cyan(filled)}${chalk.dim(empty)} ${name}`;
+    },
+    /** Bullet point for lists */
+    bullet: (text) => `  ${symbols.bullet} ${text}`,
+};
+//# sourceMappingURL=cli-symbols.js.map

package/dist/src/utils/cli-symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-symbols.js","sourceRoot":"","sources":["../../../src/utils/cli-symbols.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IAC5B,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IAC1B,OAAO,EAAE,GAAG;IACZ,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IACzB,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;IAC3B,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IAC3B,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IACnC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;CAC1B,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,mCAAmC;IACnC,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;IAEpE,yBAAyB;IACzB,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;IAE9D,kCAAkC;IAClC,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;IAErE,oBAAoB;IACpB,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;IAE5D,6BAA6B;IAC7B,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;IAEhE,wCAAwC;IACxC,KAAK,EAAE,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,EAAE;IAEvE,+CAA+C;IAC/C,KAAK,EAAE,CAAC,GAAW,EAAE,KAAa,EAAE,IAAY,EAAE,EAAE;QAClD,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;QACxD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;IAC5D,CAAC;IAED,6BAA6B;IAC7B,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,IAAI,IAAI,EAAE;CAC/C,CAAC","sourcesContent":["/**\n * Centralized symbol and color definitions for CLI output.\n *\n * Provides consistent visual vocabulary across all CLI handlers.\n * Supports both Unicode and ASCII fallback for terminal compatibility.\n */\nimport chalk from 'chalk';\nimport { isUnicodeSupported } from './vendor/is-unicorn-supported.js';\n\nconst unicode = isUnicodeSupported();\n\nexport const symbols = {\n  success: unicode ? '✓' : '+',\n  error: unicode ? '✗' : 'x',\n  warning: '!',\n  info: unicode ? 'ℹ' : 'i',\n  arrow: unicode ? '→' : '->',\n  bullet: unicode ? '•' : '*',\n  progressFilled: unicode ? '▓' : '#',\n  progressEmpty: unicode ? '░' : '-',\n} as const;\n\n/**\n * Pre-styled output functions for consistent CLI formatting.\n * Uses chalk for coloring with appropriate symbols.\n */\nexport const styled = {\n  /** Green checkmark with message */\n  success: (text: string) => chalk.green(`${symbols.success} ${text}`),\n\n  /** Red X with message */\n  error: (text: string) => chalk.red(`${symbols.error} ${text}`),\n\n  /** Yellow warning with message */\n  warning: (text: string) => chalk.yellow(`${symbols.warning} ${text}`),\n\n  /** Dim info text */\n  info: (text: string) => chalk.dim(`${symbols.info} ${text}`),\n\n  /** Cyan arrow for actions */\n  action: (text: string) => chalk.cyan(`${symbols.arrow} ${text}`),\n\n  /** Label with value, label is dimmed */\n  label: (label: string, value: string) => `${chalk.dim(label)} ${value}`,\n\n  /** Phase indicator with visual progress bar */\n  phase: (num: number, total: number, name: string) => {\n    const filled = symbols.progressFilled.repeat(num);\n    const empty = symbols.progressEmpty.repeat(total - num);\n    return `${chalk.cyan(filled)}${chalk.dim(empty)} ${name}`;\n  },\n\n  /** Bullet point for lists */\n  bullet: (text: string) => `  ${symbols.bullet} ${text}`,\n} as const;\n"]}

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

@@ -0,0 +1,7 @@
+export declare function initLogFile(): void;
+export declare function getLogFilePath(): string | null;
+export declare function logInfo(...args: unknown[]): void;
+export declare function logWarn(...args: unknown[]): void;
+export declare function logError(...args: unknown[]): void;
+export declare function debug(...args: unknown[]): void;
+export declare function enableDebugLogs(): void;