@kubb/cli 5.0.0-alpha.17 → 5.0.0-alpha.18

package/dist/{mcp-CONmm_xT.cjs.map → mcp-B1QBsDAa.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"mcp-CONmm_xT.cjs","names":["jiti","process","sendTelemetry","buildTelemetryEvent","getErrorMessage"],"sources":["../src/runners/mcp.ts"],"sourcesContent":["import process from 'node:process'\nimport { styleText } from 'node:util'\nimport { getErrorMessage } from '@internals/utils'\nimport type * as McpModule from '@kubb/mcp'\nimport { jiti } from '../utils/jiti.ts'\nimport { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'\n\ntype McpOptions = {\n  version: string\n}\n\nexport async function runMcp({ version }: McpOptions): Promise<void> {\n  let mod: typeof McpModule\n  try {\n    mod = (await jiti.import('@kubb/mcp', { default: true })) as typeof McpModule\n  } catch (_e) {\n    console.error(`Import of '@kubb/mcp' is required to start the MCP server`)\n    process.exit(1)\n  }\n\n  const { run } = mod\n  const hrStart = process.hrtime()\n  try {\n    console.log('⏳ Starting MCP server...')\n    console.warn(styleText('yellow', 'This feature is still under development — use with caution'))\n    run()\n    await sendTelemetry(buildTelemetryEvent({ command: 'mcp', kubbVersion: version, hrStart, status: 'success' }))\n  } catch (error) {\n    await sendTelemetry(buildTelemetryEvent({ command: 'mcp', kubbVersion: version, hrStart, status: 'failed' }))\n    console.error(getErrorMessage(error))\n  }\n}\n"],"mappings":";;;;;;;;AAWA,eAAsB,OAAO,EAAE,WAAsC;CACnE,IAAI;AACJ,KAAI;AACF,QAAO,MAAMA,aAAAA,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;UACjD,IAAI;AACX,UAAQ,MAAM,4DAA4D;AAC1E,eAAA,QAAQ,KAAK,EAAE;;CAGjB,MAAM,EAAE,QAAQ;CAChB,MAAM,UAAUC,aAAAA,QAAQ,QAAQ;AAChC,KAAI;AACF,UAAQ,IAAI,2BAA2B;AACvC,UAAQ,MAAA,GAAA,UAAA,WAAe,UAAU,6DAA6D,CAAC;AAC/F,OAAK;AACL,QAAMC,kBAAAA,cAAcC,kBAAAA,oBAAoB;GAAE,SAAS;GAAO,aAAa;GAAS;GAAS,QAAQ;GAAW,CAAC,CAAC;UACvG,OAAO;AACd,QAAMD,kBAAAA,cAAcC,kBAAAA,oBAAoB;GAAE,SAAS;GAAO,aAAa;GAAS;GAAS,QAAQ;GAAU,CAAC,CAAC;AAC7G,UAAQ,MAAMC,eAAAA,gBAAgB,MAAM,CAAC"}
+{"version":3,"file":"mcp-B1QBsDAa.cjs","names":["jiti","process","sendTelemetry","buildTelemetryEvent","getErrorMessage"],"sources":["../src/runners/mcp.ts"],"sourcesContent":["import process from 'node:process'\nimport { styleText } from 'node:util'\nimport { getErrorMessage } from '@internals/utils'\nimport type * as McpModule from '@kubb/mcp'\nimport { jiti } from '../utils/jiti.ts'\nimport { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'\n\ntype McpOptions = {\n  version: string\n}\n\nexport async function runMcp({ version }: McpOptions): Promise<void> {\n  let mod: typeof McpModule\n  try {\n    mod = (await jiti.import('@kubb/mcp', { default: true })) as typeof McpModule\n  } catch (_e) {\n    console.error(`Import of '@kubb/mcp' is required to start the MCP server`)\n    process.exit(1)\n  }\n\n  const { run } = mod\n  const hrStart = process.hrtime()\n  try {\n    console.log('⏳ Starting MCP server...')\n    console.warn(styleText('yellow', 'This feature is still under development — use with caution'))\n    run()\n    await sendTelemetry(buildTelemetryEvent({ command: 'mcp', kubbVersion: version, hrStart, status: 'success' }))\n  } catch (error) {\n    await sendTelemetry(buildTelemetryEvent({ command: 'mcp', kubbVersion: version, hrStart, status: 'failed' }))\n    console.error(getErrorMessage(error))\n  }\n}\n"],"mappings":";;;;;;;;AAWA,eAAsB,OAAO,EAAE,WAAsC;CACnE,IAAI;AACJ,KAAI;AACF,QAAO,MAAMA,aAAAA,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;UACjD,IAAI;AACX,UAAQ,MAAM,4DAA4D;AAC1E,eAAA,QAAQ,KAAK,EAAE;;CAGjB,MAAM,EAAE,QAAQ;CAChB,MAAM,UAAUC,aAAAA,QAAQ,QAAQ;AAChC,KAAI;AACF,UAAQ,IAAI,2BAA2B;AACvC,UAAQ,MAAA,GAAA,UAAA,WAAe,UAAU,6DAA6D,CAAC;AAC/F,OAAK;AACL,QAAMC,kBAAAA,cAAcC,kBAAAA,oBAAoB;GAAE,SAAS;GAAO,aAAa;GAAS;GAAS,QAAQ;GAAW,CAAC,CAAC;UACvG,OAAO;AACd,QAAMD,kBAAAA,cAAcC,kBAAAA,oBAAoB;GAAE,SAAS;GAAO,aAAa;GAAS;GAAS,QAAQ;GAAU,CAAC,CAAC;AAC7G,UAAQ,MAAMC,eAAAA,gBAAgB,MAAM,CAAC"}

package/dist/{mcp-BUX9Sa4P.cjs → mcp-Bk73H7BV.cjs}

@@ -1,16 +1,16 @@
 require("./chunk-ByKO4r7w.cjs");
-const require_define = require("./define-D6Kfm7-Z.cjs");
-const require_package = require("./package-DoFD7DF6.cjs");
+const require_define = require("./define-Bdn8j5VM.cjs");
+const require_package = require("./package-ELXKKj4Y.cjs");
 //#region src/commands/mcp.ts
 const command = require_define.defineCommand({
 	name: "mcp",
 	description: "Start the server to enable the MCP client to interact with the LLM.",
 	async run() {
-		const { runMcp } = await Promise.resolve().then(() => require("./mcp-CONmm_xT.cjs"));
+		const { runMcp } = await Promise.resolve().then(() => require("./mcp-B1QBsDAa.cjs"));
 		await runMcp({ version: require_package.version });
 	}
 });
 //#endregion
 exports.command = command;
 
-//# sourceMappingURL=mcp-BUX9Sa4P.cjs.map
+//# sourceMappingURL=mcp-Bk73H7BV.cjs.map

package/dist/{mcp-BUX9Sa4P.cjs.map → mcp-Bk73H7BV.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"mcp-BUX9Sa4P.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: 'Start the server to enable the MCP client to interact with the LLM.',\n  async run() {\n    const { runMcp } = await import('../runners/mcp.ts')\n\n    await runMcp({ version })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAUA,eAAAA,cAAc;CACnC,MAAM;CACN,aAAa;CACb,MAAM,MAAM;EACV,MAAM,EAAE,WAAW,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,qBAAA,CAAA;AAEzB,QAAM,OAAO,EAAE,SAAA,gBAAA,SAAS,CAAC;;CAE5B,CAAC"}
+{"version":3,"file":"mcp-Bk73H7BV.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: 'Start the server to enable the MCP client to interact with the LLM.',\n  async run() {\n    const { runMcp } = await import('../runners/mcp.ts')\n\n    await runMcp({ version })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAUA,eAAAA,cAAc;CACnC,MAAM;CACN,aAAa;CACb,MAAM,MAAM;EACV,MAAM,EAAE,WAAW,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,qBAAA,CAAA;AAEzB,QAAM,OAAO,EAAE,SAAA,gBAAA,SAAS,CAAC;;CAE5B,CAAC"}

package/dist/{mcp-BiGUvbWP.js → mcp-BzHyPR8C.js}

@@ -1,6 +1,6 @@
 import "./chunk--u3MIqq1.js";
-import { t as getErrorMessage } from "./errors-6mF_WKxg.js";
-import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-BF3SMlH6.js";
+import { t as getErrorMessage } from "./errors-CjPmyZHy.js";
+import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-BDtfsYde.js";
 import { t as jiti } from "./jiti-e08mD2Ph.js";
 import { styleText } from "node:util";
 import process from "node:process";
@@ -38,4 +38,4 @@ async function runMcp({ version }) {
 //#endregion
 export { runMcp };
 
-//# sourceMappingURL=mcp-BiGUvbWP.js.map
+//# sourceMappingURL=mcp-BzHyPR8C.js.map

package/dist/{mcp-BiGUvbWP.js.map → mcp-BzHyPR8C.js.map}

@@ -1 +1 @@
-{"version":3,"file":"mcp-BiGUvbWP.js","names":[],"sources":["../src/runners/mcp.ts"],"sourcesContent":["import process from 'node:process'\nimport { styleText } from 'node:util'\nimport { getErrorMessage } from '@internals/utils'\nimport type * as McpModule from '@kubb/mcp'\nimport { jiti } from '../utils/jiti.ts'\nimport { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'\n\ntype McpOptions = {\n  version: string\n}\n\nexport async function runMcp({ version }: McpOptions): Promise<void> {\n  let mod: typeof McpModule\n  try {\n    mod = (await jiti.import('@kubb/mcp', { default: true })) as typeof McpModule\n  } catch (_e) {\n    console.error(`Import of '@kubb/mcp' is required to start the MCP server`)\n    process.exit(1)\n  }\n\n  const { run } = mod\n  const hrStart = process.hrtime()\n  try {\n    console.log('⏳ Starting MCP server...')\n    console.warn(styleText('yellow', 'This feature is still under development — use with caution'))\n    run()\n    await sendTelemetry(buildTelemetryEvent({ command: 'mcp', kubbVersion: version, hrStart, status: 'success' }))\n  } catch (error) {\n    await sendTelemetry(buildTelemetryEvent({ command: 'mcp', kubbVersion: version, hrStart, status: 'failed' }))\n    console.error(getErrorMessage(error))\n  }\n}\n"],"mappings":";;;;;;;AAWA,eAAsB,OAAO,EAAE,WAAsC;CACnE,IAAI;AACJ,KAAI;AACF,QAAO,MAAM,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;UACjD,IAAI;AACX,UAAQ,MAAM,4DAA4D;AAC1E,UAAQ,KAAK,EAAE;;CAGjB,MAAM,EAAE,QAAQ;CAChB,MAAM,UAAU,QAAQ,QAAQ;AAChC,KAAI;AACF,UAAQ,IAAI,2BAA2B;AACvC,UAAQ,KAAK,UAAU,UAAU,6DAA6D,CAAC;AAC/F,OAAK;AACL,QAAM,cAAc,oBAAoB;GAAE,SAAS;GAAO,aAAa;GAAS;GAAS,QAAQ;GAAW,CAAC,CAAC;UACvG,OAAO;AACd,QAAM,cAAc,oBAAoB;GAAE,SAAS;GAAO,aAAa;GAAS;GAAS,QAAQ;GAAU,CAAC,CAAC;AAC7G,UAAQ,MAAM,gBAAgB,MAAM,CAAC"}
+{"version":3,"file":"mcp-BzHyPR8C.js","names":[],"sources":["../src/runners/mcp.ts"],"sourcesContent":["import process from 'node:process'\nimport { styleText } from 'node:util'\nimport { getErrorMessage } from '@internals/utils'\nimport type * as McpModule from '@kubb/mcp'\nimport { jiti } from '../utils/jiti.ts'\nimport { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'\n\ntype McpOptions = {\n  version: string\n}\n\nexport async function runMcp({ version }: McpOptions): Promise<void> {\n  let mod: typeof McpModule\n  try {\n    mod = (await jiti.import('@kubb/mcp', { default: true })) as typeof McpModule\n  } catch (_e) {\n    console.error(`Import of '@kubb/mcp' is required to start the MCP server`)\n    process.exit(1)\n  }\n\n  const { run } = mod\n  const hrStart = process.hrtime()\n  try {\n    console.log('⏳ Starting MCP server...')\n    console.warn(styleText('yellow', 'This feature is still under development — use with caution'))\n    run()\n    await sendTelemetry(buildTelemetryEvent({ command: 'mcp', kubbVersion: version, hrStart, status: 'success' }))\n  } catch (error) {\n    await sendTelemetry(buildTelemetryEvent({ command: 'mcp', kubbVersion: version, hrStart, status: 'failed' }))\n    console.error(getErrorMessage(error))\n  }\n}\n"],"mappings":";;;;;;;AAWA,eAAsB,OAAO,EAAE,WAAsC;CACnE,IAAI;AACJ,KAAI;AACF,QAAO,MAAM,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;UACjD,IAAI;AACX,UAAQ,MAAM,4DAA4D;AAC1E,UAAQ,KAAK,EAAE;;CAGjB,MAAM,EAAE,QAAQ;CAChB,MAAM,UAAU,QAAQ,QAAQ;AAChC,KAAI;AACF,UAAQ,IAAI,2BAA2B;AACvC,UAAQ,KAAK,UAAU,UAAU,6DAA6D,CAAC;AAC/F,OAAK;AACL,QAAM,cAAc,oBAAoB;GAAE,SAAS;GAAO,aAAa;GAAS;GAAS,QAAQ;GAAW,CAAC,CAAC;UACvG,OAAO;AACd,QAAM,cAAc,oBAAoB;GAAE,SAAS;GAAO,aAAa;GAAS;GAAS,QAAQ;GAAU,CAAC,CAAC;AAC7G,UAAQ,MAAM,gBAAgB,MAAM,CAAC"}

package/dist/{mcp-yOOdC8cL.js → mcp-CI8Wgcgg.js}

@@ -1,16 +1,16 @@
 import "./chunk--u3MIqq1.js";
-import { n as defineCommand } from "./define--M_JMcDC.js";
-import { t as version } from "./package-CheJ57Am.js";
+import { n as defineCommand } from "./define-Ctii4bel.js";
+import { t as version } from "./package-HdPHmGk2.js";
 //#region src/commands/mcp.ts
 const command = defineCommand({
 	name: "mcp",
 	description: "Start the server to enable the MCP client to interact with the LLM.",
 	async run() {
-		const { runMcp } = await import("./mcp-BiGUvbWP.js");
+		const { runMcp } = await import("./mcp-BzHyPR8C.js");
 		await runMcp({ version });
 	}
 });
 //#endregion
 export { command };
 
-//# sourceMappingURL=mcp-yOOdC8cL.js.map
+//# sourceMappingURL=mcp-CI8Wgcgg.js.map

package/dist/{mcp-yOOdC8cL.js.map → mcp-CI8Wgcgg.js.map}

@@ -1 +1 @@
-{"version":3,"file":"mcp-yOOdC8cL.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: 'Start the server to enable the MCP client to interact with the LLM.',\n  async run() {\n    const { runMcp } = await import('../runners/mcp.ts')\n\n    await runMcp({ version })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aAAa;CACb,MAAM,MAAM;EACV,MAAM,EAAE,WAAW,MAAM,OAAO;AAEhC,QAAM,OAAO,EAAE,SAAS,CAAC;;CAE5B,CAAC"}
+{"version":3,"file":"mcp-CI8Wgcgg.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: 'Start the server to enable the MCP client to interact with the LLM.',\n  async run() {\n    const { runMcp } = await import('../runners/mcp.ts')\n\n    await runMcp({ version })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aAAa;CACb,MAAM,MAAM;EACV,MAAM,EAAE,WAAW,MAAM,OAAO;AAEhC,QAAM,OAAO,EAAE,SAAS,CAAC;;CAE5B,CAAC"}

package/dist/{package-DoFD7DF6.cjs → package-ELXKKj4Y.cjs}

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "5.0.0-alpha.17";
+var version = "5.0.0-alpha.18";
 //#endregion
 Object.defineProperty(exports, "version", {
 	enumerable: true,
@@ -8,4 +8,4 @@ Object.defineProperty(exports, "version", {
 	}
 });
 
-//# sourceMappingURL=package-DoFD7DF6.cjs.map
+//# sourceMappingURL=package-ELXKKj4Y.cjs.map

package/dist/package-ELXKKj4Y.cjs.map

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

package/dist/package-HdPHmGk2.js

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

package/dist/package-HdPHmGk2.js.map

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

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;AAClD,SAAQ,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;AAEvD,QAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,SAAA,GAAA,mBAAA,OAAc,KAAK,MAAM;GAC7B,OAAO,WAAW,WAAW;GAC7B;GACA;GACA;GACD,CAAC;AAEF,MAAI,UAAU;AACZ,SAAM,OAAO;AACb,YAAS;AACT;;AAGF,QAAM,GAAG,UAAU,MAAM,WAAW;AAClC,OAAI,SAAS,EACX,UAAS;YACA,WAAW,KACpB,wBAAO,IAAI,MAAM,IAAI,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,6BAA6B,SAAS,CAAC;OAElF,wBAAO,IAAI,MAAM,IAAI,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,qBAAqB,OAAO,CAAC;IAE1E;AACF,QAAM,GAAG,SAAS,OAAO;GACzB"}

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

@@ -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-DLzN4fRo.js.map

package/dist/shell-DLzN4fRo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-DLzN4fRo.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;AAClD,SAAQ,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;AAEvD,QAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,QAAQ,MAAM,KAAK,MAAM;GAC7B,OAAO,WAAW,WAAW;GAC7B;GACA;GACA;GACD,CAAC;AAEF,MAAI,UAAU;AACZ,SAAM,OAAO;AACb,YAAS;AACT;;AAGF,QAAM,GAAG,UAAU,MAAM,WAAW;AAClC,OAAI,SAAS,EACX,UAAS;YACA,WAAW,KACpB,wBAAO,IAAI,MAAM,IAAI,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,6BAA6B,SAAS,CAAC;OAElF,wBAAO,IAAI,MAAM,IAAI,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,qBAAqB,OAAO,CAAC;IAE1E;AACF,QAAM,GAAG,SAAS,OAAO;GACzB"}

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

@@ -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,35 @@ 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.
+*
+* @example
+* ```ts
+* if (canUseTTY()) {
+*   renderProgressBar()
+* }
+* ```
 */
 function canUseTTY() {
 	return !!process.stdout.isTTY && !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 +58,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 +76,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;
@@ -200,4 +236,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-BDtfsYde.js.map

package/dist/telemetry-BDtfsYde.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-BDtfsYde.js","names":["dnsPromises","process"],"sources":["../../../internals/utils/src/env.ts","../../../internals/utils/src/network.ts","../src/utils/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 and is not running in CI.\n *\n * @example\n * ```ts\n * if (canUseTTY()) {\n *   renderProgressBar()\n * }\n * ```\n */\nexport function canUseTTY(): boolean {\n  return !!process.stdout.isTTY && !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\nexport type TelemetryPlugin = {\n  name: string\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 * Detect whether the current process is running inside a CI environment.\n * Delegates to the canonical isCIEnvironment() from envDetection.\n */\nexport function isCi(): boolean {\n  return isCIEnvironment()\n}\n\n/**\n * Check if telemetry is disabled via DO_NOT_TRACK or KUBB_DISABLE_TELEMETRY.\n * Respects the standard DO_NOT_TRACK convention used across development tools.\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                  { key: 'options', value: { stringValue: JSON.stringify({ ...p.options, usedEnumNames: undefined }) } },\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            { key: 'service.version', value: { stringValue: event.kubbVersion } },\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: { code: (event.status === 'success' ? 1 : 2) satisfies OtlpStatusCode },\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-DZ7IrLAU.cjs → telemetry-CocGsmb6.cjs}

@@ -9,6 +9,13 @@ node_process = require_chunk.__toESM(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;
@@ -17,19 +24,35 @@ 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.
+*
+* @example
+* ```ts
+* if (canUseTTY()) {
+*   renderProgressBar()
+* }
+* ```
 */
 function canUseTTY() {
 	return !!process.stdout.isTTY && !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 +60,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 +78,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;
@@ -237,4 +273,4 @@ Object.defineProperty(exports, "sendTelemetry", {
 	}
 });
 
-//# sourceMappingURL=telemetry-DZ7IrLAU.cjs.map
+//# sourceMappingURL=telemetry-CocGsmb6.cjs.map

package/dist/telemetry-CocGsmb6.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-CocGsmb6.cjs","names":["dnsPromises","process","OTLP_ENDPOINT","os"],"sources":["../../../internals/utils/src/env.ts","../../../internals/utils/src/network.ts","../src/utils/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 and is not running in CI.\n *\n * @example\n * ```ts\n * if (canUseTTY()) {\n *   renderProgressBar()\n * }\n * ```\n */\nexport function canUseTTY(): boolean {\n  return !!process.stdout.isTTY && !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\nexport type TelemetryPlugin = {\n  name: string\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 * Detect whether the current process is running inside a CI environment.\n * Delegates to the canonical isCIEnvironment() from envDetection.\n */\nexport function isCi(): boolean {\n  return isCIEnvironment()\n}\n\n/**\n * Check if telemetry is disabled via DO_NOT_TRACK or KUBB_DISABLE_TELEMETRY.\n * Respects the standard DO_NOT_TRACK convention used across development tools.\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                  { key: 'options', value: { stringValue: JSON.stringify({ ...p.options, usedEnumNames: undefined }) } },\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            { key: 'service.version', value: { stringValue: event.kubbVersion } },\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: { code: (event.status === 'success' ? 1 : 2) satisfies OtlpStatusCode },\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/{validate-D5EYrHAr.cjs → validate-B-XUhWlq.cjs}

@@ -1,6 +1,6 @@
 require("./chunk-ByKO4r7w.cjs");
-const require_define = require("./define-D6Kfm7-Z.cjs");
-const require_package = require("./package-DoFD7DF6.cjs");
+const require_define = require("./define-Bdn8j5VM.cjs");
+const require_package = require("./package-ELXKKj4Y.cjs");
 //#region src/commands/validate.ts
 const command = require_define.defineCommand({
 	name: "validate",
@@ -12,7 +12,7 @@ const command = require_define.defineCommand({
 		required: true
 	} },
 	async run({ values }) {
-		const { runValidate } = await Promise.resolve().then(() => require("./validate-ujLCYSWU.cjs"));
+		const { runValidate } = await Promise.resolve().then(() => require("./validate-C1jTRzaZ.cjs"));
 		await runValidate({
 			input: values.input,
 			version: require_package.version
@@ -22,4 +22,4 @@ const command = require_define.defineCommand({
 //#endregion
 exports.command = command;
 
-//# sourceMappingURL=validate-D5EYrHAr.cjs.map
+//# sourceMappingURL=validate-B-XUhWlq.cjs.map

package/dist/{validate-D5EYrHAr.cjs.map → validate-B-XUhWlq.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"validate-D5EYrHAr.cjs","names":["defineCommand"],"sources":["../src/commands/validate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'validate',\n  description: 'Validate a Swagger/OpenAPI file',\n  options: {\n    input: { type: 'string', description: 'Path to Swagger/OpenAPI file', short: 'i', required: true },\n  },\n  async run({ values }) {\n    const { runValidate } = await import('../runners/validate.ts')\n\n    await runValidate({ input: values.input, version })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAUA,eAAAA,cAAc;CACnC,MAAM;CACN,aAAa;CACb,SAAS,EACP,OAAO;EAAE,MAAM;EAAU,aAAa;EAAgC,OAAO;EAAK,UAAU;EAAM,EACnG;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,gBAAgB,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,0BAAA,CAAA;AAE9B,QAAM,YAAY;GAAE,OAAO,OAAO;GAAO,SAAA,gBAAA;GAAS,CAAC;;CAEtD,CAAC"}
+{"version":3,"file":"validate-B-XUhWlq.cjs","names":["defineCommand"],"sources":["../src/commands/validate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'validate',\n  description: 'Validate a Swagger/OpenAPI file',\n  options: {\n    input: { type: 'string', description: 'Path to Swagger/OpenAPI file', short: 'i', required: true },\n  },\n  async run({ values }) {\n    const { runValidate } = await import('../runners/validate.ts')\n\n    await runValidate({ input: values.input, version })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAUA,eAAAA,cAAc;CACnC,MAAM;CACN,aAAa;CACb,SAAS,EACP,OAAO;EAAE,MAAM;EAAU,aAAa;EAAgC,OAAO;EAAK,UAAU;EAAM,EACnG;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,gBAAgB,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,0BAAA,CAAA;AAE9B,QAAM,YAAY;GAAE,OAAO,OAAO;GAAO,SAAA,gBAAA;GAAS,CAAC;;CAEtD,CAAC"}

package/dist/{validate-ujLCYSWU.cjs → validate-C1jTRzaZ.cjs}

@@ -1,6 +1,6 @@
 const require_chunk = require("./chunk-ByKO4r7w.cjs");
-const require_errors = require("./errors-DBW0N9w4.cjs");
-const require_telemetry = require("./telemetry-DZ7IrLAU.cjs");
+const require_errors = require("./errors-CLCjoSg0.cjs");
+const require_telemetry = require("./telemetry-CocGsmb6.cjs");
 const require_jiti = require("./jiti-Cd3S0xwr.cjs");
 let node_process = require("node:process");
 node_process = require_chunk.__toESM(node_process);
@@ -39,4 +39,4 @@ async function runValidate({ input, version }) {
 //#endregion
 exports.runValidate = runValidate;
 
-//# sourceMappingURL=validate-ujLCYSWU.cjs.map
+//# sourceMappingURL=validate-C1jTRzaZ.cjs.map

package/dist/{validate-ujLCYSWU.cjs.map → validate-C1jTRzaZ.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"validate-ujLCYSWU.cjs","names":["jiti","process","sendTelemetry","buildTelemetryEvent","getErrorMessage"],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport { getErrorMessage } from '@internals/utils'\nimport type * as OasModule from '@kubb/oas'\nimport { jiti } from '../utils/jiti.ts'\nimport { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'\n\ntype ValidateOptions = {\n  input: string\n  version: string\n}\n\nexport async function runValidate({ input, version }: ValidateOptions): Promise<void> {\n  let mod: typeof OasModule\n  try {\n    mod = (await jiti.import('@kubb/oas', { default: true })) as typeof OasModule\n  } catch (_e) {\n    console.error(`Import of '@kubb/oas' is required to do validation`)\n    process.exit(1)\n  }\n\n  const { parse } = mod\n  const hrStart = process.hrtime()\n  try {\n    const oas = await parse(input)\n    await oas.validate()\n\n    await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'success' }))\n    console.log('✅ Validation success')\n  } catch (error) {\n    await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'failed' }))\n    console.error('❌ Validation failed')\n    console.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;;AAWA,eAAsB,YAAY,EAAE,OAAO,WAA2C;CACpF,IAAI;AACJ,KAAI;AACF,QAAO,MAAMA,aAAAA,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;UACjD,IAAI;AACX,UAAQ,MAAM,qDAAqD;AACnE,eAAA,QAAQ,KAAK,EAAE;;CAGjB,MAAM,EAAE,UAAU;CAClB,MAAM,UAAUC,aAAAA,QAAQ,QAAQ;AAChC,KAAI;AAEF,SADY,MAAM,MAAM,MAAM,EACpB,UAAU;AAEpB,QAAMC,kBAAAA,cAAcC,kBAAAA,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAW,CAAC,CAAC;AACnH,UAAQ,IAAI,uBAAuB;UAC5B,OAAO;AACd,QAAMD,kBAAAA,cAAcC,kBAAAA,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAU,CAAC,CAAC;AAClH,UAAQ,MAAM,sBAAsB;AACpC,UAAQ,MAAMC,eAAAA,gBAAgB,MAAM,CAAC;AACrC,eAAA,QAAQ,KAAK,EAAE"}
+{"version":3,"file":"validate-C1jTRzaZ.cjs","names":["jiti","process","sendTelemetry","buildTelemetryEvent","getErrorMessage"],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport { getErrorMessage } from '@internals/utils'\nimport type * as OasModule from '@kubb/oas'\nimport { jiti } from '../utils/jiti.ts'\nimport { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'\n\ntype ValidateOptions = {\n  input: string\n  version: string\n}\n\nexport async function runValidate({ input, version }: ValidateOptions): Promise<void> {\n  let mod: typeof OasModule\n  try {\n    mod = (await jiti.import('@kubb/oas', { default: true })) as typeof OasModule\n  } catch (_e) {\n    console.error(`Import of '@kubb/oas' is required to do validation`)\n    process.exit(1)\n  }\n\n  const { parse } = mod\n  const hrStart = process.hrtime()\n  try {\n    const oas = await parse(input)\n    await oas.validate()\n\n    await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'success' }))\n    console.log('✅ Validation success')\n  } catch (error) {\n    await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'failed' }))\n    console.error('❌ Validation failed')\n    console.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;;AAWA,eAAsB,YAAY,EAAE,OAAO,WAA2C;CACpF,IAAI;AACJ,KAAI;AACF,QAAO,MAAMA,aAAAA,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;UACjD,IAAI;AACX,UAAQ,MAAM,qDAAqD;AACnE,eAAA,QAAQ,KAAK,EAAE;;CAGjB,MAAM,EAAE,UAAU;CAClB,MAAM,UAAUC,aAAAA,QAAQ,QAAQ;AAChC,KAAI;AAEF,SADY,MAAM,MAAM,MAAM,EACpB,UAAU;AAEpB,QAAMC,kBAAAA,cAAcC,kBAAAA,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAW,CAAC,CAAC;AACnH,UAAQ,IAAI,uBAAuB;UAC5B,OAAO;AACd,QAAMD,kBAAAA,cAAcC,kBAAAA,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAU,CAAC,CAAC;AAClH,UAAQ,MAAM,sBAAsB;AACpC,UAAQ,MAAMC,eAAAA,gBAAgB,MAAM,CAAC;AACrC,eAAA,QAAQ,KAAK,EAAE"}

package/dist/{validate-BImbbx1t.js → validate-CdCyfldE.js}

@@ -1,6 +1,6 @@
 import "./chunk--u3MIqq1.js";
-import { t as getErrorMessage } from "./errors-6mF_WKxg.js";
-import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-BF3SMlH6.js";
+import { t as getErrorMessage } from "./errors-CjPmyZHy.js";
+import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-BDtfsYde.js";
 import { t as jiti } from "./jiti-e08mD2Ph.js";
 import process from "node:process";
 //#region src/runners/validate.ts
@@ -38,4 +38,4 @@ async function runValidate({ input, version }) {
 //#endregion
 export { runValidate };
 
-//# sourceMappingURL=validate-BImbbx1t.js.map
+//# sourceMappingURL=validate-CdCyfldE.js.map

package/dist/{validate-BImbbx1t.js.map → validate-CdCyfldE.js.map}

@@ -1 +1 @@
-{"version":3,"file":"validate-BImbbx1t.js","names":[],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport { getErrorMessage } from '@internals/utils'\nimport type * as OasModule from '@kubb/oas'\nimport { jiti } from '../utils/jiti.ts'\nimport { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'\n\ntype ValidateOptions = {\n  input: string\n  version: string\n}\n\nexport async function runValidate({ input, version }: ValidateOptions): Promise<void> {\n  let mod: typeof OasModule\n  try {\n    mod = (await jiti.import('@kubb/oas', { default: true })) as typeof OasModule\n  } catch (_e) {\n    console.error(`Import of '@kubb/oas' is required to do validation`)\n    process.exit(1)\n  }\n\n  const { parse } = mod\n  const hrStart = process.hrtime()\n  try {\n    const oas = await parse(input)\n    await oas.validate()\n\n    await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'success' }))\n    console.log('✅ Validation success')\n  } catch (error) {\n    await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'failed' }))\n    console.error('❌ Validation failed')\n    console.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;AAWA,eAAsB,YAAY,EAAE,OAAO,WAA2C;CACpF,IAAI;AACJ,KAAI;AACF,QAAO,MAAM,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;UACjD,IAAI;AACX,UAAQ,MAAM,qDAAqD;AACnE,UAAQ,KAAK,EAAE;;CAGjB,MAAM,EAAE,UAAU;CAClB,MAAM,UAAU,QAAQ,QAAQ;AAChC,KAAI;AAEF,SADY,MAAM,MAAM,MAAM,EACpB,UAAU;AAEpB,QAAM,cAAc,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAW,CAAC,CAAC;AACnH,UAAQ,IAAI,uBAAuB;UAC5B,OAAO;AACd,QAAM,cAAc,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAU,CAAC,CAAC;AAClH,UAAQ,MAAM,sBAAsB;AACpC,UAAQ,MAAM,gBAAgB,MAAM,CAAC;AACrC,UAAQ,KAAK,EAAE"}
+{"version":3,"file":"validate-CdCyfldE.js","names":[],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport { getErrorMessage } from '@internals/utils'\nimport type * as OasModule from '@kubb/oas'\nimport { jiti } from '../utils/jiti.ts'\nimport { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'\n\ntype ValidateOptions = {\n  input: string\n  version: string\n}\n\nexport async function runValidate({ input, version }: ValidateOptions): Promise<void> {\n  let mod: typeof OasModule\n  try {\n    mod = (await jiti.import('@kubb/oas', { default: true })) as typeof OasModule\n  } catch (_e) {\n    console.error(`Import of '@kubb/oas' is required to do validation`)\n    process.exit(1)\n  }\n\n  const { parse } = mod\n  const hrStart = process.hrtime()\n  try {\n    const oas = await parse(input)\n    await oas.validate()\n\n    await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'success' }))\n    console.log('✅ Validation success')\n  } catch (error) {\n    await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'failed' }))\n    console.error('❌ Validation failed')\n    console.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;AAWA,eAAsB,YAAY,EAAE,OAAO,WAA2C;CACpF,IAAI;AACJ,KAAI;AACF,QAAO,MAAM,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;UACjD,IAAI;AACX,UAAQ,MAAM,qDAAqD;AACnE,UAAQ,KAAK,EAAE;;CAGjB,MAAM,EAAE,UAAU;CAClB,MAAM,UAAU,QAAQ,QAAQ;AAChC,KAAI;AAEF,SADY,MAAM,MAAM,MAAM,EACpB,UAAU;AAEpB,QAAM,cAAc,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAW,CAAC,CAAC;AACnH,UAAQ,IAAI,uBAAuB;UAC5B,OAAO;AACd,QAAM,cAAc,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAU,CAAC,CAAC;AAClH,UAAQ,MAAM,sBAAsB;AACpC,UAAQ,MAAM,gBAAgB,MAAM,CAAC;AACrC,UAAQ,KAAK,EAAE"}

package/dist/{validate-D9ZlUBTT.js → validate-DvjfD11u.js}

@@ -1,6 +1,6 @@
 import "./chunk--u3MIqq1.js";
-import { n as defineCommand } from "./define--M_JMcDC.js";
-import { t as version } from "./package-CheJ57Am.js";
+import { n as defineCommand } from "./define-Ctii4bel.js";
+import { t as version } from "./package-HdPHmGk2.js";
 //#region src/commands/validate.ts
 const command = defineCommand({
 	name: "validate",
@@ -12,7 +12,7 @@ const command = defineCommand({
 		required: true
 	} },
 	async run({ values }) {
-		const { runValidate } = await import("./validate-BImbbx1t.js");
+		const { runValidate } = await import("./validate-CdCyfldE.js");
 		await runValidate({
 			input: values.input,
 			version
@@ -22,4 +22,4 @@ const command = defineCommand({
 //#endregion
 export { command };
 
-//# sourceMappingURL=validate-D9ZlUBTT.js.map
+//# sourceMappingURL=validate-DvjfD11u.js.map

package/dist/{validate-D9ZlUBTT.js.map → validate-DvjfD11u.js.map}

@@ -1 +1 @@
-{"version":3,"file":"validate-D9ZlUBTT.js","names":[],"sources":["../src/commands/validate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'validate',\n  description: 'Validate a Swagger/OpenAPI file',\n  options: {\n    input: { type: 'string', description: 'Path to Swagger/OpenAPI file', short: 'i', required: true },\n  },\n  async run({ values }) {\n    const { runValidate } = await import('../runners/validate.ts')\n\n    await runValidate({ input: values.input, version })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aAAa;CACb,SAAS,EACP,OAAO;EAAE,MAAM;EAAU,aAAa;EAAgC,OAAO;EAAK,UAAU;EAAM,EACnG;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,gBAAgB,MAAM,OAAO;AAErC,QAAM,YAAY;GAAE,OAAO,OAAO;GAAO;GAAS,CAAC;;CAEtD,CAAC"}
+{"version":3,"file":"validate-DvjfD11u.js","names":[],"sources":["../src/commands/validate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'validate',\n  description: 'Validate a Swagger/OpenAPI file',\n  options: {\n    input: { type: 'string', description: 'Path to Swagger/OpenAPI file', short: 'i', required: true },\n  },\n  async run({ values }) {\n    const { runValidate } = await import('../runners/validate.ts')\n\n    await runValidate({ input: values.input, version })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aAAa;CACb,SAAS,EACP,OAAO;EAAE,MAAM;EAAU,aAAa;EAAgC,OAAO;EAAK,UAAU;EAAM,EACnG;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,gBAAgB,MAAM,OAAO;AAErC,QAAM,YAAY;GAAE,OAAO,OAAO;GAAO;GAAS,CAAC;;CAEtD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/cli",
-  "version": "5.0.0-alpha.17",
+  "version": "5.0.0-alpha.18",
   "description": "Command-line interface for Kubb, enabling easy generation of TypeScript, React-Query, Zod, and other code from OpenAPI specifications.",
   "keywords": [
     "cli",
@@ -58,14 +58,14 @@
     "cosmiconfig": "^9.0.1",
     "jiti": "2.5.1",
     "tinyexec": "^1.0.4",
-    "@kubb/core": "5.0.0-alpha.17"
+    "@kubb/core": "5.0.0-alpha.18"
   },
   "devDependencies": {
     "source-map-support": "^0.5.21",
     "@internals/utils": "0.0.0",
-    "@kubb/agent": "5.0.0-alpha.17",
-    "@kubb/mcp": "5.0.0-alpha.17",
-    "@kubb/oas": "5.0.0-alpha.17"
+    "@kubb/agent": "5.0.0-alpha.18",
+    "@kubb/mcp": "5.0.0-alpha.18",
+    "@kubb/oas": "5.0.0-alpha.18"
   },
   "engines": {
     "node": ">=22"

package/src/runners/generate.ts

@@ -38,7 +38,7 @@ type ToolMap = typeof formatters | typeof linters
 
 type RunToolPassOptions = {
   toolValue: string
-  detect: () => Promise<string | undefined>
+  detect: () => Promise<string | null>
   toolMap: ToolMap
   /** Short noun used in "Auto-detected <toolLabel>:" message, e.g. "formatter" or "linter". */
   toolLabel: string

package/dist/define--M_JMcDC.js

@@ -1,25 +0,0 @@
-import "./chunk--u3MIqq1.js";
-//#region ../../internals/utils/src/cli/define.ts
-/** Returns a `CLIAdapter` with type inference. Pass a different adapter to `createCLI` to swap the CLI engine. */
-function defineCLIAdapter(adapter) {
-	return adapter;
-}
-/**
-* Returns a `CommandDefinition` with typed `values` in `run()`.
-* The callback receives `values` typed from the declared options — no casts needed.
-*/
-function defineCommand(def) {
-	const { run, ...rest } = def;
-	if (!run) return rest;
-	return {
-		...rest,
-		run: (args) => run({
-			values: args.values,
-			positionals: args.positionals
-		})
-	};
-}
-//#endregion
-export { defineCommand as n, defineCLIAdapter as t };
-
-//# sourceMappingURL=define--M_JMcDC.js.map