@kubb/cli 5.0.0-alpha.2 → 5.0.0-alpha.21

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-DxiR7clS.js → telemetry-CBISr5w4.js}

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

package/dist/telemetry-CBISr5w4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-CBISr5w4.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 with a valid terminal\n * width and is not running in CI.\n *\n * Some IDE-embedded terminals report `isTTY = true` but set `columns` to `0`,\n * which breaks clack's box-drawing helpers (they call `String.prototype.repeat`\n * with a negative count and throw a `RangeError`).  We therefore require a\n * positive column count before declaring the TTY usable.\n *\n * @example\n * ```ts\n * if (canUseTTY()) {\n *   renderProgressBar()\n * }\n * ```\n */\nexport function canUseTTY(): boolean {\n  return !!process.stdout.isTTY && (process.stdout.columns ?? 0) > 0 && !isCIEnvironment()\n}\n","import { promises as dnsPromises } from 'node:dns'\n\n/**\n * Well-known stable domains used as DNS probes to check internet connectivity.\n */\nconst TEST_DOMAINS = ['dns.google.com', 'cloudflare.com', 'one.one.one.one'] as const\n\n/**\n * Returns `true` when the system has internet connectivity.\n * Probes DNS resolution against well-known stable domains.\n *\n * @example\n * ```ts\n * if (await isOnline()) {\n *   await fetchLatestVersion()\n * }\n * ```\n */\nexport async function isOnline(): Promise<boolean> {\n  for (const domain of TEST_DOMAINS) {\n    try {\n      await dnsPromises.resolve(domain)\n      return true\n    } catch {\n      // Try next domain\n    }\n  }\n\n  return false\n}\n\n/**\n * Executes `fn` only when the system is online. Returns `null` when offline or on error.\n *\n * @example\n * ```ts\n * const version = await executeIfOnline(() => fetchLatestVersion('kubb'))\n * // null when offline\n * ```\n */\nexport async function executeIfOnline<T>(fn: () => Promise<T>): Promise<T | null> {\n  if (!(await isOnline())) return null\n\n  try {\n    return await fn()\n  } catch {\n    return null\n  }\n}\n","import { randomBytes } from 'node:crypto'\nimport os from 'node:os'\nimport process from 'node:process'\nimport { executeIfOnline, isCIEnvironment } from '@internals/utils'\nimport { OTLP_ENDPOINT } from '../constants.ts'\n\n// OpenTelemetry OTLP JSON types\n// https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto\n// https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/common/v1/common.proto\n\ntype OtlpStringValue = { stringValue: string }\ntype OtlpBoolValue = { boolValue: boolean }\ntype OtlpIntValue = { intValue: number }\ntype OtlpDoubleValue = { doubleValue: number }\ntype OtlpBytesValue = { bytesValue: string }\ntype OtlpArrayValue = { arrayValue: { values: OtlpAnyValue[] } }\ntype OtlpKvListValue = { kvlistValue: { values: OtlpKeyValue[] } }\n\ntype OtlpAnyValue = OtlpStringValue | OtlpBoolValue | OtlpIntValue | OtlpDoubleValue | OtlpBytesValue | OtlpArrayValue | OtlpKvListValue\n\ntype OtlpKeyValue = {\n  key: string\n  value: OtlpAnyValue\n}\n\ntype OtlpResource = {\n  attributes: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpInstrumentationScope = {\n  name: string\n  version?: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\n/** https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto#L103 */\ntype OtlpSpanKind = 0 | 1 | 2 | 3 | 4 | 5\n\n/** 0 = STATUS_CODE_UNSET, 1 = STATUS_CODE_OK, 2 = STATUS_CODE_ERROR */\ntype OtlpStatusCode = 0 | 1 | 2\n\ntype OtlpStatus = {\n  code: OtlpStatusCode\n  message?: string\n}\n\ntype OtlpSpan = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  parentSpanId?: string\n  name: string\n  kind: OtlpSpanKind\n  startTimeUnixNano: string\n  endTimeUnixNano: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n  events?: OtlpSpanEvent[]\n  droppedEventsCount?: number\n  links?: OtlpSpanLink[]\n  droppedLinksCount?: number\n  status?: OtlpStatus\n}\n\ntype OtlpSpanEvent = {\n  timeUnixNano: string\n  name: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpSpanLink = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpScopeSpans = {\n  scope: OtlpInstrumentationScope\n  spans: OtlpSpan[]\n  schemaUrl?: string\n}\n\ntype OtlpResourceSpans = {\n  resource: OtlpResource\n  scopeSpans: OtlpScopeSpans[]\n  schemaUrl?: string\n}\n\n/** Root payload sent to POST /v1/traces */\ntype OtlpExportTraceServiceRequest = {\n  resourceSpans: OtlpResourceSpans[]\n}\n\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-Cn9X1I5B.cjs → telemetry-YO-uwAbf.cjs}

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-ByKO4r7w.cjs");
-const require_constants = require("./constants-BTUap0zs.cjs");
+const require_constants = require("./constants-D0XHAHeZ.cjs");
 let node_crypto = require("node:crypto");
 let node_dns = require("node:dns");
 let node_os = require("node:os");
@@ -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,41 @@ function isGitHubActions() {
 * Returns `true` when the process is running in a CI environment.
 * Covers GitHub Actions, GitLab CI, CircleCI, Travis CI, Jenkins, Bitbucket,
 * TeamCity, Buildkite, and Azure Pipelines.
+*
+* @example
+* ```ts
+* if (isCIEnvironment()) {
+*   logger.level = 'error'
+* }
+* ```
 */
 function isCIEnvironment() {
 	return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.BITBUCKET_BUILD_NUMBER || process.env.JENKINS_URL || process.env.CIRCLECI || process.env.TRAVIS || process.env.TEAMCITY_VERSION || process.env.BUILDKITE || process.env.TF_BUILD);
 }
 /**
-* Returns `true` when the process has an interactive TTY and is not running in CI.
+* Returns `true` when the process has an interactive TTY with a valid terminal
+* width and is not running in CI.
+*
+* Some IDE-embedded terminals report `isTTY = true` but set `columns` to `0`,
+* which breaks clack's box-drawing helpers (they call `String.prototype.repeat`
+* with a negative count and throw a `RangeError`).  We therefore require a
+* positive column count before declaring the TTY usable.
+*
+* @example
+* ```ts
+* if (canUseTTY()) {
+*   renderProgressBar()
+* }
+* ```
 */
 function canUseTTY() {
-	return !!process.stdout.isTTY && !isCIEnvironment();
+	return !!process.stdout.isTTY && (process.stdout.columns ?? 0) > 0 && !isCIEnvironment();
 }
 //#endregion
 //#region ../../internals/utils/src/network.ts
-/** Well-known stable domains used as DNS probes to check internet connectivity. */
+/**
+* Well-known stable domains used as DNS probes to check internet connectivity.
+*/
 const TEST_DOMAINS = [
 	"dns.google.com",
 	"cloudflare.com",
@@ -37,7 +66,14 @@ const TEST_DOMAINS = [
 ];
 /**
 * Returns `true` when the system has internet connectivity.
-* Uses DNS resolution against well-known stable domains as a lightweight probe.
+* Probes DNS resolution against well-known stable domains.
+*
+* @example
+* ```ts
+* if (await isOnline()) {
+*   await fetchLatestVersion()
+* }
+* ```
 */
 async function isOnline() {
 	for (const domain of TEST_DOMAINS) try {
@@ -48,6 +84,12 @@ async function isOnline() {
 }
 /**
 * Executes `fn` only when the system is online. Returns `null` when offline or on error.
+*
+* @example
+* ```ts
+* const version = await executeIfOnline(() => fetchLatestVersion('kubb'))
+* // null when offline
+* ```
 */
 async function executeIfOnline(fn) {
 	if (!await isOnline()) return null;
@@ -237,4 +279,4 @@ Object.defineProperty(exports, "sendTelemetry", {
 	}
 });
 
-//# sourceMappingURL=telemetry-Cn9X1I5B.cjs.map
+//# sourceMappingURL=telemetry-YO-uwAbf.cjs.map

package/dist/telemetry-YO-uwAbf.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-YO-uwAbf.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 with a valid terminal\n * width and is not running in CI.\n *\n * Some IDE-embedded terminals report `isTTY = true` but set `columns` to `0`,\n * which breaks clack's box-drawing helpers (they call `String.prototype.repeat`\n * with a negative count and throw a `RangeError`).  We therefore require a\n * positive column count before declaring the TTY usable.\n *\n * @example\n * ```ts\n * if (canUseTTY()) {\n *   renderProgressBar()\n * }\n * ```\n */\nexport function canUseTTY(): boolean {\n  return !!process.stdout.isTTY && (process.stdout.columns ?? 0) > 0 && !isCIEnvironment()\n}\n","import { promises as dnsPromises } from 'node:dns'\n\n/**\n * Well-known stable domains used as DNS probes to check internet connectivity.\n */\nconst TEST_DOMAINS = ['dns.google.com', 'cloudflare.com', 'one.one.one.one'] as const\n\n/**\n * Returns `true` when the system has internet connectivity.\n * Probes DNS resolution against well-known stable domains.\n *\n * @example\n * ```ts\n * if (await isOnline()) {\n *   await fetchLatestVersion()\n * }\n * ```\n */\nexport async function isOnline(): Promise<boolean> {\n  for (const domain of TEST_DOMAINS) {\n    try {\n      await dnsPromises.resolve(domain)\n      return true\n    } catch {\n      // Try next domain\n    }\n  }\n\n  return false\n}\n\n/**\n * Executes `fn` only when the system is online. Returns `null` when offline or on error.\n *\n * @example\n * ```ts\n * const version = await executeIfOnline(() => fetchLatestVersion('kubb'))\n * // null when offline\n * ```\n */\nexport async function executeIfOnline<T>(fn: () => Promise<T>): Promise<T | null> {\n  if (!(await isOnline())) return null\n\n  try {\n    return await fn()\n  } catch {\n    return null\n  }\n}\n","import { randomBytes } from 'node:crypto'\nimport os from 'node:os'\nimport process from 'node:process'\nimport { executeIfOnline, isCIEnvironment } from '@internals/utils'\nimport { OTLP_ENDPOINT } from '../constants.ts'\n\n// OpenTelemetry OTLP JSON types\n// https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto\n// https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/common/v1/common.proto\n\ntype OtlpStringValue = { stringValue: string }\ntype OtlpBoolValue = { boolValue: boolean }\ntype OtlpIntValue = { intValue: number }\ntype OtlpDoubleValue = { doubleValue: number }\ntype OtlpBytesValue = { bytesValue: string }\ntype OtlpArrayValue = { arrayValue: { values: OtlpAnyValue[] } }\ntype OtlpKvListValue = { kvlistValue: { values: OtlpKeyValue[] } }\n\ntype OtlpAnyValue = OtlpStringValue | OtlpBoolValue | OtlpIntValue | OtlpDoubleValue | OtlpBytesValue | OtlpArrayValue | OtlpKvListValue\n\ntype OtlpKeyValue = {\n  key: string\n  value: OtlpAnyValue\n}\n\ntype OtlpResource = {\n  attributes: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpInstrumentationScope = {\n  name: string\n  version?: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\n/** https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto#L103 */\ntype OtlpSpanKind = 0 | 1 | 2 | 3 | 4 | 5\n\n/** 0 = STATUS_CODE_UNSET, 1 = STATUS_CODE_OK, 2 = STATUS_CODE_ERROR */\ntype OtlpStatusCode = 0 | 1 | 2\n\ntype OtlpStatus = {\n  code: OtlpStatusCode\n  message?: string\n}\n\ntype OtlpSpan = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  parentSpanId?: string\n  name: string\n  kind: OtlpSpanKind\n  startTimeUnixNano: string\n  endTimeUnixNano: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n  events?: OtlpSpanEvent[]\n  droppedEventsCount?: number\n  links?: OtlpSpanLink[]\n  droppedLinksCount?: number\n  status?: OtlpStatus\n}\n\ntype OtlpSpanEvent = {\n  timeUnixNano: string\n  name: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpSpanLink = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpScopeSpans = {\n  scope: OtlpInstrumentationScope\n  spans: OtlpSpan[]\n  schemaUrl?: string\n}\n\ntype OtlpResourceSpans = {\n  resource: OtlpResource\n  scopeSpans: OtlpScopeSpans[]\n  schemaUrl?: string\n}\n\n/** Root payload sent to POST /v1/traces */\ntype OtlpExportTraceServiceRequest = {\n  resourceSpans: OtlpResourceSpans[]\n}\n\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-Bbrn3Q-A.cjs → validate-B-LfVNlS.cjs}

@@ -1,6 +1,6 @@
 const require_chunk = require("./chunk-ByKO4r7w.cjs");
-const require_errors = require("./errors-DBW0N9w4.cjs");
-const require_telemetry = require("./telemetry-Cn9X1I5B.cjs");
+const require_errors = require("./errors-CLCjoSg0.cjs");
+const require_telemetry = require("./telemetry-YO-uwAbf.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-Bbrn3Q-A.cjs.map
+//# sourceMappingURL=validate-B-LfVNlS.cjs.map

package/dist/{validate-Bbrn3Q-A.cjs.map → validate-B-LfVNlS.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"validate-Bbrn3Q-A.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-B-LfVNlS.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-l8vLmwKA.js → validate-CIS8nJdd.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-DxiR7clS.js";
+import { t as getErrorMessage } from "./errors-CjPmyZHy.js";
+import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-CBISr5w4.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-l8vLmwKA.js.map
+//# sourceMappingURL=validate-CIS8nJdd.js.map

package/dist/{validate-l8vLmwKA.js.map → validate-CIS8nJdd.js.map}

@@ -1 +1 @@
-{"version":3,"file":"validate-l8vLmwKA.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-CIS8nJdd.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-DCeW2b2k.js → validate-CT9EjxW0.js}

@@ -1,6 +1,6 @@
 import "./chunk--u3MIqq1.js";
-import { n as defineCommand } from "./define--M_JMcDC.js";
-import { t as version } from "./package-B4LgzOaR.js";
+import { n as defineCommand } from "./define-Ctii4bel.js";
+import { t as version } from "./package-DTEuw2ZR.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-l8vLmwKA.js");
+		const { runValidate } = await import("./validate-CIS8nJdd.js");
 		await runValidate({
 			input: values.input,
 			version
@@ -22,4 +22,4 @@ const command = defineCommand({
 //#endregion
 export { command };
 
-//# sourceMappingURL=validate-DCeW2b2k.js.map
+//# sourceMappingURL=validate-CT9EjxW0.js.map

package/dist/{validate-DCeW2b2k.js.map → validate-CT9EjxW0.js.map}

@@ -1 +1 @@
-{"version":3,"file":"validate-DCeW2b2k.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-CT9EjxW0.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/dist/{validate-B_O2agAB.cjs → validate-D-Jv1vcb.cjs}

@@ -1,6 +1,6 @@
 require("./chunk-ByKO4r7w.cjs");
-const require_define = require("./define-D6Kfm7-Z.cjs");
-const require_package = require("./package-lo3R7SUU.cjs");
+const require_define = require("./define-Bdn8j5VM.cjs");
+const require_package = require("./package-CH6AW-ko.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-Bbrn3Q-A.cjs"));
+		const { runValidate } = await Promise.resolve().then(() => require("./validate-B-LfVNlS.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-B_O2agAB.cjs.map
+//# sourceMappingURL=validate-D-Jv1vcb.cjs.map

package/dist/{validate-B_O2agAB.cjs.map → validate-D-Jv1vcb.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"validate-B_O2agAB.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-D-Jv1vcb.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/cli",
-  "version": "5.0.0-alpha.2",
+  "version": "5.0.0-alpha.21",
   "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.2"
+    "@kubb/core": "5.0.0-alpha.21"
   },
   "devDependencies": {
     "source-map-support": "^0.5.21",
     "@internals/utils": "0.0.0",
-    "@kubb/agent": "5.0.0-alpha.2",
-    "@kubb/mcp": "5.0.0-alpha.2",
-    "@kubb/oas": "5.0.0-alpha.2"
+    "@kubb/agent": "5.0.0-alpha.21",
+    "@kubb/mcp": "5.0.0-alpha.21",
+    "@kubb/oas": "5.0.0-alpha.21"
   },
   "engines": {
     "node": ">=22"

package/src/constants.ts

@@ -1,33 +1,78 @@
-/** NPM registry endpoint used to check for @kubb/cli updates. */
+/**
+ * NPM registry endpoint used to check for @kubb/cli updates.
+ */
 export const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const
 
-/** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */
+/**
+ * OpenTelemetry ingestion endpoint for anonymous usage telemetry.
+ */
 export const OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const
 
-/** Horizontal rule rendered above/below the plain-logger generation summary. */
+/**
+ * Horizontal rule rendered above/below the plain-logger generation summary.
+ */
 export const SUMMARY_SEPARATOR = '─'.repeat(27)
 
-/** Maximum number of █ characters in a plugin timing bar. */
+/**
+ * Maximum number of █ characters in a plugin timing bar.
+ */
 export const SUMMARY_MAX_BAR_LENGTH = 10 as const
 
-/** Divides elapsed milliseconds into bar-length units (1 block per 100 ms). */
+/**
+ * Divides elapsed milliseconds into bar-length units (1 block per 100 ms).
+ */
 export const SUMMARY_TIME_SCALE_DIVISOR = 100 as const
 
-/** Glob pattern for paths the file watcher ignores. */
+/**
+ * Glob pattern for paths the file watcher ignores.
+ */
 export const WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const
 
-/** Default runtime values for the `agent start` command. */
+/**
+ * Flags that short-circuit execution (help/version) — no telemetry notice is shown.
+ */
+export const QUITE_FLAGS = new Set(['--help', '-h', '--version', '-v'] as const)
+
+/**
+ * Flags accepted by the `generate` command.
+ */
+export const GENERATE_FLAGS = new Set(['--config', '-c', '--log-level', '-l', '--watch', '-w', '--debug', '-d', '--verbose', '-v', '--silent', '-s'] as const)
+
+/**
+ * Flags accepted by the `validate` command.
+ */
+export const VALIDATE_FLAGS = new Set(['--input', '-i'] as const)
+
+/**
+ * Flags accepted by the `init` command.
+ */
+export const INIT_FLAGS = new Set(['--yes', '-y'] as const)
+
+/**
+ * Flags accepted by the `agent start` command.
+ */
+export const AGENT_START_FLAGS = new Set(['--config', '-c', '--port', '-p', '--host', '--allow-write', '--allow-all'] as const)
+
+/**
+ * All known CLI flags across every command.
+ */
+export const ARGS = new Set([...QUITE_FLAGS, ...GENERATE_FLAGS, ...VALIDATE_FLAGS, ...INIT_FLAGS, ...AGENT_START_FLAGS] as const)
+
 export const agentDefaults = {
   port: '3000',
   host: 'localhost',
   configFile: 'kubb.config.ts',
   retryTimeout: '30000',
   studioUrl: 'https://studio.kubb.dev',
-  /** Relative path from the @kubb/agent package root to the server entry. */
+  /**
+   * Relative path from the @kubb/agent package root to the server entry.
+   */
   serverEntryPath: '.output/server/index.mjs',
 } as const
 
-/** Default values used during interactive `init` scaffolding. */
+/**
+ * Default values used during interactive `init` scaffolding.
+ */
 export const initDefaults = {
   inputPath: './openapi.yaml',
   outputPath: './src/gen',
@@ -73,4 +118,6 @@ export const pluginDefaultConfigs = {
     })`,
 } as const satisfies Record<string, string>
 
-/** Color palette used by randomCliColor() for deterministic plugin name coloring. */
+/**
+ * Color palette used by randomCliColor() for deterministic plugin name coloring.
+ */

package/src/index.ts

@@ -1,17 +1,18 @@
 import { styleText } from 'node:util'
 import { createCLI } from '@internals/utils'
 import { version } from '../package.json'
+import { QUITE_FLAGS } from './constants.ts'
+import { isFlag } from './utils/flags.ts'
 import { isTelemetryDisabled } from './utils/telemetry.ts'
 
 const cli = createCLI()
 
-function shouldShowTelemetryNotice(argv: string[]): boolean {
+function shouldShowTelemetryNotice(argv: Array<string>): boolean {
   if (isTelemetryDisabled()) {
     return false
   }
   // Skip when the user is just asking for help or version info
-  const quietFlags = new Set(['--help', '-h', '--version', '-v'])
-  if (argv.some((arg) => quietFlags.has(arg))) {
+  if (argv.some((arg) => isFlag(QUITE_FLAGS, arg))) {
     return false
   }
   // Skip in non-interactive / scripting contexts
@@ -21,7 +22,7 @@ function shouldShowTelemetryNotice(argv: string[]): boolean {
   return true
 }
 
-export async function run(argv: string[] = process.argv): Promise<void> {
+export async function run(argv: Array<string> = process.argv): Promise<void> {
   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`,