@kubb/cli 5.0.0-alpha.1 → 5.0.0-alpha.11

package/dist/{validate-l8vLmwKA.js.map → validate-BImbbx1t.js.map}

@@ -1 +1 @@
-{"version":3,"file":"validate-l8vLmwKA.js","names":[],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport { getErrorMessage } from '@internals/utils'\nimport type * as OasModule from '@kubb/oas'\nimport { jiti } from '../utils/jiti.ts'\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  let mod: typeof OasModule\n  try {\n    mod = (await jiti.import('@kubb/oas', { default: true })) as typeof OasModule\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(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.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;AAWA,eAAsB,YAAY,EAAE,OAAO,WAA2C;CACpF,IAAI;AACJ,KAAI;AACF,QAAO,MAAM,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;UACjD,IAAI;AACX,UAAQ,MAAM,qDAAqD;AACnE,UAAQ,KAAK,EAAE;;CAGjB,MAAM,EAAE,UAAU;CAClB,MAAM,UAAU,QAAQ,QAAQ;AAChC,KAAI;AAEF,SADY,MAAM,MAAM,MAAM,EACpB,UAAU;AAEpB,QAAM,cAAc,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAW,CAAC,CAAC;AACnH,UAAQ,IAAI,uBAAuB;UAC5B,OAAO;AACd,QAAM,cAAc,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAU,CAAC,CAAC;AAClH,UAAQ,MAAM,sBAAsB;AACpC,UAAQ,MAAM,gBAAgB,MAAM,CAAC;AACrC,UAAQ,KAAK,EAAE"}
+{"version":3,"file":"validate-BImbbx1t.js","names":[],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport { getErrorMessage } from '@internals/utils'\nimport type * as OasModule from '@kubb/oas'\nimport { jiti } from '../utils/jiti.ts'\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  let mod: typeof OasModule\n  try {\n    mod = (await jiti.import('@kubb/oas', { default: true })) as typeof OasModule\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(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.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;AAWA,eAAsB,YAAY,EAAE,OAAO,WAA2C;CACpF,IAAI;AACJ,KAAI;AACF,QAAO,MAAM,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;UACjD,IAAI;AACX,UAAQ,MAAM,qDAAqD;AACnE,UAAQ,KAAK,EAAE;;CAGjB,MAAM,EAAE,UAAU;CAClB,MAAM,UAAU,QAAQ,QAAQ;AAChC,KAAI;AAEF,SADY,MAAM,MAAM,MAAM,EACpB,UAAU;AAEpB,QAAM,cAAc,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAW,CAAC,CAAC;AACnH,UAAQ,IAAI,uBAAuB;UAC5B,OAAO;AACd,QAAM,cAAc,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAU,CAAC,CAAC;AAClH,UAAQ,MAAM,sBAAsB;AACpC,UAAQ,MAAM,gBAAgB,MAAM,CAAC;AACrC,UAAQ,KAAK,EAAE"}

package/dist/{validate-tj-fCEwB.js → validate-DTllDsSn.js}

@@ -1,6 +1,6 @@
 import "./chunk--u3MIqq1.js";
 import { n as defineCommand } from "./define--M_JMcDC.js";
-import { t as version } from "./package-fz4uup_a.js";
+import { t as version } from "./package-BPoYTLqk.js";
 //#region src/commands/validate.ts
 const command = defineCommand({
 	name: "validate",
@@ -12,7 +12,7 @@ const command = defineCommand({
 		required: true
 	} },
 	async run({ values }) {
-		const { runValidate } = await import("./validate-l8vLmwKA.js");
+		const { runValidate } = await import("./validate-BImbbx1t.js");
 		await runValidate({
 			input: values.input,
 			version
@@ -22,4 +22,4 @@ const command = defineCommand({
 //#endregion
 export { command };
 
-//# sourceMappingURL=validate-tj-fCEwB.js.map
+//# sourceMappingURL=validate-DTllDsSn.js.map

package/dist/{validate-tj-fCEwB.js.map → validate-DTllDsSn.js.map}

@@ -1 +1 @@
-{"version":3,"file":"validate-tj-fCEwB.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: { type: 'string', description: 'Path to Swagger/OpenAPI file', short: 'i', required: true },\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;EAAE,MAAM;EAAU,aAAa;EAAgC,OAAO;EAAK,UAAU;EAAM,EACnG;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,gBAAgB,MAAM,OAAO;AAErC,QAAM,YAAY;GAAE,OAAO,OAAO;GAAO;GAAS,CAAC;;CAEtD,CAAC"}
+{"version":3,"file":"validate-DTllDsSn.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: { type: 'string', description: 'Path to Swagger/OpenAPI file', short: 'i', required: true },\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;EAAE,MAAM;EAAU,aAAa;EAAgC,OAAO;EAAK,UAAU;EAAM,EACnG;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-BugLA3jw.cjs → validate-P6Zttj3f.cjs}

@@ -1,6 +1,6 @@
 require("./chunk-ByKO4r7w.cjs");
 const require_define = require("./define-D6Kfm7-Z.cjs");
-const require_package = require("./package-Dj3K_LEj.cjs");
+const require_package = require("./package-BMz8d3aM.cjs");
 //#region src/commands/validate.ts
 const command = require_define.defineCommand({
 	name: "validate",
@@ -12,7 +12,7 @@ const command = require_define.defineCommand({
 		required: true
 	} },
 	async run({ values }) {
-		const { runValidate } = await Promise.resolve().then(() => require("./validate-Bbrn3Q-A.cjs"));
+		const { runValidate } = await Promise.resolve().then(() => require("./validate-ujLCYSWU.cjs"));
 		await runValidate({
 			input: values.input,
 			version: require_package.version
@@ -22,4 +22,4 @@ const command = require_define.defineCommand({
 //#endregion
 exports.command = command;
 
-//# sourceMappingURL=validate-BugLA3jw.cjs.map
+//# sourceMappingURL=validate-P6Zttj3f.cjs.map

package/dist/{validate-BugLA3jw.cjs.map → validate-P6Zttj3f.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"validate-BugLA3jw.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: { type: 'string', description: 'Path to Swagger/OpenAPI file', short: 'i', required: true },\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;EAAE,MAAM;EAAU,aAAa;EAAgC,OAAO;EAAK,UAAU;EAAM,EACnG;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"}
+{"version":3,"file":"validate-P6Zttj3f.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: { type: 'string', description: 'Path to Swagger/OpenAPI file', short: 'i', required: true },\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;EAAE,MAAM;EAAU,aAAa;EAAgC,OAAO;EAAK,UAAU;EAAM,EACnG;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-Bbrn3Q-A.cjs → validate-ujLCYSWU.cjs}

@@ -1,6 +1,6 @@
 const require_chunk = require("./chunk-ByKO4r7w.cjs");
 const require_errors = require("./errors-DBW0N9w4.cjs");
-const require_telemetry = require("./telemetry-Cn9X1I5B.cjs");
+const require_telemetry = require("./telemetry-DZ7IrLAU.cjs");
 const require_jiti = require("./jiti-Cd3S0xwr.cjs");
 let node_process = require("node:process");
 node_process = require_chunk.__toESM(node_process);
@@ -39,4 +39,4 @@ async function runValidate({ input, version }) {
 //#endregion
 exports.runValidate = runValidate;
 
-//# sourceMappingURL=validate-Bbrn3Q-A.cjs.map
+//# sourceMappingURL=validate-ujLCYSWU.cjs.map

package/dist/{validate-Bbrn3Q-A.cjs.map → validate-ujLCYSWU.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"validate-Bbrn3Q-A.cjs","names":["jiti","process","sendTelemetry","buildTelemetryEvent","getErrorMessage"],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport { getErrorMessage } from '@internals/utils'\nimport type * as OasModule from '@kubb/oas'\nimport { jiti } from '../utils/jiti.ts'\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  let mod: typeof OasModule\n  try {\n    mod = (await jiti.import('@kubb/oas', { default: true })) as typeof OasModule\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(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.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;;AAWA,eAAsB,YAAY,EAAE,OAAO,WAA2C;CACpF,IAAI;AACJ,KAAI;AACF,QAAO,MAAMA,aAAAA,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;UACjD,IAAI;AACX,UAAQ,MAAM,qDAAqD;AACnE,eAAA,QAAQ,KAAK,EAAE;;CAGjB,MAAM,EAAE,UAAU;CAClB,MAAM,UAAUC,aAAAA,QAAQ,QAAQ;AAChC,KAAI;AAEF,SADY,MAAM,MAAM,MAAM,EACpB,UAAU;AAEpB,QAAMC,kBAAAA,cAAcC,kBAAAA,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAW,CAAC,CAAC;AACnH,UAAQ,IAAI,uBAAuB;UAC5B,OAAO;AACd,QAAMD,kBAAAA,cAAcC,kBAAAA,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAU,CAAC,CAAC;AAClH,UAAQ,MAAM,sBAAsB;AACpC,UAAQ,MAAMC,eAAAA,gBAAgB,MAAM,CAAC;AACrC,eAAA,QAAQ,KAAK,EAAE"}
+{"version":3,"file":"validate-ujLCYSWU.cjs","names":["jiti","process","sendTelemetry","buildTelemetryEvent","getErrorMessage"],"sources":["../src/runners/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport { getErrorMessage } from '@internals/utils'\nimport type * as OasModule from '@kubb/oas'\nimport { jiti } from '../utils/jiti.ts'\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  let mod: typeof OasModule\n  try {\n    mod = (await jiti.import('@kubb/oas', { default: true })) as typeof OasModule\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(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.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":";;;;;;;AAWA,eAAsB,YAAY,EAAE,OAAO,WAA2C;CACpF,IAAI;AACJ,KAAI;AACF,QAAO,MAAMA,aAAAA,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;UACjD,IAAI;AACX,UAAQ,MAAM,qDAAqD;AACnE,eAAA,QAAQ,KAAK,EAAE;;CAGjB,MAAM,EAAE,UAAU;CAClB,MAAM,UAAUC,aAAAA,QAAQ,QAAQ;AAChC,KAAI;AAEF,SADY,MAAM,MAAM,MAAM,EACpB,UAAU;AAEpB,QAAMC,kBAAAA,cAAcC,kBAAAA,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAW,CAAC,CAAC;AACnH,UAAQ,IAAI,uBAAuB;UAC5B,OAAO;AACd,QAAMD,kBAAAA,cAAcC,kBAAAA,oBAAoB;GAAE,SAAS;GAAY,aAAa;GAAS;GAAS,QAAQ;GAAU,CAAC,CAAC;AAClH,UAAQ,MAAM,sBAAsB;AACpC,UAAQ,MAAMC,eAAAA,gBAAgB,MAAM,CAAC;AACrC,eAAA,QAAQ,KAAK,EAAE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/cli",
-  "version": "5.0.0-alpha.1",
+  "version": "5.0.0-alpha.11",
   "description": "Command-line interface for Kubb, enabling easy generation of TypeScript, React-Query, Zod, and other code from OpenAPI specifications.",
   "keywords": [
     "cli",
@@ -58,14 +58,14 @@
     "cosmiconfig": "^9.0.1",
     "jiti": "2.5.1",
     "tinyexec": "^1.0.4",
-    "@kubb/core": "5.0.0-alpha.1"
+    "@kubb/core": "5.0.0-alpha.11"
   },
   "devDependencies": {
     "source-map-support": "^0.5.21",
     "@internals/utils": "0.0.0",
-    "@kubb/agent": "5.0.0-alpha.1",
-    "@kubb/mcp": "5.0.0-alpha.1",
-    "@kubb/oas": "5.0.0-alpha.1"
+    "@kubb/agent": "5.0.0-alpha.11",
+    "@kubb/mcp": "5.0.0-alpha.11",
+    "@kubb/oas": "5.0.0-alpha.11"
   },
   "engines": {
     "node": ">=22"

package/src/constants.ts

@@ -1,33 +1,78 @@
-/** NPM registry endpoint used to check for @kubb/cli updates. */
+/**
+ * NPM registry endpoint used to check for @kubb/cli updates.
+ */
 export const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const
 
-/** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */
+/**
+ * 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. */
+/**
+ * Horizontal rule rendered above/below the plain-logger generation summary.
+ */
 export const SUMMARY_SEPARATOR = '─'.repeat(27)
 
-/** Maximum number of █ characters in a plugin timing bar. */
+/**
+ * Maximum number of █ characters in a plugin timing bar.
+ */
 export const SUMMARY_MAX_BAR_LENGTH = 10 as const
 
-/** Divides elapsed milliseconds into bar-length units (1 block per 100 ms). */
+/**
+ * Divides elapsed milliseconds into bar-length units (1 block per 100 ms).
+ */
 export const SUMMARY_TIME_SCALE_DIVISOR = 100 as const
 
-/** Glob pattern for paths the file watcher ignores. */
+/**
+ * Glob pattern for paths the file watcher ignores.
+ */
 export const WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const
 
-/** Default runtime values for the `agent start` command. */
+/**
+ * Flags that short-circuit execution (help/version) — no telemetry notice is shown.
+ */
+export const QUITE_FLAGS = new Set(['--help', '-h', '--version', '-v'] as const)
+
+/**
+ * Flags accepted by the `generate` command.
+ */
+export const GENERATE_FLAGS = new Set(['--config', '-c', '--log-level', '-l', '--watch', '-w', '--debug', '-d', '--verbose', '-v', '--silent', '-s'] as const)
+
+/**
+ * Flags accepted by the `validate` command.
+ */
+export const VALIDATE_FLAGS = new Set(['--input', '-i'] as const)
+
+/**
+ * Flags accepted by the `init` command.
+ */
+export const INIT_FLAGS = new Set(['--yes', '-y'] as const)
+
+/**
+ * Flags accepted by the `agent start` command.
+ */
+export const AGENT_START_FLAGS = new Set(['--config', '-c', '--port', '-p', '--host', '--allow-write', '--allow-all'] as const)
+
+/**
+ * All known CLI flags across every command.
+ */
+export const ARGS = new Set([...QUITE_FLAGS, ...GENERATE_FLAGS, ...VALIDATE_FLAGS, ...INIT_FLAGS, ...AGENT_START_FLAGS] as const)
+
 export const agentDefaults = {
   port: '3000',
   host: 'localhost',
   configFile: 'kubb.config.ts',
   retryTimeout: '30000',
   studioUrl: 'https://studio.kubb.dev',
-  /** Relative path from the @kubb/agent package root to the server entry. */
+  /**
+   * Relative path from the @kubb/agent package root to the server entry.
+   */
   serverEntryPath: '.output/server/index.mjs',
 } as const
 
-/** Default values used during interactive `init` scaffolding. */
+/**
+ * Default values used during interactive `init` scaffolding.
+ */
 export const initDefaults = {
   inputPath: './openapi.yaml',
   outputPath: './src/gen',
@@ -73,4 +118,6 @@ export const pluginDefaultConfigs = {
     })`,
 } as const satisfies Record<string, string>
 
-/** Color palette used by randomCliColor() for deterministic plugin name coloring. */
+/**
+ * Color palette used by randomCliColor() for deterministic plugin name coloring.
+ */

package/src/index.ts

@@ -1,17 +1,18 @@
 import { styleText } from 'node:util'
 import { createCLI } from '@internals/utils'
 import { version } from '../package.json'
+import { QUITE_FLAGS } from './constants.ts'
+import { isFlag } from './utils/flags.ts'
 import { isTelemetryDisabled } from './utils/telemetry.ts'
 
 const cli = createCLI()
 
-function shouldShowTelemetryNotice(argv: string[]): boolean {
+function shouldShowTelemetryNotice(argv: Array<string>): boolean {
   if (isTelemetryDisabled()) {
     return false
   }
   // Skip when the user is just asking for help or version info
-  const quietFlags = new Set(['--help', '-h', '--version', '-v'])
-  if (argv.some((arg) => quietFlags.has(arg))) {
+  if (argv.some((arg) => isFlag(QUITE_FLAGS, arg))) {
     return false
   }
   // Skip in non-interactive / scripting contexts
@@ -21,7 +22,7 @@ function shouldShowTelemetryNotice(argv: string[]): boolean {
   return true
 }
 
-export async function run(argv: string[] = process.argv): Promise<void> {
+export async function run(argv: Array<string> = process.argv): Promise<void> {
   if (shouldShowTelemetryNotice(argv)) {
     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`,

package/src/loggers/clackLogger.ts

@@ -2,9 +2,8 @@ import { relative } from 'node:path'
 import process from 'node:process'
 import { styleText } from 'node:util'
 import * as clack from '@clack/prompts'
-import { formatMs, formatMsWithColor, toCause } from '@internals/utils'
+import { formatMs, formatMsWithColor, getIntro, toCause } from '@internals/utils'
 import { defineLogger, logLevel as logLevelMap } from '@kubb/core'
-import { getIntro } from '../utils/getIntro.ts'
 import { getSummary } from '../utils/getSummary.ts'
 import { runHook } from '../utils/runHook.ts'
 import { ClackWritable } from '../utils/Writables.ts'

package/src/runners/generate.ts

@@ -16,7 +16,6 @@ import {
   type KubbEvents,
   linters,
   logLevel as logLevelMap,
-  PromiseManager,
   safeBuild,
   setup,
 } from '@kubb/core'
@@ -159,7 +158,7 @@ async function generate({ input, config: userConfig, events, logLevel }: Generat
 
   await events.emit('info', config.name ? `Setup generation ${styleText('bold', config.name)}` : 'Setup generation', inputPath)
 
-  const { sources, fabric, pluginManager } = await setup({
+  const { sources, fabric, driver } = await setup({
     config,
     events,
   })
@@ -171,7 +170,7 @@ async function generate({ input, config: userConfig, events, logLevel }: Generat
       config,
       events,
     },
-    { pluginManager, fabric, events, sources },
+    { driver, fabric, events, sources },
   )
 
   await events.emit('info', 'Load summary')
@@ -206,7 +205,7 @@ async function generate({ input, config: userConfig, events, logLevel }: Generat
       buildTelemetryEvent({
         command: 'generate',
         kubbVersion: version,
-        plugins: pluginManager.plugins.map((p) => ({ name: p.name, options: p.options as Record<string, unknown> })),
+        plugins: driver.plugins.map((p) => ({ name: p.name, options: p.options as Record<string, unknown> })),
         hrStart,
         filesCreated: files.length,
         status: 'failed',
@@ -274,7 +273,7 @@ async function generate({ input, config: userConfig, events, logLevel }: Generat
   const telemetryEvent = buildTelemetryEvent({
     command: 'generate',
     kubbVersion: version,
-    plugins: pluginManager.plugins.map((p) => ({ name: p.name, options: p.options as Record<string, unknown> })),
+    plugins: driver.plugins.map((p) => ({ name: p.name, options: p.options as Record<string, unknown> })),
     hrStart,
     filesCreated: files.length,
     status: 'success',
@@ -293,7 +292,6 @@ type GenerateCommandOptions = {
 export async function runGenerateCommand({ input, configPath, logLevel: logLevelKey, watch }: GenerateCommandOptions): Promise<void> {
   const logLevel = logLevelMap[logLevelKey as keyof typeof logLevelMap] ?? logLevelMap.info
   const events = new AsyncEventEmitterClass<KubbEvents>()
-  const promiseManager = new PromiseManager()
 
   await setupLogger(events, { logLevel })
 
@@ -322,26 +320,20 @@ export async function runGenerateCommand({ input, configPath, logLevel: logLevel
 
     await events.emit('lifecycle:start', version)
 
-    const promises = configs.map((config) => {
-      return async () => {
-        if (isInputPath(config) && watch) {
-          await startWatcher([input || config.input.path], async (paths) => {
-            // remove to avoid duplicate listeners after each change
-            events.removeAll()
+    for (const config of configs) {
+      if (isInputPath(config) && watch) {
+        await startWatcher([input || config.input.path], async (paths) => {
+          // remove to avoid duplicate listeners after each change
+          events.removeAll()
 
-            await generate({ input, config, logLevel, events })
-
-            clack.log.step(styleText('yellow', `Watching for changes in ${paths.join(' and ')}`))
-          })
-
-          return
-        }
+          await generate({ input, config, logLevel, events })
 
+          clack.log.step(styleText('yellow', `Watching for changes in ${paths.join(' and ')}`))
+        })
+      } else {
         await generate({ input, config, logLevel, events })
       }
-    })
-
-    await promiseManager.run('seq', promises)
+    }
 
     await events.emit('lifecycle:end')
   } catch (error) {

package/src/types.ts

@@ -0,0 +1,11 @@
+export type QuiteFlag = '--help' | '-h' | '--version' | '-v'
+
+export type GenerateFlag = '--config' | '-c' | '--log-level' | '-l' | '--watch' | '-w' | '--debug' | '-d' | '--verbose' | '-v' | '--silent' | '-s'
+
+export type ValidateFlag = '--input' | '-i'
+
+export type InitFlag = '--yes' | '-y'
+
+export type AgentStartFlag = '--config' | '-c' | '--port' | '-p' | '--host' | '--allow-write' | '--allow-all'
+
+export type Arg = QuiteFlag | GenerateFlag | ValidateFlag | InitFlag | AgentStartFlag

package/src/utils/flags.ts

@@ -0,0 +1,10 @@
+/**
+ * Type guard that checks whether a raw string is a member of a typed flag set.
+ * Avoids the need for type assertions when working with `Set<T extends string>`.
+ */
+export function isFlag<T extends string>(set: ReadonlySet<T>, value: string): value is T {
+  for (const flag of set) {
+    if (flag === value) return true
+  }
+  return false
+}

package/dist/constants-BTUap0zs.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants-BTUap0zs.cjs","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/** NPM registry endpoint used to check for @kubb/cli updates. */\nexport const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const\n\n/** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */\nexport const OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const\n\n/** Horizontal rule rendered above/below the plain-logger generation summary. */\nexport const SUMMARY_SEPARATOR = '─'.repeat(27)\n\n/** Maximum number of █ characters in a plugin timing bar. */\nexport const SUMMARY_MAX_BAR_LENGTH = 10 as const\n\n/** Divides elapsed milliseconds into bar-length units (1 block per 100 ms). */\nexport const SUMMARY_TIME_SCALE_DIVISOR = 100 as const\n\n/** Glob pattern for paths the file watcher ignores. */\nexport const WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const\n\n/** Default runtime values for the `agent start` command. */\nexport const agentDefaults = {\n  port: '3000',\n  host: 'localhost',\n  configFile: 'kubb.config.ts',\n  retryTimeout: '30000',\n  studioUrl: 'https://studio.kubb.dev',\n  /** Relative path from the @kubb/agent package root to the server entry. */\n  serverEntryPath: '.output/server/index.mjs',\n} as const\n\n/** Default values used during interactive `init` scaffolding. */\nexport const initDefaults = {\n  inputPath: './openapi.yaml',\n  outputPath: './src/gen',\n  plugins: ['plugin-oas', 'plugin-ts'],\n} as const\n\n/**\n * Maps each plugin value to the default config snippet inserted by `init`.\n * The `satisfies` constraint ensures all values remain plain strings while\n * `as const` keeps the object deeply immutable.\n */\nexport const pluginDefaultConfigs = {\n  'plugin-oas': 'pluginOas()',\n  'plugin-ts': `pluginTs({\n      output: { path: 'models' },\n    })`,\n  'plugin-client': `pluginClient({\n      output: { path: 'clients' },\n    })`,\n  'plugin-react-query': `pluginReactQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-solid-query': `pluginSolidQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-svelte-query': `pluginSvelteQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-vue-query': `pluginVueQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-swr': `pluginSwr({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-zod': `pluginZod({\n      output: { path: 'zod' },\n    })`,\n  'plugin-faker': `pluginFaker({\n      output: { path: 'mocks' },\n    })`,\n  'plugin-msw': `pluginMsw({\n      output: { path: 'msw' },\n    })`,\n} as const satisfies Record<string, string>\n\n/** Color palette used by randomCliColor() for deterministic plugin name coloring. */\n"],"mappings":";;AACA,MAAa,uBAAuB;;AAGpC,MAAa,gBAAgB;;AAG7B,MAAa,oBAAoB,IAAI,OAAO,GAAG;;AAS/C,MAAa,wBAAwB;;AAGrC,MAAa,gBAAgB;CAC3B,MAAM;CACN,MAAM;CACN,YAAY;CACZ,cAAc;CACd,WAAW;CAEX,iBAAiB;CAClB;;AAGD,MAAa,eAAe;CAC1B,WAAW;CACX,YAAY;CACZ,SAAS,CAAC,cAAc,YAAY;CACrC;;;;;;AAOD,MAAa,uBAAuB;CAClC,cAAc;CACd,aAAa;;;CAGb,iBAAiB;;;CAGjB,sBAAsB;;;CAGtB,sBAAsB;;;CAGtB,uBAAuB;;;CAGvB,oBAAoB;;;CAGpB,cAAc;;;CAGd,cAAc;;;CAGd,gBAAgB;;;CAGhB,cAAc;;;CAGf"}

package/dist/constants-CM3dJzjK.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants-CM3dJzjK.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/** NPM registry endpoint used to check for @kubb/cli updates. */\nexport const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const\n\n/** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */\nexport const OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const\n\n/** Horizontal rule rendered above/below the plain-logger generation summary. */\nexport const SUMMARY_SEPARATOR = '─'.repeat(27)\n\n/** Maximum number of █ characters in a plugin timing bar. */\nexport const SUMMARY_MAX_BAR_LENGTH = 10 as const\n\n/** Divides elapsed milliseconds into bar-length units (1 block per 100 ms). */\nexport const SUMMARY_TIME_SCALE_DIVISOR = 100 as const\n\n/** Glob pattern for paths the file watcher ignores. */\nexport const WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const\n\n/** Default runtime values for the `agent start` command. */\nexport const agentDefaults = {\n  port: '3000',\n  host: 'localhost',\n  configFile: 'kubb.config.ts',\n  retryTimeout: '30000',\n  studioUrl: 'https://studio.kubb.dev',\n  /** Relative path from the @kubb/agent package root to the server entry. */\n  serverEntryPath: '.output/server/index.mjs',\n} as const\n\n/** Default values used during interactive `init` scaffolding. */\nexport const initDefaults = {\n  inputPath: './openapi.yaml',\n  outputPath: './src/gen',\n  plugins: ['plugin-oas', 'plugin-ts'],\n} as const\n\n/**\n * Maps each plugin value to the default config snippet inserted by `init`.\n * The `satisfies` constraint ensures all values remain plain strings while\n * `as const` keeps the object deeply immutable.\n */\nexport const pluginDefaultConfigs = {\n  'plugin-oas': 'pluginOas()',\n  'plugin-ts': `pluginTs({\n      output: { path: 'models' },\n    })`,\n  'plugin-client': `pluginClient({\n      output: { path: 'clients' },\n    })`,\n  'plugin-react-query': `pluginReactQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-solid-query': `pluginSolidQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-svelte-query': `pluginSvelteQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-vue-query': `pluginVueQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-swr': `pluginSwr({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-zod': `pluginZod({\n      output: { path: 'zod' },\n    })`,\n  'plugin-faker': `pluginFaker({\n      output: { path: 'mocks' },\n    })`,\n  'plugin-msw': `pluginMsw({\n      output: { path: 'msw' },\n    })`,\n} as const satisfies Record<string, string>\n\n/** Color palette used by randomCliColor() for deterministic plugin name coloring. */\n"],"mappings":";;AACA,MAAa,uBAAuB;;AAGpC,MAAa,gBAAgB;;AAG7B,MAAa,oBAAoB,IAAI,OAAO,GAAG;;AAS/C,MAAa,wBAAwB;;AAGrC,MAAa,gBAAgB;CAC3B,MAAM;CACN,MAAM;CACN,YAAY;CACZ,cAAc;CACd,WAAW;CAEX,iBAAiB;CAClB;;AAGD,MAAa,eAAe;CAC1B,WAAW;CACX,YAAY;CACZ,SAAS,CAAC,cAAc,YAAY;CACrC;;;;;;AAOD,MAAa,uBAAuB;CAClC,cAAc;CACd,aAAa;;;CAGb,iBAAiB;;;CAGjB,sBAAsB;;;CAGtB,sBAAsB;;;CAGtB,uBAAuB;;;CAGvB,oBAAoB;;;CAGpB,cAAc;;;CAGd,cAAc;;;CAGd,gBAAgB;;;CAGhB,cAAc;;;CAGf"}