@kubb/cli 4.29.1 → 4.31.1

package/dist/telemetry-BcdCgNDv.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-BcdCgNDv.cjs","names":["process","os"],"sources":["../src/utils/telemetry.ts"],"sourcesContent":["import { randomBytes } from 'node:crypto'\nimport os from 'node:os'\nimport process from 'node:process'\nimport { executeIfOnline } from '@kubb/core/utils'\n\nconst OTLP_ENDPOINT = 'https://otlp.kubb.dev'\n\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// ---------------------------------------------------------------------------\n\ntype OtlpStringValue = { stringValue: string }\ntype OtlpBoolValue = { boolValue: boolean }\ntype OtlpIntValue = { intValue: number }\ntype OtlpDoubleValue = { doubleValue: number }\ntype OtlpBytesValue = { bytesValue: string }\ntype OtlpArrayValue = { arrayValue: { values: OtlpAnyValue[] } }\ntype OtlpKvListValue = { kvlistValue: { values: OtlpKeyValue[] } }\n\ntype OtlpAnyValue = OtlpStringValue | OtlpBoolValue | OtlpIntValue | OtlpDoubleValue | OtlpBytesValue | OtlpArrayValue | OtlpKvListValue\n\ntype OtlpKeyValue = {\n  key: string\n  value: OtlpAnyValue\n}\n\ntype OtlpResource = {\n  attributes: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpInstrumentationScope = {\n  name: string\n  version?: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\n/** https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto#L103 */\ntype OtlpSpanKind = 0 | 1 | 2 | 3 | 4 | 5\n\n/** 0 = STATUS_CODE_UNSET, 1 = STATUS_CODE_OK, 2 = STATUS_CODE_ERROR */\ntype OtlpStatusCode = 0 | 1 | 2\n\ntype OtlpStatus = {\n  code: OtlpStatusCode\n  message?: string\n}\n\ntype OtlpSpan = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  parentSpanId?: string\n  name: string\n  kind: OtlpSpanKind\n  startTimeUnixNano: string\n  endTimeUnixNano: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n  events?: OtlpSpanEvent[]\n  droppedEventsCount?: number\n  links?: OtlpSpanLink[]\n  droppedLinksCount?: number\n  status?: OtlpStatus\n}\n\ntype OtlpSpanEvent = {\n  timeUnixNano: string\n  name: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpSpanLink = {\n  traceId: string\n  spanId: string\n  traceState?: string\n  attributes?: OtlpKeyValue[]\n  droppedAttributesCount?: number\n}\n\ntype OtlpScopeSpans = {\n  scope: OtlpInstrumentationScope\n  spans: OtlpSpan[]\n  schemaUrl?: string\n}\n\ntype OtlpResourceSpans = {\n  resource: OtlpResource\n  scopeSpans: OtlpScopeSpans[]\n  schemaUrl?: string\n}\n\n/** Root payload sent to POST /v1/traces */\nexport type OtlpExportTraceServiceRequest = {\n  resourceSpans: OtlpResourceSpans[]\n}\n\n// ---------------------------------------------------------------------------\n\nexport type TelemetryPlugin = {\n  name: string\n  options: Record<string, unknown>\n}\n\nexport type TelemetryEvent = {\n  command: string\n  kubbVersion: string\n  nodeVersion: string\n  platform: string\n  ci: boolean\n  plugins: TelemetryPlugin[]\n  duration: number\n  filesCreated: number\n  status: 'success' | 'failed'\n}\n\n/**\n * Detect whether the current process is running inside a CI environment by\n * checking the well-known environment variables set by all major CI systems.\n */\nexport function isCi(): boolean {\n  return !!(\n    (\n      process.env['CI'] || // Generic (GitHub Actions, GitLab CI, CircleCI, Travis CI, etc.)\n      process.env['GITHUB_ACTIONS'] || // GitHub Actions\n      process.env['GITLAB_CI'] || // GitLab CI\n      process.env['BITBUCKET_BUILD_NUMBER'] || // Bitbucket Pipelines\n      process.env['JENKINS_URL'] || // Jenkins\n      process.env['CIRCLECI'] || // CircleCI\n      process.env['TRAVIS'] || // Travis CI\n      process.env['TEAMCITY_VERSION'] || // TeamCity\n      process.env['BUILDKITE'] || // Buildkite\n      process.env['TF_BUILD']\n    ) // Azure Pipelines\n  )\n}\n\n/**\n * Check if telemetry is disabled via DO_NOT_TRACK or KUBB_DISABLE_TELEMETRY.\n * Respects the standard DO_NOT_TRACK convention used across development tools.\n */\nexport function isTelemetryDisabled(): boolean {\n  return (\n    process.env['DO_NOT_TRACK'] === '1' ||\n    process.env['DO_NOT_TRACK'] === 'true' ||\n    process.env['KUBB_DISABLE_TELEMETRY'] === '1' ||\n    process.env['KUBB_DISABLE_TELEMETRY'] === 'true'\n  )\n}\n\n/**\n * Convert a TelemetryEvent into an OTLP-compatible JSON trace payload.\n * See https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/\n */\nexport function buildOtlpPayload(event: TelemetryEvent): OtlpExportTraceServiceRequest {\n  const traceId = randomBytes(16).toString('hex')\n  const spanId = randomBytes(8).toString('hex')\n  const endTimeNs = BigInt(Date.now()) * 1_000_000n\n  const startTimeNs = endTimeNs - BigInt(event.duration) * 1_000_000n\n\n  const attributes: OtlpKeyValue[] = [\n    { key: 'kubb.command', value: { stringValue: event.command } },\n    { key: 'kubb.version', value: { stringValue: event.kubbVersion } },\n    { key: 'kubb.node_version', value: { stringValue: event.nodeVersion } },\n    { key: 'kubb.platform', value: { stringValue: event.platform } },\n    { key: 'kubb.ci', value: { boolValue: event.ci } },\n    { key: 'kubb.files_created', value: { intValue: event.filesCreated } },\n    { key: 'kubb.status', value: { stringValue: event.status } },\n    {\n      key: 'kubb.plugins',\n      value: {\n        arrayValue: {\n          values: event.plugins.map(\n            (p): OtlpKvListValue => ({\n              kvlistValue: {\n                values: [\n                  { key: 'name', value: { stringValue: p.name } },\n                  { key: 'options', value: { stringValue: JSON.stringify({ ...p.options, usedEnumNames: undefined }) } },\n                ],\n              },\n            }),\n          ),\n        },\n      },\n    },\n  ]\n\n  return {\n    resourceSpans: [\n      {\n        resource: {\n          attributes: [\n            { key: 'service.name', value: { stringValue: 'kubb-cli' } },\n            { key: 'service.version', value: { stringValue: event.kubbVersion } },\n            { key: 'telemetry.sdk.language', value: { stringValue: 'nodejs' } },\n          ],\n        },\n        scopeSpans: [\n          {\n            scope: { name: 'kubb-cli', version: event.kubbVersion },\n            spans: [\n              {\n                traceId,\n                spanId,\n                name: event.command,\n                kind: 1 satisfies OtlpSpanKind,\n                startTimeUnixNano: String(startTimeNs),\n                endTimeUnixNano: String(endTimeNs),\n                attributes,\n                status: { code: (event.status === 'success' ? 1 : 2) satisfies OtlpStatusCode },\n              },\n            ],\n          },\n        ],\n      },\n    ],\n  }\n}\n\n/**\n * Send an anonymous telemetry event to the Kubb OTLP endpoint.\n * Respects DO_NOT_TRACK and KUBB_DISABLE_TELEMETRY environment variables.\n * Fails silently to never interrupt the generation process.\n */\nexport async function sendTelemetry(event: TelemetryEvent): Promise<void> {\n  if (isTelemetryDisabled()) {\n    return\n  }\n\n  await executeIfOnline(async () => {\n    try {\n      await fetch(`${OTLP_ENDPOINT}/v1/traces`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'Kubb-Telemetry-Version': '1',\n          'Kubb-Telemetry-Source': 'kubb-cli',\n        },\n        body: JSON.stringify(buildOtlpPayload(event)),\n        signal: AbortSignal.timeout(5_000),\n      })\n    } catch (_e) {\n      // Fail silently – telemetry must never break the CLI\n    }\n  })\n}\n\n/**\n * Build an anonymous telemetry payload from a completed generation run.\n * No file paths, OpenAPI specs, or secrets are included.\n */\nexport function buildTelemetryEvent(options: {\n  command: 'generate' | 'mcp' | 'validate' | 'agent'\n  kubbVersion: string\n  plugins?: TelemetryPlugin[]\n  hrStart: [number, number]\n  filesCreated?: number\n  status: 'success' | 'failed'\n}): TelemetryEvent {\n  const [seconds, nanoseconds] = process.hrtime(options.hrStart)\n  const duration = Math.round(seconds * 1000 + nanoseconds / 1e6)\n\n  return {\n    command: options.command,\n    kubbVersion: options.kubbVersion,\n    nodeVersion: process.versions.node.split('.')[0] ?? 'unknown',\n    platform: os.platform(),\n    ci: isCi(),\n    plugins: options.plugins ?? [],\n    duration,\n    filesCreated: options.filesCreated ?? 0,\n    status: options.status,\n  }\n}\n"],"mappings":"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"}

package/dist/{validate-BgYhe_55.cjs → validate-DSIGR8AG.cjs}

@@ -1,4 +1,6 @@
 const require_chunk = require('./chunk-CNbaEX1y.cjs');
+const require_package = require('./package-BLK3K956.cjs');
+const require_telemetry = require('./telemetry-BcdCgNDv.cjs');
 let citty = require("citty");
 let node_process = require("node:process");
 node_process = require_chunk.__toESM(node_process);
@@ -36,10 +38,23 @@ const command = (0, citty.defineCommand)({
 				node_process.default.exit(1);
 			}
 			const { parse } = mod;
+			const hrStart = node_process.default.hrtime();
 			try {
 				await (await parse(args.input)).validate();
+				await require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
+					command: "validate",
+					kubbVersion: require_package.version,
+					hrStart,
+					status: "success"
+				}));
 				console.log("✅ Validation success");
 			} catch (error) {
+				await require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
+					command: "validate",
+					kubbVersion: require_package.version,
+					hrStart,
+					status: "failed"
+				}));
 				console.error("❌ Validation failed");
 				console.log(error?.message);
 				node_process.default.exit(1);
@@ -50,4 +65,4 @@ const command = (0, citty.defineCommand)({
 
 //#endregion
 exports.default = command;
-//# sourceMappingURL=validate-BgYhe_55.cjs.map
+//# sourceMappingURL=validate-DSIGR8AG.cjs.map

package/dist/validate-DSIGR8AG.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-DSIGR8AG.cjs","names":["jiti","process","sendTelemetry","buildTelemetryEvent","version"],"sources":["../src/commands/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport type { ArgsDef } from 'citty'\nimport { defineCommand, showUsage } from 'citty'\nimport { createJiti } from 'jiti'\nimport { version } from '../../package.json'\nimport { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'\n\nconst jiti = createJiti(import.meta.url, {\n  sourceMaps: true,\n})\n\nconst args = {\n  input: {\n    type: 'string',\n    description: 'Path to Swagger/OpenAPI file',\n    alias: 'i',\n  },\n  help: {\n    type: 'boolean',\n    description: 'Show help',\n    alias: 'h',\n    default: false,\n  },\n} as const satisfies ArgsDef\n\nconst command = defineCommand({\n  meta: {\n    name: 'validate',\n    description: 'Validate a Swagger/OpenAPI file',\n  },\n  args,\n  async run(commandContext) {\n    const { args } = commandContext\n\n    if (args.help) {\n      return showUsage(command)\n    }\n\n    if (args.input) {\n      let mod: any\n      try {\n        mod = await jiti.import('@kubb/oas', { default: true })\n      } catch (_e) {\n        console.error(`Import of '@kubb/oas' is required to do validation`)\n        process.exit(1)\n      }\n\n      const { parse } = mod\n      const hrStart = process.hrtime()\n      try {\n        const oas = await parse(args.input)\n        await oas.validate()\n\n        await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'success' }))\n        console.log('✅ Validation success')\n      } catch (error) {\n        await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'failed' }))\n        console.error('❌ Validation failed')\n        console.log((error as Error)?.message)\n        process.exit(1)\n      }\n    }\n  },\n})\n\nexport default command\n"],"mappings":";;;;;;;;;AAOA,MAAMA,6EAAmC,EACvC,YAAY,MACb,CAAC;AAgBF,MAAM,mCAAwB;CAC5B,MAAM;EACJ,MAAM;EACN,aAAa;EACd;CACD,MAnBW;EACX,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACR;EACD,MAAM;GACJ,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACF;CAQC,MAAM,IAAI,gBAAgB;EACxB,MAAM,EAAE,SAAS;AAEjB,MAAI,KAAK,KACP,6BAAiB,QAAQ;AAG3B,MAAI,KAAK,OAAO;GACd,IAAI;AACJ,OAAI;AACF,UAAM,MAAMA,OAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;YAChD,IAAI;AACX,YAAQ,MAAM,qDAAqD;AACnE,yBAAQ,KAAK,EAAE;;GAGjB,MAAM,EAAE,UAAU;GAClB,MAAM,UAAUC,qBAAQ,QAAQ;AAChC,OAAI;AAEF,WADY,MAAM,MAAM,KAAK,MAAM,EACzB,UAAU;AAEpB,UAAMC,gCAAcC,sCAAoB;KAAE,SAAS;KAAY,aAAaC;KAAS;KAAS,QAAQ;KAAW,CAAC,CAAC;AACnH,YAAQ,IAAI,uBAAuB;YAC5B,OAAO;AACd,UAAMF,gCAAcC,sCAAoB;KAAE,SAAS;KAAY,aAAaC;KAAS;KAAS,QAAQ;KAAU,CAAC,CAAC;AAClH,YAAQ,MAAM,sBAAsB;AACpC,YAAQ,IAAK,OAAiB,QAAQ;AACtC,yBAAQ,KAAK,EAAE;;;;CAItB,CAAC"}

package/dist/{validate-DOeZKiGx.js → validate-tLrVQqUL.js}

@@ -1,4 +1,6 @@
 import { t as __name } from "./chunk-DKWOrOAv.js";
+import { t as version } from "./package-P3yw_Wp4.js";
+import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-4xNBLqQy.js";
 import { defineCommand, showUsage } from "citty";
 import process from "node:process";
 import { createJiti } from "jiti";
@@ -35,10 +37,23 @@ const command = defineCommand({
 				process.exit(1);
 			}
 			const { parse } = mod;
+			const hrStart = process.hrtime();
 			try {
 				await (await parse(args.input)).validate();
+				await sendTelemetry(buildTelemetryEvent({
+					command: "validate",
+					kubbVersion: version,
+					hrStart,
+					status: "success"
+				}));
 				console.log("✅ Validation success");
 			} catch (error) {
+				await sendTelemetry(buildTelemetryEvent({
+					command: "validate",
+					kubbVersion: version,
+					hrStart,
+					status: "failed"
+				}));
 				console.error("❌ Validation failed");
 				console.log(error?.message);
 				process.exit(1);
@@ -49,4 +64,4 @@ const command = defineCommand({
 
 //#endregion
 export { command as default };
-//# sourceMappingURL=validate-DOeZKiGx.js.map
+//# sourceMappingURL=validate-tLrVQqUL.js.map

package/dist/validate-tLrVQqUL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-tLrVQqUL.js","names":[],"sources":["../src/commands/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport type { ArgsDef } from 'citty'\nimport { defineCommand, showUsage } from 'citty'\nimport { createJiti } from 'jiti'\nimport { version } from '../../package.json'\nimport { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'\n\nconst jiti = createJiti(import.meta.url, {\n  sourceMaps: true,\n})\n\nconst args = {\n  input: {\n    type: 'string',\n    description: 'Path to Swagger/OpenAPI file',\n    alias: 'i',\n  },\n  help: {\n    type: 'boolean',\n    description: 'Show help',\n    alias: 'h',\n    default: false,\n  },\n} as const satisfies ArgsDef\n\nconst command = defineCommand({\n  meta: {\n    name: 'validate',\n    description: 'Validate a Swagger/OpenAPI file',\n  },\n  args,\n  async run(commandContext) {\n    const { args } = commandContext\n\n    if (args.help) {\n      return showUsage(command)\n    }\n\n    if (args.input) {\n      let mod: any\n      try {\n        mod = await jiti.import('@kubb/oas', { default: true })\n      } catch (_e) {\n        console.error(`Import of '@kubb/oas' is required to do validation`)\n        process.exit(1)\n      }\n\n      const { parse } = mod\n      const hrStart = process.hrtime()\n      try {\n        const oas = await parse(args.input)\n        await oas.validate()\n\n        await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'success' }))\n        console.log('✅ Validation success')\n      } catch (error) {\n        await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'failed' }))\n        console.error('❌ Validation failed')\n        console.log((error as Error)?.message)\n        process.exit(1)\n      }\n    }\n  },\n})\n\nexport default command\n"],"mappings":";;;;;;;;AAOA,MAAM,OAAO,WAAW,OAAO,KAAK,KAAK,EACvC,YAAY,MACb,CAAC;AAgBF,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,MAAM;EACN,aAAa;EACd;CACD,MAnBW;EACX,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACR;EACD,MAAM;GACJ,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACF;CAQC,MAAM,IAAI,gBAAgB;EACxB,MAAM,EAAE,SAAS;AAEjB,MAAI,KAAK,KACP,QAAO,UAAU,QAAQ;AAG3B,MAAI,KAAK,OAAO;GACd,IAAI;AACJ,OAAI;AACF,UAAM,MAAM,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;YAChD,IAAI;AACX,YAAQ,MAAM,qDAAqD;AACnE,YAAQ,KAAK,EAAE;;GAGjB,MAAM,EAAE,UAAU;GAClB,MAAM,UAAU,QAAQ,QAAQ;AAChC,OAAI;AAEF,WADY,MAAM,MAAM,KAAK,MAAM,EACzB,UAAU;AAEpB,UAAM,cAAc,oBAAoB;KAAE,SAAS;KAAY,aAAa;KAAS;KAAS,QAAQ;KAAW,CAAC,CAAC;AACnH,YAAQ,IAAI,uBAAuB;YAC5B,OAAO;AACd,UAAM,cAAc,oBAAoB;KAAE,SAAS;KAAY,aAAa;KAAS;KAAS,QAAQ;KAAU,CAAC,CAAC;AAClH,YAAQ,MAAM,sBAAsB;AACpC,YAAQ,IAAK,OAAiB,QAAQ;AACtC,YAAQ,KAAK,EAAE;;;;CAItB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/cli",
-  "version": "4.29.1",
+  "version": "4.31.1",
   "description": "Command-line interface for Kubb, enabling easy generation of TypeScript, React-Query, Zod, and other code from OpenAPI specifications.",
   "keywords": [
     "cli",
@@ -42,7 +42,8 @@
     "dist",
     "bin",
     "!/**/**.test.**",
-    "!/**/__tests__/**"
+    "!/**/__tests__/**",
+    "!/**/__snapshots__/**"
   ],
   "size-limit": [
     {
@@ -55,16 +56,16 @@
     "@clack/prompts": "^1.0.1",
     "chokidar": "^5.0.0",
     "citty": "^0.1.6",
-    "cosmiconfig": "^9.0.0",
+    "cosmiconfig": "^9.0.1",
     "jiti": "2.5.1",
     "tinyexec": "^1.0.2",
-    "@kubb/core": "4.29.1"
+    "@kubb/core": "4.31.1"
   },
   "devDependencies": {
     "source-map-support": "^0.5.21",
-    "@kubb/agent": "4.29.1",
-    "@kubb/mcp": "4.29.1",
-    "@kubb/oas": "4.29.1"
+    "@kubb/agent": "4.31.1",
+    "@kubb/mcp": "4.31.1",
+    "@kubb/oas": "4.31.1"
   },
   "engines": {
     "node": ">=20"

package/src/commands/agent/start.ts

@@ -6,6 +6,8 @@ import { styleText } from 'node:util'
 import * as clack from '@clack/prompts'
 import type { ArgsDef } from 'citty'
 import { defineCommand } from 'citty'
+import { version } from '../../../package.json'
+import { buildTelemetryEvent, sendTelemetry } from '../../utils/telemetry.ts'
 
 const args = {
   config: {
@@ -122,6 +124,7 @@ const command = defineCommand({
   args,
   async run(commandContext) {
     const { args } = commandContext
+    const hrStart = process.hrtime()
 
     try {
       const configPath = path.resolve(process.cwd(), args.config || 'kubb.config.ts')
@@ -131,8 +134,10 @@ const command = defineCommand({
       const allowWrite = args['allow-write']
       const allowAll = args['allow-all']
 
-      await startServer({ port, host, configPath, noCache, allowWrite, allowAll })
+      startServer({ port, host, configPath, noCache, allowWrite, allowAll })
+      await sendTelemetry(buildTelemetryEvent({ command: 'agent', kubbVersion: version, hrStart, status: 'success' }))
     } catch (error) {
+      await sendTelemetry(buildTelemetryEvent({ command: 'agent', kubbVersion: version, hrStart, status: 'failed' }))
       clack.log.error(styleText('red', 'Failed to start agent server'))
       console.error(error)
       process.exit(1)

package/src/commands/init.ts

@@ -3,9 +3,10 @@ import path from 'node:path'
 import process from 'node:process'
 import { styleText } from 'node:util'
 import * as clack from '@clack/prompts'
+import { detectPackageManager, type PackageManagerInfo } from '@kubb/core'
 import { defineCommand } from 'citty'
 import { version } from '../../package.json'
-import { detectPackageManager, hasPackageJson, initPackageJson, installPackages, type PackageManagerInfo } from '../utils/packageManager.ts'
+import { hasPackageJson, initPackageJson, installPackages } from '../utils/packageManager.ts'
 
 type PluginOption = {
   value: string

package/src/commands/mcp.ts

@@ -1,7 +1,10 @@
+import process from 'node:process'
 import { styleText } from 'node:util'
 import type { ArgsDef } from 'citty'
 import { defineCommand, showUsage } from 'citty'
 import { createJiti } from 'jiti'
+import { version } from '../../package.json'
+import { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'
 
 const jiti = createJiti(import.meta.url, {
   sourceMaps: true,
@@ -38,11 +41,14 @@ const command = defineCommand({
     }
 
     const { run } = mod
+    const hrStart = process.hrtime()
     try {
       console.log('⏳ Starting MCP server...')
       console.warn(styleText('yellow', 'This feature is still under development — use with caution'))
-      await run()
+      run()
+      await sendTelemetry(buildTelemetryEvent({ command: 'mcp', kubbVersion: version, hrStart, status: 'success' }))
     } catch (error) {
+      await sendTelemetry(buildTelemetryEvent({ command: 'mcp', kubbVersion: version, hrStart, status: 'failed' }))
       console.error((error as Error)?.message)
     }
   },

package/src/commands/validate.ts

@@ -2,6 +2,8 @@ import process from 'node:process'
 import type { ArgsDef } from 'citty'
 import { defineCommand, showUsage } from 'citty'
 import { createJiti } from 'jiti'
+import { version } from '../../package.json'
+import { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'
 
 const jiti = createJiti(import.meta.url, {
   sourceMaps: true,
@@ -44,12 +46,15 @@ const command = defineCommand({
       }
 
       const { parse } = mod
+      const hrStart = process.hrtime()
       try {
         const oas = await parse(args.input)
         await oas.validate()
 
+        await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'success' }))
         console.log('✅ Validation success')
       } catch (error) {
+        await sendTelemetry(buildTelemetryEvent({ command: 'validate', kubbVersion: version, hrStart, status: 'failed' }))
         console.error('❌ Validation failed')
         console.log((error as Error)?.message)
         process.exit(1)

package/src/index.ts

@@ -1,5 +1,7 @@
+import { styleText } from 'node:util'
 import { defineCommand, runCommand, runMain } from 'citty'
 import { version } from '../package.json'
+import { isTelemetryDisabled } from './utils/telemetry.ts'
 
 const main = defineCommand({
   meta: {
@@ -20,6 +22,12 @@ const main = defineCommand({
       process.exit(0)
     }
 
+    if (!isTelemetryDisabled()) {
+      console.log(
+        `${styleText('yellow', 'Notice:')} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \nTo disable, set ${styleText('cyan', 'KUBB_DISABLE_TELEMETRY=1')}.\n`,
+      )
+    }
+
     if (!['generate', 'validate', 'mcp', 'agent', 'init'].includes(rawArgs[0] as string)) {
       // generate is not being used
       const generateCommand = await import('./commands/generate.ts').then((r) => r.default)

package/src/runners/generate.ts

@@ -5,7 +5,9 @@ import { styleText } from 'node:util'
 import { type Config, type KubbEvents, LogLevel, safeBuild, setup } from '@kubb/core'
 import type { AsyncEventEmitter } from '@kubb/core/utils'
 import { detectFormatter, detectLinter, formatters, linters } from '@kubb/core/utils'
+import { version } from '../../package.json'
 import { executeHooks } from '../utils/executeHooks.ts'
+import { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'
 
 type GenerateProps = {
   input?: string
@@ -80,11 +82,22 @@ export async function generate({ input, config: userConfig, events, logLevel }:
     await events.emit('generation:summary', config, {
       failedPlugins,
       filesCreated: files.length,
-      status: failedPlugins.size > 0 || error ? 'failed' : 'success',
+      status: 'failed',
       hrStart,
       pluginTimings: logLevel >= LogLevel.verbose ? pluginTimings : undefined,
     })
 
+    await sendTelemetry(
+      buildTelemetryEvent({
+        command: 'generate',
+        kubbVersion: version,
+        plugins: pluginManager.plugins.map((p) => ({ name: p.name, options: p.options as Record<string, unknown> })),
+        hrStart,
+        filesCreated: files.length,
+        status: 'failed',
+      }),
+    )
+
     process.exit(1)
   }
 
@@ -194,11 +207,24 @@ export async function generate({ input, config: userConfig, events, logLevel }:
     await events.emit('hooks:end')
   }
 
+  const generationStatus = failedPlugins.size > 0 || error ? 'failed' : 'success'
+
   await events.emit('generation:summary', config, {
     failedPlugins,
     filesCreated: files.length,
-    status: failedPlugins.size > 0 || error ? 'failed' : 'success',
+    status: generationStatus,
     hrStart,
     pluginTimings,
   })
+
+  const telemetryEvent = buildTelemetryEvent({
+    command: 'generate',
+    kubbVersion: version,
+    plugins: pluginManager.plugins.map((p) => ({ name: p.name, options: p.options as Record<string, unknown> })),
+    hrStart,
+    filesCreated: files.length,
+    status: generationStatus,
+  })
+
+  await sendTelemetry(telemetryEvent)
 }

package/src/utils/packageManager.ts

@@ -1,72 +1,14 @@
 import { spawn } from 'node:child_process'
 import fs from 'node:fs'
 import path from 'node:path'
-
-export type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun'
-
-export interface PackageManagerInfo {
-  name: PackageManager
-  lockFile: string
-  installCommand: string[]
-}
-
-const packageManagers: Record<PackageManager, PackageManagerInfo> = {
-  pnpm: {
-    name: 'pnpm',
-    lockFile: 'pnpm-lock.yaml',
-    installCommand: ['add', '-D'],
-  },
-  yarn: {
-    name: 'yarn',
-    lockFile: 'yarn.lock',
-    installCommand: ['add', '-D'],
-  },
-  bun: {
-    name: 'bun',
-    lockFile: 'bun.lockb',
-    installCommand: ['add', '-d'],
-  },
-  npm: {
-    name: 'npm',
-    lockFile: 'package-lock.json',
-    installCommand: ['install', '--save-dev'],
-  },
-}
-
-export function detectPackageManager(cwd: string = process.cwd()): PackageManagerInfo {
-  // Check for packageManager field in package.json
-  const packageJsonPath = path.join(cwd, 'package.json')
-  if (fs.existsSync(packageJsonPath)) {
-    try {
-      const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'))
-      if (packageJson.packageManager) {
-        const [name] = packageJson.packageManager.split('@')
-        if (name in packageManagers) {
-          return packageManagers[name as PackageManager]
-        }
-      }
-    } catch {
-      // Continue to lock file detection
-    }
-  }
-
-  // Check for lock files
-  for (const pm of Object.values(packageManagers)) {
-    if (fs.existsSync(path.join(cwd, pm.lockFile))) {
-      return pm
-    }
-  }
-
-  // Default to npm
-  return packageManagers.npm
-}
+import type { PackageManagerInfo, PackageManagerName } from '@kubb/core'
 
 export function hasPackageJson(cwd: string = process.cwd()): boolean {
   return fs.existsSync(path.join(cwd, 'package.json'))
 }
 
 export async function initPackageJson(cwd: string, packageManager: PackageManagerInfo): Promise<void> {
-  const commands: Record<PackageManager, string[]> = {
+  const commands: Record<PackageManagerName, string[]> = {
     npm: ['init', '-y'],
     pnpm: ['init'],
     yarn: ['init', '-y'],