@kubb/cli 5.0.0-alpha.52 → 5.0.0-alpha.53

package/src/loggers/clackLogger.ts

@@ -73,7 +73,7 @@ export const clackLogger = defineLogger({
       state.isSpinning = false
     }
 
-    context.on('kubb:info', (message, info = '') => {
+    context.on('kubb:info', ({ message, info = '' }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -87,7 +87,7 @@ export const clackLogger = defineLogger({
       }
     })
 
-    context.on('kubb:success', (message, info = '') => {
+    context.on('kubb:success', ({ message, info = '' }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -101,7 +101,7 @@ export const clackLogger = defineLogger({
       }
     })
 
-    context.on('kubb:warn', (message, info) => {
+    context.on('kubb:warn', ({ message, info }) => {
       if (logLevel < logLevelMap.warn) {
         return
       }
@@ -113,7 +113,7 @@ export const clackLogger = defineLogger({
       clack.log.warn(text)
     })
 
-    context.on('kubb:error', (error) => {
+    context.on('kubb:error', ({ error }) => {
       const caused = toCause(error)
 
       const text = [styleText('red', '✗'), error.message].join(' ')
@@ -142,14 +142,14 @@ export const clackLogger = defineLogger({
       }
     })
 
-    context.on('kubb:version:new', (version, latestVersion) => {
+    context.on('kubb:version:new', ({ currentVersion, latestVersion }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
 
       try {
         clack.box(
-          `\`v${version}\` → \`v${latestVersion}\`
+          `\`v${currentVersion}\` → \`v${latestVersion}\`
 Run \`npm install -g @kubb/cli\` to update`,
           'Update available for `Kubb`',
           {
@@ -162,12 +162,12 @@ Run \`npm install -g @kubb/cli\` to update`,
           },
         )
       } catch {
-        console.log(`Update available for Kubb: v${version} → v${latestVersion}`)
+        console.log(`Update available for Kubb: v${currentVersion} → v${latestVersion}`)
         console.log('Run `npm install -g @kubb/cli` to update')
       }
     })
 
-    context.on('kubb:lifecycle:start', async (version) => {
+    context.on('kubb:lifecycle:start', async ({ version }) => {
       console.log(`\n${getIntro({ title: 'The ultimate toolkit for working with APIs', description: 'Ready to start', version, areEyesOpen: true })}\n`)
 
       reset()
@@ -184,7 +184,7 @@ Run \`npm install -g @kubb/cli\` to update`,
       startSpinner(getMessage('Configuration loading'))
     })
 
-    context.on('kubb:config:end', (_configs) => {
+    context.on('kubb:config:end', () => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -194,7 +194,7 @@ Run \`npm install -g @kubb/cli\` to update`,
       clack.outro(text)
     })
 
-    context.on('kubb:generation:start', (config) => {
+    context.on('kubb:generation:start', ({ config }) => {
       reset()
 
       // Initialize progress tracking for this generation
@@ -205,7 +205,7 @@ Run \`npm install -g @kubb/cli\` to update`,
       clack.intro(text)
     })
 
-    context.on('kubb:plugin:start', (plugin) => {
+    context.on('kubb:plugin:start', ({ plugin }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -227,7 +227,7 @@ Run \`npm install -g @kubb/cli\` to update`,
       state.activeProgress.set(plugin.name, { progressBar, interval })
     })
 
-    context.on('kubb:plugin:end', (plugin, { duration, success }) => {
+    context.on('kubb:plugin:end', ({ plugin, duration, success }) => {
       stopSpinner()
 
       const active = state.activeProgress.get(plugin.name)
@@ -258,7 +258,7 @@ Run \`npm install -g @kubb/cli\` to update`,
       showProgressStep()
     })
 
-    context.on('kubb:files:processing:start', (files) => {
+    context.on('kubb:files:processing:start', ({ files }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -275,7 +275,7 @@ Run \`npm install -g @kubb/cli\` to update`,
         size: 30,
       })
 
-      context.emit('kubb:info', text)
+      context.emit('kubb:info', { message: text })
       progressBar.start(getMessage(text))
       state.activeProgress.set('files', { progressBar })
     })
@@ -319,7 +319,7 @@ Run \`npm install -g @kubb/cli\` to update`,
       showProgressStep()
     })
 
-    context.on('kubb:generation:end', (config) => {
+    context.on('kubb:generation:end', ({ config }) => {
       const text = getMessage(config.name ? `Generation completed for ${styleText('dim', config.name)}` : 'Generation completed')
 
       clack.outro(text)
@@ -423,7 +423,7 @@ Run \`npm install -g @kubb/cli\` to update`,
       clack.outro(text)
     })
 
-    context.on('kubb:generation:summary', (config, { pluginTimings, failedPlugins, filesCreated, status, hrStart }) => {
+    context.on('kubb:generation:summary', ({ config, pluginTimings, failedPlugins, filesCreated, status, hrStart }) => {
       const summary = getSummary({
         failedPlugins,
         filesCreated,

package/src/loggers/fileSystemLogger.ts

@@ -57,28 +57,28 @@ export const fileSystemLogger = defineLogger({
       return Object.keys(files)
     }
 
-    context.on('kubb:info', (message, info) => {
+    context.on('kubb:info', ({ message, info }) => {
       state.cachedLogs.add({
         date: new Date(),
         logs: [`ℹ ${message} ${info}`],
       })
     })
 
-    context.on('kubb:success', (message, info) => {
+    context.on('kubb:success', ({ message, info }) => {
       state.cachedLogs.add({
         date: new Date(),
         logs: [`✓ ${message} ${info}`],
       })
     })
 
-    context.on('kubb:warn', (message, info) => {
+    context.on('kubb:warn', ({ message, info }) => {
       state.cachedLogs.add({
         date: new Date(),
         logs: [`⚠ ${message} ${info}`],
       })
     })
 
-    context.on('kubb:error', (error) => {
+    context.on('kubb:error', ({ error }) => {
       state.cachedLogs.add({
         date: new Date(),
         logs: [`✗ ${error.message}`, error.stack || 'unknown stack'],
@@ -92,14 +92,14 @@ export const fileSystemLogger = defineLogger({
       })
     })
 
-    context.on('kubb:plugin:start', (plugin) => {
+    context.on('kubb:plugin:start', ({ plugin }) => {
       state.cachedLogs.add({
         date: new Date(),
         logs: [`Generating ${plugin.name}`],
       })
     })
 
-    context.on('kubb:plugin:end', (plugin, { duration, success }) => {
+    context.on('kubb:plugin:end', ({ plugin, duration, success }) => {
       const durationStr = formatMs(duration)
 
       state.cachedLogs.add({
@@ -108,18 +108,18 @@ export const fileSystemLogger = defineLogger({
       })
     })
 
-    context.on('kubb:files:processing:start', (files) => {
+    context.on('kubb:files:processing:start', ({ files }) => {
       state.cachedLogs.add({
         date: new Date(),
         logs: [`Start ${files.length} writing:`, ...files.map((file) => file.path)],
       })
     })
 
-    context.on('kubb:generation:end', async (config) => {
+    context.on('kubb:generation:end', async ({ config }) => {
       const writtenFilePaths = await writeLogs(config.name)
       if (writtenFilePaths.length > 0) {
         const files = writtenFilePaths.map((f) => relative(process.cwd(), f))
-        await context.emit('kubb:info', 'Debug files written to:', files.join(', '))
+        await context.emit('kubb:info', { message: 'Debug files written to:', info: files.join(', ') })
       }
       reset()
     })

package/src/loggers/githubActionsLogger.ts

@@ -55,7 +55,7 @@ export const githubActionsLogger = defineLogger({
       console.log('::endgroup::')
     }
 
-    context.on('kubb:info', (message, info = '') => {
+    context.on('kubb:info', ({ message, info = '' }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -65,7 +65,7 @@ export const githubActionsLogger = defineLogger({
       console.log(text)
     })
 
-    context.on('kubb:success', (message, info = '') => {
+    context.on('kubb:success', ({ message, info = '' }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -75,7 +75,7 @@ export const githubActionsLogger = defineLogger({
       console.log(text)
     })
 
-    context.on('kubb:warn', (message, info = '') => {
+    context.on('kubb:warn', ({ message, info = '' }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -85,7 +85,7 @@ export const githubActionsLogger = defineLogger({
       console.warn(`::warning::${text}`)
     })
 
-    context.on('kubb:error', (error) => {
+    context.on('kubb:error', ({ error }) => {
       const caused = toCause(error)
 
       if (logLevel <= logLevelMap.silent) {
@@ -112,7 +112,7 @@ export const githubActionsLogger = defineLogger({
       }
     })
 
-    context.on('kubb:lifecycle:start', (version) => {
+    context.on('kubb:lifecycle:start', ({ version }) => {
       console.log(styleText('yellow', `Kubb ${version} 🧩`))
       reset()
     })
@@ -129,7 +129,7 @@ export const githubActionsLogger = defineLogger({
       console.log(text)
     })
 
-    context.on('kubb:config:end', (configs) => {
+    context.on('kubb:config:end', ({ configs }) => {
       state.currentConfigs = configs
 
       if (logLevel <= logLevelMap.silent) {
@@ -143,7 +143,7 @@ export const githubActionsLogger = defineLogger({
       closeGroup('Configuration')
     })
 
-    context.on('kubb:generation:start', (config) => {
+    context.on('kubb:generation:start', ({ config }) => {
       reset()
 
       // Initialize progress tracking for this generation
@@ -160,7 +160,7 @@ export const githubActionsLogger = defineLogger({
       }
     })
 
-    context.on('kubb:plugin:start', (plugin) => {
+    context.on('kubb:plugin:start', ({ plugin }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -173,7 +173,7 @@ export const githubActionsLogger = defineLogger({
       console.log(text)
     })
 
-    context.on('kubb:plugin:end', (plugin, { duration, success }) => {
+    context.on('kubb:plugin:end', ({ plugin, duration, success }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -204,7 +204,7 @@ export const githubActionsLogger = defineLogger({
       showProgressStep()
     })
 
-    context.on('kubb:files:processing:start', (files) => {
+    context.on('kubb:files:processing:start', ({ files }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -244,7 +244,7 @@ export const githubActionsLogger = defineLogger({
       state.processedFiles++
     })
 
-    context.on('kubb:generation:end', (config) => {
+    context.on('kubb:generation:end', ({ config }) => {
       const text = getMessage(
         config.name ? `${styleText('blue', '✓')} Generation completed for ${styleText('dim', config.name)}` : `${styleText('blue', '✓')} Generation completed`,
       )
@@ -353,7 +353,7 @@ export const githubActionsLogger = defineLogger({
       }
     })
 
-    context.on('kubb:generation:summary', (config, { status, hrStart, failedPlugins }) => {
+    context.on('kubb:generation:summary', ({ config, status, hrStart, failedPlugins }) => {
       const pluginsCount = config.plugins?.length ?? 0
       const successCount = pluginsCount - failedPlugins.size
       const duration = formatHrtime(hrStart)

package/src/loggers/plainLogger.ts

@@ -19,7 +19,7 @@ export const plainLogger = defineLogger({
       return formatMessage(message, logLevel)
     }
 
-    context.on('kubb:info', (message, info) => {
+    context.on('kubb:info', ({ message, info }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -29,7 +29,7 @@ export const plainLogger = defineLogger({
       console.log(text)
     })
 
-    context.on('kubb:success', (message, info = '') => {
+    context.on('kubb:success', ({ message, info = '' }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -39,7 +39,7 @@ export const plainLogger = defineLogger({
       console.log(text)
     })
 
-    context.on('kubb:warn', (message, info) => {
+    context.on('kubb:warn', ({ message, info }) => {
       if (logLevel < logLevelMap.warn) {
         return
       }
@@ -49,7 +49,7 @@ export const plainLogger = defineLogger({
       console.log(text)
     })
 
-    context.on('kubb:error', (error) => {
+    context.on('kubb:error', ({ error }) => {
       const caused = toCause(error)
 
       const text = getMessage(['✗', error.message].join(' '))
@@ -104,7 +104,7 @@ export const plainLogger = defineLogger({
       console.log(text)
     })
 
-    context.on('kubb:plugin:start', (plugin) => {
+    context.on('kubb:plugin:start', ({ plugin }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -113,7 +113,7 @@ export const plainLogger = defineLogger({
       console.log(text)
     })
 
-    context.on('kubb:plugin:end', (plugin, { duration, success }) => {
+    context.on('kubb:plugin:end', ({ plugin, duration, success }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -124,7 +124,7 @@ export const plainLogger = defineLogger({
       console.log(text)
     })
 
-    context.on('kubb:files:processing:start', (files) => {
+    context.on('kubb:files:processing:start', ({ files }) => {
       if (logLevel <= logLevelMap.silent) {
         return
       }
@@ -154,7 +154,7 @@ export const plainLogger = defineLogger({
       console.log(text)
     })
 
-    context.on('kubb:generation:end', (config) => {
+    context.on('kubb:generation:end', ({ config }) => {
       const text = getMessage(config.name ? `Generation completed for ${config.name}` : 'Generation completed')
 
       console.log(text)
@@ -237,7 +237,7 @@ export const plainLogger = defineLogger({
       console.log(text)
     })
 
-    context.on('kubb:generation:summary', (config, { pluginTimings, status, hrStart, failedPlugins, filesCreated }) => {
+    context.on('kubb:generation:summary', ({ config, pluginTimings, status, hrStart, failedPlugins, filesCreated }) => {
       const summary = getSummary({
         failedPlugins,
         filesCreated,

package/src/runners/generate.ts

@@ -61,10 +61,10 @@ async function runToolPass({
   if (resolvedTool === 'auto') {
     const detected = await detect()
     if (!detected) {
-      await hooks.emit('kubb:warn', noToolMessage)
+      await hooks.emit('kubb:warn', { message: noToolMessage })
     } else {
       resolvedTool = detected
-      await hooks.emit('kubb:info', `Auto-detected ${toolLabel}: ${styleText('dim', resolvedTool)}`)
+      await hooks.emit('kubb:info', { message: `Auto-detected ${toolLabel}: ${styleText('dim', resolvedTool)}` })
     }
   }
 
@@ -79,24 +79,23 @@ async function runToolPass({
       // Wire up the hook:end listener BEFORE emitting hook:start to avoid the race condition
       // where hook:end fires synchronously inside emit('kubb:hook:start') before the listener is registered.
       const hookEndPromise = new Promise<void>((resolve, reject) => {
-        const handler = ({ id, success, error }: { id?: string; command: string; args?: readonly string[]; success: boolean; error: Error | null }) => {
-          if (id !== hookId) return
+        const handler = (ctx: { id?: string; command: string; args?: readonly string[]; success: boolean; error: Error | null }) => {
+          if (ctx.id !== hookId) return
           hooks.off('kubb:hook:end', handler)
-          if (!success) {
-            reject(error ?? new Error(`${toolConfig.errorMessage}`))
+          if (!ctx.success) {
+            reject(ctx.error ?? new Error(`${toolConfig.errorMessage}`))
             return
           }
           hooks
-            .emit(
-              'kubb:success',
-              [
+            .emit('kubb:success', {
+              message: [
                 `${successPrefix} with ${styleText('dim', resolvedTool)}`,
                 logLevel >= logLevelMap.info ? `on ${styleText('dim', outputPath)}` : undefined,
                 'successfully',
               ]
                 .filter(Boolean)
                 .join(' '),
-            )
+            })
             .then(resolve)
             .catch(reject)
         }
@@ -116,7 +115,7 @@ async function runToolPass({
       // runHook already emitted kubb:error for binary-not-found cases; here we surface the
       // real reason (e.g. "Hook execute failed: oxlint --fix …") for non-zero exits.
       const err = toError(caughtError)
-      await hooks.emit('kubb:error', err)
+      await hooks.emit('kubb:error', { error: err })
       toolError = err
     }
   }
@@ -148,15 +147,15 @@ async function generate(options: GenerateProps): Promise<void> {
   const kubb = createKubb(config, { hooks })
   await kubb.setup()
 
-  await hooks.emit('kubb:generation:start', config)
+  await hooks.emit('kubb:generation:start', { config })
 
-  await hooks.emit('kubb:info', config.name ? `Setup generation ${styleText('bold', config.name)}` : 'Setup generation', inputPath)
+  await hooks.emit('kubb:info', { message: config.name ? `Setup generation ${styleText('bold', config.name)}` : 'Setup generation', info: inputPath })
 
-  await hooks.emit('kubb:info', config.name ? `Build generation ${styleText('bold', config.name)}` : 'Build generation', inputPath)
+  await hooks.emit('kubb:info', { message: config.name ? `Build generation ${styleText('bold', config.name)}` : 'Build generation', info: inputPath })
 
   const { files, failedPlugins, pluginTimings, error, driver } = await kubb.safeBuild()
 
-  await hooks.emit('kubb:info', 'Load summary')
+  await hooks.emit('kubb:info', { message: 'Load summary' })
 
   // Handle build failures (either from failed plugins or general errors)
 
@@ -171,12 +170,13 @@ async function generate(options: GenerateProps): Promise<void> {
     ].filter(Boolean)
 
     for (const err of allErrors) {
-      await hooks.emit('kubb:error', err)
+      await hooks.emit('kubb:error', { error: err })
     }
 
-    await hooks.emit('kubb:generation:end', config, files, kubb.sources)
+    await hooks.emit('kubb:generation:end', { config, files, sources: kubb.sources })
 
-    await hooks.emit('kubb:generation:summary', config, {
+    await hooks.emit('kubb:generation:summary', {
+      config,
       failedPlugins,
       filesCreated: files.length,
       status: 'failed',
@@ -201,8 +201,8 @@ async function generate(options: GenerateProps): Promise<void> {
     process.exit(1)
   }
 
-  await hooks.emit('kubb:success', 'Generation successfully', inputPath)
-  await hooks.emit('kubb:generation:end', config, files, kubb.sources)
+  await hooks.emit('kubb:success', { message: 'Generation successfully', info: inputPath })
+  await hooks.emit('kubb:generation:end', { config, files, sources: kubb.sources })
 
   const outputPath = path.resolve(config.root, config.output.path)
 
@@ -248,7 +248,8 @@ async function generate(options: GenerateProps): Promise<void> {
   }
 
   // Only reached when there are no failures (process.exit(1) is called above otherwise)
-  await hooks.emit('kubb:generation:summary', config, {
+  await hooks.emit('kubb:generation:summary', {
+    config,
     failedPlugins,
     filesCreated: files.length,
     status: 'success',
@@ -291,7 +292,7 @@ export async function runGenerateCommand({ input, configPath, logLevel: logLevel
       const latestVersion = data.version
 
       if (latestVersion && version < latestVersion) {
-        await hooks.emit('kubb:version:new', version, latestVersion)
+        await hooks.emit('kubb:version:new', { currentVersion: version, latestVersion })
       }
     } catch {
       // Ignore network errors for version check
@@ -303,11 +304,11 @@ export async function runGenerateCommand({ input, configPath, logLevel: logLevel
     const configs = await getConfigs(result.config, { input } as CLIOptions)
 
     await hooks.emit('kubb:config:start')
-    await hooks.emit('kubb:info', 'Config loaded', path.relative(process.cwd(), result.filepath))
-    await hooks.emit('kubb:success', 'Config loaded successfully', path.relative(process.cwd(), result.filepath))
-    await hooks.emit('kubb:config:end', configs)
+    await hooks.emit('kubb:info', { message: 'Config loaded', info: path.relative(process.cwd(), result.filepath) })
+    await hooks.emit('kubb:success', { message: 'Config loaded successfully', info: path.relative(process.cwd(), result.filepath) })
+    await hooks.emit('kubb:config:end', { configs })
 
-    await hooks.emit('kubb:lifecycle:start', version)
+    await hooks.emit('kubb:lifecycle:start', { version })
 
     for (const config of configs) {
       if (isInputPath(config) && watch) {
@@ -326,7 +327,7 @@ export async function runGenerateCommand({ input, configPath, logLevel: logLevel
 
     await hooks.emit('kubb:lifecycle:end')
   } catch (error) {
-    await hooks.emit('kubb:error', toError(error))
+    await hooks.emit('kubb:error', { error: toError(error) })
     process.exit(1)
   }
 }

package/src/utils/executeHooks.ts

@@ -2,7 +2,7 @@ import { createHash } from 'node:crypto'
 import { styleText } from 'node:util'
 import type { AsyncEventEmitter } from '@internals/utils'
 import { tokenize } from '@internals/utils'
-import type { Config, KubbHooks } from '@kubb/core'
+import type { Config, KubbHookEndContext, KubbHooks } from '@kubb/core'
 
 type ExecutingHooksProps = {
   configHooks: NonNullable<Config['hooks']>
@@ -24,15 +24,15 @@ export async function executeHooks({ configHooks, hooks }: ExecutingHooksProps):
     // Wire up the hook:end listener BEFORE emitting hook:start to avoid the race condition
     // where hook:end fires synchronously inside emit('kubb:hook:start') before the listener is registered.
     const hookEndPromise = new Promise<void>((resolve, reject) => {
-      const handler = ({ id, success, error }: { id?: string; command: string; args?: readonly string[]; success: boolean; error: Error | null }) => {
-        if (id !== hookId) return
+      const handler = (ctx: KubbHookEndContext) => {
+        if (ctx.id !== hookId) return
         hooks.off('kubb:hook:end', handler)
-        if (!success) {
-          reject(error ?? new Error(`Hook failed: ${command}`))
+        if (!ctx.success) {
+          reject(ctx.error ?? new Error(`Hook failed: ${command}`))
           return
         }
         hooks
-          .emit('kubb:success', `${styleText('dim', command)} successfully executed`)
+          .emit('kubb:success', { message: `${styleText('dim', command)} successfully executed` })
           .then(resolve)
           .catch(reject)
       }

package/src/utils/runHook.ts

@@ -64,7 +64,7 @@ export async function runHook({ id, command, args, commandWithArgs, context, str
         success: false,
         error: toError(err),
       })
-      await context.emit('kubb:error', toError(err))
+      await context.emit('kubb:error', { error: toError(err) })
       return
     }
 
@@ -88,6 +88,6 @@ export async function runHook({ id, command, args, commandWithArgs, context, str
       success: false,
       error: errorMessage,
     })
-    await context.emit('kubb:error', errorMessage)
+    await context.emit('kubb:error', { error: errorMessage })
   }
 }