@kubb/cli 4.22.0 → 4.22.2

package/dist/{validate-0Qu8SxVA.js.map → validate-YI4YkVTl.js.map}

@@ -1 +1 @@
-{"version":3,"file":"validate-0Qu8SxVA.js","names":[],"sources":["../src/commands/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport type { ArgsDef } from 'citty'\nimport { defineCommand, showUsage } from 'citty'\nimport { createJiti } from 'jiti'\n\nconst jiti = createJiti(import.meta.url, {\n  sourceMaps: true,\n})\n\nconst args = {\n  input: {\n    type: 'string',\n    description: 'Path to Swagger/OpenAPI file',\n    alias: 'i',\n  },\n  help: {\n    type: 'boolean',\n    description: 'Show help',\n    alias: 'h',\n    default: false,\n  },\n} as const satisfies ArgsDef\n\nconst command = defineCommand({\n  meta: {\n    name: 'validate',\n    description: 'Validate a Swagger/OpenAPI file',\n  },\n  args,\n  async run(commandContext) {\n    const { args } = commandContext\n\n    if (args.help) {\n      return showUsage(command)\n    }\n\n    if (args.input) {\n      let mod: any\n      try {\n        mod = await jiti.import('@kubb/oas', { default: true })\n      } catch (_e) {\n        console.error(`Import of '@kubb/oas' is required to do validation`)\n        process.exit(1)\n      }\n\n      const { parse } = mod\n      try {\n        const oas = await parse(args.input)\n        await oas.validate()\n\n        console.log('✅ Validation success')\n      } catch (error) {\n        console.error('❌ Validation failed')\n        console.log((error as Error)?.message)\n        process.exit(1)\n      }\n    }\n  },\n})\n\nexport default command\n"],"mappings":";;;;;;AAKA,MAAM,OAAO,WAAW,OAAO,KAAK,KAAK,EACvC,YAAY,MACb,CAAC;AAgBF,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,MAAM;EACN,aAAa;EACd;CACD,MAnBW;EACX,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACR;EACD,MAAM;GACJ,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACF;CAQC,MAAM,IAAI,gBAAgB;EACxB,MAAM,EAAE,SAAS;AAEjB,MAAI,KAAK,KACP,QAAO,UAAU,QAAQ;AAG3B,MAAI,KAAK,OAAO;GACd,IAAI;AACJ,OAAI;AACF,UAAM,MAAM,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;YAChD,IAAI;AACX,YAAQ,MAAM,qDAAqD;AACnE,YAAQ,KAAK,EAAE;;GAGjB,MAAM,EAAE,UAAU;AAClB,OAAI;AAEF,WADY,MAAM,MAAM,KAAK,MAAM,EACzB,UAAU;AAEpB,YAAQ,IAAI,uBAAuB;YAC5B,OAAO;AACd,YAAQ,MAAM,sBAAsB;AACpC,YAAQ,IAAK,OAAiB,QAAQ;AACtC,YAAQ,KAAK,EAAE;;;;CAItB,CAAC;AAEF,uBAAe"}
+{"version":3,"file":"validate-YI4YkVTl.js","names":[],"sources":["../src/commands/validate.ts"],"sourcesContent":["import process from 'node:process'\nimport type { ArgsDef } from 'citty'\nimport { defineCommand, showUsage } from 'citty'\nimport { createJiti } from 'jiti'\n\nconst jiti = createJiti(import.meta.url, {\n  sourceMaps: true,\n})\n\nconst args = {\n  input: {\n    type: 'string',\n    description: 'Path to Swagger/OpenAPI file',\n    alias: 'i',\n  },\n  help: {\n    type: 'boolean',\n    description: 'Show help',\n    alias: 'h',\n    default: false,\n  },\n} as const satisfies ArgsDef\n\nconst command = defineCommand({\n  meta: {\n    name: 'validate',\n    description: 'Validate a Swagger/OpenAPI file',\n  },\n  args,\n  async run(commandContext) {\n    const { args } = commandContext\n\n    if (args.help) {\n      return showUsage(command)\n    }\n\n    if (args.input) {\n      let mod: any\n      try {\n        mod = await jiti.import('@kubb/oas', { default: true })\n      } catch (_e) {\n        console.error(`Import of '@kubb/oas' is required to do validation`)\n        process.exit(1)\n      }\n\n      const { parse } = mod\n      try {\n        const oas = await parse(args.input)\n        await oas.validate()\n\n        console.log('✅ Validation success')\n      } catch (error) {\n        console.error('❌ Validation failed')\n        console.log((error as Error)?.message)\n        process.exit(1)\n      }\n    }\n  },\n})\n\nexport default command\n"],"mappings":";;;;;;AAKA,MAAM,OAAO,WAAW,OAAO,KAAK,KAAK,EACvC,YAAY,MACb,CAAC;AAgBF,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,MAAM;EACN,aAAa;EACd;CACD,MAnBW;EACX,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACR;EACD,MAAM;GACJ,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACF;CAQC,MAAM,IAAI,gBAAgB;EACxB,MAAM,EAAE,SAAS;AAEjB,MAAI,KAAK,KACP,QAAO,UAAU,QAAQ;AAG3B,MAAI,KAAK,OAAO;GACd,IAAI;AACJ,OAAI;AACF,UAAM,MAAM,KAAK,OAAO,aAAa,EAAE,SAAS,MAAM,CAAC;YAChD,IAAI;AACX,YAAQ,MAAM,qDAAqD;AACnE,YAAQ,KAAK,EAAE;;GAGjB,MAAM,EAAE,UAAU;AAClB,OAAI;AAEF,WADY,MAAM,MAAM,KAAK,MAAM,EACzB,UAAU;AAEpB,YAAQ,IAAI,uBAAuB;YAC5B,OAAO;AACd,YAAQ,MAAM,sBAAsB;AACpC,YAAQ,IAAK,OAAiB,QAAQ;AACtC,YAAQ,KAAK,EAAE;;;;CAItB,CAAC;AAEF,uBAAe"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/cli",
-  "version": "4.22.0",
+  "version": "4.22.2",
   "description": "Command-line interface for Kubb, enabling easy generation of TypeScript, React-Query, Zod, and other code from OpenAPI specifications.",
   "keywords": [
     "cli",
@@ -66,14 +66,14 @@
     "seedrandom": "^3.0.5",
     "semver": "^7.7.4",
     "string-argv": "^0.3.2",
-    "@kubb/core": "4.22.0"
+    "@kubb/core": "4.22.2"
   },
   "devDependencies": {
     "@types/seedrandom": "^3.0.8",
     "@types/semver": "^7.7.1",
     "source-map-support": "^0.5.21",
-    "@kubb/mcp": "4.22.0",
-    "@kubb/oas": "4.22.0"
+    "@kubb/mcp": "4.22.2",
+    "@kubb/oas": "4.22.2"
   },
   "engines": {
     "node": ">=20"

package/src/commands/generate.ts

@@ -13,7 +13,6 @@ import { setupLogger } from '../loggers/utils.ts'
 import { generate } from '../runners/generate.ts'
 import { getConfigs } from '../utils/getConfigs.ts'
 import { getCosmiConfig } from '../utils/getCosmiConfig.ts'
-import { startStreamServer } from '../utils/streamServer.ts'
 import { startWatcher } from '../utils/watcher.ts'
 
 const args = {
@@ -53,21 +52,6 @@ const args = {
     alias: 's',
     default: false,
   },
-  stream: {
-    type: 'boolean',
-    description: 'Start HTTP server with SSE streaming',
-    default: false,
-  },
-  port: {
-    type: 'string',
-    description: 'Port for stream server (requires --stream). If not specified, an available port is automatically selected.',
-    alias: 'p',
-  },
-  host: {
-    type: 'string',
-    description: 'Host for stream server (requires --stream)',
-    default: 'localhost',
-  },
   help: {
     type: 'boolean',
     description: 'Show help',
@@ -122,28 +106,6 @@ const command = defineCommand({
       const result = await getCosmiConfig('kubb', args.config)
       const configs = await getConfigs(result, args)
 
-      // Start stream server if --stream flag is provided
-      if (args.stream) {
-        if (configs.length > 1) {
-          clack.log.warn(pc.yellow('Stream mode only supports a single configuration. Only the first config will be used.'))
-        }
-
-        const port = args.port ? Number.parseInt(args.port, 10) : 0
-        const host = args.host
-
-        await startStreamServer({
-          port,
-          host,
-          configPath: result.filepath,
-          config: configs[0]!,
-          input,
-          args,
-        })
-
-        // Server is running, don't exit
-        return
-      }
-
       await events.emit('config:start')
 
       await events.emit('info', 'Config loaded', path.relative(process.cwd(), result.filepath))

package/src/commands/init.ts

@@ -307,7 +307,9 @@ const command = defineCommand({
           '\n' +
           pc.cyan(`  1. Make sure your OpenAPI spec is at: ${inputPath}`) +
           '\n' +
-          pc.cyan('  2. Run: npx kubb generate') +
+          pc.cyan('  2. Generate code with: npx kubb generate') +
+          '\n' +
+          pc.cyan('     Or start a stream server with: npx kubb start') +
           '\n' +
           pc.cyan(`  3. Find generated files in: ${outputPath}`) +
           '\n\n' +

package/src/commands/start.ts

@@ -0,0 +1,149 @@
+import * as process from 'node:process'
+import * as clack from '@clack/prompts'
+import { LogLevel, type ServerEvents, startServer } from '@kubb/core'
+import { AsyncEventEmitter } from '@kubb/core/utils'
+import type { ArgsDef } from 'citty'
+import { defineCommand, showUsage } from 'citty'
+import pc from 'picocolors'
+import { version } from '../../package.json'
+import { generate } from '../runners/generate.ts'
+import { getConfigs } from '../utils/getConfigs.ts'
+import { getCosmiConfig } from '../utils/getCosmiConfig.ts'
+import type { Args as GenerateArgs } from './generate.ts'
+
+const args = {
+  config: {
+    type: 'string',
+    description: 'Path to the Kubb config',
+    alias: 'c',
+  },
+  logLevel: {
+    type: 'string',
+    description: 'Info, silent, verbose or debug',
+    alias: 'l',
+    default: 'info',
+    valueHint: 'silent|info|verbose|debug',
+  },
+  debug: {
+    type: 'boolean',
+    description: 'Override logLevel to debug',
+    alias: 'd',
+    default: false,
+  },
+  verbose: {
+    type: 'boolean',
+    description: 'Override logLevel to verbose',
+    alias: 'v',
+    default: false,
+  },
+  silent: {
+    type: 'boolean',
+    description: 'Override logLevel to silent',
+    alias: 's',
+    default: false,
+  },
+  port: {
+    type: 'string',
+    description: 'Port for the server. If not specified, an available port is automatically selected.',
+    alias: 'p',
+  },
+  host: {
+    type: 'string',
+    description: 'Host for the server',
+    default: 'localhost',
+  },
+  help: {
+    type: 'boolean',
+    description: 'Show help',
+    alias: 'h',
+    default: false,
+  },
+} as const satisfies ArgsDef
+
+const command = defineCommand({
+  meta: {
+    name: 'start',
+    description: "[input] Start HTTP server with SSE streaming based on a 'kubb.config.ts' file",
+  },
+  args,
+  async run(commandContext) {
+    const { args } = commandContext
+    const input = args._[0]
+
+    if (args.help) {
+      return showUsage(command)
+    }
+
+    if (args.debug) {
+      args.logLevel = 'debug'
+    }
+
+    if (args.verbose) {
+      args.logLevel = 'verbose'
+    }
+
+    if (args.silent) {
+      args.logLevel = 'silent'
+    }
+
+    try {
+      const result = await getCosmiConfig('kubb', args.config)
+      // Create args compatible with getConfigs/startStreamServer (needs watch property)
+      const generateArgs = { ...args, watch: false } as unknown as GenerateArgs
+      const configs = await getConfigs(result, generateArgs)
+
+      if (configs.length > 1) {
+        clack.log.warn(pc.yellow('Stream mode only supports a single configuration. Only the first config will be used.'))
+      }
+
+      const port = args.port ? Number.parseInt(args.port, 10) : 0
+      const host = args.host
+      const config = configs[0]!
+      const logLevel = LogLevel[args.logLevel as keyof typeof LogLevel] || 3
+
+      const events = new AsyncEventEmitter<ServerEvents>()
+
+      events.on('server:start', (serverUrl: string, configPath: string) => {
+        clack.log.success(pc.green(`Stream server started on ${pc.bold(serverUrl)}`))
+        clack.log.info(pc.dim(`Config: ${configPath}`))
+        clack.log.info(pc.dim(`Connect: ${serverUrl}/api/info`))
+        clack.log.info(pc.dim(`Generate: ${serverUrl}/api/generate`))
+        clack.log.info(pc.dim(`Health: ${serverUrl}/api/health`))
+        clack.log.step(pc.yellow('Waiting for requests... (Press Ctrl+C to stop)'))
+      })
+
+      events.on('server:shutdown', () => {
+        clack.log.info('Shutting down stream server...')
+      })
+
+      events.on('server:stopped', () => {
+        clack.log.success('Server stopped')
+      })
+
+      await startServer({
+        port,
+        host,
+        configPath: result.filepath,
+        config,
+        version,
+        events,
+        onGenerate: async () => {
+          await generate({
+            input,
+            config,
+            logLevel,
+            events,
+          })
+        },
+      })
+
+      // Server is running, don't exit
+    } catch (error) {
+      clack.log.error(pc.red('Failed to start stream server'))
+      console.error(error)
+      process.exit(1)
+    }
+  },
+})
+
+export default command

package/src/index.ts

@@ -20,7 +20,7 @@ const main = defineCommand({
       process.exit(0)
     }
 
-    if (!['generate', 'validate', 'mcp', 'init'].includes(rawArgs[0] as string)) {
+    if (!['generate', 'validate', 'mcp', 'init', 'start'].includes(rawArgs[0] as string)) {
       // generate is not being used
       const generateCommand = await import('./commands/generate.ts').then((r) => r.default)
 
@@ -34,6 +34,7 @@ const main = defineCommand({
     validate: () => import('./commands/validate.ts').then((r) => r.default),
     mcp: () => import('./commands/mcp.ts').then((r) => r.default),
     init: () => import('./commands/init.ts').then((r) => r.default),
+    start: () => import('./commands/start.ts').then((r) => r.default),
   },
 })
 

package/src/loggers/clackLogger.ts

@@ -3,7 +3,7 @@ import process from 'node:process'
 import * as clack from '@clack/prompts'
 import { defineLogger, LogLevel } from '@kubb/core'
 import { formatHrtime, formatMs } from '@kubb/core/utils'
-import { execa } from 'execa'
+import { type ExecaError, execa } from 'execa'
 import pc from 'picocolors'
 import { formatMsWithColor } from '../utils/formatMsWithColor.ts'
 import { getIntro } from '../utils/getIntro.ts'
@@ -139,7 +139,7 @@ export const clackLogger = defineLogger({
     })
 
     context.on('error', (error) => {
-      const caused = error.cause as Error
+      const caused = error.cause as Error | undefined
 
       const text = [pc.red('✗'), error.message].join(' ')
 
@@ -411,22 +411,32 @@ Run \`npm install -g @kubb/cli\` to update`,
             error: null,
           })
         } catch (err) {
-          const error = new Error('Hook execute failed')
-          error.cause = 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)
 
           await context.emit('debug', {
             date: new Date(),
-            logs: [(err as any).stdout],
+            logs: [stdout, stderr].filter(Boolean),
           })
 
+          if (stderr) {
+            console.error(stderr)
+          }
+          if (stdout) {
+            console.log(stdout)
+          }
+
+          const errorMessage = new Error(`Hook execute failed: ${commandWithArgs}`)
+
           await context.emit('hook:end', {
             command,
             args,
             id,
             success: false,
-            error,
+            error: errorMessage,
           })
-          await context.emit('error', error)
+          await context.emit('error', errorMessage)
         }
 
         return
@@ -454,16 +464,26 @@ Run \`npm install -g @kubb/cli\` to update`,
 
         await context.emit('hook:end', { command, args, id, success: true, error: null })
       } catch (err) {
-        const error = new Error('Hook execute failed')
-        error.cause = 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)
 
         await context.emit('debug', {
           date: new Date(),
-          logs: [(err as any).stdout],
+          logs: [stdout, stderr].filter(Boolean),
         })
 
-        await context.emit('hook:end', { command, args, id, success: true, error })
-        await context.emit('error', error)
+        if (stderr) {
+          logger.error(stderr)
+        }
+        if (stdout) {
+          logger.message(stdout)
+        }
+
+        const errorMessage = new Error(`Hook execute failed: ${commandWithArgs}`)
+
+        await context.emit('hook:end', { command, args, id, success: false, error: errorMessage })
+        await context.emit('error', errorMessage)
       }
     })
 

package/src/loggers/githubActionsLogger.ts

@@ -1,6 +1,6 @@
 import { type Config, defineLogger, LogLevel } from '@kubb/core'
 import { formatHrtime, formatMs } from '@kubb/core/utils'
-import { execa } from 'execa'
+import { type ExecaError, execa } from 'execa'
 import pc from 'picocolors'
 import { formatMsWithColor } from '../utils/formatMsWithColor.ts'
 
@@ -111,7 +111,7 @@ export const githubActionsLogger = defineLogger({
     })
 
     context.on('error', (error) => {
-      const caused = error.cause as Error
+      const caused = error.cause as Error | undefined
 
       if (logLevel <= LogLevel.silent) {
         return
@@ -363,7 +363,9 @@ export const githubActionsLogger = defineLogger({
           logs: [result.stdout],
         })
 
-        console.log(result.stdout)
+        if (logLevel > LogLevel.silent) {
+          console.log(result.stdout)
+        }
 
         await context.emit('hook:end', {
           command,
@@ -373,22 +375,33 @@ export const githubActionsLogger = defineLogger({
           error: null,
         })
       } catch (err) {
-        const error = new Error('Hook execute failed')
-        error.cause = 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)
 
         await context.emit('debug', {
           date: new Date(),
-          logs: [(err as any).stdout],
+          logs: [stdout, stderr].filter(Boolean),
         })
 
+        // Display stderr/stdout in GitHub Actions format
+        if (stderr) {
+          console.error(`::error::${stderr}`)
+        }
+        if (stdout) {
+          console.log(stdout)
+        }
+
+        const errorMessage = new Error(`Hook execute failed: ${commandWithArgs}`)
+
         await context.emit('hook:end', {
           command,
           args,
           id,
           success: false,
-          error,
+          error: errorMessage,
         })
-        await context.emit('error', error)
+        await context.emit('error', errorMessage)
       }
     })
 

package/src/loggers/plainLogger.ts

@@ -1,7 +1,7 @@
 import { relative } from 'node:path'
 import { defineLogger, LogLevel } from '@kubb/core'
 import { formatMs } from '@kubb/core/utils'
-import { execa } from 'execa'
+import { type ExecaError, execa } from 'execa'
 import { getSummary } from '../utils/getSummary.ts'
 
 /**
@@ -59,7 +59,7 @@ export const plainLogger = defineLogger({
     })
 
     context.on('error', (error) => {
-      const caused = error.cause as Error
+      const caused = error.cause as Error | undefined
 
       const text = getMessage(['✗', error.message].join(' '))
 
@@ -233,7 +233,9 @@ export const plainLogger = defineLogger({
           logs: [result.stdout],
         })
 
-        console.log(result.stdout)
+        if (logLevel > LogLevel.silent) {
+          console.log(result.stdout)
+        }
 
         await context.emit('hook:end', {
           command,
@@ -243,22 +245,32 @@ export const plainLogger = defineLogger({
           error: null,
         })
       } catch (err) {
-        const error = new Error('Hook execute failed')
-        error.cause = 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)
 
         await context.emit('debug', {
           date: new Date(),
-          logs: [(err as any).stdout],
+          logs: [stdout, stderr].filter(Boolean),
         })
 
+        if (stderr) {
+          console.error(stderr)
+        }
+        if (stdout) {
+          console.log(stdout)
+        }
+
+        const errorMessage = new Error(`Hook execute failed: ${commandWithArgs}`)
+
         await context.emit('hook:end', {
           command,
           args,
           id,
           success: false,
-          error,
+          error: errorMessage,
         })
-        await context.emit('error', error)
+        await context.emit('error', errorMessage)
       }
     })