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

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 (133) hide show
  1. package/LICENSE +17 -10
  2. package/README.md +45 -77
  3. package/bin/kubb.js +9 -3
  4. package/dist/Telemetry-CfPP7MYq.cjs +321 -0
  5. package/dist/Telemetry-CfPP7MYq.cjs.map +1 -0
  6. package/dist/Telemetry-uAr3lK_-.js +284 -0
  7. package/dist/Telemetry-uAr3lK_-.js.map +1 -0
  8. package/dist/{define-Bdn8j5VM.cjs → defineCommand-Bo3yZTWI.cjs} +3 -21
  9. package/dist/defineCommand-Bo3yZTWI.cjs.map +1 -0
  10. package/dist/{define-m_fp-Aqm.js → defineCommand-DMEeqliP.js} +4 -16
  11. package/dist/defineCommand-DMEeqliP.js.map +1 -0
  12. package/dist/{errors-CINO1EIv.js → errors-Dc_d7BfX.js} +2 -2
  13. package/dist/{errors-CINO1EIv.js.map → errors-Dc_d7BfX.js.map} +1 -1
  14. package/dist/{errors-CLCjoSg0.cjs → errors-gxFK0vrp.cjs} +2 -2
  15. package/dist/{errors-CLCjoSg0.cjs.map → errors-gxFK0vrp.cjs.map} +1 -1
  16. package/dist/{generate-Bod9YCbF.cjs → generate-Dj_ztXAk.cjs} +21 -16
  17. package/dist/generate-Dj_ztXAk.cjs.map +1 -0
  18. package/dist/{generate-BY-juRdH.js → generate-DqE96-AW.js} +21 -16
  19. package/dist/generate-DqE96-AW.js.map +1 -0
  20. package/dist/index.cjs +34 -81
  21. package/dist/index.cjs.map +1 -1
  22. package/dist/index.d.ts +6 -1
  23. package/dist/index.js +34 -81
  24. package/dist/index.js.map +1 -1
  25. package/dist/{init-BIkZU6mB.cjs → init-CT0QBOJR.cjs} +6 -6
  26. package/dist/{init-BIkZU6mB.cjs.map → init-CT0QBOJR.cjs.map} +1 -1
  27. package/dist/{init-Cs3Fp6nN.js → init-Dj-yuBT4.js} +5 -5
  28. package/dist/{init-Cs3Fp6nN.js.map → init-Dj-yuBT4.js.map} +1 -1
  29. package/dist/mcp-Bx5bWdkI.cjs +21 -0
  30. package/dist/mcp-Bx5bWdkI.cjs.map +1 -0
  31. package/dist/mcp-Dgf2OtCy.js +21 -0
  32. package/dist/mcp-Dgf2OtCy.js.map +1 -0
  33. package/dist/{package-DrUndPET.cjs → package-CK8o-iEe.cjs} +2 -2
  34. package/dist/package-CK8o-iEe.cjs.map +1 -0
  35. package/dist/package-DC0ALWof.js +6 -0
  36. package/dist/package-DC0ALWof.js.map +1 -0
  37. package/dist/{chunk-BvFE5Tac.js → rolldown-runtime-C0LytTxp.js} +0 -1
  38. package/dist/{run-YsoCk5we.cjs → run-AYlRjIX5.cjs} +136 -98
  39. package/dist/run-AYlRjIX5.cjs.map +1 -0
  40. package/dist/run-B9R0rCqJ.cjs +1380 -0
  41. package/dist/run-B9R0rCqJ.cjs.map +1 -0
  42. package/dist/run-BM1t8CSM.cjs +33 -0
  43. package/dist/run-BM1t8CSM.cjs.map +1 -0
  44. package/dist/run-BlFVmIJl.js +32 -0
  45. package/dist/run-BlFVmIJl.js.map +1 -0
  46. package/dist/{run-CQbj3ley.cjs → run-CBc896in.cjs} +6 -6
  47. package/dist/run-CBc896in.cjs.map +1 -0
  48. package/dist/run-CxPZ9S4b.js +1377 -0
  49. package/dist/run-CxPZ9S4b.js.map +1 -0
  50. package/dist/{run-CF97BWVa.js → run-D9mQoQHA.js} +123 -85
  51. package/dist/run-D9mQoQHA.js.map +1 -0
  52. package/dist/{run-CCZ24VKk.js → run-D_dWNFhX.js} +5 -5
  53. package/dist/run-D_dWNFhX.js.map +1 -0
  54. package/dist/tools-CZT9wSA6.cjs +175 -0
  55. package/dist/tools-CZT9wSA6.cjs.map +1 -0
  56. package/dist/tools-D0UogMU3.js +152 -0
  57. package/dist/tools-D0UogMU3.js.map +1 -0
  58. package/dist/{validate-lbUkWQ5o.js → validate-CRXa_v3l.js} +5 -5
  59. package/dist/{validate-lbUkWQ5o.js.map → validate-CRXa_v3l.js.map} +1 -1
  60. package/dist/{validate-Bfpf_UIh.cjs → validate-CVqbA1lL.cjs} +6 -6
  61. package/dist/{validate-Bfpf_UIh.cjs.map → validate-CVqbA1lL.cjs.map} +1 -1
  62. package/package.json +13 -25
  63. package/dist/agent-DN7o8nlE.js +0 -68
  64. package/dist/agent-DN7o8nlE.js.map +0 -1
  65. package/dist/agent-Fm9_8BBH.cjs +0 -70
  66. package/dist/agent-Fm9_8BBH.cjs.map +0 -1
  67. package/dist/constants-B2JTeRBb.js +0 -42
  68. package/dist/constants-B2JTeRBb.js.map +0 -1
  69. package/dist/constants-BINTA5VZ.cjs +0 -77
  70. package/dist/constants-BINTA5VZ.cjs.map +0 -1
  71. package/dist/constants-BYGmiFs0.cjs +0 -139
  72. package/dist/constants-BYGmiFs0.cjs.map +0 -1
  73. package/dist/constants-DSJ-Xrbv.js +0 -116
  74. package/dist/constants-DSJ-Xrbv.js.map +0 -1
  75. package/dist/define-Bdn8j5VM.cjs.map +0 -1
  76. package/dist/define-m_fp-Aqm.js.map +0 -1
  77. package/dist/generate-BY-juRdH.js.map +0 -1
  78. package/dist/generate-Bod9YCbF.cjs.map +0 -1
  79. package/dist/mcp-BSNulBcC.js +0 -39
  80. package/dist/mcp-BSNulBcC.js.map +0 -1
  81. package/dist/mcp-DcSrFhhP.cjs +0 -39
  82. package/dist/mcp-DcSrFhhP.cjs.map +0 -1
  83. package/dist/package-D5wmvFl4.js +0 -6
  84. package/dist/package-D5wmvFl4.js.map +0 -1
  85. package/dist/package-DrUndPET.cjs.map +0 -1
  86. package/dist/run-BAJubgdA.js +0 -1735
  87. package/dist/run-BAJubgdA.js.map +0 -1
  88. package/dist/run-BzpYYOQs.js +0 -121
  89. package/dist/run-BzpYYOQs.js.map +0 -1
  90. package/dist/run-CCZ24VKk.js.map +0 -1
  91. package/dist/run-CF97BWVa.js.map +0 -1
  92. package/dist/run-CQbj3ley.cjs.map +0 -1
  93. package/dist/run-CqKd6JNc.cjs +0 -1738
  94. package/dist/run-CqKd6JNc.cjs.map +0 -1
  95. package/dist/run-D0hmRpHy.js +0 -49
  96. package/dist/run-D0hmRpHy.js.map +0 -1
  97. package/dist/run-DwdAwnLG.cjs +0 -125
  98. package/dist/run-DwdAwnLG.cjs.map +0 -1
  99. package/dist/run-Lr0Ctnu0.cjs +0 -50
  100. package/dist/run-Lr0Ctnu0.cjs.map +0 -1
  101. package/dist/run-YsoCk5we.cjs.map +0 -1
  102. package/dist/shell-475fQKaX.cjs +0 -62
  103. package/dist/shell-475fQKaX.cjs.map +0 -1
  104. package/dist/shell-CN6DNqeC.js +0 -51
  105. package/dist/shell-CN6DNqeC.js.map +0 -1
  106. package/dist/telemetry-B2iWkY5e.cjs +0 -280
  107. package/dist/telemetry-B2iWkY5e.cjs.map +0 -1
  108. package/dist/telemetry-BkektVz6.js +0 -243
  109. package/dist/telemetry-BkektVz6.js.map +0 -1
  110. package/src/commands/agent/start.ts +0 -50
  111. package/src/commands/agent.ts +0 -10
  112. package/src/commands/generate.ts +0 -59
  113. package/src/commands/init.ts +0 -51
  114. package/src/commands/mcp.ts +0 -36
  115. package/src/commands/validate.ts +0 -22
  116. package/src/constants.ts +0 -48
  117. package/src/index.ts +0 -45
  118. package/src/loggers/clackLogger.ts +0 -460
  119. package/src/loggers/fileSystemLogger.ts +0 -148
  120. package/src/loggers/githubActionsLogger.ts +0 -367
  121. package/src/loggers/plainLogger.ts +0 -243
  122. package/src/loggers/types.ts +0 -7
  123. package/src/loggers/utils.ts +0 -252
  124. package/src/runners/agent/run.ts +0 -113
  125. package/src/runners/agent/utils.ts +0 -98
  126. package/src/runners/generate/run.ts +0 -276
  127. package/src/runners/generate/utils.ts +0 -209
  128. package/src/runners/init/run.ts +0 -211
  129. package/src/runners/init/utils.ts +0 -33
  130. package/src/runners/mcp/run.ts +0 -55
  131. package/src/runners/validate/run.ts +0 -63
  132. package/src/telemetry.ts +0 -280
  133. /package/dist/{chunk-ByKO4r7w.cjs → rolldown-runtime-Bx3C2hgW.cjs} +0 -0
@@ -1,1738 +0,0 @@
1
- const require_chunk = require("./chunk-ByKO4r7w.cjs");
2
- const require_errors = require("./errors-CLCjoSg0.cjs");
3
- const require_telemetry = require("./telemetry-B2iWkY5e.cjs");
4
- const require_shell = require("./shell-475fQKaX.cjs");
5
- const require_package = require("./package-DrUndPET.cjs");
6
- const require_constants = require("./constants-BINTA5VZ.cjs");
7
- let node_util = require("node:util");
8
- let node_events = require("node:events");
9
- let node_crypto = require("node:crypto");
10
- let node_child_process = require("node:child_process");
11
- let node_fs = require("node:fs");
12
- let node_fs_promises = require("node:fs/promises");
13
- let node_path = require("node:path");
14
- node_path = require_chunk.__toESM(node_path, 1);
15
- let node_process = require("node:process");
16
- node_process = require_chunk.__toESM(node_process, 1);
17
- let _clack_prompts = require("@clack/prompts");
18
- _clack_prompts = require_chunk.__toESM(_clack_prompts, 1);
19
- let _kubb_core = require("@kubb/core");
20
- let node_stream = require("node:stream");
21
- let cosmiconfig = require("cosmiconfig");
22
- let jiti = require("jiti");
23
- let tinyexec = require("tinyexec");
24
- //#region ../../internals/utils/src/asyncEventEmitter.ts
25
- /**
26
- * Typed `EventEmitter` that awaits all async listeners before resolving.
27
- * Wraps Node's `EventEmitter` with full TypeScript event-map inference.
28
- *
29
- * @example
30
- * ```ts
31
- * const emitter = new AsyncEventEmitter<{ build: [name: string] }>()
32
- * emitter.on('build', async (name) => { console.log(name) })
33
- * await emitter.emit('build', 'petstore') // all listeners awaited
34
- * ```
35
- */
36
- var AsyncEventEmitter = class {
37
- /**
38
- * Maximum number of listeners per event before Node emits a memory-leak warning.
39
- * @default 10
40
- */
41
- constructor(maxListener = 10) {
42
- this.#emitter.setMaxListeners(maxListener);
43
- }
44
- #emitter = new node_events.EventEmitter();
45
- /**
46
- * Emits `eventName` and awaits all registered listeners sequentially.
47
- * Throws if any listener rejects, wrapping the cause with the event name and serialized arguments.
48
- *
49
- * @example
50
- * ```ts
51
- * await emitter.emit('build', 'petstore')
52
- * ```
53
- */
54
- async emit(eventName, ...eventArgs) {
55
- const listeners = this.#emitter.listeners(eventName);
56
- if (listeners.length === 0) return;
57
- for (const listener of listeners) try {
58
- await listener(...eventArgs);
59
- } catch (err) {
60
- let serializedArgs;
61
- try {
62
- serializedArgs = JSON.stringify(eventArgs);
63
- } catch {
64
- serializedArgs = String(eventArgs);
65
- }
66
- throw new Error(`Error in async listener for "${eventName}" with eventArgs ${serializedArgs}`, { cause: require_errors.toError(err) });
67
- }
68
- }
69
- /**
70
- * Registers a persistent listener for `eventName`.
71
- *
72
- * @example
73
- * ```ts
74
- * emitter.on('build', async (name) => { console.log(name) })
75
- * ```
76
- */
77
- on(eventName, handler) {
78
- this.#emitter.on(eventName, handler);
79
- }
80
- /**
81
- * Registers a one-shot listener that removes itself after the first invocation.
82
- *
83
- * @example
84
- * ```ts
85
- * emitter.onOnce('build', async (name) => { console.log(name) })
86
- * ```
87
- */
88
- onOnce(eventName, handler) {
89
- const wrapper = (...args) => {
90
- this.off(eventName, wrapper);
91
- return handler(...args);
92
- };
93
- this.on(eventName, wrapper);
94
- }
95
- /**
96
- * Removes a previously registered listener.
97
- *
98
- * @example
99
- * ```ts
100
- * emitter.off('build', handler)
101
- * ```
102
- */
103
- off(eventName, handler) {
104
- this.#emitter.off(eventName, handler);
105
- }
106
- /**
107
- * Returns the number of listeners registered for `eventName`.
108
- *
109
- * @example
110
- * ```ts
111
- * emitter.on('build', handler)
112
- * emitter.listenerCount('build') // 1
113
- * ```
114
- */
115
- listenerCount(eventName) {
116
- return this.#emitter.listenerCount(eventName);
117
- }
118
- /**
119
- * Removes all listeners from every event channel.
120
- *
121
- * @example
122
- * ```ts
123
- * emitter.removeAll()
124
- * ```
125
- */
126
- removeAll() {
127
- this.#emitter.removeAllListeners();
128
- }
129
- };
130
- //#endregion
131
- //#region ../../internals/utils/src/time.ts
132
- /**
133
- * Calculates elapsed time in milliseconds from a high-resolution `process.hrtime` start time.
134
- * Rounds to 2 decimal places for sub-millisecond precision without noise.
135
- *
136
- * @example
137
- * ```ts
138
- * const start = process.hrtime()
139
- * doWork()
140
- * getElapsedMs(start) // 42.35
141
- * ```
142
- */
143
- function getElapsedMs(hrStart) {
144
- const [seconds, nanoseconds] = process.hrtime(hrStart);
145
- const ms = seconds * 1e3 + nanoseconds / 1e6;
146
- return Math.round(ms * 100) / 100;
147
- }
148
- /**
149
- * Converts a millisecond duration into a human-readable string (`ms`, `s`, or `m s`).
150
- *
151
- * @example
152
- * ```ts
153
- * formatMs(250) // '250ms'
154
- * formatMs(1500) // '1.50s'
155
- * formatMs(90000) // '1m 30.0s'
156
- * ```
157
- */
158
- function formatMs(ms) {
159
- if (ms >= 6e4) return `${Math.floor(ms / 6e4)}m ${(ms % 6e4 / 1e3).toFixed(1)}s`;
160
- if (ms >= 1e3) return `${(ms / 1e3).toFixed(2)}s`;
161
- return `${Math.round(ms)}ms`;
162
- }
163
- /**
164
- * Formats the elapsed time since `hrStart` as a human-readable string.
165
- *
166
- * @example
167
- * ```ts
168
- * const start = process.hrtime()
169
- * doWork()
170
- * formatHrtime(start) // '1.50s'
171
- * ```
172
- */
173
- function formatHrtime(hrStart) {
174
- return formatMs(getElapsedMs(hrStart));
175
- }
176
- //#endregion
177
- //#region ../../internals/utils/src/colors.ts
178
- /**
179
- * Parses a CSS hex color string (`#RGB`) into its RGB channels.
180
- * Falls back to `255` for any channel that cannot be parsed.
181
- */
182
- function parseHex(color) {
183
- const int = Number.parseInt(color.replace("#", ""), 16);
184
- return Number.isNaN(int) ? {
185
- r: 255,
186
- g: 255,
187
- b: 255
188
- } : {
189
- r: int >> 16 & 255,
190
- g: int >> 8 & 255,
191
- b: int & 255
192
- };
193
- }
194
- /**
195
- * Returns a function that wraps a string in a 24-bit ANSI true-color escape sequence
196
- * for the given hex color.
197
- */
198
- function hex(color) {
199
- const { r, g, b } = parseHex(color);
200
- return (text) => `\x1b[38;2;${r};${g};${b}m${text}\x1b[0m`;
201
- }
202
- function gradient(colorStops, text) {
203
- const chars = text.split("");
204
- return chars.map((char, i) => {
205
- const t = chars.length <= 1 ? 0 : i / (chars.length - 1);
206
- const seg = Math.min(Math.floor(t * (colorStops.length - 1)), colorStops.length - 2);
207
- const lt = t * (colorStops.length - 1) - seg;
208
- const from = parseHex(colorStops[seg]);
209
- const to = parseHex(colorStops[seg + 1]);
210
- return `\x1b[38;2;${Math.round(from.r + (to.r - from.r) * lt)};${Math.round(from.g + (to.g - from.g) * lt)};${Math.round(from.b + (to.b - from.b) * lt)}m${char}\x1b[0m`;
211
- }).join("");
212
- }
213
- /**
214
- * ANSI color functions for each part of the Kubb mascot illustration.
215
- */
216
- const palette = {
217
- /**
218
- * Top cap of the skittle.
219
- */
220
- lid: hex("#F55A17"),
221
- /**
222
- * Upper wood body.
223
- */
224
- woodTop: hex("#F5A217"),
225
- /**
226
- * Middle wood body.
227
- */
228
- woodMid: hex("#F58517"),
229
- /**
230
- * Base wood body.
231
- */
232
- woodBase: hex("#B45309"),
233
- /**
234
- * Eye whites.
235
- */
236
- eye: hex("#FFFFFF"),
237
- /**
238
- * Highlight accent.
239
- */
240
- highlight: hex("#adadc6"),
241
- /**
242
- * Cheek blush.
243
- */
244
- blush: hex("#FDA4AF")
245
- };
246
- /**
247
- * Generates the Kubb mascot welcome banner as an ANSI-colored string.
248
- *
249
- * @example
250
- * ```ts
251
- * console.log(getIntro({ title: 'kubb.config.ts', description: 'generating…', version: '5.0.0', areEyesOpen: true }))
252
- * ```
253
- */
254
- function getIntro({ title, description, version, areEyesOpen }) {
255
- const kubbVersion = gradient([
256
- "#F58517",
257
- "#F5A217",
258
- "#F55A17"
259
- ], `KUBB v${version}`);
260
- const eyeTop = areEyesOpen ? palette.eye("█▀█") : palette.eye("───");
261
- const eyeBottom = areEyesOpen ? palette.eye("▀▀▀") : palette.eye("───");
262
- return `
263
- ${palette.lid("▄▄▄▄▄▄▄▄▄▄▄▄▄")}
264
- ${palette.woodTop("█ ")}${palette.highlight("▄▄")}${palette.woodTop(" ")}${palette.highlight("▄▄")}${palette.woodTop(" █")} ${kubbVersion}
265
- ${palette.woodMid("█ ")}${eyeTop}${palette.woodMid(" ")}${eyeTop}${palette.woodMid(" █")} ${(0, node_util.styleText)("gray", title)}
266
- ${palette.woodMid("█ ")}${eyeBottom}${palette.woodMid(" ")}${palette.blush("◡")}${palette.woodMid(" ")}${eyeBottom}${palette.woodMid(" █")} ${(0, node_util.styleText)("yellow", "➜")} ${(0, node_util.styleText)("white", description)}
267
- ${palette.woodBase("▀▀▀▀▀▀▀▀▀▀▀▀▀")}
268
- `;
269
- }
270
- /**
271
- * ANSI color names used by {@link randomCliColor} for deterministic terminal coloring.
272
- */
273
- const randomColors = [
274
- "black",
275
- "red",
276
- "green",
277
- "yellow",
278
- "blue",
279
- "white",
280
- "magenta",
281
- "cyan",
282
- "gray"
283
- ];
284
- /**
285
- * Wraps `text` in a deterministic ANSI color derived from the text's SHA-256 hash.
286
- *
287
- * @example
288
- * ```ts
289
- * randomCliColor('petstore') // '\x1b[33m' + 'petstore' + '\x1b[39m' (always the same color for 'petstore')
290
- * ```
291
- */
292
- function randomCliColor(text) {
293
- if (!text) return "";
294
- return (0, node_util.styleText)(randomColors[(0, node_crypto.createHash)("sha256").update(text).digest().readUInt32BE(0) % randomColors.length] ?? "white", text);
295
- }
296
- /**
297
- * Formats a millisecond duration with a threshold-based ANSI color.
298
- * `≤ 500 ms` → green · `≤ 1 000 ms` → yellow · `> 1 000 ms` → red.
299
- *
300
- * @example
301
- * ```ts
302
- * formatMsWithColor(200) // '\x1b[32m200ms\x1b[39m'
303
- * formatMsWithColor(800) // '\x1b[33m800ms\x1b[39m'
304
- * formatMsWithColor(1500) // '\x1b[31m1.50s\x1b[39m'
305
- * ```
306
- */
307
- function formatMsWithColor(ms) {
308
- const formatted = formatMs(ms);
309
- if (ms <= 500) return (0, node_util.styleText)("green", formatted);
310
- if (ms <= 1e3) return (0, node_util.styleText)("yellow", formatted);
311
- return (0, node_util.styleText)("red", formatted);
312
- }
313
- //#endregion
314
- //#region ../../internals/utils/src/formatters.ts
315
- /**
316
- * CLI command descriptors for each supported code formatter.
317
- *
318
- * Each entry contains the executable `command`, an `args` factory that maps an
319
- * output path to the correct argument list, and an `errorMessage` shown when
320
- * the formatter is not found.
321
- */
322
- const formatters = {
323
- prettier: {
324
- command: "prettier",
325
- args: (outputPath) => [
326
- "--ignore-unknown",
327
- "--write",
328
- outputPath
329
- ],
330
- errorMessage: "Prettier not found"
331
- },
332
- biome: {
333
- command: "biome",
334
- args: (outputPath) => [
335
- "format",
336
- "--write",
337
- outputPath
338
- ],
339
- errorMessage: "Biome not found"
340
- },
341
- oxfmt: {
342
- command: "oxfmt",
343
- args: (outputPath) => [outputPath],
344
- errorMessage: "Oxfmt not found"
345
- }
346
- };
347
- async function isFormatterAvailable(formatter) {
348
- return new Promise((resolve) => {
349
- const child = (0, node_child_process.spawn)(formatter, ["--version"], { stdio: "ignore" });
350
- child.on("close", (code) => resolve(code === 0));
351
- child.on("error", () => resolve(false));
352
- });
353
- }
354
- /**
355
- * Detects the first available code formatter on the current system.
356
- *
357
- * - Checks in preference order: `oxfmt`, `biome`, `prettier`.
358
- * - Returns `null` when none are found.
359
- *
360
- * @example
361
- * ```ts
362
- * const formatter = await detectFormatter()
363
- * if (formatter) {
364
- * console.log(`Using ${formatter} for formatting`)
365
- * }
366
- * ```
367
- */
368
- async function detectFormatter() {
369
- const formatterNames = new Set([
370
- "oxfmt",
371
- "biome",
372
- "prettier"
373
- ]);
374
- for (const formatter of formatterNames) if (await isFormatterAvailable(formatter)) return formatter;
375
- return null;
376
- }
377
- //#endregion
378
- //#region ../../internals/utils/src/fs.ts
379
- /**
380
- * Writes `data` to `path`, trimming leading/trailing whitespace before saving.
381
- * Skips the write when the trimmed content is empty or identical to what is already on disk.
382
- * Creates any missing parent directories automatically.
383
- * When `sanity` is `true`, re-reads the file after writing and throws if the content does not match.
384
- *
385
- * @example
386
- * ```ts
387
- * await write('./src/Pet.ts', source) // writes and returns trimmed content
388
- * await write('./src/Pet.ts', source) // null — file unchanged
389
- * await write('./src/Pet.ts', ' ') // null — empty content skipped
390
- * ```
391
- */
392
- async function write(path, data, options = {}) {
393
- const trimmed = data.trim();
394
- if (trimmed === "") return null;
395
- const resolved = (0, node_path.resolve)(path);
396
- if (typeof Bun !== "undefined") {
397
- const file = Bun.file(resolved);
398
- if ((await file.exists() ? await file.text() : null) === trimmed) return null;
399
- await Bun.write(resolved, trimmed);
400
- return trimmed;
401
- }
402
- try {
403
- if (await (0, node_fs_promises.readFile)(resolved, { encoding: "utf-8" }) === trimmed) return null;
404
- } catch {}
405
- await (0, node_fs_promises.mkdir)((0, node_path.dirname)(resolved), { recursive: true });
406
- await (0, node_fs_promises.writeFile)(resolved, trimmed, { encoding: "utf-8" });
407
- if (options.sanity) {
408
- const savedData = await (0, node_fs_promises.readFile)(resolved, { encoding: "utf-8" });
409
- if (savedData !== trimmed) throw new Error(`Sanity check failed for ${path}\n\nData[${data.length}]:\n${data}\n\nSaved[${savedData.length}]:\n${savedData}\n`);
410
- return savedData;
411
- }
412
- return trimmed;
413
- }
414
- //#endregion
415
- //#region ../../internals/utils/src/linters.ts
416
- /**
417
- * Collects all files under `dir` recursively using Node's built-in fs APIs.
418
- *
419
- * Passing explicit file paths to oxlint (instead of a directory) bypasses
420
- * oxlint's `.gitignore`-aware directory traversal, which would otherwise skip
421
- * files that are listed in `.gitignore` (e.g. generated output directories).
422
- */
423
- function findLintableFiles(dir) {
424
- try {
425
- return (0, node_fs.readdirSync)(dir, {
426
- withFileTypes: true,
427
- recursive: true
428
- }).filter((d) => d.isFile()).map((d) => `${d.parentPath}/${d.name}`);
429
- } catch {
430
- return [];
431
- }
432
- }
433
- /**
434
- * CLI command descriptors for each supported linter.
435
- *
436
- * Each entry contains the executable `command`, an `args` factory that maps an
437
- * output path to the correct argument list, and an `errorMessage` shown when
438
- * the linter is not found.
439
- */
440
- const linters = {
441
- eslint: {
442
- command: "eslint",
443
- args: (outputPath) => [outputPath, "--fix"],
444
- errorMessage: "Eslint not found"
445
- },
446
- biome: {
447
- command: "biome",
448
- args: (outputPath) => [
449
- "lint",
450
- "--fix",
451
- outputPath
452
- ],
453
- errorMessage: "Biome not found"
454
- },
455
- oxlint: {
456
- command: "oxlint",
457
- args: (outputPath) => ["--fix", ...findLintableFiles(outputPath)],
458
- errorMessage: "Oxlint not found"
459
- }
460
- };
461
- async function isLinterAvailable(linter) {
462
- return new Promise((resolve) => {
463
- const child = (0, node_child_process.spawn)(linter, ["--version"], { stdio: "ignore" });
464
- child.on("close", (code) => resolve(code === 0));
465
- child.on("error", () => resolve(false));
466
- });
467
- }
468
- /**
469
- * Detects the first available linter on the current system.
470
- *
471
- * - Checks in preference order: `oxlint`, `biome`, `eslint`.
472
- * - Returns `null` when none are found.
473
- *
474
- * @example
475
- * ```ts
476
- * const linter = await detectLinter()
477
- * if (linter) {
478
- * console.log(`Using ${linter} for linting`)
479
- * }
480
- * ```
481
- */
482
- async function detectLinter() {
483
- const linterNames = new Set([
484
- "oxlint",
485
- "biome",
486
- "eslint"
487
- ]);
488
- for (const linter of linterNames) if (await isLinterAvailable(linter)) return linter;
489
- return null;
490
- }
491
- //#endregion
492
- //#region src/loggers/clackLogger.ts
493
- /**
494
- * Node.js `Writable` stream that forwards each chunk to a clack `taskLog` message.
495
- * Used to pipe hook subprocess output into the clack task log UI.
496
- */
497
- var ClackWritable = class extends node_stream.Writable {
498
- taskLog;
499
- constructor(taskLog, opts) {
500
- super(opts);
501
- this.taskLog = taskLog;
502
- }
503
- _write(chunk, _encoding, callback) {
504
- this.taskLog.message(`${(0, node_util.styleText)("dim", chunk.toString())}`);
505
- callback();
506
- }
507
- };
508
- /**
509
- * TTY logger with beautiful UI and progress indicators for local development.
510
- */
511
- const clackLogger = (0, _kubb_core.defineLogger)({
512
- name: "clack",
513
- install(context, options) {
514
- const logLevel = options?.logLevel ?? _kubb_core.logLevel.info;
515
- const state = {
516
- totalPlugins: 0,
517
- completedPlugins: 0,
518
- failedPlugins: 0,
519
- totalFiles: 0,
520
- processedFiles: 0,
521
- hrStart: node_process.default.hrtime(),
522
- spinner: _clack_prompts.spinner(),
523
- isSpinning: false,
524
- activeProgress: /* @__PURE__ */ new Map()
525
- };
526
- function reset() {
527
- for (const [_key, active] of state.activeProgress) {
528
- if (active.interval) clearInterval(active.interval);
529
- active.progressBar?.stop();
530
- }
531
- state.totalPlugins = 0;
532
- state.completedPlugins = 0;
533
- state.failedPlugins = 0;
534
- state.totalFiles = 0;
535
- state.processedFiles = 0;
536
- state.hrStart = node_process.default.hrtime();
537
- state.spinner = _clack_prompts.spinner();
538
- state.isSpinning = false;
539
- state.activeProgress.clear();
540
- }
541
- function showProgressStep() {
542
- if (logLevel <= _kubb_core.logLevel.silent) return;
543
- const line = buildProgressLine(state);
544
- if (line) _clack_prompts.log.step(getMessage(line));
545
- }
546
- function getMessage(message) {
547
- return formatMessage(message, logLevel);
548
- }
549
- function startSpinner(text) {
550
- state.spinner.start(text);
551
- state.isSpinning = true;
552
- }
553
- function stopSpinner(text) {
554
- state.spinner.stop(text);
555
- state.isSpinning = false;
556
- }
557
- context.on("kubb:info", ({ message, info = "" }) => {
558
- if (logLevel <= _kubb_core.logLevel.silent) return;
559
- const text = getMessage([
560
- (0, node_util.styleText)("blue", "ℹ"),
561
- message,
562
- (0, node_util.styleText)("dim", info)
563
- ].join(" "));
564
- if (state.isSpinning) state.spinner.message(text);
565
- else _clack_prompts.log.info(text);
566
- });
567
- context.on("kubb:success", ({ message, info = "" }) => {
568
- if (logLevel <= _kubb_core.logLevel.silent) return;
569
- const text = getMessage([
570
- (0, node_util.styleText)("blue", "✓"),
571
- message,
572
- logLevel >= _kubb_core.logLevel.info ? (0, node_util.styleText)("dim", info) : void 0
573
- ].filter(Boolean).join(" "));
574
- if (state.isSpinning) stopSpinner(text);
575
- else _clack_prompts.log.success(text);
576
- });
577
- context.on("kubb:warn", ({ message, info }) => {
578
- if (logLevel < _kubb_core.logLevel.warn) return;
579
- const text = getMessage([
580
- (0, node_util.styleText)("yellow", "⚠"),
581
- message,
582
- logLevel >= _kubb_core.logLevel.info && info ? (0, node_util.styleText)("dim", info) : void 0
583
- ].filter(Boolean).join(" "));
584
- _clack_prompts.log.warn(text);
585
- });
586
- context.on("kubb:error", ({ error }) => {
587
- const caused = require_errors.toCause(error);
588
- const text = [(0, node_util.styleText)("red", "✗"), error.message].join(" ");
589
- if (state.isSpinning) stopSpinner(getMessage(text));
590
- else _clack_prompts.log.error(getMessage(text));
591
- if (logLevel >= _kubb_core.logLevel.debug && error.stack) {
592
- const frames = error.stack.split("\n").slice(1, 4);
593
- for (const frame of frames) _clack_prompts.log.message(getMessage((0, node_util.styleText)("dim", frame.trim())));
594
- if (caused?.stack) {
595
- _clack_prompts.log.message((0, node_util.styleText)("dim", `└─ caused by ${caused.message}`));
596
- const frames = caused.stack.split("\n").slice(1, 4);
597
- for (const frame of frames) _clack_prompts.log.message(getMessage(` ${(0, node_util.styleText)("dim", frame.trim())}`));
598
- }
599
- }
600
- });
601
- context.on("kubb:version:new", ({ currentVersion, latestVersion }) => {
602
- if (logLevel <= _kubb_core.logLevel.silent) return;
603
- try {
604
- _clack_prompts.box(`\`v${currentVersion}\` → \`v${latestVersion}\`
605
- Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
606
- width: "auto",
607
- formatBorder: (s) => (0, node_util.styleText)("yellow", s),
608
- rounded: true,
609
- withGuide: false,
610
- contentAlign: "center",
611
- titleAlign: "center"
612
- });
613
- } catch {
614
- console.log(`Update available for Kubb: v${currentVersion} → v${latestVersion}`);
615
- console.log("Run `npm install -g @kubb/cli` to update");
616
- }
617
- });
618
- context.on("kubb:lifecycle:start", async ({ version }) => {
619
- console.log(`\n${getIntro({
620
- title: "The ultimate toolkit for working with APIs",
621
- description: "Ready to start",
622
- version,
623
- areEyesOpen: true
624
- })}\n`);
625
- reset();
626
- });
627
- context.on("kubb:config:start", () => {
628
- if (logLevel <= _kubb_core.logLevel.silent) return;
629
- const text = getMessage("Configuration started");
630
- _clack_prompts.intro(text);
631
- startSpinner(getMessage("Configuration loading"));
632
- });
633
- context.on("kubb:config:end", () => {
634
- if (logLevel <= _kubb_core.logLevel.silent) return;
635
- const text = getMessage("Configuration completed");
636
- _clack_prompts.outro(text);
637
- });
638
- context.on("kubb:generation:start", ({ config }) => {
639
- reset();
640
- state.totalPlugins = config.plugins?.length ?? 0;
641
- const text = getMessage(["Generation started", config.name ? `for ${(0, node_util.styleText)("dim", config.name)}` : void 0].filter(Boolean).join(" "));
642
- _clack_prompts.intro(text);
643
- });
644
- context.on("kubb:plugin:start", ({ plugin }) => {
645
- if (logLevel <= _kubb_core.logLevel.silent) return;
646
- stopSpinner();
647
- const progressBar = _clack_prompts.progress({
648
- style: "block",
649
- max: 100,
650
- size: 30
651
- });
652
- const text = getMessage(`Generating ${(0, node_util.styleText)("bold", plugin.name)}`);
653
- progressBar.start(text);
654
- const interval = setInterval(() => {
655
- progressBar.advance();
656
- }, 100);
657
- state.activeProgress.set(plugin.name, {
658
- progressBar,
659
- interval
660
- });
661
- });
662
- context.on("kubb:plugin:end", ({ plugin, duration, success }) => {
663
- stopSpinner();
664
- const active = state.activeProgress.get(plugin.name);
665
- if (!active || logLevel === _kubb_core.logLevel.silent) return;
666
- clearInterval(active.interval);
667
- if (success) state.completedPlugins++;
668
- else state.failedPlugins++;
669
- const durationStr = formatMsWithColor(duration);
670
- const text = getMessage(success ? `${(0, node_util.styleText)("bold", plugin.name)} completed in ${durationStr}` : `${(0, node_util.styleText)("bold", plugin.name)} failed in ${(0, node_util.styleText)("red", formatMs(duration))}`);
671
- active.progressBar.stop(text);
672
- state.activeProgress.delete(plugin.name);
673
- showProgressStep();
674
- });
675
- context.on("kubb:files:processing:start", ({ files }) => {
676
- if (logLevel <= _kubb_core.logLevel.silent) return;
677
- stopSpinner();
678
- state.totalFiles = files.length;
679
- state.processedFiles = 0;
680
- const text = `Writing ${files.length} files`;
681
- const progressBar = _clack_prompts.progress({
682
- style: "block",
683
- max: files.length,
684
- size: 30
685
- });
686
- context.emit("kubb:info", { message: text });
687
- progressBar.start(getMessage(text));
688
- state.activeProgress.set("files", { progressBar });
689
- });
690
- context.on("kubb:file:processing:update", ({ file, config }) => {
691
- if (logLevel <= _kubb_core.logLevel.silent) return;
692
- stopSpinner();
693
- state.processedFiles++;
694
- const text = `Writing ${(0, node_path.relative)(config.root, file.path)}`;
695
- const active = state.activeProgress.get("files");
696
- if (!active) return;
697
- active.progressBar.advance(void 0, text);
698
- });
699
- context.on("kubb:files:processing:end", () => {
700
- if (logLevel <= _kubb_core.logLevel.silent) return;
701
- stopSpinner();
702
- const text = getMessage("Files written successfully");
703
- const active = state.activeProgress.get("files");
704
- if (!active) return;
705
- active.progressBar.stop(text);
706
- state.activeProgress.delete("files");
707
- showProgressStep();
708
- });
709
- context.on("kubb:generation:end", ({ config }) => {
710
- const text = getMessage(config.name ? `Generation completed for ${(0, node_util.styleText)("dim", config.name)}` : "Generation completed");
711
- _clack_prompts.outro(text);
712
- });
713
- context.on("kubb:format:start", () => {
714
- if (logLevel <= _kubb_core.logLevel.silent) return;
715
- const text = getMessage("Format started");
716
- _clack_prompts.intro(text);
717
- });
718
- context.on("kubb:format:end", () => {
719
- if (logLevel <= _kubb_core.logLevel.silent) return;
720
- const text = getMessage("Format completed");
721
- _clack_prompts.outro(text);
722
- });
723
- context.on("kubb:lint:start", () => {
724
- if (logLevel <= _kubb_core.logLevel.silent) return;
725
- const text = getMessage("Lint started");
726
- _clack_prompts.intro(text);
727
- });
728
- context.on("kubb:lint:end", () => {
729
- if (logLevel <= _kubb_core.logLevel.silent) return;
730
- const text = getMessage("Lint completed");
731
- _clack_prompts.outro(text);
732
- });
733
- context.on("kubb:hook:start", ({ command, args }) => {
734
- if (logLevel <= _kubb_core.logLevel.silent) return;
735
- const text = getMessage(`Hook ${(0, node_util.styleText)("dim", formatCommandWithArgs(command, args))} started`);
736
- _clack_prompts.intro(text);
737
- });
738
- context.on("kubb:hook:end", ({ command, args }) => {
739
- if (logLevel <= _kubb_core.logLevel.silent) return;
740
- const text = getMessage(`Hook ${(0, node_util.styleText)("dim", formatCommandWithArgs(command, args))} successfully executed`);
741
- _clack_prompts.outro(text);
742
- });
743
- context.on("kubb:generation:summary", ({ config, pluginTimings, failedPlugins, filesCreated, status, hrStart }) => {
744
- const summary = getSummary({
745
- failedPlugins,
746
- filesCreated,
747
- config,
748
- status,
749
- hrStart,
750
- pluginTimings: logLevel >= _kubb_core.logLevel.verbose ? pluginTimings : void 0
751
- });
752
- const title = config.name || "";
753
- summary.unshift("\n");
754
- summary.push("\n");
755
- const borderColor = status === "success" ? "green" : "red";
756
- try {
757
- _clack_prompts.box(summary.join("\n"), getMessage(title), {
758
- width: "auto",
759
- formatBorder: (s) => (0, node_util.styleText)(borderColor, s),
760
- rounded: true,
761
- withGuide: false,
762
- contentAlign: "left",
763
- titleAlign: "center"
764
- });
765
- } catch {
766
- console.log(summary.join("\n"));
767
- }
768
- });
769
- context.on("kubb:lifecycle:end", () => {
770
- reset();
771
- });
772
- return (commandWithArgs) => {
773
- if (logLevel <= _kubb_core.logLevel.silent) return {
774
- onStdout: (s) => console.log(s),
775
- onStderr: (s) => console.error(s)
776
- };
777
- const logger = _clack_prompts.taskLog({ title: getMessage(["Executing hook", logLevel >= _kubb_core.logLevel.info ? (0, node_util.styleText)("dim", commandWithArgs) : void 0].filter(Boolean).join(" ")) });
778
- const writable = new ClackWritable(logger);
779
- return {
780
- stream: true,
781
- onLine: (line) => writable.write(line),
782
- onStdout: (s) => logger.message(s),
783
- onStderr: (s) => logger.error(s)
784
- };
785
- };
786
- }
787
- });
788
- //#endregion
789
- //#region src/loggers/fileSystemLogger.ts
790
- /**
791
- * FileSystem logger that captures debug events and writes them to `.kubb` directory files.
792
- *
793
- * @note Logs are written on `kubb:lifecycle:end` or process exit. Cached logs may be lost if the process crashes before either event.
794
- */
795
- const fileSystemLogger = (0, _kubb_core.defineLogger)({
796
- name: "filesystem",
797
- install(context) {
798
- const state = {
799
- cachedLogs: /* @__PURE__ */ new Set(),
800
- startDate: Date.now()
801
- };
802
- function reset() {
803
- state.cachedLogs = /* @__PURE__ */ new Set();
804
- state.startDate = Date.now();
805
- }
806
- async function writeLogs(name) {
807
- if (state.cachedLogs.size === 0) return [];
808
- const files = {};
809
- for (const log of state.cachedLogs) {
810
- const baseName = log.fileName || `${[
811
- "kubb",
812
- name,
813
- state.startDate
814
- ].filter(Boolean).join("-")}.log`;
815
- const pathName = (0, node_path.resolve)(node_process.default.cwd(), ".kubb", baseName);
816
- if (!files[pathName]) files[pathName] = [];
817
- if (log.logs.length > 0) {
818
- const timestamp = log.date.toLocaleString();
819
- files[pathName].push(`[${timestamp}]\n${log.logs.join("\n")}`);
820
- }
821
- }
822
- for (const [fileName, logs] of Object.entries(files)) await write(fileName, logs.join("\n\n"));
823
- return Object.keys(files);
824
- }
825
- context.on("kubb:info", ({ message, info }) => {
826
- state.cachedLogs.add({
827
- date: /* @__PURE__ */ new Date(),
828
- logs: [`ℹ ${message} ${info}`]
829
- });
830
- });
831
- context.on("kubb:success", ({ message, info }) => {
832
- state.cachedLogs.add({
833
- date: /* @__PURE__ */ new Date(),
834
- logs: [`✓ ${message} ${info}`]
835
- });
836
- });
837
- context.on("kubb:warn", ({ message, info }) => {
838
- state.cachedLogs.add({
839
- date: /* @__PURE__ */ new Date(),
840
- logs: [`⚠ ${message} ${info}`]
841
- });
842
- });
843
- context.on("kubb:error", ({ error }) => {
844
- state.cachedLogs.add({
845
- date: /* @__PURE__ */ new Date(),
846
- logs: [`✗ ${error.message}`, error.stack || "unknown stack"]
847
- });
848
- });
849
- context.on("kubb:debug", (message) => {
850
- state.cachedLogs.add({
851
- date: /* @__PURE__ */ new Date(),
852
- logs: message.logs
853
- });
854
- });
855
- context.on("kubb:plugin:start", ({ plugin }) => {
856
- state.cachedLogs.add({
857
- date: /* @__PURE__ */ new Date(),
858
- logs: [`Generating ${plugin.name}`]
859
- });
860
- });
861
- context.on("kubb:plugin:end", ({ plugin, duration, success }) => {
862
- const durationStr = formatMs(duration);
863
- state.cachedLogs.add({
864
- date: /* @__PURE__ */ new Date(),
865
- logs: [success ? `${plugin.name} completed in ${durationStr}` : `${plugin.name} failed in ${durationStr}`]
866
- });
867
- });
868
- context.on("kubb:files:processing:start", ({ files }) => {
869
- state.cachedLogs.add({
870
- date: /* @__PURE__ */ new Date(),
871
- logs: [`Start ${files.length} writing:`, ...files.map((file) => file.path)]
872
- });
873
- });
874
- context.on("kubb:generation:end", async ({ config }) => {
875
- const writtenFilePaths = await writeLogs(config.name);
876
- if (writtenFilePaths.length > 0) {
877
- const files = writtenFilePaths.map((f) => (0, node_path.relative)(node_process.default.cwd(), f));
878
- await context.emit("kubb:info", {
879
- message: "Debug files written to:",
880
- info: files.join(", ")
881
- });
882
- }
883
- reset();
884
- });
885
- const exitHandler = () => {
886
- if (state.cachedLogs.size > 0) writeLogs().catch(() => {});
887
- };
888
- node_process.default.once("exit", exitHandler);
889
- node_process.default.once("SIGINT", exitHandler);
890
- node_process.default.once("SIGTERM", exitHandler);
891
- }
892
- });
893
- //#endregion
894
- //#region src/loggers/githubActionsLogger.ts
895
- /**
896
- * GitHub Actions logger using group annotations for collapsible sections in CI.
897
- */
898
- const githubActionsLogger = (0, _kubb_core.defineLogger)({
899
- name: "github-actions",
900
- install(context, options) {
901
- const logLevel = options?.logLevel ?? _kubb_core.logLevel.info;
902
- const state = {
903
- totalPlugins: 0,
904
- completedPlugins: 0,
905
- failedPlugins: 0,
906
- totalFiles: 0,
907
- processedFiles: 0,
908
- hrStart: process.hrtime(),
909
- currentConfigs: []
910
- };
911
- function reset() {
912
- state.totalPlugins = 0;
913
- state.completedPlugins = 0;
914
- state.failedPlugins = 0;
915
- state.totalFiles = 0;
916
- state.processedFiles = 0;
917
- state.hrStart = process.hrtime();
918
- state.currentConfigs = [];
919
- }
920
- function showProgressStep() {
921
- if (logLevel <= _kubb_core.logLevel.silent) return;
922
- const line = buildProgressLine(state);
923
- if (line) console.log(getMessage(line));
924
- }
925
- function getMessage(message) {
926
- return formatMessage(message, logLevel);
927
- }
928
- function openGroup(name) {
929
- console.log(`::group::${name}`);
930
- }
931
- function closeGroup(_name) {
932
- console.log("::endgroup::");
933
- }
934
- context.on("kubb:info", ({ message, info = "" }) => {
935
- if (logLevel <= _kubb_core.logLevel.silent) return;
936
- const text = getMessage([
937
- (0, node_util.styleText)("blue", "ℹ"),
938
- message,
939
- (0, node_util.styleText)("dim", info)
940
- ].join(" "));
941
- console.log(text);
942
- });
943
- context.on("kubb:success", ({ message, info = "" }) => {
944
- if (logLevel <= _kubb_core.logLevel.silent) return;
945
- const text = getMessage([
946
- (0, node_util.styleText)("blue", "✓"),
947
- message,
948
- logLevel >= _kubb_core.logLevel.info ? (0, node_util.styleText)("dim", info) : void 0
949
- ].filter(Boolean).join(" "));
950
- console.log(text);
951
- });
952
- context.on("kubb:warn", ({ message, info = "" }) => {
953
- if (logLevel <= _kubb_core.logLevel.silent) return;
954
- const text = getMessage([
955
- (0, node_util.styleText)("yellow", "⚠"),
956
- message,
957
- logLevel >= _kubb_core.logLevel.info ? (0, node_util.styleText)("dim", info) : void 0
958
- ].filter(Boolean).join(" "));
959
- console.warn(`::warning::${text}`);
960
- });
961
- context.on("kubb:error", ({ error }) => {
962
- const caused = require_errors.toCause(error);
963
- if (logLevel <= _kubb_core.logLevel.silent) return;
964
- const message = error.message || String(error);
965
- console.error(`::error::${message}`);
966
- if (logLevel >= _kubb_core.logLevel.debug && error.stack) {
967
- const frames = error.stack.split("\n").slice(1, 4);
968
- for (const frame of frames) console.log(getMessage((0, node_util.styleText)("dim", frame.trim())));
969
- if (caused?.stack) {
970
- console.log((0, node_util.styleText)("dim", `└─ caused by ${caused.message}`));
971
- const frames = caused.stack.split("\n").slice(1, 4);
972
- for (const frame of frames) console.log(getMessage(` ${(0, node_util.styleText)("dim", frame.trim())}`));
973
- }
974
- }
975
- });
976
- context.on("kubb:lifecycle:start", ({ version }) => {
977
- console.log((0, node_util.styleText)("yellow", `Kubb ${version} 🧩`));
978
- reset();
979
- });
980
- context.on("kubb:config:start", () => {
981
- if (logLevel <= _kubb_core.logLevel.silent) return;
982
- const text = getMessage("Configuration started");
983
- openGroup("Configuration");
984
- console.log(text);
985
- });
986
- context.on("kubb:config:end", ({ configs }) => {
987
- state.currentConfigs = configs;
988
- if (logLevel <= _kubb_core.logLevel.silent) return;
989
- const text = getMessage("Configuration completed");
990
- console.log(text);
991
- closeGroup("Configuration");
992
- });
993
- context.on("kubb:generation:start", ({ config }) => {
994
- reset();
995
- state.totalPlugins = config.plugins?.length ?? 0;
996
- const text = config.name ? `Generation for ${(0, node_util.styleText)("bold", config.name)}` : "Generation";
997
- if (state.currentConfigs.length > 1) openGroup(text);
998
- if (state.currentConfigs.length === 1) console.log(getMessage(text));
999
- });
1000
- context.on("kubb:plugin:start", ({ plugin }) => {
1001
- if (logLevel <= _kubb_core.logLevel.silent) return;
1002
- const text = getMessage(`Generating ${(0, node_util.styleText)("bold", plugin.name)}`);
1003
- if (state.currentConfigs.length === 1) openGroup(`Plugin: ${plugin.name}`);
1004
- console.log(text);
1005
- });
1006
- context.on("kubb:plugin:end", ({ plugin, duration, success }) => {
1007
- if (logLevel <= _kubb_core.logLevel.silent) return;
1008
- if (success) state.completedPlugins++;
1009
- else state.failedPlugins++;
1010
- const durationStr = formatMsWithColor(duration);
1011
- const text = getMessage(success ? `${(0, node_util.styleText)("bold", plugin.name)} completed in ${durationStr}` : `${(0, node_util.styleText)("bold", plugin.name)} failed in ${(0, node_util.styleText)("red", formatMs(duration))}`);
1012
- console.log(text);
1013
- if (state.currentConfigs.length > 1) console.log(" ");
1014
- if (state.currentConfigs.length === 1) closeGroup(`Plugin: ${plugin.name}`);
1015
- showProgressStep();
1016
- });
1017
- context.on("kubb:files:processing:start", ({ files }) => {
1018
- if (logLevel <= _kubb_core.logLevel.silent) return;
1019
- state.totalFiles = files.length;
1020
- state.processedFiles = 0;
1021
- if (state.currentConfigs.length === 1) openGroup("File Generation");
1022
- const text = getMessage(`Writing ${files.length} files`);
1023
- console.log(text);
1024
- });
1025
- context.on("kubb:files:processing:end", () => {
1026
- if (logLevel <= _kubb_core.logLevel.silent) return;
1027
- const text = getMessage("Files written successfully");
1028
- console.log(text);
1029
- if (state.currentConfigs.length === 1) closeGroup("File Generation");
1030
- showProgressStep();
1031
- });
1032
- context.on("kubb:file:processing:update", () => {
1033
- if (logLevel <= _kubb_core.logLevel.silent) return;
1034
- state.processedFiles++;
1035
- });
1036
- context.on("kubb:generation:end", ({ config }) => {
1037
- const text = getMessage(config.name ? `${(0, node_util.styleText)("blue", "✓")} Generation completed for ${(0, node_util.styleText)("dim", config.name)}` : `${(0, node_util.styleText)("blue", "✓")} Generation completed`);
1038
- console.log(text);
1039
- });
1040
- context.on("kubb:format:start", () => {
1041
- if (logLevel <= _kubb_core.logLevel.silent) return;
1042
- const text = getMessage("Format started");
1043
- if (state.currentConfigs.length === 1) openGroup("Formatting");
1044
- console.log(text);
1045
- });
1046
- context.on("kubb:format:end", () => {
1047
- if (logLevel <= _kubb_core.logLevel.silent) return;
1048
- const text = getMessage("Format completed");
1049
- console.log(text);
1050
- if (state.currentConfigs.length === 1) closeGroup("Formatting");
1051
- });
1052
- context.on("kubb:lint:start", () => {
1053
- if (logLevel <= _kubb_core.logLevel.silent) return;
1054
- const text = getMessage("Lint started");
1055
- if (state.currentConfigs.length === 1) openGroup("Linting");
1056
- console.log(text);
1057
- });
1058
- context.on("kubb:lint:end", () => {
1059
- if (logLevel <= _kubb_core.logLevel.silent) return;
1060
- const text = getMessage("Lint completed");
1061
- console.log(text);
1062
- if (state.currentConfigs.length === 1) closeGroup("Linting");
1063
- });
1064
- context.on("kubb:hook:start", ({ command, args }) => {
1065
- if (logLevel <= _kubb_core.logLevel.silent) return;
1066
- const commandWithArgs = formatCommandWithArgs(command, args);
1067
- const text = getMessage(`Hook ${(0, node_util.styleText)("dim", commandWithArgs)} started`);
1068
- if (state.currentConfigs.length === 1) openGroup(`Hook ${commandWithArgs}`);
1069
- console.log(text);
1070
- });
1071
- context.on("kubb:hook:end", ({ command, args }) => {
1072
- if (logLevel <= _kubb_core.logLevel.silent) return;
1073
- const commandWithArgs = formatCommandWithArgs(command, args);
1074
- const text = getMessage(`Hook ${(0, node_util.styleText)("dim", commandWithArgs)} completed`);
1075
- console.log(text);
1076
- if (state.currentConfigs.length === 1) closeGroup(`Hook ${commandWithArgs}`);
1077
- });
1078
- context.on("kubb:generation:summary", ({ config, status, hrStart, failedPlugins }) => {
1079
- const pluginsCount = config.plugins?.length ?? 0;
1080
- const successCount = pluginsCount - failedPlugins.size;
1081
- const duration = formatHrtime(hrStart);
1082
- if (state.currentConfigs.length > 1) console.log(" ");
1083
- console.log(status === "success" ? `Kubb Summary: ${(0, node_util.styleText)("blue", "✓")} ${`${successCount} successful`}, ${pluginsCount} total, ${(0, node_util.styleText)("green", duration)}` : `Kubb Summary: ${(0, node_util.styleText)("blue", "✓")} ${`${successCount} successful`}, ✗ ${`${failedPlugins.size} failed`}, ${pluginsCount} total, ${(0, node_util.styleText)("green", duration)}`);
1084
- if (state.currentConfigs.length > 1) closeGroup(config.name ? `Generation for ${(0, node_util.styleText)("bold", config.name)}` : "Generation");
1085
- });
1086
- context.on("kubb:lifecycle:end", () => {
1087
- reset();
1088
- });
1089
- return (_commandWithArgs) => ({
1090
- onStdout: logLevel > _kubb_core.logLevel.silent ? (s) => console.log(s) : void 0,
1091
- onStderr: logLevel > _kubb_core.logLevel.silent ? (s) => console.error(`::error::${s}`) : void 0
1092
- });
1093
- }
1094
- });
1095
- //#endregion
1096
- //#region src/loggers/plainLogger.ts
1097
- /**
1098
- * Plain console adapter for non-TTY environments with simple `console.log` output.
1099
- */
1100
- const plainLogger = (0, _kubb_core.defineLogger)({
1101
- name: "plain",
1102
- install(context, options) {
1103
- const logLevel = options?.logLevel ?? _kubb_core.logLevel.info;
1104
- function getMessage(message) {
1105
- return formatMessage(message, logLevel);
1106
- }
1107
- context.on("kubb:info", ({ message, info }) => {
1108
- if (logLevel <= _kubb_core.logLevel.silent) return;
1109
- const text = getMessage([
1110
- "ℹ",
1111
- message,
1112
- info
1113
- ].join(" "));
1114
- console.log(text);
1115
- });
1116
- context.on("kubb:success", ({ message, info = "" }) => {
1117
- if (logLevel <= _kubb_core.logLevel.silent) return;
1118
- const text = getMessage([
1119
- "✓",
1120
- message,
1121
- logLevel >= _kubb_core.logLevel.info ? info : void 0
1122
- ].filter(Boolean).join(" "));
1123
- console.log(text);
1124
- });
1125
- context.on("kubb:warn", ({ message, info }) => {
1126
- if (logLevel < _kubb_core.logLevel.warn) return;
1127
- const text = getMessage([
1128
- "⚠",
1129
- message,
1130
- logLevel >= _kubb_core.logLevel.info ? info : void 0
1131
- ].filter(Boolean).join(" "));
1132
- console.log(text);
1133
- });
1134
- context.on("kubb:error", ({ error }) => {
1135
- const caused = require_errors.toCause(error);
1136
- const text = getMessage(["✗", error.message].join(" "));
1137
- console.log(text);
1138
- if (logLevel >= _kubb_core.logLevel.debug && error.stack) {
1139
- const frames = error.stack.split("\n").slice(1, 4);
1140
- for (const frame of frames) console.log(getMessage(frame.trim()));
1141
- if (caused?.stack) {
1142
- console.log(`└─ caused by ${caused.message}`);
1143
- const frames = caused.stack.split("\n").slice(1, 4);
1144
- for (const frame of frames) console.log(getMessage(` ${frame.trim()}`));
1145
- }
1146
- }
1147
- });
1148
- context.on("kubb:lifecycle:start", () => {
1149
- console.log("Kubb CLI 🧩");
1150
- });
1151
- context.on("kubb:config:start", () => {
1152
- if (logLevel <= _kubb_core.logLevel.silent) return;
1153
- const text = getMessage("Configuration started");
1154
- console.log(text);
1155
- });
1156
- context.on("kubb:config:end", () => {
1157
- if (logLevel <= _kubb_core.logLevel.silent) return;
1158
- const text = getMessage("Configuration completed");
1159
- console.log(text);
1160
- });
1161
- context.on("kubb:generation:start", () => {
1162
- const text = getMessage("Generation started");
1163
- console.log(text);
1164
- });
1165
- context.on("kubb:plugin:start", ({ plugin }) => {
1166
- if (logLevel <= _kubb_core.logLevel.silent) return;
1167
- const text = getMessage(`Generating ${plugin.name}`);
1168
- console.log(text);
1169
- });
1170
- context.on("kubb:plugin:end", ({ plugin, duration, success }) => {
1171
- if (logLevel <= _kubb_core.logLevel.silent) return;
1172
- const durationStr = formatMs(duration);
1173
- const text = getMessage(success ? `${plugin.name} completed in ${durationStr}` : `${plugin.name} failed in ${durationStr}`);
1174
- console.log(text);
1175
- });
1176
- context.on("kubb:files:processing:start", ({ files }) => {
1177
- if (logLevel <= _kubb_core.logLevel.silent) return;
1178
- const text = getMessage(`Writing ${files.length} files`);
1179
- console.log(text);
1180
- });
1181
- context.on("kubb:file:processing:update", ({ file, config }) => {
1182
- if (logLevel <= _kubb_core.logLevel.silent) return;
1183
- const text = getMessage(`Writing ${(0, node_path.relative)(config.root, file.path)}`);
1184
- console.log(text);
1185
- });
1186
- context.on("kubb:files:processing:end", () => {
1187
- if (logLevel <= _kubb_core.logLevel.silent) return;
1188
- const text = getMessage("Files written successfully");
1189
- console.log(text);
1190
- });
1191
- context.on("kubb:generation:end", ({ config }) => {
1192
- const text = getMessage(config.name ? `Generation completed for ${config.name}` : "Generation completed");
1193
- console.log(text);
1194
- });
1195
- context.on("kubb:format:start", () => {
1196
- if (logLevel <= _kubb_core.logLevel.silent) return;
1197
- const text = getMessage("Format started");
1198
- console.log(text);
1199
- });
1200
- context.on("kubb:format:end", () => {
1201
- if (logLevel <= _kubb_core.logLevel.silent) return;
1202
- const text = getMessage("Format completed");
1203
- console.log(text);
1204
- });
1205
- context.on("kubb:lint:start", () => {
1206
- if (logLevel <= _kubb_core.logLevel.silent) return;
1207
- const text = getMessage("Lint started");
1208
- console.log(text);
1209
- });
1210
- context.on("kubb:lint:end", () => {
1211
- if (logLevel <= _kubb_core.logLevel.silent) return;
1212
- const text = getMessage("Lint completed");
1213
- console.log(text);
1214
- });
1215
- context.on("kubb:hook:start", ({ command, args }) => {
1216
- if (logLevel <= _kubb_core.logLevel.silent) return;
1217
- const text = getMessage(`Hook ${formatCommandWithArgs(command, args)} started`);
1218
- console.log(text);
1219
- });
1220
- context.on("kubb:hook:end", ({ command, args }) => {
1221
- if (logLevel <= _kubb_core.logLevel.silent) return;
1222
- const text = getMessage(`Hook ${formatCommandWithArgs(command, args)} completed`);
1223
- console.log(text);
1224
- });
1225
- context.on("kubb:generation:summary", ({ config, pluginTimings, status, hrStart, failedPlugins, filesCreated }) => {
1226
- const summary = getSummary({
1227
- failedPlugins,
1228
- filesCreated,
1229
- config,
1230
- status,
1231
- hrStart,
1232
- pluginTimings: logLevel >= _kubb_core.logLevel.verbose ? pluginTimings : void 0
1233
- });
1234
- console.log(require_constants.SUMMARY_SEPARATOR);
1235
- console.log(summary.join("\n"));
1236
- console.log(require_constants.SUMMARY_SEPARATOR);
1237
- });
1238
- return (_commandWithArgs) => ({
1239
- onStdout: logLevel > _kubb_core.logLevel.silent ? (s) => console.log(s) : void 0,
1240
- onStderr: logLevel > _kubb_core.logLevel.silent ? (s) => console.error(s) : void 0
1241
- });
1242
- }
1243
- });
1244
- //#endregion
1245
- //#region src/loggers/utils.ts
1246
- /**
1247
- * Optionally prefix a message with a [HH:MM:SS] timestamp when logLevel >= verbose.
1248
- * Shared across all logger adapters to avoid duplication.
1249
- */
1250
- function formatMessage(message, logLevel) {
1251
- if (logLevel >= _kubb_core.logLevel.verbose) return `${(0, node_util.styleText)("dim", `[${(/* @__PURE__ */ new Date()).toLocaleTimeString("en-US", {
1252
- hour12: false,
1253
- hour: "2-digit",
1254
- minute: "2-digit",
1255
- second: "2-digit"
1256
- })}]`)} ${message}`;
1257
- return message;
1258
- }
1259
- /**
1260
- * Build the progress summary line shared by clack and GitHub Actions loggers.
1261
- * Returns null when there is nothing to display.
1262
- */
1263
- function buildProgressLine(state) {
1264
- const parts = [];
1265
- const duration = formatHrtime(state.hrStart);
1266
- if (state.totalPlugins > 0) {
1267
- const pluginStr = state.failedPlugins > 0 ? `Plugins ${(0, node_util.styleText)("green", state.completedPlugins.toString())}/${state.totalPlugins} ${(0, node_util.styleText)("red", `(${state.failedPlugins} failed)`)}` : `Plugins ${(0, node_util.styleText)("green", state.completedPlugins.toString())}/${state.totalPlugins}`;
1268
- parts.push(pluginStr);
1269
- }
1270
- if (state.totalFiles > 0) parts.push(`Files ${(0, node_util.styleText)("green", state.processedFiles.toString())}/${state.totalFiles}`);
1271
- if (parts.length === 0) return null;
1272
- parts.push(`${(0, node_util.styleText)("green", duration)} elapsed`);
1273
- return parts.join((0, node_util.styleText)("dim", " | "));
1274
- }
1275
- /**
1276
- * Join a command and its optional args into a single display string.
1277
- * e.g. ("prettier", ["--write", "."]) → "prettier --write ."
1278
- */
1279
- function formatCommandWithArgs(command, args) {
1280
- return args?.length ? `${command} ${args.join(" ")}` : command;
1281
- }
1282
- function detectLogger() {
1283
- if (require_telemetry.isGitHubActions()) return "github-actions";
1284
- if (require_telemetry.canUseTTY()) return "clack";
1285
- return "plain";
1286
- }
1287
- const logMapper = {
1288
- clack: clackLogger,
1289
- plain: plainLogger,
1290
- "github-actions": githubActionsLogger
1291
- };
1292
- async function setupLogger(context, { logLevel }) {
1293
- const type = detectLogger();
1294
- const logger = logMapper[type];
1295
- if (!logger) throw new Error(`Unknown adapter type: ${type}`);
1296
- const makeSink = await logger.install(context, { logLevel });
1297
- if (logLevel >= _kubb_core.logLevel.debug) await fileSystemLogger.install(context, { logLevel });
1298
- return typeof makeSink === "function" ? makeSink : void 0;
1299
- }
1300
- /**
1301
- * Builds the generation summary lines rendered in the end-of-run box.
1302
- * Returns an array of styled strings, one per summary row.
1303
- */
1304
- function getSummary({ failedPlugins, filesCreated, status, hrStart, config, pluginTimings }) {
1305
- const duration = formatHrtime(hrStart);
1306
- const pluginsCount = config.plugins?.length ?? 0;
1307
- const successCount = pluginsCount - failedPlugins.size;
1308
- const meta = {
1309
- plugins: status === "success" ? `${(0, node_util.styleText)("green", `${successCount} successful`)}, ${pluginsCount} total` : `${(0, node_util.styleText)("green", `${successCount} successful`)}, ${(0, node_util.styleText)("red", `${failedPlugins.size} failed`)}, ${pluginsCount} total`,
1310
- pluginsFailed: status === "failed" ? [...failedPlugins].map(({ plugin }) => randomCliColor(plugin.name)).join(", ") : void 0,
1311
- filesCreated,
1312
- time: (0, node_util.styleText)("green", duration),
1313
- output: node_path.default.resolve(config.root, config.output.path)
1314
- };
1315
- const labels = {
1316
- plugins: "Plugins:",
1317
- failed: "Failed:",
1318
- generated: "Generated:",
1319
- pluginTimings: "Plugin Timings:",
1320
- output: "Output:"
1321
- };
1322
- const maxLength = Math.max(0, ...[...Object.values(labels), ...pluginTimings ? Array.from(pluginTimings.keys()) : []].map((s) => s.length));
1323
- const summaryLines = [];
1324
- summaryLines.push(`${labels.plugins.padEnd(maxLength + 2)} ${meta.plugins}`);
1325
- if (meta.pluginsFailed) summaryLines.push(`${labels.failed.padEnd(maxLength + 2)} ${meta.pluginsFailed}`);
1326
- summaryLines.push(`${labels.generated.padEnd(maxLength + 2)} ${meta.filesCreated} files in ${meta.time}`);
1327
- if (pluginTimings && pluginTimings.size > 0) {
1328
- const sortedTimings = Array.from(pluginTimings.entries()).sort((a, b) => b[1] - a[1]);
1329
- summaryLines.push(`${labels.pluginTimings}`);
1330
- sortedTimings.forEach(([name, time]) => {
1331
- const timeStr = time >= 1e3 ? `${(time / 1e3).toFixed(2)}s` : `${Math.round(time)}ms`;
1332
- const barLength = Math.min(Math.ceil(time / 100), 10);
1333
- const bar = (0, node_util.styleText)("dim", "█".repeat(barLength));
1334
- summaryLines.push(`${(0, node_util.styleText)("dim", "•")} ${name.padEnd(maxLength + 1)}${bar} ${timeStr}`);
1335
- });
1336
- }
1337
- summaryLines.push(`${labels.output.padEnd(maxLength + 2)} ${meta.output}`);
1338
- return summaryLines;
1339
- }
1340
- //#endregion
1341
- //#region src/runners/generate/utils.ts
1342
- const jiti$1 = (0, jiti.createJiti)(require("url").pathToFileURL(__filename).href, {
1343
- jsx: {
1344
- runtime: "automatic",
1345
- importSource: "@kubb/renderer-jsx"
1346
- },
1347
- moduleCache: false
1348
- });
1349
- const tsLoader = (configFile) => jiti$1.import(configFile, { default: true });
1350
- const MODULE_NAME = "kubb";
1351
- const BASE_SEARCH_PLACES = [
1352
- "package.json",
1353
- `.${MODULE_NAME}rc`,
1354
- `.${MODULE_NAME}rc.json`,
1355
- `.${MODULE_NAME}rc.yaml`,
1356
- `.${MODULE_NAME}rc.yml`,
1357
- `.${MODULE_NAME}rc.ts`,
1358
- `.${MODULE_NAME}rc.mts`,
1359
- `.${MODULE_NAME}rc.cts`,
1360
- `.${MODULE_NAME}rc.js`,
1361
- `.${MODULE_NAME}rc.mjs`,
1362
- `.${MODULE_NAME}rc.cjs`,
1363
- `${MODULE_NAME}.config.ts`,
1364
- `${MODULE_NAME}.config.mts`,
1365
- `${MODULE_NAME}.config.cts`,
1366
- `${MODULE_NAME}.config.js`,
1367
- `${MODULE_NAME}.config.mjs`,
1368
- `${MODULE_NAME}.config.cjs`
1369
- ];
1370
- const SEARCH_PLACES = [
1371
- "",
1372
- ".config/",
1373
- "configs/"
1374
- ].flatMap((prefix) => BASE_SEARCH_PLACES.map((p) => `${prefix}${p}`));
1375
- async function getCosmiConfig(configFile) {
1376
- const explorer = (0, cosmiconfig.cosmiconfig)(MODULE_NAME, {
1377
- cache: false,
1378
- searchPlaces: SEARCH_PLACES,
1379
- loaders: {
1380
- ".ts": tsLoader,
1381
- ".mts": tsLoader,
1382
- ".cts": tsLoader
1383
- }
1384
- });
1385
- let result;
1386
- try {
1387
- result = configFile ? await explorer.load(configFile) : await explorer.search();
1388
- } catch (error) {
1389
- throw new Error("Config failed loading", { cause: error });
1390
- }
1391
- if (!result?.config || result.isEmpty) throw new Error("Config not defined, create a kubb.config.js or pass through your config with the option --config");
1392
- return result;
1393
- }
1394
- /**
1395
- * Discovers the Kubb config via cosmiconfig and resolves it into a normalized array of configs.
1396
- * Every config in the result is guaranteed to have a `plugins` array.
1397
- */
1398
- async function getConfigs({ configPath, input }) {
1399
- const result = await getCosmiConfig(configPath);
1400
- const resolved = await (typeof result.config === "function" ? result.config({ input }) : result.config);
1401
- const userConfigs = Array.isArray(resolved) ? resolved : [resolved];
1402
- return {
1403
- configPath: result.filepath,
1404
- configs: userConfigs.map((item) => ({
1405
- ...item,
1406
- plugins: item.plugins ?? []
1407
- }))
1408
- };
1409
- }
1410
- /**
1411
- * Runs the `done` hooks defined in a Kubb config in sequence.
1412
- */
1413
- async function executeHooks({ configHooks, hooks, makeSink }) {
1414
- const commands = Array.isArray(configHooks.done) ? configHooks.done : [configHooks.done].filter(Boolean);
1415
- for (const command of commands) {
1416
- const [cmd, ...args] = require_shell.tokenize(command);
1417
- if (!cmd) continue;
1418
- const hookId = (0, node_crypto.createHash)("sha256").update(command).digest("hex");
1419
- const commandWithArgs = [cmd, ...args].join(" ");
1420
- await hooks.emit("kubb:hook:start", {
1421
- id: hookId,
1422
- command: cmd,
1423
- args
1424
- });
1425
- const { stream = false, onLine, onStdout, onStderr } = makeSink?.(commandWithArgs) ?? {};
1426
- await runHook({
1427
- id: hookId,
1428
- command: cmd,
1429
- args,
1430
- commandWithArgs,
1431
- context: hooks,
1432
- stream,
1433
- sink: {
1434
- onLine,
1435
- onStdout,
1436
- onStderr
1437
- }
1438
- });
1439
- }
1440
- }
1441
- async function runHook({ id, command, args, commandWithArgs, context, stream = false, sink }) {
1442
- const emitEnd = (success, error) => context.emit("kubb:hook:end", {
1443
- command,
1444
- args,
1445
- id,
1446
- success,
1447
- error
1448
- });
1449
- try {
1450
- const proc = (0, tinyexec.x)(command, [...args ?? []], {
1451
- nodeOptions: { detached: process.platform !== "win32" },
1452
- throwOnError: true
1453
- });
1454
- if (stream && sink?.onLine) for await (const line of proc) sink.onLine(line);
1455
- const result = await proc;
1456
- await context.emit("kubb:debug", {
1457
- date: /* @__PURE__ */ new Date(),
1458
- logs: [result.stdout.trimEnd()]
1459
- });
1460
- await context.emit("kubb:success", { message: `${(0, node_util.styleText)("dim", commandWithArgs)} successfully executed` });
1461
- await emitEnd(true, null);
1462
- } catch (err) {
1463
- if (!(err instanceof tinyexec.NonZeroExitError)) {
1464
- const error = require_errors.toError(err);
1465
- await emitEnd(false, error);
1466
- await context.emit("kubb:error", { error });
1467
- return;
1468
- }
1469
- const stderr = err.output?.stderr ?? "";
1470
- const stdout = err.output?.stdout ?? "";
1471
- await context.emit("kubb:debug", {
1472
- date: /* @__PURE__ */ new Date(),
1473
- logs: [stdout, stderr].filter(Boolean)
1474
- });
1475
- if (stderr) sink?.onStderr?.(stderr);
1476
- if (stdout) sink?.onStdout?.(stdout);
1477
- const error = /* @__PURE__ */ new Error(`Hook execute failed: ${commandWithArgs}`);
1478
- await emitEnd(false, error);
1479
- await context.emit("kubb:error", { error });
1480
- }
1481
- }
1482
- /**
1483
- * Starts a file watcher on the given paths and calls `cb` on any change.
1484
- * Ignores `.git` and `node_modules` directories.
1485
- */
1486
- async function startWatcher(path, cb, log = {
1487
- info: console.log,
1488
- error: console.log
1489
- }) {
1490
- const { watch } = await import("chokidar");
1491
- watch(path, {
1492
- ignorePermissionErrors: true,
1493
- ignored: require_constants.WATCHER_IGNORED_PATHS
1494
- }).on("all", async (type, file) => {
1495
- log.info((0, node_util.styleText)("yellow", (0, node_util.styleText)("bold", `Change detected: ${type} ${file}`)));
1496
- try {
1497
- await cb(path);
1498
- } catch (_e) {
1499
- log.error((0, node_util.styleText)("red", "Watcher failed"));
1500
- }
1501
- });
1502
- }
1503
- //#endregion
1504
- //#region src/runners/generate/run.ts
1505
- /**
1506
- * Registers a one-shot `kubb:hook:end` listener for `hookId` BEFORE the caller emits `kubb:hook:start`,
1507
- * avoiding the race where a synchronous emitter fires end before the listener is attached.
1508
- */
1509
- function waitForHookEnd(hooks, hookId, onSuccess, fallbackErrorMessage) {
1510
- return new Promise((resolve, reject) => {
1511
- const handler = (ctx) => {
1512
- if (ctx.id !== hookId) return;
1513
- hooks.off("kubb:hook:end", handler);
1514
- if (!ctx.success) {
1515
- reject(ctx.error ?? new Error(fallbackErrorMessage));
1516
- return;
1517
- }
1518
- onSuccess().then(resolve).catch(reject);
1519
- };
1520
- hooks.on("kubb:hook:end", handler);
1521
- });
1522
- }
1523
- async function runToolPass({ toolValue, detect, toolMap, toolLabel, successPrefix, noToolMessage, configName, outputPath, logLevel, hooks, onStart, onEnd }) {
1524
- await onStart();
1525
- let resolvedTool = toolValue;
1526
- if (resolvedTool === "auto") {
1527
- const detected = await detect();
1528
- if (!detected) await hooks.emit("kubb:warn", { message: noToolMessage });
1529
- else {
1530
- resolvedTool = detected;
1531
- await hooks.emit("kubb:info", { message: `Auto-detected ${toolLabel}: ${(0, node_util.styleText)("dim", resolvedTool)}` });
1532
- }
1533
- }
1534
- let toolError;
1535
- if (resolvedTool && resolvedTool !== "auto" && resolvedTool in toolMap) {
1536
- const toolConfig = toolMap[resolvedTool];
1537
- const hookId = (0, node_crypto.createHash)("sha256").update([configName, resolvedTool].filter(Boolean).join("-")).digest("hex");
1538
- const successMessage = [
1539
- `${successPrefix} with ${(0, node_util.styleText)("dim", resolvedTool)}`,
1540
- logLevel >= _kubb_core.logLevel.info ? `on ${(0, node_util.styleText)("dim", outputPath)}` : void 0,
1541
- "successfully"
1542
- ].filter(Boolean).join(" ");
1543
- try {
1544
- const hookEndPromise = waitForHookEnd(hooks, hookId, () => hooks.emit("kubb:success", { message: successMessage }), toolConfig.errorMessage);
1545
- await hooks.emit("kubb:hook:start", {
1546
- id: hookId,
1547
- command: toolConfig.command,
1548
- args: toolConfig.args(outputPath)
1549
- });
1550
- await hookEndPromise;
1551
- } catch (caughtError) {
1552
- const err = require_errors.toError(caughtError);
1553
- await hooks.emit("kubb:error", { error: err });
1554
- toolError = err;
1555
- }
1556
- }
1557
- await onEnd();
1558
- if (toolError) throw toolError;
1559
- }
1560
- async function generate(options) {
1561
- const { input, hooks, logLevel, makeSink } = options;
1562
- const hrStart = node_process.default.hrtime();
1563
- const inputPath = input ?? (options.config.input && "path" in options.config.input ? options.config.input.path : void 0);
1564
- const config = {
1565
- ...options.config,
1566
- input: inputPath ? {
1567
- ...options.config.input,
1568
- path: inputPath
1569
- } : options.config.input,
1570
- ...options.config.output
1571
- };
1572
- const kubb = (0, _kubb_core.createKubb)(config, { hooks });
1573
- await kubb.setup();
1574
- await hooks.emit("kubb:generation:start", { config });
1575
- await hooks.emit("kubb:info", {
1576
- message: config.name ? `Setup generation ${(0, node_util.styleText)("bold", config.name)}` : "Setup generation",
1577
- info: inputPath
1578
- });
1579
- await hooks.emit("kubb:info", {
1580
- message: config.name ? `Build generation ${(0, node_util.styleText)("bold", config.name)}` : "Build generation",
1581
- info: inputPath
1582
- });
1583
- const { files, failedPlugins, pluginTimings, error, driver } = await kubb.safeBuild();
1584
- await hooks.emit("kubb:info", { message: "Load summary" });
1585
- const telemetryPlugins = Array.from(driver.plugins.values(), (p) => ({
1586
- name: p.name,
1587
- options: p.options
1588
- }));
1589
- const reportTelemetry = (status) => require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
1590
- command: "generate",
1591
- kubbVersion: require_package.version,
1592
- plugins: telemetryPlugins,
1593
- hrStart,
1594
- filesCreated: files.length,
1595
- status
1596
- }));
1597
- if (failedPlugins.size > 0 || error) {
1598
- const allErrors = [error, ...Array.from(failedPlugins, (it) => it.error)].filter(Boolean);
1599
- for (const err of allErrors) await hooks.emit("kubb:error", { error: err });
1600
- await hooks.emit("kubb:generation:end", {
1601
- config,
1602
- files,
1603
- sources: kubb.sources
1604
- });
1605
- await hooks.emit("kubb:generation:summary", {
1606
- config,
1607
- failedPlugins,
1608
- filesCreated: files.length,
1609
- status: "failed",
1610
- hrStart,
1611
- pluginTimings: logLevel >= _kubb_core.logLevel.verbose ? pluginTimings : void 0
1612
- });
1613
- await reportTelemetry("failed");
1614
- node_process.default.exit(1);
1615
- }
1616
- await hooks.emit("kubb:success", {
1617
- message: "Generation succeeded",
1618
- info: inputPath
1619
- });
1620
- await hooks.emit("kubb:generation:end", {
1621
- config,
1622
- files,
1623
- sources: kubb.sources
1624
- });
1625
- const outputPath = node_path.default.resolve(config.root, config.output.path);
1626
- const toolPasses = [config.output.format && {
1627
- toolValue: config.output.format,
1628
- detect: detectFormatter,
1629
- toolMap: formatters,
1630
- toolLabel: "formatter",
1631
- successPrefix: "Formatting",
1632
- noToolMessage: "No formatter found (oxfmt, biome, or prettier). Skipping formatting.",
1633
- onStart: () => hooks.emit("kubb:format:start"),
1634
- onEnd: () => hooks.emit("kubb:format:end")
1635
- }, config.output.lint && {
1636
- toolValue: config.output.lint,
1637
- detect: detectLinter,
1638
- toolMap: linters,
1639
- toolLabel: "linter",
1640
- successPrefix: "Linting",
1641
- noToolMessage: "No linter found (oxlint, biome, or eslint). Skipping linting.",
1642
- onStart: () => hooks.emit("kubb:lint:start"),
1643
- onEnd: () => hooks.emit("kubb:lint:end")
1644
- }].filter(Boolean);
1645
- for (const pass of toolPasses) await runToolPass({
1646
- ...pass,
1647
- configName: config.name,
1648
- outputPath,
1649
- logLevel,
1650
- hooks
1651
- });
1652
- if (config.hooks) {
1653
- await hooks.emit("kubb:hooks:start");
1654
- await executeHooks({
1655
- configHooks: config.hooks,
1656
- hooks,
1657
- makeSink
1658
- });
1659
- await hooks.emit("kubb:hooks:end");
1660
- }
1661
- await hooks.emit("kubb:generation:summary", {
1662
- config,
1663
- failedPlugins,
1664
- filesCreated: files.length,
1665
- status: "success",
1666
- hrStart,
1667
- pluginTimings
1668
- });
1669
- await reportTelemetry("success");
1670
- }
1671
- async function checkForUpdate(hooks) {
1672
- await require_telemetry.executeIfOnline(async () => {
1673
- try {
1674
- const data = await (await fetch(require_constants.KUBB_NPM_PACKAGE_URL)).json();
1675
- if (data.version && require_package.version < data.version) await hooks.emit("kubb:version:new", {
1676
- currentVersion: require_package.version,
1677
- latestVersion: data.version
1678
- });
1679
- } catch {}
1680
- });
1681
- }
1682
- /**
1683
- * Runs the full Kubb generation lifecycle for the given CLI options.
1684
- * Sets up the logger, checks for a newer version, loads configs, and calls `generate` for each config entry.
1685
- */
1686
- async function run({ input, configPath, logLevel: logLevelKey, watch }) {
1687
- const logLevel = _kubb_core.logLevel[logLevelKey] ?? _kubb_core.logLevel.info;
1688
- const hooks = new AsyncEventEmitter();
1689
- const makeSink = await setupLogger(hooks, { logLevel });
1690
- await checkForUpdate(hooks);
1691
- try {
1692
- const { configs, configPath: resolvedConfigPath } = await getConfigs({
1693
- configPath,
1694
- input
1695
- });
1696
- const relativeConfigPath = node_path.default.relative(node_process.default.cwd(), resolvedConfigPath);
1697
- await hooks.emit("kubb:config:start");
1698
- await hooks.emit("kubb:info", {
1699
- message: "Config loaded",
1700
- info: relativeConfigPath
1701
- });
1702
- await hooks.emit("kubb:success", {
1703
- message: "Config loaded successfully",
1704
- info: relativeConfigPath
1705
- });
1706
- await hooks.emit("kubb:config:end", { configs });
1707
- await hooks.emit("kubb:lifecycle:start", { version: require_package.version });
1708
- for (const config of configs) if ((0, _kubb_core.isInputPath)(config) && watch) await startWatcher([input || config.input.path], async (paths) => {
1709
- hooks.removeAll();
1710
- await generate({
1711
- input,
1712
- config,
1713
- logLevel,
1714
- hooks,
1715
- makeSink
1716
- });
1717
- _clack_prompts.log.step((0, node_util.styleText)("yellow", `Watching for changes in ${paths.join(" and ")}`));
1718
- }, {
1719
- info: (msg) => _clack_prompts.log.info(msg),
1720
- error: (msg) => _clack_prompts.log.error(msg)
1721
- });
1722
- else await generate({
1723
- input,
1724
- config,
1725
- logLevel,
1726
- hooks,
1727
- makeSink
1728
- });
1729
- await hooks.emit("kubb:lifecycle:end");
1730
- } catch (error) {
1731
- await hooks.emit("kubb:error", { error: require_errors.toError(error) });
1732
- node_process.default.exit(1);
1733
- }
1734
- }
1735
- //#endregion
1736
- exports.run = run;
1737
-
1738
- //# sourceMappingURL=run-CqKd6JNc.cjs.map