@kubb/cli 4.28.1 → 4.29.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/cli",
-  "version": "4.28.1",
+  "version": "4.29.1",
   "description": "Command-line interface for Kubb, enabling easy generation of TypeScript, React-Query, Zod, and other code from OpenAPI specifications.",
   "keywords": [
     "cli",
@@ -19,7 +19,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/kubb-labs/kubb.git",
+    "url": "git+https://github.com/kubb-labs/kubb.git",
     "directory": "packages/cli"
   },
   "license": "MIT",
@@ -28,14 +28,12 @@
   "type": "module",
   "exports": {
     ".": {
-      "require": "./dist/index.cjs",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
     },
     "./package.json": "./package.json"
   },
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.cts",
+  "types": "./dist/index.d.ts",
   "bin": {
     "kubb": "bin/kubb.cjs"
   },
@@ -58,24 +56,15 @@
     "chokidar": "^5.0.0",
     "citty": "^0.1.6",
     "cosmiconfig": "^9.0.0",
-    "dotenv": "^17.3.1",
-    "execa": "^9.6.1",
-    "gradient-string": "^3.0.0",
     "jiti": "2.5.1",
-    "latest-version": "^9.0.0",
-    "picocolors": "^1.1.1",
-    "seedrandom": "^3.0.5",
-    "semver": "^7.7.4",
-    "string-argv": "^0.3.2",
-    "@kubb/core": "4.28.1"
+    "tinyexec": "^1.0.2",
+    "@kubb/core": "4.29.1"
   },
   "devDependencies": {
-    "@types/seedrandom": "^3.0.8",
-    "@types/semver": "^7.7.1",
     "source-map-support": "^0.5.21",
-    "@kubb/agent": "4.28.1",
-    "@kubb/mcp": "4.28.1",
-    "@kubb/oas": "4.28.1"
+    "@kubb/agent": "4.29.1",
+    "@kubb/mcp": "4.29.1",
+    "@kubb/oas": "4.29.1"
   },
   "engines": {
     "node": ">=20"
@@ -85,6 +74,8 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
   "scripts": {
     "build": "tsdown && size-limit",
     "clean": "npx rimraf ./dist",

package/src/commands/agent/start.ts

@@ -1,13 +1,11 @@
+import { spawn } from 'node:child_process'
 import path from 'node:path'
 import * as process from 'node:process'
 import { fileURLToPath } from 'node:url'
-
+import { styleText } from 'node:util'
 import * as clack from '@clack/prompts'
 import type { ArgsDef } from 'citty'
 import { defineCommand } from 'citty'
-import { config as loadEnv } from 'dotenv'
-import { execa } from 'execa'
-import pc from 'picocolors'
 
 const args = {
   config: {
@@ -53,8 +51,12 @@ type StartServerProps = {
 
 async function startServer({ port, host, configPath, noCache, allowWrite, allowAll }: StartServerProps): Promise<void> {
   try {
-    // Load .env files into process.env (supports .env, .env.local, .env.*.local)
-    loadEnv() // .env
+    // Load .env file into process.env using Node.js built-in (v20.12.0+)
+    try {
+      process.loadEnvFile()
+    } catch {
+      // .env file may not exist; ignore
+    }
 
     // Resolve the @kubb/agent package path
     const agentPkgUrl = import.meta.resolve('@kubb/agent/package.json')
@@ -90,20 +92,19 @@ async function startServer({ port, host, configPath, noCache, allowWrite, allowA
       KUBB_STUDIO_URL,
     }
 
-    clack.log.step(pc.cyan('Starting agent server...'))
-    clack.log.info(pc.dim(`Config: ${KUBB_AGENT_CONFIG}`))
-    clack.log.info(pc.dim(`Host: ${HOST}`))
-    clack.log.info(pc.dim(`Port: ${PORT}`))
+    clack.log.step(styleText('cyan', 'Starting agent server...'))
+    clack.log.info(styleText('dim', `Config: ${KUBB_AGENT_CONFIG}`))
+    clack.log.info(styleText('dim', `Host: ${HOST}`))
+    clack.log.info(styleText('dim', `Port: ${PORT}`))
     if (noCache) {
-      clack.log.info(pc.dim('Session caching: disabled'))
+      clack.log.info(styleText('dim', 'Session caching: disabled'))
     }
     if (!KUBB_AGENT_ALLOW_WRITE && !KUBB_AGENT_ALLOW_ALL) {
-      clack.log.warn(pc.yellow('Filesystem writes disabled. Use --allow-write or --allow-all to enable.'))
+      clack.log.warn(styleText('yellow', 'Filesystem writes disabled. Use --allow-write or --allow-all to enable.'))
     }
 
-    // Use execa to spawn the server process
-    await execa('node', [serverPath], {
-      env,
+    spawn('node', [serverPath], {
+      env: { ...process.env, ...env },
       stdio: 'inherit',
       cwd: process.cwd(),
     })
@@ -132,7 +133,7 @@ const command = defineCommand({
 
       await startServer({ port, host, configPath, noCache, allowWrite, allowAll })
     } catch (error) {
-      clack.log.error(pc.red('Failed to start agent server'))
+      clack.log.error(styleText('red', 'Failed to start agent server'))
       console.error(error)
       process.exit(1)
     }

package/src/commands/generate.ts

@@ -1,13 +1,11 @@
 import path from 'node:path'
 import * as process from 'node:process'
+import { styleText } from 'node:util'
 import * as clack from '@clack/prompts'
 import { type CLIOptions, isInputPath, type KubbEvents, LogLevel, PromiseManager } from '@kubb/core'
 import { AsyncEventEmitter, executeIfOnline, getConfigs } from '@kubb/core/utils'
 import type { ArgsDef, ParsedArgs } from 'citty'
 import { defineCommand, showUsage } from 'citty'
-import getLatestVersion from 'latest-version'
-import pc from 'picocolors'
-import { lt } from 'semver'
 import { version } from '../../package.json'
 import { setupLogger } from '../loggers/utils.ts'
 import { generate } from '../runners/generate.ts'
@@ -94,10 +92,16 @@ const command = defineCommand({
     await setupLogger(events, { logLevel })
 
     await executeIfOnline(async () => {
-      const latestVersion = await getLatestVersion('@kubb/cli')
+      try {
+        const res = await fetch('https://registry.npmjs.org/@kubb/cli/latest')
+        const data = (await res.json()) as { version: string }
+        const latestVersion = data.version
 
-      if (lt(version, latestVersion)) {
-        await events.emit('version:new', version, latestVersion)
+        if (latestVersion && version < latestVersion) {
+          await events.emit('version:new', version, latestVersion)
+        }
+      } catch {
+        // Ignore network errors for version check
       }
     })
 
@@ -118,6 +122,9 @@ const command = defineCommand({
         return async () => {
           if (isInputPath(config) && args.watch) {
             await startWatcher([input || config.input.path], async (paths) => {
+              // remove to avoid duplicate listeners after each change
+              events.removeAll()
+
               await generate({
                 input,
                 config,
@@ -125,7 +132,7 @@ const command = defineCommand({
                 events,
               })
 
-              clack.log.step(pc.yellow(`Watching for changes in ${paths.join(' and ')}`))
+              clack.log.step(styleText('yellow', `Watching for changes in ${paths.join(' and ')}`))
             })
 
             return

package/src/commands/init.ts

@@ -1,9 +1,9 @@
 import fs from 'node:fs'
 import path from 'node:path'
 import process from 'node:process'
+import { styleText } from 'node:util'
 import * as clack from '@clack/prompts'
 import { defineCommand } from 'citty'
-import pc from 'picocolors'
 import { version } from '../../package.json'
 import { detectPackageManager, hasPackageJson, initPackageJson, installPackages, type PackageManagerInfo } from '../utils/packageManager.ts'
 
@@ -186,7 +186,7 @@ const command = defineCommand({
     const cwd = process.cwd()
     const yes = args.yes
 
-    clack.intro(pc.bgCyan(pc.black(' Kubb Init ')))
+    clack.intro(styleText('bgCyan', styleText('black', ' Kubb Init ')))
 
     try {
       // Check/create package.json
@@ -215,14 +215,14 @@ const command = defineCommand({
         spinner.stop(`Created package.json with ${packageManager.name}`)
       } else {
         packageManager = detectPackageManager(cwd)
-        clack.log.info(`Detected package manager: ${pc.cyan(packageManager.name)}`)
+        clack.log.info(`Detected package manager: ${styleText('cyan', packageManager.name)}`)
       }
 
       // Prompt for OpenAPI spec path
       let inputPath: string
       if (yes) {
         inputPath = DEFAULT_INPUT_PATH
-        clack.log.info(`Using input path: ${pc.cyan(inputPath)}`)
+        clack.log.info(`Using input path: ${styleText('cyan', inputPath)}`)
       } else {
         const inputPathResult = await clack.text({
           message: 'Where is your OpenAPI specification located?',
@@ -244,7 +244,7 @@ const command = defineCommand({
       let outputPath: string
       if (yes) {
         outputPath = DEFAULT_OUTPUT_PATH
-        clack.log.info(`Using output path: ${pc.cyan(outputPath)}`)
+        clack.log.info(`Using output path: ${styleText('cyan', outputPath)}`)
       } else {
         const outputPathResult = await clack.text({
           message: 'Where should the generated files be output?',
@@ -266,7 +266,7 @@ const command = defineCommand({
       let selectedPlugins: PluginOption[]
       if (yes) {
         selectedPlugins = plugins.filter((plugin) => DEFAULT_PLUGINS.includes(plugin.value))
-        clack.log.info(`Using plugins: ${pc.cyan(selectedPlugins.map((p) => p.label).join(', '))}`)
+        clack.log.info(`Using plugins: ${styleText('cyan', selectedPlugins.map((p) => p.label).join(', '))}`)
       } else {
         const selectedPluginValues = await clack.multiselect({
           message: 'Select plugins to use:',
@@ -338,22 +338,22 @@ const command = defineCommand({
 
       // Success message
       clack.outro(
-        pc.green('✓ All set!') +
+        styleText('green', '✓ All set!') +
           '\n\n' +
-          pc.dim('Next steps:') +
+          styleText('dim', 'Next steps:') +
           '\n' +
-          pc.cyan(`  1. Make sure your OpenAPI spec is at: ${inputPath}`) +
+          styleText('cyan', `  1. Make sure your OpenAPI spec is at: ${inputPath}`) +
           '\n' +
-          pc.cyan('  2. Generate code with: npx kubb generate') +
+          styleText('cyan', '  2. Generate code with: npx kubb generate') +
           '\n' +
-          pc.cyan('     Or start a stream server with: npx kubb start') +
+          styleText('cyan', '     Or start a stream server with: npx kubb start') +
           '\n' +
-          pc.cyan(`  3. Find generated files in: ${outputPath}`) +
+          styleText('cyan', `  3. Find generated files in: ${outputPath}`) +
           '\n\n' +
-          pc.dim(`Using ${packageManager.name} • Kubb v${version}`),
+          styleText('dim', `Using ${packageManager.name} • Kubb v${version}`),
       )
     } catch (error) {
-      clack.log.error(pc.red('An error occurred during initialization'))
+      clack.log.error(styleText('red', 'An error occurred during initialization'))
       if (error instanceof Error) {
         clack.log.error(error.message)
       }

package/src/commands/mcp.ts

@@ -1,7 +1,7 @@
+import { styleText } from 'node:util'
 import type { ArgsDef } from 'citty'
 import { defineCommand, showUsage } from 'citty'
 import { createJiti } from 'jiti'
-import pc from 'picocolors'
 
 const jiti = createJiti(import.meta.url, {
   sourceMaps: true,
@@ -40,7 +40,7 @@ const command = defineCommand({
     const { run } = mod
     try {
       console.log('⏳ Starting MCP server...')
-      console.warn(pc.yellow('This feature is still under development — use with caution'))
+      console.warn(styleText('yellow', 'This feature is still under development — use with caution'))
       await run()
     } catch (error) {
       console.error((error as Error)?.message)

package/src/loggers/clackLogger.ts

@@ -1,10 +1,10 @@
 import { relative } from 'node:path'
 import process from 'node:process'
+import { styleText } from 'node:util'
 import * as clack from '@clack/prompts'
 import { defineLogger, LogLevel } from '@kubb/core'
 import { formatHrtime, formatMs } from '@kubb/core/utils'
-import { type ExecaError, execa } from 'execa'
-import pc from 'picocolors'
+import { type NonZeroExitError, x } from 'tinyexec'
 import { formatMsWithColor } from '../utils/formatMsWithColor.ts'
 import { getIntro } from '../utils/getIntro.ts'
 import { getSummary } from '../utils/getSummary.ts'
@@ -60,18 +60,18 @@ export const clackLogger = defineLogger({
       if (state.totalPlugins > 0) {
         const pluginStr =
           state.failedPlugins > 0
-            ? `Plugins ${pc.green(state.completedPlugins.toString())}/${state.totalPlugins} ${pc.red(`(${state.failedPlugins} failed)`)}`
-            : `Plugins ${pc.green(state.completedPlugins.toString())}/${state.totalPlugins}`
+            ? `Plugins ${styleText('green', state.completedPlugins.toString())}/${state.totalPlugins} ${styleText('red', `(${state.failedPlugins} failed)`)}`
+            : `Plugins ${styleText('green', state.completedPlugins.toString())}/${state.totalPlugins}`
         parts.push(pluginStr)
       }
 
       if (state.totalFiles > 0) {
-        parts.push(`Files ${pc.green(state.processedFiles.toString())}/${state.totalFiles}`)
+        parts.push(`Files ${styleText('green', state.processedFiles.toString())}/${state.totalFiles}`)
       }
 
       if (parts.length > 0) {
-        parts.push(`${pc.green(duration)} elapsed`)
-        clack.log.step(getMessage(parts.join(pc.dim(' | '))))
+        parts.push(`${styleText('green', duration)} elapsed`)
+        clack.log.step(getMessage(parts.join(styleText('dim', ' | '))))
       }
     }
 
@@ -84,7 +84,7 @@ export const clackLogger = defineLogger({
           second: '2-digit',
         })
 
-        return [pc.dim(`[${timestamp}]`), message].join(' ')
+        return [styleText('dim', `[${timestamp}]`), message].join(' ')
       }
 
       return message
@@ -105,7 +105,7 @@ export const clackLogger = defineLogger({
         return
       }
 
-      const text = getMessage([pc.blue('ℹ'), message, pc.dim(info)].join(' '))
+      const text = getMessage([styleText('blue', 'ℹ'), message, styleText('dim', info)].join(' '))
 
       if (state.isSpinning) {
         state.spinner.message(text)
@@ -119,7 +119,7 @@ export const clackLogger = defineLogger({
         return
       }
 
-      const text = getMessage([pc.blue('✓'), message, logLevel >= LogLevel.info ? pc.dim(info) : undefined].filter(Boolean).join(' '))
+      const text = getMessage([styleText('blue', '✓'), message, logLevel >= LogLevel.info ? styleText('dim', info) : undefined].filter(Boolean).join(' '))
 
       if (state.isSpinning) {
         stopSpinner(text)
@@ -133,7 +133,9 @@ export const clackLogger = defineLogger({
         return
       }
 
-      const text = getMessage([pc.yellow('⚠'), message, logLevel >= LogLevel.info ? pc.dim(info) : undefined].filter(Boolean).join(' '))
+      const text = getMessage(
+        [styleText('yellow', '⚠'), message, logLevel >= LogLevel.info && info ? styleText('dim', info) : undefined].filter(Boolean).join(' '),
+      )
 
       clack.log.warn(text)
     })
@@ -141,7 +143,7 @@ export const clackLogger = defineLogger({
     context.on('error', (error) => {
       const caused = error.cause as Error | undefined
 
-      const text = [pc.red('✗'), error.message].join(' ')
+      const text = [styleText('red', '✗'), error.message].join(' ')
 
       if (state.isSpinning) {
         stopSpinner(getMessage(text))
@@ -153,15 +155,15 @@ export const clackLogger = defineLogger({
       if (logLevel >= LogLevel.debug && error.stack) {
         const frames = error.stack.split('\n').slice(1, 4)
         for (const frame of frames) {
-          clack.log.message(getMessage(pc.dim(frame.trim())))
+          clack.log.message(getMessage(styleText('dim', frame.trim())))
         }
 
         if (caused?.stack) {
-          clack.log.message(pc.dim(`└─ caused by ${caused.message}`))
+          clack.log.message(styleText('dim', `└─ caused by ${caused.message}`))
 
           const frames = caused.stack.split('\n').slice(1, 4)
           for (const frame of frames) {
-            clack.log.message(getMessage(`    ${pc.dim(frame.trim())}`))
+            clack.log.message(getMessage(`    ${styleText('dim', frame.trim())}`))
           }
         }
       }
@@ -178,7 +180,7 @@ Run \`npm install -g @kubb/cli\` to update`,
         'Update available for `Kubb`',
         {
           width: 'auto',
-          formatBorder: pc.yellow,
+          formatBorder: (s: string) => styleText('yellow', s),
           rounded: true,
           withGuide: false,
           contentAlign: 'center',
@@ -218,7 +220,7 @@ Run \`npm install -g @kubb/cli\` to update`,
       // Initialize progress tracking
       state.totalPlugins = config.plugins?.length || 0
 
-      const text = getMessage(['Generation started', config.name ? `for ${pc.dim(config.name)}` : undefined].filter(Boolean).join(' '))
+      const text = getMessage(['Generation started', config.name ? `for ${styleText('dim', config.name)}` : undefined].filter(Boolean).join(' '))
 
       clack.intro(text)
       reset()
@@ -236,7 +238,7 @@ Run \`npm install -g @kubb/cli\` to update`,
         max: 100,
         size: 30,
       })
-      const text = getMessage(`Generating ${pc.bold(plugin.name)}`)
+      const text = getMessage(`Generating ${styleText('bold', plugin.name)}`)
       progressBar.start(text)
 
       const interval = setInterval(() => {
@@ -265,7 +267,9 @@ Run \`npm install -g @kubb/cli\` to update`,
 
       const durationStr = formatMsWithColor(duration)
       const text = getMessage(
-        success ? `${pc.bold(plugin.name)} completed in ${durationStr}` : `${pc.bold(plugin.name)} failed in ${pc.red(formatMs(duration))}`,
+        success
+          ? `${styleText('bold', plugin.name)} completed in ${durationStr}`
+          : `${styleText('bold', plugin.name)} failed in ${styleText('red', formatMs(duration))}`,
       )
 
       active.progressBar.stop(text)
@@ -337,7 +341,7 @@ Run \`npm install -g @kubb/cli\` to update`,
     })
 
     context.on('generation:end', (config) => {
-      const text = getMessage(config.name ? `Generation completed for ${pc.dim(config.name)}` : 'Generation completed')
+      const text = getMessage(config.name ? `Generation completed for ${styleText('dim', config.name)}` : 'Generation completed')
 
       clack.outro(text)
     })
@@ -384,7 +388,7 @@ Run \`npm install -g @kubb/cli\` to update`,
 
     context.on('hook:start', async ({ id, command, args }) => {
       const commandWithArgs = args?.length ? `${command} ${args.join(' ')}` : command
-      const text = getMessage(`Hook ${pc.dim(commandWithArgs)} started`)
+      const text = getMessage(`Hook ${styleText('dim', commandWithArgs)} started`)
 
       // Skip hook execution if no id is provided (e.g., during benchmarks or tests)
       if (!id) {
@@ -393,14 +397,14 @@ Run \`npm install -g @kubb/cli\` to update`,
 
       if (logLevel <= LogLevel.silent) {
         try {
-          const result = await execa(command, args, {
-            detached: true,
-            stripFinalNewline: true,
+          const result = await x(command, [...(args ?? [])], {
+            nodeOptions: { detached: true },
+            throwOnError: true,
           })
 
           await context.emit('debug', {
             date: new Date(),
-            logs: [result.stdout],
+            logs: [result.stdout.trimEnd()],
           })
 
           await context.emit('hook:end', {
@@ -411,9 +415,9 @@ Run \`npm install -g @kubb/cli\` to update`,
             error: null,
           })
         } catch (err) {
-          const error = err as ExecaError
-          const stderr = typeof error.stderr === 'string' ? error.stderr : String(error.stderr)
-          const stdout = typeof error.stdout === 'string' ? error.stdout : String(error.stdout)
+          const error = err as NonZeroExitError
+          const stderr = error.output?.stderr ?? ''
+          const stdout = error.output?.stdout ?? ''
 
           await context.emit('debug', {
             date: new Date(),
@@ -445,28 +449,33 @@ Run \`npm install -g @kubb/cli\` to update`,
       clack.intro(text)
 
       const logger = clack.taskLog({
-        title: getMessage(['Executing hook', logLevel >= LogLevel.info ? pc.dim(commandWithArgs) : undefined].filter(Boolean).join(' ')),
+        title: getMessage(['Executing hook', logLevel >= LogLevel.info ? styleText('dim', commandWithArgs) : undefined].filter(Boolean).join(' ')),
       })
 
       const writable = new ClackWritable(logger)
 
       try {
-        const result = await execa(command, args, {
-          detached: true,
-          stdout: ['pipe', writable],
-          stripFinalNewline: true,
+        const proc = x(command, [...(args ?? [])], {
+          nodeOptions: { detached: true },
+          throwOnError: true,
         })
 
+        for await (const line of proc) {
+          writable.write(line)
+        }
+
+        const result = await proc
+
         await context.emit('debug', {
           date: new Date(),
-          logs: [result.stdout],
+          logs: [result.stdout.trimEnd()],
         })
 
         await context.emit('hook:end', { command, args, id, success: true, error: null })
       } catch (err) {
-        const error = err as ExecaError
-        const stderr = typeof error.stderr === 'string' ? error.stderr : String(error.stderr)
-        const stdout = typeof error.stdout === 'string' ? error.stdout : String(error.stdout)
+        const error = err as NonZeroExitError
+        const stderr = error.output?.stderr ?? ''
+        const stdout = error.output?.stdout ?? ''
 
         await context.emit('debug', {
           date: new Date(),
@@ -493,7 +502,7 @@ Run \`npm install -g @kubb/cli\` to update`,
       }
 
       const commandWithArgs = args?.length ? `${command} ${args.join(' ')}` : command
-      const text = getMessage(`Hook ${pc.dim(commandWithArgs)} successfully executed`)
+      const text = getMessage(`Hook ${styleText('dim', commandWithArgs)} successfully executed`)
 
       clack.outro(text)
     })
@@ -515,7 +524,7 @@ Run \`npm install -g @kubb/cli\` to update`,
       if (status === 'success') {
         clack.box(summary.join('\n'), getMessage(title), {
           width: 'auto',
-          formatBorder: pc.green,
+          formatBorder: (s: string) => styleText('green', s),
           rounded: true,
           withGuide: false,
           contentAlign: 'left',
@@ -527,7 +536,7 @@ Run \`npm install -g @kubb/cli\` to update`,
 
       clack.box(summary.join('\n'), getMessage(title), {
         width: 'auto',
-        formatBorder: pc.red,
+        formatBorder: (s: string) => styleText('red', s),
         rounded: true,
         withGuide: false,
         contentAlign: 'left',