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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (155) hide show
  1. package/README.md +198 -36
  2. package/dist/agent-DQerNyd8.cjs +70 -0
  3. package/dist/agent-DQerNyd8.cjs.map +1 -0
  4. package/dist/agent-ZKJkTTGN.js +68 -0
  5. package/dist/agent-ZKJkTTGN.js.map +1 -0
  6. package/dist/{chunk--u3MIqq1.js → chunk-CRm0XQPb.js} +1 -0
  7. package/dist/constants-84a47qA-.js +35 -0
  8. package/dist/constants-84a47qA-.js.map +1 -0
  9. package/dist/constants-AHhyFH15.cjs +139 -0
  10. package/dist/constants-AHhyFH15.cjs.map +1 -0
  11. package/dist/constants-BtmponZ3.cjs +58 -0
  12. package/dist/constants-BtmponZ3.cjs.map +1 -0
  13. package/dist/constants-C94RKp3A.js +116 -0
  14. package/dist/constants-C94RKp3A.js.map +1 -0
  15. package/dist/{define-Bdn8j5VM.cjs → define-C4AB3POr.cjs} +2 -2
  16. package/dist/{define-Bdn8j5VM.cjs.map → define-C4AB3POr.cjs.map} +1 -1
  17. package/dist/{define-Ctii4bel.js → define-DNG1U8ha.js} +2 -2
  18. package/dist/{define-Ctii4bel.js.map → define-DNG1U8ha.js.map} +1 -1
  19. package/dist/{errors-CjPmyZHy.js → errors-CoxrNXaA.js} +2 -2
  20. package/dist/{errors-CjPmyZHy.js.map → errors-CoxrNXaA.js.map} +1 -1
  21. package/dist/{errors-CLCjoSg0.cjs → errors-DykI11xo.cjs} +2 -2
  22. package/dist/{errors-CLCjoSg0.cjs.map → errors-DykI11xo.cjs.map} +1 -1
  23. package/dist/generate-40x9PP4o.js +77 -0
  24. package/dist/generate-40x9PP4o.js.map +1 -0
  25. package/dist/generate-DQLvFw4z.cjs +76 -0
  26. package/dist/generate-DQLvFw4z.cjs.map +1 -0
  27. package/dist/index.cjs +23 -14
  28. package/dist/index.cjs.map +1 -1
  29. package/dist/index.d.ts +1 -1
  30. package/dist/index.js +23 -14
  31. package/dist/index.js.map +1 -1
  32. package/dist/init-CT9RChdK.js +53 -0
  33. package/dist/init-CT9RChdK.js.map +1 -0
  34. package/dist/init-sEaUN7Dj.cjs +53 -0
  35. package/dist/init-sEaUN7Dj.cjs.map +1 -0
  36. package/dist/mcp-Siyb6fTT.cjs +39 -0
  37. package/dist/mcp-Siyb6fTT.cjs.map +1 -0
  38. package/dist/mcp-cjPrOeot.js +39 -0
  39. package/dist/mcp-cjPrOeot.js.map +1 -0
  40. package/dist/{package-BapVyQ-w.cjs → package-BJ6qam2Y.cjs} +2 -2
  41. package/dist/package-BJ6qam2Y.cjs.map +1 -0
  42. package/dist/package-CR5vEK4K.js +6 -0
  43. package/dist/package-CR5vEK4K.js.map +1 -0
  44. package/dist/{agent-sdYBBgrd.js → run-BQ3Qj0xB.js} +46 -43
  45. package/dist/run-BQ3Qj0xB.js.map +1 -0
  46. package/dist/run-BQzoaxjR.js +32 -0
  47. package/dist/run-BQzoaxjR.js.map +1 -0
  48. package/dist/run-CGf0KEts.js +51 -0
  49. package/dist/run-CGf0KEts.js.map +1 -0
  50. package/dist/{generate-CNrRLY4n.js → run-CHZKHTv0.js} +832 -828
  51. package/dist/run-CHZKHTv0.js.map +1 -0
  52. package/dist/{init-CZ5Xq2Hd.cjs → run-C_NMctua.cjs} +107 -149
  53. package/dist/run-C_NMctua.cjs.map +1 -0
  54. package/dist/{generate-B1Pa2ho-.cjs → run-CcQawFNK.cjs} +784 -780
  55. package/dist/run-CcQawFNK.cjs.map +1 -0
  56. package/dist/run-CkTpemme.cjs +52 -0
  57. package/dist/run-CkTpemme.cjs.map +1 -0
  58. package/dist/run-Cl4SrSob.cjs +33 -0
  59. package/dist/run-Cl4SrSob.cjs.map +1 -0
  60. package/dist/{agent-B4cAAab2.cjs → run-D-s2LdlW.cjs} +46 -43
  61. package/dist/run-D-s2LdlW.cjs.map +1 -0
  62. package/dist/{init-eNRlotJK.js → run-D8dCWepS.js} +107 -149
  63. package/dist/run-D8dCWepS.js.map +1 -0
  64. package/dist/{shell-DLzN4fRo.js → shell-BrqyJdB7.js} +2 -2
  65. package/dist/{shell-DLzN4fRo.js.map → shell-BrqyJdB7.js.map} +1 -1
  66. package/dist/{shell-475fQKaX.cjs → shell-Lh-vLWwH.cjs} +2 -2
  67. package/dist/{shell-475fQKaX.cjs.map → shell-Lh-vLWwH.cjs.map} +1 -1
  68. package/dist/validate-8pgfxUTy.js +26 -0
  69. package/dist/validate-8pgfxUTy.js.map +1 -0
  70. package/dist/validate-CstV7Pc2.cjs +26 -0
  71. package/dist/validate-CstV7Pc2.cjs.map +1 -0
  72. package/package.json +16 -15
  73. package/src/commands/agent/start.ts +10 -7
  74. package/src/commands/agent.ts +3 -1
  75. package/src/commands/generate.ts +21 -13
  76. package/src/commands/init.ts +34 -3
  77. package/src/commands/mcp.ts +28 -4
  78. package/src/commands/validate.ts +6 -4
  79. package/src/constants.ts +3 -74
  80. package/src/index.ts +6 -4
  81. package/src/loggers/clackLogger.ts +143 -181
  82. package/src/loggers/githubActionsLogger.ts +119 -121
  83. package/src/loggers/plainLogger.ts +50 -100
  84. package/src/loggers/types.ts +6 -0
  85. package/src/loggers/utils.ts +190 -18
  86. package/src/runners/agent/run.ts +113 -0
  87. package/src/runners/agent/utils.ts +98 -0
  88. package/src/runners/generate/run.ts +411 -0
  89. package/src/runners/generate/utils.ts +222 -0
  90. package/src/runners/init/run.ts +212 -0
  91. package/src/{utils/packageManager.ts → runners/init/utils.ts} +12 -2
  92. package/src/runners/mcp/run.ts +37 -0
  93. package/src/runners/validate/run.ts +63 -0
  94. package/dist/agent-B4cAAab2.cjs.map +0 -1
  95. package/dist/agent-CR6Z96og.js +0 -56
  96. package/dist/agent-CR6Z96og.js.map +0 -1
  97. package/dist/agent-Dmxzqg4d.cjs +0 -58
  98. package/dist/agent-Dmxzqg4d.cjs.map +0 -1
  99. package/dist/agent-sdYBBgrd.js.map +0 -1
  100. package/dist/constants-CnDXa1R6.cjs +0 -148
  101. package/dist/constants-CnDXa1R6.cjs.map +0 -1
  102. package/dist/constants-aL3CP_Wq.js +0 -95
  103. package/dist/constants-aL3CP_Wq.js.map +0 -1
  104. package/dist/generate-B1Pa2ho-.cjs.map +0 -1
  105. package/dist/generate-BDGOOsBM.cjs +0 -65
  106. package/dist/generate-BDGOOsBM.cjs.map +0 -1
  107. package/dist/generate-CNrRLY4n.js.map +0 -1
  108. package/dist/generate-DuhxPLGr.js +0 -66
  109. package/dist/generate-DuhxPLGr.js.map +0 -1
  110. package/dist/init-CZ5Xq2Hd.cjs.map +0 -1
  111. package/dist/init-CnZXHrbq.js +0 -25
  112. package/dist/init-CnZXHrbq.js.map +0 -1
  113. package/dist/init-NYJSZJSb.cjs +0 -25
  114. package/dist/init-NYJSZJSb.cjs.map +0 -1
  115. package/dist/init-eNRlotJK.js.map +0 -1
  116. package/dist/mcp-CYOgxB82.cjs +0 -47
  117. package/dist/mcp-CYOgxB82.cjs.map +0 -1
  118. package/dist/mcp-CdFWyrwi.cjs +0 -16
  119. package/dist/mcp-CdFWyrwi.cjs.map +0 -1
  120. package/dist/mcp-DhSxuDMD.js +0 -16
  121. package/dist/mcp-DhSxuDMD.js.map +0 -1
  122. package/dist/mcp-DmJm3TrU.js +0 -46
  123. package/dist/mcp-DmJm3TrU.js.map +0 -1
  124. package/dist/package-BapVyQ-w.cjs.map +0 -1
  125. package/dist/package-DyJE-qNq.js +0 -6
  126. package/dist/package-DyJE-qNq.js.map +0 -1
  127. package/dist/telemetry-DN95_2pF.cjs +0 -282
  128. package/dist/telemetry-DN95_2pF.cjs.map +0 -1
  129. package/dist/telemetry-LgT_sdPe.js +0 -245
  130. package/dist/telemetry-LgT_sdPe.js.map +0 -1
  131. package/dist/validate-C6npXzel.cjs +0 -25
  132. package/dist/validate-C6npXzel.cjs.map +0 -1
  133. package/dist/validate-kLJoT_hi.js +0 -33
  134. package/dist/validate-kLJoT_hi.js.map +0 -1
  135. package/dist/validate-n38Rh-Y7.js +0 -25
  136. package/dist/validate-n38Rh-Y7.js.map +0 -1
  137. package/dist/validate-yKKzqEZ5.cjs +0 -34
  138. package/dist/validate-yKKzqEZ5.cjs.map +0 -1
  139. package/src/loggers/fileSystemLogger.ts +0 -138
  140. package/src/runners/agent.ts +0 -155
  141. package/src/runners/generate.ts +0 -333
  142. package/src/runners/init.ts +0 -296
  143. package/src/runners/mcp.ts +0 -51
  144. package/src/runners/validate.ts +0 -39
  145. package/src/types.ts +0 -11
  146. package/src/utils/Writables.ts +0 -17
  147. package/src/utils/executeHooks.ts +0 -45
  148. package/src/utils/flags.ts +0 -9
  149. package/src/utils/getConfig.ts +0 -10
  150. package/src/utils/getCosmiConfig.ts +0 -80
  151. package/src/utils/getSummary.ts +0 -68
  152. package/src/utils/runHook.ts +0 -91
  153. package/src/utils/telemetry.ts +0 -273
  154. package/src/utils/watcher.ts +0 -19
  155. /package/dist/{chunk-ByKO4r7w.cjs → chunk-Bx3C2hgW.cjs} +0 -0
@@ -1,24 +1,25 @@
1
- import "./chunk--u3MIqq1.js";
2
- import { r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-LgT_sdPe.js";
3
- import { t as spawnAsync } from "./shell-DLzN4fRo.js";
4
- import { s as agentDefaults } from "./constants-aL3CP_Wq.js";
1
+ import "./chunk-CRm0XQPb.js";
2
+ import { t as getErrorMessage } from "./errors-CoxrNXaA.js";
3
+ import { t as spawnAsync } from "./shell-BrqyJdB7.js";
4
+ import { i as agentDefaults } from "./constants-84a47qA-.js";
5
+ import { createRequire } from "node:module";
5
6
  import { styleText } from "node:util";
6
7
  import path from "node:path";
7
- import * as process$1 from "node:process";
8
- import net from "node:net";
9
- import { fileURLToPath } from "node:url";
8
+ import { Telemetry } from "@kubb/core";
9
+ import process from "node:process";
10
10
  import * as clack from "@clack/prompts";
11
- //#region src/runners/agent.ts
11
+ import net from "node:net";
12
+ //#region src/runners/agent/utils.ts
12
13
  /**
13
14
  * Resolves the environment passed to the detached agent process using CLI values first, then environment values, then CLI defaults.
14
15
  */
15
16
  function resolveAgentStartEnvironment({ port, host, configPath, allowWrite, allowAll }) {
16
- const resolvedPort = port ?? process$1.env.PORT ?? agentDefaults.port;
17
- const resolvedHost = host !== agentDefaults.host ? host : process$1.env.HOST ?? agentDefaults.host;
18
- const resolvedAllowAll = allowAll || process$1.env.KUBB_AGENT_ALLOW_ALL === "true";
19
- const resolvedAllowWrite = resolvedAllowAll || allowWrite || process$1.env.KUBB_AGENT_ALLOW_WRITE === "true";
20
- const agentRoot = process$1.env.KUBB_AGENT_ROOT ?? process$1.cwd();
21
- const agentConfigPath = path.resolve(process$1.cwd(), configPath || process$1.env.KUBB_AGENT_CONFIG || agentDefaults.configFile);
17
+ const resolvedPort = port ?? process.env.PORT ?? agentDefaults.port;
18
+ const resolvedHost = host !== agentDefaults.host ? host : process.env.HOST ?? agentDefaults.host;
19
+ const resolvedAllowAll = allowAll || process.env.KUBB_AGENT_ALLOW_ALL === "true";
20
+ const resolvedAllowWrite = resolvedAllowAll || allowWrite || process.env.KUBB_AGENT_ALLOW_WRITE === "true";
21
+ const agentRoot = process.env.KUBB_AGENT_ROOT ?? process.cwd();
22
+ const agentConfigPath = path.resolve(process.cwd(), configPath || process.env.KUBB_AGENT_CONFIG || agentDefaults.configFile);
22
23
  return {
23
24
  port: resolvedPort,
24
25
  host: resolvedHost,
@@ -26,16 +27,16 @@ function resolveAgentStartEnvironment({ port, host, configPath, allowWrite, allo
26
27
  allowAll: resolvedAllowAll,
27
28
  agentConfigPath,
28
29
  env: {
29
- ...process$1.env,
30
+ ...process.env,
30
31
  PORT: resolvedPort,
31
32
  HOST: resolvedHost,
32
33
  KUBB_AGENT_ROOT: agentRoot,
33
34
  KUBB_AGENT_CONFIG: agentConfigPath,
34
35
  KUBB_AGENT_ALLOW_WRITE: String(resolvedAllowWrite),
35
36
  KUBB_AGENT_ALLOW_ALL: String(resolvedAllowAll),
36
- KUBB_AGENT_TOKEN: process$1.env.KUBB_AGENT_TOKEN,
37
- KUBB_AGENT_RETRY_TIMEOUT: process$1.env.KUBB_AGENT_RETRY_TIMEOUT ?? agentDefaults.retryTimeout,
38
- KUBB_STUDIO_URL: process$1.env.KUBB_STUDIO_URL ?? agentDefaults.studioUrl
37
+ KUBB_AGENT_TOKEN: process.env.KUBB_AGENT_TOKEN,
38
+ KUBB_AGENT_RETRY_TIMEOUT: process.env.KUBB_AGENT_RETRY_TIMEOUT ?? agentDefaults.retryTimeout,
39
+ KUBB_STUDIO_URL: process.env.KUBB_STUDIO_URL ?? agentDefaults.studioUrl
39
40
  }
40
41
  };
41
42
  }
@@ -50,15 +51,28 @@ function isPortAvailable(port, host) {
50
51
  server.listen(port, host);
51
52
  });
52
53
  }
53
- async function runAgentStart({ port, host, configPath, allowWrite, allowAll, version }) {
54
- const hrStart = process$1.hrtime();
54
+ //#endregion
55
+ //#region src/runners/agent/run.ts
56
+ /**
57
+ * Spawns the Kubb Agent HTTP server as a Node.js subprocess.
58
+ * Resolves config from CLI flags and environment variables, validates the port, and exits with code 1 on failure.
59
+ */
60
+ async function run({ port, host, configPath, allowWrite, allowAll, version }) {
61
+ const hrStart = process.hrtime();
62
+ const report = (status) => Telemetry.send(Telemetry.build({
63
+ command: "agent",
64
+ kubbVersion: version,
65
+ hrStart,
66
+ status
67
+ }));
55
68
  try {
56
69
  try {
57
- process$1.loadEnvFile();
70
+ process.loadEnvFile();
58
71
  } catch {}
59
- let agentPkgUrl;
72
+ const require = createRequire(import.meta.url);
73
+ let agentPkgPath;
60
74
  try {
61
- agentPkgUrl = import.meta.resolve("@kubb/agent/package.json");
75
+ agentPkgPath = require.resolve("@kubb/agent/package.json");
62
76
  } catch (_e) {
63
77
  console.error(styleText("red", "The @kubb/agent package is not installed."));
64
78
  console.error("");
@@ -67,9 +81,8 @@ async function runAgentStart({ port, host, configPath, allowWrite, allowAll, ver
67
81
  console.error(styleText("cyan", " # or"));
68
82
  console.error(styleText("cyan", " pnpm install @kubb/agent"));
69
83
  console.error("");
70
- process$1.exit(1);
84
+ process.exit(1);
71
85
  }
72
- const agentPkgPath = fileURLToPath(agentPkgUrl);
73
86
  const agentDir = path.dirname(agentPkgPath);
74
87
  const serverPath = path.join(agentDir, agentDefaults.serverEntryPath);
75
88
  const resolvedEnv = resolveAgentStartEnvironment({
@@ -88,31 +101,21 @@ async function runAgentStart({ port, host, configPath, allowWrite, allowAll, ver
88
101
  if (!resolvedEnv.allowWrite && !resolvedEnv.allowAll) clack.log.warn(styleText("yellow", "Filesystem writes disabled. Use --allow-write or --allow-all to enable."));
89
102
  if (!await isPortAvailable(numericPort, resolvedEnv.host)) {
90
103
  clack.log.error(styleText("red", `Port ${resolvedEnv.port} is already in use. Stop the existing process or choose a different port with --port.`));
91
- process$1.exit(1);
104
+ process.exit(1);
92
105
  }
93
106
  await spawnAsync("node", [serverPath], {
94
107
  env: resolvedEnv.env,
95
- cwd: process$1.cwd()
108
+ cwd: process.cwd()
96
109
  });
97
- await sendTelemetry(buildTelemetryEvent({
98
- command: "agent",
99
- kubbVersion: version,
100
- hrStart,
101
- status: "success"
102
- }));
110
+ await report("success");
103
111
  } catch (error) {
104
- await sendTelemetry(buildTelemetryEvent({
105
- command: "agent",
106
- kubbVersion: version,
107
- hrStart,
108
- status: "failed"
109
- }));
112
+ await report("failed");
110
113
  clack.log.error(styleText("red", "Failed to start agent server"));
111
- console.error(error);
112
- process$1.exit(1);
114
+ clack.log.error(getErrorMessage(error));
115
+ process.exit(1);
113
116
  }
114
117
  }
115
118
  //#endregion
116
- export { runAgentStart };
119
+ export { run };
117
120
 
118
- //# sourceMappingURL=agent-sdYBBgrd.js.map
121
+ //# sourceMappingURL=run-BQ3Qj0xB.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-BQ3Qj0xB.js","names":[],"sources":["../src/runners/agent/utils.ts","../src/runners/agent/run.ts"],"sourcesContent":["import net from 'node:net'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { agentDefaults } from '../../constants.ts'\n\ntype AgentStartEnvironmentInput = {\n /**\n * TCP port for the HTTP server. When `undefined`, falls back to `PORT` env var or the default (`3000`).\n */\n port: string | undefined\n /**\n * Hostname the HTTP server binds to.\n */\n host: string\n /**\n * Explicit path to the Kubb config file. When `undefined`, falls back to `KUBB_AGENT_CONFIG` or the default filename.\n */\n configPath: string | undefined\n /**\n * Grants the agent permission to write generated files to the filesystem.\n */\n allowWrite: boolean\n /**\n * Grants all agent permissions, including filesystem writes. Implies `allowWrite`.\n */\n allowAll: boolean\n}\n\ntype ResolvedAgentStartEnvironment = {\n /**\n * Final port string after merging CLI flag, `PORT` env var, and the default.\n */\n port: string\n /**\n * Final hostname after merging CLI flag, `HOST` env var, and the default.\n */\n host: string\n /**\n * Effective write-permission flag, accounting for `allowAll` and `KUBB_AGENT_ALLOW_WRITE`.\n */\n allowWrite: boolean\n /**\n * Effective all-permissions flag, accounting for `KUBB_AGENT_ALLOW_ALL`.\n */\n allowAll: boolean\n /**\n * Absolute path to the Kubb config file passed to the agent subprocess.\n */\n agentConfigPath: string\n /**\n * Merged `process.env` object with all resolved agent environment variables applied.\n */\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 */\nexport function resolveAgentStartEnvironment({ port, host, configPath, allowWrite, allowAll }: AgentStartEnvironmentInput): 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\nexport function 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","import { createRequire } from 'node:module'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { styleText } from 'node:util'\nimport * as clack from '@clack/prompts'\nimport { spawnAsync, getErrorMessage } from '@internals/utils'\nimport { Telemetry } from '@kubb/core'\nimport { agentDefaults } from '../../constants.ts'\nimport { isPortAvailable, resolveAgentStartEnvironment } from './utils.ts'\n\ntype AgentStartOptions = {\n /**\n * TCP port for the HTTP server. When `undefined`, falls back to `PORT` env var or the default (`3000`).\n */\n port: string | undefined\n /**\n * Hostname the HTTP server binds to.\n *\n * @default 'localhost'\n */\n host: string\n /**\n * Explicit path to the Kubb config file. When `undefined`, falls back to `KUBB_AGENT_CONFIG` or the default filename.\n */\n configPath: string | undefined\n /**\n * Grants the agent permission to write generated files to the filesystem.\n */\n allowWrite: boolean\n /**\n * Grants all agent permissions, including filesystem writes. Implies `allowWrite`.\n */\n allowAll: boolean\n /**\n * Current `@kubb/cli` version string, used for the telemetry payload.\n */\n version: string\n}\n\n/**\n * Spawns the Kubb Agent HTTP server as a Node.js subprocess.\n * Resolves config from CLI flags and environment variables, validates the port, and exits with code 1 on failure.\n */\nexport async function run({ port, host, configPath, allowWrite, allowAll, version }: AgentStartOptions): Promise<void> {\n const hrStart = process.hrtime()\n const report = (status: 'success' | 'failed') => Telemetry.send(Telemetry.build({ command: 'agent', kubbVersion: version, hrStart, status }))\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, createRequire is CJS/ESM compatible (import.meta.resolve is ESM-only)\n const require = createRequire(import.meta.url)\n let agentPkgPath: string\n try {\n agentPkgPath = require.resolve('@kubb/agent/package.json')\n } catch (_e) {\n console.error(styleText('red', 'The @kubb/agent package is not installed.'))\n console.error('')\n console.error('Install it with:')\n console.error(styleText('cyan', ' npm install @kubb/agent'))\n console.error(styleText('cyan', ' # or'))\n console.error(styleText('cyan', ' pnpm install @kubb/agent'))\n console.error('')\n process.exit(1)\n }\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 report('success')\n } catch (error) {\n await report('failed')\n clack.log.error(styleText('red', 'Failed to start agent server'))\n clack.log.error(getErrorMessage(error))\n process.exit(1)\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ import "./chunk-CRm0XQPb.js";
2
+ import { t as getErrorMessage } from "./errors-CoxrNXaA.js";
3
+ import { styleText } from "node:util";
4
+ import { Telemetry } from "@kubb/core";
5
+ import process from "node:process";
6
+ //#region src/runners/mcp/run.ts
7
+ async function run({ version, port, host }) {
8
+ const { run: startMcpServer } = await import("@kubb/mcp");
9
+ const hrStart = process.hrtime();
10
+ const report = (status) => Telemetry.send(Telemetry.build({
11
+ command: "mcp",
12
+ kubbVersion: version,
13
+ hrStart,
14
+ status
15
+ }));
16
+ try {
17
+ console.log(styleText("cyan", "⏳ Starting MCP server..."));
18
+ console.warn(styleText("yellow", "This feature is still under development, use with caution"));
19
+ await startMcpServer(void 0, {
20
+ port: port !== void 0 ? Number(port) : void 0,
21
+ host
22
+ });
23
+ await report("success");
24
+ } catch (error) {
25
+ await report("failed");
26
+ console.error(getErrorMessage(error));
27
+ }
28
+ }
29
+ //#endregion
30
+ export { run };
31
+
32
+ //# sourceMappingURL=run-BQzoaxjR.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-BQzoaxjR.js","names":[],"sources":["../src/runners/mcp/run.ts"],"sourcesContent":["import process from 'node:process'\nimport { styleText } from 'node:util'\nimport { getErrorMessage } from '@internals/utils'\nimport { Telemetry } from '@kubb/core'\nimport type * as McpModule from '@kubb/mcp'\n\ntype McpOptions = {\n /**\n * Current `@kubb/cli` version string, used for the telemetry payload.\n */\n version: string\n /**\n * TCP port for the HTTP MCP server. When `undefined`, the server uses stdio transport.\n */\n port?: string\n /**\n * Hostname to bind to when running in HTTP mode.\n *\n * @default 'localhost'\n */\n host?: string\n}\n\nexport async function run({ version, port, host }: McpOptions): Promise<void> {\n const { run: startMcpServer } = (await import('@kubb/mcp')) as typeof McpModule\n const hrStart = process.hrtime()\n const report = (status: 'success' | 'failed') => Telemetry.send(Telemetry.build({ command: 'mcp', kubbVersion: version, hrStart, status }))\n try {\n console.log(styleText('cyan', '⏳ Starting MCP server...'))\n console.warn(styleText('yellow', 'This feature is still under development, use with caution'))\n await startMcpServer(undefined, { port: port !== undefined ? Number(port) : undefined, host })\n await report('success')\n } catch (error) {\n await report('failed')\n console.error(getErrorMessage(error))\n }\n}\n"],"mappings":";;;;;;AAuBA,eAAsB,IAAI,EAAE,SAAS,MAAM,QAAmC;CAC5E,MAAM,EAAE,KAAK,mBAAoB,MAAM,OAAO;CAC9C,MAAM,UAAU,QAAQ,OAAO;CAC/B,MAAM,UAAU,WAAiC,UAAU,KAAK,UAAU,MAAM;EAAE,SAAS;EAAO,aAAa;EAAS;EAAS;CAAO,CAAC,CAAC;CAC1I,IAAI;EACF,QAAQ,IAAI,UAAU,QAAQ,0BAA0B,CAAC;EACzD,QAAQ,KAAK,UAAU,UAAU,2DAA2D,CAAC;EAC7F,MAAM,eAAe,KAAA,GAAW;GAAE,MAAM,SAAS,KAAA,IAAY,OAAO,IAAI,IAAI,KAAA;GAAW;EAAK,CAAC;EAC7F,MAAM,OAAO,SAAS;CACxB,SAAS,OAAO;EACd,MAAM,OAAO,QAAQ;EACrB,QAAQ,MAAM,gBAAgB,KAAK,CAAC;CACtC;AACF"}
@@ -0,0 +1,51 @@
1
+ import "./chunk-CRm0XQPb.js";
2
+ import { t as getErrorMessage } from "./errors-CoxrNXaA.js";
3
+ import { styleText } from "node:util";
4
+ import { Telemetry } from "@kubb/core";
5
+ import process from "node:process";
6
+ //#region src/runners/validate/run.ts
7
+ /**
8
+ * Dynamically loads `@kubb/adapter-oas` for OpenAPI validation.
9
+ */
10
+ function loadValidateModule() {
11
+ return import("@kubb/adapter-oas");
12
+ }
13
+ /**
14
+ * Validates an OpenAPI/Swagger file at `input` using `@kubb/adapter-oas`.
15
+ * Exits the process with code 1 on validation failure or missing dependency.
16
+ */
17
+ async function run({ input, version }, dependencies = { loadValidateModule }) {
18
+ const hrStart = process.hrtime();
19
+ const report = (status) => Telemetry.send(Telemetry.build({
20
+ command: "validate",
21
+ kubbVersion: version,
22
+ hrStart,
23
+ status
24
+ }));
25
+ try {
26
+ const { adapterOas } = await dependencies.loadValidateModule();
27
+ const adapter = adapterOas();
28
+ if (!adapter.validate) throw new Error("The loaded adapter does not support validation.");
29
+ await adapter.validate(input, { throwOnError: true });
30
+ await report("success");
31
+ console.log("✅ Validation success");
32
+ } catch (error) {
33
+ await report("failed");
34
+ if (error instanceof Error && /@kubb\/adapter-oas/.test(error.message)) {
35
+ console.error(styleText("red", "The @kubb/adapter-oas package is not installed."));
36
+ console.error("");
37
+ console.error("Install it with:");
38
+ console.error(styleText("cyan", " npm install @kubb/adapter-oas"));
39
+ console.error(styleText("cyan", " # or"));
40
+ console.error(styleText("cyan", " pnpm install @kubb/adapter-oas"));
41
+ console.error("");
42
+ }
43
+ console.error("❌ Validation failed");
44
+ console.error(getErrorMessage(error));
45
+ process.exit(1);
46
+ }
47
+ }
48
+ //#endregion
49
+ export { run };
50
+
51
+ //# sourceMappingURL=run-CGf0KEts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-CGf0KEts.js","names":[],"sources":["../src/runners/validate/run.ts"],"sourcesContent":["import process from 'node:process'\nimport { styleText } from 'node:util'\nimport { getErrorMessage } from '@internals/utils'\nimport { Telemetry } from '@kubb/core'\n\ntype ValidateOptions = {\n /**\n * Path or URL to the OpenAPI/Swagger file to validate.\n */\n input: string\n /**\n * Current `@kubb/cli` version string, used for the telemetry payload.\n */\n version: string\n}\n\ntype ValidateModule = typeof import('@kubb/adapter-oas')\ntype ValidateDependencies = {\n /**\n * Loads `@kubb/adapter-oas`. Injected so tests can substitute a mock.\n */\n loadValidateModule: () => Promise<ValidateModule>\n}\n\n/**\n * Dynamically loads `@kubb/adapter-oas` for OpenAPI validation.\n */\nexport function loadValidateModule(): Promise<ValidateModule> {\n return import('@kubb/adapter-oas') as Promise<ValidateModule>\n}\n\n/**\n * Validates an OpenAPI/Swagger file at `input` using `@kubb/adapter-oas`.\n * Exits the process with code 1 on validation failure or missing dependency.\n */\nexport async function run({ input, version }: ValidateOptions, dependencies: ValidateDependencies = { loadValidateModule }): Promise<void> {\n const hrStart = process.hrtime()\n const report = (status: 'success' | 'failed') => Telemetry.send(Telemetry.build({ command: 'validate', kubbVersion: version, hrStart, status }))\n try {\n const { adapterOas } = await dependencies.loadValidateModule()\n const adapter = adapterOas()\n if (!adapter.validate) {\n throw new Error('The loaded adapter does not support validation.')\n }\n await adapter.validate(input, { throwOnError: true })\n await report('success')\n console.log('✅ Validation success')\n } catch (error) {\n await report('failed')\n if (error instanceof Error && /@kubb\\/adapter-oas/.test(error.message)) {\n console.error(styleText('red', 'The @kubb/adapter-oas package is not installed.'))\n console.error('')\n console.error('Install it with:')\n console.error(styleText('cyan', ' npm install @kubb/adapter-oas'))\n console.error(styleText('cyan', ' # or'))\n console.error(styleText('cyan', ' pnpm install @kubb/adapter-oas'))\n console.error('')\n }\n console.error('❌ Validation failed')\n console.error(getErrorMessage(error))\n process.exit(1)\n }\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAgB,qBAA8C;CAC5D,OAAO,OAAO;AAChB;;;;;AAMA,eAAsB,IAAI,EAAE,OAAO,WAA4B,eAAqC,EAAE,mBAAmB,GAAkB;CACzI,MAAM,UAAU,QAAQ,OAAO;CAC/B,MAAM,UAAU,WAAiC,UAAU,KAAK,UAAU,MAAM;EAAE,SAAS;EAAY,aAAa;EAAS;EAAS;CAAO,CAAC,CAAC;CAC/I,IAAI;EACF,MAAM,EAAE,eAAe,MAAM,aAAa,mBAAmB;EAC7D,MAAM,UAAU,WAAW;EAC3B,IAAI,CAAC,QAAQ,UACX,MAAM,IAAI,MAAM,iDAAiD;EAEnE,MAAM,QAAQ,SAAS,OAAO,EAAE,cAAc,KAAK,CAAC;EACpD,MAAM,OAAO,SAAS;EACtB,QAAQ,IAAI,sBAAsB;CACpC,SAAS,OAAO;EACd,MAAM,OAAO,QAAQ;EACrB,IAAI,iBAAiB,SAAS,qBAAqB,KAAK,MAAM,OAAO,GAAG;GACtE,QAAQ,MAAM,UAAU,OAAO,iDAAiD,CAAC;GACjF,QAAQ,MAAM,EAAE;GAChB,QAAQ,MAAM,kBAAkB;GAChC,QAAQ,MAAM,UAAU,QAAQ,iCAAiC,CAAC;GAClE,QAAQ,MAAM,UAAU,QAAQ,QAAQ,CAAC;GACzC,QAAQ,MAAM,UAAU,QAAQ,kCAAkC,CAAC;GACnE,QAAQ,MAAM,EAAE;EAClB;EACA,QAAQ,MAAM,qBAAqB;EACnC,QAAQ,MAAM,gBAAgB,KAAK,CAAC;EACpC,QAAQ,KAAK,CAAC;CAChB;AACF"}