@kubb/cli 5.0.0-alpha.9 → 5.0.0-beta.10

package/dist/run-YsoCk5we.cjs

@@ -0,0 +1,248 @@
+const require_chunk = require("./chunk-ByKO4r7w.cjs");
+const require_shell = require("./shell-475fQKaX.cjs");
+const require_constants = require("./constants-BYGmiFs0.cjs");
+let node_util = require("node:util");
+let node_fs = require("node:fs");
+node_fs = require_chunk.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_chunk.__toESM(node_path, 1);
+let node_process = require("node:process");
+node_process = require_chunk.__toESM(node_process, 1);
+let _clack_prompts = require("@clack/prompts");
+_clack_prompts = require_chunk.__toESM(_clack_prompts, 1);
+//#region ../../internals/utils/src/packageManager.ts
+/**
+* Metadata for each supported package manager, keyed by its short name.
+*
+* @example
+* ```ts
+* packageManagers.pnpm.installCommand // ['add', '-D']
+* packageManagers.npm.lockFile        // 'package-lock.json'
+* ```
+*/
+const packageManagers = {
+	pnpm: {
+		name: "pnpm",
+		lockFile: "pnpm-lock.yaml",
+		installCommand: ["add", "-D"]
+	},
+	yarn: {
+		name: "yarn",
+		lockFile: "yarn.lock",
+		installCommand: ["add", "-D"]
+	},
+	bun: {
+		name: "bun",
+		lockFile: "bun.lockb",
+		installCommand: ["add", "-d"]
+	},
+	npm: {
+		name: "npm",
+		lockFile: "package-lock.json",
+		installCommand: ["install", "--save-dev"]
+	}
+};
+/**
+* Detects the active package manager for the given directory.
+* Resolution order: `packageManager` field in `package.json`, then presence of a lock file.
+* Falls back to `npm` when no signal is found.
+*
+* @example
+* ```ts
+* detectPackageManager('/my/project') // { name: 'pnpm', lockFile: 'pnpm-lock.yaml', ... }
+* detectPackageManager()              // falls back to npm when no lock file is found
+* ```
+*/
+function detectPackageManager(cwd = process.cwd()) {
+	const packageJsonPath = (0, node_path.join)(cwd, "package.json");
+	if ((0, node_fs.existsSync)(packageJsonPath)) try {
+		const pmField = JSON.parse((0, node_fs.readFileSync)(packageJsonPath, "utf-8")).packageManager;
+		if (typeof pmField === "string") {
+			const name = pmField.split("@")[0];
+			if (name && name in packageManagers) return packageManagers[name];
+		}
+	} catch {}
+	for (const pm of Object.values(packageManagers)) if ((0, node_fs.existsSync)((0, node_path.join)(cwd, pm.lockFile))) return pm;
+	return packageManagers.npm;
+}
+//#endregion
+//#region ../../internals/shared/src/init.ts
+function generateConfigFile({ selectedPlugins, inputPath, outputPath }) {
+	return `import { defineConfig } from 'kubb'
+${selectedPlugins.map((plugin) => `import { ${plugin.importName} } from '${plugin.packageName}'`).join("\n")}
+
+export default defineConfig({
+  root: '.',
+  input: {
+    path: '${inputPath}',
+  },
+  output: {
+    path: '${outputPath}',
+    clean: true,
+  },
+  plugins: [
+${selectedPlugins.map((plugin) => {
+		return `    ${require_constants.pluginDefaultConfigs[plugin.value] ?? `${plugin.importName}()`},`;
+	}).join("\n")}
+  ],
+})
+`;
+}
+//#endregion
+//#region src/runners/init/utils.ts
+/**
+* Returns `true` when a `package.json` exists at `cwd`.
+*/
+function hasPackageJson(cwd = node_process.default.cwd()) {
+	return node_fs.default.existsSync(node_path.default.join(cwd, "package.json"));
+}
+/**
+* Initializes a new `package.json` at `cwd` using the detected package manager.
+*/
+async function initPackageJson(cwd, packageManager) {
+	await require_shell.spawnAsync(packageManager.name, {
+		npm: ["init", "-y"],
+		pnpm: ["init"],
+		yarn: ["init", "-y"],
+		bun: ["init", "-y"]
+	}[packageManager.name], { cwd });
+}
+/**
+* Installs the given packages at `cwd` using the detected package manager.
+*/
+async function installPackages(packages, packageManager, cwd = node_process.default.cwd()) {
+	await require_shell.spawnAsync(packageManager.name, [...packageManager.installCommand, ...packages], { cwd });
+}
+//#endregion
+//#region src/runners/init/run.ts
+function cancelAndExit(message = "Operation cancelled.") {
+	_clack_prompts.cancel(message);
+	node_process.default.exit(0);
+}
+/**
+* Runs the interactive Kubb scaffolding wizard.
+* Detects the package manager, prompts for input/output paths and plugins, installs packages, and writes `kubb.config.ts`.
+* Pass `yes: true` to skip all prompts and use defaults.
+*/
+async function run({ yes, version, input: inputFlag, output: outputFlag, plugins: pluginsFlag }) {
+	const cwd = node_process.default.cwd();
+	_clack_prompts.intro((0, node_util.styleText)("bgCyan", (0, node_util.styleText)("black", " Kubb Init ")));
+	/**
+	* Returns `flag` when provided, the `defaultValue` when `yes` is set,
+	* or calls `prompt()` for interactive input. Exits on cancellation.
+	*/
+	async function resolveOrPrompt(flag, defaultValue, logLabel, prompt) {
+		if (flag !== void 0) {
+			_clack_prompts.log.info(`${logLabel}: ${(0, node_util.styleText)("cyan", String(flag))}`);
+			return flag;
+		}
+		if (yes) {
+			_clack_prompts.log.info(`${logLabel}: ${(0, node_util.styleText)("cyan", String(defaultValue))}`);
+			return defaultValue;
+		}
+		const result = await prompt();
+		if (_clack_prompts.isCancel(result)) cancelAndExit();
+		return result;
+	}
+	try {
+		if (!hasPackageJson(cwd)) {
+			if (!yes) {
+				const shouldInit = await _clack_prompts.confirm({
+					message: "No package.json found. Would you like to create one?",
+					initialValue: true
+				});
+				if (_clack_prompts.isCancel(shouldInit) || !shouldInit) cancelAndExit();
+			}
+			const packageManager = detectPackageManager(cwd);
+			const spinner = _clack_prompts.spinner();
+			spinner.start(`Initializing package.json with ${packageManager.name}`);
+			await initPackageJson(cwd, packageManager);
+			spinner.stop(`Created package.json with ${packageManager.name}`);
+		}
+		const packageManager = detectPackageManager(cwd);
+		if (hasPackageJson(cwd)) _clack_prompts.log.info(`Detected package manager: ${(0, node_util.styleText)("cyan", packageManager.name)}`);
+		const inputPath = await resolveOrPrompt(inputFlag, require_constants.initDefaults.inputPath, "Using input path", () => _clack_prompts.text({
+			message: "Where is your OpenAPI specification located?",
+			placeholder: require_constants.initDefaults.inputPath,
+			defaultValue: require_constants.initDefaults.inputPath,
+			validate: (value) => {
+				if (!value) return "Input path is required";
+			}
+		}));
+		const outputPath = await resolveOrPrompt(outputFlag, require_constants.initDefaults.outputPath, "Using output path", () => _clack_prompts.text({
+			message: "Where should the generated files be output?",
+			placeholder: require_constants.initDefaults.outputPath,
+			defaultValue: require_constants.initDefaults.outputPath,
+			validate: (value) => {
+				if (!value) return "Output path is required";
+			}
+		}));
+		const defaultPlugins = require_constants.availablePlugins.filter((p) => require_constants.initDefaults.plugins.includes(p.value));
+		const pluginLabel = (plugins) => (0, node_util.styleText)("cyan", plugins.map((p) => p.label).join(", "));
+		let selectedPlugins;
+		if (pluginsFlag) {
+			const requested = pluginsFlag.split(",").map((v) => v.trim()).filter(Boolean);
+			selectedPlugins = require_constants.availablePlugins.filter((p) => requested.includes(p.value));
+			if (selectedPlugins.length === 0) {
+				selectedPlugins = defaultPlugins;
+				_clack_prompts.log.warn(`No valid plugins found in --plugins value; falling back to default: ${pluginLabel(defaultPlugins)}`);
+			} else _clack_prompts.log.info(`Using plugins: ${pluginLabel(selectedPlugins)}`);
+		} else if (yes) {
+			selectedPlugins = defaultPlugins;
+			_clack_prompts.log.info(`Using plugins: ${pluginLabel(defaultPlugins)}`);
+		} else {
+			const values = await _clack_prompts.multiselect({
+				message: "Select plugins to use:",
+				options: require_constants.availablePlugins.map(({ value, label, hint }) => ({
+					value,
+					label,
+					hint
+				})),
+				initialValues: [...require_constants.initDefaults.plugins],
+				required: true
+			});
+			if (_clack_prompts.isCancel(values)) cancelAndExit();
+			selectedPlugins = require_constants.availablePlugins.filter((p) => values.includes(p.value));
+		}
+		const packagesToInstall = ["kubb", ...selectedPlugins.map((p) => p.packageName)];
+		const spinner = _clack_prompts.spinner();
+		spinner.start(`Installing ${packagesToInstall.length} packages with ${packageManager.name}`);
+		try {
+			await installPackages(packagesToInstall, packageManager, cwd);
+			spinner.stop(`Installed ${packagesToInstall.length} packages`);
+		} catch (error) {
+			spinner.stop("Installation failed");
+			throw error;
+		}
+		const configSpinner = _clack_prompts.spinner();
+		configSpinner.start(`Creating ${require_constants.KUBB_CONFIG_FILENAME}`);
+		const configContent = generateConfigFile({
+			selectedPlugins,
+			inputPath,
+			outputPath
+		});
+		const configPath = node_path.default.join(cwd, require_constants.KUBB_CONFIG_FILENAME);
+		if (node_fs.default.existsSync(configPath)) {
+			configSpinner.stop(`${require_constants.KUBB_CONFIG_FILENAME} already exists`);
+			if (!yes) {
+				const shouldOverwrite = await _clack_prompts.confirm({
+					message: `${require_constants.KUBB_CONFIG_FILENAME} already exists. Overwrite?`,
+					initialValue: false
+				});
+				if (_clack_prompts.isCancel(shouldOverwrite) || !shouldOverwrite) cancelAndExit("Keeping existing configuration. Packages have been installed.");
+			}
+			configSpinner.start(`Overwriting ${require_constants.KUBB_CONFIG_FILENAME}`);
+		}
+		await node_fs.default.promises.writeFile(configPath, configContent, "utf-8");
+		configSpinner.stop(`Created ${require_constants.KUBB_CONFIG_FILENAME}`);
+		_clack_prompts.outro((0, node_util.styleText)("green", "✓ All set!") + "\n\n" + (0, node_util.styleText)("dim", "Next steps:") + "\n" + (0, node_util.styleText)("cyan", `  1. Make sure your OpenAPI spec is at: ${inputPath}`) + "\n" + (0, node_util.styleText)("cyan", "  2. Generate code with: npx kubb generate") + "\n" + (0, node_util.styleText)("cyan", "     Or start a stream server with: npx kubb agent start") + "\n" + (0, node_util.styleText)("cyan", `  3. Find generated files in: ${outputPath}`) + "\n\n" + (0, node_util.styleText)("dim", `Using ${packageManager.name} • Kubb v${version}`));
+	} catch (error) {
+		_clack_prompts.log.error((0, node_util.styleText)("red", "An error occurred during initialization"));
+		if (error instanceof Error) _clack_prompts.log.error(error.message);
+		node_process.default.exit(1);
+	}
+}
+//#endregion
+exports.run = run;
+
+//# sourceMappingURL=run-YsoCk5we.cjs.map

package/dist/run-YsoCk5we.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-YsoCk5we.cjs","names":["pluginDefaultConfigs","process","fs","path","spawnAsync","process","clack","initDefaults","availablePlugins","KUBB_CONFIG_FILENAME","path","fs"],"sources":["../../../internals/utils/src/packageManager.ts","../../../internals/shared/src/init.ts","../src/runners/init/utils.ts","../src/runners/init/run.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport { join } from 'node:path'\n\n/**\n * Supported package manager identifiers.\n *\n * @example\n * ```ts\n * const pm: PackageManagerName = 'pnpm'\n * ```\n */\nexport type PackageManagerName = 'npm' | 'pnpm' | 'yarn' | 'bun'\n\n/**\n * Metadata describing a package manager's lock file and install command.\n */\nexport interface PackageManagerInfo {\n  /**\n   * Identifier used in CLI commands, e.g. `pnpm`, `yarn`.\n   */\n  name: PackageManagerName\n  /**\n   * Lock file name that uniquely identifies this package manager in a project root.\n   */\n  lockFile: string\n  /**\n   * Subcommands passed to the package manager binary to install a dev dependency.\n   */\n  installCommand: ReadonlyArray<string>\n}\n/**\n * Metadata for each supported package manager, keyed by its short name.\n *\n * @example\n * ```ts\n * packageManagers.pnpm.installCommand // ['add', '-D']\n * packageManagers.npm.lockFile        // 'package-lock.json'\n * ```\n */\nconst packageManagers: Record<PackageManagerName, PackageManagerInfo> = {\n  pnpm: {\n    name: 'pnpm',\n    lockFile: 'pnpm-lock.yaml',\n    installCommand: ['add', '-D'],\n  },\n  yarn: {\n    name: 'yarn',\n    lockFile: 'yarn.lock',\n    installCommand: ['add', '-D'],\n  },\n  bun: {\n    name: 'bun',\n    lockFile: 'bun.lockb',\n    installCommand: ['add', '-d'],\n  },\n  npm: {\n    name: 'npm',\n    lockFile: 'package-lock.json',\n    installCommand: ['install', '--save-dev'],\n  },\n}\n\n/**\n * Minimal shape of `package.json` fields read during detection.\n */\ntype PackageJson = {\n  /**\n   * The `packageManager` field from `package.json` (e.g. `\"pnpm@9.0.0\"`).\n   */\n  packageManager?: string\n}\n\n/**\n * Detects the active package manager for the given directory.\n * Resolution order: `packageManager` field in `package.json`, then presence of a lock file.\n * Falls back to `npm` when no signal is found.\n *\n * @example\n * ```ts\n * detectPackageManager('/my/project') // { name: 'pnpm', lockFile: 'pnpm-lock.yaml', ... }\n * detectPackageManager()              // falls back to npm when no lock file is found\n * ```\n */\nexport function detectPackageManager(cwd: string = process.cwd()): PackageManagerInfo {\n  const packageJsonPath = join(cwd, 'package.json')\n  if (existsSync(packageJsonPath)) {\n    try {\n      const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8')) as PackageJson\n      const pmField = packageJson.packageManager\n      if (typeof pmField === 'string') {\n        const name = pmField.split('@')[0]\n        if (name && name in packageManagers) {\n          return packageManagers[name as PackageManagerName]\n        }\n      }\n    } catch {\n      // Continue to lock file detection\n    }\n  }\n\n  for (const pm of Object.values(packageManagers)) {\n    if (existsSync(join(cwd, pm.lockFile))) {\n      return pm\n    }\n  }\n\n  return packageManagers.npm\n}\n","import { pluginDefaultConfigs } from './constants.ts'\nimport type { PluginOption } from './types.ts'\n\nexport function generateConfigFile({\n  selectedPlugins,\n  inputPath,\n  outputPath,\n}: {\n  selectedPlugins: PluginOption[]\n  inputPath: string\n  outputPath: string\n}): string {\n  const imports = selectedPlugins.map((plugin) => `import { ${plugin.importName} } from '${plugin.packageName}'`).join('\\n')\n\n  const pluginConfigs = selectedPlugins\n    .map((plugin) => {\n      const config = (pluginDefaultConfigs as Record<string, string>)[plugin.value] ?? `${plugin.importName}()`\n      return `    ${config},`\n    })\n    .join('\\n')\n\n  return `import { defineConfig } from 'kubb'\n${imports}\n\nexport default defineConfig({\n  root: '.',\n  input: {\n    path: '${inputPath}',\n  },\n  output: {\n    path: '${outputPath}',\n    clean: true,\n  },\n  plugins: [\n${pluginConfigs}\n  ],\n})\n`\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport process from 'node:process'\nimport type { PackageManagerInfo, PackageManagerName } from '@internals/utils'\nimport { spawnAsync } from '@internals/utils'\n\n/**\n * Returns `true` when a `package.json` exists at `cwd`.\n */\nexport function hasPackageJson(cwd: string = process.cwd()): boolean {\n  return fs.existsSync(path.join(cwd, 'package.json'))\n}\n\n/**\n * Initializes a new `package.json` at `cwd` using the detected package manager.\n */\nexport async function initPackageJson(cwd: string, packageManager: PackageManagerInfo): Promise<void> {\n  const commands: Record<PackageManagerName, string[]> = {\n    npm: ['init', '-y'],\n    pnpm: ['init'],\n    yarn: ['init', '-y'],\n    bun: ['init', '-y'],\n  }\n\n  await spawnAsync(packageManager.name, commands[packageManager.name], { cwd })\n}\n\n/**\n * Installs the given packages at `cwd` using the detected package manager.\n */\nexport async function installPackages(packages: string[], packageManager: PackageManagerInfo, cwd: string = process.cwd()): Promise<void> {\n  await spawnAsync(packageManager.name, [...packageManager.installCommand, ...packages], { cwd })\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { styleText } from 'node:util'\nimport * as clack from '@clack/prompts'\nimport { detectPackageManager } from '@internals/utils'\nimport { availablePlugins, generateConfigFile, initDefaults, KUBB_CONFIG_FILENAME, type PluginOption } from '@internals/shared'\nimport { hasPackageJson, initPackageJson, installPackages } from './utils.ts'\n\nfunction cancelAndExit(message = 'Operation cancelled.'): never {\n  clack.cancel(message)\n  process.exit(0)\n}\n\ntype InitOptions = {\n  /**\n   * When `true`, skips all interactive prompts and uses default values.\n   */\n  yes: boolean\n  /**\n   * Current `@kubb/cli` version string, shown in the outro and used for package installation.\n   */\n  version: string\n  /**\n   * Input path flag value from `--input`. When provided, skips the input prompt.\n   */\n  input?: string\n  /**\n   * Output directory flag value from `--output`. When provided, skips the output prompt.\n   */\n  output?: string\n  /**\n   * Comma-separated plugin list from `--plugins`, e.g. `'plugin-ts,plugin-zod'`. When provided, skips the plugin selection prompt.\n   */\n  plugins?: string\n}\n\n/**\n * Runs the interactive Kubb scaffolding wizard.\n * Detects the package manager, prompts for input/output paths and plugins, installs packages, and writes `kubb.config.ts`.\n * Pass `yes: true` to skip all prompts and use defaults.\n */\nexport async function run({ yes, version, input: inputFlag, output: outputFlag, plugins: pluginsFlag }: InitOptions): Promise<void> {\n  const cwd = process.cwd()\n\n  clack.intro(styleText('bgCyan', styleText('black', ' Kubb Init ')))\n\n  /**\n   * Returns `flag` when provided, the `defaultValue` when `yes` is set,\n   * or calls `prompt()` for interactive input. Exits on cancellation.\n   */\n  async function resolveOrPrompt<T>(flag: T | undefined, defaultValue: T, logLabel: string, prompt: () => Promise<T | symbol>): Promise<T> {\n    if (flag !== undefined) {\n      clack.log.info(`${logLabel}: ${styleText('cyan', String(flag))}`)\n      return flag\n    }\n    if (yes) {\n      clack.log.info(`${logLabel}: ${styleText('cyan', String(defaultValue))}`)\n      return defaultValue\n    }\n    const result = await prompt()\n    if (clack.isCancel(result)) cancelAndExit()\n    return result as T\n  }\n\n  try {\n    // Check/create package.json — detect package manager once after the block\n    if (!hasPackageJson(cwd)) {\n      if (!yes) {\n        const shouldInit = await clack.confirm({\n          message: 'No package.json found. Would you like to create one?',\n          initialValue: true,\n        })\n\n        if (clack.isCancel(shouldInit) || !shouldInit) {\n          cancelAndExit()\n        }\n      }\n\n      const packageManager = detectPackageManager(cwd)\n      const spinner = clack.spinner()\n      spinner.start(`Initializing package.json with ${packageManager.name}`)\n      await initPackageJson(cwd, packageManager)\n      spinner.stop(`Created package.json with ${packageManager.name}`)\n    }\n\n    const packageManager = detectPackageManager(cwd)\n    if (hasPackageJson(cwd)) {\n      clack.log.info(`Detected package manager: ${styleText('cyan', packageManager.name)}`)\n    }\n\n    // Prompt for OpenAPI spec path\n    const inputPath = await resolveOrPrompt(inputFlag, initDefaults.inputPath, 'Using input path', () =>\n      clack.text({\n        message: 'Where is your OpenAPI specification located?',\n        placeholder: initDefaults.inputPath,\n        defaultValue: initDefaults.inputPath,\n        validate: (value) => {\n          if (!value) return 'Input path is required'\n        },\n      }),\n    )\n\n    // Prompt for output directory\n    const outputPath = await resolveOrPrompt(outputFlag, initDefaults.outputPath, 'Using output path', () =>\n      clack.text({\n        message: 'Where should the generated files be output?',\n        placeholder: initDefaults.outputPath,\n        defaultValue: initDefaults.outputPath,\n        validate: (value) => {\n          if (!value) return 'Output path is required'\n        },\n      }),\n    )\n\n    // Plugin selection\n    const defaultPlugins = availablePlugins.filter((p) => (initDefaults.plugins as readonly string[]).includes(p.value))\n    const pluginLabel = (plugins: PluginOption[]) => styleText('cyan', plugins.map((p) => p.label).join(', '))\n\n    let selectedPlugins: PluginOption[]\n    if (pluginsFlag) {\n      const requested = pluginsFlag\n        .split(',')\n        .map((v) => v.trim())\n        .filter(Boolean)\n      selectedPlugins = availablePlugins.filter((p) => requested.includes(p.value))\n      if (selectedPlugins.length === 0) {\n        selectedPlugins = defaultPlugins\n        clack.log.warn(`No valid plugins found in --plugins value; falling back to default: ${pluginLabel(defaultPlugins)}`)\n      } else {\n        clack.log.info(`Using plugins: ${pluginLabel(selectedPlugins)}`)\n      }\n    } else if (yes) {\n      selectedPlugins = defaultPlugins\n      clack.log.info(`Using plugins: ${pluginLabel(defaultPlugins)}`)\n    } else {\n      const values = await clack.multiselect({\n        message: 'Select plugins to use:',\n        options: availablePlugins.map(({ value, label, hint }) => ({ value, label, hint })),\n        initialValues: [...initDefaults.plugins],\n        required: true,\n      })\n      if (clack.isCancel(values)) cancelAndExit()\n      selectedPlugins = availablePlugins.filter((p) => (values as string[]).includes(p.value))\n    }\n\n    // Install packages\n    const packagesToInstall = ['kubb', ...selectedPlugins.map((p) => p.packageName)]\n\n    const spinner = clack.spinner()\n    spinner.start(`Installing ${packagesToInstall.length} packages with ${packageManager.name}`)\n\n    try {\n      await installPackages(packagesToInstall, packageManager, cwd)\n      spinner.stop(`Installed ${packagesToInstall.length} packages`)\n    } catch (error) {\n      spinner.stop('Installation failed')\n      throw error\n    }\n\n    // Generate config file\n    const configSpinner = clack.spinner()\n    configSpinner.start(`Creating ${KUBB_CONFIG_FILENAME}`)\n\n    const configContent = generateConfigFile({ selectedPlugins, inputPath, outputPath })\n    const configPath = path.join(cwd, KUBB_CONFIG_FILENAME)\n\n    if (fs.existsSync(configPath)) {\n      configSpinner.stop(`${KUBB_CONFIG_FILENAME} already exists`)\n\n      if (!yes) {\n        const shouldOverwrite = await clack.confirm({\n          message: `${KUBB_CONFIG_FILENAME} already exists. Overwrite?`,\n          initialValue: false,\n        })\n\n        if (clack.isCancel(shouldOverwrite) || !shouldOverwrite) {\n          cancelAndExit('Keeping existing configuration. Packages have been installed.')\n        }\n      }\n\n      configSpinner.start(`Overwriting ${KUBB_CONFIG_FILENAME}`)\n    }\n\n    await fs.promises.writeFile(configPath, configContent, 'utf-8')\n\n    configSpinner.stop(`Created ${KUBB_CONFIG_FILENAME}`)\n\n    clack.outro(\n      styleText('green', '✓ All set!') +\n        '\\n\\n' +\n        styleText('dim', 'Next steps:') +\n        '\\n' +\n        styleText('cyan', `  1. Make sure your OpenAPI spec is at: ${inputPath}`) +\n        '\\n' +\n        styleText('cyan', '  2. Generate code with: npx kubb generate') +\n        '\\n' +\n        styleText('cyan', '     Or start a stream server with: npx kubb agent start') +\n        '\\n' +\n        styleText('cyan', `  3. Find generated files in: ${outputPath}`) +\n        '\\n\\n' +\n        styleText('dim', `Using ${packageManager.name} • Kubb v${version}`),\n    )\n  } catch (error) {\n    clack.log.error(styleText('red', 'An error occurred during initialization'))\n    if (error instanceof Error) {\n      clack.log.error(error.message)\n    }\n    process.exit(1)\n  }\n}\n"],"mappings":"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"}

package/dist/{shell-7HPrTCJ5.cjs → shell-475fQKaX.cjs}

@@ -15,8 +15,13 @@ function tokenize(command) {
 * Spawns `cmd` with `args` and returns a promise that settles when the child process finishes.
 *
 * Foreground mode (default) inherits the parent's stdio and rejects on non-zero exit or signal.
-* Detached mode spawns the child in its own process group, unref's it, and resolves immediately —
-* the parent can exit without waiting for the child.
+* Detached mode spawns the child in its own process group, unref's it, and resolves immediately.
+*
+* @example
+* ```ts
+* await spawnAsync('pnpm', ['install'])
+* await spawnAsync('node', ['server.js'], { detached: true }) // fire-and-forget
+* ```
 */
 function spawnAsync(cmd, args, options = {}) {
 	const { cwd = process.cwd(), env, detached = false } = options;
@@ -54,4 +59,4 @@ Object.defineProperty(exports, "tokenize", {
 	}
 });
 
-//# sourceMappingURL=shell-7HPrTCJ5.cjs.map
+//# sourceMappingURL=shell-475fQKaX.cjs.map

package/dist/shell-475fQKaX.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-475fQKaX.cjs","names":[],"sources":["../../../internals/utils/src/shell.ts"],"sourcesContent":["import { spawn } from 'node:child_process'\n\n/**\n * Tokenizes a shell command string, respecting single and double quotes.\n *\n * @example\n * tokenize('git commit -m \"initial commit\"')\n * // → ['git', 'commit', '-m', 'initial commit']\n */\nexport function tokenize(command: string): string[] {\n  return (command.match(/[^\\s\"']+|\"([^\"]*)\"|'([^']*)'/g) ?? []).map((token) => token.replace(/^[\"']|[\"']$/g, ''))\n}\n\ntype SpawnOptions = {\n  /**\n   * Working directory for the child process.\n   * @default process.cwd()\n   */\n  cwd?: string\n  /**\n   * Environment variables passed to the child process.\n   * @default process.env\n   */\n  env?: NodeJS.ProcessEnv\n  /**\n   * When `true`, spawns a detached background process and resolves immediately.\n   * The child is unref'd so the parent process can exit independently.\n   * @default false\n   */\n  detached?: boolean\n}\n\n/**\n * Spawns `cmd` with `args` and returns a promise that settles when the child process finishes.\n *\n * Foreground mode (default) inherits the parent's stdio and rejects on non-zero exit or signal.\n * Detached mode spawns the child in its own process group, unref's it, and resolves immediately.\n *\n * @example\n * ```ts\n * await spawnAsync('pnpm', ['install'])\n * await spawnAsync('node', ['server.js'], { detached: true }) // fire-and-forget\n * ```\n */\nexport function spawnAsync(cmd: string, args: string[], options: SpawnOptions = {}): Promise<void> {\n  const { cwd = process.cwd(), env, detached = false } = options\n\n  return new Promise((resolve, reject) => {\n    const child = spawn(cmd, args, {\n      stdio: detached ? 'ignore' : 'inherit',\n      cwd,\n      env,\n      detached,\n    })\n\n    if (detached) {\n      child.unref()\n      resolve()\n      return\n    }\n\n    child.on('close', (code, signal) => {\n      if (code === 0) {\n        resolve()\n      } else if (signal !== null) {\n        reject(new Error(`\"${cmd} ${args.join(' ')}\" was terminated by signal ${signal}`))\n      } else {\n        reject(new Error(`\"${cmd} ${args.join(' ')}\" exited with code ${code}`))\n      }\n    })\n    child.on('error', reject)\n  })\n}\n"],"mappings":";;;;;;;;;;AASA,SAAgB,SAAS,SAA2B;CAClD,QAAQ,QAAQ,MAAM,gCAAgC,IAAI,EAAE,EAAE,KAAK,UAAU,MAAM,QAAQ,gBAAgB,GAAG,CAAC;;;;;;;;;;;;;;AAkCjH,SAAgB,WAAW,KAAa,MAAgB,UAAwB,EAAE,EAAiB;CACjG,MAAM,EAAE,MAAM,QAAQ,KAAK,EAAE,KAAK,WAAW,UAAU;CAEvD,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,SAAA,GAAA,mBAAA,OAAc,KAAK,MAAM;GAC7B,OAAO,WAAW,WAAW;GAC7B;GACA;GACA;GACD,CAAC;EAEF,IAAI,UAAU;GACZ,MAAM,OAAO;GACb,SAAS;GACT;;EAGF,MAAM,GAAG,UAAU,MAAM,WAAW;GAClC,IAAI,SAAS,GACX,SAAS;QACJ,IAAI,WAAW,MACpB,uBAAO,IAAI,MAAM,IAAI,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,6BAA6B,SAAS,CAAC;QAElF,uBAAO,IAAI,MAAM,IAAI,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,qBAAqB,OAAO,CAAC;IAE1E;EACF,MAAM,GAAG,SAAS,OAAO;GACzB"}

package/dist/{shell-DqqWsHCD.js → shell-CN6DNqeC.js}

@@ -1,4 +1,4 @@
-import "./chunk--u3MIqq1.js";
+import "./chunk-BvFE5Tac.js";
 import { spawn } from "node:child_process";
 //#region ../../internals/utils/src/shell.ts
 /**
@@ -15,8 +15,13 @@ function tokenize(command) {
 * Spawns `cmd` with `args` and returns a promise that settles when the child process finishes.
 *
 * Foreground mode (default) inherits the parent's stdio and rejects on non-zero exit or signal.
-* Detached mode spawns the child in its own process group, unref's it, and resolves immediately —
-* the parent can exit without waiting for the child.
+* Detached mode spawns the child in its own process group, unref's it, and resolves immediately.
+*
+* @example
+* ```ts
+* await spawnAsync('pnpm', ['install'])
+* await spawnAsync('node', ['server.js'], { detached: true }) // fire-and-forget
+* ```
 */
 function spawnAsync(cmd, args, options = {}) {
 	const { cwd = process.cwd(), env, detached = false } = options;
@@ -43,4 +48,4 @@ function spawnAsync(cmd, args, options = {}) {
 //#endregion
 export { tokenize as n, spawnAsync as t };
 
-//# sourceMappingURL=shell-DqqWsHCD.js.map
+//# sourceMappingURL=shell-CN6DNqeC.js.map

package/dist/shell-CN6DNqeC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-CN6DNqeC.js","names":[],"sources":["../../../internals/utils/src/shell.ts"],"sourcesContent":["import { spawn } from 'node:child_process'\n\n/**\n * Tokenizes a shell command string, respecting single and double quotes.\n *\n * @example\n * tokenize('git commit -m \"initial commit\"')\n * // → ['git', 'commit', '-m', 'initial commit']\n */\nexport function tokenize(command: string): string[] {\n  return (command.match(/[^\\s\"']+|\"([^\"]*)\"|'([^']*)'/g) ?? []).map((token) => token.replace(/^[\"']|[\"']$/g, ''))\n}\n\ntype SpawnOptions = {\n  /**\n   * Working directory for the child process.\n   * @default process.cwd()\n   */\n  cwd?: string\n  /**\n   * Environment variables passed to the child process.\n   * @default process.env\n   */\n  env?: NodeJS.ProcessEnv\n  /**\n   * When `true`, spawns a detached background process and resolves immediately.\n   * The child is unref'd so the parent process can exit independently.\n   * @default false\n   */\n  detached?: boolean\n}\n\n/**\n * Spawns `cmd` with `args` and returns a promise that settles when the child process finishes.\n *\n * Foreground mode (default) inherits the parent's stdio and rejects on non-zero exit or signal.\n * Detached mode spawns the child in its own process group, unref's it, and resolves immediately.\n *\n * @example\n * ```ts\n * await spawnAsync('pnpm', ['install'])\n * await spawnAsync('node', ['server.js'], { detached: true }) // fire-and-forget\n * ```\n */\nexport function spawnAsync(cmd: string, args: string[], options: SpawnOptions = {}): Promise<void> {\n  const { cwd = process.cwd(), env, detached = false } = options\n\n  return new Promise((resolve, reject) => {\n    const child = spawn(cmd, args, {\n      stdio: detached ? 'ignore' : 'inherit',\n      cwd,\n      env,\n      detached,\n    })\n\n    if (detached) {\n      child.unref()\n      resolve()\n      return\n    }\n\n    child.on('close', (code, signal) => {\n      if (code === 0) {\n        resolve()\n      } else if (signal !== null) {\n        reject(new Error(`\"${cmd} ${args.join(' ')}\" was terminated by signal ${signal}`))\n      } else {\n        reject(new Error(`\"${cmd} ${args.join(' ')}\" exited with code ${code}`))\n      }\n    })\n    child.on('error', reject)\n  })\n}\n"],"mappings":";;;;;;;;;;AASA,SAAgB,SAAS,SAA2B;CAClD,QAAQ,QAAQ,MAAM,gCAAgC,IAAI,EAAE,EAAE,KAAK,UAAU,MAAM,QAAQ,gBAAgB,GAAG,CAAC;;;;;;;;;;;;;;AAkCjH,SAAgB,WAAW,KAAa,MAAgB,UAAwB,EAAE,EAAiB;CACjG,MAAM,EAAE,MAAM,QAAQ,KAAK,EAAE,KAAK,WAAW,UAAU;CAEvD,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,QAAQ,MAAM,KAAK,MAAM;GAC7B,OAAO,WAAW,WAAW;GAC7B;GACA;GACA;GACD,CAAC;EAEF,IAAI,UAAU;GACZ,MAAM,OAAO;GACb,SAAS;GACT;;EAGF,MAAM,GAAG,UAAU,MAAM,WAAW;GAClC,IAAI,SAAS,GACX,SAAS;QACJ,IAAI,WAAW,MACpB,uBAAO,IAAI,MAAM,IAAI,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,6BAA6B,SAAS,CAAC;QAElF,uBAAO,IAAI,MAAM,IAAI,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,qBAAqB,OAAO,CAAC;IAE1E;EACF,MAAM,GAAG,SAAS,OAAO;GACzB"}

package/dist/{telemetry-DZ7IrLAU.cjs → telemetry-B2iWkY5e.cjs}

@@ -1,14 +1,21 @@
 const require_chunk = require("./chunk-ByKO4r7w.cjs");
-const require_constants = require("./constants-D0XHAHeZ.cjs");
+const require_constants = require("./constants-BINTA5VZ.cjs");
 let node_crypto = require("node:crypto");
 let node_dns = require("node:dns");
 let node_os = require("node:os");
-node_os = require_chunk.__toESM(node_os);
+node_os = require_chunk.__toESM(node_os, 1);
 let node_process = require("node:process");
-node_process = require_chunk.__toESM(node_process);
+node_process = require_chunk.__toESM(node_process, 1);
 //#region ../../internals/utils/src/env.ts
 /**
 * Returns `true` when running inside a GitHub Actions workflow.
+*
+* @example
+* ```ts
+* if (isGitHubActions()) {
+*   core.setOutput('result', 'ok')
+* }
+* ```
 */
 function isGitHubActions() {
 	return !!process.env.GITHUB_ACTIONS;
@@ -17,19 +24,41 @@ function isGitHubActions() {
 * Returns `true` when the process is running in a CI environment.
 * Covers GitHub Actions, GitLab CI, CircleCI, Travis CI, Jenkins, Bitbucket,
 * TeamCity, Buildkite, and Azure Pipelines.
+*
+* @example
+* ```ts
+* if (isCIEnvironment()) {
+*   logger.level = 'error'
+* }
+* ```
 */
 function isCIEnvironment() {
 	return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.BITBUCKET_BUILD_NUMBER || process.env.JENKINS_URL || process.env.CIRCLECI || process.env.TRAVIS || process.env.TEAMCITY_VERSION || process.env.BUILDKITE || process.env.TF_BUILD);
 }
 /**
-* Returns `true` when the process has an interactive TTY and is not running in CI.
+* Returns `true` when the process has an interactive TTY with a valid terminal
+* width and is not running in CI.
+*
+* Some IDE-embedded terminals report `isTTY = true` but set `columns` to `0`,
+* which breaks clack's box-drawing helpers (they call `String.prototype.repeat`
+* with a negative count and throw a `RangeError`).  We therefore require a
+* positive column count before declaring the TTY usable.
+*
+* @example
+* ```ts
+* if (canUseTTY()) {
+*   renderProgressBar()
+* }
+* ```
 */
 function canUseTTY() {
-	return !!process.stdout.isTTY && !isCIEnvironment();
+	return !!process.stdout.isTTY && (process.stdout.columns ?? 0) > 0 && !isCIEnvironment();
 }
 //#endregion
 //#region ../../internals/utils/src/network.ts
-/** Well-known stable domains used as DNS probes to check internet connectivity. */
+/**
+* Well-known stable domains used as DNS probes to check internet connectivity.
+*/
 const TEST_DOMAINS = [
 	"dns.google.com",
 	"cloudflare.com",
@@ -37,7 +66,14 @@ const TEST_DOMAINS = [
 ];
 /**
 * Returns `true` when the system has internet connectivity.
-* Uses DNS resolution against well-known stable domains as a lightweight probe.
+* Probes DNS resolution against well-known stable domains.
+*
+* @example
+* ```ts
+* if (await isOnline()) {
+*   await fetchLatestVersion()
+* }
+* ```
 */
 async function isOnline() {
 	for (const domain of TEST_DOMAINS) try {
@@ -48,6 +84,12 @@ async function isOnline() {
 }
 /**
 * Executes `fn` only when the system is online. Returns `null` when offline or on error.
+*
+* @example
+* ```ts
+* const version = await executeIfOnline(() => fetchLatestVersion('kubb'))
+* // null when offline
+* ```
 */
 async function executeIfOnline(fn) {
 	if (!await isOnline()) return null;
@@ -58,17 +100,15 @@ async function executeIfOnline(fn) {
 	}
 }
 //#endregion
-//#region src/utils/telemetry.ts
+//#region src/telemetry.ts
 /**
-* Detect whether the current process is running inside a CI environment.
-* Delegates to the canonical isCIEnvironment() from envDetection.
+* Returns `true` when the current process runs inside a CI environment.
 */
 function isCi() {
 	return isCIEnvironment();
 }
 /**
-* Check if telemetry is disabled via DO_NOT_TRACK or KUBB_DISABLE_TELEMETRY.
-* Respects the standard DO_NOT_TRACK convention used across development tools.
+* Returns `true` when telemetry is disabled via `DO_NOT_TRACK` or `KUBB_DISABLE_TELEMETRY`.
 */
 function isTelemetryDisabled() {
 	return node_process.default.env["DO_NOT_TRACK"] === "1" || node_process.default.env["DO_NOT_TRACK"] === "true" || node_process.default.env["KUBB_DISABLE_TELEMETRY"] === "1" || node_process.default.env["KUBB_DISABLE_TELEMETRY"] === "true";
@@ -237,4 +277,4 @@ Object.defineProperty(exports, "sendTelemetry", {
 	}
 });
 
-//# sourceMappingURL=telemetry-DZ7IrLAU.cjs.map
+//# sourceMappingURL=telemetry-B2iWkY5e.cjs.map

package/dist/telemetry-B2iWkY5e.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-B2iWkY5e.cjs","names":["dnsPromises","process","OTLP_ENDPOINT","os"],"sources":["../../../internals/utils/src/env.ts","../../../internals/utils/src/network.ts","../src/telemetry.ts"],"sourcesContent":["/**\n * Returns `true` when running inside a GitHub Actions workflow.\n *\n * @example\n * ```ts\n * if (isGitHubActions()) {\n *   core.setOutput('result', 'ok')\n * }\n * ```\n */\nexport function isGitHubActions(): boolean {\n  return !!process.env.GITHUB_ACTIONS\n}\n\n/**\n * Returns `true` when the process is running in a CI environment.\n * Covers GitHub Actions, GitLab CI, CircleCI, Travis CI, Jenkins, Bitbucket,\n * TeamCity, Buildkite, and Azure Pipelines.\n *\n * @example\n * ```ts\n * if (isCIEnvironment()) {\n *   logger.level = 'error'\n * }\n * ```\n */\nexport function isCIEnvironment(): boolean {\n  return !!(\n    process.env.CI ||\n    process.env.GITHUB_ACTIONS ||\n    process.env.GITLAB_CI ||\n    process.env.BITBUCKET_BUILD_NUMBER ||\n    process.env.JENKINS_URL ||\n    process.env.CIRCLECI ||\n    process.env.TRAVIS ||\n    process.env.TEAMCITY_VERSION ||\n    process.env.BUILDKITE ||\n    process.env.TF_BUILD\n  )\n}\n\n/**\n * Returns `true` when the process has an interactive TTY with a valid terminal\n * width and is not running in CI.\n *\n * Some IDE-embedded terminals report `isTTY = true` but set `columns` to `0`,\n * which breaks clack's box-drawing helpers (they call `String.prototype.repeat`\n * with a negative count and throw a `RangeError`).  We therefore require a\n * positive column count before declaring the TTY usable.\n *\n * @example\n * ```ts\n * if (canUseTTY()) {\n *   renderProgressBar()\n * }\n * ```\n */\nexport function canUseTTY(): boolean {\n  return !!process.stdout.isTTY && (process.stdout.columns ?? 0) > 0 && !isCIEnvironment()\n}\n","import { promises as dnsPromises } from 'node:dns'\n\n/**\n * Well-known stable domains used as DNS probes to check internet connectivity.\n */\nconst TEST_DOMAINS = ['dns.google.com', 'cloudflare.com', 'one.one.one.one'] as const\n\n/**\n * Returns `true` when the system has internet connectivity.\n * Probes DNS resolution against well-known stable domains.\n *\n * @example\n * ```ts\n * if (await isOnline()) {\n *   await fetchLatestVersion()\n * }\n * ```\n */\nexport async function isOnline(): Promise<boolean> {\n  for (const domain of TEST_DOMAINS) {\n    try {\n      await dnsPromises.resolve(domain)\n      return true\n    } catch {\n      // Try next domain\n    }\n  }\n\n  return false\n}\n\n/**\n * Executes `fn` only when the system is online. Returns `null` when offline or on error.\n *\n * @example\n * ```ts\n * const version = await executeIfOnline(() => fetchLatestVersion('kubb'))\n * // null when offline\n * ```\n */\nexport async function executeIfOnline<T>(fn: () => Promise<T>): Promise<T | null> {\n  if (!(await isOnline())) return null\n\n  try {\n    return await fn()\n  } catch {\n    return null\n  }\n}\n","import { randomBytes } from 'node:crypto'\nimport os from 'node:os'\nimport process from 'node:process'\nimport { executeIfOnline, isCIEnvironment } from '@internals/utils'\nimport { OTLP_ENDPOINT } from './constants.ts'\n\n// OpenTelemetry OTLP JSON types\n// https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto\n// https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/common/v1/common.proto\n\ntype OtlpStringValue = { stringValue: string }\ntype OtlpBoolValue = { boolValue: boolean }\ntype OtlpIntValue = { intValue: number }\ntype OtlpDoubleValue = { doubleValue: number }\ntype OtlpBytesValue = { bytesValue: string }\ntype OtlpArrayValue = { arrayValue: { values: OtlpAnyValue[] } }\ntype OtlpKvListValue = { kvlistValue: { values: OtlpKeyValue[] } }\n\ntype OtlpAnyValue = OtlpStringValue | OtlpBoolValue | OtlpIntValue | OtlpDoubleValue | OtlpBytesValue | OtlpArrayValue | OtlpKvListValue\n\ntype OtlpKeyValue = {\n  key: string\n  value: OtlpAnyValue\n}\n\ntype OtlpResource = {\n  attributes: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpInstrumentationScope = {\n  name: string\n  version?: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\n/** https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto#L103 */\ntype OtlpSpanKind = 0 | 1 | 2 | 3 | 4 | 5\n\n/** 0 = STATUS_CODE_UNSET, 1 = STATUS_CODE_OK, 2 = STATUS_CODE_ERROR */\ntype OtlpStatusCode = 0 | 1 | 2\n\ntype OtlpStatus = {\n  code: OtlpStatusCode\n  message?: string\n}\n\ntype OtlpSpan = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  parentSpanId?: string\n  name: string\n  kind: OtlpSpanKind\n  startTimeUnixNano: string\n  endTimeUnixNano: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n  events?: OtlpSpanEvent[]\n  droppedEventsCount?: number\n  links?: OtlpSpanLink[]\n  droppedLinksCount?: number\n  status?: OtlpStatus\n}\n\ntype OtlpSpanEvent = {\n  timeUnixNano: string\n  name: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpSpanLink = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpScopeSpans = {\n  scope: OtlpInstrumentationScope\n  spans: OtlpSpan[]\n  schemaUrl?: string\n}\n\ntype OtlpResourceSpans = {\n  resource: OtlpResource\n  scopeSpans: OtlpScopeSpans[]\n  schemaUrl?: string\n}\n\n/** Root payload sent to POST /v1/traces */\ntype OtlpExportTraceServiceRequest = {\n  resourceSpans: OtlpResourceSpans[]\n}\n\n/**\n * Anonymous plugin name and options snapshot sent with each telemetry event.\n */\nexport type TelemetryPlugin = {\n  /**\n   * Plugin name as registered in the Kubb config, e.g. `'@kubb/plugin-ts'`.\n   */\n  name: string\n  /**\n   * anonymized plugin options snapshot — values are included but cannot be traced back to the user.\n   */\n  options: Record<string, unknown>\n}\n\ntype TelemetryEvent = {\n  command: string\n  kubbVersion: string\n  nodeVersion: string\n  platform: string\n  ci: boolean\n  plugins: TelemetryPlugin[]\n  duration: number\n  filesCreated: number\n  status: 'success' | 'failed'\n}\n\n/**\n * Returns `true` when the current process runs inside a CI environment.\n */\nexport function isCi(): boolean {\n  return isCIEnvironment()\n}\n\n/**\n * Returns `true` when telemetry is disabled via `DO_NOT_TRACK` or `KUBB_DISABLE_TELEMETRY`.\n */\nexport function isTelemetryDisabled(): boolean {\n  return (\n    process.env['DO_NOT_TRACK'] === '1' ||\n    process.env['DO_NOT_TRACK'] === 'true' ||\n    process.env['KUBB_DISABLE_TELEMETRY'] === '1' ||\n    process.env['KUBB_DISABLE_TELEMETRY'] === 'true'\n  )\n}\n\n/**\n * Convert a TelemetryEvent into an OTLP-compatible JSON trace payload.\n * See https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/\n */\nexport function buildOtlpPayload(event: TelemetryEvent): OtlpExportTraceServiceRequest {\n  const traceId = randomBytes(16).toString('hex')\n  const spanId = randomBytes(8).toString('hex')\n  const endTimeNs = BigInt(Date.now()) * 1_000_000n\n  const startTimeNs = endTimeNs - BigInt(event.duration) * 1_000_000n\n\n  const attributes: OtlpKeyValue[] = [\n    { key: 'kubb.command', value: { stringValue: event.command } },\n    { key: 'kubb.version', value: { stringValue: event.kubbVersion } },\n    { key: 'kubb.node_version', value: { stringValue: event.nodeVersion } },\n    { key: 'kubb.platform', value: { stringValue: event.platform } },\n    { key: 'kubb.ci', value: { boolValue: event.ci } },\n    { key: 'kubb.files_created', value: { intValue: event.filesCreated } },\n    { key: 'kubb.status', value: { stringValue: event.status } },\n    {\n      key: 'kubb.plugins',\n      value: {\n        arrayValue: {\n          values: event.plugins.map(\n            (p): OtlpKvListValue => ({\n              kvlistValue: {\n                values: [\n                  { key: 'name', value: { stringValue: p.name } },\n                  {\n                    key: 'options',\n                    value: {\n                      stringValue: JSON.stringify({\n                        ...p.options,\n                        usedEnumNames: undefined,\n                      }),\n                    },\n                  },\n                ],\n              },\n            }),\n          ),\n        },\n      },\n    },\n  ]\n\n  return {\n    resourceSpans: [\n      {\n        resource: {\n          attributes: [\n            { key: 'service.name', value: { stringValue: 'kubb-cli' } },\n            {\n              key: 'service.version',\n              value: { stringValue: event.kubbVersion },\n            },\n            { key: 'telemetry.sdk.language', value: { stringValue: 'nodejs' } },\n          ],\n        },\n        scopeSpans: [\n          {\n            scope: { name: 'kubb-cli', version: event.kubbVersion },\n            spans: [\n              {\n                traceId,\n                spanId,\n                name: event.command,\n                kind: 1 satisfies OtlpSpanKind,\n                startTimeUnixNano: String(startTimeNs),\n                endTimeUnixNano: String(endTimeNs),\n                attributes,\n                status: {\n                  code: (event.status === 'success' ? 1 : 2) satisfies OtlpStatusCode,\n                },\n              },\n            ],\n          },\n        ],\n      },\n    ],\n  }\n}\n\n/**\n * Send an anonymous telemetry event to the Kubb OTLP endpoint.\n * Respects DO_NOT_TRACK and KUBB_DISABLE_TELEMETRY environment variables.\n * Fails silently to never interrupt the generation process.\n */\nexport async function sendTelemetry(event: TelemetryEvent): Promise<void> {\n  if (isTelemetryDisabled()) {\n    return\n  }\n\n  await executeIfOnline(async () => {\n    try {\n      await fetch(`${OTLP_ENDPOINT}/v1/traces`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'Kubb-Telemetry-Version': '1',\n          'Kubb-Telemetry-Source': 'kubb-cli',\n        },\n        body: JSON.stringify(buildOtlpPayload(event)),\n        signal: AbortSignal.timeout(5_000),\n      })\n    } catch (_e) {\n      // Fail silently – telemetry must never break the CLI\n    }\n  })\n}\n\n/**\n * Build an anonymous telemetry payload from a completed generation run.\n * No file paths, OpenAPI specs, or secrets are included.\n */\nexport function buildTelemetryEvent(options: {\n  command: 'generate' | 'mcp' | 'validate' | 'agent'\n  kubbVersion: string\n  plugins?: TelemetryPlugin[]\n  hrStart: [number, number]\n  filesCreated?: number\n  status: 'success' | 'failed'\n}): TelemetryEvent {\n  const [seconds, nanoseconds] = process.hrtime(options.hrStart)\n  const duration = Math.round(seconds * 1000 + nanoseconds / 1e6)\n\n  return {\n    command: options.command,\n    kubbVersion: options.kubbVersion,\n    nodeVersion: process.versions.node.split('.')[0] as string,\n    platform: os.platform(),\n    ci: isCi(),\n    plugins: options.plugins ?? [],\n    duration,\n    filesCreated: options.filesCreated ?? 0,\n    status: options.status,\n  }\n}\n"],"mappings":"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"}

package/dist/{telemetry-BF3SMlH6.js → telemetry-BkektVz6.js}

@@ -1,5 +1,5 @@
-import "./chunk--u3MIqq1.js";
-import { n as OTLP_ENDPOINT } from "./constants-DJM9zCXm.js";
+import "./chunk-BvFE5Tac.js";
+import { n as OTLP_ENDPOINT } from "./constants-B2JTeRBb.js";
 import { randomBytes } from "node:crypto";
 import { promises } from "node:dns";
 import os from "node:os";
@@ -7,6 +7,13 @@ import process$1 from "node:process";
 //#region ../../internals/utils/src/env.ts
 /**
 * Returns `true` when running inside a GitHub Actions workflow.
+*
+* @example
+* ```ts
+* if (isGitHubActions()) {
+*   core.setOutput('result', 'ok')
+* }
+* ```
 */
 function isGitHubActions() {
 	return !!process.env.GITHUB_ACTIONS;
@@ -15,19 +22,41 @@ function isGitHubActions() {
 * Returns `true` when the process is running in a CI environment.
 * Covers GitHub Actions, GitLab CI, CircleCI, Travis CI, Jenkins, Bitbucket,
 * TeamCity, Buildkite, and Azure Pipelines.
+*
+* @example
+* ```ts
+* if (isCIEnvironment()) {
+*   logger.level = 'error'
+* }
+* ```
 */
 function isCIEnvironment() {
 	return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.BITBUCKET_BUILD_NUMBER || process.env.JENKINS_URL || process.env.CIRCLECI || process.env.TRAVIS || process.env.TEAMCITY_VERSION || process.env.BUILDKITE || process.env.TF_BUILD);
 }
 /**
-* Returns `true` when the process has an interactive TTY and is not running in CI.
+* Returns `true` when the process has an interactive TTY with a valid terminal
+* width and is not running in CI.
+*
+* Some IDE-embedded terminals report `isTTY = true` but set `columns` to `0`,
+* which breaks clack's box-drawing helpers (they call `String.prototype.repeat`
+* with a negative count and throw a `RangeError`).  We therefore require a
+* positive column count before declaring the TTY usable.
+*
+* @example
+* ```ts
+* if (canUseTTY()) {
+*   renderProgressBar()
+* }
+* ```
 */
 function canUseTTY() {
-	return !!process.stdout.isTTY && !isCIEnvironment();
+	return !!process.stdout.isTTY && (process.stdout.columns ?? 0) > 0 && !isCIEnvironment();
 }
 //#endregion
 //#region ../../internals/utils/src/network.ts
-/** Well-known stable domains used as DNS probes to check internet connectivity. */
+/**
+* Well-known stable domains used as DNS probes to check internet connectivity.
+*/
 const TEST_DOMAINS = [
 	"dns.google.com",
 	"cloudflare.com",
@@ -35,7 +64,14 @@ const TEST_DOMAINS = [
 ];
 /**
 * Returns `true` when the system has internet connectivity.
-* Uses DNS resolution against well-known stable domains as a lightweight probe.
+* Probes DNS resolution against well-known stable domains.
+*
+* @example
+* ```ts
+* if (await isOnline()) {
+*   await fetchLatestVersion()
+* }
+* ```
 */
 async function isOnline() {
 	for (const domain of TEST_DOMAINS) try {
@@ -46,6 +82,12 @@ async function isOnline() {
 }
 /**
 * Executes `fn` only when the system is online. Returns `null` when offline or on error.
+*
+* @example
+* ```ts
+* const version = await executeIfOnline(() => fetchLatestVersion('kubb'))
+* // null when offline
+* ```
 */
 async function executeIfOnline(fn) {
 	if (!await isOnline()) return null;
@@ -56,17 +98,15 @@ async function executeIfOnline(fn) {
 	}
 }
 //#endregion
-//#region src/utils/telemetry.ts
+//#region src/telemetry.ts
 /**
-* Detect whether the current process is running inside a CI environment.
-* Delegates to the canonical isCIEnvironment() from envDetection.
+* Returns `true` when the current process runs inside a CI environment.
 */
 function isCi() {
 	return isCIEnvironment();
 }
 /**
-* Check if telemetry is disabled via DO_NOT_TRACK or KUBB_DISABLE_TELEMETRY.
-* Respects the standard DO_NOT_TRACK convention used across development tools.
+* Returns `true` when telemetry is disabled via `DO_NOT_TRACK` or `KUBB_DISABLE_TELEMETRY`.
 */
 function isTelemetryDisabled() {
 	return process$1.env["DO_NOT_TRACK"] === "1" || process$1.env["DO_NOT_TRACK"] === "true" || process$1.env["KUBB_DISABLE_TELEMETRY"] === "1" || process$1.env["KUBB_DISABLE_TELEMETRY"] === "true";
@@ -200,4 +240,4 @@ function buildTelemetryEvent(options) {
 //#endregion
 export { canUseTTY as a, executeIfOnline as i, isTelemetryDisabled as n, isGitHubActions as o, sendTelemetry as r, buildTelemetryEvent as t };
 
-//# sourceMappingURL=telemetry-BF3SMlH6.js.map
+//# sourceMappingURL=telemetry-BkektVz6.js.map