workos 0.17.1 → 0.19.0

package/dist/utils/{clack-utils.js → ui-utils.js}

@@ -12,9 +12,11 @@ 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 ui from './ui.js';
 import { INTEGRATION_CONFIG } from '../lib/config.js';
 import { SPAWN_OPTS } from './platform.js';
+import { isPromptAllowed } from './interaction-mode.js';
+import { exitWithError, isJsonMode } from './output.js';
 /**
  * Redact sensitive info (API keys, client secrets) from a string.
  */
@@ -24,16 +26,37 @@ export function redactSensitiveInfo(str) {
 }
 export async function abort(message, status) {
     await analytics.shutdown('cancelled');
-    clack.outro(message ?? 'Installer setup cancelled.');
+    ui.outro(message ?? 'Installer setup cancelled.');
     return process.exit(status ?? 1);
 }
 export async function abortIfCancelled(input, integration) {
-    await analytics.shutdown('cancelled');
+    if (!isPromptAllowed()) {
+        // Never await `input` in non-interactive mode — awaiting a never-resolving
+        // prompt is exactly the hang this guard fixes. Fail fast with a structured
+        // error instead. Placed before analytics.shutdown('cancelled') so a
+        // non-interactive block is not mislabeled as a user cancel.
+        exitWithError({
+            code: 'non_interactive_prompt',
+            message: `This step requires interactive input${integration ? ` for ${integration}` : ''}, but the CLI is running ` +
+                `in a non-interactive mode (agent/CI/non-TTY). Pass the required flags (e.g. --router app|pages for Next.js) ` +
+                `or run in an interactive terminal.`,
+            recovery: {
+                hints: [
+                    {
+                        description: 'Re-run in an interactive terminal, or pass the flags that answer this prompt (e.g. --router).',
+                    },
+                ],
+            },
+        });
+    }
     const resolvedInput = await input;
-    if (clack.isCancel(resolvedInput) ||
-        (typeof resolvedInput === 'symbol' && resolvedInput.description === 'clack:cancel')) {
+    if (ui.isCancel(resolvedInput)) {
+        // Flush a 'cancelled' session end ONLY on an actual cancel. Running this on
+        // every prompt (the previous behavior) emitted a bogus session end and added
+        // up to 3s of flush dead-time to each prompt on the happy path.
+        await analytics.shutdown('cancelled');
         const docsUrl = integration ? INTEGRATION_CONFIG[integration].docsUrl : 'https://workos.com/docs/user-management';
-        clack.cancel(`Installer setup cancelled. You can read the documentation for ${integration ?? 'WorkOS AuthKit'} at ${chalk.cyan(docsUrl)} to continue with the setup manually.`);
+        ui.cancel(`Installer 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 {
@@ -41,12 +64,10 @@ export async function abortIfCancelled(input, integration) {
     }
 }
 export function printWelcome(options) {
-    // eslint-disable-next-line no-console
-    console.log('');
-    clack.intro(chalk.inverse(` ${options.wizardName} `));
+    ui.intro('WorkOS', 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);
+    ui.note(welcomeText);
 }
 export async function confirmContinueIfNoOrDirtyGitRepo(options) {
     return traceStep('check-git-status', async () => {
@@ -54,7 +75,7 @@ export async function confirmContinueIfNoOrDirtyGitRepo(options) {
             // CI mode: auto-continue without git
             const continueWithoutGit = options.ci
                 ? true
-                : await abortIfCancelled(clack.confirm({
+                : await abortIfCancelled(ui.confirm({
                     message: 'You are not inside a git repository. The installer will create and update files. Do you want to continue anyway?',
                 }));
             analytics.setTag('continue-without-git', continueWithoutGit);
@@ -68,16 +89,16 @@ export async function confirmContinueIfNoOrDirtyGitRepo(options) {
         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`);
+                ui.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:
+            ui.log.warn(`You have uncommitted or untracked files in your repo:
 
 ${uncommittedOrUntrackedFiles.join('\n')}
 
 The installer will create and update files.`);
-            const continueWithDirtyRepo = await abortIfCancelled(clack.confirm({
+            const continueWithDirtyRepo = await abortIfCancelled(ui.confirm({
                 message: 'Do you want to continue anyway?',
             }));
             analytics.setTag('continue-with-dirty-repo', continueWithDirtyRepo);
@@ -118,7 +139,7 @@ export function getUncommittedOrUntrackedFiles() {
     }
 }
 export async function askForItemSelection(items, message) {
-    const selection = await abortIfCancelled(clack.select({
+    const selection = await abortIfCancelled(ui.select({
         maxItems: 12,
         message: message,
         options: items.map((item, index) => {
@@ -142,11 +163,11 @@ export async function confirmContinueIfPackageVersionNotSupported({ packageId, p
             analytics.setTag(`${packageName.toLowerCase()}-supported`, true);
             return;
         }
-        clack.log.warn(`You have an unsupported version of ${packageName} installed:
+        ui.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 installer.`);
-        const continueWithUnsupportedVersion = await abortIfCancelled(clack.confirm({
+        ui.note(note ?? `Please upgrade to ${acceptableVersions} if you wish to use the WorkOS AuthKit installer.`);
+        const continueWithUnsupportedVersion = await abortIfCancelled(ui.confirm({
             message: 'Do you want to continue anyway?',
         }));
         analytics.setTag(`${packageName.toLowerCase()}-continue-with-unsupported-version`, continueWithUnsupportedVersion);
@@ -181,14 +202,14 @@ export async function isReact19Installed({ installDir }) {
 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({
+            const shouldUpdatePackage = await abortIfCancelled(ui.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 sdkInstallSpinner = ui.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 });
@@ -230,7 +251,7 @@ export async function installPackage({ packageName, alreadyInstalled, askBeforeU
         }
         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 installer has created an \`workos-installation-error-*.log\` file. If you think this issue is caused by the WorkOS AuthKit installer, create an issue on GitHub and include the log file's content:\n${ISSUES_URL}`)}`);
+            ui.log.error(`${chalk.red('Encountered the following error during installation:')}\n\n${e}\n\n${chalk.dim(`The installer has created an \`workos-installation-error-*.log\` file. If you think this issue is caused by the WorkOS AuthKit installer, 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)}.`);
@@ -262,7 +283,7 @@ export async function ensurePackageIsInstalled(packageJson, packageId, packageNa
             if (options?.dashboard) {
                 return;
             }
-            const continueWithoutPackage = await abortIfCancelled(clack.confirm({
+            const continueWithoutPackage = await abortIfCancelled(ui.confirm({
                 message: `${packageName} does not seem to be installed. Do you still want to continue?`,
                 initialValue: false,
             }));
@@ -274,7 +295,7 @@ export async function ensurePackageIsInstalled(packageJson, packageId, packageNa
 }
 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 installer in the root of your app!');
+        ui.log.error('Could not find package.json. Make sure to run the installer in the root of your app!');
         return abort();
     });
     let packageJson = undefined;
@@ -283,7 +304,7 @@ export async function getPackageDotJson({ installDir }) {
         packageJson = JSON.parse(packageJsonFileContents);
     }
     catch {
-        clack.log.error(`Unable to parse your ${chalk.cyan('package.json')}. Make sure it has a valid format!`);
+        ui.log.error(`Unable to parse your ${chalk.cyan('package.json')}. Make sure it has a valid format!`);
         await abort();
     }
     return packageJson || {};
@@ -298,7 +319,7 @@ export async function updatePackageDotJson(packageDotJson, { installDir }) {
         });
     }
     catch {
-        clack.log.error(`Unable to update your ${chalk.cyan('package.json')}.`);
+        ui.log.error(`Unable to update your ${chalk.cyan('package.json')}.`);
         await abort();
     }
 }
@@ -315,7 +336,7 @@ export async function getPackageManager(options) {
     // 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}`);
+        ui.log.info(`CI mode: auto-selected package manager: ${selectedPackageManager.label}`);
         analytics.setTag('package-manager', selectedPackageManager.name);
         return selectedPackageManager;
     }
@@ -324,7 +345,7 @@ export async function getPackageManager(options) {
     const message = detectedPackageManagers.length > 1
         ? 'Multiple package managers detected. Please select one:'
         : 'Please select your package manager.';
-    const selectedPackageManager = await abortIfCancelled(clack.select({
+    const selectedPackageManager = await abortIfCancelled(ui.select({
         message,
         options: pkgOptions.map((packageManager) => ({
             value: packageManager,
@@ -351,9 +372,15 @@ export async function getOrAskForWorkOSCredentials(_options, requireApiKey = tru
     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');
+        // Say "you provided" only when the user actually supplied credentials
+        // (cli/manual, or an unknown source). For device/stored/env the state
+        // machine already announced the source accurately before this runs, so
+        // stay silent rather than double-announce. Gate on human output mode so
+        // this never pollutes JSON/NDJSON.
+        const source = _options.credentialSource;
+        const userProvided = source === 'cli' || source === 'manual' || source === undefined;
+        if (!_options.dashboard && !isJsonMode() && userProvided) {
+            ui.log.info('Using the WorkOS credentials you provided');
         }
         return { apiKey: apiKey || '', clientId };
     }
@@ -368,7 +395,7 @@ export async function getOrAskForWorkOSCredentials(_options, requireApiKey = tru
             // 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`);
+                    ui.log.success(`Found existing WorkOS credentials in .env.local`);
                 }
                 return {
                     apiKey: existingApiKey || '',
@@ -382,10 +409,10 @@ export async function getOrAskForWorkOSCredentials(_options, requireApiKey = tru
         }
     }
     // Otherwise, prompt user for credentials
-    clack.log.step(`Get your credentials from ${chalk.cyan('https://dashboard.workos.com')}`);
+    ui.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({
+        ui.log.info(`${chalk.dim('ℹ️ Your API key will be hidden for security and saved to .env.local')}`);
+        apiKey = (await abortIfCancelled(ui.password({
             message: 'Enter your WorkOS API Key',
             validate: (value) => {
                 if (!value)
@@ -398,10 +425,10 @@ export async function getOrAskForWorkOSCredentials(_options, requireApiKey = tru
         })));
     }
     else if (!requireApiKey) {
-        clack.log.info(`${chalk.dim('ℹ️ Client-only SDK - API key not required')}`);
+        ui.log.info(`${chalk.dim('ℹ️ Client-only SDK - API key not required')}`);
     }
     if (!clientId) {
-        clientId = (await abortIfCancelled(clack.text({
+        clientId = (await abortIfCancelled(ui.text({
             message: 'Enter your WorkOS Client ID',
             placeholder: 'client_...',
             validate: (value) => {
@@ -419,4 +446,4 @@ export async function getOrAskForWorkOSCredentials(_options, requireApiKey = tru
 /**
  * Fetch project data using a personal API key (for CI mode)
  */
-//# sourceMappingURL=clack-utils.js.map
+//# sourceMappingURL=ui-utils.js.map

package/dist/utils/ui-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-utils.js","sourceRoot":"","sources":["../../src/utils/ui-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 { join } 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 { InstallerOptions } from './types.js';\nimport { getPackageVersion } from './package-json.js';\nimport { ISSUES_URL, type Integration } from '../lib/constants.js';\nimport { analytics } from './analytics.js';\nimport ui from './ui.js';\nimport { INTEGRATION_CONFIG } from '../lib/config.js';\nimport { SPAWN_OPTS } from './platform.js';\nimport { isPromptAllowed } from './interaction-mode.js';\nimport { exitWithError, isJsonMode } from './output.js';\n\n/**\n * Redact sensitive info (API keys, client secrets) from a string.\n */\nexport function redactSensitiveInfo(str: string): string {\n  // Redact WorkOS API keys (sk_...), client secrets, etc.\n  return str.replace(/sk_[a-zA-Z0-9]+/g, 'sk_***').replace(/client_[a-zA-Z0-9]{20,}/g, 'client_***');\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  ui.outro(message ?? 'Installer 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  if (!isPromptAllowed()) {\n    // Never await `input` in non-interactive mode — awaiting a never-resolving\n    // prompt is exactly the hang this guard fixes. Fail fast with a structured\n    // error instead. Placed before analytics.shutdown('cancelled') so a\n    // non-interactive block is not mislabeled as a user cancel.\n    exitWithError({\n      code: 'non_interactive_prompt',\n      message:\n        `This step requires interactive input${integration ? ` for ${integration}` : ''}, but the CLI is running ` +\n        `in a non-interactive mode (agent/CI/non-TTY). Pass the required flags (e.g. --router app|pages for Next.js) ` +\n        `or run in an interactive terminal.`,\n      recovery: {\n        hints: [\n          {\n            description:\n              'Re-run in an interactive terminal, or pass the flags that answer this prompt (e.g. --router).',\n          },\n        ],\n      },\n    });\n  }\n\n  const resolvedInput = await input;\n\n  if (ui.isCancel(resolvedInput)) {\n    // Flush a 'cancelled' session end ONLY on an actual cancel. Running this on\n    // every prompt (the previous behavior) emitted a bogus session end and added\n    // up to 3s of flush dead-time to each prompt on the happy path.\n    await analytics.shutdown('cancelled');\n\n    const docsUrl = integration ? INTEGRATION_CONFIG[integration].docsUrl : 'https://workos.com/docs/user-management';\n\n    ui.cancel(\n      `Installer 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  ui.intro('WorkOS', 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  ui.note(welcomeText);\n}\n\nexport async function confirmContinueIfNoOrDirtyGitRepo(options: Pick<InstallerOptions, '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            ui.confirm({\n              message:\n                'You are not inside a git repository. The installer 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        ui.log.info(`CI mode: continuing with uncommitted/untracked files in repo`);\n        analytics.setTag('continue-with-dirty-repo', true);\n        return;\n      }\n\n      ui.log.warn(\n        `You have uncommitted or untracked files in your repo:\n\n${uncommittedOrUntrackedFiles.join('\\n')}\n\nThe installer will create and update files.`,\n      );\n      const continueWithDirtyRepo = await abortIfCancelled(\n        ui.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    ui.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    ui.log.warn(\n      `You have an unsupported version of ${packageName} installed:\n\n  ${packageId}@${packageVersion}`,\n    );\n\n    ui.note(note ?? `Please upgrade to ${acceptableVersions} if you wish to use the WorkOS AuthKit installer.`);\n    const continueWithUnsupportedVersion = await abortIfCancelled(\n      ui.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<InstallerOptions, '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 {\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        ui.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 = ui.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        const [cmd, ...baseArgs] = pkgManager.installCommand.split(' ');\n        const args = [\n          ...baseArgs,\n          packageName,\n          ...pkgManager.flags.split(/\\s+/).filter(Boolean),\n          ...(forceInstall && pkgManager.forceInstallFlag ? pkgManager.forceInstallFlag.split(/\\s+/) : []),\n          ...(legacyPeerDepsFlag ? [legacyPeerDepsFlag] : []),\n        ];\n        const proc = childProcess.spawn(cmd, args, { cwd: installDir, ...SPAWN_OPTS });\n        let stdout = '';\n        let stderr = '';\n        proc.stdout?.on('data', (d: Buffer) => {\n          stdout += d.toString();\n        });\n        proc.stderr?.on('data', (d: Buffer) => {\n          stderr += d.toString();\n        });\n        proc.on('close', (code) => {\n          if (code !== 0) {\n            fs.writeFileSync(\n              join(process.cwd(), `workos-installation-error-${Date.now()}.log`),\n              JSON.stringify({\n                stdout: redactSensitiveInfo(stdout),\n                stderr: redactSensitiveInfo(stderr),\n              }),\n              { encoding: 'utf8' },\n            );\n            reject(new Error(`${cmd} exited with code ${code}\\n${stderr}`));\n          } else {\n            resolve();\n          }\n        });\n        proc.on('error', reject);\n      });\n    } catch (e) {\n      sdkInstallSpinner.stop('Installation failed.');\n      ui.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 installer has created an \\`workos-installation-error-*.log\\` file. If you think this issue is caused by the WorkOS AuthKit installer, 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('installer 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<InstallerOptions, '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        ui.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<InstallerOptions, 'installDir'>): Promise<PackageDotJson> {\n  const packageJsonFileContents = await fs.promises.readFile(join(installDir, 'package.json'), 'utf8').catch(() => {\n    ui.log.error('Could not find package.json. Make sure to run the installer 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    ui.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<InstallerOptions, '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    ui.log.error(`Unable to update your ${chalk.cyan('package.json')}.`);\n\n    await abort();\n  }\n}\n\nexport async function getPackageManager(\n  options: Pick<InstallerOptions, '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    ui.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    ui.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<InstallerOptions, '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<InstallerOptions, 'ci' | 'apiKey' | 'clientId' | 'installDir' | 'dashboard' | 'credentialSource'>,\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    // Say \"you provided\" only when the user actually supplied credentials\n    // (cli/manual, or an unknown source). For device/stored/env the state\n    // machine already announced the source accurately before this runs, so\n    // stay silent rather than double-announce. Gate on human output mode so\n    // this never pollutes JSON/NDJSON.\n    const source = _options.credentialSource;\n    const userProvided = source === 'cli' || source === 'manual' || source === undefined;\n    if (!_options.dashboard && !isJsonMode() && userProvided) {\n      ui.log.info('Using the WorkOS credentials you provided');\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          ui.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  ui.log.step(`Get your credentials from ${chalk.cyan('https://dashboard.workos.com')}`);\n\n  if (requireApiKey && !apiKey) {\n    ui.log.info(`${chalk.dim('ℹ️ Your API key will be hidden for security and saved to .env.local')}`);\n    apiKey = (await abortIfCancelled(\n      ui.password({\n        message: 'Enter your WorkOS API Key',\n        validate: (value) => {\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    ui.log.info(`${chalk.dim('ℹ️ Client-only SDK - API key not required')}`);\n  }\n\n  if (!clientId) {\n    clientId = (await abortIfCancelled(\n      ui.text({\n        message: 'Enter your WorkOS Client ID',\n        placeholder: 'client_...',\n        validate: (value) => {\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/utils/ui.d.ts

@@ -0,0 +1,148 @@
+/**
+ * UI facade — flat, gutterless CLI output + interactive prompts.
+ *
+ * The single import seam for all CLI UI: every module imports the default `ui`
+ * from this file. Output is hand-styled ANSI (diffdad-style: 2-space indent, one
+ * accent color, no vertical gutter). Input (confirm/select/text/password)
+ * delegates to `@inquirer/prompts`.
+ *
+ * The prompt adapters keep a stable call shape (`{ message, options,
+ * initialValue, validate }`) and the `isCancel(answer)` pattern, so the input
+ * engine can be swapped underneath without touching the ~30 call sites.
+ *
+ * Cancellation: @inquirer THROWS on ctrl-c / signal-abort (ExitPromptError /
+ * AbortPromptError) instead of returning a symbol. Each adapted prompt catches
+ * those and returns the `CANCEL` symbol, so `if (ui.isCancel(x))` keeps working.
+ */
+export declare function setDashboardMode(enabled: boolean): void;
+export declare function isDashboardMode(): boolean;
+/**
+ * An inverse "badge" chip (e.g. a colored INFO / WARN label). Pure string
+ * helper so callers writing to stdout OR stderr can reuse it. chalk.level === 0
+ * (JSON mode) strips the color to plain text automatically.
+ */
+export declare function pill(label: string, kind?: 'info' | 'warn'): string;
+/**
+ * Branded title line, framed by blank lines. With a subtitle it renders
+ * `Title · subtitle` (accent-bold name, dim subtitle) — the dad-style header.
+ */
+declare function intro(title: string, subtitle?: string): void;
+/** Closing line. */
+declare function outro(message?: string): void;
+/** A titled section header — anchors a "moment" that owns several lines. */
+declare function heading(title: string): void;
+/** Multi-line indented note (body dim, framed by blank lines). */
+declare function note(message: string): void;
+export type RowStatusKind = 'ok' | 'muted' | 'warn';
+export interface Row {
+    key: string;
+    value: string;
+    /** Optional trailing status word (e.g. "created", "already set", "updated"). */
+    status?: string;
+    /** How to color the status word. Defaults to 'muted'. */
+    statusKind?: RowStatusKind;
+}
+/**
+ * Print a set of aligned key/value rows (leading ✓, dim key padded to the
+ * widest key in the set, accent value, optional colored status). Alignment is a
+ * property of the whole set, so callers pass every row at once.
+ */
+declare function rows(items: Row[]): void;
+export interface Spinner {
+    start: (message?: string) => void;
+    message: (message: string) => void;
+    stop: (message?: string, code?: number) => void;
+    /** Halt and erase the spinner line WITHOUT printing a final status line. */
+    clear: () => void;
+}
+/** spinner: start(msg) / message(msg) / stop(msg, code). */
+declare function spinner(): Spinner;
+/**
+ * Returned by a prompt when the user cancels (ctrl-c) or a signal aborts it.
+ * Typed as a plain `symbol` (not `unique symbol`) to preserve the exact
+ * generic-inference behavior at call sites like `assertNotCancelled<T>(v: T | symbol)`.
+ */
+export declare const CANCEL: symbol;
+/** Type guard that narrows a prompt result to a non-cancel value. */
+export declare function isCancel(value: unknown): value is symbol;
+/** Print a cancellation line. */
+export declare function cancel(message?: string): void;
+/**
+ * Thrown when a prompt is attempted where the user cannot answer: machine
+ * (`--json`) output, or a non-interactive stdin (piped / no TTY). Previously
+ * these either corrupted machine output or hung forever waiting on a stdin that
+ * never delivers a keystroke. Callers that reach this generally have an upstream
+ * gap (they should have gated on isPromptAllowed()/isJsonMode() and offered a
+ * flag) — surfacing it fails fast with a clear next step instead of hanging.
+ */
+export declare class PromptUnavailableError extends Error {
+    readonly reason: 'json' | 'no-tty';
+    constructor(reason: 'json' | 'no-tty', message: string);
+}
+/**
+ * Adapt the validate contract (return error string / Error when invalid,
+ * undefined when valid) to @inquirer's (return true when valid, string when not).
+ */
+type ValidateFn = (value: string) => string | Error | undefined | void | Promise<string | Error | undefined | void>;
+interface ConfirmOptions {
+    message: string;
+    initialValue?: boolean;
+    signal?: AbortSignal;
+}
+declare function confirm(options: ConfirmOptions): Promise<boolean | symbol>;
+interface SelectOption<T> {
+    value: T;
+    label?: string;
+    hint?: string;
+}
+interface SelectOptions<T> {
+    message: string;
+    options: ReadonlyArray<SelectOption<T>>;
+    initialValue?: T;
+    maxItems?: number;
+    signal?: AbortSignal;
+}
+declare function select<T>(options: SelectOptions<T>): Promise<T | symbol>;
+interface TextOptions {
+    message: string;
+    placeholder?: string;
+    defaultValue?: string;
+    initialValue?: string;
+    validate?: ValidateFn;
+    signal?: AbortSignal;
+}
+declare function text(options: TextOptions): Promise<string | symbol>;
+interface PasswordOptions {
+    message: string;
+    validate?: ValidateFn;
+    signal?: AbortSignal;
+}
+declare function password(options: PasswordOptions): Promise<string | symbol>;
+declare const ui: {
+    intro: typeof intro;
+    outro: typeof outro;
+    heading: typeof heading;
+    note: typeof note;
+    rows: typeof rows;
+    pill: typeof pill;
+    log: {
+        info: (m: string) => void;
+        step: (m: string) => void;
+        success: (m: string) => void;
+        warn: (m: string) => void;
+        warning: (m: string) => void;
+        error: (m: string) => void;
+        /** A muted, low-priority aside (opt-out hints, "run X later"). One dim line. */
+        hint: (m: string) => void;
+        /** A nested sub-step, indented one level under its parent line. */
+        detail: (m: string) => void;
+    };
+    spinner: typeof spinner;
+    confirm: typeof confirm;
+    select: typeof select;
+    text: typeof text;
+    password: typeof password;
+    isCancel: typeof isCancel;
+    cancel: typeof cancel;
+};
+export default ui;