@kubb/cli 5.0.0-beta.9 → 5.0.0-beta.93

package/src/loggers/clackLogger.ts

@@ -1,460 +0,0 @@
-import { relative } from 'node:path'
-import process from 'node:process'
-import { styleText } from 'node:util'
-import * as clack from '@clack/prompts'
-import { formatMs, formatMsWithColor, getIntro, toCause } from '@internals/utils'
-import { defineLogger, logLevel as logLevelMap } from '@kubb/core'
-import { getSummary } from './utils.ts'
-import { buildProgressLine, formatCommandWithArgs, formatMessage } from './utils.ts'
-import { Writable } from 'node:stream'
-import type { WritableOptions } from 'node:stream'
-
-/**
- * Node.js `Writable` stream that forwards each chunk to a clack `taskLog` message.
- * Used to pipe hook subprocess output into the clack task log UI.
- */
-class ClackWritable extends Writable {
-  taskLog: ReturnType<typeof clack.taskLog>
-  constructor(taskLog: ReturnType<typeof clack.taskLog>, opts?: WritableOptions) {
-    super(opts)
-
-    this.taskLog = taskLog
-  }
-  _write(chunk: Buffer, _encoding: BufferEncoding, callback: (error?: Error | null) => void): void {
-    this.taskLog.message(`${styleText('dim', chunk.toString())}`)
-    callback()
-  }
-}
-
-/**
- * TTY logger with beautiful UI and progress indicators for local development.
- */
-export const clackLogger = defineLogger({
-  name: 'clack',
-  install(context, options) {
-    const logLevel = options?.logLevel ?? logLevelMap.info
-    const state = {
-      totalPlugins: 0,
-      completedPlugins: 0,
-      failedPlugins: 0,
-      totalFiles: 0,
-      processedFiles: 0,
-      hrStart: process.hrtime(),
-      spinner: clack.spinner(),
-      isSpinning: false,
-      activeProgress: new Map<string, { interval?: NodeJS.Timeout; progressBar: clack.ProgressResult }>(),
-    }
-
-    function reset() {
-      for (const [_key, active] of state.activeProgress) {
-        if (active.interval) {
-          clearInterval(active.interval)
-        }
-        active.progressBar?.stop()
-      }
-
-      state.totalPlugins = 0
-      state.completedPlugins = 0
-      state.failedPlugins = 0
-      state.totalFiles = 0
-      state.processedFiles = 0
-      state.hrStart = process.hrtime()
-      state.spinner = clack.spinner()
-      state.isSpinning = false
-      state.activeProgress.clear()
-    }
-
-    function showProgressStep() {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const line = buildProgressLine(state)
-      if (line) {
-        clack.log.step(getMessage(line))
-      }
-    }
-
-    function getMessage(message: string): string {
-      return formatMessage(message, logLevel)
-    }
-
-    function startSpinner(text?: string) {
-      state.spinner.start(text)
-      state.isSpinning = true
-    }
-
-    function stopSpinner(text?: string) {
-      state.spinner.stop(text)
-      state.isSpinning = false
-    }
-
-    context.on('kubb:info', ({ message, info = '' }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage([styleText('blue', 'ℹ'), message, styleText('dim', info)].join(' '))
-
-      if (state.isSpinning) {
-        state.spinner.message(text)
-      } else {
-        clack.log.info(text)
-      }
-    })
-
-    context.on('kubb:success', ({ message, info = '' }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage([styleText('blue', '✓'), message, logLevel >= logLevelMap.info ? styleText('dim', info) : undefined].filter(Boolean).join(' '))
-
-      if (state.isSpinning) {
-        stopSpinner(text)
-      } else {
-        clack.log.success(text)
-      }
-    })
-
-    context.on('kubb:warn', ({ message, info }) => {
-      if (logLevel < logLevelMap.warn) {
-        return
-      }
-
-      const text = getMessage(
-        [styleText('yellow', '⚠'), message, logLevel >= logLevelMap.info && info ? styleText('dim', info) : undefined].filter(Boolean).join(' '),
-      )
-
-      clack.log.warn(text)
-    })
-
-    context.on('kubb:error', ({ error }) => {
-      const caused = toCause(error)
-
-      const text = [styleText('red', '✗'), error.message].join(' ')
-
-      if (state.isSpinning) {
-        stopSpinner(getMessage(text))
-      } else {
-        clack.log.error(getMessage(text))
-      }
-
-      // Show stack trace in debug mode (first 3 frames)
-      if (logLevel >= logLevelMap.debug && error.stack) {
-        const frames = error.stack.split('\n').slice(1, 4)
-        for (const frame of frames) {
-          clack.log.message(getMessage(styleText('dim', frame.trim())))
-        }
-
-        if (caused?.stack) {
-          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(`    ${styleText('dim', frame.trim())}`))
-          }
-        }
-      }
-    })
-
-    context.on('kubb:version:new', ({ currentVersion, latestVersion }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      try {
-        clack.box(
-          `\`v${currentVersion}\` → \`v${latestVersion}\`
-Run \`npm install -g @kubb/cli\` to update`,
-          'Update available for `Kubb`',
-          {
-            width: 'auto',
-            formatBorder: (s: string) => styleText('yellow', s),
-            rounded: true,
-            withGuide: false,
-            contentAlign: 'center',
-            titleAlign: 'center',
-          },
-        )
-      } catch {
-        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 }) => {
-      console.log(`\n${getIntro({ title: 'The ultimate toolkit for working with APIs', description: 'Ready to start', version, areEyesOpen: true })}\n`)
-
-      reset()
-    })
-
-    context.on('kubb:config:start', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Configuration started')
-
-      clack.intro(text)
-      startSpinner(getMessage('Configuration loading'))
-    })
-
-    context.on('kubb:config:end', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Configuration completed')
-
-      clack.outro(text)
-    })
-
-    context.on('kubb:generation:start', ({ config }) => {
-      reset()
-
-      // Initialize progress tracking for this generation
-      state.totalPlugins = config.plugins?.length ?? 0
-
-      const text = getMessage(['Generation started', config.name ? `for ${styleText('dim', config.name)}` : undefined].filter(Boolean).join(' '))
-
-      clack.intro(text)
-    })
-
-    context.on('kubb:plugin:start', ({ plugin }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      stopSpinner()
-
-      const progressBar = clack.progress({
-        style: 'block',
-        max: 100,
-        size: 30,
-      })
-      const text = getMessage(`Generating ${styleText('bold', plugin.name)}`)
-      progressBar.start(text)
-
-      const interval = setInterval(() => {
-        progressBar.advance()
-      }, 100)
-
-      state.activeProgress.set(plugin.name, { progressBar, interval })
-    })
-
-    context.on('kubb:plugin:end', ({ plugin, duration, success }) => {
-      stopSpinner()
-
-      const active = state.activeProgress.get(plugin.name)
-
-      if (!active || logLevel === logLevelMap.silent) {
-        return
-      }
-
-      clearInterval(active.interval)
-
-      if (success) {
-        state.completedPlugins++
-      } else {
-        state.failedPlugins++
-      }
-
-      const durationStr = formatMsWithColor(duration)
-      const text = getMessage(
-        success
-          ? `${styleText('bold', plugin.name)} completed in ${durationStr}`
-          : `${styleText('bold', plugin.name)} failed in ${styleText('red', formatMs(duration))}`,
-      )
-
-      active.progressBar.stop(text)
-      state.activeProgress.delete(plugin.name)
-
-      // Show progress step after each plugin
-      showProgressStep()
-    })
-
-    context.on('kubb:files:processing:start', ({ files }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      stopSpinner()
-
-      state.totalFiles = files.length
-      state.processedFiles = 0
-
-      const text = `Writing ${files.length} files`
-      const progressBar = clack.progress({
-        style: 'block',
-        max: files.length,
-        size: 30,
-      })
-
-      context.emit('kubb:info', { message: text })
-      progressBar.start(getMessage(text))
-      state.activeProgress.set('files', { progressBar })
-    })
-
-    context.on('kubb:file:processing:update', ({ file, config }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      stopSpinner()
-
-      state.processedFiles++
-
-      const text = `Writing ${relative(config.root, file.path)}`
-      const active = state.activeProgress.get('files')
-
-      if (!active) {
-        return
-      }
-
-      active.progressBar.advance(undefined, text)
-    })
-    context.on('kubb:files:processing:end', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      stopSpinner()
-
-      const text = getMessage('Files written successfully')
-      const active = state.activeProgress.get('files')
-
-      if (!active) {
-        return
-      }
-
-      active.progressBar.stop(text)
-      state.activeProgress.delete('files')
-
-      // Show final progress step after files are written
-      showProgressStep()
-    })
-
-    context.on('kubb:generation:end', ({ config }) => {
-      const text = getMessage(config.name ? `Generation completed for ${styleText('dim', config.name)}` : 'Generation completed')
-
-      clack.outro(text)
-    })
-
-    context.on('kubb:format:start', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Format started')
-
-      clack.intro(text)
-    })
-
-    context.on('kubb:format:end', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Format completed')
-
-      clack.outro(text)
-    })
-
-    context.on('kubb:lint:start', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Lint started')
-
-      clack.intro(text)
-    })
-
-    context.on('kubb:lint:end', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Lint completed')
-
-      clack.outro(text)
-    })
-
-    context.on('kubb:hook:start', ({ command, args }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const commandWithArgs = formatCommandWithArgs(command, args)
-      const text = getMessage(`Hook ${styleText('dim', commandWithArgs)} started`)
-
-      clack.intro(text)
-    })
-
-    context.on('kubb:hook:end', ({ command, args }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const commandWithArgs = formatCommandWithArgs(command, args)
-      const text = getMessage(`Hook ${styleText('dim', commandWithArgs)} successfully executed`)
-
-      clack.outro(text)
-    })
-
-    context.on('kubb:generation:summary', ({ config, pluginTimings, failedPlugins, filesCreated, status, hrStart }) => {
-      const summary = getSummary({
-        failedPlugins,
-        filesCreated,
-        config,
-        status,
-        hrStart,
-        pluginTimings: logLevel >= logLevelMap.verbose ? pluginTimings : undefined,
-      })
-      const title = config.name || ''
-
-      summary.unshift('\n')
-      summary.push('\n')
-
-      const borderColor = status === 'success' ? 'green' : 'red'
-      try {
-        clack.box(summary.join('\n'), getMessage(title), {
-          width: 'auto',
-          formatBorder: (s: string) => styleText(borderColor, s),
-          rounded: true,
-          withGuide: false,
-          contentAlign: 'left',
-          titleAlign: 'center',
-        })
-      } catch {
-        console.log(summary.join('\n'))
-      }
-    })
-
-    context.on('kubb:lifecycle:end', () => {
-      reset()
-    })
-
-    return (commandWithArgs: string) => {
-      if (logLevel <= logLevelMap.silent) {
-        return {
-          onStdout: (s: string) => console.log(s),
-          onStderr: (s: string) => console.error(s),
-        }
-      }
-
-      const logger = clack.taskLog({
-        title: getMessage(['Executing hook', logLevel >= logLevelMap.info ? styleText('dim', commandWithArgs) : undefined].filter(Boolean).join(' ')),
-      })
-      const writable = new ClackWritable(logger)
-
-      return {
-        stream: true,
-        onLine: (line: string) => writable.write(line),
-        onStdout: (s: string) => logger.message(s),
-        onStderr: (s: string) => logger.error(s),
-      }
-    }
-  },
-})

package/src/loggers/fileSystemLogger.ts

@@ -1,151 +0,0 @@
-import { relative, resolve } from 'node:path'
-import process from 'node:process'
-import { formatMs, write } from '@internals/utils'
-import { defineLogger } from '@kubb/core'
-
-type CachedEvent = {
-  /**
-   * Timestamp when this event was captured, used to derive the log filename.
-   */
-  date: Date
-  /**
-   * Accumulated log lines for this event.
-   */
-  logs: string[]
-  /**
-   * Optional override for the output filename inside `.kubb/`. When omitted, the filename is derived from `date`.
-   */
-  fileName?: string
-}
-
-/**
- * FileSystem logger that captures debug events and writes them to `.kubb` directory files.
- *
- * @note Logs are written on `kubb:lifecycle:end` or process exit. Cached logs may be lost if the process crashes before either event.
- */
-export const fileSystemLogger = defineLogger({
-  name: 'filesystem',
-  install(context) {
-    const state = {
-      cachedLogs: new Set<CachedEvent>(),
-      startDate: Date.now(),
-    }
-
-    function reset() {
-      state.cachedLogs = new Set<CachedEvent>()
-      state.startDate = Date.now()
-    }
-
-    async function writeLogs(name?: string) {
-      if (state.cachedLogs.size === 0) {
-        return []
-      }
-
-      const files: Record<string, string[]> = {}
-
-      for (const log of state.cachedLogs) {
-        const baseName = log.fileName || `${['kubb', name, state.startDate].filter(Boolean).join('-')}.log`
-        const pathName = resolve(process.cwd(), '.kubb', baseName)
-
-        if (!files[pathName]) {
-          files[pathName] = []
-        }
-
-        if (log.logs.length > 0) {
-          const prefix = `[${log.date.toLocaleString()}] `
-          const indent = ' '.repeat(prefix.length)
-          const [first, ...rest] = log.logs
-          files[pathName].push([prefix + first, ...rest.map((line) => indent + line)].join('\n'))
-        }
-      }
-
-      for (const [fileName, logs] of Object.entries(files)) {
-        await write(fileName, logs.join('\n'))
-      }
-
-      return Object.keys(files)
-    }
-
-    context.on('kubb:info', ({ message, info }) => {
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [`ℹ ${[message, info].filter(Boolean).join(' ')}`],
-      })
-    })
-
-    context.on('kubb:success', ({ message, info }) => {
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [`✓ ${[message, info].filter(Boolean).join(' ')}`],
-      })
-    })
-
-    context.on('kubb:warn', ({ message, info }) => {
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [`⚠ ${[message, info].filter(Boolean).join(' ')}`],
-      })
-    })
-
-    context.on('kubb:error', ({ error }) => {
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [`✗ ${error.message}`, error.stack || 'unknown stack'],
-      })
-    })
-
-    context.on('kubb:debug', ({ date, fileName, logs }) => {
-      state.cachedLogs.add({
-        date,
-        fileName,
-        logs,
-      })
-    })
-
-    context.on('kubb:plugin:start', ({ plugin }) => {
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [`► Generating ${plugin.name}`],
-      })
-    })
-
-    context.on('kubb:plugin:end', ({ plugin, duration, success }) => {
-      const durationStr = formatMs(duration)
-
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [success ? `✓ ${plugin.name} completed in ${durationStr}` : `✗ ${plugin.name} failed in ${durationStr}`],
-      })
-    })
-
-    context.on('kubb:files:processing:start', ({ files }) => {
-      state.cachedLogs.add({
-        date: new Date(),
-        logs: [`► Writing ${files.length} files`, ...files.map((file) => `  ${file.path}`)],
-      })
-    })
-
-    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', { message: 'Debug files written to:', info: files.join(', ') })
-      }
-      reset()
-    })
-
-    // Fallback: Write logs on process exit to handle crashes
-    const exitHandler = () => {
-      // Synchronous write on exit - best effort
-      if (state.cachedLogs.size > 0) {
-        writeLogs().catch(() => {
-          // Ignore errors on exit
-        })
-      }
-    }
-
-    process.once('exit', exitHandler)
-    process.once('SIGINT', exitHandler)
-    process.once('SIGTERM', exitHandler)
-  },
-})