@kubb/cli 5.10.0 → 5.10.2

package/dist/{Telemetry-BmdDiGPs.js → Telemetry-4smY7ClN.js}

@@ -105,7 +105,7 @@ function formatMs(ms) {
 }
 //#endregion
 //#region package.json
-var version = "5.10.0";
+var version = "5.10.2";
 //#endregion
 //#region src/Telemetry.ts
 /** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */
@@ -130,7 +130,7 @@ function trackRun({ command, hrStart }) {
 *
 * @see https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/
 */
-function buildOtlpPayload({ command, duration, status, plugins = [], filesCreated = 0 }) {
+function buildOtlpPayload({ command, duration, status, plugins = [], filesCreated = 0, mcpClient }) {
 	const traceId = randomBytes(16).toString("hex");
 	const spanId = randomBytes(8).toString("hex");
 	const endTimeNs = BigInt(Date.now()) * 1000000n;
@@ -166,10 +166,18 @@ function buildOtlpPayload({ command, duration, status, plugins = [], filesCreate
 			key: "kubb.ci",
 			value: { boolValue: isCIEnvironment() }
 		},
+		{
+			key: "kubb.tty",
+			value: { boolValue: process$1.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 }
@@ -256,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-BmdDiGPs.js.map
+//# sourceMappingURL=Telemetry-4smY7ClN.js.map

package/dist/Telemetry-4smY7ClN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Telemetry-4smY7ClN.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/{Telemetry-DuLxs5c3.cjs → Telemetry-DOahDJXF.cjs}

@@ -107,7 +107,7 @@ function formatMs(ms) {
 }
 //#endregion
 //#region package.json
-var version = "5.10.0";
+var version = "5.10.2";
 //#endregion
 //#region src/Telemetry.ts
 /** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */
@@ -132,7 +132,7 @@ function trackRun({ command, hrStart }) {
 *
 * @see https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/
 */
-function buildOtlpPayload({ command, duration, status, plugins = [], filesCreated = 0 }) {
+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;
@@ -168,10 +168,18 @@ function buildOtlpPayload({ command, duration, status, plugins = [], filesCreate
 			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 }
@@ -311,4 +319,4 @@ Object.defineProperty(exports, "version", {
 	}
 });
 
-//# sourceMappingURL=Telemetry-DuLxs5c3.cjs.map
+//# sourceMappingURL=Telemetry-DOahDJXF.cjs.map

package/dist/Telemetry-DOahDJXF.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Telemetry-DOahDJXF.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":";;;;;;;;;;;;;;;;;;;AAWA,SAAgB,QAAQ,OAAuB;CAC7C,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AACjE;;;;;;;;;;AAWA,SAAgB,gBAAgB,OAAwB;CACtD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;;;;;;;ACpBA,SAAgB,kBAA2B;CACzC,MAAM,KAAKA,aAAAA,QAAQ,IAAI;CACvB,OAAO,CAAC,EACL,MAAM,OAAO,WAAW,OAAO,OAChCA,aAAAA,QAAQ,IAAI,kBACZA,aAAAA,QAAQ,IAAI,aACZA,aAAAA,QAAQ,IAAI,0BACZA,aAAAA,QAAQ,IAAI,eACZA,aAAAA,QAAQ,IAAI,YACZA,aAAAA,QAAQ,IAAI,UACZA,aAAAA,QAAQ,IAAI,oBACZA,aAAAA,QAAQ,IAAI,aACZA,aAAAA,QAAQ,IAAI;AAEhB;;;ACnBA,MAAM,QAAQ,OAAO,QAAQ;AAC7B,MAAM,SAAS,UAAU;;;;;;;;;AAUzB,MAAa,UAAU;CAAE;CAAO,GAAG,OAAO;AAAE;AAE5C,SAAS,SAA6D;CACpE,IAAI,OAAO,OAAO;EAAE,MAAM;EAAO,SAAS,QAAQ,SAAS,OAAO;CAAG;CACrE,IAAI,QAAQ,OAAO;EAAE,MAAM;EAAQ,SAAU,WAA0D,MAAM,SAAS,QAAQ;CAAG;CACjI,OAAO;EAAE,MAAM;EAAQ,SAAS,QAAQ,UAAU,QAAQ;CAAG;AAC/D;;;;;;;;;;;;;;ACPA,SAAgB,aAAa,SAAmC;CAC9D,MAAM,CAAC,SAAS,eAAe,QAAQ,OAAO,OAAO;CACrD,MAAM,KAAK,UAAU,MAAO,cAAc;CAC1C,OAAO,KAAK,MAAM,KAAK,GAAG,IAAI;AAChC;;;;;;;;;;;AAYA,SAAgB,SAAS,IAAoB;CAC3C,IAAI,MAAM,KAGR,OAAO,GAFM,KAAK,MAAM,KAAK,GAEhB,EAAE,KADA,KAAK,MAAS,IAAA,CAAM,QAAQ,CACrB,EAAE;CAG1B,IAAI,MAAM,KACR,OAAO,IAAI,KAAK,IAAA,CAAM,QAAQ,CAAC,EAAE;CAEnC,OAAO,GAAG,KAAK,MAAM,EAAE,EAAE;AAC3B;;;;;;;AE9BA,MAAM,gBAAgB;;;;AAgCtB,SAAgB,aAAsB;CACpC,OAAO,CAAC,gBAAgB,wBAAwB,CAAC,CAAC,MAAM,SAAS,CAAC,KAAK,MAAM,CAAC,CAAC,SAASC,aAAAA,QAAQ,IAAI,SAAS,EAAE,CAAC;AAClH;;AAGA,SAAgB,SAAS,EAAE,SAAS,WAA2G;CAC7I,QAAQ,WAAW,cAAc,iBAAiB;EAAE;EAAS,UAAU,KAAK,MAAM,aAAa,OAAO,CAAC;EAAG,GAAG;CAAO,CAAC,CAAC;AACxH;;;;;;;AAQA,SAAgB,iBAAiB,EAC/B,SACA,UACA,QACA,UAAU,CAAC,GACX,eAAe,GACf,aAC8D;CAC9D,MAAM,WAAA,GAAUC,YAAAA,YAAAA,CAAY,EAAE,CAAC,CAAC,SAAS,KAAK;CAC9C,MAAM,UAAA,GAASA,YAAAA,YAAAA,CAAY,CAAC,CAAC,CAAC,SAAS,KAAK;CAC5C,MAAM,YAAY,OAAO,KAAK,IAAI,CAAC,IAAI;CACvC,MAAM,cAAc,YAAY,OAAO,QAAQ,IAAI;CACnD,MAAM,cAAc,CAAC,GAAG,IAAI,IAAI,QAAQ,KAAK,WAAW,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK;CAC5E,MAAM,SAAA,GAAQC,aAAAA,gBAAAA,CAAgB;CAE9B,MAAM,aAAa;EACjB;GAAE,KAAK;GAAgB,OAAO,EAAE,aAAa,QAAQ;EAAE;EACvD;GAAE,KAAK;GAAgB,OAAO,EAAE,aAAa,QAAQ;EAAE;EACvD;GAAE,KAAK;GAAqB,OAAO,EAAE,aAAaF,aAAAA,QAAQ,SAAS,KAAK,MAAM,GAAG,CAAC,CAAC,GAAa;EAAE;EAClG;GAAE,KAAK;GAAgB,OAAO,EAAE,aAAa,QAAQ,KAAK;EAAE;EAC5D;GAAE,KAAK;GAAwB,OAAO,EAAE,aAAa,QAAQ,QAAQ,MAAM,GAAG,CAAC,CAAC,GAAa;EAAE;EAC/F;GAAE,KAAK;GAAiB,OAAO,EAAE,aAAaG,QAAAA,QAAG,SAAS,EAAE;EAAE;EAC9D;GAAE,KAAK;GAAW,OAAO,EAAE,WAAW,gBAAgB,EAAE;EAAE;EAE1D;GAAE,KAAK;GAAY,OAAO,EAAE,WAAWH,aAAAA,QAAQ,MAAM,UAAU,KAAK;EAAE;EACtE,GAAI,MAAM,WAAW,MAAM,OAAO,CAAC;GAAE,KAAK;GAAc,OAAO,EAAE,aAAa,MAAM,KAAK;EAAE,CAAC,IAAI,CAAC;EAEjG,GAAI,YAAY,CAAC;GAAE,KAAK;GAAmB,OAAO,EAAE,aAAa,UAAU,MAAM,GAAG,EAAE,EAAE;EAAE,CAAC,IAAI,CAAC;EAChG;GAAE,KAAK;GAAsB,OAAO,EAAE,UAAU,aAAa;EAAE;EAC/D;GAAE,KAAK;GAAe,OAAO,EAAE,aAAa,OAAO;EAAE;EACrD;GACE,KAAK;GACL,OAAO,EAAE,YAAY,EAAE,QAAQ,YAAY,KAAK,UAAU,EAAE,aAAa,KAAK,EAAE,EAAE,EAAE;EACtF;EACA,GAAG,YAAY,KAAK,UAAU;GAAE,KAAK,eAAe;GAAQ,OAAO,EAAE,WAAW,KAAK;EAAE,EAAE;EACzF;GACE,KAAK;GACL,OAAO,EACL,YAAY,EACV,QAAQ,QAAQ,KAAK,OAAO,EAC1B,aAAa,EACX,QAAQ,CACN;IAAE,KAAK;IAAQ,OAAO,EAAE,aAAa,EAAE,KAAK;GAAE,GAC9C;IACE,KAAK;IACL,OAAO,EACL,aAAa,KAAK,UAAU;KAC1B,GAAG,EAAE;KACL,eAAe,KAAA;IACjB,CAAC,EACH;GACF,CACF,EACF,EACF,EAAE,EACJ,EACF;EACF;CACF;CAEA,OAAO,EACL,eAAe,CACb;EACE,UAAU,EACR,YAAY;GACV;IAAE,KAAK;IAAgB,OAAO,EAAE,aAAa,OAAO;GAAE;GACtD;IAAE,KAAK;IAAmB,OAAO,EAAE,aAAa,QAAQ;GAAE;GAC1D;IAAE,KAAK;IAA0B,OAAO,EAAE,aAAa,SAAS;GAAE;EACpE,EACF;EACA,YAAY,CACV;GACE,OAAO;IAAE,MAAM;IAAa;GAAQ;GACpC,OAAO,CACL;IACE;IACA;IACA,MAAM;IACN,MAAM;IACN,mBAAmB,OAAO,WAAW;IACrC,iBAAiB,OAAO,SAAS;IACjC;IACA,QAAQ,EACN,MAAM,WAAW,YAAY,IAAI,EACnC;GACF,CACF;EACF,CACF;CACF,CACF,EACF;AACF;;;;;;AAOA,eAAsB,cAAc,SAA6D;CAC/F,IAAI,WAAW,GACb;CAGF,IAAI;EACF,MAAM,MAAM,GAAG,cAAc,aAAa;GACxC,QAAQ;GACR,SAAS;IACP,gBAAgB;IAChB,0BAA0B;IAC1B,yBAAyB;GAC3B;GACA,MAAM,KAAK,UAAU,OAAO;GAC5B,QAAQ,YAAY,QAAQ,GAAK;EACnC,CAAC;CACH,SAAS,IAAI,CAEb;AACF"}

package/dist/{background-DWasKvSw.js → background-BKWslHZJ.js}

@@ -1,11 +1,12 @@
 import "./rolldown-runtime-CRm0XQPb.js";
-import { a as prepareConnection } from "./run-B33l-Tx7.js";
+import { a as prepareConnection } from "./run-DsRPwmkb.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-DWasKvSw.js.map
+//# sourceMappingURL=background-BKWslHZJ.js.map

package/dist/background-BKWslHZJ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-BKWslHZJ.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-y0JpYwlj.js → background-BkDRe558.js}

@@ -1 +1 @@
-export { t as getWorkerLogPath, n as getWorkerStatus, i as startWorker, a as stopWorker } from "./background-DWasKvSw.js";
+export { t as getWorkerLogPath, n as getWorkerStatus, i as startWorker, a as stopWorker } from "./background-BKWslHZJ.js";

package/dist/{background-CK9olfbv.cjs → background-CF80MwuR.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-Bqy3HW6o.cjs");
+const require_run = require("./run-xXgz6PA_.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-CK9olfbv.cjs.map
+//# sourceMappingURL=background-CF80MwuR.cjs.map

package/dist/background-CF80MwuR.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-CF80MwuR.cjs","names":["path","getProjectKubbHome","readFile","connectSocket","Diagnostics","delay","prepareConnection","createRequire","x"],"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/{config-BPuFepc5.js → config-BC4Wm0OK.js}

@@ -1,8 +1,9 @@
 import "./rolldown-runtime-CRm0XQPb.js";
-import { _ as isRichOutput, m as clackLogger, p as plainLogger, v as findConfigFile, y as loadConfigFile } from "./output-DIJsbXzW.js";
+import { l as toError } from "./Telemetry-4smY7ClN.js";
+import { _ as isRichOutput, b as CONFIG_EXTENSIONS, m as clackLogger, p as plainLogger, v as findConfigFile, y as loadConfigFile } from "./output-CxcaLxy9.js";
 import process from "node:process";
 import { resolve } from "node:path";
-import { createCliReporter } from "@kubb/core";
+import { Diagnostics, createCliReporter } from "@kubb/core";
 //#region src/loggers/reporters.ts
 /** Bridges a {@link Reporter} onto the hook emitter: calls `report` with each config's {@link GenerationResult} on `kubb:generation:end`. */
 function installReporter(context, reporter, ctx) {
@@ -55,7 +56,13 @@ function selectReporters(reporters, names) {
 /** Discovers the Kubb config and resolves it into normalized configs, each guaranteed to have a `plugins` array. */
 async function getConfigs({ configPath, input, watch, logLevel }) {
 	const file = configPath ? resolve(configPath) : findConfigFile();
-	if (!file) throw new Error("Config not defined, create a kubb.config.js or pass through your config with the option --config");
+	if (!file) throw new Diagnostics.Error({
+		code: Diagnostics.code.unknown,
+		severity: "error",
+		message: `No Kubb config found. Looked for kubb.config.* and .kubbrc.* (${CONFIG_EXTENSIONS.join(", ")}) in ${process.cwd()}, its .config/ and configs/ folders, and each parent folder.`,
+		help: "Run `kubb init` to create one, or pass a path with `--config`.",
+		location: { kind: "config" }
+	});
 	let configs;
 	try {
 		configs = await loadConfigFile(file, {
@@ -65,7 +72,14 @@ async function getConfigs({ configPath, input, watch, logLevel }) {
 			logLevel
 		});
 	} catch (error) {
-		throw new Error("Config failed loading", { cause: error });
+		throw new Diagnostics.Error({
+			code: Diagnostics.code.unknown,
+			severity: "error",
+			message: `Config failed loading: ${file}`,
+			help: "Fix the error the config file throws, shown under `caused by:`.",
+			location: { kind: "config" },
+			cause: toError(error)
+		});
 	}
 	return {
 		configPath: file,
@@ -78,4 +92,4 @@ async function getConfigs({ configPath, input, watch, logLevel }) {
 //#endregion
 export { selectReporters as n, setupReporters as r, getConfigs as t };
 
-//# sourceMappingURL=config-BPuFepc5.js.map
+//# sourceMappingURL=config-BC4Wm0OK.js.map

package/dist/config-BC4Wm0OK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-BC4Wm0OK.js","names":[],"sources":["../src/loggers/reporters.ts","../src/config.ts"],"sourcesContent":["import process from 'node:process'\nimport type { Config, Hookable, KubbHooks, Reporter, ReporterContext, ReporterPluginFiles } from '@kubb/core'\nimport { createCliReporter } from '@kubb/core'\nimport { isRichOutput } from '../utils/env.ts'\nimport type { Logger, LoggerOptions } from './defineLogger.ts'\nimport { clackLogger } from './clackLogger.ts'\nimport { plainLogger } from './plainLogger.ts'\n\n/** Bridges a {@link Reporter} onto the hook emitter: calls `report` with each config's {@link GenerationResult} on `kubb:generation:end`. */\nfunction installReporter(context: Hookable<KubbHooks>, reporter: Reporter, ctx: ReporterContext): void {\n  const pluginFiles = reporter.needsPluginFiles ? new Map<Config, Map<string, Set<string>>>() : undefined\n\n  if (pluginFiles) {\n    context.hook('kubb:plugin:end', ({ config, plugin, files }) => {\n      const filesByPlugin = pluginFiles.get(config) ?? new Map<string, Set<string>>()\n      const seen = new Set([...filesByPlugin.values()].flatMap((paths) => [...paths]))\n      const added = files.filter((file) => !seen.has(file.path)).map((file) => file.path)\n\n      if (added.length) filesByPlugin.set(plugin.name, new Set([...(filesByPlugin.get(plugin.name) ?? []), ...added]))\n\n      pluginFiles.set(config, filesByPlugin)\n    })\n  }\n\n  context.hook('kubb:generation:end', async ({ config, diagnostics = [], filesCreated = 0, status = 'success', hrStart = process.hrtime() }) => {\n    const files = pluginFiles?.get(config)\n    const grouped: ReporterPluginFiles | undefined = files && [...files].map(([plugin, paths]) => ({ plugin, files: [...paths] }))\n\n    await reporter.report({ config, diagnostics, filesCreated, status, hrStart, pluginFiles: grouped }, ctx)\n\n    pluginFiles?.delete(config)\n  })\n\n  if (reporter.drain) {\n    context.hook('kubb:lifecycle:end', () => reporter.drain?.(ctx))\n  }\n}\n\n/** Installs the live logger and wires the selected reporters. `cli` renders its summary through the logger, and is skipped when `json` owns stdout. */\nfunction setupReporters(\n  context: Hookable<KubbHooks>,\n  {\n    logLevel,\n    reporters,\n    logger: forcedLogger,\n  }: LoggerOptions & {\n    reporters: ReadonlyArray<Reporter>\n    /** Overrides the terminal-based pick, e.g. the plain logger for `kubb studio snapshot`. */\n    logger?: Logger\n  },\n): void {\n  const hasJson = reporters.some((reporter) => reporter.name === 'json')\n  const ctx: ReporterContext = { logLevel }\n\n  for (const reporter of reporters) {\n    if (reporter.name !== 'cli') {\n      installReporter(context, reporter, ctx)\n      continue\n    }\n\n    if (hasJson) {\n      continue\n    }\n\n    const logger = forcedLogger ?? (isRichOutput() ? clackLogger : plainLogger)\n    const handle = logger(context, { logLevel })\n\n    // The summary belongs inside the group the logger opened for this config, so the logger writes it.\n    installReporter(context, createCliReporter({ render: handle?.renderSummary }), ctx)\n  }\n}\n\nexport default setupReporters\n\n/** Picks the reporters whose `name` is in `names`, in the given order (the CLI maps `--reporter` to this); duplicates and unknown names are skipped. */\nexport function selectReporters(reporters: ReadonlyArray<Reporter>, names: ReadonlyArray<string>): Array<Reporter> {\n  return [...new Set(names)].flatMap((name) => reporters.find((reporter) => reporter.name === name) ?? [])\n}\n","import { resolve } from 'node:path'\nimport process from 'node:process'\nimport { CONFIG_EXTENSIONS, findConfigFile, loadConfigFile } from '@internals/shared'\nimport { type CLIOptions, type Config, Diagnostics } from '@kubb/core'\nimport { toError } from '@internals/utils'\n\ntype GetConfigsOptions = {\n  /** Explicit path to the Kubb config file. When omitted, the loader searches up from `process.cwd()`. */\n  configPath?: string\n  /** OpenAPI input path or URL that overrides `config.input` for this run. */\n  input?: string\n  /** Watch flag forwarded to the user's `defineConfig` function. */\n  watch?: boolean\n  /** Log level forwarded to the user's `defineConfig` function. */\n  logLevel?: CLIOptions['logLevel']\n}\n\ntype GetConfigsResult = {\n  /** Absolute path to the resolved config file. */\n  configPath: string\n  /** Resolved and normalized Kubb configs, each guaranteed to have a `plugins` array. */\n  configs: Array<Config>\n}\n\n/** Discovers the Kubb config and resolves it into normalized configs, each guaranteed to have a `plugins` array. */\nexport async function getConfigs({ configPath, input, watch, logLevel }: GetConfigsOptions): Promise<GetConfigsResult> {\n  const file = configPath ? resolve(configPath) : findConfigFile()\n  if (!file) {\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: `No Kubb config found. Looked for kubb.config.* and .kubbrc.* (${CONFIG_EXTENSIONS.join(', ')}) in ${process.cwd()}, its .config/ and configs/ folders, and each parent folder.`,\n      help: 'Run `kubb init` to create one, or pass a path with `--config`.',\n      location: { kind: 'config' },\n    })\n  }\n\n  let configs: Array<Config>\n  try {\n    configs = await loadConfigFile<Config>(file, { config: configPath, input, watch, logLevel } satisfies CLIOptions)\n  } catch (error) {\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: `Config failed loading: ${file}`,\n      help: 'Fix the error the config file throws, shown under `caused by:`.',\n      location: { kind: 'config' },\n      cause: toError(error),\n    })\n  }\n\n  return { configPath: file, configs: configs.map((item) => ({ ...item, plugins: item.plugins ?? [] })) }\n}\n"],"mappings":"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"}

package/dist/{config-CGUQ39wR.cjs → config-bF-Lo5C2.cjs}

@@ -1,5 +1,6 @@
 const require_rolldown_runtime = require("./rolldown-runtime-CPE0t6oh.cjs");
-const require_output = require("./output-Ck7iT223.cjs");
+const require_Telemetry = require("./Telemetry-DOahDJXF.cjs");
+const require_output = require("./output-C3zLt8M9.cjs");
 let node_process = require("node:process");
 node_process = require_rolldown_runtime.__toESM(node_process, 1);
 let node_path = require("node:path");
@@ -56,7 +57,13 @@ function selectReporters(reporters, names) {
 /** Discovers the Kubb config and resolves it into normalized configs, each guaranteed to have a `plugins` array. */
 async function getConfigs({ configPath, input, watch, logLevel }) {
 	const file = configPath ? (0, node_path.resolve)(configPath) : require_output.findConfigFile();
-	if (!file) throw new Error("Config not defined, create a kubb.config.js or pass through your config with the option --config");
+	if (!file) throw new _kubb_core.Diagnostics.Error({
+		code: _kubb_core.Diagnostics.code.unknown,
+		severity: "error",
+		message: `No Kubb config found. Looked for kubb.config.* and .kubbrc.* (${require_output.CONFIG_EXTENSIONS.join(", ")}) in ${node_process.default.cwd()}, its .config/ and configs/ folders, and each parent folder.`,
+		help: "Run `kubb init` to create one, or pass a path with `--config`.",
+		location: { kind: "config" }
+	});
 	let configs;
 	try {
 		configs = await require_output.loadConfigFile(file, {
@@ -66,7 +73,14 @@ async function getConfigs({ configPath, input, watch, logLevel }) {
 			logLevel
 		});
 	} catch (error) {
-		throw new Error("Config failed loading", { cause: error });
+		throw new _kubb_core.Diagnostics.Error({
+			code: _kubb_core.Diagnostics.code.unknown,
+			severity: "error",
+			message: `Config failed loading: ${file}`,
+			help: "Fix the error the config file throws, shown under `caused by:`.",
+			location: { kind: "config" },
+			cause: require_Telemetry.toError(error)
+		});
 	}
 	return {
 		configPath: file,
@@ -96,4 +110,4 @@ Object.defineProperty(exports, "setupReporters", {
 	}
 });
 
-//# sourceMappingURL=config-CGUQ39wR.cjs.map
+//# sourceMappingURL=config-bF-Lo5C2.cjs.map

package/dist/config-bF-Lo5C2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-bF-Lo5C2.cjs","names":["process","isRichOutput","clackLogger","plainLogger","createCliReporter","resolve","findConfigFile","Diagnostics","CONFIG_EXTENSIONS","process","loadConfigFile","toError"],"sources":["../src/loggers/reporters.ts","../src/config.ts"],"sourcesContent":["import process from 'node:process'\nimport type { Config, Hookable, KubbHooks, Reporter, ReporterContext, ReporterPluginFiles } from '@kubb/core'\nimport { createCliReporter } from '@kubb/core'\nimport { isRichOutput } from '../utils/env.ts'\nimport type { Logger, LoggerOptions } from './defineLogger.ts'\nimport { clackLogger } from './clackLogger.ts'\nimport { plainLogger } from './plainLogger.ts'\n\n/** Bridges a {@link Reporter} onto the hook emitter: calls `report` with each config's {@link GenerationResult} on `kubb:generation:end`. */\nfunction installReporter(context: Hookable<KubbHooks>, reporter: Reporter, ctx: ReporterContext): void {\n  const pluginFiles = reporter.needsPluginFiles ? new Map<Config, Map<string, Set<string>>>() : undefined\n\n  if (pluginFiles) {\n    context.hook('kubb:plugin:end', ({ config, plugin, files }) => {\n      const filesByPlugin = pluginFiles.get(config) ?? new Map<string, Set<string>>()\n      const seen = new Set([...filesByPlugin.values()].flatMap((paths) => [...paths]))\n      const added = files.filter((file) => !seen.has(file.path)).map((file) => file.path)\n\n      if (added.length) filesByPlugin.set(plugin.name, new Set([...(filesByPlugin.get(plugin.name) ?? []), ...added]))\n\n      pluginFiles.set(config, filesByPlugin)\n    })\n  }\n\n  context.hook('kubb:generation:end', async ({ config, diagnostics = [], filesCreated = 0, status = 'success', hrStart = process.hrtime() }) => {\n    const files = pluginFiles?.get(config)\n    const grouped: ReporterPluginFiles | undefined = files && [...files].map(([plugin, paths]) => ({ plugin, files: [...paths] }))\n\n    await reporter.report({ config, diagnostics, filesCreated, status, hrStart, pluginFiles: grouped }, ctx)\n\n    pluginFiles?.delete(config)\n  })\n\n  if (reporter.drain) {\n    context.hook('kubb:lifecycle:end', () => reporter.drain?.(ctx))\n  }\n}\n\n/** Installs the live logger and wires the selected reporters. `cli` renders its summary through the logger, and is skipped when `json` owns stdout. */\nfunction setupReporters(\n  context: Hookable<KubbHooks>,\n  {\n    logLevel,\n    reporters,\n    logger: forcedLogger,\n  }: LoggerOptions & {\n    reporters: ReadonlyArray<Reporter>\n    /** Overrides the terminal-based pick, e.g. the plain logger for `kubb studio snapshot`. */\n    logger?: Logger\n  },\n): void {\n  const hasJson = reporters.some((reporter) => reporter.name === 'json')\n  const ctx: ReporterContext = { logLevel }\n\n  for (const reporter of reporters) {\n    if (reporter.name !== 'cli') {\n      installReporter(context, reporter, ctx)\n      continue\n    }\n\n    if (hasJson) {\n      continue\n    }\n\n    const logger = forcedLogger ?? (isRichOutput() ? clackLogger : plainLogger)\n    const handle = logger(context, { logLevel })\n\n    // The summary belongs inside the group the logger opened for this config, so the logger writes it.\n    installReporter(context, createCliReporter({ render: handle?.renderSummary }), ctx)\n  }\n}\n\nexport default setupReporters\n\n/** Picks the reporters whose `name` is in `names`, in the given order (the CLI maps `--reporter` to this); duplicates and unknown names are skipped. */\nexport function selectReporters(reporters: ReadonlyArray<Reporter>, names: ReadonlyArray<string>): Array<Reporter> {\n  return [...new Set(names)].flatMap((name) => reporters.find((reporter) => reporter.name === name) ?? [])\n}\n","import { resolve } from 'node:path'\nimport process from 'node:process'\nimport { CONFIG_EXTENSIONS, findConfigFile, loadConfigFile } from '@internals/shared'\nimport { type CLIOptions, type Config, Diagnostics } from '@kubb/core'\nimport { toError } from '@internals/utils'\n\ntype GetConfigsOptions = {\n  /** Explicit path to the Kubb config file. When omitted, the loader searches up from `process.cwd()`. */\n  configPath?: string\n  /** OpenAPI input path or URL that overrides `config.input` for this run. */\n  input?: string\n  /** Watch flag forwarded to the user's `defineConfig` function. */\n  watch?: boolean\n  /** Log level forwarded to the user's `defineConfig` function. */\n  logLevel?: CLIOptions['logLevel']\n}\n\ntype GetConfigsResult = {\n  /** Absolute path to the resolved config file. */\n  configPath: string\n  /** Resolved and normalized Kubb configs, each guaranteed to have a `plugins` array. */\n  configs: Array<Config>\n}\n\n/** Discovers the Kubb config and resolves it into normalized configs, each guaranteed to have a `plugins` array. */\nexport async function getConfigs({ configPath, input, watch, logLevel }: GetConfigsOptions): Promise<GetConfigsResult> {\n  const file = configPath ? resolve(configPath) : findConfigFile()\n  if (!file) {\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: `No Kubb config found. Looked for kubb.config.* and .kubbrc.* (${CONFIG_EXTENSIONS.join(', ')}) in ${process.cwd()}, its .config/ and configs/ folders, and each parent folder.`,\n      help: 'Run `kubb init` to create one, or pass a path with `--config`.',\n      location: { kind: 'config' },\n    })\n  }\n\n  let configs: Array<Config>\n  try {\n    configs = await loadConfigFile<Config>(file, { config: configPath, input, watch, logLevel } satisfies CLIOptions)\n  } catch (error) {\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: `Config failed loading: ${file}`,\n      help: 'Fix the error the config file throws, shown under `caused by:`.',\n      location: { kind: 'config' },\n      cause: toError(error),\n    })\n  }\n\n  return { configPath: file, configs: configs.map((item) => ({ ...item, plugins: item.plugins ?? [] })) }\n}\n"],"mappings":"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"}