@kubb/cli 5.0.0-beta.50 → 5.0.0-beta.52

package/dist/Telemetry-BZH4YIxq.js

@@ -0,0 +1,312 @@
+import "./chunk-C0LytTxp.js";
+import { randomBytes } from "node:crypto";
+import { promises } from "node:dns";
+import os from "node:os";
+import process$1 from "node:process";
+//#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);
+}
+/**
+* Returns `true` when the process has an interactive TTY with a valid terminal
+* width and is not running in CI.
+*
+* Some IDE-embedded terminals report `isTTY = true` but set `columns` to `0`,
+* which breaks clack's box-drawing helpers (they call `String.prototype.repeat`
+* with a negative count and throw a `RangeError`).  We therefore require a
+* positive column count before declaring the TTY usable.
+*
+* @example
+* ```ts
+* if (canUseTTY()) {
+*   renderProgressBar()
+* }
+* ```
+*/
+function canUseTTY() {
+	return !!process.stdout.isTTY && (process.stdout.columns ?? 0) > 0 && !isCIEnvironment();
+}
+//#endregion
+//#region ../../internals/utils/src/network.ts
+/**
+* Well-known stable domains used as DNS probes to check internet connectivity.
+*/
+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 ../../internals/utils/src/runtime.ts
+/**
+* Returns `true` when the current process is running under Bun.
+*
+* Detection keys off the global `Bun` object rather than `process.versions`,
+* because Bun polyfills `process.versions.node` for Node compatibility and would
+* otherwise look like Node.
+*
+* @example
+* ```ts
+* if (isBun()) {
+*   await Bun.write(path, data)
+* }
+* ```
+*/
+function isBun() {
+	return typeof Bun !== "undefined";
+}
+/**
+* Returns `true` when the current process is running under Deno.
+*/
+function isDeno() {
+	return typeof globalThis.Deno !== "undefined";
+}
+/**
+* Returns the name of the runtime executing the current process.
+*
+* @example
+* ```ts
+* getRuntimeName() // 'bun' when run with `bun kubb`, 'node' otherwise
+* ```
+*/
+function getRuntimeName() {
+	if (isBun()) return "bun";
+	if (isDeno()) return "deno";
+	return "node";
+}
+/**
+* Returns the version of the active runtime, or an empty string when it cannot be read.
+*
+* @example
+* ```ts
+* getRuntimeVersion() // '1.3.11' under Bun, '22.22.2' under Node
+* ```
+*/
+function getRuntimeVersion() {
+	if (isBun()) return process.versions.bun ?? "";
+	if (isDeno()) return globalThis.Deno?.version?.deno ?? "";
+	return process.versions?.node ?? "";
+}
+//#endregion
+//#region src/constants.ts
+/**
+* NPM registry endpoint used to check for @kubb/cli updates.
+*/
+const KUBB_NPM_PACKAGE_URL = "https://registry.npmjs.org/@kubb/cli/latest";
+/**
+* OpenTelemetry ingestion endpoint for anonymous usage telemetry.
+*/
+const OTLP_ENDPOINT = "https://otlp.kubb.dev";
+/**
+* Glob pattern for paths the file watcher ignores.
+*/
+const WATCHER_IGNORED_PATHS = "**/{.git,node_modules}/**";
+/**
+* Flags that short-circuit execution (help/version), no telemetry notice is shown.
+*/
+const QUIET_FLAGS = new Set([
+	"--help",
+	"-h",
+	"--version",
+	"-v"
+]);
+//#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],
+			runtime: getRuntimeName(),
+			runtimeVersion: getRuntimeVersion().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.runtime",
+				value: { stringValue: event.runtime }
+			},
+			{
+				key: "kubb.runtime_version",
+				value: { stringValue: event.runtimeVersion }
+			},
+			{
+				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
+export { executeIfOnline as a, WATCHER_IGNORED_PATHS as i, KUBB_NPM_PACKAGE_URL as n, canUseTTY as o, QUIET_FLAGS as r, Telemetry as t };
+
+//# sourceMappingURL=Telemetry-BZH4YIxq.js.map

package/dist/Telemetry-BZH4YIxq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Telemetry-BZH4YIxq.js","names":["dnsPromises","process"],"sources":["../../../internals/utils/src/env.ts","../../../internals/utils/src/network.ts","../../../internals/utils/src/runtime.ts","../src/constants.ts","../src/Telemetry.ts"],"sourcesContent":["/**\n * Returns `true` when the process is running in a CI environment.\n * Covers GitHub Actions, GitLab CI, CircleCI, Travis CI, Jenkins, Bitbucket,\n * TeamCity, Buildkite, and Azure Pipelines.\n *\n * @example\n * ```ts\n * if (isCIEnvironment()) {\n *   logger.level = 'error'\n * }\n * ```\n */\nexport function isCIEnvironment(): boolean {\n  return !!(\n    process.env.CI ||\n    process.env.GITHUB_ACTIONS ||\n    process.env.GITLAB_CI ||\n    process.env.BITBUCKET_BUILD_NUMBER ||\n    process.env.JENKINS_URL ||\n    process.env.CIRCLECI ||\n    process.env.TRAVIS ||\n    process.env.TEAMCITY_VERSION ||\n    process.env.BUILDKITE ||\n    process.env.TF_BUILD\n  )\n}\n\n/**\n * Returns `true` when the process has an interactive TTY with a valid terminal\n * width and is not running in CI.\n *\n * Some IDE-embedded terminals report `isTTY = true` but set `columns` to `0`,\n * which breaks clack's box-drawing helpers (they call `String.prototype.repeat`\n * with a negative count and throw a `RangeError`).  We therefore require a\n * positive column count before declaring the TTY usable.\n *\n * @example\n * ```ts\n * if (canUseTTY()) {\n *   renderProgressBar()\n * }\n * ```\n */\nexport function canUseTTY(): boolean {\n  return !!process.stdout.isTTY && (process.stdout.columns ?? 0) > 0 && !isCIEnvironment()\n}\n","import { promises as dnsPromises } from 'node:dns'\n\n/**\n * Well-known stable domains used as DNS probes to check internet connectivity.\n */\nconst TEST_DOMAINS = ['dns.google.com', 'cloudflare.com', 'one.one.one.one'] as const\n\n/**\n * Returns `true` when the system has internet connectivity.\n * Probes DNS resolution against well-known stable domains.\n *\n * @example\n * ```ts\n * if (await isOnline()) {\n *   await fetchLatestVersion()\n * }\n * ```\n */\nexport async function isOnline(): Promise<boolean> {\n  for (const domain of TEST_DOMAINS) {\n    try {\n      await dnsPromises.resolve(domain)\n      return true\n    } catch {\n      // Try next domain\n    }\n  }\n\n  return false\n}\n\n/**\n * Executes `fn` only when the system is online. Returns `null` when offline or on error.\n *\n * @example\n * ```ts\n * const version = await executeIfOnline(() => fetchLatestVersion('kubb'))\n * // null when offline\n * ```\n */\nexport async function executeIfOnline<T>(fn: () => Promise<T>): Promise<T | null> {\n  if (!(await isOnline())) return null\n\n  try {\n    return await fn()\n  } catch {\n    return null\n  }\n}\n","/**\n * Name of the JavaScript runtime executing the current process.\n */\nexport type RuntimeName = 'bun' | 'deno' | 'node'\n\n/**\n * Returns `true` when the current process is running under Bun.\n *\n * Detection keys off the global `Bun` object rather than `process.versions`,\n * because Bun polyfills `process.versions.node` for Node compatibility and would\n * otherwise look like Node.\n *\n * @example\n * ```ts\n * if (isBun()) {\n *   await Bun.write(path, data)\n * }\n * ```\n */\nexport function isBun(): boolean {\n  return typeof Bun !== 'undefined'\n}\n\n/**\n * Returns `true` when the current process is running under Deno.\n */\nexport function isDeno(): boolean {\n  return typeof (globalThis as { Deno?: unknown }).Deno !== 'undefined'\n}\n\n/**\n * Returns `true` when the current process is running under Node.\n *\n * Bun and Deno are excluded first so a polyfilled `process` does not register as Node.\n */\nexport function isNode(): boolean {\n  return !isBun() && !isDeno() && typeof process !== 'undefined' && process.versions?.node != null\n}\n\n/**\n * Returns the name of the runtime executing the current process.\n *\n * @example\n * ```ts\n * getRuntimeName() // 'bun' when run with `bun kubb`, 'node' otherwise\n * ```\n */\nexport function getRuntimeName(): RuntimeName {\n  if (isBun()) return 'bun'\n  if (isDeno()) return 'deno'\n  return 'node'\n}\n\n/**\n * Returns the version of the active runtime, or an empty string when it cannot be read.\n *\n * @example\n * ```ts\n * getRuntimeVersion() // '1.3.11' under Bun, '22.22.2' under Node\n * ```\n */\nexport function getRuntimeVersion(): string {\n  if (isBun()) return process.versions.bun ?? ''\n  if (isDeno()) return (globalThis as { Deno?: { version?: { deno?: string } } }).Deno?.version?.deno ?? ''\n  return process.versions?.node ?? ''\n}\n","/**\n * NPM registry endpoint used to check for @kubb/cli updates.\n */\nexport const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const\n\n/**\n * OpenTelemetry ingestion endpoint for anonymous usage telemetry.\n */\nexport const OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const\n\n/**\n * Glob pattern for paths the file watcher ignores.\n */\nexport const WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const\n\n/**\n * Flags that short-circuit execution (help/version), no telemetry notice is shown.\n */\nexport const QUIET_FLAGS = new Set(['--help', '-h', '--version', '-v'] as const)\n","import { randomBytes } from 'node:crypto'\nimport os from 'node:os'\nimport process from 'node:process'\nimport { executeIfOnline, getRuntimeName, getRuntimeVersion, isCIEnvironment, type RuntimeName } from '@internals/utils'\nimport { OTLP_ENDPOINT } from './constants.ts'\n\n// OpenTelemetry OTLP JSON types\n// https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto\n// https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/common/v1/common.proto\n\ntype OtlpStringValue = { stringValue: string }\ntype OtlpBoolValue = { boolValue: boolean }\ntype OtlpIntValue = { intValue: number }\ntype OtlpDoubleValue = { doubleValue: number }\ntype OtlpBytesValue = { bytesValue: string }\ntype OtlpArrayValue = { arrayValue: { values: Array<OtlpAnyValue> } }\ntype OtlpKvListValue = { kvlistValue: { values: Array<OtlpKeyValue> } }\n\ntype OtlpAnyValue = OtlpStringValue | OtlpBoolValue | OtlpIntValue | OtlpDoubleValue | OtlpBytesValue | OtlpArrayValue | OtlpKvListValue\n\ntype OtlpKeyValue = {\n  key: string\n  value: OtlpAnyValue\n}\n\ntype OtlpResource = {\n  attributes: Array<OtlpKeyValue>\n  droppedAttributesCount?: number\n}\n\ntype OtlpInstrumentationScope = {\n  name: string\n  version?: string\n  attributes?: Array<OtlpKeyValue>\n  droppedAttributesCount?: number\n}\n\n/** https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto#L103 */\ntype OtlpSpanKind = 0 | 1 | 2 | 3 | 4 | 5\n\n/** 0 = STATUS_CODE_UNSET, 1 = STATUS_CODE_OK, 2 = STATUS_CODE_ERROR */\ntype OtlpStatusCode = 0 | 1 | 2\n\ntype OtlpStatus = {\n  code: OtlpStatusCode\n  message?: string\n}\n\ntype OtlpSpan = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  parentSpanId?: string\n  name: string\n  kind: OtlpSpanKind\n  startTimeUnixNano: string\n  endTimeUnixNano: string\n  attributes?: Array<OtlpKeyValue>\n  droppedAttributesCount?: number\n  events?: Array<OtlpSpanEvent>\n  droppedEventsCount?: number\n  links?: Array<OtlpSpanLink>\n  droppedLinksCount?: number\n  status?: OtlpStatus\n}\n\ntype OtlpSpanEvent = {\n  timeUnixNano: string\n  name: string\n  attributes?: Array<OtlpKeyValue>\n  droppedAttributesCount?: number\n}\n\ntype OtlpSpanLink = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  attributes?: Array<OtlpKeyValue>\n  droppedAttributesCount?: number\n}\n\ntype OtlpScopeSpans = {\n  scope: OtlpInstrumentationScope\n  spans: Array<OtlpSpan>\n  schemaUrl?: string\n}\n\ntype OtlpResourceSpans = {\n  resource: OtlpResource\n  scopeSpans: Array<OtlpScopeSpans>\n  schemaUrl?: string\n}\n\n/** Root payload sent to POST /v1/traces */\ntype OtlpExportTraceServiceRequest = {\n  resourceSpans: Array<OtlpResourceSpans>\n}\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 plugin options snapshot, values are included but cannot be traced back to the user.\n   */\n  options: Record<string, unknown>\n}\n\nexport type TelemetryEvent = {\n  command: string\n  kubbVersion: string\n  nodeVersion: string\n  /**\n   * Name of the JavaScript runtime that executed the run, `'bun'`, `'deno'`, or `'node'`.\n   */\n  runtime: RuntimeName\n  /**\n   * Major version of the active runtime, e.g. `'1'` under Bun or `'22'` under Node.\n   */\n  runtimeVersion: string\n  platform: string\n  ci: boolean\n  plugins: Array<TelemetryPlugin>\n  duration: number\n  filesCreated: number\n  status: 'success' | 'failed'\n}\n\n/**\n * Anonymous OTLP usage telemetry for the Kubb run. All methods are static, so call them as\n * `Telemetry.build(...)`, `Telemetry.send(...)`, and `Telemetry.isDisabled()`. No file paths,\n * OpenAPI specs, or secrets are ever included, and sending fails silently to never break a run.\n */\nexport class Telemetry {\n  /**\n   * Returns `true` when telemetry is disabled via `DO_NOT_TRACK` or `KUBB_DISABLE_TELEMETRY`.\n   */\n  static isDisabled(): boolean {\n    return (\n      process.env['DO_NOT_TRACK'] === '1' ||\n      process.env['DO_NOT_TRACK'] === 'true' ||\n      process.env['KUBB_DISABLE_TELEMETRY'] === '1' ||\n      process.env['KUBB_DISABLE_TELEMETRY'] === 'true'\n    )\n  }\n\n  /**\n   * Build an anonymous telemetry payload from a completed generation run.\n   */\n  static build(options: {\n    command: 'generate' | 'mcp' | 'validate' | 'agent'\n    kubbVersion: string\n    plugins?: Array<TelemetryPlugin>\n    hrStart: [number, number]\n    filesCreated?: number\n    status: 'success' | 'failed'\n  }): TelemetryEvent {\n    const [seconds, nanoseconds] = process.hrtime(options.hrStart)\n    const duration = Math.round(seconds * 1000 + nanoseconds / 1e6)\n\n    return {\n      command: options.command,\n      kubbVersion: options.kubbVersion,\n      nodeVersion: process.versions.node.split('.')[0] as string,\n      runtime: getRuntimeName(),\n      runtimeVersion: getRuntimeVersion().split('.')[0] as string,\n      platform: os.platform(),\n      ci: isCIEnvironment(),\n      plugins: options.plugins ?? [],\n      duration,\n      filesCreated: options.filesCreated ?? 0,\n      status: options.status,\n    }\n  }\n\n  /**\n   * Convert a {@link TelemetryEvent} into an OTLP-compatible JSON trace payload.\n   * See https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/\n   */\n  static buildOtlpPayload(event: TelemetryEvent): OtlpExportTraceServiceRequest {\n    const traceId = randomBytes(16).toString('hex')\n    const spanId = randomBytes(8).toString('hex')\n    const endTimeNs = BigInt(Date.now()) * 1_000_000n\n    const startTimeNs = endTimeNs - BigInt(event.duration) * 1_000_000n\n\n    const attributes: Array<OtlpKeyValue> = [\n      { key: 'kubb.command', value: { stringValue: event.command } },\n      { key: 'kubb.version', value: { stringValue: event.kubbVersion } },\n      { key: 'kubb.node_version', value: { stringValue: event.nodeVersion } },\n      { key: 'kubb.runtime', value: { stringValue: event.runtime } },\n      { key: 'kubb.runtime_version', value: { stringValue: event.runtimeVersion } },\n      { key: 'kubb.platform', value: { stringValue: event.platform } },\n      { key: 'kubb.ci', value: { boolValue: event.ci } },\n      { key: 'kubb.files_created', value: { intValue: event.filesCreated } },\n      { key: 'kubb.status', value: { stringValue: event.status } },\n      {\n        key: 'kubb.plugins',\n        value: {\n          arrayValue: {\n            values: event.plugins.map(\n              (p): OtlpKvListValue => ({\n                kvlistValue: {\n                  values: [\n                    { key: 'name', value: { stringValue: p.name } },\n                    {\n                      key: 'options',\n                      value: {\n                        stringValue: JSON.stringify({\n                          ...p.options,\n                          usedEnumNames: undefined,\n                        }),\n                      },\n                    },\n                  ],\n                },\n              }),\n            ),\n          },\n        },\n      },\n    ]\n\n    return {\n      resourceSpans: [\n        {\n          resource: {\n            attributes: [\n              { key: 'service.name', value: { stringValue: 'kubb-core' } },\n              {\n                key: 'service.version',\n                value: { stringValue: event.kubbVersion },\n              },\n              { key: 'telemetry.sdk.language', value: { stringValue: 'nodejs' } },\n            ],\n          },\n          scopeSpans: [\n            {\n              scope: { name: 'kubb-core', version: event.kubbVersion },\n              spans: [\n                {\n                  traceId,\n                  spanId,\n                  name: event.command,\n                  kind: 1 satisfies OtlpSpanKind,\n                  startTimeUnixNano: String(startTimeNs),\n                  endTimeUnixNano: String(endTimeNs),\n                  attributes,\n                  status: {\n                    code: (event.status === 'success' ? 1 : 2) satisfies OtlpStatusCode,\n                  },\n                },\n              ],\n            },\n          ],\n        },\n      ],\n    }\n  }\n\n  /**\n   * Send an anonymous telemetry event to the Kubb OTLP endpoint. Respects `DO_NOT_TRACK` and\n   * `KUBB_DISABLE_TELEMETRY`, and fails silently so telemetry never interrupts a run.\n   */\n  static async send(event: TelemetryEvent): Promise<void> {\n    if (Telemetry.isDisabled()) {\n      return\n    }\n\n    await executeIfOnline(async () => {\n      try {\n        await fetch(`${OTLP_ENDPOINT}/v1/traces`, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'Kubb-Telemetry-Version': '1',\n            'Kubb-Telemetry-Source': 'kubb-core',\n          },\n          body: JSON.stringify(Telemetry.buildOtlpPayload(event)),\n          signal: AbortSignal.timeout(5_000),\n        })\n      } catch (_e) {\n        // Fail silently, telemetry must never break the run\n      }\n    })\n  }\n}\n"],"mappings":"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"}

package/dist/Telemetry-DC5WVMB9.cjs

@@ -0,0 +1,349 @@
+const require_chunk = require("./chunk-Bx3C2hgW.cjs");
+let node_crypto = require("node:crypto");
+let node_dns = require("node:dns");
+let node_os = require("node:os");
+node_os = require_chunk.__toESM(node_os, 1);
+let node_process = require("node:process");
+node_process = require_chunk.__toESM(node_process, 1);
+//#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);
+}
+/**
+* Returns `true` when the process has an interactive TTY with a valid terminal
+* width and is not running in CI.
+*
+* Some IDE-embedded terminals report `isTTY = true` but set `columns` to `0`,
+* which breaks clack's box-drawing helpers (they call `String.prototype.repeat`
+* with a negative count and throw a `RangeError`).  We therefore require a
+* positive column count before declaring the TTY usable.
+*
+* @example
+* ```ts
+* if (canUseTTY()) {
+*   renderProgressBar()
+* }
+* ```
+*/
+function canUseTTY() {
+	return !!process.stdout.isTTY && (process.stdout.columns ?? 0) > 0 && !isCIEnvironment();
+}
+//#endregion
+//#region ../../internals/utils/src/network.ts
+/**
+* Well-known stable domains used as DNS probes to check internet connectivity.
+*/
+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 node_dns.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 ../../internals/utils/src/runtime.ts
+/**
+* Returns `true` when the current process is running under Bun.
+*
+* Detection keys off the global `Bun` object rather than `process.versions`,
+* because Bun polyfills `process.versions.node` for Node compatibility and would
+* otherwise look like Node.
+*
+* @example
+* ```ts
+* if (isBun()) {
+*   await Bun.write(path, data)
+* }
+* ```
+*/
+function isBun() {
+	return typeof Bun !== "undefined";
+}
+/**
+* Returns `true` when the current process is running under Deno.
+*/
+function isDeno() {
+	return typeof globalThis.Deno !== "undefined";
+}
+/**
+* Returns the name of the runtime executing the current process.
+*
+* @example
+* ```ts
+* getRuntimeName() // 'bun' when run with `bun kubb`, 'node' otherwise
+* ```
+*/
+function getRuntimeName() {
+	if (isBun()) return "bun";
+	if (isDeno()) return "deno";
+	return "node";
+}
+/**
+* Returns the version of the active runtime, or an empty string when it cannot be read.
+*
+* @example
+* ```ts
+* getRuntimeVersion() // '1.3.11' under Bun, '22.22.2' under Node
+* ```
+*/
+function getRuntimeVersion() {
+	if (isBun()) return process.versions.bun ?? "";
+	if (isDeno()) return globalThis.Deno?.version?.deno ?? "";
+	return process.versions?.node ?? "";
+}
+//#endregion
+//#region src/constants.ts
+/**
+* NPM registry endpoint used to check for @kubb/cli updates.
+*/
+const KUBB_NPM_PACKAGE_URL = "https://registry.npmjs.org/@kubb/cli/latest";
+/**
+* OpenTelemetry ingestion endpoint for anonymous usage telemetry.
+*/
+const OTLP_ENDPOINT = "https://otlp.kubb.dev";
+/**
+* Glob pattern for paths the file watcher ignores.
+*/
+const WATCHER_IGNORED_PATHS = "**/{.git,node_modules}/**";
+/**
+* Flags that short-circuit execution (help/version), no telemetry notice is shown.
+*/
+const QUIET_FLAGS = new Set([
+	"--help",
+	"-h",
+	"--version",
+	"-v"
+]);
+//#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 node_process.default.env["DO_NOT_TRACK"] === "1" || node_process.default.env["DO_NOT_TRACK"] === "true" || node_process.default.env["KUBB_DISABLE_TELEMETRY"] === "1" || node_process.default.env["KUBB_DISABLE_TELEMETRY"] === "true";
+	}
+	/**
+	* Build an anonymous telemetry payload from a completed generation run.
+	*/
+	static build(options) {
+		const [seconds, nanoseconds] = node_process.default.hrtime(options.hrStart);
+		const duration = Math.round(seconds * 1e3 + nanoseconds / 1e6);
+		return {
+			command: options.command,
+			kubbVersion: options.kubbVersion,
+			nodeVersion: node_process.default.versions.node.split(".")[0],
+			runtime: getRuntimeName(),
+			runtimeVersion: getRuntimeVersion().split(".")[0],
+			platform: node_os.default.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 = (0, node_crypto.randomBytes)(16).toString("hex");
+		const spanId = (0, node_crypto.randomBytes)(8).toString("hex");
+		const endTimeNs = BigInt(Date.now()) * 1000000n;
+		const startTimeNs = endTimeNs - BigInt(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.runtime",
+				value: { stringValue: event.runtime }
+			},
+			{
+				key: "kubb.runtime_version",
+				value: { stringValue: event.runtimeVersion }
+			},
+			{
+				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
+Object.defineProperty(exports, "KUBB_NPM_PACKAGE_URL", {
+	enumerable: true,
+	get: function() {
+		return KUBB_NPM_PACKAGE_URL;
+	}
+});
+Object.defineProperty(exports, "QUIET_FLAGS", {
+	enumerable: true,
+	get: function() {
+		return QUIET_FLAGS;
+	}
+});
+Object.defineProperty(exports, "Telemetry", {
+	enumerable: true,
+	get: function() {
+		return Telemetry;
+	}
+});
+Object.defineProperty(exports, "WATCHER_IGNORED_PATHS", {
+	enumerable: true,
+	get: function() {
+		return WATCHER_IGNORED_PATHS;
+	}
+});
+Object.defineProperty(exports, "canUseTTY", {
+	enumerable: true,
+	get: function() {
+		return canUseTTY;
+	}
+});
+Object.defineProperty(exports, "executeIfOnline", {
+	enumerable: true,
+	get: function() {
+		return executeIfOnline;
+	}
+});
+
+//# sourceMappingURL=Telemetry-DC5WVMB9.cjs.map