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

package/dist/{telemetry-DxiR7clS.js → telemetry-LgT_sdPe.js}

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

package/dist/telemetry-LgT_sdPe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-LgT_sdPe.js","names":["dnsPromises","process"],"sources":["../../../internals/utils/src/env.ts","../../../internals/utils/src/network.ts","../src/utils/telemetry.ts"],"sourcesContent":["/**\n * Returns `true` when running inside a GitHub Actions workflow.\n *\n * @example\n * ```ts\n * if (isGitHubActions()) {\n *   core.setOutput('result', 'ok')\n * }\n * ```\n */\nexport function isGitHubActions(): boolean {\n  return !!process.env.GITHUB_ACTIONS\n}\n\n/**\n * Returns `true` when the process is running in a CI environment.\n * Covers GitHub Actions, GitLab CI, CircleCI, Travis CI, Jenkins, Bitbucket,\n * TeamCity, Buildkite, and Azure Pipelines.\n *\n * @example\n * ```ts\n * if (isCIEnvironment()) {\n *   logger.level = 'error'\n * }\n * ```\n */\nexport function isCIEnvironment(): boolean {\n  return !!(\n    process.env.CI ||\n    process.env.GITHUB_ACTIONS ||\n    process.env.GITLAB_CI ||\n    process.env.BITBUCKET_BUILD_NUMBER ||\n    process.env.JENKINS_URL ||\n    process.env.CIRCLECI ||\n    process.env.TRAVIS ||\n    process.env.TEAMCITY_VERSION ||\n    process.env.BUILDKITE ||\n    process.env.TF_BUILD\n  )\n}\n\n/**\n * Returns `true` when the process has an interactive TTY with a valid terminal\n * width and is not running in CI.\n *\n * Some IDE-embedded terminals report `isTTY = true` but set `columns` to `0`,\n * which breaks clack's box-drawing helpers (they call `String.prototype.repeat`\n * with a negative count and throw a `RangeError`).  We therefore require a\n * positive column count before declaring the TTY usable.\n *\n * @example\n * ```ts\n * if (canUseTTY()) {\n *   renderProgressBar()\n * }\n * ```\n */\nexport function canUseTTY(): boolean {\n  return !!process.stdout.isTTY && (process.stdout.columns ?? 0) > 0 && !isCIEnvironment()\n}\n","import { promises as dnsPromises } from 'node:dns'\n\n/**\n * Well-known stable domains used as DNS probes to check internet connectivity.\n */\nconst TEST_DOMAINS = ['dns.google.com', 'cloudflare.com', 'one.one.one.one'] as const\n\n/**\n * Returns `true` when the system has internet connectivity.\n * Probes DNS resolution against well-known stable domains.\n *\n * @example\n * ```ts\n * if (await isOnline()) {\n *   await fetchLatestVersion()\n * }\n * ```\n */\nexport async function isOnline(): Promise<boolean> {\n  for (const domain of TEST_DOMAINS) {\n    try {\n      await dnsPromises.resolve(domain)\n      return true\n    } catch {\n      // Try next domain\n    }\n  }\n\n  return false\n}\n\n/**\n * Executes `fn` only when the system is online. Returns `null` when offline or on error.\n *\n * @example\n * ```ts\n * const version = await executeIfOnline(() => fetchLatestVersion('kubb'))\n * // null when offline\n * ```\n */\nexport async function executeIfOnline<T>(fn: () => Promise<T>): Promise<T | null> {\n  if (!(await isOnline())) return null\n\n  try {\n    return await fn()\n  } catch {\n    return null\n  }\n}\n","import { randomBytes } from 'node:crypto'\nimport os from 'node:os'\nimport process from 'node:process'\nimport { executeIfOnline, isCIEnvironment } from '@internals/utils'\nimport { OTLP_ENDPOINT } from '../constants.ts'\n\n// OpenTelemetry OTLP JSON types\n// https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto\n// https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/common/v1/common.proto\n\ntype OtlpStringValue = { stringValue: string }\ntype OtlpBoolValue = { boolValue: boolean }\ntype OtlpIntValue = { intValue: number }\ntype OtlpDoubleValue = { doubleValue: number }\ntype OtlpBytesValue = { bytesValue: string }\ntype OtlpArrayValue = { arrayValue: { values: OtlpAnyValue[] } }\ntype OtlpKvListValue = { kvlistValue: { values: OtlpKeyValue[] } }\n\ntype OtlpAnyValue = OtlpStringValue | OtlpBoolValue | OtlpIntValue | OtlpDoubleValue | OtlpBytesValue | OtlpArrayValue | OtlpKvListValue\n\ntype OtlpKeyValue = {\n  key: string\n  value: OtlpAnyValue\n}\n\ntype OtlpResource = {\n  attributes: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpInstrumentationScope = {\n  name: string\n  version?: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\n/** https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto#L103 */\ntype OtlpSpanKind = 0 | 1 | 2 | 3 | 4 | 5\n\n/** 0 = STATUS_CODE_UNSET, 1 = STATUS_CODE_OK, 2 = STATUS_CODE_ERROR */\ntype OtlpStatusCode = 0 | 1 | 2\n\ntype OtlpStatus = {\n  code: OtlpStatusCode\n  message?: string\n}\n\ntype OtlpSpan = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  parentSpanId?: string\n  name: string\n  kind: OtlpSpanKind\n  startTimeUnixNano: string\n  endTimeUnixNano: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n  events?: OtlpSpanEvent[]\n  droppedEventsCount?: number\n  links?: OtlpSpanLink[]\n  droppedLinksCount?: number\n  status?: OtlpStatus\n}\n\ntype OtlpSpanEvent = {\n  timeUnixNano: string\n  name: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpSpanLink = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpScopeSpans = {\n  scope: OtlpInstrumentationScope\n  spans: OtlpSpan[]\n  schemaUrl?: string\n}\n\ntype OtlpResourceSpans = {\n  resource: OtlpResource\n  scopeSpans: OtlpScopeSpans[]\n  schemaUrl?: string\n}\n\n/** Root payload sent to POST /v1/traces */\ntype OtlpExportTraceServiceRequest = {\n  resourceSpans: OtlpResourceSpans[]\n}\n\nexport type TelemetryPlugin = {\n  name: string\n  options: Record<string, unknown>\n}\n\ntype TelemetryEvent = {\n  command: string\n  kubbVersion: string\n  nodeVersion: string\n  platform: string\n  ci: boolean\n  plugins: TelemetryPlugin[]\n  duration: number\n  filesCreated: number\n  status: 'success' | 'failed'\n}\n\n/**\n * Detect whether the current process is running inside a CI environment.\n * Delegates to the canonical isCIEnvironment() from envDetection.\n */\nexport function isCi(): boolean {\n  return isCIEnvironment()\n}\n\n/**\n * Check if telemetry is disabled via DO_NOT_TRACK or KUBB_DISABLE_TELEMETRY.\n * Respects the standard DO_NOT_TRACK convention used across development tools.\n */\nexport function isTelemetryDisabled(): boolean {\n  return (\n    process.env['DO_NOT_TRACK'] === '1' ||\n    process.env['DO_NOT_TRACK'] === 'true' ||\n    process.env['KUBB_DISABLE_TELEMETRY'] === '1' ||\n    process.env['KUBB_DISABLE_TELEMETRY'] === 'true'\n  )\n}\n\n/**\n * Convert a TelemetryEvent into an OTLP-compatible JSON trace payload.\n * See https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/\n */\nexport function buildOtlpPayload(event: TelemetryEvent): OtlpExportTraceServiceRequest {\n  const traceId = randomBytes(16).toString('hex')\n  const spanId = randomBytes(8).toString('hex')\n  const endTimeNs = BigInt(Date.now()) * 1_000_000n\n  const startTimeNs = endTimeNs - BigInt(event.duration) * 1_000_000n\n\n  const attributes: OtlpKeyValue[] = [\n    { key: 'kubb.command', value: { stringValue: event.command } },\n    { key: 'kubb.version', value: { stringValue: event.kubbVersion } },\n    { key: 'kubb.node_version', value: { stringValue: event.nodeVersion } },\n    { key: 'kubb.platform', value: { stringValue: event.platform } },\n    { key: 'kubb.ci', value: { boolValue: event.ci } },\n    { key: 'kubb.files_created', value: { intValue: event.filesCreated } },\n    { key: 'kubb.status', value: { stringValue: event.status } },\n    {\n      key: 'kubb.plugins',\n      value: {\n        arrayValue: {\n          values: event.plugins.map(\n            (p): OtlpKvListValue => ({\n              kvlistValue: {\n                values: [\n                  { key: 'name', value: { stringValue: p.name } },\n                  {\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-cli' } },\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-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: {\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.\n * Respects DO_NOT_TRACK and KUBB_DISABLE_TELEMETRY environment variables.\n * Fails silently to never interrupt the generation process.\n */\nexport async function sendTelemetry(event: TelemetryEvent): Promise<void> {\n  if (isTelemetryDisabled()) {\n    return\n  }\n\n  await executeIfOnline(async () => {\n    try {\n      await fetch(`${OTLP_ENDPOINT}/v1/traces`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'Kubb-Telemetry-Version': '1',\n          'Kubb-Telemetry-Source': 'kubb-cli',\n        },\n        body: JSON.stringify(buildOtlpPayload(event)),\n        signal: AbortSignal.timeout(5_000),\n      })\n    } catch (_e) {\n      // Fail silently – telemetry must never break the CLI\n    }\n  })\n}\n\n/**\n * Build an anonymous telemetry payload from a completed generation run.\n * No file paths, OpenAPI specs, or secrets are included.\n */\nexport function buildTelemetryEvent(options: {\n  command: 'generate' | 'mcp' | 'validate' | 'agent'\n  kubbVersion: string\n  plugins?: TelemetryPlugin[]\n  hrStart: [number, number]\n  filesCreated?: number\n  status: 'success' | 'failed'\n}): TelemetryEvent {\n  const [seconds, nanoseconds] = process.hrtime(options.hrStart)\n  const duration = Math.round(seconds * 1000 + nanoseconds / 1e6)\n\n  return {\n    command: options.command,\n    kubbVersion: options.kubbVersion,\n    nodeVersion: process.versions.node.split('.')[0] as string,\n    platform: os.platform(),\n    ci: isCi(),\n    plugins: options.plugins ?? [],\n    duration,\n    filesCreated: options.filesCreated ?? 0,\n    status: options.status,\n  }\n}\n"],"mappings":"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"}

package/dist/{validate-D5CuvkLl.js → validate-CIR3_lZI.js}

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

package/dist/validate-CIR3_lZI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-CIR3_lZI.js","names":[],"sources":["../src/commands/validate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'validate',\n  description: 'Validate a Swagger/OpenAPI file',\n  options: {\n    input: {\n      type: 'string',\n      description: 'Path to Swagger/OpenAPI file',\n      short: 'i',\n      required: true,\n    },\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;EACL,MAAM;EACN,aAAa;EACb,OAAO;EACP,UAAU;EACX,EACF;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-D8Zb-dns.cjs → validate-DcqUb4DM.cjs}

@@ -1,6 +1,6 @@
 require("./chunk-ByKO4r7w.cjs");
-const require_define = require("./define-D6Kfm7-Z.cjs");
-const require_package = require("./package-CbrJTkI2.cjs");
+const require_define = require("./define-Bdn8j5VM.cjs");
+const require_package = require("./package-D5arPDnh.cjs");
 //#region src/commands/validate.ts
 const command = require_define.defineCommand({
 	name: "validate",
@@ -12,7 +12,7 @@ const command = require_define.defineCommand({
 		required: true
 	} },
 	async run({ values }) {
-		const { runValidate } = await Promise.resolve().then(() => require("./validate-Bbrn3Q-A.cjs"));
+		const { runValidate } = await Promise.resolve().then(() => require("./validate-yKKzqEZ5.cjs"));
 		await runValidate({
 			input: values.input,
 			version: require_package.version
@@ -22,4 +22,4 @@ const command = require_define.defineCommand({
 //#endregion
 exports.command = command;
 
-//# sourceMappingURL=validate-D8Zb-dns.cjs.map
+//# sourceMappingURL=validate-DcqUb4DM.cjs.map

package/dist/validate-DcqUb4DM.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-DcqUb4DM.cjs","names":["defineCommand"],"sources":["../src/commands/validate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'validate',\n  description: 'Validate a Swagger/OpenAPI file',\n  options: {\n    input: {\n      type: 'string',\n      description: 'Path to Swagger/OpenAPI file',\n      short: 'i',\n      required: true,\n    },\n  },\n  async run({ values }) {\n    const { runValidate } = await import('../runners/validate.ts')\n\n    await runValidate({ input: values.input, version })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAUA,eAAAA,cAAc;CACnC,MAAM;CACN,aAAa;CACb,SAAS,EACP,OAAO;EACL,MAAM;EACN,aAAa;EACb,OAAO;EACP,UAAU;EACX,EACF;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-l8vLmwKA.js → validate-kLJoT_hi.js}

@@ -1,21 +1,13 @@
 import "./chunk--u3MIqq1.js";
-import { t as getErrorMessage } from "./errors-6mF_WKxg.js";
-import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-DxiR7clS.js";
-import { t as jiti } from "./jiti-e08mD2Ph.js";
+import { t as getErrorMessage } from "./errors-CjPmyZHy.js";
+import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-LgT_sdPe.js";
 import process from "node:process";
+import { parseDocument, validateDocument } from "@kubb/adapter-oas";
 //#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 validateDocument(await parseDocument(input), { throwOnError: true });
 		await sendTelemetry(buildTelemetryEvent({
 			command: "validate",
 			kubbVersion: version,
@@ -38,4 +30,4 @@ async function runValidate({ input, version }) {
 //#endregion
 export { runValidate };
 
-//# sourceMappingURL=validate-l8vLmwKA.js.map
+//# sourceMappingURL=validate-kLJoT_hi.js.map

package/dist/validate-kLJoT_hi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-kLJoT_hi.js","names":[],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport { getErrorMessage } from '@internals/utils'\nimport { parseDocument, validateDocument } from '@kubb/adapter-oas'\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  const hrStart = process.hrtime()\n  try {\n    const document = await parseDocument(input)\n    await validateDocument(document, { throwOnError: true })\n\n    await sendTelemetry(\n      buildTelemetryEvent({\n        command: 'validate',\n        kubbVersion: version,\n        hrStart,\n        status: 'success',\n      }),\n    )\n    console.log('✅ Validation success')\n  } catch (error) {\n    await sendTelemetry(\n      buildTelemetryEvent({\n        command: 'validate',\n        kubbVersion: version,\n        hrStart,\n        status: 'failed',\n      }),\n    )\n    console.error('❌ Validation failed')\n    console.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;AAUA,eAAsB,YAAY,EAAE,OAAO,WAA2C;CACpF,MAAM,UAAU,QAAQ,QAAQ;AAChC,KAAI;AAEF,QAAM,iBAAiB,MADA,cAAc,MAAM,EACV,EAAE,cAAc,MAAM,CAAC;AAExD,QAAM,cACJ,oBAAoB;GAClB,SAAS;GACT,aAAa;GACb;GACA,QAAQ;GACT,CAAC,CACH;AACD,UAAQ,IAAI,uBAAuB;UAC5B,OAAO;AACd,QAAM,cACJ,oBAAoB;GAClB,SAAS;GACT,aAAa;GACb;GACA,QAAQ;GACT,CAAC,CACH;AACD,UAAQ,MAAM,sBAAsB;AACpC,UAAQ,MAAM,gBAAgB,MAAM,CAAC;AACrC,UAAQ,KAAK,EAAE"}

package/dist/{validate-Bbrn3Q-A.cjs → validate-yKKzqEZ5.cjs}

@@ -1,22 +1,14 @@
 const require_chunk = require("./chunk-ByKO4r7w.cjs");
-const require_errors = require("./errors-DBW0N9w4.cjs");
-const require_telemetry = require("./telemetry-Cn9X1I5B.cjs");
-const require_jiti = require("./jiti-Cd3S0xwr.cjs");
+const require_errors = require("./errors-CLCjoSg0.cjs");
+const require_telemetry = require("./telemetry-DN95_2pF.cjs");
 let node_process = require("node:process");
-node_process = require_chunk.__toESM(node_process);
+node_process = require_chunk.__toESM(node_process, 1);
+let _kubb_adapter_oas = require("@kubb/adapter-oas");
 //#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 (0, _kubb_adapter_oas.validateDocument)(await (0, _kubb_adapter_oas.parseDocument)(input), { throwOnError: true });
 		await require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
 			command: "validate",
 			kubbVersion: version,
@@ -39,4 +31,4 @@ async function runValidate({ input, version }) {
 //#endregion
 exports.runValidate = runValidate;
 
-//# sourceMappingURL=validate-Bbrn3Q-A.cjs.map
+//# sourceMappingURL=validate-yKKzqEZ5.cjs.map

package/dist/validate-yKKzqEZ5.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-yKKzqEZ5.cjs","names":["process","sendTelemetry","buildTelemetryEvent","getErrorMessage"],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport { getErrorMessage } from '@internals/utils'\nimport { parseDocument, validateDocument } from '@kubb/adapter-oas'\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  const hrStart = process.hrtime()\n  try {\n    const document = await parseDocument(input)\n    await validateDocument(document, { throwOnError: true })\n\n    await sendTelemetry(\n      buildTelemetryEvent({\n        command: 'validate',\n        kubbVersion: version,\n        hrStart,\n        status: 'success',\n      }),\n    )\n    console.log('✅ Validation success')\n  } catch (error) {\n    await sendTelemetry(\n      buildTelemetryEvent({\n        command: 'validate',\n        kubbVersion: version,\n        hrStart,\n        status: 'failed',\n      }),\n    )\n    console.error('❌ Validation failed')\n    console.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;;AAUA,eAAsB,YAAY,EAAE,OAAO,WAA2C;CACpF,MAAM,UAAUA,aAAAA,QAAQ,QAAQ;AAChC,KAAI;AAEF,SAAA,GAAA,kBAAA,kBAAuB,OAAA,GAAA,kBAAA,eADc,MAAM,EACV,EAAE,cAAc,MAAM,CAAC;AAExD,QAAMC,kBAAAA,cACJC,kBAAAA,oBAAoB;GAClB,SAAS;GACT,aAAa;GACb;GACA,QAAQ;GACT,CAAC,CACH;AACD,UAAQ,IAAI,uBAAuB;UAC5B,OAAO;AACd,QAAMD,kBAAAA,cACJC,kBAAAA,oBAAoB;GAClB,SAAS;GACT,aAAa;GACb;GACA,QAAQ;GACT,CAAC,CACH;AACD,UAAQ,MAAM,sBAAsB;AACpC,UAAQ,MAAMC,eAAAA,gBAAgB,MAAM,CAAC;AACrC,eAAA,QAAQ,KAAK,EAAE"}

package/package.json

@@ -1,41 +1,31 @@
 {
   "name": "@kubb/cli",
-  "version": "5.0.0-alpha.8",
+  "version": "5.0.0-beta.75",
   "description": "Command-line interface for Kubb, enabling easy generation of TypeScript, React-Query, Zod, and other code from OpenAPI specifications.",
   "keywords": [
     "cli",
+    "code-generator",
+    "codegen",
     "command-line",
     "command-line-tool",
-    "terminal",
-    "typescript",
-    "openapi",
-    "swagger",
+    "kubb",
     "oas",
-    "code-generator",
-    "codegen",
-    "sdk-generator",
+    "openapi",
     "plugins",
-    "kubb"
+    "sdk-generator",
+    "swagger",
+    "terminal",
+    "typescript"
   ],
+  "license": "MIT",
+  "author": "stijnvanhulle",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kubb-labs/kubb.git",
     "directory": "packages/cli"
   },
-  "license": "MIT",
-  "author": "stijnvanhulle",
-  "sideEffects": false,
-  "type": "module",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./package.json": "./package.json"
-  },
-  "types": "./dist/index.d.ts",
   "bin": {
-    "kubb": "bin/kubb.cjs"
+    "kubb": "bin/kubb.js"
   },
   "files": [
     "src",
@@ -45,6 +35,38 @@
     "!/**/__tests__/**",
     "!/**/__snapshots__/**"
   ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.3.0",
+    "chokidar": "^5.0.0",
+    "cosmiconfig": "^9.0.1",
+    "tinyexec": "^1.1.2",
+    "unrun": "^0.2.37",
+    "@kubb/core": "5.0.0-beta.75",
+    "@kubb/adapter-oas": "5.0.0-beta.75"
+  },
+  "devDependencies": {
+    "@internals/utils": "0.0.0"
+  },
+  "optionalDependencies": {
+    "@kubb/agent": "5.0.0-beta.75",
+    "@kubb/mcp": "5.0.0-beta.75"
+  },
   "size-limit": [
     {
       "path": "./dist/*.js",
@@ -52,36 +74,15 @@
       "gzip": true
     }
   ],
-  "dependencies": {
-    "@clack/prompts": "^1.1.0",
-    "chokidar": "^5.0.0",
-    "cosmiconfig": "^9.0.1",
-    "jiti": "2.5.1",
-    "tinyexec": "^1.0.4",
-    "@kubb/core": "5.0.0-alpha.8"
-  },
-  "devDependencies": {
-    "source-map-support": "^0.5.21",
-    "@internals/utils": "0.0.0",
-    "@kubb/agent": "5.0.0-alpha.8",
-    "@kubb/mcp": "5.0.0-alpha.8",
-    "@kubb/oas": "5.0.0-alpha.8"
-  },
+  "preferGlobal": true,
   "engines": {
     "node": ">=22"
   },
-  "preferGlobal": true,
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
   "scripts": {
     "build": "tsdown && size-limit",
     "clean": "npx rimraf ./dist",
-    "lint": "bun biome lint .",
-    "lint:fix": "bun biome lint --fix --unsafe .",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
     "release": "pnpm publish --no-git-check",
     "release:canary": "bash ../../.github/canary.sh && node ../../scripts/build.js canary && pnpm publish --no-git-check",
     "start": "tsdown --watch",

package/src/commands/agent/start.ts

@@ -6,15 +6,31 @@ export const command = defineCommand({
   name: 'start',
   description: 'Start the Agent server',
   options: {
-    config: { type: 'string', description: 'Path to the Kubb config', short: 'c' },
-    port: { type: 'string', description: `Port for the server (default: ${agentDefaults.port})`, short: 'p' },
-    host: { type: 'string', description: 'Host for the server', default: agentDefaults.host },
+    config: {
+      type: 'string',
+      description: 'Path to the Kubb config',
+      short: 'c',
+    },
+    port: {
+      type: 'string',
+      description: `Port for the server (default: ${agentDefaults.port})`,
+      short: 'p',
+    },
+    host: {
+      type: 'string',
+      description: 'Host for the server',
+      default: agentDefaults.host,
+    },
     'allow-write': {
       type: 'boolean',
       description: 'Allow writing generated files to the filesystem. When not set, no files are written and the config patch is not persisted.',
       default: false,
     },
-    'allow-all': { type: 'boolean', description: 'Grant all permissions (implies --allow-write).', default: false },
+    'allow-all': {
+      type: 'boolean',
+      description: 'Grant all permissions (implies --allow-write).',
+      default: false,
+    },
   },
   async run({ values }) {
     const { runAgentStart } = await import('../../runners/agent.ts')

package/src/commands/generate.ts

@@ -5,7 +5,11 @@ export const command = defineCommand({
   description: "[input] Generate files based on a 'kubb.config.ts' file",
   arguments: ['[input]'],
   options: {
-    config: { type: 'string', description: 'Path to the Kubb config', short: 'c' },
+    config: {
+      type: 'string',
+      description: 'Path to the Kubb config',
+      short: 'c',
+    },
     logLevel: {
       type: 'string',
       description: 'Info, silent, verbose or debug',
@@ -14,15 +18,40 @@ export const command = defineCommand({
       hint: 'silent|info|verbose|debug',
       enum: ['silent', 'info', 'verbose', 'debug'],
     },
-    watch: { type: 'boolean', description: 'Watch mode based on the input file', short: 'w', default: false },
-    debug: { type: 'boolean', description: 'Override logLevel to debug', short: 'd', 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 },
+    watch: {
+      type: 'boolean',
+      description: 'Watch mode based on the input file',
+      short: 'w',
+      default: false,
+    },
+    debug: {
+      type: 'boolean',
+      description: 'Override logLevel to debug',
+      short: 'd',
+      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,
+    },
   },
   async run({ values, positionals }) {
     const logLevel = values.debug ? 'debug' : values.verbose ? 'verbose' : values.silent ? 'silent' : values.logLevel
     const { runGenerateCommand } = await import('../runners/generate.ts')
 
-    await runGenerateCommand({ input: positionals[0], configPath: values.config, logLevel, watch: values.watch })
+    await runGenerateCommand({
+      input: positionals[0],
+      configPath: values.config,
+      logLevel,
+      watch: values.watch,
+    })
   },
 })

package/src/commands/init.ts

@@ -5,7 +5,12 @@ export const command = defineCommand({
   name: 'init',
   description: 'Initialize a new Kubb project with interactive setup',
   options: {
-    yes: { type: 'boolean', description: 'Skip prompts and use default options', short: 'y', default: false },
+    yes: {
+      type: 'boolean',
+      description: 'Skip prompts and use default options',
+      short: 'y',
+      default: false,
+    },
   },
   async run({ values }) {
     const { runInit } = await import('../runners/init.ts')

package/src/commands/validate.ts

@@ -5,7 +5,12 @@ export 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 },
+    input: {
+      type: 'string',
+      description: 'Path to Swagger/OpenAPI file',
+      short: 'i',
+      required: true,
+    },
   },
   async run({ values }) {
     const { runValidate } = await import('../runners/validate.ts')

package/src/constants.ts

@@ -1,37 +1,64 @@
-/** NPM registry endpoint used to check for @kubb/cli updates. */
+/**
+ * Default filename for the Kubb configuration file.
+ *
+ * Used by the `init` command when scaffolding new projects and by the `agent` default config.
+ */
+export const KUBB_CONFIG_FILENAME = 'kubb.config.ts' as const
+
+/**
+ * NPM registry endpoint used to check for @kubb/cli updates.
+ */
 export const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const
 
-/** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */
+/**
+ * OpenTelemetry ingestion endpoint for anonymous usage telemetry.
+ */
 export const OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const
 
-/** Horizontal rule rendered above/below the plain-logger generation summary. */
+/**
+ * Horizontal rule rendered above/below the plain-logger generation summary.
+ */
 export const SUMMARY_SEPARATOR = '─'.repeat(27)
 
-/** Maximum number of █ characters in a plugin timing bar. */
+/**
+ * Maximum number of █ characters in a plugin timing bar.
+ */
 export const SUMMARY_MAX_BAR_LENGTH = 10 as const
 
-/** Divides elapsed milliseconds into bar-length units (1 block per 100 ms). */
+/**
+ * Divides elapsed milliseconds into bar-length units (1 block per 100 ms).
+ */
 export const SUMMARY_TIME_SCALE_DIVISOR = 100 as const
 
-/** Glob pattern for paths the file watcher ignores. */
+/**
+ * Glob pattern for paths the file watcher ignores.
+ */
 export const WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const
 
-/** Default runtime values for the `agent start` command. */
+/**
+ * Flags that short-circuit execution (help/version) — no telemetry notice is shown.
+ */
+export const QUIET_FLAGS = new Set(['--help', '-h', '--version', '-v'] as const)
+
 export const agentDefaults = {
   port: '3000',
   host: 'localhost',
-  configFile: 'kubb.config.ts',
+  configFile: KUBB_CONFIG_FILENAME,
   retryTimeout: '30000',
   studioUrl: 'https://studio.kubb.dev',
-  /** Relative path from the @kubb/agent package root to the server entry. */
+  /**
+   * Relative path from the @kubb/agent package root to the server entry.
+   */
   serverEntryPath: '.output/server/index.mjs',
 } as const
 
-/** Default values used during interactive `init` scaffolding. */
+/**
+ * Default values used during interactive `init` scaffolding.
+ */
 export const initDefaults = {
   inputPath: './openapi.yaml',
   outputPath: './src/gen',
-  plugins: ['plugin-oas', 'plugin-ts'],
+  plugins: ['plugin-ts'],
 } as const
 
 /**
@@ -40,7 +67,6 @@ export const initDefaults = {
  * `as const` keeps the object deeply immutable.
  */
 export const pluginDefaultConfigs = {
-  'plugin-oas': 'pluginOas()',
   'plugin-ts': `pluginTs({
       output: { path: 'models' },
     })`,
@@ -50,18 +76,9 @@ export const pluginDefaultConfigs = {
   'plugin-react-query': `pluginReactQuery({
       output: { path: 'hooks' },
     })`,
-  'plugin-solid-query': `pluginSolidQuery({
-      output: { path: 'hooks' },
-    })`,
-  'plugin-svelte-query': `pluginSvelteQuery({
-      output: { path: 'hooks' },
-    })`,
   'plugin-vue-query': `pluginVueQuery({
       output: { path: 'hooks' },
     })`,
-  'plugin-swr': `pluginSwr({
-      output: { path: 'hooks' },
-    })`,
   'plugin-zod': `pluginZod({
       output: { path: 'zod' },
     })`,
@@ -71,6 +88,17 @@ export const pluginDefaultConfigs = {
   'plugin-msw': `pluginMsw({
       output: { path: 'msw' },
     })`,
+  'plugin-cypress': `pluginCypress({
+      output: { path: 'cypress' },
+    })`,
+  'plugin-mcp': `pluginMcp({
+      output: { path: 'mcp' },
+    })`,
+  'plugin-redoc': `pluginRedoc({
+      output: { path: 'redoc' },
+    })`,
 } as const satisfies Record<string, string>
 
-/** Color palette used by randomCliColor() for deterministic plugin name coloring. */
+/**
+ * Color palette used by randomCliColor() for deterministic plugin name coloring.
+ */