@kubb/core 5.0.0-beta.38 → 5.0.0-beta.39

package/dist/index.js

@@ -1,8 +1,83 @@
 import "./chunk-C0LytTxp.js";
-import { _ as URLPath, a as defineResolver, c as Diagnostics, d as isProblemDiagnostic, f as isUpdateDiagnostic, g as logLevel, h as diagnosticCode, i as FileManager, l as diagnosticCatalog, m as DEFAULT_STUDIO_URL, n as _usingCtx, o as definePlugin, p as narrowDiagnostic, r as FileProcessor, s as DiagnosticError, t as KubbDriver, u as isPerformanceDiagnostic, v as AsyncEventEmitter, y as BuildError } from "./KubbDriver-CyNF-NIb.js";
+import { c as createStorage, d as formatMs, f as getElapsedMs, h as BuildError, l as Diagnostics, m as AsyncEventEmitter, n as KubbDriver, o as defineResolver, r as _usingCtx, s as definePlugin, t as memoryStorage, u as OTLP_ENDPOINT } from "./memoryStorage-CNQTs-YG.js";
+import { stripVTControlCharacters, styleText } from "node:util";
+import { createHash, randomBytes } from "node:crypto";
 import { access, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
-import { dirname, join, resolve } from "node:path";
+import { dirname, join, relative, resolve } from "node:path";
+import { promises } from "node:dns";
 import * as ast from "@kubb/ast";
+import process$1 from "node:process";
+import os from "node:os";
+//#region ../../internals/utils/src/colors.ts
+/**
+* Parses a CSS hex color string (`#RGB`) into its RGB channels.
+* Falls back to `255` for any channel that cannot be parsed.
+*/
+function parseHex(color) {
+	const int = Number.parseInt(color.replace("#", ""), 16);
+	return Number.isNaN(int) ? {
+		r: 255,
+		g: 255,
+		b: 255
+	} : {
+		r: int >> 16 & 255,
+		g: int >> 8 & 255,
+		b: int & 255
+	};
+}
+/**
+* Returns a function that wraps a string in a 24-bit ANSI true-color escape sequence
+* for the given hex color.
+*/
+function hex(color) {
+	const { r, g, b } = parseHex(color);
+	return (text) => `\x1b[38;2;${r};${g};${b}m${text}\x1b[0m`;
+}
+hex("#F55A17"), hex("#F5A217"), hex("#F58517"), hex("#B45309"), hex("#FFFFFF"), hex("#adadc6"), hex("#FDA4AF");
+/**
+* ANSI color names used by {@link randomCliColor} for deterministic terminal coloring.
+*/
+const randomColors = [
+	"black",
+	"red",
+	"green",
+	"yellow",
+	"blue",
+	"white",
+	"magenta",
+	"cyan",
+	"gray"
+];
+/**
+* Wraps `text` in a deterministic ANSI color derived from the text's SHA-256 hash.
+*
+* @example
+* ```ts
+* randomCliColor('petstore') // '\x1b[33m' + 'petstore' + '\x1b[39m' (always the same color for 'petstore')
+* ```
+*/
+function randomCliColor(text) {
+	if (!text) return "";
+	return styleText(randomColors[createHash("sha256").update(text).digest().readUInt32BE(0) % randomColors.length] ?? "white", text);
+}
+//#endregion
+//#region ../../internals/utils/src/env.ts
+/**
+* Returns `true` when the process is running in a CI environment.
+* Covers GitHub Actions, GitLab CI, CircleCI, Travis CI, Jenkins, Bitbucket,
+* TeamCity, Buildkite, and Azure Pipelines.
+*
+* @example
+* ```ts
+* if (isCIEnvironment()) {
+*   logger.level = 'error'
+* }
+* ```
+*/
+function isCIEnvironment() {
+	return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.BITBUCKET_BUILD_NUMBER || process.env.JENKINS_URL || process.env.CIRCLECI || process.env.TRAVIS || process.env.TEAMCITY_VERSION || process.env.BUILDKITE || process.env.TF_BUILD);
+}
+//#endregion
 //#region ../../internals/utils/src/fs.ts
 /**
 * Writes `data` to `path`, trimming leading/trailing whitespace before saving.
@@ -54,6 +129,51 @@ async function clean(path) {
 	});
 }
 //#endregion
+//#region ../../internals/utils/src/network.ts
+/**
+* Well-known stable domains used as DNS probes to check internet connectivity.
+*/
+const TEST_DOMAINS = [
+	"dns.google.com",
+	"cloudflare.com",
+	"one.one.one.one"
+];
+/**
+* Returns `true` when the system has internet connectivity.
+* Probes DNS resolution against well-known stable domains.
+*
+* @example
+* ```ts
+* if (await isOnline()) {
+*   await fetchLatestVersion()
+* }
+* ```
+*/
+async function isOnline() {
+	for (const domain of TEST_DOMAINS) try {
+		await promises.resolve(domain);
+		return true;
+	} catch {}
+	return false;
+}
+/**
+* Executes `fn` only when the system is online. Returns `null` when offline or on error.
+*
+* @example
+* ```ts
+* const version = await executeIfOnline(() => fetchLatestVersion('kubb'))
+* // null when offline
+* ```
+*/
+async function executeIfOnline(fn) {
+	if (!await isOnline()) return null;
+	try {
+		return await fn();
+	} catch {
+		return null;
+	}
+}
+//#endregion
 //#region src/createAdapter.ts
 /**
 * Defines a custom adapter that translates a spec format into Kubb's universal
@@ -89,49 +209,6 @@ function createAdapter(build) {
 	return (options) => build(options ?? {});
 }
 //#endregion
-//#region src/createStorage.ts
-/**
-* Defines a custom storage backend. The builder receives user options and
-* returns a `Storage` implementation. Kubb ships with filesystem and
-* in-memory storages, reach for this when you need to write generated files
-* elsewhere (cloud storage, a database, a remote API).
-*
-* @example In-memory storage (the built-in implementation)
-* ```ts
-* import { createStorage } from '@kubb/core'
-*
-* export const memoryStorage = createStorage(() => {
-*   const store = new Map<string, string>()
-*
-*   return {
-*     name: 'memory',
-*     async hasItem(key) {
-*       return store.has(key)
-*     },
-*     async getItem(key) {
-*       return store.get(key) ?? null
-*     },
-*     async setItem(key, value) {
-*       store.set(key, value)
-*     },
-*     async removeItem(key) {
-*       store.delete(key)
-*     },
-*     async getKeys(base) {
-*       const keys = [...store.keys()]
-*       return base ? keys.filter((k) => k.startsWith(base)) : keys
-*     },
-*     async clear(base) {
-*       if (!base) store.clear()
-*     },
-*   }
-* })
-* ```
-*/
-function createStorage(build) {
-	return (options) => build(options ?? {});
-}
-//#endregion
 //#region src/storages/fsStorage.ts
 /**
 * Built-in filesystem storage driver.
@@ -256,16 +333,10 @@ function resolveConfig(userConfig) {
 			...userConfig.output
 		},
 		storage: userConfig.storage ?? fsStorage(),
-		devtools: userConfig.devtools ? {
-			studioUrl: DEFAULT_STUDIO_URL,
-			...typeof userConfig.devtools === "boolean" ? {} : userConfig.devtools
-		} : void 0,
+		reporters: userConfig.reporters ?? [],
 		plugins: userConfig.plugins ?? []
 	};
 }
-function isInputPath(config) {
-	return typeof config?.input === "object" && config.input !== null && "path" in config.input;
-}
 /**
 * Kubb code-generation instance bound to a single config entry. Resolves the user
 * config during `setup()` and shares `hooks`, `storage`, `driver`, and `config` across
@@ -323,7 +394,7 @@ var Kubb = class {
 	async build() {
 		const out = await this.safeBuild();
 		if (Diagnostics.hasError(out.diagnostics)) {
-			const errors = out.diagnostics.filter(isProblemDiagnostic).filter((diagnostic) => diagnostic.severity === "error").map((diagnostic) => diagnostic.cause ?? new DiagnosticError(diagnostic));
+			const errors = out.diagnostics.filter(Diagnostics.isProblem).filter((diagnostic) => diagnostic.severity === "error").map((diagnostic) => diagnostic.cause ?? new Diagnostics.Error(diagnostic));
 			throw new BuildError(`Build failed with ${errors.length} ${errors.length === 1 ? "error" : "errors"}`, { errors });
 		}
 		return out;
@@ -385,8 +456,8 @@ function createKubb(userConfig, options = {}) {
 //#endregion
 //#region src/createReporter.ts
 /**
-* Defines a reporter. When the definition has a `flush`, the returned reporter buffers each value
-* `report` returns and hands the array to `flush` once, then clears it. Without a `flush`, nothing
+* Defines a reporter. When the definition has a `drain`, the returned reporter buffers each value
+* `report` returns and hands the array to `drain` once, then clears it. Without a `drain`, nothing
 * is buffered. Wiring the reporter onto the run's events is the host's job, so the reporter only
 * ever deals with a {@link GenerationResult}.
 *
@@ -399,17 +470,19 @@ function createKubb(userConfig, options = {}) {
 *   report(result) {
 *     return { status: Diagnostics.hasError(result.diagnostics) ? 'failed' : 'success', diagnostics: result.diagnostics }
 *   },
-*   flush(context, reports) {
+*   drain(context, reports) {
 *     process.stdout.write(`${JSON.stringify(reports, null, 2)}\n`)
 *   },
 * })
 * ```
 */
 function createReporter(reporter) {
-	const flush = reporter.flush;
-	if (!flush) return {
+	const drain = reporter.drain;
+	if (!drain) return {
 		name: reporter.name,
-		report: reporter.report
+		async report(result, context) {
+			await reporter.report(result, context);
+		}
 	};
 	const reports = [];
 	return {
@@ -417,12 +490,409 @@ function createReporter(reporter) {
 		async report(result, context) {
 			reports.push(await reporter.report(result, context));
 		},
-		async flush(context) {
-			await flush(context, reports);
+		async drain(context) {
+			await drain(context, reports);
 			reports.length = 0;
 		}
 	};
 }
+/**
+* Picks the reporters whose `name` matches one of `names`, in the order the names are given.
+* The config carries every available reporter, and the host selects which to activate by name
+* (the CLI maps `--reporter` to this). Duplicate names and names without a matching reporter are
+* skipped.
+*/
+function selectReporters(reporters, names) {
+	const seen = /* @__PURE__ */ new Set();
+	const selected = [];
+	for (const name of names) {
+		if (seen.has(name)) continue;
+		seen.add(name);
+		const reporter = reporters.find((candidate) => candidate.name === name);
+		if (reporter) selected.push(reporter);
+	}
+	return selected;
+}
+//#endregion
+//#region src/defineLogger.ts
+/**
+* Numeric log-level thresholds used internally to compare verbosity.
+*
+* Higher numbers are more verbose.
+*/
+const logLevel = {
+	silent: Number.NEGATIVE_INFINITY,
+	error: 0,
+	warn: 1,
+	info: 3,
+	verbose: 4
+};
+/**
+* Defines a typed logger. Use the second type parameter to declare a return
+* value from `install`, which is handy when the logger exposes a sink factory
+* or cleanup callback to the caller.
+*
+* @example Basic logger
+* ```ts
+* import { defineLogger } from '@kubb/core'
+*
+* export const myLogger = defineLogger({
+*   name: 'my-logger',
+*   install(context) {
+*     context.on('kubb:info', ({ message }) => console.log('ℹ', message))
+*     context.on('kubb:error', ({ error }) => console.error('✗', error.message))
+*   },
+* })
+* ```
+*
+* @example Logger that returns a hook sink factory
+* ```ts
+* import { defineLogger, type LoggerOptions } from '@kubb/core'
+* import type { HookSinkFactory } from './sinks'
+*
+* export const myLogger = defineLogger<LoggerOptions, HookSinkFactory>({
+*   name: 'my-logger',
+*   install(context) {
+*     // … register event handlers …
+*     return () => ({ onStdout: console.log })
+*   },
+* })
+* ```
+*/
+function defineLogger(logger) {
+	return logger;
+}
+//#endregion
+//#region src/reporters/report.ts
+/**
+* Builds the normalized {@link Report} for one config from its {@link GenerationResult}. Splits the
+* diagnostics into problems and per-plugin timings (slowest first) and derives the plugin and issue
+* counts, so every reporter renders the same data.
+*/
+function buildReport(result) {
+	const { config, diagnostics, filesCreated, status, hrStart } = result;
+	const failed = Diagnostics.failedPlugins(diagnostics);
+	const total = config.plugins?.length ?? 0;
+	const counts = Diagnostics.count(diagnostics);
+	const problems = diagnostics.filter(Diagnostics.isProblem);
+	const timings = diagnostics.filter(Diagnostics.isPerformance).sort((a, b) => b.duration - a.duration).map((diagnostic) => ({
+		plugin: diagnostic.plugin,
+		durationMs: diagnostic.duration
+	}));
+	return {
+		name: config.name ?? "",
+		status,
+		plugins: {
+			passed: total - failed.length,
+			failed,
+			total
+		},
+		counts,
+		filesCreated,
+		durationMs: getElapsedMs(hrStart),
+		output: resolve(config.root, config.output.path),
+		timings,
+		diagnostics: problems.map((diagnostic) => Diagnostics.serialize(diagnostic))
+	};
+}
+//#endregion
+//#region src/reporters/cliReporter.ts
+/**
+* Builds the vitest/jest-style summary for one {@link Report}: right-aligned dim labels with
+* `N passed (total)` counts, and a per-plugin `Timings` section when `showTimings`.
+*/
+function buildSummaryLines(report, { showTimings }) {
+	const { status, plugins, counts, filesCreated, durationMs, output, timings } = report;
+	const rows = [];
+	rows.push(["Plugins", status === "success" ? `${styleText("green", `${plugins.passed} passed`)} (${plugins.total})` : `${styleText("green", `${plugins.passed} passed`)} | ${styleText("red", `${plugins.failed.length} failed`)} (${plugins.total})`]);
+	if (status === "failed" && plugins.failed.length > 0) rows.push(["Failed", plugins.failed.map((name) => randomCliColor(name)).join(", ")]);
+	if (counts.errors > 0 || counts.warnings > 0) {
+		const issues = [counts.errors > 0 ? styleText("red", `${counts.errors} ${counts.errors === 1 ? "error" : "errors"}`) : void 0, counts.warnings > 0 ? styleText("yellow", `${counts.warnings} ${counts.warnings === 1 ? "warning" : "warnings"}`) : void 0].filter(Boolean).join(" | ");
+		rows.push(["Issues", issues]);
+	}
+	rows.push(["Files", `${styleText("green", String(filesCreated))} generated`]);
+	rows.push(["Duration", styleText("green", formatMs(durationMs))]);
+	rows.push(["Output", output]);
+	const labelWidth = Math.max(...rows.map(([label]) => label.length), timings.length > 0 ? 7 : 0);
+	const lines = rows.map(([label, value]) => `${styleText("dim", label.padStart(labelWidth))}  ${value}`);
+	if (showTimings && timings.length > 0) {
+		const nameWidth = Math.max(0, ...timings.map((timing) => timing.plugin.length));
+		const indent = " ".repeat(labelWidth + 2);
+		lines.push(styleText("dim", "Timings".padStart(labelWidth)));
+		for (const timing of timings) {
+			const timeStr = formatMs(timing.durationMs);
+			const barLength = Math.min(Math.ceil(timing.durationMs / 100), 10);
+			const bar = styleText("dim", "█".repeat(barLength));
+			lines.push(`${indent}${styleText("dim", "•")} ${timing.plugin.padEnd(nameWidth)} ${bar} ${timeStr}`);
+		}
+	}
+	return lines;
+}
+/**
+* Renders the summary as plain `console.log` lines so it works in every CLI (no clack/TTY
+* dependency): a blank line, the config name colored by status, then the summary rows.
+*/
+function renderSummary(lines, { title, status }) {
+	console.log("");
+	if (title) console.log(styleText(status === "failed" ? "red" : "green", title));
+	for (const line of lines) console.log(line);
+}
+/**
+* The default `cli` reporter. Renders the {@link Report} for each config as it finishes, independent
+* of the live logger view. Suppressed at `silent`; the `verbose` level adds the per-plugin timings.
+*/
+const cliReporter = createReporter({
+	name: "cli",
+	report(result, { logLevel: logLevel$1 }) {
+		if (logLevel$1 <= logLevel.silent) return;
+		const report = buildReport(result);
+		renderSummary(buildSummaryLines(report, { showTimings: logLevel$1 >= logLevel.verbose }), {
+			title: report.name,
+			status: report.status
+		});
+	}
+});
+//#endregion
+//#region src/reporters/fileReporter.ts
+/**
+* Builds the `## Summary` section: the same counts the cli and json reporters expose, as a list of
+* `label  value` rows with the labels padded to a common width.
+*/
+function buildSummarySection(report) {
+	const { status, plugins, counts, filesCreated, durationMs, output } = report;
+	const rows = [["Status", status], ["Plugins", status === "success" ? `${plugins.passed} passed (${plugins.total})` : `${plugins.passed} passed | ${plugins.failed.length} failed (${plugins.total})`]];
+	if (plugins.failed.length > 0) rows.push(["Failed", plugins.failed.join(", ")]);
+	rows.push(["Issues", `${counts.errors} errors | ${counts.warnings} warnings | ${counts.infos} infos`]);
+	rows.push(["Files", `${filesCreated} generated`]);
+	rows.push(["Duration", formatMs(durationMs)]);
+	rows.push(["Output", output]);
+	const labelWidth = Math.max(...rows.map(([label]) => label.length));
+	return [
+		"## Summary",
+		"",
+		...rows.map(([label, value]) => `  ${label.padEnd(labelWidth)}  ${value}`)
+	];
+}
+/**
+* Builds the `## Problems` section: each problem rendered in the miette block format, blocks
+* separated by a blank line. Returns an empty array when there are no problems, so the caller
+* can drop the heading.
+*/
+function buildProblemSection(diagnostics) {
+	const problems = diagnostics.filter(Diagnostics.isProblem);
+	if (problems.length === 0) return [];
+	return [
+		"## Problems",
+		"",
+		problems.map((diagnostic) => Diagnostics.formatLines(diagnostic).join("\n")).join("\n\n")
+	];
+}
+/**
+* Builds the `## Timings` section from a {@link Report}: one `plugin   duration` row per record,
+* slowest first with the plugin names left-aligned and the durations right-aligned. Returns an
+* empty array when there are no timings.
+*/
+function buildTimingSection(report) {
+	const { timings } = report;
+	if (timings.length === 0) return [];
+	const nameWidth = Math.max(...timings.map((timing) => timing.plugin.length));
+	const durations = timings.map((timing) => formatMs(timing.durationMs));
+	const durationWidth = Math.max(...durations.map((duration) => duration.length));
+	return [
+		"## Timings",
+		"",
+		...timings.map((timing, index) => `  ${timing.plugin.padEnd(nameWidth)}  ${durations[index].padStart(durationWidth)}`)
+	];
+}
+/**
+* The `file` reporter. Writes a config's {@link Report} to `.kubb/kubb-<name>-<timestamp>.log` as a
+* plain-text document: a `# <name> — <timestamp>` header, a `## Summary` with the same counts the
+* cli and json reporters expose, a `## Problems` section in the miette block format, and a
+* `## Timings` section. Selected with `--reporter file` (or `reporters: ['file']`), replacing the
+* old `--debug` flag.
+*
+* @note Unlike the streaming logger it replaced, it captures the collected diagnostics once a
+* config finishes, not the live `kubb:info`/`kubb:plugin` event stream. Color is stripped so the
+* file stays plain text even when the run is attached to a TTY.
+*/
+const fileReporter = createReporter({
+	name: "file",
+	async report(result) {
+		const { diagnostics, config } = result;
+		if (diagnostics.length === 0) return;
+		const report = buildReport(result);
+		const content = stripVTControlCharacters([config.name ? `# ${config.name} — ${(/* @__PURE__ */ new Date()).toISOString()}` : `# ${(/* @__PURE__ */ new Date()).toISOString()}`, ...[
+			buildSummarySection(report),
+			buildProblemSection(diagnostics),
+			buildTimingSection(report)
+		].filter((section) => section.length > 0).map((section) => section.join("\n"))].join("\n\n"));
+		const baseName = `${[
+			"kubb",
+			config.name,
+			Date.now()
+		].filter(Boolean).join("-")}.log`;
+		const pathName = resolve(process$1.cwd(), ".kubb", baseName);
+		await write(pathName, `${content}\n`);
+		console.error(`Debug log written to ${relative(process$1.cwd(), pathName)}`);
+	}
+});
+//#endregion
+//#region src/reporters/jsonReporter.ts
+/**
+* The `json` reporter. `report` returns one config's {@link Report}, which {@link createReporter}
+* buffers, and `drain` writes them as a single pretty-printed JSON array on `kubb:lifecycle:end`.
+* Buffering keeps a multi-config run one valid JSON document on stdout instead of concatenated
+* objects that would break `jq .`. The terminal reporter is suppressed while `json` is active so
+* stdout stays valid JSON.
+*/
+const jsonReporter = createReporter({
+	name: "json",
+	report(result) {
+		return buildReport(result);
+	},
+	drain(_context, reports) {
+		process$1.stdout.write(`${JSON.stringify(reports, null, 2)}\n`);
+	}
+});
+//#endregion
+//#region src/Telemetry.ts
+/**
+* Anonymous OTLP usage telemetry for the Kubb run. All methods are static, so call them as
+* `Telemetry.build(...)`, `Telemetry.send(...)`, and `Telemetry.isDisabled()`. No file paths,
+* OpenAPI specs, or secrets are ever included, and sending fails silently to never break a run.
+*/
+var Telemetry = class Telemetry {
+	/**
+	* Returns `true` when telemetry is disabled via `DO_NOT_TRACK` or `KUBB_DISABLE_TELEMETRY`.
+	*/
+	static isDisabled() {
+		return process$1.env["DO_NOT_TRACK"] === "1" || process$1.env["DO_NOT_TRACK"] === "true" || process$1.env["KUBB_DISABLE_TELEMETRY"] === "1" || process$1.env["KUBB_DISABLE_TELEMETRY"] === "true";
+	}
+	/**
+	* Build an anonymous telemetry payload from a completed generation run.
+	*/
+	static build(options) {
+		const [seconds, nanoseconds] = process$1.hrtime(options.hrStart);
+		const duration = Math.round(seconds * 1e3 + nanoseconds / 1e6);
+		return {
+			command: options.command,
+			kubbVersion: options.kubbVersion,
+			nodeVersion: process$1.versions.node.split(".")[0],
+			platform: os.platform(),
+			ci: isCIEnvironment(),
+			plugins: options.plugins ?? [],
+			duration,
+			filesCreated: options.filesCreated ?? 0,
+			status: options.status
+		};
+	}
+	/**
+	* Convert a {@link TelemetryEvent} into an OTLP-compatible JSON trace payload.
+	* See https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/
+	*/
+	static buildOtlpPayload(event) {
+		const traceId = randomBytes(16).toString("hex");
+		const spanId = randomBytes(8).toString("hex");
+		const endTimeNs = BigInt(Date.now()) * 1000000n;
+		const startTimeNs = endTimeNs - BigInt(event.duration) * 1000000n;
+		const attributes = [
+			{
+				key: "kubb.command",
+				value: { stringValue: event.command }
+			},
+			{
+				key: "kubb.version",
+				value: { stringValue: event.kubbVersion }
+			},
+			{
+				key: "kubb.node_version",
+				value: { stringValue: event.nodeVersion }
+			},
+			{
+				key: "kubb.platform",
+				value: { stringValue: event.platform }
+			},
+			{
+				key: "kubb.ci",
+				value: { boolValue: event.ci }
+			},
+			{
+				key: "kubb.files_created",
+				value: { intValue: event.filesCreated }
+			},
+			{
+				key: "kubb.status",
+				value: { stringValue: event.status }
+			},
+			{
+				key: "kubb.plugins",
+				value: { arrayValue: { values: event.plugins.map((p) => ({ kvlistValue: { values: [{
+					key: "name",
+					value: { stringValue: p.name }
+				}, {
+					key: "options",
+					value: { stringValue: JSON.stringify({
+						...p.options,
+						usedEnumNames: void 0
+					}) }
+				}] } })) } }
+			}
+		];
+		return { resourceSpans: [{
+			resource: { attributes: [
+				{
+					key: "service.name",
+					value: { stringValue: "kubb-core" }
+				},
+				{
+					key: "service.version",
+					value: { stringValue: event.kubbVersion }
+				},
+				{
+					key: "telemetry.sdk.language",
+					value: { stringValue: "nodejs" }
+				}
+			] },
+			scopeSpans: [{
+				scope: {
+					name: "kubb-core",
+					version: event.kubbVersion
+				},
+				spans: [{
+					traceId,
+					spanId,
+					name: event.command,
+					kind: 1,
+					startTimeUnixNano: String(startTimeNs),
+					endTimeUnixNano: String(endTimeNs),
+					attributes,
+					status: { code: event.status === "success" ? 1 : 2 }
+				}]
+			}]
+		}] };
+	}
+	/**
+	* Send an anonymous telemetry event to the Kubb OTLP endpoint. Respects `DO_NOT_TRACK` and
+	* `KUBB_DISABLE_TELEMETRY`, and fails silently so telemetry never interrupts a run.
+	*/
+	static async send(event) {
+		if (Telemetry.isDisabled()) return;
+		await executeIfOnline(async () => {
+			try {
+				await fetch(`${OTLP_ENDPOINT}/v1/traces`, {
+					method: "POST",
+					headers: {
+						"Content-Type": "application/json",
+						"Kubb-Telemetry-Version": "1",
+						"Kubb-Telemetry-Source": "kubb-core"
+					},
+					body: JSON.stringify(Telemetry.buildOtlpPayload(event)),
+					signal: AbortSignal.timeout(5e3)
+				});
+			} catch (_e) {}
+		});
+	}
+};
 //#endregion
 //#region src/createRenderer.ts
 /**
@@ -498,43 +968,6 @@ function defineGenerator(generator) {
 	return generator;
 }
 //#endregion
-//#region src/defineLogger.ts
-/**
-* Defines a typed logger. Use the second type parameter to declare a return
-* value from `install`, which is handy when the logger exposes a sink factory
-* or cleanup callback to the caller.
-*
-* @example Basic logger
-* ```ts
-* import { defineLogger } from '@kubb/core'
-*
-* export const myLogger = defineLogger({
-*   name: 'my-logger',
-*   install(context) {
-*     context.on('kubb:info', ({ message }) => console.log('ℹ', message))
-*     context.on('kubb:error', ({ error }) => console.error('✗', error.message))
-*   },
-* })
-* ```
-*
-* @example Logger that returns a hook sink factory
-* ```ts
-* import { defineLogger, type LoggerOptions } from '@kubb/core'
-* import type { HookSinkFactory } from './sinks'
-*
-* export const myLogger = defineLogger<LoggerOptions, HookSinkFactory>({
-*   name: 'my-logger',
-*   install(context) {
-*     // … register event handlers …
-*     return () => ({ onStdout: console.log })
-*   },
-* })
-* ```
-*/
-function defineLogger(logger) {
-	return logger;
-}
-//#endregion
 //#region src/defineMiddleware.ts
 /**
 * Creates a middleware factory. Middleware fires after every plugin handler
@@ -606,56 +1039,6 @@ function defineParser(parser) {
 	return parser;
 }
 //#endregion
-//#region src/storages/memoryStorage.ts
-/**
-* In-memory storage driver. Useful for testing and dry-run scenarios where
-* generated output should be captured without touching the filesystem.
-*
-* All data lives in a `Map` scoped to the storage instance and is discarded
-* when the instance is garbage-collected.
-*
-* @example
-* ```ts
-* import { memoryStorage } from '@kubb/core'
-* import { defineConfig } from 'kubb'
-*
-* export default defineConfig({
-*   input:  { path: './petStore.yaml' },
-*   output: { path: './src/gen' },
-*   storage: memoryStorage(),
-* })
-* ```
-*/
-const memoryStorage = createStorage(() => {
-	const store = /* @__PURE__ */ new Map();
-	return {
-		name: "memory",
-		async hasItem(key) {
-			return store.has(key);
-		},
-		async getItem(key) {
-			return store.get(key) ?? null;
-		},
-		async setItem(key, value) {
-			store.set(key, value);
-		},
-		async removeItem(key) {
-			store.delete(key);
-		},
-		async getKeys(base) {
-			const keys = [...store.keys()];
-			return base ? keys.filter((k) => k.startsWith(base)) : keys;
-		},
-		async clear(base) {
-			if (!base) {
-				store.clear();
-				return;
-			}
-			for (const key of store.keys()) if (key.startsWith(base)) store.delete(key);
-		}
-	};
-});
-//#endregion
-export { AsyncEventEmitter, DiagnosticError, Diagnostics, FileManager, FileProcessor, KubbDriver, URLPath, ast, createAdapter, createKubb, createRenderer, createReporter, createStorage, defineGenerator, defineLogger, defineMiddleware, defineParser, definePlugin, defineResolver, diagnosticCatalog, diagnosticCode, fsStorage, isInputPath, isPerformanceDiagnostic, isProblemDiagnostic, isUpdateDiagnostic, logLevel, memoryStorage, narrowDiagnostic };
+export { AsyncEventEmitter, Diagnostics, KubbDriver, Telemetry, ast, cliReporter, createAdapter, createKubb, createRenderer, createReporter, createStorage, defineGenerator, defineLogger, defineMiddleware, defineParser, definePlugin, defineResolver, fileReporter, fsStorage, jsonReporter, logLevel, memoryStorage, selectReporters };
 
 //# sourceMappingURL=index.js.map