@kubb/cli 5.0.0-beta.75 → 5.0.0-beta.8

package/dist/index.js

@@ -1,8 +1,8 @@
-import "./chunk--u3MIqq1.js";
-import { t as defineCLIAdapter } from "./define-Ctii4bel.js";
-import { n as isTelemetryDisabled } from "./telemetry-LgT_sdPe.js";
-import { t as version } from "./package-DqZsMLZ9.js";
-import { i as QUIET_FLAGS } from "./constants-aL3CP_Wq.js";
+import "./chunk-BvFE5Tac.js";
+import { t as defineCLIAdapter } from "./define-m_fp-Aqm.js";
+import { n as isTelemetryDisabled } from "./telemetry-BkektVz6.js";
+import { t as version } from "./package-s8PvCnk-.js";
+import { r as QUIET_FLAGS } from "./constants-B2JTeRBb.js";
 import { parseArgs, styleText } from "node:util";
 //#region ../../internals/utils/src/cli/schema.ts
 /**
@@ -23,6 +23,7 @@ function serializeCommand(def) {
 		name: def.name,
 		description: def.description,
 		arguments: def.arguments,
+		...def.examples?.length ? { examples: def.examples } : {},
 		options: serializeOptions(def.options ?? {}),
 		subCommands: def.subCommands ? def.subCommands.map(serializeCommand) : []
 	};
@@ -76,6 +77,11 @@ function renderHelp(def, parentName) {
 		console.log(`  ${flags}${opt.description}${defaultPart}`);
 	}
 	console.log();
+	if (schema.examples?.length) {
+		console.log(styleText("bold", "Examples:"));
+		for (const ex of schema.examples) console.log(`  ${styleText("dim", ex)}`);
+		console.log();
+	}
 }
 //#endregion
 //#region ../../internals/utils/src/cli/adapters/nodeAdapter.ts
@@ -132,7 +138,9 @@ async function runCommand(def, argv, parentName) {
 }
 function printRootHelp(programName, version, defs) {
 	console.log(`\n${styleText("bold", "Usage:")} ${programName} <command> [options]\n`);
-	console.log(`  Kubb generation — v${version}\n`);
+	console.log(`  Kubb v${version} — Generate TypeScript types, API clients, React Query hooks,`);
+	console.log(`  Zod schemas, and more from an OpenAPI specification.\n`);
+	console.log(`  Quick start: ${styleText("cyan", `${programName} init`)} to scaffold a config, then ${styleText("cyan", `${programName} generate`)} to run.\n`);
 	console.log(styleText("bold", "Commands:"));
 	for (const def of defs) console.log(`  ${styleText("cyan", def.name.padEnd(16))}${def.description}`);
 	console.log();
@@ -151,7 +159,8 @@ const nodeAdapter = defineCLIAdapter({
 	},
 	async run(defs, argv, opts) {
 		const { programName, defaultCommandName, version } = opts;
-		const args = argv.length >= 2 && argv[0]?.includes("node") ? argv.slice(2) : argv;
+		const firstArgIsExecutablePath = (argv[0]?.includes("/") || argv[0]?.includes("\\")) ?? false;
+		const args = argv.length >= 2 && firstArgIsExecutablePath ? argv.slice(2) : argv;
 		if (args[0] === "--version" || args[0] === "-v") {
 			console.log(version);
 			process.exit(0);
@@ -225,7 +234,7 @@ function createCLI(options) {
 	} };
 }
 //#endregion
-//#region src/utils/flags.ts
+//#region ../../internals/utils/src/isFlag.ts
 /**
 * Type guard that confirms `value` is a member of `set`. Avoids type assertions with `Set<T extends string>`.
 */
@@ -244,11 +253,11 @@ function shouldShowTelemetryNotice(argv) {
 }
 async function run(argv = process.argv) {
 	if (shouldShowTelemetryNotice(argv)) console.log(`${styleText("yellow", "Notice:")} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \nTo disable, set ${styleText("cyan", "KUBB_DISABLE_TELEMETRY=1")}.\n`);
-	const { command: generateCommand } = await import("./generate-YPtfjsg4.js");
-	const { command: validateCommand } = await import("./validate-CIR3_lZI.js");
-	const { command: mcpCommand } = await import("./mcp-C-d5N1wZ.js");
-	const { command: agentCommand } = await import("./agent-CTdJEHEs.js");
-	const { command: initCommand } = await import("./init-ooJeOBGt.js");
+	const { command: generateCommand } = await import("./generate-DzC1brc9.js");
+	const { command: validateCommand } = await import("./validate-Da2LIDVc.js");
+	const { command: mcpCommand } = await import("./mcp-Bm2Q7YdS.js");
+	const { command: agentCommand } = await import("./agent-DTeGTNl7.js");
+	const { command: initCommand } = await import("./init-BYlb-ua0.js");
 	await cli.run([
 		generateCommand,
 		validateCommand,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../internals/utils/src/cli/schema.ts","../../../internals/utils/src/cli/help.ts","../../../internals/utils/src/cli/adapters/nodeAdapter.ts","../../../internals/utils/src/cli/parse.ts","../src/utils/flags.ts","../src/index.ts"],"sourcesContent":["import type { CommandDefinition, CommandSchema, OptionDefinition, OptionSchema } from './types.ts'\n\n/**\n * Serializes `CommandDefinition[]` to a plain, JSON-serializable structure.\n * Use to expose CLI capabilities to AI agents or MCP tools.\n *\n * @example\n * ```ts\n * getCommandSchema([generateCommand, agentCommand])\n * // [{ name: 'generate', options: [...], subCommands: [] }, ...]\n * ```\n */\nexport function getCommandSchema(defs: CommandDefinition[]): CommandSchema[] {\n  return defs.map(serializeCommand)\n}\n\nfunction serializeCommand(def: CommandDefinition): CommandSchema {\n  return {\n    name: def.name,\n    description: def.description,\n    arguments: def.arguments,\n    options: serializeOptions(def.options ?? {}),\n    subCommands: def.subCommands ? def.subCommands.map(serializeCommand) : [],\n  }\n}\n\nfunction serializeOptions(options: Record<string, OptionDefinition>): OptionSchema[] {\n  return Object.entries(options).map(([name, opt]) => {\n    const shortPart = opt.short ? `-${opt.short}, ` : ''\n    const valuePart = opt.type === 'string' ? ` <${opt.hint ?? name}>` : ''\n    const flags = `${shortPart}--${name}${valuePart}`\n\n    return {\n      name,\n      flags,\n      type: opt.type,\n      description: opt.description,\n      ...(opt.default !== undefined ? { default: opt.default } : {}),\n      ...(opt.hint ? { hint: opt.hint } : {}),\n      ...(opt.enum ? { enum: opt.enum } : {}),\n      ...(opt.required ? { required: opt.required } : {}),\n    }\n  })\n}\n","import { styleText } from 'node:util'\nimport { getCommandSchema } from './schema.ts'\nimport type { CommandDefinition, OptionSchema } from './types.ts'\n\n/** Prints formatted help output for `def` using its `CommandDefinition`.\n *\n * @example\n * ```ts\n * renderHelp({ name: 'generate', description: 'Generate client code' })\n * // prints Usage: generate [options] ...\n * ```\n */\nexport function renderHelp(def: CommandDefinition, parentName?: string): void {\n  const schema = getCommandSchema([def])[0]!\n\n  const programName = parentName ? `${parentName} ${schema.name}` : schema.name\n\n  const argsPart = schema.arguments?.length ? ` ${schema.arguments.join(' ')}` : ''\n  const subCmdPart = schema.subCommands.length ? ' <command>' : ''\n  console.log(`\\n${styleText('bold', 'Usage:')} ${programName}${argsPart}${subCmdPart} [options]\\n`)\n\n  if (schema.description) {\n    console.log(`  ${schema.description}\\n`)\n  }\n\n  if (schema.subCommands.length) {\n    console.log(styleText('bold', 'Commands:'))\n    for (const sub of schema.subCommands) {\n      console.log(`  ${styleText('cyan', sub.name.padEnd(16))}${sub.description}`)\n    }\n    console.log()\n  }\n\n  const options: OptionSchema[] = [\n    ...schema.options,\n    {\n      name: 'help',\n      flags: '-h, --help',\n      type: 'boolean' as const,\n      description: 'Show help',\n    },\n  ]\n\n  console.log(styleText('bold', 'Options:'))\n  for (const opt of options) {\n    const flags = styleText('cyan', opt.flags.padEnd(30))\n    const defaultPart = opt.default !== undefined ? styleText('dim', ` (default: ${opt.default})`) : ''\n    console.log(`  ${flags}${opt.description}${defaultPart}`)\n  }\n  console.log()\n}\n","import { parseArgs, styleText } from 'node:util'\nimport { defineCLIAdapter } from '../define.ts'\nimport { renderHelp } from '../help.ts'\nimport type { CommandDefinition, OptionType, ParsedArgs, RunOptions } from '../types.ts'\n\ntype ParseOption = {\n  type: OptionType\n  short?: string\n  default?: string | boolean\n}\ntype ParseOptions = Record<string, ParseOption>\n\nfunction buildParseOptions(def: CommandDefinition): ParseOptions {\n  const result: ParseOptions = {\n    help: { type: 'boolean', short: 'h' },\n  }\n\n  for (const [name, opt] of Object.entries(def.options ?? {})) {\n    result[name] = {\n      type: opt.type,\n      ...(opt.short ? { short: opt.short } : {}),\n      ...(opt.default !== undefined ? { default: opt.default } : {}),\n    }\n  }\n\n  return result\n}\n\nasync function runCommand(def: CommandDefinition, argv: string[], parentName?: string): Promise<void> {\n  const parseOptions = buildParseOptions(def)\n\n  let parsed: ParsedArgs\n  try {\n    const result = parseArgs({\n      args: argv,\n      options: parseOptions,\n      allowPositionals: true,\n      strict: false,\n    })\n    parsed = {\n      values: result.values as ParsedArgs['values'],\n      positionals: result.positionals,\n    }\n  } catch {\n    renderHelp(def, parentName)\n    process.exit(1)\n  }\n\n  if (parsed.values['help']) {\n    renderHelp(def, parentName)\n    process.exit(0)\n  }\n\n  // Validate required options before running the command\n  for (const [name, opt] of Object.entries(def.options ?? {})) {\n    if (opt.required && parsed.values[name] === undefined) {\n      console.error(styleText('red', `Error: --${name} is required`))\n      renderHelp(def, parentName)\n      process.exit(1)\n    }\n  }\n\n  if (!def.run) {\n    renderHelp(def, parentName)\n    process.exit(0)\n  }\n\n  try {\n    await def.run(parsed)\n  } catch (err) {\n    console.error(styleText('red', `Error: ${err instanceof Error ? err.message : String(err)}`))\n    renderHelp(def, parentName)\n    process.exit(1)\n  }\n}\n\nfunction printRootHelp(programName: string, version: string, defs: CommandDefinition[]): void {\n  console.log(`\\n${styleText('bold', 'Usage:')} ${programName} <command> [options]\\n`)\n  console.log(`  Kubb generation — v${version}\\n`)\n  console.log(styleText('bold', 'Commands:'))\n  for (const def of defs) {\n    console.log(`  ${styleText('cyan', def.name.padEnd(16))}${def.description}`)\n  }\n  console.log()\n  console.log(styleText('bold', 'Options:'))\n  console.log(`  ${styleText('cyan', '-v, --version'.padEnd(30))}Show version number`)\n  console.log(`  ${styleText('cyan', '-h, --help'.padEnd(30))}Show help`)\n  console.log()\n  console.log(`Run ${styleText('cyan', `${programName} <command> --help`)} for command-specific help.\\n`)\n}\n\n/**\n * CLI adapter using `node:util parseArgs`. No external dependencies.\n */\nexport const nodeAdapter = defineCLIAdapter({\n  renderHelp(def: CommandDefinition, parentName?: string): void {\n    renderHelp(def, parentName)\n  },\n\n  async run(defs: CommandDefinition[], argv: string[], opts: RunOptions): Promise<void> {\n    const { programName, defaultCommandName, version } = opts\n\n    const args = argv.length >= 2 && argv[0]?.includes('node') ? argv.slice(2) : argv\n\n    if (args[0] === '--version' || args[0] === '-v') {\n      console.log(version)\n      process.exit(0)\n    }\n\n    if (args[0] === '--help' || args[0] === '-h') {\n      printRootHelp(programName, version, defs)\n      process.exit(0)\n    }\n\n    if (args.length === 0) {\n      const defaultDef = defs.find((d) => d.name === defaultCommandName)\n      if (defaultDef?.run) {\n        await runCommand(defaultDef, [], programName)\n      } else {\n        printRootHelp(programName, version, defs)\n      }\n      return\n    }\n\n    const [first, ...rest] = args\n    const isKnownSubcommand = defs.some((d) => d.name === first)\n\n    let def: CommandDefinition | undefined\n    let commandArgv: string[]\n    let parentName: string | undefined\n\n    if (isKnownSubcommand) {\n      def = defs.find((d) => d.name === first)\n      commandArgv = rest\n      parentName = programName\n    } else {\n      def = defs.find((d) => d.name === defaultCommandName)\n      commandArgv = args\n      parentName = programName\n    }\n\n    if (!def) {\n      console.error(`Unknown command: ${first}`)\n      printRootHelp(programName, version, defs)\n      process.exit(1)\n    }\n\n    if (def.subCommands?.length) {\n      const [subName, ...subRest] = commandArgv\n      const subDef = def.subCommands.find((s) => s.name === subName)\n\n      if (subName === '--help' || subName === '-h') {\n        renderHelp(def, parentName)\n        process.exit(0)\n      }\n\n      if (!subDef) {\n        renderHelp(def, parentName)\n        process.exit(subName ? 1 : 0)\n      }\n\n      await runCommand(subDef, subRest, `${parentName} ${def.name}`)\n      return\n    }\n\n    await runCommand(def, commandArgv, parentName)\n  },\n})\n","import { nodeAdapter } from './adapters/nodeAdapter.ts'\nimport type { CLIAdapter, CommandDefinition, RunOptions } from './types.ts'\n\n/**\n * Creates a CLI runner bound to a specific adapter.\n *\n * @default nodeAdapter (Node.js `node:util parseArgs`)\n *\n * @example\n * ```ts\n * await createCLI().run(commands, process.argv.slice(2), {\n *   programName: 'kubb',\n *   defaultCommandName: 'generate',\n *   version: '5.0.0',\n * })\n * ```\n */\nexport function createCLI(options?: { adapter?: CLIAdapter }): {\n  run(commands: CommandDefinition[], argv: string[], opts: RunOptions): Promise<void>\n} {\n  const adapter = options?.adapter ?? nodeAdapter\n\n  return {\n    run(commands, argv, opts) {\n      return adapter.run(commands, argv, opts)\n    },\n  }\n}\n","/**\n * Type guard that confirms `value` is a member of `set`. Avoids type assertions with `Set<T extends string>`.\n */\nexport function isFlag<T extends string>(set: ReadonlySet<T>, value: string): value is T {\n  for (const flag of set) {\n    if (flag === value) return true\n  }\n  return false\n}\n","import { styleText } from 'node:util'\nimport { createCLI } from '@internals/utils'\nimport { version } from '../package.json'\nimport { QUIET_FLAGS } from './constants.ts'\nimport { isFlag } from './utils/flags.ts'\nimport { isTelemetryDisabled } from './utils/telemetry.ts'\n\nconst cli = createCLI()\n\nfunction shouldShowTelemetryNotice(argv: Array<string>): boolean {\n  if (isTelemetryDisabled()) {\n    return false\n  }\n  // Skip when the user is just asking for help or version info\n  if (argv.some((arg) => isFlag(QUIET_FLAGS, arg))) {\n    return false\n  }\n  // Skip in non-interactive / scripting contexts\n  if (!process.stdout.isTTY) {\n    return false\n  }\n  return true\n}\n\nexport async function run(argv: Array<string> = process.argv): Promise<void> {\n  if (shouldShowTelemetryNotice(argv)) {\n    console.log(\n      `${styleText('yellow', 'Notice:')} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \\nTo disable, set ${styleText('cyan', 'KUBB_DISABLE_TELEMETRY=1')}.\\n`,\n    )\n  }\n\n  const { command: generateCommand } = await import('./commands/generate.ts')\n  const { command: validateCommand } = await import('./commands/validate.ts')\n  const { command: mcpCommand } = await import('./commands/mcp.ts')\n  const { command: agentCommand } = await import('./commands/agent.ts')\n  const { command: initCommand } = await import('./commands/init.ts')\n\n  await cli.run([generateCommand, validateCommand, mcpCommand, agentCommand, initCommand], argv, {\n    programName: 'kubb',\n    defaultCommandName: 'generate',\n    version,\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../internals/utils/src/cli/schema.ts","../../../internals/utils/src/cli/help.ts","../../../internals/utils/src/cli/adapters/nodeAdapter.ts","../../../internals/utils/src/cli/parse.ts","../../../internals/utils/src/isFlag.ts","../src/index.ts"],"sourcesContent":["import type { CommandDefinition, CommandSchema, OptionDefinition, OptionSchema } from './types.ts'\n\n/**\n * Serializes `CommandDefinition[]` to a plain, JSON-serializable structure.\n * Use to expose CLI capabilities to AI agents or MCP tools.\n *\n * @example\n * ```ts\n * getCommandSchema([generateCommand, agentCommand])\n * // [{ name: 'generate', options: [...], subCommands: [] }, ...]\n * ```\n */\nexport function getCommandSchema(defs: CommandDefinition[]): CommandSchema[] {\n  return defs.map(serializeCommand)\n}\n\nfunction serializeCommand(def: CommandDefinition): CommandSchema {\n  return {\n    name: def.name,\n    description: def.description,\n    arguments: def.arguments,\n    ...(def.examples?.length ? { examples: def.examples } : {}),\n    options: serializeOptions(def.options ?? {}),\n    subCommands: def.subCommands ? def.subCommands.map(serializeCommand) : [],\n  }\n}\n\nfunction serializeOptions(options: Record<string, OptionDefinition>): OptionSchema[] {\n  return Object.entries(options).map(([name, opt]) => {\n    const shortPart = opt.short ? `-${opt.short}, ` : ''\n    const valuePart = opt.type === 'string' ? ` <${opt.hint ?? name}>` : ''\n    const flags = `${shortPart}--${name}${valuePart}`\n\n    return {\n      name,\n      flags,\n      type: opt.type,\n      description: opt.description,\n      ...(opt.default !== undefined ? { default: opt.default } : {}),\n      ...(opt.hint ? { hint: opt.hint } : {}),\n      ...(opt.enum ? { enum: opt.enum } : {}),\n      ...(opt.required ? { required: opt.required } : {}),\n    }\n  })\n}\n","import { styleText } from 'node:util'\nimport { getCommandSchema } from './schema.ts'\nimport type { CommandDefinition, OptionSchema } from './types.ts'\n\n/** Prints formatted help output for `def` using its `CommandDefinition`.\n *\n * @example\n * ```ts\n * renderHelp({ name: 'generate', description: 'Generate client code' })\n * // prints Usage: generate [options] ...\n * ```\n */\nexport function renderHelp(def: CommandDefinition, parentName?: string): void {\n  const schema = getCommandSchema([def])[0]!\n\n  const programName = parentName ? `${parentName} ${schema.name}` : schema.name\n\n  const argsPart = schema.arguments?.length ? ` ${schema.arguments.join(' ')}` : ''\n  const subCmdPart = schema.subCommands.length ? ' <command>' : ''\n  console.log(`\\n${styleText('bold', 'Usage:')} ${programName}${argsPart}${subCmdPart} [options]\\n`)\n\n  if (schema.description) {\n    console.log(`  ${schema.description}\\n`)\n  }\n\n  if (schema.subCommands.length) {\n    console.log(styleText('bold', 'Commands:'))\n    for (const sub of schema.subCommands) {\n      console.log(`  ${styleText('cyan', sub.name.padEnd(16))}${sub.description}`)\n    }\n    console.log()\n  }\n\n  const options: OptionSchema[] = [\n    ...schema.options,\n    {\n      name: 'help',\n      flags: '-h, --help',\n      type: 'boolean' as const,\n      description: 'Show help',\n    },\n  ]\n\n  console.log(styleText('bold', 'Options:'))\n  for (const opt of options) {\n    const flags = styleText('cyan', opt.flags.padEnd(30))\n    const defaultPart = opt.default !== undefined ? styleText('dim', ` (default: ${opt.default})`) : ''\n    console.log(`  ${flags}${opt.description}${defaultPart}`)\n  }\n  console.log()\n\n  if (schema.examples?.length) {\n    console.log(styleText('bold', 'Examples:'))\n    for (const ex of schema.examples) {\n      console.log(`  ${styleText('dim', ex)}`)\n    }\n    console.log()\n  }\n}\n","import { parseArgs, styleText } from 'node:util'\nimport { defineCLIAdapter } from '../define.ts'\nimport { renderHelp } from '../help.ts'\nimport type { CommandDefinition, OptionType, ParsedArgs, RunOptions } from '../types.ts'\n\ntype ParseOption = {\n  type: OptionType\n  short?: string\n  default?: string | boolean\n}\ntype ParseOptions = Record<string, ParseOption>\n\nfunction buildParseOptions(def: CommandDefinition): ParseOptions {\n  const result: ParseOptions = {\n    help: { type: 'boolean', short: 'h' },\n  }\n\n  for (const [name, opt] of Object.entries(def.options ?? {})) {\n    result[name] = {\n      type: opt.type,\n      ...(opt.short ? { short: opt.short } : {}),\n      ...(opt.default !== undefined ? { default: opt.default } : {}),\n    }\n  }\n\n  return result\n}\n\nasync function runCommand(def: CommandDefinition, argv: string[], parentName?: string): Promise<void> {\n  const parseOptions = buildParseOptions(def)\n\n  let parsed: ParsedArgs\n  try {\n    const result = parseArgs({\n      args: argv,\n      options: parseOptions,\n      allowPositionals: true,\n      strict: false,\n    })\n    parsed = {\n      values: result.values as ParsedArgs['values'],\n      positionals: result.positionals,\n    }\n  } catch {\n    renderHelp(def, parentName)\n    process.exit(1)\n  }\n\n  if (parsed.values['help']) {\n    renderHelp(def, parentName)\n    process.exit(0)\n  }\n\n  // Validate required options before running the command\n  for (const [name, opt] of Object.entries(def.options ?? {})) {\n    if (opt.required && parsed.values[name] === undefined) {\n      console.error(styleText('red', `Error: --${name} is required`))\n      renderHelp(def, parentName)\n      process.exit(1)\n    }\n  }\n\n  if (!def.run) {\n    renderHelp(def, parentName)\n    process.exit(0)\n  }\n\n  try {\n    await def.run(parsed)\n  } catch (err) {\n    console.error(styleText('red', `Error: ${err instanceof Error ? err.message : String(err)}`))\n    renderHelp(def, parentName)\n    process.exit(1)\n  }\n}\n\nfunction printRootHelp(programName: string, version: string, defs: CommandDefinition[]): void {\n  console.log(`\\n${styleText('bold', 'Usage:')} ${programName} <command> [options]\\n`)\n  console.log(`  Kubb v${version} — Generate TypeScript types, API clients, React Query hooks,`)\n  console.log(`  Zod schemas, and more from an OpenAPI specification.\\n`)\n  console.log(`  Quick start: ${styleText('cyan', `${programName} init`)} to scaffold a config, then ${styleText('cyan', `${programName} generate`)} to run.\\n`)\n  console.log(styleText('bold', 'Commands:'))\n  for (const def of defs) {\n    console.log(`  ${styleText('cyan', def.name.padEnd(16))}${def.description}`)\n  }\n  console.log()\n  console.log(styleText('bold', 'Options:'))\n  console.log(`  ${styleText('cyan', '-v, --version'.padEnd(30))}Show version number`)\n  console.log(`  ${styleText('cyan', '-h, --help'.padEnd(30))}Show help`)\n  console.log()\n  console.log(`Run ${styleText('cyan', `${programName} <command> --help`)} for command-specific help.\\n`)\n}\n\n/**\n * CLI adapter using `node:util parseArgs`. No external dependencies.\n */\nexport const nodeAdapter = defineCLIAdapter({\n  renderHelp(def: CommandDefinition, parentName?: string): void {\n    renderHelp(def, parentName)\n  },\n\n  async run(defs: CommandDefinition[], argv: string[], opts: RunOptions): Promise<void> {\n    const { programName, defaultCommandName, version } = opts\n\n    // Strip the leading executable + script entries when process.argv is passed directly.\n    // Handles Node.js (/usr/bin/node), Bun (/usr/local/bin/bun), Deno, tsx, etc.\n    // All runtime executable paths contain a path separator; bare command names do not.\n    const firstArgIsExecutablePath = (argv[0]?.includes('/') || argv[0]?.includes('\\\\')) ?? false\n    const args = argv.length >= 2 && firstArgIsExecutablePath ? argv.slice(2) : argv\n\n    if (args[0] === '--version' || args[0] === '-v') {\n      console.log(version)\n      process.exit(0)\n    }\n\n    if (args[0] === '--help' || args[0] === '-h') {\n      printRootHelp(programName, version, defs)\n      process.exit(0)\n    }\n\n    if (args.length === 0) {\n      const defaultDef = defs.find((d) => d.name === defaultCommandName)\n      if (defaultDef?.run) {\n        await runCommand(defaultDef, [], programName)\n      } else {\n        printRootHelp(programName, version, defs)\n      }\n      return\n    }\n\n    const [first, ...rest] = args\n    const isKnownSubcommand = defs.some((d) => d.name === first)\n\n    let def: CommandDefinition | undefined\n    let commandArgv: string[]\n    let parentName: string | undefined\n\n    if (isKnownSubcommand) {\n      def = defs.find((d) => d.name === first)\n      commandArgv = rest\n      parentName = programName\n    } else {\n      def = defs.find((d) => d.name === defaultCommandName)\n      commandArgv = args\n      parentName = programName\n    }\n\n    if (!def) {\n      console.error(`Unknown command: ${first}`)\n      printRootHelp(programName, version, defs)\n      process.exit(1)\n    }\n\n    if (def.subCommands?.length) {\n      const [subName, ...subRest] = commandArgv\n      const subDef = def.subCommands.find((s) => s.name === subName)\n\n      if (subName === '--help' || subName === '-h') {\n        renderHelp(def, parentName)\n        process.exit(0)\n      }\n\n      if (!subDef) {\n        renderHelp(def, parentName)\n        process.exit(subName ? 1 : 0)\n      }\n\n      await runCommand(subDef, subRest, `${parentName} ${def.name}`)\n      return\n    }\n\n    await runCommand(def, commandArgv, parentName)\n  },\n})\n","import { nodeAdapter } from './adapters/nodeAdapter.ts'\nimport type { CLIAdapter, CommandDefinition, RunOptions } from './types.ts'\n\n/**\n * Creates a CLI runner bound to a specific adapter.\n *\n * @default nodeAdapter (Node.js `node:util parseArgs`)\n *\n * @example\n * ```ts\n * await createCLI().run(commands, process.argv.slice(2), {\n *   programName: 'kubb',\n *   defaultCommandName: 'generate',\n *   version: '5.0.0',\n * })\n * ```\n */\nexport function createCLI(options?: { adapter?: CLIAdapter }): {\n  run(commands: CommandDefinition[], argv: string[], opts: RunOptions): Promise<void>\n} {\n  const adapter = options?.adapter ?? nodeAdapter\n\n  return {\n    run(commands, argv, opts) {\n      return adapter.run(commands, argv, opts)\n    },\n  }\n}\n","/**\n * Type guard that confirms `value` is a member of `set`. Avoids type assertions with `Set<T extends string>`.\n */\nexport function isFlag<T extends string>(set: ReadonlySet<T>, value: string): value is T {\n  for (const flag of set) {\n    if (flag === value) return true\n  }\n  return false\n}\n","import { styleText } from 'node:util'\nimport { createCLI, isFlag } from '@internals/utils'\nimport { version } from '../package.json'\nimport { QUIET_FLAGS } from './constants.ts'\nimport { isTelemetryDisabled } from './telemetry.ts'\n\nconst cli = createCLI()\n\nfunction shouldShowTelemetryNotice(argv: Array<string>): boolean {\n  if (isTelemetryDisabled()) {\n    return false\n  }\n\n  // Skip when the user is just asking for help or version info\n  if (argv.some((arg) => isFlag(QUIET_FLAGS, arg))) {\n    return false\n  }\n\n  // Skip in non-interactive / scripting contexts\n  if (!process.stdout.isTTY) {\n    return false\n  }\n\n  return true\n}\n\nexport async function run(argv: Array<string> = process.argv): Promise<void> {\n  if (shouldShowTelemetryNotice(argv)) {\n    console.log(\n      `${styleText('yellow', 'Notice:')} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \\nTo disable, set ${styleText('cyan', 'KUBB_DISABLE_TELEMETRY=1')}.\\n`,\n    )\n  }\n\n  const { command: generateCommand } = await import('./commands/generate.ts')\n  const { command: validateCommand } = await import('./commands/validate.ts')\n  const { command: mcpCommand } = await import('./commands/mcp.ts')\n  const { command: agentCommand } = await import('./commands/agent.ts')\n  const { command: initCommand } = await import('./commands/init.ts')\n\n  await cli.run([generateCommand, validateCommand, mcpCommand, agentCommand, initCommand], argv, {\n    programName: 'kubb',\n    defaultCommandName: 'generate',\n    version,\n  })\n}\n"],"mappings":"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"}

package/dist/init-BVYkUQ-b.cjs

@@ -0,0 +1,53 @@
+require("./chunk-ByKO4r7w.cjs");
+const require_define = require("./define-Bdn8j5VM.cjs");
+const require_package = require("./package-BvBzYG6c.cjs");
+//#region src/commands/init.ts
+const command = require_define.defineCommand({
+	name: "init",
+	description: "Scaffold a kubb.config.ts and install plugins for code generation from an OpenAPI spec. Run without flags for interactive setup, or pass --input, --output, and --plugins to skip the prompts.",
+	examples: [
+		"kubb init",
+		"kubb init --yes",
+		"kubb init --input ./openapi.yaml --output ./src/gen --plugins plugin-ts,plugin-zod",
+		"kubb init --plugins plugin-ts,plugin-client,plugin-react-query"
+	],
+	options: {
+		yes: {
+			type: "boolean",
+			description: "Skip prompts and use default options",
+			short: "y",
+			default: false
+		},
+		input: {
+			type: "string",
+			description: "Path to the OpenAPI specification",
+			short: "i",
+			hint: "path"
+		},
+		output: {
+			type: "string",
+			description: "Output directory for generated files",
+			short: "o",
+			hint: "path"
+		},
+		plugins: {
+			type: "string",
+			description: "Comma-separated list of plugins to use (plugin-ts, plugin-client, plugin-react-query, plugin-vue-query, plugin-zod, plugin-faker, plugin-msw, plugin-cypress, plugin-mcp, plugin-redoc)",
+			hint: "plugin-ts,plugin-zod,..."
+		}
+	},
+	async run({ values }) {
+		const { run } = await Promise.resolve().then(() => require("./run-YsoCk5we.cjs"));
+		await run({
+			yes: values.yes,
+			version: require_package.version,
+			input: values.input,
+			output: values.output,
+			plugins: values.plugins
+		});
+	}
+});
+//#endregion
+exports.command = command;
+
+//# sourceMappingURL=init-BVYkUQ-b.cjs.map

package/dist/init-BVYkUQ-b.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-BVYkUQ-b.cjs","names":["defineCommand"],"sources":["../src/commands/init.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'init',\n  description:\n    'Scaffold a kubb.config.ts and install plugins for code generation from an OpenAPI spec. Run without flags for interactive setup, or pass --input, --output, and --plugins to skip the prompts.',\n  examples: [\n    'kubb init',\n    'kubb init --yes',\n    'kubb init --input ./openapi.yaml --output ./src/gen --plugins plugin-ts,plugin-zod',\n    'kubb init --plugins plugin-ts,plugin-client,plugin-react-query',\n  ],\n  options: {\n    yes: {\n      type: 'boolean',\n      description: 'Skip prompts and use default options',\n      short: 'y',\n      default: false,\n    },\n    input: {\n      type: 'string',\n      description: 'Path to the OpenAPI specification',\n      short: 'i',\n      hint: 'path',\n    },\n    output: {\n      type: 'string',\n      description: 'Output directory for generated files',\n      short: 'o',\n      hint: 'path',\n    },\n    plugins: {\n      type: 'string',\n      description:\n        'Comma-separated list of plugins to use (plugin-ts, plugin-client, plugin-react-query, plugin-vue-query, plugin-zod, plugin-faker, plugin-msw, plugin-cypress, plugin-mcp, plugin-redoc)',\n      hint: 'plugin-ts,plugin-zod,...',\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/init/run.ts')\n\n    await run({\n      yes: values.yes,\n      version,\n      input: values.input,\n      output: values.output,\n      plugins: values.plugins,\n    })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAUA,eAAAA,cAAc;CACnC,MAAM;CACN,aACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACD;CACD,SAAS;EACP,KAAK;GACH,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACD,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,MAAM;GACP;EACD,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACP,MAAM;GACP;EACD,SAAS;GACP,MAAM;GACN,aACE;GACF,MAAM;GACP;EACF;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,QAAQ,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,qBAAA,CAAA;EAEtB,MAAM,IAAI;GACR,KAAK,OAAO;GACZ,SAAA,gBAAA;GACA,OAAO,OAAO;GACd,QAAQ,OAAO;GACf,SAAS,OAAO;GACjB,CAAC;;CAEL,CAAC"}

package/dist/init-BYlb-ua0.js

@@ -0,0 +1,53 @@
+import "./chunk-BvFE5Tac.js";
+import { n as defineCommand } from "./define-m_fp-Aqm.js";
+import { t as version } from "./package-s8PvCnk-.js";
+//#region src/commands/init.ts
+const command = defineCommand({
+	name: "init",
+	description: "Scaffold a kubb.config.ts and install plugins for code generation from an OpenAPI spec. Run without flags for interactive setup, or pass --input, --output, and --plugins to skip the prompts.",
+	examples: [
+		"kubb init",
+		"kubb init --yes",
+		"kubb init --input ./openapi.yaml --output ./src/gen --plugins plugin-ts,plugin-zod",
+		"kubb init --plugins plugin-ts,plugin-client,plugin-react-query"
+	],
+	options: {
+		yes: {
+			type: "boolean",
+			description: "Skip prompts and use default options",
+			short: "y",
+			default: false
+		},
+		input: {
+			type: "string",
+			description: "Path to the OpenAPI specification",
+			short: "i",
+			hint: "path"
+		},
+		output: {
+			type: "string",
+			description: "Output directory for generated files",
+			short: "o",
+			hint: "path"
+		},
+		plugins: {
+			type: "string",
+			description: "Comma-separated list of plugins to use (plugin-ts, plugin-client, plugin-react-query, plugin-vue-query, plugin-zod, plugin-faker, plugin-msw, plugin-cypress, plugin-mcp, plugin-redoc)",
+			hint: "plugin-ts,plugin-zod,..."
+		}
+	},
+	async run({ values }) {
+		const { run } = await import("./run-CF97BWVa.js");
+		await run({
+			yes: values.yes,
+			version,
+			input: values.input,
+			output: values.output,
+			plugins: values.plugins
+		});
+	}
+});
+//#endregion
+export { command };
+
+//# sourceMappingURL=init-BYlb-ua0.js.map

package/dist/init-BYlb-ua0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-BYlb-ua0.js","names":[],"sources":["../src/commands/init.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'init',\n  description:\n    'Scaffold a kubb.config.ts and install plugins for code generation from an OpenAPI spec. Run without flags for interactive setup, or pass --input, --output, and --plugins to skip the prompts.',\n  examples: [\n    'kubb init',\n    'kubb init --yes',\n    'kubb init --input ./openapi.yaml --output ./src/gen --plugins plugin-ts,plugin-zod',\n    'kubb init --plugins plugin-ts,plugin-client,plugin-react-query',\n  ],\n  options: {\n    yes: {\n      type: 'boolean',\n      description: 'Skip prompts and use default options',\n      short: 'y',\n      default: false,\n    },\n    input: {\n      type: 'string',\n      description: 'Path to the OpenAPI specification',\n      short: 'i',\n      hint: 'path',\n    },\n    output: {\n      type: 'string',\n      description: 'Output directory for generated files',\n      short: 'o',\n      hint: 'path',\n    },\n    plugins: {\n      type: 'string',\n      description:\n        'Comma-separated list of plugins to use (plugin-ts, plugin-client, plugin-react-query, plugin-vue-query, plugin-zod, plugin-faker, plugin-msw, plugin-cypress, plugin-mcp, plugin-redoc)',\n      hint: 'plugin-ts,plugin-zod,...',\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/init/run.ts')\n\n    await run({\n      yes: values.yes,\n      version,\n      input: values.input,\n      output: values.output,\n      plugins: values.plugins,\n    })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACD;CACD,SAAS;EACP,KAAK;GACH,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACD,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,MAAM;GACP;EACD,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACP,MAAM;GACP;EACD,SAAS;GACP,MAAM;GACN,aACE;GACF,MAAM;GACP;EACF;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,QAAQ,MAAM,OAAO;EAE7B,MAAM,IAAI;GACR,KAAK,OAAO;GACZ;GACA,OAAO,OAAO;GACd,QAAQ,OAAO;GACf,SAAS,OAAO;GACjB,CAAC;;CAEL,CAAC"}

package/dist/mcp-Bm2Q7YdS.js

@@ -0,0 +1,39 @@
+import "./chunk-BvFE5Tac.js";
+import { n as defineCommand } from "./define-m_fp-Aqm.js";
+import { t as version } from "./package-s8PvCnk-.js";
+//#region src/commands/mcp.ts
+const command = defineCommand({
+	name: "mcp",
+	description: "Start a Model Context Protocol (MCP) server that exposes Kubb code generation as tools for AI assistants. Once running, configure your AI client (Claude, Cursor, Windsurf, etc.) to connect to it — the assistant can then call kubb generate directly without leaving the chat.",
+	examples: [
+		"kubb mcp",
+		"kubb mcp --port 3001",
+		"# Then add to your MCP client config:",
+		"# { \"mcpServers\": { \"kubb\": { \"command\": \"npx\", \"args\": [\"kubb\", \"mcp\"] } } }"
+	],
+	options: {
+		port: {
+			type: "string",
+			short: "p",
+			description: "Port for HTTP MCP server (omit for stdio)",
+			hint: "number"
+		},
+		host: {
+			type: "string",
+			description: "Hostname to bind to (HTTP mode only)",
+			default: "localhost"
+		}
+	},
+	async run({ values }) {
+		const { run } = await import("./run-D0hmRpHy.js");
+		await run({
+			version,
+			port: values.port,
+			host: values.host
+		});
+	}
+});
+//#endregion
+export { command };
+
+//# sourceMappingURL=mcp-Bm2Q7YdS.js.map

package/dist/mcp-Bm2Q7YdS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-Bm2Q7YdS.js","names":[],"sources":["../src/commands/mcp.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'mcp',\n  description:\n    'Start a Model Context Protocol (MCP) server that exposes Kubb code generation as tools for AI assistants. Once running, configure your AI client (Claude, Cursor, Windsurf, etc.) to connect to it — the assistant can then call kubb generate directly without leaving the chat.',\n  examples: [\n    'kubb mcp',\n    'kubb mcp --port 3001',\n    '# Then add to your MCP client config:',\n    '# { \"mcpServers\": { \"kubb\": { \"command\": \"npx\", \"args\": [\"kubb\", \"mcp\"] } } }',\n  ],\n  options: {\n    port: {\n      type: 'string',\n      short: 'p',\n      description: 'Port for HTTP MCP server (omit for stdio)',\n      hint: 'number',\n    },\n    host: {\n      type: 'string',\n      description: 'Hostname to bind to (HTTP mode only)',\n      default: 'localhost',\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/mcp/run.ts')\n\n    await run({\n      version,\n      port: values.port,\n      host: values.host,\n    })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACD;CACD,SAAS;EACP,MAAM;GACJ,MAAM;GACN,OAAO;GACP,aAAa;GACb,MAAM;GACP;EACD,MAAM;GACJ,MAAM;GACN,aAAa;GACb,SAAS;GACV;EACF;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,QAAQ,MAAM,OAAO;EAE7B,MAAM,IAAI;GACR;GACA,MAAM,OAAO;GACb,MAAM,OAAO;GACd,CAAC;;CAEL,CAAC"}

package/dist/mcp-CiNoagVX.cjs

@@ -0,0 +1,39 @@
+require("./chunk-ByKO4r7w.cjs");
+const require_define = require("./define-Bdn8j5VM.cjs");
+const require_package = require("./package-BvBzYG6c.cjs");
+//#region src/commands/mcp.ts
+const command = require_define.defineCommand({
+	name: "mcp",
+	description: "Start a Model Context Protocol (MCP) server that exposes Kubb code generation as tools for AI assistants. Once running, configure your AI client (Claude, Cursor, Windsurf, etc.) to connect to it — the assistant can then call kubb generate directly without leaving the chat.",
+	examples: [
+		"kubb mcp",
+		"kubb mcp --port 3001",
+		"# Then add to your MCP client config:",
+		"# { \"mcpServers\": { \"kubb\": { \"command\": \"npx\", \"args\": [\"kubb\", \"mcp\"] } } }"
+	],
+	options: {
+		port: {
+			type: "string",
+			short: "p",
+			description: "Port for HTTP MCP server (omit for stdio)",
+			hint: "number"
+		},
+		host: {
+			type: "string",
+			description: "Hostname to bind to (HTTP mode only)",
+			default: "localhost"
+		}
+	},
+	async run({ values }) {
+		const { run } = await Promise.resolve().then(() => require("./run-Lr0Ctnu0.cjs"));
+		await run({
+			version: require_package.version,
+			port: values.port,
+			host: values.host
+		});
+	}
+});
+//#endregion
+exports.command = command;
+
+//# sourceMappingURL=mcp-CiNoagVX.cjs.map

package/dist/mcp-CiNoagVX.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-CiNoagVX.cjs","names":["defineCommand"],"sources":["../src/commands/mcp.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'mcp',\n  description:\n    'Start a Model Context Protocol (MCP) server that exposes Kubb code generation as tools for AI assistants. Once running, configure your AI client (Claude, Cursor, Windsurf, etc.) to connect to it — the assistant can then call kubb generate directly without leaving the chat.',\n  examples: [\n    'kubb mcp',\n    'kubb mcp --port 3001',\n    '# Then add to your MCP client config:',\n    '# { \"mcpServers\": { \"kubb\": { \"command\": \"npx\", \"args\": [\"kubb\", \"mcp\"] } } }',\n  ],\n  options: {\n    port: {\n      type: 'string',\n      short: 'p',\n      description: 'Port for HTTP MCP server (omit for stdio)',\n      hint: 'number',\n    },\n    host: {\n      type: 'string',\n      description: 'Hostname to bind to (HTTP mode only)',\n      default: 'localhost',\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/mcp/run.ts')\n\n    await run({\n      version,\n      port: values.port,\n      host: values.host,\n    })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAUA,eAAAA,cAAc;CACnC,MAAM;CACN,aACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACD;CACD,SAAS;EACP,MAAM;GACJ,MAAM;GACN,OAAO;GACP,aAAa;GACb,MAAM;GACP;EACD,MAAM;GACJ,MAAM;GACN,aAAa;GACb,SAAS;GACV;EACF;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,QAAQ,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,qBAAA,CAAA;EAEtB,MAAM,IAAI;GACR,SAAA,gBAAA;GACA,MAAM,OAAO;GACb,MAAM,OAAO;GACd,CAAC;;CAEL,CAAC"}

package/dist/{package-D5arPDnh.cjs → package-BvBzYG6c.cjs}

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "5.0.0-beta.75";
+var version = "5.0.0-beta.8";
 //#endregion
 Object.defineProperty(exports, "version", {
 	enumerable: true,
@@ -8,4 +8,4 @@ Object.defineProperty(exports, "version", {
 	}
 });
 
-//# sourceMappingURL=package-D5arPDnh.cjs.map
+//# sourceMappingURL=package-BvBzYG6c.cjs.map

package/dist/package-BvBzYG6c.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-BvBzYG6c.cjs","names":[],"sources":["../package.json"],"sourcesContent":[""],"mappings":""}

package/dist/package-s8PvCnk-.js

@@ -0,0 +1,6 @@
+//#region package.json
+var version = "5.0.0-beta.8";
+//#endregion
+export { version as t };
+
+//# sourceMappingURL=package-s8PvCnk-.js.map

package/dist/package-s8PvCnk-.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-s8PvCnk-.js","names":[],"sources":["../package.json"],"sourcesContent":[""],"mappings":""}

package/dist/{agent-Ev5hU5hH.js → run-BzpYYOQs.js}

@@ -1,24 +1,25 @@
-import "./chunk--u3MIqq1.js";
-import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-LgT_sdPe.js";
-import { t as spawnAsync } from "./shell-DLzN4fRo.js";
-import { s as agentDefaults } from "./constants-aL3CP_Wq.js";
+import "./chunk-BvFE5Tac.js";
+import { t as getErrorMessage } from "./errors-CINO1EIv.js";
+import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-BkektVz6.js";
+import { t as spawnAsync } from "./shell-CN6DNqeC.js";
+import { o as agentDefaults } from "./constants-B2JTeRBb.js";
+import { createRequire } from "node:module";
 import { styleText } from "node:util";
 import path from "node:path";
-import * as process$1 from "node:process";
-import net from "node:net";
-import { fileURLToPath } from "node:url";
+import process from "node:process";
 import * as clack from "@clack/prompts";
-//#region src/runners/agent.ts
+import net from "node:net";
+//#region src/runners/agent/utils.ts
 /**
 * Resolves the environment passed to the detached agent process using CLI values first, then environment values, then CLI defaults.
 */
 function resolveAgentStartEnvironment({ port, host, configPath, allowWrite, allowAll }) {
-	const resolvedPort = port ?? process$1.env.PORT ?? agentDefaults.port;
-	const resolvedHost = host !== agentDefaults.host ? host : process$1.env.HOST ?? agentDefaults.host;
-	const resolvedAllowAll = allowAll || process$1.env.KUBB_AGENT_ALLOW_ALL === "true";
-	const resolvedAllowWrite = resolvedAllowAll || allowWrite || process$1.env.KUBB_AGENT_ALLOW_WRITE === "true";
-	const agentRoot = process$1.env.KUBB_AGENT_ROOT ?? process$1.cwd();
-	const agentConfigPath = path.resolve(process$1.cwd(), configPath || process$1.env.KUBB_AGENT_CONFIG || agentDefaults.configFile);
+	const resolvedPort = port ?? process.env.PORT ?? agentDefaults.port;
+	const resolvedHost = host !== agentDefaults.host ? host : process.env.HOST ?? agentDefaults.host;
+	const resolvedAllowAll = allowAll || process.env.KUBB_AGENT_ALLOW_ALL === "true";
+	const resolvedAllowWrite = resolvedAllowAll || allowWrite || process.env.KUBB_AGENT_ALLOW_WRITE === "true";
+	const agentRoot = process.env.KUBB_AGENT_ROOT ?? process.cwd();
+	const agentConfigPath = path.resolve(process.cwd(), configPath || process.env.KUBB_AGENT_CONFIG || agentDefaults.configFile);
 	return {
 		port: resolvedPort,
 		host: resolvedHost,
@@ -26,16 +27,16 @@ function resolveAgentStartEnvironment({ port, host, configPath, allowWrite, allo
 		allowAll: resolvedAllowAll,
 		agentConfigPath,
 		env: {
-			...process$1.env,
+			...process.env,
 			PORT: resolvedPort,
 			HOST: resolvedHost,
 			KUBB_AGENT_ROOT: agentRoot,
 			KUBB_AGENT_CONFIG: agentConfigPath,
 			KUBB_AGENT_ALLOW_WRITE: String(resolvedAllowWrite),
 			KUBB_AGENT_ALLOW_ALL: String(resolvedAllowAll),
-			KUBB_AGENT_TOKEN: process$1.env.KUBB_AGENT_TOKEN,
-			KUBB_AGENT_RETRY_TIMEOUT: process$1.env.KUBB_AGENT_RETRY_TIMEOUT ?? agentDefaults.retryTimeout,
-			KUBB_STUDIO_URL: process$1.env.KUBB_STUDIO_URL ?? agentDefaults.studioUrl
+			KUBB_AGENT_TOKEN: process.env.KUBB_AGENT_TOKEN,
+			KUBB_AGENT_RETRY_TIMEOUT: process.env.KUBB_AGENT_RETRY_TIMEOUT ?? agentDefaults.retryTimeout,
+			KUBB_STUDIO_URL: process.env.KUBB_STUDIO_URL ?? agentDefaults.studioUrl
 		}
 	};
 }
@@ -50,20 +51,38 @@ function isPortAvailable(port, host) {
 		server.listen(port, host);
 	});
 }
-async function runAgentStart({ port, host, configPath, allowWrite, allowAll, version }) {
-	const hrStart = process$1.hrtime();
+//#endregion
+//#region src/runners/agent/run.ts
+/**
+* Spawns the Kubb Agent HTTP server as a Node.js subprocess.
+* Resolves config from CLI flags and environment variables, validates the port, and exits with code 1 on failure.
+*/
+async function run({ port, host, configPath, allowWrite, allowAll, version }) {
+	const hrStart = process.hrtime();
+	const report = (status) => sendTelemetry(buildTelemetryEvent({
+		command: "agent",
+		kubbVersion: version,
+		hrStart,
+		status
+	}));
 	try {
 		try {
-			process$1.loadEnvFile();
+			process.loadEnvFile();
 		} catch {}
-		let agentPkgUrl;
+		const require = createRequire(import.meta.url);
+		let agentPkgPath;
 		try {
-			agentPkgUrl = import.meta.resolve("@kubb/agent/package.json");
+			agentPkgPath = require.resolve("@kubb/agent/package.json");
 		} catch (_e) {
-			console.error(`Import of '@kubb/agent' is required to start the Agent server`);
-			process$1.exit(1);
+			console.error(styleText("red", "The @kubb/agent package is not installed."));
+			console.error("");
+			console.error("Install it with:");
+			console.error(styleText("cyan", "  npm install @kubb/agent"));
+			console.error(styleText("cyan", "  # or"));
+			console.error(styleText("cyan", "  pnpm install @kubb/agent"));
+			console.error("");
+			process.exit(1);
 		}
-		const agentPkgPath = fileURLToPath(agentPkgUrl);
 		const agentDir = path.dirname(agentPkgPath);
 		const serverPath = path.join(agentDir, agentDefaults.serverEntryPath);
 		const resolvedEnv = resolveAgentStartEnvironment({
@@ -82,31 +101,21 @@ async function runAgentStart({ port, host, configPath, allowWrite, allowAll, ver
 		if (!resolvedEnv.allowWrite && !resolvedEnv.allowAll) clack.log.warn(styleText("yellow", "Filesystem writes disabled. Use --allow-write or --allow-all to enable."));
 		if (!await isPortAvailable(numericPort, resolvedEnv.host)) {
 			clack.log.error(styleText("red", `Port ${resolvedEnv.port} is already in use. Stop the existing process or choose a different port with --port.`));
-			process$1.exit(1);
+			process.exit(1);
 		}
 		await spawnAsync("node", [serverPath], {
 			env: resolvedEnv.env,
-			cwd: process$1.cwd()
+			cwd: process.cwd()
 		});
-		await sendTelemetry(buildTelemetryEvent({
-			command: "agent",
-			kubbVersion: version,
-			hrStart,
-			status: "success"
-		}));
+		await report("success");
 	} catch (error) {
-		await sendTelemetry(buildTelemetryEvent({
-			command: "agent",
-			kubbVersion: version,
-			hrStart,
-			status: "failed"
-		}));
+		await report("failed");
 		clack.log.error(styleText("red", "Failed to start agent server"));
-		console.error(error);
-		process$1.exit(1);
+		clack.log.error(getErrorMessage(error));
+		process.exit(1);
 	}
 }
 //#endregion
-export { runAgentStart };
+export { run };
 
-//# sourceMappingURL=agent-Ev5hU5hH.js.map
+//# sourceMappingURL=run-BzpYYOQs.js.map

package/dist/run-BzpYYOQs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-BzpYYOQs.js","names":[],"sources":["../src/runners/agent/utils.ts","../src/runners/agent/run.ts"],"sourcesContent":["import net from 'node:net'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { agentDefaults } from '../../constants.ts'\n\ntype AgentStartEnvironmentInput = {\n  /**\n   * TCP port for the HTTP server. When `undefined`, falls back to `PORT` env var or the default (`3000`).\n   */\n  port: string | undefined\n  /**\n   * Hostname the HTTP server binds to.\n   */\n  host: string\n  /**\n   * Explicit path to the Kubb config file. When `undefined`, falls back to `KUBB_AGENT_CONFIG` or the default filename.\n   */\n  configPath: string | undefined\n  /**\n   * Grants the agent permission to write generated files to the filesystem.\n   */\n  allowWrite: boolean\n  /**\n   * Grants all agent permissions, including filesystem writes. Implies `allowWrite`.\n   */\n  allowAll: boolean\n}\n\ntype ResolvedAgentStartEnvironment = {\n  /**\n   * Final port string after merging CLI flag, `PORT` env var, and the default.\n   */\n  port: string\n  /**\n   * Final hostname after merging CLI flag, `HOST` env var, and the default.\n   */\n  host: string\n  /**\n   * Effective write-permission flag, accounting for `allowAll` and `KUBB_AGENT_ALLOW_WRITE`.\n   */\n  allowWrite: boolean\n  /**\n   * Effective all-permissions flag, accounting for `KUBB_AGENT_ALLOW_ALL`.\n   */\n  allowAll: boolean\n  /**\n   * Absolute path to the Kubb config file passed to the agent subprocess.\n   */\n  agentConfigPath: string\n  /**\n   * Merged `process.env` object with all resolved agent environment variables applied.\n   */\n  env: NodeJS.ProcessEnv\n}\n\n/**\n * Resolves the environment passed to the detached agent process using CLI values first, then environment values, then CLI defaults.\n */\nexport function resolveAgentStartEnvironment({ port, host, configPath, allowWrite, allowAll }: AgentStartEnvironmentInput): ResolvedAgentStartEnvironment {\n  const resolvedPort = port ?? process.env.PORT ?? agentDefaults.port\n  const resolvedHost = host !== agentDefaults.host ? host : (process.env.HOST ?? agentDefaults.host)\n  const resolvedAllowAll = allowAll || process.env.KUBB_AGENT_ALLOW_ALL === 'true'\n  const resolvedAllowWrite = resolvedAllowAll || allowWrite || process.env.KUBB_AGENT_ALLOW_WRITE === 'true'\n  const agentRoot = process.env.KUBB_AGENT_ROOT ?? process.cwd()\n  const agentConfigPath = path.resolve(process.cwd(), configPath || process.env.KUBB_AGENT_CONFIG || agentDefaults.configFile)\n\n  return {\n    port: resolvedPort,\n    host: resolvedHost,\n    allowWrite: resolvedAllowWrite,\n    allowAll: resolvedAllowAll,\n    agentConfigPath,\n    env: {\n      ...process.env,\n      PORT: resolvedPort,\n      HOST: resolvedHost,\n      KUBB_AGENT_ROOT: agentRoot,\n      KUBB_AGENT_CONFIG: agentConfigPath,\n      KUBB_AGENT_ALLOW_WRITE: String(resolvedAllowWrite),\n      KUBB_AGENT_ALLOW_ALL: String(resolvedAllowAll),\n      KUBB_AGENT_TOKEN: process.env.KUBB_AGENT_TOKEN,\n      KUBB_AGENT_RETRY_TIMEOUT: process.env.KUBB_AGENT_RETRY_TIMEOUT ?? agentDefaults.retryTimeout,\n      KUBB_STUDIO_URL: process.env.KUBB_STUDIO_URL ?? agentDefaults.studioUrl,\n    },\n  }\n}\n\nexport function isPortAvailable(port: number, host: string): Promise<boolean> {\n  return new Promise((resolve) => {\n    const server = net.createServer()\n    server.once('error', () => resolve(false))\n    server.once('listening', () => {\n      server.close()\n      resolve(true)\n    })\n    server.listen(port, host)\n  })\n}\n","import { createRequire } from 'node:module'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { styleText } from 'node:util'\nimport * as clack from '@clack/prompts'\nimport { spawnAsync, getErrorMessage } from '@internals/utils'\nimport { agentDefaults } from '../../constants.ts'\nimport { buildTelemetryEvent, sendTelemetry } from '../../telemetry.ts'\nimport { isPortAvailable, resolveAgentStartEnvironment } from './utils.ts'\n\ntype AgentStartOptions = {\n  /**\n   * TCP port for the HTTP server. When `undefined`, falls back to `PORT` env var or the default (`3000`).\n   */\n  port: string | undefined\n  /**\n   * Hostname the HTTP server binds to.\n   *\n   * @default 'localhost'\n   */\n  host: string\n  /**\n   * Explicit path to the Kubb config file. When `undefined`, falls back to `KUBB_AGENT_CONFIG` or the default filename.\n   */\n  configPath: string | undefined\n  /**\n   * Grants the agent permission to write generated files to the filesystem.\n   */\n  allowWrite: boolean\n  /**\n   * Grants all agent permissions, including filesystem writes. Implies `allowWrite`.\n   */\n  allowAll: boolean\n  /**\n   * Current `@kubb/cli` version string, used for the telemetry payload.\n   */\n  version: string\n}\n\n/**\n * Spawns the Kubb Agent HTTP server as a Node.js subprocess.\n * Resolves config from CLI flags and environment variables, validates the port, and exits with code 1 on failure.\n */\nexport async function run({ port, host, configPath, allowWrite, allowAll, version }: AgentStartOptions): Promise<void> {\n  const hrStart = process.hrtime()\n  const report = (status: 'success' | 'failed') => sendTelemetry(buildTelemetryEvent({ command: 'agent', kubbVersion: version, hrStart, status }))\n\n  try {\n    // Load .env file into process.env using Node.js built-in (v20.12.0+)\n    try {\n      process.loadEnvFile()\n    } catch {\n      // .env file may not exist; ignore\n    }\n\n    // Resolve the @kubb/agent package path — createRequire is CJS/ESM compatible (import.meta.resolve is ESM-only)\n    const require = createRequire(import.meta.url)\n    let agentPkgPath: string\n    try {\n      agentPkgPath = require.resolve('@kubb/agent/package.json')\n    } catch (_e) {\n      console.error(styleText('red', 'The @kubb/agent package is not installed.'))\n      console.error('')\n      console.error('Install it with:')\n      console.error(styleText('cyan', '  npm install @kubb/agent'))\n      console.error(styleText('cyan', '  # or'))\n      console.error(styleText('cyan', '  pnpm install @kubb/agent'))\n      console.error('')\n      process.exit(1)\n    }\n    const agentDir = path.dirname(agentPkgPath)\n    const serverPath = path.join(agentDir, agentDefaults.serverEntryPath)\n\n    const resolvedEnv = resolveAgentStartEnvironment({\n      port,\n      host,\n      configPath,\n      allowWrite,\n      allowAll,\n    })\n    const numericPort = Number(resolvedEnv.port)\n\n    if (!Number.isInteger(numericPort) || numericPort <= 0) {\n      throw new Error(`Invalid port \"${resolvedEnv.port}\". Provide a positive integer with --port or PORT.`)\n    }\n\n    clack.log.step(styleText('cyan', 'Starting agent server...'))\n    clack.log.info(styleText('dim', `Config: ${resolvedEnv.agentConfigPath}`))\n    clack.log.info(styleText('dim', `Host: ${resolvedEnv.host}`))\n    clack.log.info(styleText('dim', `Port: ${resolvedEnv.port}`))\n    if (!resolvedEnv.allowWrite && !resolvedEnv.allowAll) {\n      clack.log.warn(styleText('yellow', 'Filesystem writes disabled. Use --allow-write or --allow-all to enable.'))\n    }\n\n    if (!(await isPortAvailable(numericPort, resolvedEnv.host))) {\n      clack.log.error(styleText('red', `Port ${resolvedEnv.port} is already in use. Stop the existing process or choose a different port with --port.`))\n      process.exit(1)\n    }\n\n    // Spawns the server as a detached background process so the CLI can exit independently.\n    await spawnAsync('node', [serverPath], {\n      env: resolvedEnv.env,\n      cwd: process.cwd(),\n    })\n\n    await report('success')\n  } catch (error) {\n    await report('failed')\n    clack.log.error(styleText('red', 'Failed to start agent server'))\n    clack.log.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":"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"}

package/dist/run-CCZ24VKk.js

@@ -0,0 +1,51 @@
+import "./chunk-BvFE5Tac.js";
+import { t as getErrorMessage } from "./errors-CINO1EIv.js";
+import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-BkektVz6.js";
+import { styleText } from "node:util";
+import process from "node:process";
+//#region src/runners/validate/run.ts
+/**
+* Dynamically loads `@kubb/adapter-oas` for OpenAPI validation.
+*/
+function loadValidateModule() {
+	return import("@kubb/adapter-oas");
+}
+/**
+* Validates an OpenAPI/Swagger file at `input` using `@kubb/adapter-oas`.
+* Exits the process with code 1 on validation failure or missing dependency.
+*/
+async function run({ input, version }, dependencies = { loadValidateModule }) {
+	const hrStart = process.hrtime();
+	const report = (status) => sendTelemetry(buildTelemetryEvent({
+		command: "validate",
+		kubbVersion: version,
+		hrStart,
+		status
+	}));
+	try {
+		const { adapterOas } = await dependencies.loadValidateModule();
+		const adapter = adapterOas();
+		if (!adapter.validate) throw new Error("The loaded adapter does not support validation.");
+		await adapter.validate(input, { throwOnError: true });
+		await report("success");
+		console.log("✅ Validation success");
+	} catch (error) {
+		await report("failed");
+		if (error instanceof Error && /@kubb\/adapter-oas/.test(error.message)) {
+			console.error(styleText("red", "The @kubb/adapter-oas package is not installed."));
+			console.error("");
+			console.error("Install it with:");
+			console.error(styleText("cyan", "  npm install @kubb/adapter-oas"));
+			console.error(styleText("cyan", "  # or"));
+			console.error(styleText("cyan", "  pnpm install @kubb/adapter-oas"));
+			console.error("");
+		}
+		console.error("❌ Validation failed");
+		console.error(getErrorMessage(error));
+		process.exit(1);
+	}
+}
+//#endregion
+export { run };
+
+//# sourceMappingURL=run-CCZ24VKk.js.map