@kubb/cli 4.32.3 → 4.33.0

package/dist/{telemetry-DYWvlxqs.js → telemetry-C4gOKX2x.js}

@@ -1,23 +1,44 @@
 import "./chunk--u3MIqq1.js";
+import { n as OTLP_ENDPOINT } from "./constants-CEKRremI.js";
 import { randomBytes } from "node:crypto";
 import os from "node:os";
-import process from "node:process";
+import process$1 from "node:process";
 import { executeIfOnline } from "@kubb/core/utils";
+//#region src/utils/envDetection.ts
+/**
+* Check if running in GitHub Actions environment
+*/
+function isGitHubActions() {
+	return !!process.env.GITHUB_ACTIONS;
+}
+/**
+* Check if running in any CI environment.
+* Covers all major CI systems via their well-known environment variables.
+*/
+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);
+}
+/**
+* Check if TTY is available for interactive output
+*/
+function canUseTTY() {
+	return !!process.stdout.isTTY && !isCIEnvironment();
+}
+//#endregion
 //#region src/utils/telemetry.ts
-const OTLP_ENDPOINT = "https://otlp.kubb.dev";
 /**
-* Detect whether the current process is running inside a CI environment by
-* checking the well-known environment variables set by all major CI systems.
+* Detect whether the current process is running inside a CI environment.
+* Delegates to the canonical isCIEnvironment() from envDetection.
 */
 function isCi() {
-	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"]);
+	return isCIEnvironment();
 }
 /**
 * Check if telemetry is disabled via DO_NOT_TRACK or KUBB_DISABLE_TELEMETRY.
 * Respects the standard DO_NOT_TRACK convention used across development tools.
 */
 function isTelemetryDisabled() {
-	return process.env["DO_NOT_TRACK"] === "1" || process.env["DO_NOT_TRACK"] === "true" || process.env["KUBB_DISABLE_TELEMETRY"] === "1" || process.env["KUBB_DISABLE_TELEMETRY"] === "true";
+	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";
 }
 /**
 * Convert a TelemetryEvent into an OTLP-compatible JSON trace payload.
@@ -131,12 +152,12 @@ async function sendTelemetry(event) {
 * No file paths, OpenAPI specs, or secrets are included.
 */
 function buildTelemetryEvent(options) {
-	const [seconds, nanoseconds] = process.hrtime(options.hrStart);
+	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.versions.node.split(".")[0] ?? "unknown",
+		nodeVersion: process$1.versions.node.split(".")[0],
 		platform: os.platform(),
 		ci: isCi(),
 		plugins: options.plugins ?? [],
@@ -146,6 +167,6 @@ function buildTelemetryEvent(options) {
 	};
 }
 //#endregion
-export { isTelemetryDisabled as n, sendTelemetry as r, buildTelemetryEvent as t };
+export { isGitHubActions as a, canUseTTY as i, isTelemetryDisabled as n, sendTelemetry as r, buildTelemetryEvent as t };
 
-//# sourceMappingURL=telemetry-DYWvlxqs.js.map
+//# sourceMappingURL=telemetry-C4gOKX2x.js.map

package/dist/telemetry-C4gOKX2x.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-C4gOKX2x.js","names":["process"],"sources":["../src/utils/envDetection.ts","../src/utils/telemetry.ts"],"sourcesContent":["/**\n * Check if running in GitHub Actions environment\n */\nexport function isGitHubActions(): boolean {\n  return !!process.env.GITHUB_ACTIONS\n}\n\n/**\n * Check if running in any CI environment.\n * Covers all major CI systems via their well-known environment variables.\n */\nexport function isCIEnvironment(): boolean {\n  return !!(\n    (\n      process.env.CI || // Generic (GitHub Actions, GitLab CI, CircleCI, Travis CI, etc.)\n      process.env.GITHUB_ACTIONS || // GitHub Actions\n      process.env.GITLAB_CI || // GitLab CI\n      process.env.BITBUCKET_BUILD_NUMBER || // Bitbucket Pipelines\n      process.env.JENKINS_URL || // Jenkins\n      process.env.CIRCLECI || // CircleCI\n      process.env.TRAVIS || // Travis CI\n      process.env.TEAMCITY_VERSION || // TeamCity\n      process.env.BUILDKITE || // Buildkite\n      process.env.TF_BUILD\n    ) // Azure Pipelines\n  )\n}\n\n/**\n * Check if TTY is available for interactive output\n */\nexport function canUseTTY(): boolean {\n  return !!process.stdout.isTTY && !isCIEnvironment()\n}\n","import { randomBytes } from 'node:crypto'\nimport os from 'node:os'\nimport process from 'node:process'\nimport { executeIfOnline } from '@kubb/core/utils'\nimport { OTLP_ENDPOINT } from '../constants.ts'\nimport { isCIEnvironment } from './envDetection.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-BDSSqUiG.cjs → telemetry-T5IA2dWA.cjs}

@@ -1,18 +1,39 @@
 const require_chunk = require("./chunk-ByKO4r7w.cjs");
+const require_constants = require("./constants-CnPOlsJq.cjs");
 let node_crypto = require("node:crypto");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 let node_process = require("node:process");
 node_process = require_chunk.__toESM(node_process);
 let _kubb_core_utils = require("@kubb/core/utils");
+//#region src/utils/envDetection.ts
+/**
+* Check if running in GitHub Actions environment
+*/
+function isGitHubActions() {
+	return !!process.env.GITHUB_ACTIONS;
+}
+/**
+* Check if running in any CI environment.
+* Covers all major CI systems via their well-known environment variables.
+*/
+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);
+}
+/**
+* Check if TTY is available for interactive output
+*/
+function canUseTTY() {
+	return !!process.stdout.isTTY && !isCIEnvironment();
+}
+//#endregion
 //#region src/utils/telemetry.ts
-const OTLP_ENDPOINT = "https://otlp.kubb.dev";
 /**
-* Detect whether the current process is running inside a CI environment by
-* checking the well-known environment variables set by all major CI systems.
+* Detect whether the current process is running inside a CI environment.
+* Delegates to the canonical isCIEnvironment() from envDetection.
 */
 function isCi() {
-	return !!(node_process.default.env["CI"] || node_process.default.env["GITHUB_ACTIONS"] || node_process.default.env["GITLAB_CI"] || node_process.default.env["BITBUCKET_BUILD_NUMBER"] || node_process.default.env["JENKINS_URL"] || node_process.default.env["CIRCLECI"] || node_process.default.env["TRAVIS"] || node_process.default.env["TEAMCITY_VERSION"] || node_process.default.env["BUILDKITE"] || node_process.default.env["TF_BUILD"]);
+	return isCIEnvironment();
 }
 /**
 * Check if telemetry is disabled via DO_NOT_TRACK or KUBB_DISABLE_TELEMETRY.
@@ -115,7 +136,7 @@ async function sendTelemetry(event) {
 	if (isTelemetryDisabled()) return;
 	await (0, _kubb_core_utils.executeIfOnline)(async () => {
 		try {
-			await fetch(`${OTLP_ENDPOINT}/v1/traces`, {
+			await fetch(`${require_constants.OTLP_ENDPOINT}/v1/traces`, {
 				method: "POST",
 				headers: {
 					"Content-Type": "application/json",
@@ -138,7 +159,7 @@ function buildTelemetryEvent(options) {
 	return {
 		command: options.command,
 		kubbVersion: options.kubbVersion,
-		nodeVersion: node_process.default.versions.node.split(".")[0] ?? "unknown",
+		nodeVersion: node_process.default.versions.node.split(".")[0],
 		platform: node_os.default.platform(),
 		ci: isCi(),
 		plugins: options.plugins ?? [],
@@ -154,6 +175,18 @@ Object.defineProperty(exports, "buildTelemetryEvent", {
 		return buildTelemetryEvent;
 	}
 });
+Object.defineProperty(exports, "canUseTTY", {
+	enumerable: true,
+	get: function() {
+		return canUseTTY;
+	}
+});
+Object.defineProperty(exports, "isGitHubActions", {
+	enumerable: true,
+	get: function() {
+		return isGitHubActions;
+	}
+});
 Object.defineProperty(exports, "isTelemetryDisabled", {
 	enumerable: true,
 	get: function() {
@@ -167,4 +200,4 @@ Object.defineProperty(exports, "sendTelemetry", {
 	}
 });
 
-//# sourceMappingURL=telemetry-BDSSqUiG.cjs.map
+//# sourceMappingURL=telemetry-T5IA2dWA.cjs.map

package/dist/telemetry-T5IA2dWA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-T5IA2dWA.cjs","names":["process","OTLP_ENDPOINT","os"],"sources":["../src/utils/envDetection.ts","../src/utils/telemetry.ts"],"sourcesContent":["/**\n * Check if running in GitHub Actions environment\n */\nexport function isGitHubActions(): boolean {\n  return !!process.env.GITHUB_ACTIONS\n}\n\n/**\n * Check if running in any CI environment.\n * Covers all major CI systems via their well-known environment variables.\n */\nexport function isCIEnvironment(): boolean {\n  return !!(\n    (\n      process.env.CI || // Generic (GitHub Actions, GitLab CI, CircleCI, Travis CI, etc.)\n      process.env.GITHUB_ACTIONS || // GitHub Actions\n      process.env.GITLAB_CI || // GitLab CI\n      process.env.BITBUCKET_BUILD_NUMBER || // Bitbucket Pipelines\n      process.env.JENKINS_URL || // Jenkins\n      process.env.CIRCLECI || // CircleCI\n      process.env.TRAVIS || // Travis CI\n      process.env.TEAMCITY_VERSION || // TeamCity\n      process.env.BUILDKITE || // Buildkite\n      process.env.TF_BUILD\n    ) // Azure Pipelines\n  )\n}\n\n/**\n * Check if TTY is available for interactive output\n */\nexport function canUseTTY(): boolean {\n  return !!process.stdout.isTTY && !isCIEnvironment()\n}\n","import { randomBytes } from 'node:crypto'\nimport os from 'node:os'\nimport process from 'node:process'\nimport { executeIfOnline } from '@kubb/core/utils'\nimport { OTLP_ENDPOINT } from '../constants.ts'\nimport { isCIEnvironment } from './envDetection.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/types-CLtz0jem.js

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

package/dist/types-CLtz0jem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-CLtz0jem.js","names":[],"sources":["../src/cli/types.ts"],"sourcesContent":["type BaseOption = {\n  /** Single-character short alias, e.g. `'c'` for `--config`. */\n  short?: string\n  description: string\n  hint?: string\n  required?: boolean\n  /** Allowed values for string options. Used in help output and AI/MCP tool schemas. */\n  enum?: string[]\n}\n\nexport type StringOption = BaseOption & { type: 'string'; default?: string }\nexport type BooleanOption = BaseOption & { type: 'boolean'; default?: boolean }\nexport type OptionDefinition = StringOption | BooleanOption\nexport type OptionType = OptionDefinition['type']\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/** Infers typed values from an options record. Options with a `default` or `required: true` are always defined. */\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\nexport type ParsedArgs = {\n  values: Record<string, string | boolean | undefined>\n  positionals: string[]\n}\n\nexport type CommandDefinition = {\n  name: string\n  description: string\n  /** Positional argument labels shown in usage line, e.g. `['[input]']`. */\n  arguments?: string[]\n  options?: Record<string, OptionDefinition>\n  subCommands?: CommandDefinition[]\n  run?: (args: ParsedArgs) => Promise<void>\n}\n\n/**\n * Returns a `CommandDefinition` with typed `values` in `run()`.\n * The callback receives `values` typed from the declared options — no casts needed.\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) => run({ values: args.values as InferValues<O>, positionals: args.positionals }),\n  }\n}\n\nexport type RunOptions = {\n  programName: string\n  defaultCommandName: string\n  version: string\n}\n\nexport type CLIAdapter = {\n  run(commands: CommandDefinition[], argv: string[], opts: RunOptions): Promise<void>\n  renderHelp(def: CommandDefinition, parentName?: string): void\n}\n\n/** Returns a `CLIAdapter` with type inference. Pass a different adapter to `createCLI` to swap the CLI engine. */\nexport function defineCLIAdapter(adapter: CLIAdapter): CLIAdapter {\n  return adapter\n}\n\nexport type OptionSchema = {\n  name: string\n  flags: string\n  type: OptionType\n  description: string\n  default?: string | boolean\n  hint?: string\n  required?: boolean\n  enum?: string[]\n}\n\nexport type CommandSchema = {\n  name: string\n  description: string\n  arguments?: string[]\n  options: OptionSchema[]\n  subCommands: CommandSchema[]\n}\n"],"mappings":";;;;;;AA6CA,SAAgB,cAA0D,KAOpD;CACpB,MAAM,EAAE,KAAK,GAAG,SAAS;AACzB,KAAI,CAAC,IAAK,QAAO;AACjB,QAAO;EACL,GAAG;EACH,MAAM,SAAS,IAAI;GAAE,QAAQ,KAAK;GAA0B,aAAa,KAAK;GAAa,CAAC;EAC7F;;;AAeH,SAAgB,iBAAiB,SAAiC;AAChE,QAAO"}

package/dist/types-Ck2lzFON.cjs

@@ -0,0 +1,36 @@
+require("./chunk-ByKO4r7w.cjs");
+//#region src/cli/types.ts
+/**
+* Returns a `CommandDefinition` with typed `values` in `run()`.
+* The callback receives `values` typed from the declared options — no casts needed.
+*/
+function defineCommand(def) {
+	const { run, ...rest } = def;
+	if (!run) return rest;
+	return {
+		...rest,
+		run: (args) => run({
+			values: args.values,
+			positionals: args.positionals
+		})
+	};
+}
+/** Returns a `CLIAdapter` with type inference. Pass a different adapter to `createCLI` to swap the CLI engine. */
+function defineCLIAdapter(adapter) {
+	return adapter;
+}
+//#endregion
+Object.defineProperty(exports, "defineCLIAdapter", {
+	enumerable: true,
+	get: function() {
+		return defineCLIAdapter;
+	}
+});
+Object.defineProperty(exports, "defineCommand", {
+	enumerable: true,
+	get: function() {
+		return defineCommand;
+	}
+});
+
+//# sourceMappingURL=types-Ck2lzFON.cjs.map

package/dist/types-Ck2lzFON.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-Ck2lzFON.cjs","names":[],"sources":["../src/cli/types.ts"],"sourcesContent":["type BaseOption = {\n  /** Single-character short alias, e.g. `'c'` for `--config`. */\n  short?: string\n  description: string\n  hint?: string\n  required?: boolean\n  /** Allowed values for string options. Used in help output and AI/MCP tool schemas. */\n  enum?: string[]\n}\n\nexport type StringOption = BaseOption & { type: 'string'; default?: string }\nexport type BooleanOption = BaseOption & { type: 'boolean'; default?: boolean }\nexport type OptionDefinition = StringOption | BooleanOption\nexport type OptionType = OptionDefinition['type']\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/** Infers typed values from an options record. Options with a `default` or `required: true` are always defined. */\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\nexport type ParsedArgs = {\n  values: Record<string, string | boolean | undefined>\n  positionals: string[]\n}\n\nexport type CommandDefinition = {\n  name: string\n  description: string\n  /** Positional argument labels shown in usage line, e.g. `['[input]']`. */\n  arguments?: string[]\n  options?: Record<string, OptionDefinition>\n  subCommands?: CommandDefinition[]\n  run?: (args: ParsedArgs) => Promise<void>\n}\n\n/**\n * Returns a `CommandDefinition` with typed `values` in `run()`.\n * The callback receives `values` typed from the declared options — no casts needed.\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) => run({ values: args.values as InferValues<O>, positionals: args.positionals }),\n  }\n}\n\nexport type RunOptions = {\n  programName: string\n  defaultCommandName: string\n  version: string\n}\n\nexport type CLIAdapter = {\n  run(commands: CommandDefinition[], argv: string[], opts: RunOptions): Promise<void>\n  renderHelp(def: CommandDefinition, parentName?: string): void\n}\n\n/** Returns a `CLIAdapter` with type inference. Pass a different adapter to `createCLI` to swap the CLI engine. */\nexport function defineCLIAdapter(adapter: CLIAdapter): CLIAdapter {\n  return adapter\n}\n\nexport type OptionSchema = {\n  name: string\n  flags: string\n  type: OptionType\n  description: string\n  default?: string | boolean\n  hint?: string\n  required?: boolean\n  enum?: string[]\n}\n\nexport type CommandSchema = {\n  name: string\n  description: string\n  arguments?: string[]\n  options: OptionSchema[]\n  subCommands: CommandSchema[]\n}\n"],"mappings":";;;;;;AA6CA,SAAgB,cAA0D,KAOpD;CACpB,MAAM,EAAE,KAAK,GAAG,SAAS;AACzB,KAAI,CAAC,IAAK,QAAO;AACjB,QAAO;EACL,GAAG;EACH,MAAM,SAAS,IAAI;GAAE,QAAQ,KAAK;GAA0B,aAAa,KAAK;GAAa,CAAC;EAC7F;;;AAeH,SAAgB,iBAAiB,SAAiC;AAChE,QAAO"}

package/dist/validate-Chjg23AE.js

@@ -0,0 +1,41 @@
+import "./chunk--u3MIqq1.js";
+import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-C4gOKX2x.js";
+import { t as getErrorMessage } from "./errors-bSLTEh4e.js";
+import { t as jiti } from "./jiti-Cl7t20dO.js";
+import process from "node:process";
+//#region src/runners/validate.ts
+async function runValidate({ input, version }) {
+	let mod;
+	try {
+		mod = await jiti.import("@kubb/oas", { default: true });
+	} catch (_e) {
+		console.error(`Import of '@kubb/oas' is required to do validation`);
+		process.exit(1);
+	}
+	const { parse } = mod;
+	const hrStart = process.hrtime();
+	try {
+		await (await parse(input)).validate();
+		await sendTelemetry(buildTelemetryEvent({
+			command: "validate",
+			kubbVersion: version,
+			hrStart,
+			status: "success"
+		}));
+		console.log("✅ Validation success");
+	} catch (error) {
+		await sendTelemetry(buildTelemetryEvent({
+			command: "validate",
+			kubbVersion: version,
+			hrStart,
+			status: "failed"
+		}));
+		console.error("❌ Validation failed");
+		console.error(getErrorMessage(error));
+		process.exit(1);
+	}
+}
+//#endregion
+export { runValidate };
+
+//# sourceMappingURL=validate-Chjg23AE.js.map

package/dist/validate-Chjg23AE.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-Chjg23AE.js","names":[],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport type * as OasModule from '@kubb/oas'\nimport { getErrorMessage } from '../utils/errors.ts'\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-Cr26q5xX.js

@@ -0,0 +1,25 @@
+import "./chunk--u3MIqq1.js";
+import { t as version } from "./package-681jTtCk.js";
+import { n as defineCommand } from "./types-CLtz0jem.js";
+//#region src/commands/validate.ts
+const command = defineCommand({
+	name: "validate",
+	description: "Validate a Swagger/OpenAPI file",
+	options: { input: {
+		type: "string",
+		description: "Path to Swagger/OpenAPI file",
+		short: "i",
+		required: true
+	} },
+	async run({ values }) {
+		const { runValidate } = await import("./validate-Chjg23AE.js");
+		await runValidate({
+			input: values.input,
+			version
+		});
+	}
+});
+//#endregion
+export { command };
+
+//# sourceMappingURL=validate-Cr26q5xX.js.map

package/dist/validate-Cr26q5xX.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-Cr26q5xX.js","names":[],"sources":["../src/commands/validate.ts"],"sourcesContent":["import { version } from '../../package.json'\nimport { defineCommand } from '../cli/index.ts'\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-DURmg-2Q.cjs

@@ -0,0 +1,24 @@
+require("./chunk-ByKO4r7w.cjs");
+const require_package = require("./package-aKgzEJtp.cjs");
+//#region src/commands/validate.ts
+const command = require("./types-Ck2lzFON.cjs").defineCommand({
+	name: "validate",
+	description: "Validate a Swagger/OpenAPI file",
+	options: { input: {
+		type: "string",
+		description: "Path to Swagger/OpenAPI file",
+		short: "i",
+		required: true
+	} },
+	async run({ values }) {
+		const { runValidate } = await Promise.resolve().then(() => require("./validate-Dqi9T_c4.cjs"));
+		await runValidate({
+			input: values.input,
+			version: require_package.version
+		});
+	}
+});
+//#endregion
+exports.command = command;
+
+//# sourceMappingURL=validate-DURmg-2Q.cjs.map

package/dist/validate-DURmg-2Q.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-DURmg-2Q.cjs","names":["defineCommand"],"sources":["../src/commands/validate.ts"],"sourcesContent":["import { version } from '../../package.json'\nimport { defineCommand } from '../cli/index.ts'\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,0CAAUA,cAAc;CACnC,MAAM;CACN,aAAa;CACb,SAAS,EACP,OAAO;EAAE,MAAM;EAAU,aAAa;EAAgC,OAAO;EAAK,UAAU;EAAM,EACnG;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,gBAAgB,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,0BAAA,CAAA;AAE9B,QAAM,YAAY;GAAE,OAAO,OAAO;GAAO,SAAA,gBAAA;GAAS,CAAC;;CAEtD,CAAC"}

package/dist/validate-Dqi9T_c4.cjs

@@ -0,0 +1,42 @@
+const require_chunk = require("./chunk-ByKO4r7w.cjs");
+const require_telemetry = require("./telemetry-T5IA2dWA.cjs");
+const require_errors = require("./errors-BUjJsNoe.cjs");
+const require_jiti = require("./jiti-BdskUHhD.cjs");
+let node_process = require("node:process");
+node_process = require_chunk.__toESM(node_process);
+//#region src/runners/validate.ts
+async function runValidate({ input, version }) {
+	let mod;
+	try {
+		mod = await require_jiti.jiti.import("@kubb/oas", { default: true });
+	} catch (_e) {
+		console.error(`Import of '@kubb/oas' is required to do validation`);
+		node_process.default.exit(1);
+	}
+	const { parse } = mod;
+	const hrStart = node_process.default.hrtime();
+	try {
+		await (await parse(input)).validate();
+		await require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
+			command: "validate",
+			kubbVersion: version,
+			hrStart,
+			status: "success"
+		}));
+		console.log("✅ Validation success");
+	} catch (error) {
+		await require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
+			command: "validate",
+			kubbVersion: version,
+			hrStart,
+			status: "failed"
+		}));
+		console.error("❌ Validation failed");
+		console.error(require_errors.getErrorMessage(error));
+		node_process.default.exit(1);
+	}
+}
+//#endregion
+exports.runValidate = runValidate;
+
+//# sourceMappingURL=validate-Dqi9T_c4.cjs.map

package/dist/validate-Dqi9T_c4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-Dqi9T_c4.cjs","names":["jiti","process","sendTelemetry","buildTelemetryEvent","getErrorMessage"],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport type * as OasModule from '@kubb/oas'\nimport { getErrorMessage } from '../utils/errors.ts'\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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/cli",
-  "version": "4.32.3",
+  "version": "4.33.0",
   "description": "Command-line interface for Kubb, enabling easy generation of TypeScript, React-Query, Zod, and other code from OpenAPI specifications.",
   "keywords": [
     "cli",
@@ -55,17 +55,16 @@
   "dependencies": {
     "@clack/prompts": "^1.1.0",
     "chokidar": "^5.0.0",
-    "citty": "^0.1.6",
     "cosmiconfig": "^9.0.1",
     "jiti": "2.5.1",
     "tinyexec": "^1.0.2",
-    "@kubb/core": "4.32.3"
+    "@kubb/core": "4.33.0"
   },
   "devDependencies": {
     "source-map-support": "^0.5.21",
-    "@kubb/agent": "4.32.3",
-    "@kubb/mcp": "4.32.3",
-    "@kubb/oas": "4.32.3"
+    "@kubb/agent": "4.33.0",
+    "@kubb/mcp": "4.33.0",
+    "@kubb/oas": "4.33.0"
   },
   "engines": {
     "node": ">=20"

package/src/cli/adapters/nodeAdapter.ts

@@ -0,0 +1,159 @@
+import { parseArgs, styleText } from 'node:util'
+import { renderHelp } from '../help.ts'
+import type { CommandDefinition, OptionType, ParsedArgs, RunOptions } from '../types.ts'
+import { defineCLIAdapter } from '../types.ts'
+
+type ParseOption = { type: OptionType; short?: string; default?: string | boolean }
+type ParseOptions = Record<string, ParseOption>
+
+function buildParseOptions(def: CommandDefinition): ParseOptions {
+  const result: ParseOptions = {
+    help: { type: 'boolean', short: 'h' },
+  }
+
+  for (const [name, opt] of Object.entries(def.options ?? {})) {
+    result[name] = {
+      type: opt.type,
+      ...(opt.short ? { short: opt.short } : {}),
+      ...(opt.default !== undefined ? { default: opt.default } : {}),
+    }
+  }
+
+  return result
+}
+
+async function runCommand(def: CommandDefinition, argv: string[], parentName?: string): Promise<void> {
+  const parseOptions = buildParseOptions(def)
+
+  let parsed: ParsedArgs
+  try {
+    const result = parseArgs({
+      args: argv,
+      options: parseOptions,
+      allowPositionals: true,
+      strict: false,
+    })
+    parsed = { values: result.values as ParsedArgs['values'], positionals: result.positionals }
+  } catch {
+    renderHelp(def, parentName)
+    process.exit(1)
+  }
+
+  if (parsed.values['help']) {
+    renderHelp(def, parentName)
+    process.exit(0)
+  }
+
+  // Validate required options before running the command
+  for (const [name, opt] of Object.entries(def.options ?? {})) {
+    if (opt.required && parsed.values[name] === undefined) {
+      console.error(styleText('red', `Error: --${name} is required`))
+      renderHelp(def, parentName)
+      process.exit(1)
+    }
+  }
+
+  if (!def.run) {
+    renderHelp(def, parentName)
+    process.exit(0)
+  }
+
+  try {
+    await def.run(parsed)
+  } catch (err) {
+    console.error(styleText('red', `Error: ${err instanceof Error ? err.message : String(err)}`))
+    renderHelp(def, parentName)
+    process.exit(1)
+  }
+}
+
+function printRootHelp(programName: string, version: string, defs: CommandDefinition[]): void {
+  console.log(`\n${styleText('bold', 'Usage:')} ${programName} <command> [options]\n`)
+  console.log(`  Kubb generation — v${version}\n`)
+  console.log(styleText('bold', 'Commands:'))
+  for (const def of defs) {
+    console.log(`  ${styleText('cyan', def.name.padEnd(16))}${def.description}`)
+  }
+  console.log()
+  console.log(styleText('bold', 'Options:'))
+  console.log(`  ${styleText('cyan', '-v, --version'.padEnd(30))}Show version number`)
+  console.log(`  ${styleText('cyan', '-h, --help'.padEnd(30))}Show help`)
+  console.log()
+  console.log(`Run ${styleText('cyan', `${programName} <command> --help`)} for command-specific help.\n`)
+}
+
+/** CLI adapter using `node:util parseArgs`. No external dependencies. */
+export const nodeAdapter = defineCLIAdapter({
+  renderHelp(def: CommandDefinition, parentName?: string): void {
+    renderHelp(def, parentName)
+  },
+
+  async run(defs: CommandDefinition[], argv: string[], opts: RunOptions): Promise<void> {
+    const { programName, defaultCommandName, version } = opts
+
+    const args = argv.length >= 2 && argv[0]?.includes('node') ? argv.slice(2) : argv
+
+    if (args[0] === '--version' || args[0] === '-v') {
+      console.log(version)
+      process.exit(0)
+    }
+
+    if (args[0] === '--help' || args[0] === '-h') {
+      printRootHelp(programName, version, defs)
+      process.exit(0)
+    }
+
+    if (args.length === 0) {
+      const defaultDef = defs.find((d) => d.name === defaultCommandName)
+      if (defaultDef?.run) {
+        await runCommand(defaultDef, [], programName)
+      } else {
+        printRootHelp(programName, version, defs)
+      }
+      return
+    }
+
+    const [first, ...rest] = args
+    const isKnownSubcommand = defs.some((d) => d.name === first)
+
+    let def: CommandDefinition | undefined
+    let commandArgv: string[]
+    let parentName: string | undefined
+
+    if (isKnownSubcommand) {
+      def = defs.find((d) => d.name === first)
+      commandArgv = rest
+      parentName = programName
+    } else {
+      def = defs.find((d) => d.name === defaultCommandName)
+      commandArgv = args
+      parentName = programName
+    }
+
+    if (!def) {
+      console.error(`Unknown command: ${first}`)
+      printRootHelp(programName, version, defs)
+      process.exit(1)
+    }
+
+    if (def.subCommands?.length) {
+      const [subName, ...subRest] = commandArgv
+      const subDef = def.subCommands.find((s) => s.name === subName)
+
+      if (subName === '--help' || subName === '-h') {
+        renderHelp(def, parentName)
+        process.exit(0)
+      }
+
+      if (!subDef) {
+        renderHelp(def, parentName)
+        process.exit(subName ? 1 : 0)
+      }
+
+      await runCommand(subDef, subRest, `${parentName} ${def.name}`)
+      return
+    }
+
+    await runCommand(def, commandArgv, parentName)
+  },
+})