@kubb/cli 5.0.0-beta.5 → 5.0.0-beta.51

package/dist/Telemetry-BG80bcoQ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Telemetry-BG80bcoQ.cjs","names":["dnsPromises","process","os"],"sources":["../../../internals/utils/src/env.ts","../../../internals/utils/src/network.ts","../../../internals/utils/src/runtime.ts","../src/constants.ts","../src/Telemetry.ts"],"sourcesContent":["/**\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","/**\n * Name of the JavaScript runtime executing the current process.\n */\nexport type RuntimeName = 'bun' | 'deno' | 'node'\n\n/**\n * Returns `true` when the current process is running under Bun.\n *\n * Detection keys off the global `Bun` object rather than `process.versions`,\n * because Bun polyfills `process.versions.node` for Node compatibility and would\n * otherwise look like Node.\n *\n * @example\n * ```ts\n * if (isBun()) {\n *   await Bun.write(path, data)\n * }\n * ```\n */\nexport function isBun(): boolean {\n  return typeof Bun !== 'undefined'\n}\n\n/**\n * Returns `true` when the current process is running under Deno.\n */\nexport function isDeno(): boolean {\n  return typeof (globalThis as { Deno?: unknown }).Deno !== 'undefined'\n}\n\n/**\n * Returns `true` when the current process is running under Node.\n *\n * Bun and Deno are excluded first so a polyfilled `process` does not register as Node.\n */\nexport function isNode(): boolean {\n  return !isBun() && !isDeno() && typeof process !== 'undefined' && process.versions?.node != null\n}\n\n/**\n * Returns the name of the runtime executing the current process.\n *\n * @example\n * ```ts\n * getRuntimeName() // 'bun' when run with `bun kubb`, 'node' otherwise\n * ```\n */\nexport function getRuntimeName(): RuntimeName {\n  if (isBun()) return 'bun'\n  if (isDeno()) return 'deno'\n  return 'node'\n}\n\n/**\n * Returns the version of the active runtime, or an empty string when it cannot be read.\n *\n * @example\n * ```ts\n * getRuntimeVersion() // '1.3.11' under Bun, '22.22.2' under Node\n * ```\n */\nexport function getRuntimeVersion(): string {\n  if (isBun()) return process.versions.bun ?? ''\n  if (isDeno()) return (globalThis as { Deno?: { version?: { deno?: string } } }).Deno?.version?.deno ?? ''\n  return process.versions?.node ?? ''\n}\n","/**\n * NPM registry endpoint used to check for @kubb/cli updates.\n */\nexport const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const\n\n/**\n * OpenTelemetry ingestion endpoint for anonymous usage telemetry.\n */\nexport const OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const\n\n/**\n * Horizontal rule rendered above/below the plain-logger generation summary.\n */\nexport const SUMMARY_SEPARATOR = '─'.repeat(27)\n\n/**\n * Glob pattern for paths the file watcher ignores.\n */\nexport const WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const\n\n/**\n * Flags that short-circuit execution (help/version), no telemetry notice is shown.\n */\nexport const QUIET_FLAGS = new Set(['--help', '-h', '--version', '-v'] as const)\n","import { randomBytes } from 'node:crypto'\nimport os from 'node:os'\nimport process from 'node:process'\nimport { executeIfOnline, getRuntimeName, getRuntimeVersion, isCIEnvironment, type RuntimeName } 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: Array<OtlpAnyValue> } }\ntype OtlpKvListValue = { kvlistValue: { values: Array<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: Array<OtlpKeyValue>\n  droppedAttributesCount?: number\n}\n\ntype OtlpInstrumentationScope = {\n  name: string\n  version?: string\n  attributes?: Array<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?: Array<OtlpKeyValue>\n  droppedAttributesCount?: number\n  events?: Array<OtlpSpanEvent>\n  droppedEventsCount?: number\n  links?: Array<OtlpSpanLink>\n  droppedLinksCount?: number\n  status?: OtlpStatus\n}\n\ntype OtlpSpanEvent = {\n  timeUnixNano: string\n  name: string\n  attributes?: Array<OtlpKeyValue>\n  droppedAttributesCount?: number\n}\n\ntype OtlpSpanLink = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  attributes?: Array<OtlpKeyValue>\n  droppedAttributesCount?: number\n}\n\ntype OtlpScopeSpans = {\n  scope: OtlpInstrumentationScope\n  spans: Array<OtlpSpan>\n  schemaUrl?: string\n}\n\ntype OtlpResourceSpans = {\n  resource: OtlpResource\n  scopeSpans: Array<OtlpScopeSpans>\n  schemaUrl?: string\n}\n\n/** Root payload sent to POST /v1/traces */\ntype OtlpExportTraceServiceRequest = {\n  resourceSpans: Array<OtlpResourceSpans>\n}\n\n/**\n * Anonymous plugin name and options snapshot sent with each telemetry event.\n */\nexport type TelemetryPlugin = {\n  /**\n   * Plugin name as registered in the Kubb config, e.g. `'@kubb/plugin-ts'`.\n   */\n  name: string\n  /**\n   * anonymized plugin options snapshot, values are included but cannot be traced back to the user.\n   */\n  options: Record<string, unknown>\n}\n\nexport type TelemetryEvent = {\n  command: string\n  kubbVersion: string\n  nodeVersion: string\n  /**\n   * Name of the JavaScript runtime that executed the run, `'bun'`, `'deno'`, or `'node'`.\n   */\n  runtime: RuntimeName\n  /**\n   * Major version of the active runtime, e.g. `'1'` under Bun or `'22'` under Node.\n   */\n  runtimeVersion: string\n  platform: string\n  ci: boolean\n  plugins: Array<TelemetryPlugin>\n  duration: number\n  filesCreated: number\n  status: 'success' | 'failed'\n}\n\n/**\n * Anonymous OTLP usage telemetry for the Kubb run. All methods are static, so call them as\n * `Telemetry.build(...)`, `Telemetry.send(...)`, and `Telemetry.isDisabled()`. No file paths,\n * OpenAPI specs, or secrets are ever included, and sending fails silently to never break a run.\n */\nexport class Telemetry {\n  /**\n   * Returns `true` when telemetry is disabled via `DO_NOT_TRACK` or `KUBB_DISABLE_TELEMETRY`.\n   */\n  static isDisabled(): 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   * Build an anonymous telemetry payload from a completed generation run.\n   */\n  static build(options: {\n    command: 'generate' | 'mcp' | 'validate' | 'agent'\n    kubbVersion: string\n    plugins?: Array<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      runtime: getRuntimeName(),\n      runtimeVersion: getRuntimeVersion().split('.')[0] as string,\n      platform: os.platform(),\n      ci: isCIEnvironment(),\n      plugins: options.plugins ?? [],\n      duration,\n      filesCreated: options.filesCreated ?? 0,\n      status: options.status,\n    }\n  }\n\n  /**\n   * Convert a {@link TelemetryEvent} into an OTLP-compatible JSON trace payload.\n   * See https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/\n   */\n  static 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: Array<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.runtime', value: { stringValue: event.runtime } },\n      { key: 'kubb.runtime_version', value: { stringValue: event.runtimeVersion } },\n      { key: 'kubb.platform', value: { stringValue: event.platform } },\n      { key: 'kubb.ci', value: { boolValue: event.ci } },\n      { key: 'kubb.files_created', value: { intValue: event.filesCreated } },\n      { key: 'kubb.status', value: { stringValue: event.status } },\n      {\n        key: 'kubb.plugins',\n        value: {\n          arrayValue: {\n            values: event.plugins.map(\n              (p): OtlpKvListValue => ({\n                kvlistValue: {\n                  values: [\n                    { key: 'name', value: { stringValue: p.name } },\n                    {\n                      key: 'options',\n                      value: {\n                        stringValue: JSON.stringify({\n                          ...p.options,\n                          usedEnumNames: undefined,\n                        }),\n                      },\n                    },\n                  ],\n                },\n              }),\n            ),\n          },\n        },\n      },\n    ]\n\n    return {\n      resourceSpans: [\n        {\n          resource: {\n            attributes: [\n              { key: 'service.name', value: { stringValue: 'kubb-core' } },\n              {\n                key: 'service.version',\n                value: { stringValue: event.kubbVersion },\n              },\n              { key: 'telemetry.sdk.language', value: { stringValue: 'nodejs' } },\n            ],\n          },\n          scopeSpans: [\n            {\n              scope: { name: 'kubb-core', version: event.kubbVersion },\n              spans: [\n                {\n                  traceId,\n                  spanId,\n                  name: event.command,\n                  kind: 1 satisfies OtlpSpanKind,\n                  startTimeUnixNano: String(startTimeNs),\n                  endTimeUnixNano: String(endTimeNs),\n                  attributes,\n                  status: {\n                    code: (event.status === 'success' ? 1 : 2) satisfies OtlpStatusCode,\n                  },\n                },\n              ],\n            },\n          ],\n        },\n      ],\n    }\n  }\n\n  /**\n   * Send an anonymous telemetry event to the Kubb OTLP endpoint. Respects `DO_NOT_TRACK` and\n   * `KUBB_DISABLE_TELEMETRY`, and fails silently so telemetry never interrupts a run.\n   */\n  static async send(event: TelemetryEvent): Promise<void> {\n    if (Telemetry.isDisabled()) {\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-core',\n          },\n          body: JSON.stringify(Telemetry.buildOtlpPayload(event)),\n          signal: AbortSignal.timeout(5_000),\n        })\n      } catch (_e) {\n        // Fail silently, telemetry must never break the run\n      }\n    })\n  }\n}\n"],"mappings":"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"}

package/dist/Telemetry-CyBqvgcj.js

@@ -0,0 +1,313 @@
+import "./chunk-C0LytTxp.js";
+import { randomBytes } from "node:crypto";
+import { promises } from "node:dns";
+import os from "node:os";
+import process$1 from "node:process";
+//#region ../../internals/utils/src/env.ts
+/**
+* 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 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 && (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.
+*/
+const TEST_DOMAINS = [
+	"dns.google.com",
+	"cloudflare.com",
+	"one.one.one.one"
+];
+/**
+* Returns `true` when the system has internet connectivity.
+* 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 {
+		await promises.resolve(domain);
+		return true;
+	} catch {}
+	return false;
+}
+/**
+* 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;
+	try {
+		return await fn();
+	} catch {
+		return null;
+	}
+}
+//#endregion
+//#region ../../internals/utils/src/runtime.ts
+/**
+* Returns `true` when the current process is running under Bun.
+*
+* Detection keys off the global `Bun` object rather than `process.versions`,
+* because Bun polyfills `process.versions.node` for Node compatibility and would
+* otherwise look like Node.
+*
+* @example
+* ```ts
+* if (isBun()) {
+*   await Bun.write(path, data)
+* }
+* ```
+*/
+function isBun() {
+	return typeof Bun !== "undefined";
+}
+/**
+* Returns `true` when the current process is running under Deno.
+*/
+function isDeno() {
+	return typeof globalThis.Deno !== "undefined";
+}
+/**
+* Returns the name of the runtime executing the current process.
+*
+* @example
+* ```ts
+* getRuntimeName() // 'bun' when run with `bun kubb`, 'node' otherwise
+* ```
+*/
+function getRuntimeName() {
+	if (isBun()) return "bun";
+	if (isDeno()) return "deno";
+	return "node";
+}
+/**
+* Returns the version of the active runtime, or an empty string when it cannot be read.
+*
+* @example
+* ```ts
+* getRuntimeVersion() // '1.3.11' under Bun, '22.22.2' under Node
+* ```
+*/
+function getRuntimeVersion() {
+	if (isBun()) return process.versions.bun ?? "";
+	if (isDeno()) return globalThis.Deno?.version?.deno ?? "";
+	return process.versions?.node ?? "";
+}
+//#endregion
+//#region src/constants.ts
+/**
+* NPM registry endpoint used to check for @kubb/cli updates.
+*/
+const KUBB_NPM_PACKAGE_URL = "https://registry.npmjs.org/@kubb/cli/latest";
+/**
+* OpenTelemetry ingestion endpoint for anonymous usage telemetry.
+*/
+const OTLP_ENDPOINT = "https://otlp.kubb.dev";
+"─".repeat(27);
+/**
+* Glob pattern for paths the file watcher ignores.
+*/
+const WATCHER_IGNORED_PATHS = "**/{.git,node_modules}/**";
+/**
+* Flags that short-circuit execution (help/version), no telemetry notice is shown.
+*/
+const QUIET_FLAGS = new Set([
+	"--help",
+	"-h",
+	"--version",
+	"-v"
+]);
+//#endregion
+//#region src/Telemetry.ts
+/**
+* Anonymous OTLP usage telemetry for the Kubb run. All methods are static, so call them as
+* `Telemetry.build(...)`, `Telemetry.send(...)`, and `Telemetry.isDisabled()`. No file paths,
+* OpenAPI specs, or secrets are ever included, and sending fails silently to never break a run.
+*/
+var Telemetry = class Telemetry {
+	/**
+	* Returns `true` when telemetry is disabled via `DO_NOT_TRACK` or `KUBB_DISABLE_TELEMETRY`.
+	*/
+	static isDisabled() {
+		return process$1.env["DO_NOT_TRACK"] === "1" || process$1.env["DO_NOT_TRACK"] === "true" || process$1.env["KUBB_DISABLE_TELEMETRY"] === "1" || process$1.env["KUBB_DISABLE_TELEMETRY"] === "true";
+	}
+	/**
+	* Build an anonymous telemetry payload from a completed generation run.
+	*/
+	static build(options) {
+		const [seconds, nanoseconds] = process$1.hrtime(options.hrStart);
+		const duration = Math.round(seconds * 1e3 + nanoseconds / 1e6);
+		return {
+			command: options.command,
+			kubbVersion: options.kubbVersion,
+			nodeVersion: process$1.versions.node.split(".")[0],
+			runtime: getRuntimeName(),
+			runtimeVersion: getRuntimeVersion().split(".")[0],
+			platform: os.platform(),
+			ci: isCIEnvironment(),
+			plugins: options.plugins ?? [],
+			duration,
+			filesCreated: options.filesCreated ?? 0,
+			status: options.status
+		};
+	}
+	/**
+	* Convert a {@link TelemetryEvent} into an OTLP-compatible JSON trace payload.
+	* See https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/
+	*/
+	static buildOtlpPayload(event) {
+		const traceId = randomBytes(16).toString("hex");
+		const spanId = randomBytes(8).toString("hex");
+		const endTimeNs = BigInt(Date.now()) * 1000000n;
+		const startTimeNs = endTimeNs - BigInt(event.duration) * 1000000n;
+		const attributes = [
+			{
+				key: "kubb.command",
+				value: { stringValue: event.command }
+			},
+			{
+				key: "kubb.version",
+				value: { stringValue: event.kubbVersion }
+			},
+			{
+				key: "kubb.node_version",
+				value: { stringValue: event.nodeVersion }
+			},
+			{
+				key: "kubb.runtime",
+				value: { stringValue: event.runtime }
+			},
+			{
+				key: "kubb.runtime_version",
+				value: { stringValue: event.runtimeVersion }
+			},
+			{
+				key: "kubb.platform",
+				value: { stringValue: event.platform }
+			},
+			{
+				key: "kubb.ci",
+				value: { boolValue: event.ci }
+			},
+			{
+				key: "kubb.files_created",
+				value: { intValue: event.filesCreated }
+			},
+			{
+				key: "kubb.status",
+				value: { stringValue: event.status }
+			},
+			{
+				key: "kubb.plugins",
+				value: { arrayValue: { values: event.plugins.map((p) => ({ kvlistValue: { values: [{
+					key: "name",
+					value: { stringValue: p.name }
+				}, {
+					key: "options",
+					value: { stringValue: JSON.stringify({
+						...p.options,
+						usedEnumNames: void 0
+					}) }
+				}] } })) } }
+			}
+		];
+		return { resourceSpans: [{
+			resource: { attributes: [
+				{
+					key: "service.name",
+					value: { stringValue: "kubb-core" }
+				},
+				{
+					key: "service.version",
+					value: { stringValue: event.kubbVersion }
+				},
+				{
+					key: "telemetry.sdk.language",
+					value: { stringValue: "nodejs" }
+				}
+			] },
+			scopeSpans: [{
+				scope: {
+					name: "kubb-core",
+					version: event.kubbVersion
+				},
+				spans: [{
+					traceId,
+					spanId,
+					name: event.command,
+					kind: 1,
+					startTimeUnixNano: String(startTimeNs),
+					endTimeUnixNano: String(endTimeNs),
+					attributes,
+					status: { code: event.status === "success" ? 1 : 2 }
+				}]
+			}]
+		}] };
+	}
+	/**
+	* Send an anonymous telemetry event to the Kubb OTLP endpoint. Respects `DO_NOT_TRACK` and
+	* `KUBB_DISABLE_TELEMETRY`, and fails silently so telemetry never interrupts a run.
+	*/
+	static async send(event) {
+		if (Telemetry.isDisabled()) return;
+		await executeIfOnline(async () => {
+			try {
+				await fetch(`${OTLP_ENDPOINT}/v1/traces`, {
+					method: "POST",
+					headers: {
+						"Content-Type": "application/json",
+						"Kubb-Telemetry-Version": "1",
+						"Kubb-Telemetry-Source": "kubb-core"
+					},
+					body: JSON.stringify(Telemetry.buildOtlpPayload(event)),
+					signal: AbortSignal.timeout(5e3)
+				});
+			} catch (_e) {}
+		});
+	}
+};
+//#endregion
+export { executeIfOnline as a, WATCHER_IGNORED_PATHS as i, KUBB_NPM_PACKAGE_URL as n, canUseTTY as o, QUIET_FLAGS as r, Telemetry as t };
+
+//# sourceMappingURL=Telemetry-CyBqvgcj.js.map

package/dist/Telemetry-CyBqvgcj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Telemetry-CyBqvgcj.js","names":["dnsPromises","process"],"sources":["../../../internals/utils/src/env.ts","../../../internals/utils/src/network.ts","../../../internals/utils/src/runtime.ts","../src/constants.ts","../src/Telemetry.ts"],"sourcesContent":["/**\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","/**\n * Name of the JavaScript runtime executing the current process.\n */\nexport type RuntimeName = 'bun' | 'deno' | 'node'\n\n/**\n * Returns `true` when the current process is running under Bun.\n *\n * Detection keys off the global `Bun` object rather than `process.versions`,\n * because Bun polyfills `process.versions.node` for Node compatibility and would\n * otherwise look like Node.\n *\n * @example\n * ```ts\n * if (isBun()) {\n *   await Bun.write(path, data)\n * }\n * ```\n */\nexport function isBun(): boolean {\n  return typeof Bun !== 'undefined'\n}\n\n/**\n * Returns `true` when the current process is running under Deno.\n */\nexport function isDeno(): boolean {\n  return typeof (globalThis as { Deno?: unknown }).Deno !== 'undefined'\n}\n\n/**\n * Returns `true` when the current process is running under Node.\n *\n * Bun and Deno are excluded first so a polyfilled `process` does not register as Node.\n */\nexport function isNode(): boolean {\n  return !isBun() && !isDeno() && typeof process !== 'undefined' && process.versions?.node != null\n}\n\n/**\n * Returns the name of the runtime executing the current process.\n *\n * @example\n * ```ts\n * getRuntimeName() // 'bun' when run with `bun kubb`, 'node' otherwise\n * ```\n */\nexport function getRuntimeName(): RuntimeName {\n  if (isBun()) return 'bun'\n  if (isDeno()) return 'deno'\n  return 'node'\n}\n\n/**\n * Returns the version of the active runtime, or an empty string when it cannot be read.\n *\n * @example\n * ```ts\n * getRuntimeVersion() // '1.3.11' under Bun, '22.22.2' under Node\n * ```\n */\nexport function getRuntimeVersion(): string {\n  if (isBun()) return process.versions.bun ?? ''\n  if (isDeno()) return (globalThis as { Deno?: { version?: { deno?: string } } }).Deno?.version?.deno ?? ''\n  return process.versions?.node ?? ''\n}\n","/**\n * NPM registry endpoint used to check for @kubb/cli updates.\n */\nexport const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const\n\n/**\n * OpenTelemetry ingestion endpoint for anonymous usage telemetry.\n */\nexport const OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const\n\n/**\n * Horizontal rule rendered above/below the plain-logger generation summary.\n */\nexport const SUMMARY_SEPARATOR = '─'.repeat(27)\n\n/**\n * Glob pattern for paths the file watcher ignores.\n */\nexport const WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const\n\n/**\n * Flags that short-circuit execution (help/version), no telemetry notice is shown.\n */\nexport const QUIET_FLAGS = new Set(['--help', '-h', '--version', '-v'] as const)\n","import { randomBytes } from 'node:crypto'\nimport os from 'node:os'\nimport process from 'node:process'\nimport { executeIfOnline, getRuntimeName, getRuntimeVersion, isCIEnvironment, type RuntimeName } 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: Array<OtlpAnyValue> } }\ntype OtlpKvListValue = { kvlistValue: { values: Array<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: Array<OtlpKeyValue>\n  droppedAttributesCount?: number\n}\n\ntype OtlpInstrumentationScope = {\n  name: string\n  version?: string\n  attributes?: Array<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?: Array<OtlpKeyValue>\n  droppedAttributesCount?: number\n  events?: Array<OtlpSpanEvent>\n  droppedEventsCount?: number\n  links?: Array<OtlpSpanLink>\n  droppedLinksCount?: number\n  status?: OtlpStatus\n}\n\ntype OtlpSpanEvent = {\n  timeUnixNano: string\n  name: string\n  attributes?: Array<OtlpKeyValue>\n  droppedAttributesCount?: number\n}\n\ntype OtlpSpanLink = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  attributes?: Array<OtlpKeyValue>\n  droppedAttributesCount?: number\n}\n\ntype OtlpScopeSpans = {\n  scope: OtlpInstrumentationScope\n  spans: Array<OtlpSpan>\n  schemaUrl?: string\n}\n\ntype OtlpResourceSpans = {\n  resource: OtlpResource\n  scopeSpans: Array<OtlpScopeSpans>\n  schemaUrl?: string\n}\n\n/** Root payload sent to POST /v1/traces */\ntype OtlpExportTraceServiceRequest = {\n  resourceSpans: Array<OtlpResourceSpans>\n}\n\n/**\n * Anonymous plugin name and options snapshot sent with each telemetry event.\n */\nexport type TelemetryPlugin = {\n  /**\n   * Plugin name as registered in the Kubb config, e.g. `'@kubb/plugin-ts'`.\n   */\n  name: string\n  /**\n   * anonymized plugin options snapshot, values are included but cannot be traced back to the user.\n   */\n  options: Record<string, unknown>\n}\n\nexport type TelemetryEvent = {\n  command: string\n  kubbVersion: string\n  nodeVersion: string\n  /**\n   * Name of the JavaScript runtime that executed the run, `'bun'`, `'deno'`, or `'node'`.\n   */\n  runtime: RuntimeName\n  /**\n   * Major version of the active runtime, e.g. `'1'` under Bun or `'22'` under Node.\n   */\n  runtimeVersion: string\n  platform: string\n  ci: boolean\n  plugins: Array<TelemetryPlugin>\n  duration: number\n  filesCreated: number\n  status: 'success' | 'failed'\n}\n\n/**\n * Anonymous OTLP usage telemetry for the Kubb run. All methods are static, so call them as\n * `Telemetry.build(...)`, `Telemetry.send(...)`, and `Telemetry.isDisabled()`. No file paths,\n * OpenAPI specs, or secrets are ever included, and sending fails silently to never break a run.\n */\nexport class Telemetry {\n  /**\n   * Returns `true` when telemetry is disabled via `DO_NOT_TRACK` or `KUBB_DISABLE_TELEMETRY`.\n   */\n  static isDisabled(): 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   * Build an anonymous telemetry payload from a completed generation run.\n   */\n  static build(options: {\n    command: 'generate' | 'mcp' | 'validate' | 'agent'\n    kubbVersion: string\n    plugins?: Array<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      runtime: getRuntimeName(),\n      runtimeVersion: getRuntimeVersion().split('.')[0] as string,\n      platform: os.platform(),\n      ci: isCIEnvironment(),\n      plugins: options.plugins ?? [],\n      duration,\n      filesCreated: options.filesCreated ?? 0,\n      status: options.status,\n    }\n  }\n\n  /**\n   * Convert a {@link TelemetryEvent} into an OTLP-compatible JSON trace payload.\n   * See https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/\n   */\n  static 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: Array<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.runtime', value: { stringValue: event.runtime } },\n      { key: 'kubb.runtime_version', value: { stringValue: event.runtimeVersion } },\n      { key: 'kubb.platform', value: { stringValue: event.platform } },\n      { key: 'kubb.ci', value: { boolValue: event.ci } },\n      { key: 'kubb.files_created', value: { intValue: event.filesCreated } },\n      { key: 'kubb.status', value: { stringValue: event.status } },\n      {\n        key: 'kubb.plugins',\n        value: {\n          arrayValue: {\n            values: event.plugins.map(\n              (p): OtlpKvListValue => ({\n                kvlistValue: {\n                  values: [\n                    { key: 'name', value: { stringValue: p.name } },\n                    {\n                      key: 'options',\n                      value: {\n                        stringValue: JSON.stringify({\n                          ...p.options,\n                          usedEnumNames: undefined,\n                        }),\n                      },\n                    },\n                  ],\n                },\n              }),\n            ),\n          },\n        },\n      },\n    ]\n\n    return {\n      resourceSpans: [\n        {\n          resource: {\n            attributes: [\n              { key: 'service.name', value: { stringValue: 'kubb-core' } },\n              {\n                key: 'service.version',\n                value: { stringValue: event.kubbVersion },\n              },\n              { key: 'telemetry.sdk.language', value: { stringValue: 'nodejs' } },\n            ],\n          },\n          scopeSpans: [\n            {\n              scope: { name: 'kubb-core', version: event.kubbVersion },\n              spans: [\n                {\n                  traceId,\n                  spanId,\n                  name: event.command,\n                  kind: 1 satisfies OtlpSpanKind,\n                  startTimeUnixNano: String(startTimeNs),\n                  endTimeUnixNano: String(endTimeNs),\n                  attributes,\n                  status: {\n                    code: (event.status === 'success' ? 1 : 2) satisfies OtlpStatusCode,\n                  },\n                },\n              ],\n            },\n          ],\n        },\n      ],\n    }\n  }\n\n  /**\n   * Send an anonymous telemetry event to the Kubb OTLP endpoint. Respects `DO_NOT_TRACK` and\n   * `KUBB_DISABLE_TELEMETRY`, and fails silently so telemetry never interrupts a run.\n   */\n  static async send(event: TelemetryEvent): Promise<void> {\n    if (Telemetry.isDisabled()) {\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-core',\n          },\n          body: JSON.stringify(Telemetry.buildOtlpPayload(event)),\n          signal: AbortSignal.timeout(5_000),\n        })\n      } catch (_e) {\n        // Fail silently, telemetry must never break the run\n      }\n    })\n  }\n}\n"],"mappings":"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"}

package/dist/{define-Bdn8j5VM.cjs → define-C4AB3POr.cjs}

@@ -1,4 +1,4 @@
-require("./chunk-ByKO4r7w.cjs");
+require("./chunk-Bx3C2hgW.cjs");
 //#region ../../internals/utils/src/cli/define.ts
 /**
 * Returns a `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.
@@ -51,4 +51,4 @@ Object.defineProperty(exports, "defineCommand", {
 	}
 });
 
-//# sourceMappingURL=define-Bdn8j5VM.cjs.map
+//# sourceMappingURL=define-C4AB3POr.cjs.map

package/dist/{define-Bdn8j5VM.cjs.map → define-C4AB3POr.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"define-Bdn8j5VM.cjs","names":[],"sources":["../../../internals/utils/src/cli/define.ts"],"sourcesContent":["import type { CLIAdapter, CommandDefinition, OptionDefinition } from './types.ts'\n\ntype OptionTypeMap = { string: string; boolean: boolean }\n\ntype IsRequired<O extends OptionDefinition> = O['default'] extends string | boolean ? true : O['required'] extends true ? true : false\n\n/**\n * Infers typed values from an options record. Options with a `default` or `required: true` are always defined.\n */\ntype InferValues<O extends Record<string, OptionDefinition>> = {\n  [K in keyof O as IsRequired<O[K]> extends true ? K : never]: OptionTypeMap[O[K]['type']]\n} & {\n  [K in keyof O as IsRequired<O[K]> extends true ? never : K]?: OptionTypeMap[O[K]['type']]\n}\n\n/**\n * Returns a `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.\n *\n * @example\n * ```ts\n * const adapter = defineCLIAdapter({ run: myRun, renderHelp: myHelp })\n * createCLI({ adapter }).run(commands, argv, opts)\n * ```\n */\nexport function defineCLIAdapter(adapter: CLIAdapter): CLIAdapter {\n  return adapter\n}\n\n/**\n * Returns a `CommandDefinition` with typed `values` in `run()`.\n * The callback receives `values` inferred from the declared options — no casts needed.\n *\n * @example\n * ```ts\n * const generate = defineCommand({\n *   name: 'generate',\n *   description: 'Generate client code',\n *   options: { config: { type: 'string', description: 'Config path' } },\n *   async run({ values }) { console.log(values.config) },\n * })\n * ```\n */\nexport function defineCommand<O extends Record<string, OptionDefinition>>(def: {\n  name: string\n  description: string\n  arguments?: string[]\n  options?: O\n  subCommands?: CommandDefinition[]\n  run?: (args: { values: InferValues<O>; positionals: string[] }) => Promise<void>\n}): CommandDefinition {\n  const { run, ...rest } = def\n  if (!run) return rest\n  return {\n    ...rest,\n    run: (args) =>\n      run({\n        values: args.values as InferValues<O>,\n        positionals: args.positionals,\n      }),\n  }\n}\n"],"mappings":";;;;;;;;;;;AAwBA,SAAgB,iBAAiB,SAAiC;AAChE,QAAO;;;;;;;;;;;;;;;;AAiBT,SAAgB,cAA0D,KAOpD;CACpB,MAAM,EAAE,KAAK,GAAG,SAAS;AACzB,KAAI,CAAC,IAAK,QAAO;AACjB,QAAO;EACL,GAAG;EACH,MAAM,SACJ,IAAI;GACF,QAAQ,KAAK;GACb,aAAa,KAAK;GACnB,CAAC;EACL"}
+{"version":3,"file":"define-C4AB3POr.cjs","names":[],"sources":["../../../internals/utils/src/cli/define.ts"],"sourcesContent":["import type { CLIAdapter, CommandDefinition, OptionDefinition } from './types.ts'\n\ntype OptionTypeMap = { string: string; boolean: boolean }\n\ntype IsRequired<O extends OptionDefinition> = O['default'] extends string | boolean ? true : O['required'] extends true ? true : false\n\n/**\n * Infers typed values from an options record. Options with a `default` or `required: true` are always defined.\n */\ntype InferValues<O extends Record<string, OptionDefinition>> = {\n  [K in keyof O as IsRequired<O[K]> extends true ? K : never]: OptionTypeMap[O[K]['type']]\n} & {\n  [K in keyof O as IsRequired<O[K]> extends true ? never : K]?: OptionTypeMap[O[K]['type']]\n}\n\n/**\n * Returns a `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.\n *\n * @example\n * ```ts\n * const adapter = defineCLIAdapter({ run: myRun, renderHelp: myHelp })\n * createCLI({ adapter }).run(commands, argv, opts)\n * ```\n */\nexport function defineCLIAdapter(adapter: CLIAdapter): CLIAdapter {\n  return adapter\n}\n\n/**\n * Returns a `CommandDefinition` with typed `values` in `run()`.\n * The callback receives `values` inferred from the declared options — no casts needed.\n *\n * @example\n * ```ts\n * const generate = defineCommand({\n *   name: 'generate',\n *   description: 'Generate client code',\n *   options: { config: { type: 'string', description: 'Config path' } },\n *   async run({ values }) { console.log(values.config) },\n * })\n * ```\n */\nexport function defineCommand<O extends Record<string, OptionDefinition>>(def: {\n  name: string\n  description: string\n  arguments?: string[]\n  examples?: string[]\n  options?: O\n  subCommands?: CommandDefinition[]\n  run?: (args: { values: InferValues<O>; positionals: string[] }) => Promise<void>\n}): CommandDefinition {\n  const { run, ...rest } = def\n  if (!run) return rest\n  return {\n    ...rest,\n    run: (args) =>\n      run({\n        values: args.values as InferValues<O>,\n        positionals: args.positionals,\n      }),\n  }\n}\n"],"mappings":";;;;;;;;;;;AAwBA,SAAgB,iBAAiB,SAAiC;CAChE,OAAO;AACT;;;;;;;;;;;;;;;AAgBA,SAAgB,cAA0D,KAQpD;CACpB,MAAM,EAAE,KAAK,GAAG,SAAS;CACzB,IAAI,CAAC,KAAK,OAAO;CACjB,OAAO;EACL,GAAG;EACH,MAAM,SACJ,IAAI;GACF,QAAQ,KAAK;GACb,aAAa,KAAK;EACpB,CAAC;CACL;AACF"}

package/dist/{define-Ctii4bel.js → define-C63T4jp6.js}

@@ -1,4 +1,4 @@
-import "./chunk--u3MIqq1.js";
+import "./chunk-C0LytTxp.js";
 //#region ../../internals/utils/src/cli/define.ts
 /**
 * Returns a `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.
@@ -40,4 +40,4 @@ function defineCommand(def) {
 //#endregion
 export { defineCommand as n, defineCLIAdapter as t };
 
-//# sourceMappingURL=define-Ctii4bel.js.map
+//# sourceMappingURL=define-C63T4jp6.js.map

package/dist/{define-Ctii4bel.js.map → define-C63T4jp6.js.map}

@@ -1 +1 @@
-{"version":3,"file":"define-Ctii4bel.js","names":[],"sources":["../../../internals/utils/src/cli/define.ts"],"sourcesContent":["import type { CLIAdapter, CommandDefinition, OptionDefinition } from './types.ts'\n\ntype OptionTypeMap = { string: string; boolean: boolean }\n\ntype IsRequired<O extends OptionDefinition> = O['default'] extends string | boolean ? true : O['required'] extends true ? true : false\n\n/**\n * Infers typed values from an options record. Options with a `default` or `required: true` are always defined.\n */\ntype InferValues<O extends Record<string, OptionDefinition>> = {\n  [K in keyof O as IsRequired<O[K]> extends true ? K : never]: OptionTypeMap[O[K]['type']]\n} & {\n  [K in keyof O as IsRequired<O[K]> extends true ? never : K]?: OptionTypeMap[O[K]['type']]\n}\n\n/**\n * Returns a `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.\n *\n * @example\n * ```ts\n * const adapter = defineCLIAdapter({ run: myRun, renderHelp: myHelp })\n * createCLI({ adapter }).run(commands, argv, opts)\n * ```\n */\nexport function defineCLIAdapter(adapter: CLIAdapter): CLIAdapter {\n  return adapter\n}\n\n/**\n * Returns a `CommandDefinition` with typed `values` in `run()`.\n * The callback receives `values` inferred from the declared options — no casts needed.\n *\n * @example\n * ```ts\n * const generate = defineCommand({\n *   name: 'generate',\n *   description: 'Generate client code',\n *   options: { config: { type: 'string', description: 'Config path' } },\n *   async run({ values }) { console.log(values.config) },\n * })\n * ```\n */\nexport function defineCommand<O extends Record<string, OptionDefinition>>(def: {\n  name: string\n  description: string\n  arguments?: string[]\n  options?: O\n  subCommands?: CommandDefinition[]\n  run?: (args: { values: InferValues<O>; positionals: string[] }) => Promise<void>\n}): CommandDefinition {\n  const { run, ...rest } = def\n  if (!run) return rest\n  return {\n    ...rest,\n    run: (args) =>\n      run({\n        values: args.values as InferValues<O>,\n        positionals: args.positionals,\n      }),\n  }\n}\n"],"mappings":";;;;;;;;;;;AAwBA,SAAgB,iBAAiB,SAAiC;AAChE,QAAO;;;;;;;;;;;;;;;;AAiBT,SAAgB,cAA0D,KAOpD;CACpB,MAAM,EAAE,KAAK,GAAG,SAAS;AACzB,KAAI,CAAC,IAAK,QAAO;AACjB,QAAO;EACL,GAAG;EACH,MAAM,SACJ,IAAI;GACF,QAAQ,KAAK;GACb,aAAa,KAAK;GACnB,CAAC;EACL"}
+{"version":3,"file":"define-C63T4jp6.js","names":[],"sources":["../../../internals/utils/src/cli/define.ts"],"sourcesContent":["import type { CLIAdapter, CommandDefinition, OptionDefinition } from './types.ts'\n\ntype OptionTypeMap = { string: string; boolean: boolean }\n\ntype IsRequired<O extends OptionDefinition> = O['default'] extends string | boolean ? true : O['required'] extends true ? true : false\n\n/**\n * Infers typed values from an options record. Options with a `default` or `required: true` are always defined.\n */\ntype InferValues<O extends Record<string, OptionDefinition>> = {\n  [K in keyof O as IsRequired<O[K]> extends true ? K : never]: OptionTypeMap[O[K]['type']]\n} & {\n  [K in keyof O as IsRequired<O[K]> extends true ? never : K]?: OptionTypeMap[O[K]['type']]\n}\n\n/**\n * Returns a `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.\n *\n * @example\n * ```ts\n * const adapter = defineCLIAdapter({ run: myRun, renderHelp: myHelp })\n * createCLI({ adapter }).run(commands, argv, opts)\n * ```\n */\nexport function defineCLIAdapter(adapter: CLIAdapter): CLIAdapter {\n  return adapter\n}\n\n/**\n * Returns a `CommandDefinition` with typed `values` in `run()`.\n * The callback receives `values` inferred from the declared options — no casts needed.\n *\n * @example\n * ```ts\n * const generate = defineCommand({\n *   name: 'generate',\n *   description: 'Generate client code',\n *   options: { config: { type: 'string', description: 'Config path' } },\n *   async run({ values }) { console.log(values.config) },\n * })\n * ```\n */\nexport function defineCommand<O extends Record<string, OptionDefinition>>(def: {\n  name: string\n  description: string\n  arguments?: string[]\n  examples?: string[]\n  options?: O\n  subCommands?: CommandDefinition[]\n  run?: (args: { values: InferValues<O>; positionals: string[] }) => Promise<void>\n}): CommandDefinition {\n  const { run, ...rest } = def\n  if (!run) return rest\n  return {\n    ...rest,\n    run: (args) =>\n      run({\n        values: args.values as InferValues<O>,\n        positionals: args.positionals,\n      }),\n  }\n}\n"],"mappings":";;;;;;;;;;;AAwBA,SAAgB,iBAAiB,SAAiC;CAChE,OAAO;AACT;;;;;;;;;;;;;;;AAgBA,SAAgB,cAA0D,KAQpD;CACpB,MAAM,EAAE,KAAK,GAAG,SAAS;CACzB,IAAI,CAAC,KAAK,OAAO;CACjB,OAAO;EACL,GAAG;EACH,MAAM,SACJ,IAAI;GACF,QAAQ,KAAK;GACb,aAAa,KAAK;EACpB,CAAC;CACL;AACF"}

package/dist/{errors-CjPmyZHy.js → errors-BsemQCMn.js}

@@ -1,4 +1,4 @@
-import "./chunk--u3MIqq1.js";
+import "./chunk-C0LytTxp.js";
 //#region ../../internals/utils/src/errors.ts
 /**
 * Coerces an unknown thrown value to an `Error` instance.
@@ -40,4 +40,4 @@ function toCause(error) {
 //#endregion
 export { toCause as n, toError as r, getErrorMessage as t };
 
-//# sourceMappingURL=errors-CjPmyZHy.js.map
+//# sourceMappingURL=errors-BsemQCMn.js.map

package/dist/{errors-CjPmyZHy.js.map → errors-BsemQCMn.js.map}

@@ -1 +1 @@
-{"version":3,"file":"errors-CjPmyZHy.js","names":[],"sources":["../../../internals/utils/src/errors.ts"],"sourcesContent":["/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n  errors: Array<Error>\n\n  constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n    super(message, { cause: options.cause })\n    this.name = 'BuildError'\n    this.errors = options.errors\n  }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n *   throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string')    // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n  return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n  return error.cause instanceof Error ? error.cause : undefined\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,SAAgB,QAAQ,OAAuB;AAC7C,QAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;;;;;;;;;;;AAYlE,SAAgB,gBAAgB,OAAwB;AACtD,QAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;;;;;;;;;;AAW/D,SAAgB,QAAQ,OAAiC;AACvD,QAAO,MAAM,iBAAiB,QAAQ,MAAM,QAAQ,KAAA"}
+{"version":3,"file":"errors-BsemQCMn.js","names":[],"sources":["../../../internals/utils/src/errors.ts"],"sourcesContent":["/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n  errors: Array<Error>\n\n  constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n    super(message, { cause: options.cause })\n    this.name = 'BuildError'\n    this.errors = options.errors\n  }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n *   throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string')    // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n  return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n  return error.cause instanceof Error ? error.cause : undefined\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,SAAgB,QAAQ,OAAuB;CAC7C,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AACjE;;;;;;;;;;AAWA,SAAgB,gBAAgB,OAAwB;CACtD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;;;;;;;;;AAUA,SAAgB,QAAQ,OAAiC;CACvD,OAAO,MAAM,iBAAiB,QAAQ,MAAM,QAAQ,KAAA;AACtD"}

package/dist/{errors-CLCjoSg0.cjs → errors-DykI11xo.cjs}

@@ -1,4 +1,4 @@
-require("./chunk-ByKO4r7w.cjs");
+require("./chunk-Bx3C2hgW.cjs");
 //#region ../../internals/utils/src/errors.ts
 /**
 * Coerces an unknown thrown value to an `Error` instance.
@@ -57,4 +57,4 @@ Object.defineProperty(exports, "toError", {
 	}
 });
 
-//# sourceMappingURL=errors-CLCjoSg0.cjs.map
+//# sourceMappingURL=errors-DykI11xo.cjs.map

package/dist/{errors-CLCjoSg0.cjs.map → errors-DykI11xo.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"errors-CLCjoSg0.cjs","names":[],"sources":["../../../internals/utils/src/errors.ts"],"sourcesContent":["/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n  errors: Array<Error>\n\n  constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n    super(message, { cause: options.cause })\n    this.name = 'BuildError'\n    this.errors = options.errors\n  }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n *   throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string')    // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n  return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n  return error.cause instanceof Error ? error.cause : undefined\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,SAAgB,QAAQ,OAAuB;AAC7C,QAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;;;;;;;;;;;AAYlE,SAAgB,gBAAgB,OAAwB;AACtD,QAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;;;;;;;;;;AAW/D,SAAgB,QAAQ,OAAiC;AACvD,QAAO,MAAM,iBAAiB,QAAQ,MAAM,QAAQ,KAAA"}
+{"version":3,"file":"errors-DykI11xo.cjs","names":[],"sources":["../../../internals/utils/src/errors.ts"],"sourcesContent":["/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n  errors: Array<Error>\n\n  constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n    super(message, { cause: options.cause })\n    this.name = 'BuildError'\n    this.errors = options.errors\n  }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n *   throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string')    // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n  return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n  return error.cause instanceof Error ? error.cause : undefined\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,SAAgB,QAAQ,OAAuB;CAC7C,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AACjE;;;;;;;;;;AAWA,SAAgB,gBAAgB,OAAwB;CACtD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;;;;;;;;;AAUA,SAAgB,QAAQ,OAAiC;CACvD,OAAO,MAAM,iBAAiB,QAAQ,MAAM,QAAQ,KAAA;AACtD"}

package/dist/generate-BRpukupe.cjs

@@ -0,0 +1,82 @@
+require("./chunk-Bx3C2hgW.cjs");
+//#region src/commands/generate.ts
+const command = require("./define-C4AB3POr.cjs").defineCommand({
+	name: "generate",
+	description: "Generate TypeScript types, API clients, React Query hooks, Zod schemas, and more from an OpenAPI specification. Reads kubb.config.ts by default. Pass an OpenAPI file path as the first argument to override the input without editing the config.",
+	arguments: ["[input]"],
+	examples: [
+		"kubb generate",
+		"kubb generate ./openapi.yaml",
+		"kubb generate --config kubb.config.ts",
+		"kubb generate --watch"
+	],
+	options: {
+		config: {
+			type: "string",
+			description: "Path to the Kubb config",
+			short: "c"
+		},
+		logLevel: {
+			type: "string",
+			description: "Info, silent or verbose",
+			short: "l",
+			default: "info",
+			hint: "silent|info|verbose",
+			enum: [
+				"silent",
+				"info",
+				"verbose"
+			]
+		},
+		watch: {
+			type: "boolean",
+			description: "Watch mode based on the input file",
+			short: "w",
+			default: false
+		},
+		verbose: {
+			type: "boolean",
+			description: "Override logLevel to verbose",
+			short: "v",
+			default: false
+		},
+		silent: {
+			type: "boolean",
+			description: "Override logLevel to silent",
+			short: "s",
+			default: false
+		},
+		reporter: {
+			type: "string",
+			description: "Reporters that render the run, comma-separated. Overrides config.reporters",
+			hint: "cli|json|file",
+			enum: [
+				"cli",
+				"json",
+				"file"
+			]
+		},
+		"no-cache": {
+			type: "boolean",
+			description: "Disable the incremental build cache and force a full regeneration",
+			default: false
+		}
+	},
+	async run({ values, positionals }) {
+		const logLevel = values.verbose ? "verbose" : values.silent ? "silent" : values.logLevel;
+		const reporters = values.reporter?.split(",").map((name) => name.trim()).filter(Boolean);
+		const { run } = await Promise.resolve().then(() => require("./run-CDs_ebOt.cjs"));
+		await run({
+			input: positionals[0],
+			configPath: values.config,
+			logLevel,
+			watch: values.watch,
+			reporters,
+			noCache: values["no-cache"]
+		});
+	}
+});
+//#endregion
+exports.command = command;
+
+//# sourceMappingURL=generate-BRpukupe.cjs.map

package/dist/generate-BRpukupe.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-BRpukupe.cjs","names":["defineCommand"],"sources":["../src/commands/generate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport type { ReporterName } from '@kubb/core'\n\nexport const command = defineCommand({\n  name: 'generate',\n  description:\n    'Generate TypeScript types, API clients, React Query hooks, Zod schemas, and more from an OpenAPI specification. Reads kubb.config.ts by default. Pass an OpenAPI file path as the first argument to override the input without editing the config.',\n  arguments: ['[input]'],\n  examples: ['kubb generate', 'kubb generate ./openapi.yaml', 'kubb generate --config kubb.config.ts', 'kubb generate --watch'],\n  options: {\n    config: {\n      type: 'string',\n      description: 'Path to the Kubb config',\n      short: 'c',\n    },\n    logLevel: {\n      type: 'string',\n      description: 'Info, silent or verbose',\n      short: 'l',\n      default: 'info',\n      hint: 'silent|info|verbose',\n      enum: ['silent', 'info', 'verbose'],\n    },\n    watch: {\n      type: 'boolean',\n      description: 'Watch mode based on the input file',\n      short: 'w',\n      default: false,\n    },\n    verbose: {\n      type: 'boolean',\n      description: 'Override logLevel to verbose',\n      short: 'v',\n      default: false,\n    },\n    silent: {\n      type: 'boolean',\n      description: 'Override logLevel to silent',\n      short: 's',\n      default: false,\n    },\n    reporter: {\n      type: 'string',\n      description: 'Reporters that render the run, comma-separated. Overrides config.reporters',\n      hint: 'cli|json|file',\n      enum: ['cli', 'json', 'file'],\n    },\n    'no-cache': {\n      type: 'boolean',\n      description: 'Disable the incremental build cache and force a full regeneration',\n      default: false,\n    },\n  },\n  async run({ values, positionals }) {\n    const logLevel = values.verbose ? 'verbose' : values.silent ? 'silent' : values.logLevel\n    const reporters = values.reporter\n      ?.split(',')\n      .map((name) => name.trim())\n      .filter(Boolean) as Array<ReporterName> | undefined\n    const { run } = await import('../runners/generate/run.ts')\n\n    await run({\n      input: positionals[0],\n      configPath: values.config,\n      logLevel,\n      watch: values.watch,\n      reporters,\n      noCache: values['no-cache'],\n    })\n  },\n})\n"],"mappings":";;AAGA,MAAa,yCAAUA,CAAAA,CAAAA,cAAc;CACnC,MAAM;CACN,aACE;CACF,WAAW,CAAC,SAAS;CACrB,UAAU;EAAC;EAAiB;EAAgC;EAAyC;CAAuB;CAC5H,SAAS;EACP,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;EACT;EACA,UAAU;GACR,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACT,MAAM;GACN,MAAM;IAAC;IAAU;IAAQ;GAAS;EACpC;EACA,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,SAAS;GACP,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,UAAU;GACR,MAAM;GACN,aAAa;GACb,MAAM;GACN,MAAM;IAAC;IAAO;IAAQ;GAAM;EAC9B;EACA,YAAY;GACV,MAAM;GACN,aAAa;GACb,SAAS;EACX;CACF;CACA,MAAM,IAAI,EAAE,QAAQ,eAAe;EACjC,MAAM,WAAW,OAAO,UAAU,YAAY,OAAO,SAAS,WAAW,OAAO;EAChF,MAAM,YAAY,OAAO,UACrB,MAAM,GAAG,CAAC,CACX,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAC1B,OAAO,OAAO;EACjB,MAAM,EAAE,QAAQ,MAAA,QAAA,QAAA,CAAA,CAAA,WAAA,QAAM,oBAAA,CAAA;EAEtB,MAAM,IAAI;GACR,OAAO,YAAY;GACnB,YAAY,OAAO;GACnB;GACA,OAAO,OAAO;GACd;GACA,SAAS,OAAO;EAClB,CAAC;CACH;AACF,CAAC"}