@kubb/cli 5.0.0-beta.4 → 5.0.0-beta.40

package/dist/validate-C6npXzel.cjs

@@ -1,25 +0,0 @@
-require("./chunk-ByKO4r7w.cjs");
-const require_define = require("./define-Bdn8j5VM.cjs");
-const require_package = require("./package-BapVyQ-w.cjs");
-//#region src/commands/validate.ts
-const command = require_define.defineCommand({
-	name: "validate",
-	description: "Validate a Swagger/OpenAPI file",
-	options: { input: {
-		type: "string",
-		description: "Path to Swagger/OpenAPI file",
-		short: "i",
-		required: true
-	} },
-	async run({ values }) {
-		const { runValidate } = await Promise.resolve().then(() => require("./validate-yKKzqEZ5.cjs"));
-		await runValidate({
-			input: values.input,
-			version: require_package.version
-		});
-	}
-});
-//#endregion
-exports.command = command;
-
-//# sourceMappingURL=validate-C6npXzel.cjs.map

package/dist/validate-C6npXzel.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate-C6npXzel.cjs","names":["defineCommand"],"sources":["../src/commands/validate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'validate',\n  description: 'Validate a Swagger/OpenAPI file',\n  options: {\n    input: {\n      type: 'string',\n      description: 'Path to Swagger/OpenAPI file',\n      short: 'i',\n      required: true,\n    },\n  },\n  async run({ values }) {\n    const { runValidate } = await import('../runners/validate.ts')\n\n    await runValidate({ input: values.input, version })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAUA,eAAAA,cAAc;CACnC,MAAM;CACN,aAAa;CACb,SAAS,EACP,OAAO;EACL,MAAM;EACN,aAAa;EACb,OAAO;EACP,UAAU;EACX,EACF;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,gBAAgB,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,0BAAA,CAAA;AAE9B,QAAM,YAAY;GAAE,OAAO,OAAO;GAAO,SAAA,gBAAA;GAAS,CAAC;;CAEtD,CAAC"}

package/dist/validate-kLJoT_hi.js

@@ -1,33 +0,0 @@
-import "./chunk--u3MIqq1.js";
-import { t as getErrorMessage } from "./errors-CjPmyZHy.js";
-import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-LgT_sdPe.js";
-import process from "node:process";
-import { parseDocument, validateDocument } from "@kubb/adapter-oas";
-//#region src/runners/validate.ts
-async function runValidate({ input, version }) {
-	const hrStart = process.hrtime();
-	try {
-		await validateDocument(await parseDocument(input), { throwOnError: true });
-		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.error(getErrorMessage(error));
-		process.exit(1);
-	}
-}
-//#endregion
-export { runValidate };
-
-//# sourceMappingURL=validate-kLJoT_hi.js.map

package/dist/validate-kLJoT_hi.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate-kLJoT_hi.js","names":[],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport { getErrorMessage } from '@internals/utils'\nimport { parseDocument, validateDocument } from '@kubb/adapter-oas'\nimport { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'\n\ntype ValidateOptions = {\n  input: string\n  version: string\n}\n\nexport async function runValidate({ input, version }: ValidateOptions): Promise<void> {\n  const hrStart = process.hrtime()\n  try {\n    const document = await parseDocument(input)\n    await validateDocument(document, { throwOnError: true })\n\n    await sendTelemetry(\n      buildTelemetryEvent({\n        command: 'validate',\n        kubbVersion: version,\n        hrStart,\n        status: 'success',\n      }),\n    )\n    console.log('✅ Validation success')\n  } catch (error) {\n    await sendTelemetry(\n      buildTelemetryEvent({\n        command: 'validate',\n        kubbVersion: version,\n        hrStart,\n        status: 'failed',\n      }),\n    )\n    console.error('❌ Validation failed')\n    console.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;AAUA,eAAsB,YAAY,EAAE,OAAO,WAA2C;CACpF,MAAM,UAAU,QAAQ,QAAQ;AAChC,KAAI;AAEF,QAAM,iBAAiB,MADA,cAAc,MAAM,EACV,EAAE,cAAc,MAAM,CAAC;AAExD,QAAM,cACJ,oBAAoB;GAClB,SAAS;GACT,aAAa;GACb;GACA,QAAQ;GACT,CAAC,CACH;AACD,UAAQ,IAAI,uBAAuB;UAC5B,OAAO;AACd,QAAM,cACJ,oBAAoB;GAClB,SAAS;GACT,aAAa;GACb;GACA,QAAQ;GACT,CAAC,CACH;AACD,UAAQ,MAAM,sBAAsB;AACpC,UAAQ,MAAM,gBAAgB,MAAM,CAAC;AACrC,UAAQ,KAAK,EAAE"}

package/dist/validate-n38Rh-Y7.js

@@ -1,25 +0,0 @@
-import "./chunk--u3MIqq1.js";
-import { n as defineCommand } from "./define-Ctii4bel.js";
-import { t as version } from "./package-DyJE-qNq.js";
-//#region src/commands/validate.ts
-const command = defineCommand({
-	name: "validate",
-	description: "Validate a Swagger/OpenAPI file",
-	options: { input: {
-		type: "string",
-		description: "Path to Swagger/OpenAPI file",
-		short: "i",
-		required: true
-	} },
-	async run({ values }) {
-		const { runValidate } = await import("./validate-kLJoT_hi.js");
-		await runValidate({
-			input: values.input,
-			version
-		});
-	}
-});
-//#endregion
-export { command };
-
-//# sourceMappingURL=validate-n38Rh-Y7.js.map

package/dist/validate-n38Rh-Y7.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate-n38Rh-Y7.js","names":[],"sources":["../src/commands/validate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'validate',\n  description: 'Validate a Swagger/OpenAPI file',\n  options: {\n    input: {\n      type: 'string',\n      description: 'Path to Swagger/OpenAPI file',\n      short: 'i',\n      required: true,\n    },\n  },\n  async run({ values }) {\n    const { runValidate } = await import('../runners/validate.ts')\n\n    await runValidate({ input: values.input, version })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aAAa;CACb,SAAS,EACP,OAAO;EACL,MAAM;EACN,aAAa;EACb,OAAO;EACP,UAAU;EACX,EACF;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,gBAAgB,MAAM,OAAO;AAErC,QAAM,YAAY;GAAE,OAAO,OAAO;GAAO;GAAS,CAAC;;CAEtD,CAAC"}

package/dist/validate-yKKzqEZ5.cjs

@@ -1,34 +0,0 @@
-const require_chunk = require("./chunk-ByKO4r7w.cjs");
-const require_errors = require("./errors-CLCjoSg0.cjs");
-const require_telemetry = require("./telemetry-DN95_2pF.cjs");
-let node_process = require("node:process");
-node_process = require_chunk.__toESM(node_process, 1);
-let _kubb_adapter_oas = require("@kubb/adapter-oas");
-//#region src/runners/validate.ts
-async function runValidate({ input, version }) {
-	const hrStart = node_process.default.hrtime();
-	try {
-		await (0, _kubb_adapter_oas.validateDocument)(await (0, _kubb_adapter_oas.parseDocument)(input), { throwOnError: true });
-		await require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
-			command: "validate",
-			kubbVersion: version,
-			hrStart,
-			status: "success"
-		}));
-		console.log("✅ Validation success");
-	} catch (error) {
-		await require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
-			command: "validate",
-			kubbVersion: version,
-			hrStart,
-			status: "failed"
-		}));
-		console.error("❌ Validation failed");
-		console.error(require_errors.getErrorMessage(error));
-		node_process.default.exit(1);
-	}
-}
-//#endregion
-exports.runValidate = runValidate;
-
-//# sourceMappingURL=validate-yKKzqEZ5.cjs.map

package/dist/validate-yKKzqEZ5.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate-yKKzqEZ5.cjs","names":["process","sendTelemetry","buildTelemetryEvent","getErrorMessage"],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport { getErrorMessage } from '@internals/utils'\nimport { parseDocument, validateDocument } from '@kubb/adapter-oas'\nimport { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'\n\ntype ValidateOptions = {\n  input: string\n  version: string\n}\n\nexport async function runValidate({ input, version }: ValidateOptions): Promise<void> {\n  const hrStart = process.hrtime()\n  try {\n    const document = await parseDocument(input)\n    await validateDocument(document, { throwOnError: true })\n\n    await sendTelemetry(\n      buildTelemetryEvent({\n        command: 'validate',\n        kubbVersion: version,\n        hrStart,\n        status: 'success',\n      }),\n    )\n    console.log('✅ Validation success')\n  } catch (error) {\n    await sendTelemetry(\n      buildTelemetryEvent({\n        command: 'validate',\n        kubbVersion: version,\n        hrStart,\n        status: 'failed',\n      }),\n    )\n    console.error('❌ Validation failed')\n    console.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;;AAUA,eAAsB,YAAY,EAAE,OAAO,WAA2C;CACpF,MAAM,UAAUA,aAAAA,QAAQ,QAAQ;AAChC,KAAI;AAEF,SAAA,GAAA,kBAAA,kBAAuB,OAAA,GAAA,kBAAA,eADc,MAAM,EACV,EAAE,cAAc,MAAM,CAAC;AAExD,QAAMC,kBAAAA,cACJC,kBAAAA,oBAAoB;GAClB,SAAS;GACT,aAAa;GACb;GACA,QAAQ;GACT,CAAC,CACH;AACD,UAAQ,IAAI,uBAAuB;UAC5B,OAAO;AACd,QAAMD,kBAAAA,cACJC,kBAAAA,oBAAoB;GAClB,SAAS;GACT,aAAa;GACb;GACA,QAAQ;GACT,CAAC,CACH;AACD,UAAQ,MAAM,sBAAsB;AACpC,UAAQ,MAAMC,eAAAA,gBAAgB,MAAM,CAAC;AACrC,eAAA,QAAQ,KAAK,EAAE"}

package/src/loggers/fileSystemLogger.ts

@@ -1,138 +0,0 @@
-import { relative, resolve } from 'node:path'
-import process from 'node:process'
-import { formatMs, write } from '@internals/utils'
-import { defineLogger } from '@kubb/core'
-
-type CachedEvent = {
-  date: Date
-  logs: string[]
-  fileName?: string
-}
-
-/**
- * FileSystem logger that captures debug events and writes them to `.kubb` directory files.
- * Note: Logs write on `lifecycle:end` or process exit. Cached logs may be lost if the process crashes before these events.
- */
-export const fileSystemLogger = defineLogger({
-  name: 'filesystem',
-  install(context) {
-    const state = {
-      cachedLogs: new Set<CachedEvent>(),
-      startDate: Date.now(),
-    }
-
-    function reset() {
-      state.cachedLogs = new Set<CachedEvent>()
-      state.startDate = Date.now()
-    }
-
-    async function writeLogs(name?: string) {
-      if (state.cachedLogs.size === 0) {
-        return []
-      }
-
-      const files: Record<string, string[]> = {}
-
-      for (const log of state.cachedLogs) {
-        const baseName = log.fileName || `${['kubb', name, state.startDate].filter(Boolean).join('-')}.log`
-        const pathName = resolve(process.cwd(), '.kubb', baseName)
-
-        if (!files[pathName]) {
-          files[pathName] = []
-        }
-
-        if (log.logs.length > 0) {
-          const timestamp = log.date.toLocaleString()
-          files[pathName].push(`[${timestamp}]\n${log.logs.join('\n')}`)
-        }
-      }
-
-      for (const [fileName, logs] of Object.entries(files)) {
-        await write(fileName, logs.join('\n\n'))
-      }
-
-      return Object.keys(files)
-    }
-
-    context.on('kubb:info', ({ message, info }) => {
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [`ℹ ${message} ${info}`],
-      })
-    })
-
-    context.on('kubb:success', ({ message, info }) => {
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [`✓ ${message} ${info}`],
-      })
-    })
-
-    context.on('kubb:warn', ({ message, info }) => {
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [`⚠ ${message} ${info}`],
-      })
-    })
-
-    context.on('kubb:error', ({ error }) => {
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [`✗ ${error.message}`, error.stack || 'unknown stack'],
-      })
-    })
-
-    context.on('kubb:debug', (message) => {
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: message.logs,
-      })
-    })
-
-    context.on('kubb:plugin:start', ({ plugin }) => {
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [`Generating ${plugin.name}`],
-      })
-    })
-
-    context.on('kubb:plugin:end', ({ plugin, duration, success }) => {
-      const durationStr = formatMs(duration)
-
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [success ? `${plugin.name} completed in ${durationStr}` : `${plugin.name} failed in ${durationStr}`],
-      })
-    })
-
-    context.on('kubb:files:processing:start', ({ files }) => {
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [`Start ${files.length} writing:`, ...files.map((file) => file.path)],
-      })
-    })
-
-    context.on('kubb:generation:end', async ({ config }) => {
-      const writtenFilePaths = await writeLogs(config.name)
-      if (writtenFilePaths.length > 0) {
-        const files = writtenFilePaths.map((f) => relative(process.cwd(), f))
-        await context.emit('kubb:info', { message: 'Debug files written to:', info: files.join(', ') })
-      }
-      reset()
-    })
-
-    // Fallback: Write logs on process exit to handle crashes
-    const exitHandler = () => {
-      // Synchronous write on exit - best effort
-      if (state.cachedLogs.size > 0) {
-        writeLogs().catch(() => {
-          // Ignore errors on exit
-        })
-      }
-    }
-
-    process.once('exit', exitHandler)
-    process.once('SIGINT', exitHandler)
-    process.once('SIGTERM', exitHandler)
-  },
-})

package/src/runners/agent.ts

@@ -1,155 +0,0 @@
-import net from 'node:net'
-import path from 'node:path'
-import * as process from 'node:process'
-import { fileURLToPath } from 'node:url'
-import { styleText } from 'node:util'
-import * as clack from '@clack/prompts'
-import { spawnAsync } from '@internals/utils'
-import { agentDefaults } from '../constants.ts'
-import { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'
-
-type AgentStartOptions = {
-  port: string | undefined
-  host: string
-  configPath: string | undefined
-  allowWrite: boolean
-  allowAll: boolean
-  version: string
-}
-
-type ResolvedAgentStartEnvironment = {
-  port: string
-  host: string
-  allowWrite: boolean
-  allowAll: boolean
-  agentConfigPath: string
-  env: NodeJS.ProcessEnv
-}
-
-/**
- * Resolves the environment passed to the detached agent process using CLI values first, then environment values, then CLI defaults.
- */
-function resolveAgentStartEnvironment({ port, host, configPath, allowWrite, allowAll }: Omit<AgentStartOptions, 'version'>): ResolvedAgentStartEnvironment {
-  const resolvedPort = port ?? process.env.PORT ?? agentDefaults.port
-  const resolvedHost = host !== agentDefaults.host ? host : (process.env.HOST ?? agentDefaults.host)
-  const resolvedAllowAll = allowAll || process.env.KUBB_AGENT_ALLOW_ALL === 'true'
-  const resolvedAllowWrite = resolvedAllowAll || allowWrite || process.env.KUBB_AGENT_ALLOW_WRITE === 'true'
-  const agentRoot = process.env.KUBB_AGENT_ROOT ?? process.cwd()
-  const agentConfigPath = path.resolve(process.cwd(), configPath || process.env.KUBB_AGENT_CONFIG || agentDefaults.configFile)
-
-  return {
-    port: resolvedPort,
-    host: resolvedHost,
-    allowWrite: resolvedAllowWrite,
-    allowAll: resolvedAllowAll,
-    agentConfigPath,
-    env: {
-      ...process.env,
-      PORT: resolvedPort,
-      HOST: resolvedHost,
-      KUBB_AGENT_ROOT: agentRoot,
-      KUBB_AGENT_CONFIG: agentConfigPath,
-      KUBB_AGENT_ALLOW_WRITE: String(resolvedAllowWrite),
-      KUBB_AGENT_ALLOW_ALL: String(resolvedAllowAll),
-      KUBB_AGENT_TOKEN: process.env.KUBB_AGENT_TOKEN,
-      KUBB_AGENT_RETRY_TIMEOUT: process.env.KUBB_AGENT_RETRY_TIMEOUT ?? agentDefaults.retryTimeout,
-      KUBB_STUDIO_URL: process.env.KUBB_STUDIO_URL ?? agentDefaults.studioUrl,
-    },
-  }
-}
-
-function isPortAvailable(port: number, host: string): Promise<boolean> {
-  return new Promise((resolve) => {
-    const server = net.createServer()
-    server.once('error', () => resolve(false))
-    server.once('listening', () => {
-      server.close()
-      resolve(true)
-    })
-    server.listen(port, host)
-  })
-}
-
-export async function runAgentStart({ port, host, configPath, allowWrite, allowAll, version }: AgentStartOptions): Promise<void> {
-  const hrStart = process.hrtime()
-
-  try {
-    // Load .env file into process.env using Node.js built-in (v20.12.0+)
-    try {
-      process.loadEnvFile()
-    } catch {
-      // .env file may not exist; ignore
-    }
-
-    // Resolve the @kubb/agent package path
-    let agentPkgUrl: string
-    try {
-      agentPkgUrl = import.meta.resolve('@kubb/agent/package.json')
-    } catch (_e) {
-      console.error(styleText('red', 'The @kubb/agent package is not installed.'))
-      console.error('')
-      console.error('Install it with:')
-      console.error(styleText('cyan', '  npm install @kubb/agent'))
-      console.error(styleText('cyan', '  # or'))
-      console.error(styleText('cyan', '  pnpm install @kubb/agent'))
-      console.error('')
-      process.exit(1)
-    }
-    const agentPkgPath = fileURLToPath(agentPkgUrl)
-    const agentDir = path.dirname(agentPkgPath)
-    const serverPath = path.join(agentDir, agentDefaults.serverEntryPath)
-
-    const resolvedEnv = resolveAgentStartEnvironment({
-      port,
-      host,
-      configPath,
-      allowWrite,
-      allowAll,
-    })
-    const numericPort = Number(resolvedEnv.port)
-
-    if (!Number.isInteger(numericPort) || numericPort <= 0) {
-      throw new Error(`Invalid port "${resolvedEnv.port}". Provide a positive integer with --port or PORT.`)
-    }
-
-    clack.log.step(styleText('cyan', 'Starting agent server...'))
-    clack.log.info(styleText('dim', `Config: ${resolvedEnv.agentConfigPath}`))
-    clack.log.info(styleText('dim', `Host: ${resolvedEnv.host}`))
-    clack.log.info(styleText('dim', `Port: ${resolvedEnv.port}`))
-    if (!resolvedEnv.allowWrite && !resolvedEnv.allowAll) {
-      clack.log.warn(styleText('yellow', 'Filesystem writes disabled. Use --allow-write or --allow-all to enable.'))
-    }
-
-    if (!(await isPortAvailable(numericPort, resolvedEnv.host))) {
-      clack.log.error(styleText('red', `Port ${resolvedEnv.port} is already in use. Stop the existing process or choose a different port with --port.`))
-      process.exit(1)
-    }
-
-    // Spawns the server as a detached background process so the CLI can exit independently.
-    await spawnAsync('node', [serverPath], {
-      env: resolvedEnv.env,
-      cwd: process.cwd(),
-    })
-
-    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)
-  }
-}