@kubb/cli 5.10.1 → 5.10.3

package/dist/{Telemetry-BfdvvZus.cjs → Telemetry-BV4GonCV.cjs}

@@ -107,7 +107,7 @@ function formatMs(ms) {
 }
 //#endregion
 //#region package.json
-var version = "5.10.1";
+var version = "5.10.3";
 //#endregion
 //#region src/Telemetry.ts
 /** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */
@@ -319,4 +319,4 @@ Object.defineProperty(exports, "version", {
 	}
 });
 
-//# sourceMappingURL=Telemetry-BfdvvZus.cjs.map
+//# sourceMappingURL=Telemetry-BV4GonCV.cjs.map

package/dist/Telemetry-BV4GonCV.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Telemetry-BV4GonCV.cjs","names":["process","process","randomBytes","getAgentProfile","os"],"sources":["../../../internals/utils/src/errors.ts","../../../internals/utils/src/isCIEnvironment.ts","../../../internals/utils/src/runtime.ts","../../../internals/utils/src/time.ts","../package.json","../src/Telemetry.ts"],"sourcesContent":["/**\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 Error('Build failed', { cause: toError(err) })\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 * Returns `error` followed by every error in its `cause` chain, outermost first. Stops at a\n * non-`Error` cause or a cycle.\n *\n * @example\n * ```ts\n * getErrorChain(new Error('Config failed loading', { cause: new Error('boom') })).map((error) => error.message)\n * // ['Config failed loading', 'boom']\n * ```\n */\nexport function getErrorChain(error: unknown): Array<Error> {\n  const chain: Array<Error> = []\n  for (let current = error; current instanceof Error && !chain.includes(current); current = current.cause) {\n    chain.push(current)\n  }\n  return chain\n}\n","import process from 'node:process'\n\n/**\n * Returns `true` when a known CI provider has set its environment variable.\n * `CI=false` and `CI=0` count as not CI, so a user can opt out locally.\n */\nexport function isCIEnvironment(): boolean {\n  const ci = process.env.CI\n  return !!(\n    (ci && ci !== 'false' && ci !== '0') ||\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","// Bun polyfills `process.versions.node`, so detection keys off the globals instead.\nconst isBun = typeof Bun !== 'undefined'\nconst isDeno = 'Deno' in globalThis\n\n/**\n * The JavaScript runtime executing the current process: its name, version and whether it is Bun.\n *\n * @example\n * ```ts\n * runtime.name // 'bun' when run with `bun kubb`, 'node' otherwise\n * ```\n */\nexport const runtime = { isBun, ...detect() } as const\n\nfunction detect(): { name: 'bun' | 'deno' | 'node'; version: string } {\n  if (isBun) return { name: 'bun', version: process.versions.bun ?? '' }\n  if (isDeno) return { name: 'deno', version: (globalThis as { Deno?: { version?: { deno?: string } } }).Deno?.version?.deno ?? '' }\n  return { name: 'node', version: process.versions?.node ?? '' }\n}\n","/**\n * Calculates elapsed time in milliseconds from a high-resolution `process.hrtime` start time.\n * Rounds to 2 decimal places for sub-millisecond precision without noise.\n *\n * @example\n * ```ts\n * const start = process.hrtime()\n * doWork()\n * getElapsedMs(start) // 42.35\n * ```\n */\nexport function getElapsedMs(hrStart: [number, number]): number {\n  const [seconds, nanoseconds] = process.hrtime(hrStart)\n  const ms = seconds * 1000 + nanoseconds / 1e6\n  return Math.round(ms * 100) / 100\n}\n\n/**\n * Converts a millisecond duration into a human-readable string (`ms`, `s`, or `m s`).\n *\n * @example\n * ```ts\n * formatMs(250)   // '250ms'\n * formatMs(1500)  // '1.50s'\n * formatMs(90000) // '1m 30.0s'\n * ```\n */\nexport function formatMs(ms: number): string {\n  if (ms >= 60000) {\n    const mins = Math.floor(ms / 60000)\n    const secs = ((ms % 60000) / 1000).toFixed(1)\n    return `${mins}m ${secs}s`\n  }\n\n  if (ms >= 1000) {\n    return `${(ms / 1000).toFixed(2)}s`\n  }\n  return `${Math.round(ms)}ms`\n}\n","","import { randomBytes } from 'node:crypto'\nimport os from 'node:os'\nimport process from 'node:process'\nimport { getElapsedMs, isCIEnvironment, runtime } from '@internals/utils'\nimport { getAgentProfile } from 'gunshi/agent'\nimport { version } from '../package.json'\n\n/** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */\nconst OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const\n\ntype TelemetryCommand = 'generate' | 'mcp' | 'studio' | 'validate'\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 snapshot of the plugin options. Values are included but cannot be traced back to a user.\n   */\n  options: Record<string, unknown>\n}\n\n/** How a command run ended, as the command reports it to the function {@link trackRun} returned. */\ntype RunResult = {\n  status: 'success' | 'failed'\n  plugins?: Array<TelemetryPlugin>\n  filesCreated?: number\n  /**\n   * Name the MCP client sends in its `initialize` request, e.g. `'claude-code'`. Only set for `kubb mcp`.\n   */\n  mcpClient?: string\n}\n\n/**\n * Returns `true` when telemetry is disabled via `DO_NOT_TRACK` or `KUBB_DISABLE_TELEMETRY`.\n */\nexport function isDisabled(): boolean {\n  return ['DO_NOT_TRACK', 'KUBB_DISABLE_TELEMETRY'].some((name) => ['1', 'true'].includes(process.env[name] ?? ''))\n}\n\n/** Tracks one command run for the running CLI version; returns the reporter the command calls once it knows how it ended. */\nexport function trackRun({ command, hrStart }: { command: TelemetryCommand; hrStart: [number, number] }): (result: RunResult) => Promise<void> {\n  return (result) => sendTelemetry(buildOtlpPayload({ command, duration: Math.round(getElapsedMs(hrStart)), ...result }))\n}\n\n/**\n * The OTLP trace payload for one run: a span named after the command whose attributes are the\n * anonymous run facts. The attribute keys are the contract with otlp.kubb.dev.\n *\n * @see https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/\n */\nexport function buildOtlpPayload({\n  command,\n  duration,\n  status,\n  plugins = [],\n  filesCreated = 0,\n  mcpClient,\n}: RunResult & { command: TelemetryCommand; duration: number }) {\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(duration) * 1_000_000n\n  const pluginNames = [...new Set(plugins.map((plugin) => plugin.name))].sort()\n  const agent = getAgentProfile()\n\n  const attributes = [\n    { key: 'kubb.command', value: { stringValue: command } },\n    { key: 'kubb.version', value: { stringValue: version } },\n    { key: 'kubb.node_version', value: { stringValue: process.versions.node.split('.')[0] as string } },\n    { key: 'kubb.runtime', value: { stringValue: runtime.name } },\n    { key: 'kubb.runtime_version', value: { stringValue: runtime.version.split('.')[0] as string } },\n    { key: 'kubb.platform', value: { stringValue: os.platform() } },\n    { key: 'kubb.ci', value: { boolValue: isCIEnvironment() } },\n    // A terminal on stdin means a person typed the command; agents, scripts, and CI pipe it.\n    { key: 'kubb.tty', value: { boolValue: process.stdin.isTTY === true } },\n    ...(agent.isAgent && agent.name ? [{ key: 'kubb.agent', value: { stringValue: agent.name } }] : []),\n    // The client picks this name, so cap its length before it leaves the machine.\n    ...(mcpClient ? [{ key: 'kubb.mcp_client', value: { stringValue: mcpClient.slice(0, 64) } }] : []),\n    { key: 'kubb.files_created', value: { intValue: filesCreated } },\n    { key: 'kubb.status', value: { stringValue: status } },\n    {\n      key: 'kubb.plugins',\n      value: { arrayValue: { values: pluginNames.map((name) => ({ stringValue: name })) } },\n    },\n    ...pluginNames.map((name) => ({ key: `kubb.plugin.${name}`, value: { boolValue: true } })),\n    {\n      key: 'kubb.plugin_options',\n      value: {\n        arrayValue: {\n          values: plugins.map((p) => ({\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  return {\n    resourceSpans: [\n      {\n        resource: {\n          attributes: [\n            { key: 'service.name', value: { stringValue: 'kubb' } },\n            { key: 'service.version', value: { stringValue: version } },\n            { key: 'telemetry.sdk.language', value: { stringValue: 'nodejs' } },\n          ],\n        },\n        scopeSpans: [\n          {\n            scope: { name: 'kubb-core', version },\n            spans: [\n              {\n                traceId,\n                spanId,\n                name: command,\n                kind: 1,\n                startTimeUnixNano: String(startTimeNs),\n                endTimeUnixNano: String(endTimeNs),\n                attributes,\n                status: {\n                  code: status === 'success' ? 1 : 2,\n                },\n              },\n            ],\n          },\n        ],\n      },\n    ],\n  }\n}\n\n/**\n * Send an OTLP payload to the Kubb endpoint. Respects `DO_NOT_TRACK` and\n * `KUBB_DISABLE_TELEMETRY`, and fails silently so telemetry never interrupts a run. No file\n * paths, OpenAPI specs, or secrets are sent.\n */\nexport async function sendTelemetry(payload: ReturnType<typeof buildOtlpPayload>): Promise<void> {\n  if (isDisabled()) {\n    return\n  }\n\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(payload),\n      signal: AbortSignal.timeout(5_000),\n    })\n  } catch (_e) {\n    // Fail silently, telemetry must never break the run\n  }\n}\n"],"mappings":"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"}

package/dist/Telemetry-CH2kkxWK.cjs

@@ -0,0 +1,322 @@
+const require_rolldown_runtime = require("./rolldown-runtime-C0BPl7ul.cjs");
+let node_crypto = require("node:crypto");
+let node_os = require("node:os");
+node_os = require_rolldown_runtime.__toESM(node_os, 1);
+let node_process = require("node:process");
+node_process = require_rolldown_runtime.__toESM(node_process, 1);
+let gunshi_agent = require("gunshi/agent");
+//#region ../../internals/utils/src/errors.ts
+/**
+* Coerces an unknown thrown value to an `Error` instance.
+* Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.
+*
+* @example
+* ```ts
+* try { ... } catch(err) {
+*   throw new Error('Build failed', { cause: toError(err) })
+* }
+* ```
+*/
+function toError(value) {
+	return value instanceof Error ? value : new Error(String(value));
+}
+/**
+* Extracts a human-readable message from any thrown value.
+*
+* @example
+* ```ts
+* getErrorMessage(new Error('oops')) // 'oops'
+* getErrorMessage('plain string')    // 'plain string'
+* ```
+*/
+function getErrorMessage(value) {
+	return value instanceof Error ? value.message : String(value);
+}
+//#endregion
+//#region ../../internals/utils/src/isCIEnvironment.ts
+/**
+* Returns `true` when a known CI provider has set its environment variable.
+* `CI=false` and `CI=0` count as not CI, so a user can opt out locally.
+*/
+function isCIEnvironment() {
+	const ci = node_process.default.env.CI;
+	return !!(ci && ci !== "false" && ci !== "0" || 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);
+}
+//#endregion
+//#region ../../internals/utils/src/runtime.ts
+const isBun = typeof Bun !== "undefined";
+const isDeno = "Deno" in globalThis;
+/**
+* The JavaScript runtime executing the current process: its name, version and whether it is Bun.
+*
+* @example
+* ```ts
+* runtime.name // 'bun' when run with `bun kubb`, 'node' otherwise
+* ```
+*/
+const runtime = {
+	isBun,
+	...detect()
+};
+function detect() {
+	if (isBun) return {
+		name: "bun",
+		version: process.versions.bun ?? ""
+	};
+	if (isDeno) return {
+		name: "deno",
+		version: globalThis.Deno?.version?.deno ?? ""
+	};
+	return {
+		name: "node",
+		version: process.versions?.node ?? ""
+	};
+}
+//#endregion
+//#region ../../internals/utils/src/time.ts
+/**
+* Calculates elapsed time in milliseconds from a high-resolution `process.hrtime` start time.
+* Rounds to 2 decimal places for sub-millisecond precision without noise.
+*
+* @example
+* ```ts
+* const start = process.hrtime()
+* doWork()
+* getElapsedMs(start) // 42.35
+* ```
+*/
+function getElapsedMs(hrStart) {
+	const [seconds, nanoseconds] = process.hrtime(hrStart);
+	const ms = seconds * 1e3 + nanoseconds / 1e6;
+	return Math.round(ms * 100) / 100;
+}
+/**
+* Converts a millisecond duration into a human-readable string (`ms`, `s`, or `m s`).
+*
+* @example
+* ```ts
+* formatMs(250)   // '250ms'
+* formatMs(1500)  // '1.50s'
+* formatMs(90000) // '1m 30.0s'
+* ```
+*/
+function formatMs(ms) {
+	if (ms >= 6e4) return `${Math.floor(ms / 6e4)}m ${(ms % 6e4 / 1e3).toFixed(1)}s`;
+	if (ms >= 1e3) return `${(ms / 1e3).toFixed(2)}s`;
+	return `${Math.round(ms)}ms`;
+}
+//#endregion
+//#region package.json
+var version = "5.10.3";
+//#endregion
+//#region src/Telemetry.ts
+/** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */
+const OTLP_ENDPOINT = "https://otlp.kubb.dev";
+/**
+* Returns `true` when telemetry is disabled via `DO_NOT_TRACK` or `KUBB_DISABLE_TELEMETRY`.
+*/
+function isDisabled() {
+	return ["DO_NOT_TRACK", "KUBB_DISABLE_TELEMETRY"].some((name) => ["1", "true"].includes(node_process.default.env[name] ?? ""));
+}
+/** Tracks one command run for the running CLI version; returns the reporter the command calls once it knows how it ended. */
+function trackRun({ command, hrStart }) {
+	return (result) => sendTelemetry(buildOtlpPayload({
+		command,
+		duration: Math.round(getElapsedMs(hrStart)),
+		...result
+	}));
+}
+/**
+* The OTLP trace payload for one run: a span named after the command whose attributes are the
+* anonymous run facts. The attribute keys are the contract with otlp.kubb.dev.
+*
+* @see https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/
+*/
+function buildOtlpPayload({ command, duration, status, plugins = [], filesCreated = 0, mcpClient }) {
+	const traceId = (0, node_crypto.randomBytes)(16).toString("hex");
+	const spanId = (0, node_crypto.randomBytes)(8).toString("hex");
+	const endTimeNs = BigInt(Date.now()) * 1000000n;
+	const startTimeNs = endTimeNs - BigInt(duration) * 1000000n;
+	const pluginNames = [...new Set(plugins.map((plugin) => plugin.name))].sort();
+	const agent = (0, gunshi_agent.getAgentProfile)();
+	const attributes = [
+		{
+			key: "kubb.command",
+			value: { stringValue: command }
+		},
+		{
+			key: "kubb.version",
+			value: { stringValue: version }
+		},
+		{
+			key: "kubb.node_version",
+			value: { stringValue: node_process.default.versions.node.split(".")[0] }
+		},
+		{
+			key: "kubb.runtime",
+			value: { stringValue: runtime.name }
+		},
+		{
+			key: "kubb.runtime_version",
+			value: { stringValue: runtime.version.split(".")[0] }
+		},
+		{
+			key: "kubb.platform",
+			value: { stringValue: node_os.default.platform() }
+		},
+		{
+			key: "kubb.ci",
+			value: { boolValue: isCIEnvironment() }
+		},
+		{
+			key: "kubb.tty",
+			value: { boolValue: node_process.default.stdin.isTTY === true }
+		},
+		...agent.isAgent && agent.name ? [{
+			key: "kubb.agent",
+			value: { stringValue: agent.name }
+		}] : [],
+		...mcpClient ? [{
+			key: "kubb.mcp_client",
+			value: { stringValue: mcpClient.slice(0, 64) }
+		}] : [],
+		{
+			key: "kubb.files_created",
+			value: { intValue: filesCreated }
+		},
+		{
+			key: "kubb.status",
+			value: { stringValue: status }
+		},
+		{
+			key: "kubb.plugins",
+			value: { arrayValue: { values: pluginNames.map((name) => ({ stringValue: name })) } }
+		},
+		...pluginNames.map((name) => ({
+			key: `kubb.plugin.${name}`,
+			value: { boolValue: true }
+		})),
+		{
+			key: "kubb.plugin_options",
+			value: { arrayValue: { values: 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" }
+			},
+			{
+				key: "service.version",
+				value: { stringValue: version }
+			},
+			{
+				key: "telemetry.sdk.language",
+				value: { stringValue: "nodejs" }
+			}
+		] },
+		scopeSpans: [{
+			scope: {
+				name: "kubb-core",
+				version
+			},
+			spans: [{
+				traceId,
+				spanId,
+				name: command,
+				kind: 1,
+				startTimeUnixNano: String(startTimeNs),
+				endTimeUnixNano: String(endTimeNs),
+				attributes,
+				status: { code: status === "success" ? 1 : 2 }
+			}]
+		}]
+	}] };
+}
+/**
+* Send an OTLP payload to the Kubb endpoint. Respects `DO_NOT_TRACK` and
+* `KUBB_DISABLE_TELEMETRY`, and fails silently so telemetry never interrupts a run. No file
+* paths, OpenAPI specs, or secrets are sent.
+*/
+async function sendTelemetry(payload) {
+	if (isDisabled()) return;
+	try {
+		await fetch(`${OTLP_ENDPOINT}/v1/traces`, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				"Kubb-Telemetry-Version": "1",
+				"Kubb-Telemetry-Source": "kubb-cli"
+			},
+			body: JSON.stringify(payload),
+			signal: AbortSignal.timeout(5e3)
+		});
+	} catch (_e) {}
+}
+//#endregion
+Object.defineProperty(exports, "formatMs", {
+	enumerable: true,
+	get: function() {
+		return formatMs;
+	}
+});
+Object.defineProperty(exports, "getElapsedMs", {
+	enumerable: true,
+	get: function() {
+		return getElapsedMs;
+	}
+});
+Object.defineProperty(exports, "getErrorMessage", {
+	enumerable: true,
+	get: function() {
+		return getErrorMessage;
+	}
+});
+Object.defineProperty(exports, "isCIEnvironment", {
+	enumerable: true,
+	get: function() {
+		return isCIEnvironment;
+	}
+});
+Object.defineProperty(exports, "isDisabled", {
+	enumerable: true,
+	get: function() {
+		return isDisabled;
+	}
+});
+Object.defineProperty(exports, "runtime", {
+	enumerable: true,
+	get: function() {
+		return runtime;
+	}
+});
+Object.defineProperty(exports, "toError", {
+	enumerable: true,
+	get: function() {
+		return toError;
+	}
+});
+Object.defineProperty(exports, "trackRun", {
+	enumerable: true,
+	get: function() {
+		return trackRun;
+	}
+});
+Object.defineProperty(exports, "version", {
+	enumerable: true,
+	get: function() {
+		return version;
+	}
+});
+
+//# sourceMappingURL=Telemetry-CH2kkxWK.cjs.map

package/dist/Telemetry-CH2kkxWK.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Telemetry-CH2kkxWK.cjs","names":["process","process","randomBytes","getAgentProfile","os"],"sources":["../../../internals/utils/src/errors.ts","../../../internals/utils/src/isCIEnvironment.ts","../../../internals/utils/src/runtime.ts","../../../internals/utils/src/time.ts","../package.json","../src/Telemetry.ts"],"sourcesContent":["/**\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 Error('Build failed', { cause: toError(err) })\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 * Returns `error` followed by every error in its `cause` chain, outermost first. Stops at a\n * non-`Error` cause or a cycle.\n *\n * @example\n * ```ts\n * getErrorChain(new Error('Config failed loading', { cause: new Error('boom') })).map((error) => error.message)\n * // ['Config failed loading', 'boom']\n * ```\n */\nexport function getErrorChain(error: unknown): Array<Error> {\n  const chain: Array<Error> = []\n  for (let current = error; current instanceof Error && !chain.includes(current); current = current.cause) {\n    chain.push(current)\n  }\n  return chain\n}\n","import process from 'node:process'\n\n/**\n * Returns `true` when a known CI provider has set its environment variable.\n * `CI=false` and `CI=0` count as not CI, so a user can opt out locally.\n */\nexport function isCIEnvironment(): boolean {\n  const ci = process.env.CI\n  return !!(\n    (ci && ci !== 'false' && ci !== '0') ||\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","// Bun polyfills `process.versions.node`, so detection keys off the globals instead.\nconst isBun = typeof Bun !== 'undefined'\nconst isDeno = 'Deno' in globalThis\n\n/**\n * The JavaScript runtime executing the current process: its name, version and whether it is Bun.\n *\n * @example\n * ```ts\n * runtime.name // 'bun' when run with `bun kubb`, 'node' otherwise\n * ```\n */\nexport const runtime = { isBun, ...detect() } as const\n\nfunction detect(): { name: 'bun' | 'deno' | 'node'; version: string } {\n  if (isBun) return { name: 'bun', version: process.versions.bun ?? '' }\n  if (isDeno) return { name: 'deno', version: (globalThis as { Deno?: { version?: { deno?: string } } }).Deno?.version?.deno ?? '' }\n  return { name: 'node', version: process.versions?.node ?? '' }\n}\n","/**\n * Calculates elapsed time in milliseconds from a high-resolution `process.hrtime` start time.\n * Rounds to 2 decimal places for sub-millisecond precision without noise.\n *\n * @example\n * ```ts\n * const start = process.hrtime()\n * doWork()\n * getElapsedMs(start) // 42.35\n * ```\n */\nexport function getElapsedMs(hrStart: [number, number]): number {\n  const [seconds, nanoseconds] = process.hrtime(hrStart)\n  const ms = seconds * 1000 + nanoseconds / 1e6\n  return Math.round(ms * 100) / 100\n}\n\n/**\n * Converts a millisecond duration into a human-readable string (`ms`, `s`, or `m s`).\n *\n * @example\n * ```ts\n * formatMs(250)   // '250ms'\n * formatMs(1500)  // '1.50s'\n * formatMs(90000) // '1m 30.0s'\n * ```\n */\nexport function formatMs(ms: number): string {\n  if (ms >= 60000) {\n    const mins = Math.floor(ms / 60000)\n    const secs = ((ms % 60000) / 1000).toFixed(1)\n    return `${mins}m ${secs}s`\n  }\n\n  if (ms >= 1000) {\n    return `${(ms / 1000).toFixed(2)}s`\n  }\n  return `${Math.round(ms)}ms`\n}\n","","import { randomBytes } from 'node:crypto'\nimport os from 'node:os'\nimport process from 'node:process'\nimport { getElapsedMs, isCIEnvironment, runtime } from '@internals/utils'\nimport { getAgentProfile } from 'gunshi/agent'\nimport { version } from '../package.json'\n\n/** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */\nconst OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const\n\ntype TelemetryCommand = 'generate' | 'mcp' | 'studio' | 'validate'\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 snapshot of the plugin options. Values are included but cannot be traced back to a user.\n   */\n  options: Record<string, unknown>\n}\n\n/** How a command run ended, as the command reports it to the function {@link trackRun} returned. */\ntype RunResult = {\n  status: 'success' | 'failed'\n  plugins?: Array<TelemetryPlugin>\n  filesCreated?: number\n  /**\n   * Name the MCP client sends in its `initialize` request, e.g. `'claude-code'`. Only set for `kubb mcp`.\n   */\n  mcpClient?: string\n}\n\n/**\n * Returns `true` when telemetry is disabled via `DO_NOT_TRACK` or `KUBB_DISABLE_TELEMETRY`.\n */\nexport function isDisabled(): boolean {\n  return ['DO_NOT_TRACK', 'KUBB_DISABLE_TELEMETRY'].some((name) => ['1', 'true'].includes(process.env[name] ?? ''))\n}\n\n/** Tracks one command run for the running CLI version; returns the reporter the command calls once it knows how it ended. */\nexport function trackRun({ command, hrStart }: { command: TelemetryCommand; hrStart: [number, number] }): (result: RunResult) => Promise<void> {\n  return (result) => sendTelemetry(buildOtlpPayload({ command, duration: Math.round(getElapsedMs(hrStart)), ...result }))\n}\n\n/**\n * The OTLP trace payload for one run: a span named after the command whose attributes are the\n * anonymous run facts. The attribute keys are the contract with otlp.kubb.dev.\n *\n * @see https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/\n */\nexport function buildOtlpPayload({\n  command,\n  duration,\n  status,\n  plugins = [],\n  filesCreated = 0,\n  mcpClient,\n}: RunResult & { command: TelemetryCommand; duration: number }) {\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(duration) * 1_000_000n\n  const pluginNames = [...new Set(plugins.map((plugin) => plugin.name))].sort()\n  const agent = getAgentProfile()\n\n  const attributes = [\n    { key: 'kubb.command', value: { stringValue: command } },\n    { key: 'kubb.version', value: { stringValue: version } },\n    { key: 'kubb.node_version', value: { stringValue: process.versions.node.split('.')[0] as string } },\n    { key: 'kubb.runtime', value: { stringValue: runtime.name } },\n    { key: 'kubb.runtime_version', value: { stringValue: runtime.version.split('.')[0] as string } },\n    { key: 'kubb.platform', value: { stringValue: os.platform() } },\n    { key: 'kubb.ci', value: { boolValue: isCIEnvironment() } },\n    // A terminal on stdin means a person typed the command; agents, scripts, and CI pipe it.\n    { key: 'kubb.tty', value: { boolValue: process.stdin.isTTY === true } },\n    ...(agent.isAgent && agent.name ? [{ key: 'kubb.agent', value: { stringValue: agent.name } }] : []),\n    // The client picks this name, so cap its length before it leaves the machine.\n    ...(mcpClient ? [{ key: 'kubb.mcp_client', value: { stringValue: mcpClient.slice(0, 64) } }] : []),\n    { key: 'kubb.files_created', value: { intValue: filesCreated } },\n    { key: 'kubb.status', value: { stringValue: status } },\n    {\n      key: 'kubb.plugins',\n      value: { arrayValue: { values: pluginNames.map((name) => ({ stringValue: name })) } },\n    },\n    ...pluginNames.map((name) => ({ key: `kubb.plugin.${name}`, value: { boolValue: true } })),\n    {\n      key: 'kubb.plugin_options',\n      value: {\n        arrayValue: {\n          values: plugins.map((p) => ({\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  return {\n    resourceSpans: [\n      {\n        resource: {\n          attributes: [\n            { key: 'service.name', value: { stringValue: 'kubb' } },\n            { key: 'service.version', value: { stringValue: version } },\n            { key: 'telemetry.sdk.language', value: { stringValue: 'nodejs' } },\n          ],\n        },\n        scopeSpans: [\n          {\n            scope: { name: 'kubb-core', version },\n            spans: [\n              {\n                traceId,\n                spanId,\n                name: command,\n                kind: 1,\n                startTimeUnixNano: String(startTimeNs),\n                endTimeUnixNano: String(endTimeNs),\n                attributes,\n                status: {\n                  code: status === 'success' ? 1 : 2,\n                },\n              },\n            ],\n          },\n        ],\n      },\n    ],\n  }\n}\n\n/**\n * Send an OTLP payload to the Kubb endpoint. Respects `DO_NOT_TRACK` and\n * `KUBB_DISABLE_TELEMETRY`, and fails silently so telemetry never interrupts a run. No file\n * paths, OpenAPI specs, or secrets are sent.\n */\nexport async function sendTelemetry(payload: ReturnType<typeof buildOtlpPayload>): Promise<void> {\n  if (isDisabled()) {\n    return\n  }\n\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(payload),\n      signal: AbortSignal.timeout(5_000),\n    })\n  } catch (_e) {\n    // Fail silently, telemetry must never break the run\n  }\n}\n"],"mappings":"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"}

package/dist/{Telemetry-Bf6lUdai.js → Telemetry-Cz9QCzRo.js}

@@ -105,7 +105,7 @@ function formatMs(ms) {
 }
 //#endregion
 //#region package.json
-var version = "5.10.1";
+var version = "5.10.3";
 //#endregion
 //#region src/Telemetry.ts
 /** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */
@@ -264,4 +264,4 @@ async function sendTelemetry(payload) {
 //#endregion
 export { getElapsedMs as a, getErrorMessage as c, formatMs as i, toError as l, trackRun as n, runtime as o, version as r, isCIEnvironment as s, isDisabled as t };
 
-//# sourceMappingURL=Telemetry-Bf6lUdai.js.map
+//# sourceMappingURL=Telemetry-Cz9QCzRo.js.map

package/dist/Telemetry-Cz9QCzRo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Telemetry-Cz9QCzRo.js","names":["process","process"],"sources":["../../../internals/utils/src/errors.ts","../../../internals/utils/src/isCIEnvironment.ts","../../../internals/utils/src/runtime.ts","../../../internals/utils/src/time.ts","../package.json","../src/Telemetry.ts"],"sourcesContent":["/**\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 Error('Build failed', { cause: toError(err) })\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 * Returns `error` followed by every error in its `cause` chain, outermost first. Stops at a\n * non-`Error` cause or a cycle.\n *\n * @example\n * ```ts\n * getErrorChain(new Error('Config failed loading', { cause: new Error('boom') })).map((error) => error.message)\n * // ['Config failed loading', 'boom']\n * ```\n */\nexport function getErrorChain(error: unknown): Array<Error> {\n  const chain: Array<Error> = []\n  for (let current = error; current instanceof Error && !chain.includes(current); current = current.cause) {\n    chain.push(current)\n  }\n  return chain\n}\n","import process from 'node:process'\n\n/**\n * Returns `true` when a known CI provider has set its environment variable.\n * `CI=false` and `CI=0` count as not CI, so a user can opt out locally.\n */\nexport function isCIEnvironment(): boolean {\n  const ci = process.env.CI\n  return !!(\n    (ci && ci !== 'false' && ci !== '0') ||\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","// Bun polyfills `process.versions.node`, so detection keys off the globals instead.\nconst isBun = typeof Bun !== 'undefined'\nconst isDeno = 'Deno' in globalThis\n\n/**\n * The JavaScript runtime executing the current process: its name, version and whether it is Bun.\n *\n * @example\n * ```ts\n * runtime.name // 'bun' when run with `bun kubb`, 'node' otherwise\n * ```\n */\nexport const runtime = { isBun, ...detect() } as const\n\nfunction detect(): { name: 'bun' | 'deno' | 'node'; version: string } {\n  if (isBun) return { name: 'bun', version: process.versions.bun ?? '' }\n  if (isDeno) return { name: 'deno', version: (globalThis as { Deno?: { version?: { deno?: string } } }).Deno?.version?.deno ?? '' }\n  return { name: 'node', version: process.versions?.node ?? '' }\n}\n","/**\n * Calculates elapsed time in milliseconds from a high-resolution `process.hrtime` start time.\n * Rounds to 2 decimal places for sub-millisecond precision without noise.\n *\n * @example\n * ```ts\n * const start = process.hrtime()\n * doWork()\n * getElapsedMs(start) // 42.35\n * ```\n */\nexport function getElapsedMs(hrStart: [number, number]): number {\n  const [seconds, nanoseconds] = process.hrtime(hrStart)\n  const ms = seconds * 1000 + nanoseconds / 1e6\n  return Math.round(ms * 100) / 100\n}\n\n/**\n * Converts a millisecond duration into a human-readable string (`ms`, `s`, or `m s`).\n *\n * @example\n * ```ts\n * formatMs(250)   // '250ms'\n * formatMs(1500)  // '1.50s'\n * formatMs(90000) // '1m 30.0s'\n * ```\n */\nexport function formatMs(ms: number): string {\n  if (ms >= 60000) {\n    const mins = Math.floor(ms / 60000)\n    const secs = ((ms % 60000) / 1000).toFixed(1)\n    return `${mins}m ${secs}s`\n  }\n\n  if (ms >= 1000) {\n    return `${(ms / 1000).toFixed(2)}s`\n  }\n  return `${Math.round(ms)}ms`\n}\n","","import { randomBytes } from 'node:crypto'\nimport os from 'node:os'\nimport process from 'node:process'\nimport { getElapsedMs, isCIEnvironment, runtime } from '@internals/utils'\nimport { getAgentProfile } from 'gunshi/agent'\nimport { version } from '../package.json'\n\n/** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */\nconst OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const\n\ntype TelemetryCommand = 'generate' | 'mcp' | 'studio' | 'validate'\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 snapshot of the plugin options. Values are included but cannot be traced back to a user.\n   */\n  options: Record<string, unknown>\n}\n\n/** How a command run ended, as the command reports it to the function {@link trackRun} returned. */\ntype RunResult = {\n  status: 'success' | 'failed'\n  plugins?: Array<TelemetryPlugin>\n  filesCreated?: number\n  /**\n   * Name the MCP client sends in its `initialize` request, e.g. `'claude-code'`. Only set for `kubb mcp`.\n   */\n  mcpClient?: string\n}\n\n/**\n * Returns `true` when telemetry is disabled via `DO_NOT_TRACK` or `KUBB_DISABLE_TELEMETRY`.\n */\nexport function isDisabled(): boolean {\n  return ['DO_NOT_TRACK', 'KUBB_DISABLE_TELEMETRY'].some((name) => ['1', 'true'].includes(process.env[name] ?? ''))\n}\n\n/** Tracks one command run for the running CLI version; returns the reporter the command calls once it knows how it ended. */\nexport function trackRun({ command, hrStart }: { command: TelemetryCommand; hrStart: [number, number] }): (result: RunResult) => Promise<void> {\n  return (result) => sendTelemetry(buildOtlpPayload({ command, duration: Math.round(getElapsedMs(hrStart)), ...result }))\n}\n\n/**\n * The OTLP trace payload for one run: a span named after the command whose attributes are the\n * anonymous run facts. The attribute keys are the contract with otlp.kubb.dev.\n *\n * @see https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/\n */\nexport function buildOtlpPayload({\n  command,\n  duration,\n  status,\n  plugins = [],\n  filesCreated = 0,\n  mcpClient,\n}: RunResult & { command: TelemetryCommand; duration: number }) {\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(duration) * 1_000_000n\n  const pluginNames = [...new Set(plugins.map((plugin) => plugin.name))].sort()\n  const agent = getAgentProfile()\n\n  const attributes = [\n    { key: 'kubb.command', value: { stringValue: command } },\n    { key: 'kubb.version', value: { stringValue: version } },\n    { key: 'kubb.node_version', value: { stringValue: process.versions.node.split('.')[0] as string } },\n    { key: 'kubb.runtime', value: { stringValue: runtime.name } },\n    { key: 'kubb.runtime_version', value: { stringValue: runtime.version.split('.')[0] as string } },\n    { key: 'kubb.platform', value: { stringValue: os.platform() } },\n    { key: 'kubb.ci', value: { boolValue: isCIEnvironment() } },\n    // A terminal on stdin means a person typed the command; agents, scripts, and CI pipe it.\n    { key: 'kubb.tty', value: { boolValue: process.stdin.isTTY === true } },\n    ...(agent.isAgent && agent.name ? [{ key: 'kubb.agent', value: { stringValue: agent.name } }] : []),\n    // The client picks this name, so cap its length before it leaves the machine.\n    ...(mcpClient ? [{ key: 'kubb.mcp_client', value: { stringValue: mcpClient.slice(0, 64) } }] : []),\n    { key: 'kubb.files_created', value: { intValue: filesCreated } },\n    { key: 'kubb.status', value: { stringValue: status } },\n    {\n      key: 'kubb.plugins',\n      value: { arrayValue: { values: pluginNames.map((name) => ({ stringValue: name })) } },\n    },\n    ...pluginNames.map((name) => ({ key: `kubb.plugin.${name}`, value: { boolValue: true } })),\n    {\n      key: 'kubb.plugin_options',\n      value: {\n        arrayValue: {\n          values: plugins.map((p) => ({\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  return {\n    resourceSpans: [\n      {\n        resource: {\n          attributes: [\n            { key: 'service.name', value: { stringValue: 'kubb' } },\n            { key: 'service.version', value: { stringValue: version } },\n            { key: 'telemetry.sdk.language', value: { stringValue: 'nodejs' } },\n          ],\n        },\n        scopeSpans: [\n          {\n            scope: { name: 'kubb-core', version },\n            spans: [\n              {\n                traceId,\n                spanId,\n                name: command,\n                kind: 1,\n                startTimeUnixNano: String(startTimeNs),\n                endTimeUnixNano: String(endTimeNs),\n                attributes,\n                status: {\n                  code: status === 'success' ? 1 : 2,\n                },\n              },\n            ],\n          },\n        ],\n      },\n    ],\n  }\n}\n\n/**\n * Send an OTLP payload to the Kubb endpoint. Respects `DO_NOT_TRACK` and\n * `KUBB_DISABLE_TELEMETRY`, and fails silently so telemetry never interrupts a run. No file\n * paths, OpenAPI specs, or secrets are sent.\n */\nexport async function sendTelemetry(payload: ReturnType<typeof buildOtlpPayload>): Promise<void> {\n  if (isDisabled()) {\n    return\n  }\n\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(payload),\n      signal: AbortSignal.timeout(5_000),\n    })\n  } catch (_e) {\n    // Fail silently, telemetry must never break the run\n  }\n}\n"],"mappings":"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"}

package/dist/{background-D5K6ecEo.js → background-DFME5huR.js}

@@ -1,11 +1,12 @@
 import "./rolldown-runtime-CRm0XQPb.js";
-import { a as prepareConnection } from "./run-DTz7gAk1.js";
+import { a as prepareConnection } from "./run-CPYD1Lp0.js";
 import { i as getProjectKubbHome } from "./credentials-CZK6zPLv.js";
 import { createRequire } from "node:module";
 import { hash, randomBytes } from "node:crypto";
 import { x } from "tinyexec";
 import { readFile, rename, writeFile } from "node:fs/promises";
 import path from "node:path";
+import { Diagnostics } from "@kubb/core";
 import { connect, createServer } from "node:net";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
 //#region src/runners/studio/background.ts
@@ -57,7 +58,11 @@ function requestWorker(record, command) {
 		socket.once("end", () => {
 			try {
 				const response = JSON.parse(received);
-				if (response.id !== record.id || response.pid !== record.pid || !states.includes(response.state)) throw new Error("Worker identity changed");
+				if (response.id !== record.id || response.pid !== record.pid || !states.includes(response.state)) throw new Diagnostics.Error({
+					code: Diagnostics.code.internalError,
+					severity: "error",
+					message: "Worker identity changed"
+				});
 				resolve(response);
 			} catch (error) {
 				reject(error);
@@ -91,7 +96,12 @@ async function stopWorker() {
 	try {
 		await requestWorker(record, "stop");
 	} catch (error) {
-		if (error.code !== "ECONNREFUSED" && isAlive(record.pid) && record.state !== "stopped" && record.state !== "authentication required") throw new Error("Cannot verify the background worker. No process was signaled.");
+		if (error.code !== "ECONNREFUSED" && isAlive(record.pid) && record.state !== "stopped" && record.state !== "authentication required") throw new Diagnostics.Error({
+			code: Diagnostics.code.unknown,
+			severity: "error",
+			message: "Cannot verify the background worker. No process was signaled.",
+			help: "Check `worker.log`, then stop the process by hand if it is still running."
+		});
 		return;
 	}
 	const deadline = Date.now() + 15e3;
@@ -103,7 +113,11 @@ async function stopWorker() {
 		}
 		await setTimeout$1(100);
 	}
-	throw new Error("The worker has not finished shutting down. Check worker.log and try again.");
+	throw new Diagnostics.Error({
+		code: Diagnostics.code.unknown,
+		severity: "error",
+		message: "The worker has not finished shutting down. Check worker.log and try again."
+	});
 }
 /** The listening port is the project lock, so stale state never needs a PID-based takeover. */
 async function serveWorker(shutdown) {
@@ -150,7 +164,11 @@ async function serveWorker(shutdown) {
 		if (existing?.port === port) try {
 			return { existing: await requestWorker(existing, "status") };
 		} catch {}
-		throw new Error("The project control port is occupied or another worker is starting. Try again after stopping that listener.");
+		throw new Diagnostics.Error({
+			code: Diagnostics.code.unknown,
+			severity: "error",
+			message: "The project control port is occupied or another worker is starting. Try again after stopping that listener."
+		});
 	}
 	record.port = port;
 	let saving = Promise.resolve();
@@ -204,7 +222,12 @@ async function startWorker(options) {
 			"ipc"
 		]
 	} }).process;
-	if (!child) throw new Error("Background worker failed to start");
+	if (!child) throw new Diagnostics.Error({
+		code: Diagnostics.code.unknown,
+		severity: "error",
+		message: "Background worker failed to start",
+		help: "Run `kubb studio` in the foreground to see why it fails."
+	});
 	try {
 		await new Promise((resolve, reject) => {
 			const timer = setTimeout(() => done(/* @__PURE__ */ new Error("Background worker startup timed out")), 2e4);
@@ -247,4 +270,4 @@ async function startWorker(options) {
 //#endregion
 export { stopWorker as a, startWorker as i, getWorkerStatus as n, serveWorker as r, getWorkerLogPath as t };
 
-//# sourceMappingURL=background-D5K6ecEo.js.map
+//# sourceMappingURL=background-DFME5huR.js.map

package/dist/background-DFME5huR.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-DFME5huR.js","names":["connectSocket","delay"],"sources":["../src/runners/studio/background.ts"],"sourcesContent":["import { hash, randomBytes } from 'node:crypto'\nimport { readFile, rename, writeFile } from 'node:fs/promises'\nimport { createRequire } from 'node:module'\nimport { connect as connectSocket, createServer } from 'node:net'\nimport path from 'node:path'\nimport { setTimeout as delay } from 'node:timers/promises'\nimport { Diagnostics } from '@kubb/core'\nimport { x } from 'tinyexec'\nimport { getProjectKubbHome } from './credentials.ts'\nimport { prepareConnection, type PreparedConnection, type StudioOptions, type WorkerState } from './run.ts'\n\nexport type WorkerRecord = { id: string; pid: number; port: number; state: WorkerState }\nconst states: Array<WorkerState> = ['starting', 'connected', 'reconnecting', 'authentication required', 'stopped']\nexport const getWorkerLogPath = () => path.join(getProjectKubbHome(), 'worker.log')\nconst statePath = () => path.join(getProjectKubbHome(), 'worker.json')\n\nasync function readWorker(): Promise<WorkerRecord | null> {\n  try {\n    const value: unknown = JSON.parse(await readFile(statePath(), 'utf8'))\n    if (!value || typeof value !== 'object') return null\n    const record = value as Partial<WorkerRecord>\n    return typeof record.id === 'string' &&\n      /^[a-f0-9]{32}$/.test(record.id) &&\n      Number.isInteger(record.pid) &&\n      (record.pid ?? 0) > 1 &&\n      Number.isInteger(record.port) &&\n      (record.port ?? 0) > 0 &&\n      (record.port ?? 0) <= 65535 &&\n      states.includes(record.state as WorkerState)\n      ? (record as WorkerRecord)\n      : null\n  } catch {\n    return null\n  }\n}\n\nfunction isAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0)\n    return true\n  } catch (error) {\n    return (error as NodeJS.ErrnoException).code === 'EPERM'\n  }\n}\n\n/** Authenticated loopback IPC; a stored PID never authorizes sending a process signal. */\nfunction requestWorker(record: WorkerRecord, command: 'status' | 'stop'): Promise<WorkerRecord> {\n  return new Promise((resolve, reject) => {\n    const socket = connectSocket({ host: '127.0.0.1', port: record.port })\n    let received = ''\n    socket.setTimeout(2_000, () => socket.destroy(new Error('Worker control timed out')))\n    socket.once('error', reject)\n    socket.once('connect', () => socket.write(JSON.stringify({ id: record.id, command }) + '\\n'))\n    socket.on('data', (chunk: Buffer) => {\n      received += chunk.toString()\n      if (received.length > 4096) socket.destroy(new Error('Invalid worker response'))\n    })\n    socket.once('end', () => {\n      try {\n        const response = JSON.parse(received) as WorkerRecord\n        if (response.id !== record.id || response.pid !== record.pid || !states.includes(response.state))\n          throw new Diagnostics.Error({ code: Diagnostics.code.internalError, severity: 'error', message: 'Worker identity changed' })\n        resolve(response)\n      } catch (error) {\n        reject(error)\n      }\n    })\n  })\n}\n\nexport async function getWorkerStatus(): Promise<{ running: boolean; state: WorkerState; pid?: number }> {\n  const record = await readWorker()\n  if (!record) return { running: false, state: 'stopped' }\n  try {\n    const response = await requestWorker(record, 'status')\n    return { running: true, state: response.state, pid: response.pid }\n  } catch {\n    return { running: false, state: record.state === 'authentication required' ? record.state : 'stopped' }\n  }\n}\n\nexport async function stopWorker(): Promise<void> {\n  const record = await readWorker()\n  if (!record) return\n  try {\n    await requestWorker(record, 'stop')\n  } catch (error) {\n    if (\n      (error as NodeJS.ErrnoException).code !== 'ECONNREFUSED' &&\n      isAlive(record.pid) &&\n      record.state !== 'stopped' &&\n      record.state !== 'authentication required'\n    ) {\n      throw new Diagnostics.Error({\n        code: Diagnostics.code.unknown,\n        severity: 'error',\n        message: 'Cannot verify the background worker. No process was signaled.',\n        help: 'Check `worker.log`, then stop the process by hand if it is still running.',\n      })\n    }\n    return\n  }\n  const deadline = Date.now() + 15_000\n  while (Date.now() < deadline) {\n    try {\n      await requestWorker(record, 'status')\n    } catch {\n      return\n    }\n    await delay(100)\n  }\n  throw new Diagnostics.Error({\n    code: Diagnostics.code.unknown,\n    severity: 'error',\n    message: 'The worker has not finished shutting down. Check worker.log and try again.',\n  })\n}\n\n/** The listening port is the project lock, so stale state never needs a PID-based takeover. */\nexport async function serveWorker(shutdown: AbortController) {\n  const record: WorkerRecord = { id: randomBytes(16).toString('hex'), pid: process.pid, port: 0, state: 'starting' }\n  const server = createServer((socket) => {\n    let input = ''\n    socket.setTimeout(2_000, () => socket.destroy())\n    socket.on('error', () => {})\n    socket.on('data', (chunk: Buffer) => {\n      input += chunk.toString()\n      if (input.length > 4096) {\n        socket.destroy()\n        return\n      }\n      if (!input.includes('\\n')) return\n      try {\n        const request = JSON.parse(input) as { id?: unknown; command?: unknown }\n        if (request.id !== record.id || !['status', 'stop'].includes(String(request.command))) {\n          socket.destroy()\n          return\n        }\n        socket.end(JSON.stringify(record))\n        if (request.command === 'stop') shutdown.abort()\n      } catch {\n        socket.destroy()\n      }\n    })\n  })\n  // Hash the project directory to choose its loopback port; fail on collisions.\n  const port = 20_000 + (Number.parseInt(hash('sha256', getProjectKubbHome()).slice(0, 8), 16) % 30_000)\n  try {\n    await new Promise<void>((resolve, reject) => {\n      server.once('error', reject)\n      server.listen(port, '127.0.0.1', resolve)\n    })\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== 'EADDRINUSE') throw error\n    // Let a simultaneous starter finish writing its record before checking ownership.\n    await delay(100)\n    const existing = await readWorker()\n    if (existing?.port === port) {\n      try {\n        return { existing: await requestWorker(existing, 'status') }\n      } catch {\n        /* Refuse an unverified listener. */\n      }\n    }\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: 'The project control port is occupied or another worker is starting. Try again after stopping that listener.',\n    })\n  }\n  record.port = port\n  let saving = Promise.resolve()\n  const save = () => {\n    const value = JSON.stringify(record)\n    saving = saving.then(async () => {\n      const temporary = `${statePath()}.${record.id}`\n      await writeFile(temporary, value, { mode: 0o600 })\n      await rename(temporary, statePath())\n    })\n    return saving\n  }\n  try {\n    await save()\n  } catch (error) {\n    server.close()\n    throw error\n  }\n  return {\n    async state(state: WorkerState) {\n      record.state = state\n      await save()\n    },\n    async close() {\n      try {\n        if (record.state !== 'authentication required') {\n          record.state = 'stopped'\n          await save()\n        }\n      } finally {\n        await new Promise<void>((resolve, reject) => server.close((error) => (error ? reject(error) : resolve())))\n      }\n    },\n  }\n}\n\nexport type WorkerLaunch = { options: StudioOptions; prepared: PreparedConnection }\n\nexport async function startWorker(options: StudioOptions): Promise<void> {\n  const current = await getWorkerStatus()\n  if (current.running) {\n    console.log(`Already running (${current.state}, PID ${current.pid}).`)\n    return\n  }\n  const prepared = await prepareConnection(options)\n  const entry = path.join(path.dirname(createRequire(import.meta.url).resolve('@kubb/cli/package.json')), 'dist', 'studioWorker.js')\n  const child = x(process.execPath, [...process.execArgv, entry], {\n    nodeOptions: { cwd: process.cwd(), detached: true, stdio: ['ignore', 'ignore', 'ignore', 'ipc'] },\n  }).process\n  if (!child)\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: 'Background worker failed to start',\n      help: 'Run `kubb studio` in the foreground to see why it fails.',\n    })\n  try {\n    const started = new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(() => done(new Error('Background worker startup timed out')), 20_000)\n      const done = (error?: Error) => {\n        clearTimeout(timer)\n        child.removeListener('error', failed)\n        child.removeListener('exit', exited)\n        child.removeListener('message', ready)\n        if (error) reject(error)\n        else resolve()\n      }\n      const failed = (error: Error) => done(error)\n      const exited = () => done(new Error(`Background worker exited during startup. Check ${getWorkerLogPath()}`))\n      child.once('error', failed)\n      child.once('exit', exited)\n      const ready = (message: unknown) => {\n        if (!message || typeof message !== 'object' || !('started' in message) || message.started !== true)\n          return done(new Error('Invalid worker startup response'))\n        done()\n      }\n      child.once('message', ready)\n      child.send({ options: { ...options, autoOpen: false }, prepared } satisfies WorkerLaunch, (error) => {\n        if (error) done(error)\n      })\n    })\n    await started\n    if (child.connected) child.disconnect()\n    child.unref()\n    const status = await getWorkerStatus()\n    console.log(`Background worker ${status.state} (PID ${status.pid ?? child.pid}). Logs: ${getWorkerLogPath()}`)\n  } catch (error) {\n    // This is the child we just spawned, not a PID recovered from disk.\n    child.kill('SIGTERM')\n    throw error\n  }\n}\n"],"mappings":"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"}

package/dist/{background-obsD4Gj2.cjs → background-DVZB1n4j.cjs}

@@ -1,11 +1,12 @@
 const require_rolldown_runtime = require("./rolldown-runtime-CPE0t6oh.cjs");
 const require_credentials = require("./credentials-DDaKqtJn.cjs");
-const require_run = require("./run-DHiVlG37.cjs");
+const require_run = require("./run-BnLba1gt.cjs");
 require("node:crypto");
 let tinyexec = require("tinyexec");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
 node_path = require_rolldown_runtime.__toESM(node_path, 1);
+let _kubb_core = require("@kubb/core");
 let node_module = require("node:module");
 let node_net = require("node:net");
 let node_timers_promises = require("node:timers/promises");
@@ -58,7 +59,11 @@ function requestWorker(record, command) {
 		socket.once("end", () => {
 			try {
 				const response = JSON.parse(received);
-				if (response.id !== record.id || response.pid !== record.pid || !states.includes(response.state)) throw new Error("Worker identity changed");
+				if (response.id !== record.id || response.pid !== record.pid || !states.includes(response.state)) throw new _kubb_core.Diagnostics.Error({
+					code: _kubb_core.Diagnostics.code.internalError,
+					severity: "error",
+					message: "Worker identity changed"
+				});
 				resolve(response);
 			} catch (error) {
 				reject(error);
@@ -92,7 +97,12 @@ async function stopWorker() {
 	try {
 		await requestWorker(record, "stop");
 	} catch (error) {
-		if (error.code !== "ECONNREFUSED" && isAlive(record.pid) && record.state !== "stopped" && record.state !== "authentication required") throw new Error("Cannot verify the background worker. No process was signaled.");
+		if (error.code !== "ECONNREFUSED" && isAlive(record.pid) && record.state !== "stopped" && record.state !== "authentication required") throw new _kubb_core.Diagnostics.Error({
+			code: _kubb_core.Diagnostics.code.unknown,
+			severity: "error",
+			message: "Cannot verify the background worker. No process was signaled.",
+			help: "Check `worker.log`, then stop the process by hand if it is still running."
+		});
 		return;
 	}
 	const deadline = Date.now() + 15e3;
@@ -104,7 +114,11 @@ async function stopWorker() {
 		}
 		await (0, node_timers_promises.setTimeout)(100);
 	}
-	throw new Error("The worker has not finished shutting down. Check worker.log and try again.");
+	throw new _kubb_core.Diagnostics.Error({
+		code: _kubb_core.Diagnostics.code.unknown,
+		severity: "error",
+		message: "The worker has not finished shutting down. Check worker.log and try again."
+	});
 }
 async function startWorker(options) {
 	const current = await getWorkerStatus();
@@ -124,7 +138,12 @@ async function startWorker(options) {
 			"ipc"
 		]
 	} }).process;
-	if (!child) throw new Error("Background worker failed to start");
+	if (!child) throw new _kubb_core.Diagnostics.Error({
+		code: _kubb_core.Diagnostics.code.unknown,
+		severity: "error",
+		message: "Background worker failed to start",
+		help: "Run `kubb studio` in the foreground to see why it fails."
+	});
 	try {
 		await new Promise((resolve, reject) => {
 			const timer = setTimeout(() => done(/* @__PURE__ */ new Error("Background worker startup timed out")), 2e4);
@@ -170,4 +189,4 @@ exports.getWorkerStatus = getWorkerStatus;
 exports.startWorker = startWorker;
 exports.stopWorker = stopWorker;
 
-//# sourceMappingURL=background-obsD4Gj2.cjs.map
+//# sourceMappingURL=background-DVZB1n4j.cjs.map