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

package/src/Telemetry.ts

@@ -0,0 +1,290 @@
+import { randomBytes } from 'node:crypto'
+import os from 'node:os'
+import process from 'node:process'
+import { executeIfOnline, getRuntimeName, getRuntimeVersion, isCIEnvironment, type RuntimeName } from '@internals/utils'
+import { OTLP_ENDPOINT } from './constants.ts'
+
+// OpenTelemetry OTLP JSON types
+// https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto
+// https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/common/v1/common.proto
+
+type OtlpStringValue = { stringValue: string }
+type OtlpBoolValue = { boolValue: boolean }
+type OtlpIntValue = { intValue: number }
+type OtlpDoubleValue = { doubleValue: number }
+type OtlpBytesValue = { bytesValue: string }
+type OtlpArrayValue = { arrayValue: { values: Array<OtlpAnyValue> } }
+type OtlpKvListValue = { kvlistValue: { values: Array<OtlpKeyValue> } }
+
+type OtlpAnyValue = OtlpStringValue | OtlpBoolValue | OtlpIntValue | OtlpDoubleValue | OtlpBytesValue | OtlpArrayValue | OtlpKvListValue
+
+type OtlpKeyValue = {
+  key: string
+  value: OtlpAnyValue
+}
+
+type OtlpResource = {
+  attributes: Array<OtlpKeyValue>
+  droppedAttributesCount?: number
+}
+
+type OtlpInstrumentationScope = {
+  name: string
+  version?: string
+  attributes?: Array<OtlpKeyValue>
+  droppedAttributesCount?: number
+}
+
+/** https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto#L103 */
+type OtlpSpanKind = 0 | 1 | 2 | 3 | 4 | 5
+
+/** 0 = STATUS_CODE_UNSET, 1 = STATUS_CODE_OK, 2 = STATUS_CODE_ERROR */
+type OtlpStatusCode = 0 | 1 | 2
+
+type OtlpStatus = {
+  code: OtlpStatusCode
+  message?: string
+}
+
+type OtlpSpan = {
+  traceId: string
+  spanId: string
+  traceState?: string
+  parentSpanId?: string
+  name: string
+  kind: OtlpSpanKind
+  startTimeUnixNano: string
+  endTimeUnixNano: string
+  attributes?: Array<OtlpKeyValue>
+  droppedAttributesCount?: number
+  events?: Array<OtlpSpanEvent>
+  droppedEventsCount?: number
+  links?: Array<OtlpSpanLink>
+  droppedLinksCount?: number
+  status?: OtlpStatus
+}
+
+type OtlpSpanEvent = {
+  timeUnixNano: string
+  name: string
+  attributes?: Array<OtlpKeyValue>
+  droppedAttributesCount?: number
+}
+
+type OtlpSpanLink = {
+  traceId: string
+  spanId: string
+  traceState?: string
+  attributes?: Array<OtlpKeyValue>
+  droppedAttributesCount?: number
+}
+
+type OtlpScopeSpans = {
+  scope: OtlpInstrumentationScope
+  spans: Array<OtlpSpan>
+  schemaUrl?: string
+}
+
+type OtlpResourceSpans = {
+  resource: OtlpResource
+  scopeSpans: Array<OtlpScopeSpans>
+  schemaUrl?: string
+}
+
+/** Root payload sent to POST /v1/traces */
+type OtlpExportTraceServiceRequest = {
+  resourceSpans: Array<OtlpResourceSpans>
+}
+
+/**
+ * Anonymous plugin name and options snapshot sent with each telemetry event.
+ */
+export type TelemetryPlugin = {
+  /**
+   * Plugin name as registered in the Kubb config, e.g. `'@kubb/plugin-ts'`.
+   */
+  name: string
+  /**
+   * anonymized plugin options snapshot, values are included but cannot be traced back to the user.
+   */
+  options: Record<string, unknown>
+}
+
+export type TelemetryEvent = {
+  command: string
+  kubbVersion: string
+  nodeVersion: string
+  /**
+   * Name of the JavaScript runtime that executed the run, `'bun'`, `'deno'`, or `'node'`.
+   */
+  runtime: RuntimeName
+  /**
+   * Major version of the active runtime, e.g. `'1'` under Bun or `'22'` under Node.
+   */
+  runtimeVersion: string
+  platform: string
+  ci: boolean
+  plugins: Array<TelemetryPlugin>
+  duration: number
+  filesCreated: number
+  status: 'success' | 'failed'
+}
+
+/**
+ * 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.
+ */
+export class Telemetry {
+  /**
+   * Returns `true` when telemetry is disabled via `DO_NOT_TRACK` or `KUBB_DISABLE_TELEMETRY`.
+   */
+  static isDisabled(): boolean {
+    return (
+      process.env['DO_NOT_TRACK'] === '1' ||
+      process.env['DO_NOT_TRACK'] === 'true' ||
+      process.env['KUBB_DISABLE_TELEMETRY'] === '1' ||
+      process.env['KUBB_DISABLE_TELEMETRY'] === 'true'
+    )
+  }
+
+  /**
+   * Build an anonymous telemetry payload from a completed generation run.
+   */
+  static build(options: {
+    command: 'generate' | 'mcp' | 'validate' | 'agent'
+    kubbVersion: string
+    plugins?: Array<TelemetryPlugin>
+    hrStart: [number, number]
+    filesCreated?: number
+    status: 'success' | 'failed'
+  }): TelemetryEvent {
+    const [seconds, nanoseconds] = process.hrtime(options.hrStart)
+    const duration = Math.round(seconds * 1000 + nanoseconds / 1e6)
+
+    return {
+      command: options.command,
+      kubbVersion: options.kubbVersion,
+      nodeVersion: process.versions.node.split('.')[0] as string,
+      runtime: getRuntimeName(),
+      runtimeVersion: getRuntimeVersion().split('.')[0] as string,
+      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: TelemetryEvent): OtlpExportTraceServiceRequest {
+    const traceId = randomBytes(16).toString('hex')
+    const spanId = randomBytes(8).toString('hex')
+    const endTimeNs = BigInt(Date.now()) * 1_000_000n
+    const startTimeNs = endTimeNs - BigInt(event.duration) * 1_000_000n
+
+    const attributes: Array<OtlpKeyValue> = [
+      { 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): OtlpKvListValue => ({
+                kvlistValue: {
+                  values: [
+                    { key: 'name', value: { stringValue: p.name } },
+                    {
+                      key: 'options',
+                      value: {
+                        stringValue: JSON.stringify({
+                          ...p.options,
+                          usedEnumNames: undefined,
+                        }),
+                      },
+                    },
+                  ],
+                },
+              }),
+            ),
+          },
+        },
+      },
+    ]
+
+    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 satisfies OtlpSpanKind,
+                  startTimeUnixNano: String(startTimeNs),
+                  endTimeUnixNano: String(endTimeNs),
+                  attributes,
+                  status: {
+                    code: (event.status === 'success' ? 1 : 2) satisfies OtlpStatusCode,
+                  },
+                },
+              ],
+            },
+          ],
+        },
+      ],
+    }
+  }
+
+  /**
+   * 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: TelemetryEvent): Promise<void> {
+    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(5_000),
+        })
+      } catch (_e) {
+        // Fail silently, telemetry must never break the run
+      }
+    })
+  }
+}

package/src/constants.ts

@@ -3,6 +3,11 @@
  */
 export const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const
 
+/**
+ * OpenTelemetry ingestion endpoint for anonymous usage telemetry.
+ */
+export const OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const
+
 /**
  * Horizontal rule rendered above/below the plain-logger generation summary.
  */

package/src/index.ts

@@ -1,6 +1,6 @@
 import { styleText } from 'node:util'
 import { createCLI, isFlag } from '@internals/utils'
-import { Telemetry } from '@kubb/core'
+import { Telemetry } from './Telemetry.ts'
 import { version } from '../package.json'
 import { QUIET_FLAGS } from './constants.ts'
 

package/src/loggers/clackLogger.ts

@@ -3,7 +3,8 @@ import process from 'node:process'
 import { styleText } from 'node:util'
 import * as clack from '@clack/prompts'
 import { formatMsWithColor, getElapsedMs, getIntro, toCause } from '@internals/utils'
-import { defineLogger, Diagnostics, type KubbHooks, logLevel as logLevelMap } from '@kubb/core'
+import { Diagnostics, type KubbHooks, logLevel as logLevelMap } from '@kubb/core'
+import { defineLogger } from './defineLogger.ts'
 import { buildProgressLine, createProgressCounters, formatCommandWithArgs, formatMessage, recordPluginResult, resetProgressCounters } from './utils.ts'
 
 /**
@@ -74,11 +75,6 @@ export const clackLogger = defineLogger({
       })
     }
 
-    function startSpinner(text?: string) {
-      state.spinner.start(text)
-      state.isSpinning = true
-    }
-
     function stopSpinner(text?: string) {
       if (!state.isSpinning) {
         return
@@ -199,27 +195,6 @@ Run \`npm install -g @kubb/cli\` to update`,
       reset()
     })
 
-    context.on('kubb:config:start', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Configuration started')
-
-      clack.intro(text)
-      startSpinner(getMessage('Configuration loading'))
-    })
-
-    context.on('kubb:config:end', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Configuration completed')
-
-      clack.outro(text)
-    })
-
     context.on('kubb:generation:start', ({ config }) => {
       reset()
 

package/src/loggers/defineLogger.ts

@@ -0,0 +1,59 @@
+import type { AsyncEventEmitter } from '@internals/utils'
+import type { KubbHooks } from '@kubb/core'
+
+/**
+ * Options accepted by a logger's `install` callback.
+ */
+export type LoggerOptions = {
+  /**
+   * Output verbosity. Use the `logLevel` constants exported from `@kubb/core`
+   * (`silent`, `error`, `warn`, `info`, `verbose`, `debug`).
+   */
+  logLevel: number
+}
+
+/**
+ * Event emitter handed to `Logger.install`. Use `.on('kubb:info', ...)` and
+ * friends to subscribe to build events.
+ */
+export type LoggerContext = AsyncEventEmitter<KubbHooks>
+
+/**
+ * Logger contract. A logger receives the build's event emitter and subscribes
+ * to whichever lifecycle events it wants to forward to its destination
+ * (console, file, remote service).
+ */
+export type Logger<TOptions extends LoggerOptions = LoggerOptions> = {
+  /**
+   * Display name used in diagnostics.
+   */
+  name: string
+  /**
+   * Called once per build with the shared event emitter. Subscribe to the
+   * lifecycle events the logger wants to forward to its destination.
+   */
+  install: (context: LoggerContext, options?: TOptions) => void | Promise<void>
+}
+
+export type UserLogger<TOptions extends LoggerOptions = LoggerOptions> = Logger<TOptions>
+
+/**
+ * Defines a typed logger. The `install` method subscribes to lifecycle events
+ * on the shared emitter and forwards them to the logger's destination.
+ *
+ * @example
+ * ```ts
+ * import { defineLogger } from '@kubb/cli'
+ *
+ * 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))
+ *   },
+ * })
+ * ```
+ */
+export function defineLogger<Options extends LoggerOptions = LoggerOptions>(logger: UserLogger<Options>): Logger<Options> {
+  return logger
+}

package/src/loggers/plainLogger.ts

@@ -1,6 +1,7 @@
 import { relative } from 'node:path'
 import { formatMs, toCause } from '@internals/utils'
-import { defineLogger, Diagnostics, type KubbHooks, logLevel as logLevelMap } from '@kubb/core'
+import { Diagnostics, type KubbHooks, logLevel as logLevelMap } from '@kubb/core'
+import { defineLogger } from './defineLogger.ts'
 import { createHookTimer, formatCommandWithArgs, formatMessage } from './utils.ts'
 
 /**
@@ -93,9 +94,6 @@ export const plainLogger = defineLogger({
       console.log(`Kubb CLI v${version}`)
     })
 
-    onStep('kubb:config:start', 'Configuration started')
-    onStep('kubb:config:end', 'Configuration completed')
-
     context.on('kubb:generation:start', () => {
       const text = getMessage('Generation started')
 

package/src/loggers/utils.ts

@@ -1,8 +1,9 @@
 import process from 'node:process'
 import { styleText } from 'node:util'
 import { canUseTTY, formatHrtime, getElapsedMs } from '@internals/utils'
-import type { Logger, LoggerContext, LoggerOptions, Reporter, ReporterContext } from '@kubb/core'
+import type { Reporter, ReporterContext } from '@kubb/core'
 import { logLevel as logLevelMap } from '@kubb/core'
+import type { Logger, LoggerContext, LoggerOptions } from './defineLogger.ts'
 import { clackLogger } from './clackLogger.ts'
 import { plainLogger } from './plainLogger.ts'
 import type { LoggerType } from './types.ts'
@@ -219,3 +220,28 @@ async function setupReporters(context: LoggerContext, { logLevel, reporters }: L
 }
 
 export default setupReporters
+
+/**
+ * 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.
+ */
+export function selectReporters(reporters: ReadonlyArray<Reporter>, names: ReadonlyArray<string>): Array<Reporter> {
+  const seen = new Set<string>()
+  const selected: Array<Reporter> = []
+
+  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
+}

package/src/runners/generate/run.ts

@@ -17,12 +17,11 @@ import {
   logLevel as logLevelMap,
   type ProblemDiagnostic,
   type ReporterName,
-  selectReporters,
-  Telemetry,
 } from '@kubb/core'
 import { version } from '../../../package.json'
 import { KUBB_NPM_PACKAGE_URL } from '../../constants.ts'
-import setupReporters from '../../loggers/utils.ts'
+import { Telemetry } from '../../Telemetry.ts'
+import setupReporters, { selectReporters } from '../../loggers/utils.ts'
 import { executeHooks, getConfigs, runHook, startWatcher } from './utils.ts'
 
 type GenerateProps = {
@@ -363,10 +362,8 @@ export async function run({ input, configPath, logLevel: logLevelKey, watch, rep
   try {
     const relativeConfigPath = path.relative(process.cwd(), resolvedConfigPath)
 
-    await hooks.emit('kubb:config:start')
     await hooks.emit('kubb:info', { message: 'Config loaded', info: relativeConfigPath })
     await hooks.emit('kubb:success', { message: 'Config loaded successfully', info: relativeConfigPath })
-    await hooks.emit('kubb:config:end', { configs })
 
     let anyFailed = false
     for (const config of configs) {
@@ -375,7 +372,7 @@ export async function run({ input, configPath, logLevel: logLevelKey, watch, rep
           [input || config.input.path],
           async (paths) => {
             // Don't removeAll(), that would also drop logger and lifecycle listeners.
-            // Plugin and middleware listeners are already disposed by safeBuild's
+            // Plugin listeners are already disposed by safeBuild's
             // setupResult.dispose() in its finally block, so re-running generate()
             // on the same hooks emitter is safe.
             await generate({ input, config, logLevel, hooks })

package/src/runners/mcp/run.ts

@@ -1,7 +1,7 @@
 import process from 'node:process'
 import { styleText } from 'node:util'
 import { getErrorMessage } from '@internals/utils'
-import { Telemetry } from '@kubb/core'
+import { Telemetry } from '../../Telemetry.ts'
 import type * as McpModule from '@kubb/mcp'
 
 type McpOptions = {

package/src/runners/validate/run.ts

@@ -1,7 +1,7 @@
 import process from 'node:process'
 import { styleText } from 'node:util'
 import { getErrorMessage } from '@internals/utils'
-import { Telemetry } from '@kubb/core'
+import { Telemetry } from '../../Telemetry.ts'
 
 type ValidateOptions = {
   /**

package/dist/constants-BQ8LZB1P.js

@@ -1,23 +0,0 @@
-//#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";
-"─".repeat(27);
-/**
-* 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
-export { QUIET_FLAGS as n, WATCHER_IGNORED_PATHS as r, KUBB_NPM_PACKAGE_URL as t };
-
-//# sourceMappingURL=constants-BQ8LZB1P.js.map

package/dist/constants-BQ8LZB1P.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants-BQ8LZB1P.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/**\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 * Horizontal rule rendered above/below the plain-logger generation summary.\n */\nexport const SUMMARY_SEPARATOR = '─'.repeat(27)\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"],"mappings":";;;;AAGA,MAAa,uBAAuB;AAKH,IAAI,OAAO,EAAE;;;;AAK9C,MAAa,wBAAwB;;;;AAKrC,MAAa,cAAc,IAAI,IAAI;CAAC;CAAU;CAAM;CAAa;AAAI,CAAU"}

package/dist/constants-MzEjK668.cjs

@@ -1,40 +0,0 @@
-//#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";
-"─".repeat(27);
-/**
-* 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
-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, "WATCHER_IGNORED_PATHS", {
-	enumerable: true,
-	get: function() {
-		return WATCHER_IGNORED_PATHS;
-	}
-});
-
-//# sourceMappingURL=constants-MzEjK668.cjs.map

package/dist/constants-MzEjK668.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants-MzEjK668.cjs","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/**\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 * Horizontal rule rendered above/below the plain-logger generation summary.\n */\nexport const SUMMARY_SEPARATOR = '─'.repeat(27)\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"],"mappings":";;;;AAGA,MAAa,uBAAuB;AAKH,IAAI,OAAO,EAAE;;;;AAK9C,MAAa,wBAAwB;;;;AAKrC,MAAa,cAAc,IAAI,IAAI;CAAC;CAAU;CAAM;CAAa;AAAI,CAAU"}

package/dist/package-Bm6VUbtL.js

@@ -1,6 +0,0 @@
-//#region package.json
-var version = "5.0.0-beta.50";
-//#endregion
-export { version as t };
-
-//# sourceMappingURL=package-Bm6VUbtL.js.map

package/dist/package-Bm6VUbtL.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"package-Bm6VUbtL.js","names":[],"sources":["../package.json"],"sourcesContent":[""],"mappings":""}

package/dist/package-DOVOGEEY.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"package-DOVOGEEY.cjs","names":[],"sources":["../package.json"],"sourcesContent":[""],"mappings":""}

package/dist/run-BO7phoNN.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-BO7phoNN.js","names":[],"sources":["../src/runners/validate/run.ts"],"sourcesContent":["import process from 'node:process'\nimport { styleText } from 'node:util'\nimport { getErrorMessage } from '@internals/utils'\nimport { Telemetry } from '@kubb/core'\n\ntype ValidateOptions = {\n  /**\n   * Path or URL to the OpenAPI/Swagger file to validate.\n   */\n  input: string\n  /**\n   * Current `@kubb/cli` version string, used for the telemetry payload.\n   */\n  version: string\n}\n\ntype ValidateModule = typeof import('@kubb/adapter-oas')\ntype ValidateDependencies = {\n  /**\n   * Loads `@kubb/adapter-oas`. Injected so tests can substitute a mock.\n   */\n  loadValidateModule: () => Promise<ValidateModule>\n}\n\n/**\n * Dynamically loads `@kubb/adapter-oas` for OpenAPI validation.\n */\nexport function loadValidateModule(): Promise<ValidateModule> {\n  return import('@kubb/adapter-oas') as Promise<ValidateModule>\n}\n\n/**\n * Validates an OpenAPI/Swagger file at `input` using `@kubb/adapter-oas`.\n * Exits the process with code 1 on validation failure or missing dependency.\n */\nexport async function run({ input, version }: ValidateOptions, dependencies: ValidateDependencies = { loadValidateModule }): Promise<void> {\n  const hrStart = process.hrtime()\n  const report = (status: 'success' | 'failed') => Telemetry.send(Telemetry.build({ command: 'validate', kubbVersion: version, hrStart, status }))\n  try {\n    const { adapterOas } = await dependencies.loadValidateModule()\n    const adapter = adapterOas()\n    if (!adapter.validate) {\n      throw new Error('The loaded adapter does not support validation.')\n    }\n    await adapter.validate(input, { throwOnError: true })\n    await report('success')\n    console.log('✅ Validation success')\n  } catch (error) {\n    await report('failed')\n    if (error instanceof Error && /@kubb\\/adapter-oas/.test(error.message)) {\n      console.error(styleText('red', 'The @kubb/adapter-oas package is not installed.'))\n      console.error('')\n      console.error('Install it with:')\n      console.error(styleText('cyan', '  npm install @kubb/adapter-oas'))\n      console.error(styleText('cyan', '  # or'))\n      console.error(styleText('cyan', '  pnpm install @kubb/adapter-oas'))\n      console.error('')\n    }\n    console.error('❌ Validation failed')\n    console.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAgB,qBAA8C;CAC5D,OAAO,OAAO;AAChB;;;;;AAMA,eAAsB,IAAI,EAAE,OAAO,WAA4B,eAAqC,EAAE,mBAAmB,GAAkB;CACzI,MAAM,UAAU,QAAQ,OAAO;CAC/B,MAAM,UAAU,WAAiC,UAAU,KAAK,UAAU,MAAM;EAAE,SAAS;EAAY,aAAa;EAAS;EAAS;CAAO,CAAC,CAAC;CAC/I,IAAI;EACF,MAAM,EAAE,eAAe,MAAM,aAAa,mBAAmB;EAC7D,MAAM,UAAU,WAAW;EAC3B,IAAI,CAAC,QAAQ,UACX,MAAM,IAAI,MAAM,iDAAiD;EAEnE,MAAM,QAAQ,SAAS,OAAO,EAAE,cAAc,KAAK,CAAC;EACpD,MAAM,OAAO,SAAS;EACtB,QAAQ,IAAI,sBAAsB;CACpC,SAAS,OAAO;EACd,MAAM,OAAO,QAAQ;EACrB,IAAI,iBAAiB,SAAS,qBAAqB,KAAK,MAAM,OAAO,GAAG;GACtE,QAAQ,MAAM,UAAU,OAAO,iDAAiD,CAAC;GACjF,QAAQ,MAAM,EAAE;GAChB,QAAQ,MAAM,kBAAkB;GAChC,QAAQ,MAAM,UAAU,QAAQ,iCAAiC,CAAC;GAClE,QAAQ,MAAM,UAAU,QAAQ,QAAQ,CAAC;GACzC,QAAQ,MAAM,UAAU,QAAQ,kCAAkC,CAAC;GACnE,QAAQ,MAAM,EAAE;EAClB;EACA,QAAQ,MAAM,qBAAqB;EACnC,QAAQ,MAAM,gBAAgB,KAAK,CAAC;EACpC,QAAQ,KAAK,CAAC;CAChB;AACF"}

package/dist/run-BzaKz_nl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-BzaKz_nl.js","names":[],"sources":["../src/runners/mcp/run.ts"],"sourcesContent":["import process from 'node:process'\nimport { styleText } from 'node:util'\nimport { getErrorMessage } from '@internals/utils'\nimport { Telemetry } from '@kubb/core'\nimport type * as McpModule from '@kubb/mcp'\n\ntype McpOptions = {\n  /**\n   * Current `@kubb/cli` version string, used for the telemetry payload.\n   */\n  version: string\n  /**\n   * TCP port for the HTTP MCP server. When `undefined`, the server uses stdio transport.\n   */\n  port?: string\n  /**\n   * Hostname to bind to when running in HTTP mode.\n   *\n   * @default 'localhost'\n   */\n  host?: string\n}\n\nexport async function run({ version, port, host }: McpOptions): Promise<void> {\n  const { run: startMcpServer } = (await import('@kubb/mcp')) as typeof McpModule\n  const hrStart = process.hrtime()\n  const report = (status: 'success' | 'failed') => Telemetry.send(Telemetry.build({ command: 'mcp', kubbVersion: version, hrStart, status }))\n  try {\n    console.log(styleText('cyan', '⏳ Starting MCP server...'))\n    console.warn(styleText('yellow', 'This feature is still under development, use with caution'))\n    await startMcpServer(undefined, { port: port !== undefined ? Number(port) : undefined, host })\n    await report('success')\n  } catch (error) {\n    await report('failed')\n    console.error(getErrorMessage(error))\n  }\n}\n"],"mappings":";;;;;;AAuBA,eAAsB,IAAI,EAAE,SAAS,MAAM,QAAmC;CAC5E,MAAM,EAAE,KAAK,mBAAoB,MAAM,OAAO;CAC9C,MAAM,UAAU,QAAQ,OAAO;CAC/B,MAAM,UAAU,WAAiC,UAAU,KAAK,UAAU,MAAM;EAAE,SAAS;EAAO,aAAa;EAAS;EAAS;CAAO,CAAC,CAAC;CAC1I,IAAI;EACF,QAAQ,IAAI,UAAU,QAAQ,0BAA0B,CAAC;EACzD,QAAQ,KAAK,UAAU,UAAU,2DAA2D,CAAC;EAC7F,MAAM,eAAe,KAAA,GAAW;GAAE,MAAM,SAAS,KAAA,IAAY,OAAO,IAAI,IAAI,KAAA;GAAW;EAAK,CAAC;EAC7F,MAAM,OAAO,SAAS;CACxB,SAAS,OAAO;EACd,MAAM,OAAO,QAAQ;EACrB,QAAQ,MAAM,gBAAgB,KAAK,CAAC;CACtC;AACF"}

package/dist/run-CkTpemme.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-CkTpemme.cjs","names":["process","Telemetry","getErrorMessage"],"sources":["../src/runners/validate/run.ts"],"sourcesContent":["import process from 'node:process'\nimport { styleText } from 'node:util'\nimport { getErrorMessage } from '@internals/utils'\nimport { Telemetry } from '@kubb/core'\n\ntype ValidateOptions = {\n  /**\n   * Path or URL to the OpenAPI/Swagger file to validate.\n   */\n  input: string\n  /**\n   * Current `@kubb/cli` version string, used for the telemetry payload.\n   */\n  version: string\n}\n\ntype ValidateModule = typeof import('@kubb/adapter-oas')\ntype ValidateDependencies = {\n  /**\n   * Loads `@kubb/adapter-oas`. Injected so tests can substitute a mock.\n   */\n  loadValidateModule: () => Promise<ValidateModule>\n}\n\n/**\n * Dynamically loads `@kubb/adapter-oas` for OpenAPI validation.\n */\nexport function loadValidateModule(): Promise<ValidateModule> {\n  return import('@kubb/adapter-oas') as Promise<ValidateModule>\n}\n\n/**\n * Validates an OpenAPI/Swagger file at `input` using `@kubb/adapter-oas`.\n * Exits the process with code 1 on validation failure or missing dependency.\n */\nexport async function run({ input, version }: ValidateOptions, dependencies: ValidateDependencies = { loadValidateModule }): Promise<void> {\n  const hrStart = process.hrtime()\n  const report = (status: 'success' | 'failed') => Telemetry.send(Telemetry.build({ command: 'validate', kubbVersion: version, hrStart, status }))\n  try {\n    const { adapterOas } = await dependencies.loadValidateModule()\n    const adapter = adapterOas()\n    if (!adapter.validate) {\n      throw new Error('The loaded adapter does not support validation.')\n    }\n    await adapter.validate(input, { throwOnError: true })\n    await report('success')\n    console.log('✅ Validation success')\n  } catch (error) {\n    await report('failed')\n    if (error instanceof Error && /@kubb\\/adapter-oas/.test(error.message)) {\n      console.error(styleText('red', 'The @kubb/adapter-oas package is not installed.'))\n      console.error('')\n      console.error('Install it with:')\n      console.error(styleText('cyan', '  npm install @kubb/adapter-oas'))\n      console.error(styleText('cyan', '  # or'))\n      console.error(styleText('cyan', '  pnpm install @kubb/adapter-oas'))\n      console.error('')\n    }\n    console.error('❌ Validation failed')\n    console.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;;;;;AA2BA,SAAgB,qBAA8C;CAC5D,OAAO,OAAO;AAChB;;;;;AAMA,eAAsB,IAAI,EAAE,OAAO,WAA4B,eAAqC,EAAE,mBAAmB,GAAkB;CACzI,MAAM,UAAUA,aAAAA,QAAQ,OAAO;CAC/B,MAAM,UAAU,WAAiCC,WAAAA,UAAU,KAAKA,WAAAA,UAAU,MAAM;EAAE,SAAS;EAAY,aAAa;EAAS;EAAS;CAAO,CAAC,CAAC;CAC/I,IAAI;EACF,MAAM,EAAE,eAAe,MAAM,aAAa,mBAAmB;EAC7D,MAAM,UAAU,WAAW;EAC3B,IAAI,CAAC,QAAQ,UACX,MAAM,IAAI,MAAM,iDAAiD;EAEnE,MAAM,QAAQ,SAAS,OAAO,EAAE,cAAc,KAAK,CAAC;EACpD,MAAM,OAAO,SAAS;EACtB,QAAQ,IAAI,sBAAsB;CACpC,SAAS,OAAO;EACd,MAAM,OAAO,QAAQ;EACrB,IAAI,iBAAiB,SAAS,qBAAqB,KAAK,MAAM,OAAO,GAAG;GACtE,QAAQ,OAAA,GAAA,UAAA,UAAA,CAAgB,OAAO,iDAAiD,CAAC;GACjF,QAAQ,MAAM,EAAE;GAChB,QAAQ,MAAM,kBAAkB;GAChC,QAAQ,OAAA,GAAA,UAAA,UAAA,CAAgB,QAAQ,iCAAiC,CAAC;GAClE,QAAQ,OAAA,GAAA,UAAA,UAAA,CAAgB,QAAQ,QAAQ,CAAC;GACzC,QAAQ,OAAA,GAAA,UAAA,UAAA,CAAgB,QAAQ,kCAAkC,CAAC;GACnE,QAAQ,MAAM,EAAE;EAClB;EACA,QAAQ,MAAM,qBAAqB;EACnC,QAAQ,MAAMC,eAAAA,gBAAgB,KAAK,CAAC;EACpC,aAAA,QAAQ,KAAK,CAAC;CAChB;AACF"}

package/dist/run-Cl4SrSob.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-Cl4SrSob.cjs","names":["process","Telemetry","getErrorMessage"],"sources":["../src/runners/mcp/run.ts"],"sourcesContent":["import process from 'node:process'\nimport { styleText } from 'node:util'\nimport { getErrorMessage } from '@internals/utils'\nimport { Telemetry } from '@kubb/core'\nimport type * as McpModule from '@kubb/mcp'\n\ntype McpOptions = {\n  /**\n   * Current `@kubb/cli` version string, used for the telemetry payload.\n   */\n  version: string\n  /**\n   * TCP port for the HTTP MCP server. When `undefined`, the server uses stdio transport.\n   */\n  port?: string\n  /**\n   * Hostname to bind to when running in HTTP mode.\n   *\n   * @default 'localhost'\n   */\n  host?: string\n}\n\nexport async function run({ version, port, host }: McpOptions): Promise<void> {\n  const { run: startMcpServer } = (await import('@kubb/mcp')) as typeof McpModule\n  const hrStart = process.hrtime()\n  const report = (status: 'success' | 'failed') => Telemetry.send(Telemetry.build({ command: 'mcp', kubbVersion: version, hrStart, status }))\n  try {\n    console.log(styleText('cyan', '⏳ Starting MCP server...'))\n    console.warn(styleText('yellow', 'This feature is still under development, use with caution'))\n    await startMcpServer(undefined, { port: port !== undefined ? Number(port) : undefined, host })\n    await report('success')\n  } catch (error) {\n    await report('failed')\n    console.error(getErrorMessage(error))\n  }\n}\n"],"mappings":";;;;;;;AAuBA,eAAsB,IAAI,EAAE,SAAS,MAAM,QAAmC;CAC5E,MAAM,EAAE,KAAK,mBAAoB,MAAM,OAAO;CAC9C,MAAM,UAAUA,aAAAA,QAAQ,OAAO;CAC/B,MAAM,UAAU,WAAiCC,WAAAA,UAAU,KAAKA,WAAAA,UAAU,MAAM;EAAE,SAAS;EAAO,aAAa;EAAS;EAAS;CAAO,CAAC,CAAC;CAC1I,IAAI;EACF,QAAQ,KAAA,GAAA,UAAA,UAAA,CAAc,QAAQ,0BAA0B,CAAC;EACzD,QAAQ,MAAA,GAAA,UAAA,UAAA,CAAe,UAAU,2DAA2D,CAAC;EAC7F,MAAM,eAAe,KAAA,GAAW;GAAE,MAAM,SAAS,KAAA,IAAY,OAAO,IAAI,IAAI,KAAA;GAAW;EAAK,CAAC;EAC7F,MAAM,OAAO,SAAS;CACxB,SAAS,OAAO;EACd,MAAM,OAAO,QAAQ;EACrB,QAAQ,MAAMC,eAAAA,gBAAgB,KAAK,CAAC;CACtC;AACF"}