@kubb/cli 5.0.0-alpha.7 → 5.0.0-alpha.71

package/README.md

@@ -4,12 +4,12 @@
     <img width="180" src="https://raw.githubusercontent.com/kubb-labs/kubb/main/assets/logo.png" alt="Kubb logo">
   </a>
 
-
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
 [![Coverage][coverage-src]][coverage-href]
 [![License][license-src]][license-href]
 [![Sponsors][sponsors-src]][sponsors-href]
+
 <h4>
     <a href="https://codesandbox.io/s/github/kubb-labs/kubb/tree/main//examples/typescript" target="_blank">View Demo</a>
     <span> · </span>
@@ -38,11 +38,13 @@ npx kubb init -y
 ```
 
 Defaults when using `-y`:
+
 - Input path: `./openapi.yaml`
 - Output path: `./src/gen`
 - Plugins: OpenAPI Parser + TypeScript
 
 This command will:
+
 1. Detect or create a `package.json` if it doesn't exist
 2. Prompt you for your OpenAPI specification path (default: `./openapi.yaml`)
 3. Ask for the output directory for generated files (default: `./src/gen`)
@@ -59,6 +61,7 @@ npx kubb generate
 ```
 
 Options:
+
 - `-c, --config <path>` - Path to the Kubb config file
 - `-l, --logLevel <level>` - Set log level (silent, info, verbose, debug)
 - `-w, --watch` - Watch mode based on the input file
@@ -94,7 +97,6 @@ Kubb uses an MIT-licensed open source project with its ongoing development made
   </a>
 </p>
 
-
 <!-- Badges -->
 
 [npm-version-src]: https://img.shields.io/npm/v/@kubb/cli?flat&colorA=18181B&colorB=f58517

package/bin/kubb.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+process.setSourceMapsEnabled?.(true)
+
+const { run } = await import('../dist/index.js')
+process.title = 'Kubb'
+run(process.argv)

package/dist/agent-CouS-H2S.js

@@ -0,0 +1,112 @@
+import "./chunk--u3MIqq1.js";
+import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-CS5ZE0cN.js";
+import { t as spawnAsync } from "./shell-DLzN4fRo.js";
+import { s as agentDefaults } from "./constants-mIdg9ls2.js";
+import { styleText } from "node:util";
+import path from "node:path";
+import * as process$1 from "node:process";
+import net from "node:net";
+import { fileURLToPath } from "node:url";
+import * as clack from "@clack/prompts";
+//#region src/runners/agent.ts
+/**
+* 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 }) {
+	const resolvedPort = port ?? process$1.env.PORT ?? agentDefaults.port;
+	const resolvedHost = host !== agentDefaults.host ? host : process$1.env.HOST ?? agentDefaults.host;
+	const resolvedAllowAll = allowAll || process$1.env.KUBB_AGENT_ALLOW_ALL === "true";
+	const resolvedAllowWrite = resolvedAllowAll || allowWrite || process$1.env.KUBB_AGENT_ALLOW_WRITE === "true";
+	const agentRoot = process$1.env.KUBB_AGENT_ROOT ?? process$1.cwd();
+	const agentConfigPath = path.resolve(process$1.cwd(), configPath || process$1.env.KUBB_AGENT_CONFIG || agentDefaults.configFile);
+	return {
+		port: resolvedPort,
+		host: resolvedHost,
+		allowWrite: resolvedAllowWrite,
+		allowAll: resolvedAllowAll,
+		agentConfigPath,
+		env: {
+			...process$1.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$1.env.KUBB_AGENT_TOKEN,
+			KUBB_AGENT_RETRY_TIMEOUT: process$1.env.KUBB_AGENT_RETRY_TIMEOUT ?? agentDefaults.retryTimeout,
+			KUBB_STUDIO_URL: process$1.env.KUBB_STUDIO_URL ?? agentDefaults.studioUrl
+		}
+	};
+}
+function isPortAvailable(port, host) {
+	return new Promise((resolve) => {
+		const server = net.createServer();
+		server.once("error", () => resolve(false));
+		server.once("listening", () => {
+			server.close();
+			resolve(true);
+		});
+		server.listen(port, host);
+	});
+}
+async function runAgentStart({ port, host, configPath, allowWrite, allowAll, version }) {
+	const hrStart = process$1.hrtime();
+	try {
+		try {
+			process$1.loadEnvFile();
+		} catch {}
+		let agentPkgUrl;
+		try {
+			agentPkgUrl = import.meta.resolve("@kubb/agent/package.json");
+		} catch (_e) {
+			console.error(`Import of '@kubb/agent' is required to start the Agent server`);
+			process$1.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$1.exit(1);
+		}
+		await spawnAsync("node", [serverPath], {
+			env: resolvedEnv.env,
+			cwd: process$1.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$1.exit(1);
+	}
+}
+//#endregion
+export { runAgentStart };
+
+//# sourceMappingURL=agent-CouS-H2S.js.map

package/dist/agent-CouS-H2S.js.map

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

package/dist/{agent-Cc-0-A8t.cjs → agent-D5OIwM0z.cjs}

@@ -1,7 +1,7 @@
 require("./chunk-ByKO4r7w.cjs");
-const require_define = require("./define-D6Kfm7-Z.cjs");
-const require_package = require("./package-DZb6I8FQ.cjs");
-const require_constants = require("./constants-BTUap0zs.cjs");
+const require_define = require("./define-Bdn8j5VM.cjs");
+const require_package = require("./package-DsKVMEXO.cjs");
+const require_constants = require("./constants-BgLUQ1nx.cjs");
 //#region src/commands/agent/start.ts
 const command$1 = require_define.defineCommand({
 	name: "start",
@@ -34,7 +34,7 @@ const command$1 = require_define.defineCommand({
 		}
 	},
 	async run({ values }) {
-		const { runAgentStart } = await Promise.resolve().then(() => require("./agent-C6o_6GSJ.cjs"));
+		const { runAgentStart } = await Promise.resolve().then(() => require("./agent-Zo8CQwxZ.cjs"));
 		await runAgentStart({
 			port: values.port !== void 0 ? values.port : void 0,
 			host: values.host,
@@ -55,4 +55,4 @@ const command = require_define.defineCommand({
 //#endregion
 exports.command = command;
 
-//# sourceMappingURL=agent-Cc-0-A8t.cjs.map
+//# sourceMappingURL=agent-D5OIwM0z.cjs.map

package/dist/agent-D5OIwM0z.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-D5OIwM0z.cjs","names":["command","defineCommand","agentDefaults","defineCommand","startCommand"],"sources":["../src/commands/agent/start.ts","../src/commands/agent.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../../package.json'\nimport { agentDefaults } from '../../constants.ts'\n\nexport const command = defineCommand({\n  name: 'start',\n  description: 'Start the Agent server',\n  options: {\n    config: {\n      type: 'string',\n      description: 'Path to the Kubb config',\n      short: 'c',\n    },\n    port: {\n      type: 'string',\n      description: `Port for the server (default: ${agentDefaults.port})`,\n      short: 'p',\n    },\n    host: {\n      type: 'string',\n      description: 'Host for the server',\n      default: agentDefaults.host,\n    },\n    'allow-write': {\n      type: 'boolean',\n      description: 'Allow writing generated files to the filesystem. When not set, no files are written and the config patch is not persisted.',\n      default: false,\n    },\n    'allow-all': {\n      type: 'boolean',\n      description: 'Grant all permissions (implies --allow-write).',\n      default: false,\n    },\n  },\n  async run({ values }) {\n    const { runAgentStart } = await import('../../runners/agent.ts')\n\n    await runAgentStart({\n      port: values.port !== undefined ? values.port : undefined,\n      host: values.host,\n      configPath: values.config,\n      allowWrite: values['allow-write'],\n      allowAll: values['allow-all'],\n      version,\n    })\n  },\n})\n","import { defineCommand } from '@internals/utils'\nimport { command as startCommand } from './agent/start.ts'\n\nexport const command = defineCommand({\n  name: 'agent',\n  description: 'Manage the Kubb Agent server',\n  subCommands: [startCommand],\n})\n"],"mappings":";;;;;AAIA,MAAaA,YAAUC,eAAAA,cAAc;CACnC,MAAM;CACN,aAAa;CACb,SAAS;EACP,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACR;EACD,MAAM;GACJ,MAAM;GACN,aAAa,iCAAiCC,kBAAAA,cAAc,KAAK;GACjE,OAAO;GACR;EACD,MAAM;GACJ,MAAM;GACN,aAAa;GACb,SAASA,kBAAAA,cAAc;GACxB;EACD,eAAe;GACb,MAAM;GACN,aAAa;GACb,SAAS;GACV;EACD,aAAa;GACX,MAAM;GACN,aAAa;GACb,SAAS;GACV;EACF;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,kBAAkB,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,uBAAA,CAAA;AAEhC,QAAM,cAAc;GAClB,MAAM,OAAO,SAAS,KAAA,IAAY,OAAO,OAAO,KAAA;GAChD,MAAM,OAAO;GACb,YAAY,OAAO;GACnB,YAAY,OAAO;GACnB,UAAU,OAAO;GACjB,SAAA,gBAAA;GACD,CAAC;;CAEL,CAAC;;;AC3CF,MAAa,UAAUC,eAAAA,cAAc;CACnC,MAAM;CACN,aAAa;CACb,aAAa,CAACC,UAAa;CAC5B,CAAC"}

package/dist/{agent-CjXjyuPe.js → agent-DypvJBwO.js}

@@ -1,7 +1,7 @@
 import "./chunk--u3MIqq1.js";
-import { n as defineCommand } from "./define--M_JMcDC.js";
-import { t as version } from "./package-DLd3fZNd.js";
-import { a as agentDefaults } from "./constants-CM3dJzjK.js";
+import { n as defineCommand } from "./define-Ctii4bel.js";
+import { t as version } from "./package-BD90dOVc.js";
+import { s as agentDefaults } from "./constants-mIdg9ls2.js";
 //#endregion
 //#region src/commands/agent.ts
 const command = defineCommand({
@@ -38,7 +38,7 @@ const command = defineCommand({
 			}
 		},
 		async run({ values }) {
-			const { runAgentStart } = await import("./agent-L50VNhXv.js");
+			const { runAgentStart } = await import("./agent-CouS-H2S.js");
 			await runAgentStart({
 				port: values.port !== void 0 ? values.port : void 0,
 				host: values.host,
@@ -53,4 +53,4 @@ const command = defineCommand({
 //#endregion
 export { command };
 
-//# sourceMappingURL=agent-CjXjyuPe.js.map
+//# sourceMappingURL=agent-DypvJBwO.js.map

package/dist/agent-DypvJBwO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-DypvJBwO.js","names":["command","startCommand"],"sources":["../src/commands/agent/start.ts","../src/commands/agent.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../../package.json'\nimport { agentDefaults } from '../../constants.ts'\n\nexport const command = defineCommand({\n  name: 'start',\n  description: 'Start the Agent server',\n  options: {\n    config: {\n      type: 'string',\n      description: 'Path to the Kubb config',\n      short: 'c',\n    },\n    port: {\n      type: 'string',\n      description: `Port for the server (default: ${agentDefaults.port})`,\n      short: 'p',\n    },\n    host: {\n      type: 'string',\n      description: 'Host for the server',\n      default: agentDefaults.host,\n    },\n    'allow-write': {\n      type: 'boolean',\n      description: 'Allow writing generated files to the filesystem. When not set, no files are written and the config patch is not persisted.',\n      default: false,\n    },\n    'allow-all': {\n      type: 'boolean',\n      description: 'Grant all permissions (implies --allow-write).',\n      default: false,\n    },\n  },\n  async run({ values }) {\n    const { runAgentStart } = await import('../../runners/agent.ts')\n\n    await runAgentStart({\n      port: values.port !== undefined ? values.port : undefined,\n      host: values.host,\n      configPath: values.config,\n      allowWrite: values['allow-write'],\n      allowAll: values['allow-all'],\n      version,\n    })\n  },\n})\n","import { defineCommand } from '@internals/utils'\nimport { command as startCommand } from './agent/start.ts'\n\nexport const command = defineCommand({\n  name: 'agent',\n  description: 'Manage the Kubb Agent server',\n  subCommands: [startCommand],\n})\n"],"mappings":";;;;;;ACGA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aAAa;CACb,aAAa,CDFQ,cAAc;EACnC,MAAM;EACN,aAAa;EACb,SAAS;GACP,QAAQ;IACN,MAAM;IACN,aAAa;IACb,OAAO;IACR;GACD,MAAM;IACJ,MAAM;IACN,aAAa,iCAAiC,cAAc,KAAK;IACjE,OAAO;IACR;GACD,MAAM;IACJ,MAAM;IACN,aAAa;IACb,SAAS,cAAc;IACxB;GACD,eAAe;IACb,MAAM;IACN,aAAa;IACb,SAAS;IACV;GACD,aAAa;IACX,MAAM;IACN,aAAa;IACb,SAAS;IACV;GACF;EACD,MAAM,IAAI,EAAE,UAAU;GACpB,MAAM,EAAE,kBAAkB,MAAM,OAAO;AAEvC,SAAM,cAAc;IAClB,MAAM,OAAO,SAAS,KAAA,IAAY,OAAO,OAAO,KAAA;IAChD,MAAM,OAAO;IACb,YAAY,OAAO;IACnB,YAAY,OAAO;IACnB,UAAU,OAAO;IACjB;IACD,CAAC;;EAEL,CCxCeC,CAAa;CAC5B,CAAC"}

package/dist/agent-Zo8CQwxZ.cjs

@@ -0,0 +1,116 @@
+const require_chunk = require("./chunk-ByKO4r7w.cjs");
+const require_telemetry = require("./telemetry-kmnc5OAT.cjs");
+const require_shell = require("./shell-475fQKaX.cjs");
+const require_constants = require("./constants-BgLUQ1nx.cjs");
+let node_util = require("node:util");
+let node_path = require("node:path");
+node_path = require_chunk.__toESM(node_path, 1);
+let node_process = require("node:process");
+node_process = require_chunk.__toESM(node_process, 1);
+let node_net = require("node:net");
+node_net = require_chunk.__toESM(node_net, 1);
+let node_url = require("node:url");
+let _clack_prompts = require("@clack/prompts");
+_clack_prompts = require_chunk.__toESM(_clack_prompts, 1);
+//#region src/runners/agent.ts
+/**
+* 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 }) {
+	const resolvedPort = port ?? node_process.env.PORT ?? require_constants.agentDefaults.port;
+	const resolvedHost = host !== require_constants.agentDefaults.host ? host : node_process.env.HOST ?? require_constants.agentDefaults.host;
+	const resolvedAllowAll = allowAll || node_process.env.KUBB_AGENT_ALLOW_ALL === "true";
+	const resolvedAllowWrite = resolvedAllowAll || allowWrite || node_process.env.KUBB_AGENT_ALLOW_WRITE === "true";
+	const agentRoot = node_process.env.KUBB_AGENT_ROOT ?? node_process.cwd();
+	const agentConfigPath = node_path.default.resolve(node_process.cwd(), configPath || node_process.env.KUBB_AGENT_CONFIG || require_constants.agentDefaults.configFile);
+	return {
+		port: resolvedPort,
+		host: resolvedHost,
+		allowWrite: resolvedAllowWrite,
+		allowAll: resolvedAllowAll,
+		agentConfigPath,
+		env: {
+			...node_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: node_process.env.KUBB_AGENT_TOKEN,
+			KUBB_AGENT_RETRY_TIMEOUT: node_process.env.KUBB_AGENT_RETRY_TIMEOUT ?? require_constants.agentDefaults.retryTimeout,
+			KUBB_STUDIO_URL: node_process.env.KUBB_STUDIO_URL ?? require_constants.agentDefaults.studioUrl
+		}
+	};
+}
+function isPortAvailable(port, host) {
+	return new Promise((resolve) => {
+		const server = node_net.default.createServer();
+		server.once("error", () => resolve(false));
+		server.once("listening", () => {
+			server.close();
+			resolve(true);
+		});
+		server.listen(port, host);
+	});
+}
+async function runAgentStart({ port, host, configPath, allowWrite, allowAll, version }) {
+	const hrStart = node_process.hrtime();
+	try {
+		try {
+			node_process.loadEnvFile();
+		} catch {}
+		let agentPkgUrl;
+		try {
+			agentPkgUrl = {}.resolve("@kubb/agent/package.json");
+		} catch (_e) {
+			console.error(`Import of '@kubb/agent' is required to start the Agent server`);
+			node_process.exit(1);
+		}
+		const agentPkgPath = (0, node_url.fileURLToPath)(agentPkgUrl);
+		const agentDir = node_path.default.dirname(agentPkgPath);
+		const serverPath = node_path.default.join(agentDir, require_constants.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_prompts.log.step((0, node_util.styleText)("cyan", "Starting agent server..."));
+		_clack_prompts.log.info((0, node_util.styleText)("dim", `Config: ${resolvedEnv.agentConfigPath}`));
+		_clack_prompts.log.info((0, node_util.styleText)("dim", `Host: ${resolvedEnv.host}`));
+		_clack_prompts.log.info((0, node_util.styleText)("dim", `Port: ${resolvedEnv.port}`));
+		if (!resolvedEnv.allowWrite && !resolvedEnv.allowAll) _clack_prompts.log.warn((0, node_util.styleText)("yellow", "Filesystem writes disabled. Use --allow-write or --allow-all to enable."));
+		if (!await isPortAvailable(numericPort, resolvedEnv.host)) {
+			_clack_prompts.log.error((0, node_util.styleText)("red", `Port ${resolvedEnv.port} is already in use. Stop the existing process or choose a different port with --port.`));
+			node_process.exit(1);
+		}
+		await require_shell.spawnAsync("node", [serverPath], {
+			env: resolvedEnv.env,
+			cwd: node_process.cwd()
+		});
+		await require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
+			command: "agent",
+			kubbVersion: version,
+			hrStart,
+			status: "success"
+		}));
+	} catch (error) {
+		await require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
+			command: "agent",
+			kubbVersion: version,
+			hrStart,
+			status: "failed"
+		}));
+		_clack_prompts.log.error((0, node_util.styleText)("red", "Failed to start agent server"));
+		console.error(error);
+		node_process.exit(1);
+	}
+}
+//#endregion
+exports.runAgentStart = runAgentStart;
+
+//# sourceMappingURL=agent-Zo8CQwxZ.cjs.map

package/dist/agent-Zo8CQwxZ.cjs.map

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

package/dist/{constants-BTUap0zs.cjs → constants-BgLUQ1nx.cjs}

@@ -1,22 +1,49 @@
 //#region src/constants.ts
-/** NPM registry endpoint used to check for @kubb/cli updates. */
+/**
+* Default filename for the Kubb configuration file.
+*
+* Used by the `init` command when scaffolding new projects and by the `agent` default config.
+*/
+const KUBB_CONFIG_FILENAME = "kubb.config.ts";
+/**
+* NPM registry endpoint used to check for @kubb/cli updates.
+*/
 const KUBB_NPM_PACKAGE_URL = "https://registry.npmjs.org/@kubb/cli/latest";
-/** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */
+/**
+* OpenTelemetry ingestion endpoint for anonymous usage telemetry.
+*/
 const OTLP_ENDPOINT = "https://otlp.kubb.dev";
-/** Horizontal rule rendered above/below the plain-logger generation summary. */
+/**
+* Horizontal rule rendered above/below the plain-logger generation summary.
+*/
 const SUMMARY_SEPARATOR = "─".repeat(27);
-/** Glob pattern for paths the file watcher ignores. */
+/**
+* Glob pattern for paths the file watcher ignores.
+*/
 const WATCHER_IGNORED_PATHS = "**/{.git,node_modules}/**";
-/** Default runtime values for the `agent start` command. */
+/**
+* Flags that short-circuit execution (help/version) — no telemetry notice is shown.
+*/
+const QUIET_FLAGS = new Set([
+	"--help",
+	"-h",
+	"--version",
+	"-v"
+]);
 const agentDefaults = {
 	port: "3000",
 	host: "localhost",
-	configFile: "kubb.config.ts",
+	configFile: KUBB_CONFIG_FILENAME,
 	retryTimeout: "30000",
 	studioUrl: "https://studio.kubb.dev",
+	/**
+	* Relative path from the @kubb/agent package root to the server entry.
+	*/
 	serverEntryPath: ".output/server/index.mjs"
 };
-/** Default values used during interactive `init` scaffolding. */
+/**
+* Default values used during interactive `init` scaffolding.
+*/
 const initDefaults = {
 	inputPath: "./openapi.yaml",
 	outputPath: "./src/gen",
@@ -60,8 +87,16 @@ const pluginDefaultConfigs = {
       output: { path: 'msw' },
     })`
 };
-/** Color palette used by randomCliColor() for deterministic plugin name coloring. */
+/**
+* Color palette used by randomCliColor() for deterministic plugin name coloring.
+*/
 //#endregion
+Object.defineProperty(exports, "KUBB_CONFIG_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return KUBB_CONFIG_FILENAME;
+	}
+});
 Object.defineProperty(exports, "KUBB_NPM_PACKAGE_URL", {
 	enumerable: true,
 	get: function() {
@@ -74,6 +109,12 @@ Object.defineProperty(exports, "OTLP_ENDPOINT", {
 		return OTLP_ENDPOINT;
 	}
 });
+Object.defineProperty(exports, "QUIET_FLAGS", {
+	enumerable: true,
+	get: function() {
+		return QUIET_FLAGS;
+	}
+});
 Object.defineProperty(exports, "SUMMARY_SEPARATOR", {
 	enumerable: true,
 	get: function() {
@@ -105,4 +146,4 @@ Object.defineProperty(exports, "pluginDefaultConfigs", {
 	}
 });
 
-//# sourceMappingURL=constants-BTUap0zs.cjs.map
+//# sourceMappingURL=constants-BgLUQ1nx.cjs.map

package/dist/constants-BgLUQ1nx.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-BgLUQ1nx.cjs","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/**\n * Default filename for the Kubb configuration file.\n *\n * Used by the `init` command when scaffolding new projects and by the `agent` default config.\n */\nexport const KUBB_CONFIG_FILENAME = 'kubb.config.ts' as const\n\n/**\n * NPM registry endpoint used to check for @kubb/cli updates.\n */\nexport const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const\n\n/**\n * OpenTelemetry ingestion endpoint for anonymous usage telemetry.\n */\nexport const OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const\n\n/**\n * Horizontal rule rendered above/below the plain-logger generation summary.\n */\nexport const SUMMARY_SEPARATOR = '─'.repeat(27)\n\n/**\n * Maximum number of █ characters in a plugin timing bar.\n */\nexport const SUMMARY_MAX_BAR_LENGTH = 10 as const\n\n/**\n * Divides elapsed milliseconds into bar-length units (1 block per 100 ms).\n */\nexport const SUMMARY_TIME_SCALE_DIVISOR = 100 as const\n\n/**\n * Glob pattern for paths the file watcher ignores.\n */\nexport const WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const\n\n/**\n * Flags that short-circuit execution (help/version) — no telemetry notice is shown.\n */\nexport const QUIET_FLAGS = new Set(['--help', '-h', '--version', '-v'] as const)\n\nexport const agentDefaults = {\n  port: '3000',\n  host: 'localhost',\n  configFile: KUBB_CONFIG_FILENAME,\n  retryTimeout: '30000',\n  studioUrl: 'https://studio.kubb.dev',\n  /**\n   * Relative path from the @kubb/agent package root to the server entry.\n   */\n  serverEntryPath: '.output/server/index.mjs',\n} as const\n\n/**\n * Default values used during interactive `init` scaffolding.\n */\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/**\n * Color palette used by randomCliColor() for deterministic plugin name coloring.\n */\n"],"mappings":";;;;;;AAKA,MAAa,uBAAuB;;;;AAKpC,MAAa,uBAAuB;;;;AAKpC,MAAa,gBAAgB;;;;AAK7B,MAAa,oBAAoB,IAAI,OAAO,GAAG;;;;AAe/C,MAAa,wBAAwB;;;;AAKrC,MAAa,cAAc,IAAI,IAAI;CAAC;CAAU;CAAM;CAAa;CAAK,CAAU;AAEhF,MAAa,gBAAgB;CAC3B,MAAM;CACN,MAAM;CACN,YAAY;CACZ,cAAc;CACd,WAAW;;;;CAIX,iBAAiB;CAClB;;;;AAKD,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 → constants-mIdg9ls2.js}

@@ -1,22 +1,49 @@
 //#region src/constants.ts
-/** NPM registry endpoint used to check for @kubb/cli updates. */
+/**
+* Default filename for the Kubb configuration file.
+*
+* Used by the `init` command when scaffolding new projects and by the `agent` default config.
+*/
+const KUBB_CONFIG_FILENAME = "kubb.config.ts";
+/**
+* NPM registry endpoint used to check for @kubb/cli updates.
+*/
 const KUBB_NPM_PACKAGE_URL = "https://registry.npmjs.org/@kubb/cli/latest";
-/** OpenTelemetry ingestion endpoint for anonymous usage telemetry. */
+/**
+* OpenTelemetry ingestion endpoint for anonymous usage telemetry.
+*/
 const OTLP_ENDPOINT = "https://otlp.kubb.dev";
-/** Horizontal rule rendered above/below the plain-logger generation summary. */
+/**
+* Horizontal rule rendered above/below the plain-logger generation summary.
+*/
 const SUMMARY_SEPARATOR = "─".repeat(27);
-/** Glob pattern for paths the file watcher ignores. */
+/**
+* Glob pattern for paths the file watcher ignores.
+*/
 const WATCHER_IGNORED_PATHS = "**/{.git,node_modules}/**";
-/** Default runtime values for the `agent start` command. */
+/**
+* Flags that short-circuit execution (help/version) — no telemetry notice is shown.
+*/
+const QUIET_FLAGS = new Set([
+	"--help",
+	"-h",
+	"--version",
+	"-v"
+]);
 const agentDefaults = {
 	port: "3000",
 	host: "localhost",
-	configFile: "kubb.config.ts",
+	configFile: KUBB_CONFIG_FILENAME,
 	retryTimeout: "30000",
 	studioUrl: "https://studio.kubb.dev",
+	/**
+	* Relative path from the @kubb/agent package root to the server entry.
+	*/
 	serverEntryPath: ".output/server/index.mjs"
 };
-/** Default values used during interactive `init` scaffolding. */
+/**
+* Default values used during interactive `init` scaffolding.
+*/
 const initDefaults = {
 	inputPath: "./openapi.yaml",
 	outputPath: "./src/gen",
@@ -60,8 +87,10 @@ const pluginDefaultConfigs = {
       output: { path: 'msw' },
     })`
 };
-/** Color palette used by randomCliColor() for deterministic plugin name coloring. */
+/**
+* Color palette used by randomCliColor() for deterministic plugin name coloring.
+*/
 //#endregion
-export { agentDefaults as a, WATCHER_IGNORED_PATHS as i, OTLP_ENDPOINT as n, initDefaults as o, SUMMARY_SEPARATOR as r, pluginDefaultConfigs as s, KUBB_NPM_PACKAGE_URL as t };
+export { SUMMARY_SEPARATOR as a, initDefaults as c, QUIET_FLAGS as i, pluginDefaultConfigs as l, KUBB_NPM_PACKAGE_URL as n, WATCHER_IGNORED_PATHS as o, OTLP_ENDPOINT as r, agentDefaults as s, KUBB_CONFIG_FILENAME as t };
 
-//# sourceMappingURL=constants-CM3dJzjK.js.map
+//# sourceMappingURL=constants-mIdg9ls2.js.map

package/dist/constants-mIdg9ls2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-mIdg9ls2.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/**\n * Default filename for the Kubb configuration file.\n *\n * Used by the `init` command when scaffolding new projects and by the `agent` default config.\n */\nexport const KUBB_CONFIG_FILENAME = 'kubb.config.ts' as const\n\n/**\n * NPM registry endpoint used to check for @kubb/cli updates.\n */\nexport const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const\n\n/**\n * OpenTelemetry ingestion endpoint for anonymous usage telemetry.\n */\nexport const OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const\n\n/**\n * Horizontal rule rendered above/below the plain-logger generation summary.\n */\nexport const SUMMARY_SEPARATOR = '─'.repeat(27)\n\n/**\n * Maximum number of █ characters in a plugin timing bar.\n */\nexport const SUMMARY_MAX_BAR_LENGTH = 10 as const\n\n/**\n * Divides elapsed milliseconds into bar-length units (1 block per 100 ms).\n */\nexport const SUMMARY_TIME_SCALE_DIVISOR = 100 as const\n\n/**\n * Glob pattern for paths the file watcher ignores.\n */\nexport const WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const\n\n/**\n * Flags that short-circuit execution (help/version) — no telemetry notice is shown.\n */\nexport const QUIET_FLAGS = new Set(['--help', '-h', '--version', '-v'] as const)\n\nexport const agentDefaults = {\n  port: '3000',\n  host: 'localhost',\n  configFile: KUBB_CONFIG_FILENAME,\n  retryTimeout: '30000',\n  studioUrl: 'https://studio.kubb.dev',\n  /**\n   * Relative path from the @kubb/agent package root to the server entry.\n   */\n  serverEntryPath: '.output/server/index.mjs',\n} as const\n\n/**\n * Default values used during interactive `init` scaffolding.\n */\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/**\n * Color palette used by randomCliColor() for deterministic plugin name coloring.\n */\n"],"mappings":";;;;;;AAKA,MAAa,uBAAuB;;;;AAKpC,MAAa,uBAAuB;;;;AAKpC,MAAa,gBAAgB;;;;AAK7B,MAAa,oBAAoB,IAAI,OAAO,GAAG;;;;AAe/C,MAAa,wBAAwB;;;;AAKrC,MAAa,cAAc,IAAI,IAAI;CAAC;CAAU;CAAM;CAAa;CAAK,CAAU;AAEhF,MAAa,gBAAgB;CAC3B,MAAM;CACN,MAAM;CACN,YAAY;CACZ,cAAc;CACd,WAAW;;;;CAIX,iBAAiB;CAClB;;;;AAKD,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/define-Bdn8j5VM.cjs

@@ -0,0 +1,54 @@
+require("./chunk-ByKO4r7w.cjs");
+//#region ../../internals/utils/src/cli/define.ts
+/**
+* Returns a `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.
+*
+* @example
+* ```ts
+* const adapter = defineCLIAdapter({ run: myRun, renderHelp: myHelp })
+* createCLI({ adapter }).run(commands, argv, opts)
+* ```
+*/
+function defineCLIAdapter(adapter) {
+	return adapter;
+}
+/**
+* Returns a `CommandDefinition` with typed `values` in `run()`.
+* The callback receives `values` inferred from the declared options — no casts needed.
+*
+* @example
+* ```ts
+* const generate = defineCommand({
+*   name: 'generate',
+*   description: 'Generate client code',
+*   options: { config: { type: 'string', description: 'Config path' } },
+*   async run({ values }) { console.log(values.config) },
+* })
+* ```
+*/
+function defineCommand(def) {
+	const { run, ...rest } = def;
+	if (!run) return rest;
+	return {
+		...rest,
+		run: (args) => run({
+			values: args.values,
+			positionals: args.positionals
+		})
+	};
+}
+//#endregion
+Object.defineProperty(exports, "defineCLIAdapter", {
+	enumerable: true,
+	get: function() {
+		return defineCLIAdapter;
+	}
+});
+Object.defineProperty(exports, "defineCommand", {
+	enumerable: true,
+	get: function() {
+		return defineCommand;
+	}
+});
+
+//# sourceMappingURL=define-Bdn8j5VM.cjs.map

package/dist/define-Bdn8j5VM.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-Bdn8j5VM.cjs","names":[],"sources":["../../../internals/utils/src/cli/define.ts"],"sourcesContent":["import type { CLIAdapter, CommandDefinition, OptionDefinition } from './types.ts'\n\ntype OptionTypeMap = { string: string; boolean: boolean }\n\ntype IsRequired<O extends OptionDefinition> = O['default'] extends string | boolean ? true : O['required'] extends true ? true : false\n\n/**\n * Infers typed values from an options record. Options with a `default` or `required: true` are always defined.\n */\ntype InferValues<O extends Record<string, OptionDefinition>> = {\n  [K in keyof O as IsRequired<O[K]> extends true ? K : never]: OptionTypeMap[O[K]['type']]\n} & {\n  [K in keyof O as IsRequired<O[K]> extends true ? never : K]?: OptionTypeMap[O[K]['type']]\n}\n\n/**\n * Returns a `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.\n *\n * @example\n * ```ts\n * const adapter = defineCLIAdapter({ run: myRun, renderHelp: myHelp })\n * createCLI({ adapter }).run(commands, argv, opts)\n * ```\n */\nexport function defineCLIAdapter(adapter: CLIAdapter): CLIAdapter {\n  return adapter\n}\n\n/**\n * Returns a `CommandDefinition` with typed `values` in `run()`.\n * The callback receives `values` inferred from the declared options — no casts needed.\n *\n * @example\n * ```ts\n * const generate = defineCommand({\n *   name: 'generate',\n *   description: 'Generate client code',\n *   options: { config: { type: 'string', description: 'Config path' } },\n *   async run({ values }) { console.log(values.config) },\n * })\n * ```\n */\nexport function defineCommand<O extends Record<string, OptionDefinition>>(def: {\n  name: string\n  description: string\n  arguments?: string[]\n  options?: O\n  subCommands?: CommandDefinition[]\n  run?: (args: { values: InferValues<O>; positionals: string[] }) => Promise<void>\n}): CommandDefinition {\n  const { run, ...rest } = def\n  if (!run) return rest\n  return {\n    ...rest,\n    run: (args) =>\n      run({\n        values: args.values as InferValues<O>,\n        positionals: args.positionals,\n      }),\n  }\n}\n"],"mappings":";;;;;;;;;;;AAwBA,SAAgB,iBAAiB,SAAiC;AAChE,QAAO;;;;;;;;;;;;;;;;AAiBT,SAAgB,cAA0D,KAOpD;CACpB,MAAM,EAAE,KAAK,GAAG,SAAS;AACzB,KAAI,CAAC,IAAK,QAAO;AACjB,QAAO;EACL,GAAG;EACH,MAAM,SACJ,IAAI;GACF,QAAQ,KAAK;GACb,aAAa,KAAK;GACnB,CAAC;EACL"}