@kubb/cli 5.0.0-beta.75 → 5.0.0-beta.77

package/src/loggers/plainLogger.ts

@@ -1,254 +0,0 @@
-import { relative } from 'node:path'
-import { formatMs, toCause } from '@internals/utils'
-import { defineLogger, logLevel as logLevelMap } from '@kubb/core'
-import { SUMMARY_SEPARATOR } from '../constants.ts'
-import { getSummary } from '../utils/getSummary.ts'
-import { runHook } from '../utils/runHook.ts'
-import { formatCommandWithArgs, formatMessage } from './utils.ts'
-
-/**
- * Plain console adapter for non-TTY environments with simple `console.log` output.
- */
-export const plainLogger = defineLogger({
-  name: 'plain',
-  install(context, options) {
-    const logLevel = options?.logLevel ?? logLevelMap.info
-
-    function getMessage(message: string): string {
-      return formatMessage(message, logLevel)
-    }
-
-    context.on('kubb:info', ({ message, info }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage(['ℹ', message, info].join(' '))
-
-      console.log(text)
-    })
-
-    context.on('kubb:success', ({ message, info = '' }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage(['✓', message, logLevel >= logLevelMap.info ? info : undefined].filter(Boolean).join(' '))
-
-      console.log(text)
-    })
-
-    context.on('kubb:warn', ({ message, info }) => {
-      if (logLevel < logLevelMap.warn) {
-        return
-      }
-
-      const text = getMessage(['⚠', message, logLevel >= logLevelMap.info ? info : undefined].filter(Boolean).join(' '))
-
-      console.log(text)
-    })
-
-    context.on('kubb:error', ({ error }) => {
-      const caused = toCause(error)
-
-      const text = getMessage(['✗', error.message].join(' '))
-
-      console.log(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) {
-          console.log(getMessage(frame.trim()))
-        }
-
-        if (caused?.stack) {
-          console.log(`└─ caused by ${caused.message}`)
-
-          const frames = caused.stack.split('\n').slice(1, 4)
-          for (const frame of frames) {
-            console.log(getMessage(`    ${frame.trim()}`))
-          }
-        }
-      }
-    })
-
-    context.on('kubb:lifecycle:start', () => {
-      console.log('Kubb CLI 🧩')
-    })
-
-    context.on('kubb:config:start', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Configuration started')
-
-      console.log(text)
-    })
-
-    context.on('kubb:config:end', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Configuration completed')
-
-      console.log(text)
-    })
-
-    context.on('kubb:generation:start', () => {
-      const text = getMessage('Generation started')
-
-      console.log(text)
-    })
-
-    context.on('kubb:plugin:start', ({ plugin }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-      const text = getMessage(`Generating ${plugin.name}`)
-
-      console.log(text)
-    })
-
-    context.on('kubb:plugin:end', ({ plugin, duration, success }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const durationStr = formatMs(duration)
-      const text = getMessage(success ? `${plugin.name} completed in ${durationStr}` : `${plugin.name} failed in ${durationStr}`)
-
-      console.log(text)
-    })
-
-    context.on('kubb:files:processing:start', ({ files }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage(`Writing ${files.length} files`)
-
-      console.log(text)
-    })
-
-    context.on('kubb:file:processing:update', ({ file, config }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage(`Writing ${relative(config.root, file.path)}`)
-
-      console.log(text)
-    })
-
-    context.on('kubb:files:processing:end', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Files written successfully')
-
-      console.log(text)
-    })
-
-    context.on('kubb:generation:end', ({ config }) => {
-      const text = getMessage(config.name ? `Generation completed for ${config.name}` : 'Generation completed')
-
-      console.log(text)
-    })
-
-    context.on('kubb:format:start', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Format started')
-
-      console.log(text)
-    })
-
-    context.on('kubb:format:end', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Format completed')
-
-      console.log(text)
-    })
-
-    context.on('kubb:lint:start', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Lint started')
-
-      console.log(text)
-    })
-
-    context.on('kubb:lint:end', () => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const text = getMessage('Lint completed')
-
-      console.log(text)
-    })
-
-    context.on('kubb:hook:start', async ({ id, command, args }) => {
-      const commandWithArgs = formatCommandWithArgs(command, args)
-      const text = getMessage(`Hook ${commandWithArgs} started`)
-
-      if (logLevel > logLevelMap.silent) {
-        console.log(text)
-      }
-
-      // Skip hook execution if no id is provided (e.g., during benchmarks or tests)
-      if (!id) {
-        return
-      }
-
-      await runHook({
-        id,
-        command,
-        args,
-        commandWithArgs,
-        context,
-        sink: {
-          onStdout: logLevel > logLevelMap.silent ? (s) => console.log(s) : undefined,
-          onStderr: logLevel > logLevelMap.silent ? (s) => console.error(s) : undefined,
-        },
-      })
-    })
-
-    context.on('kubb:hook:end', ({ command, args }) => {
-      if (logLevel <= logLevelMap.silent) {
-        return
-      }
-
-      const commandWithArgs = formatCommandWithArgs(command, args)
-      const text = getMessage(`Hook ${commandWithArgs} completed`)
-
-      console.log(text)
-    })
-
-    context.on('kubb:generation:summary', ({ config, pluginTimings, status, hrStart, failedPlugins, filesCreated }) => {
-      const summary = getSummary({
-        failedPlugins,
-        filesCreated,
-        config,
-        status,
-        hrStart,
-        pluginTimings: logLevel >= logLevelMap.verbose ? pluginTimings : undefined,
-      })
-
-      console.log(SUMMARY_SEPARATOR)
-      console.log(summary.join('\n'))
-      console.log(SUMMARY_SEPARATOR)
-    })
-  },
-})

package/src/loggers/types.ts

@@ -1 +0,0 @@
-export type LoggerType = 'clack' | 'github-actions' | 'plain'

package/src/loggers/utils.ts

@@ -1,106 +0,0 @@
-import { styleText } from 'node:util'
-import { canUseTTY, formatHrtime, isGitHubActions } from '@internals/utils'
-import type { Logger, LoggerContext, LoggerOptions } from '@kubb/core'
-import { logLevel as logLevelMap } from '@kubb/core'
-import { clackLogger } from './clackLogger.ts'
-import { fileSystemLogger } from './fileSystemLogger.ts'
-import { githubActionsLogger } from './githubActionsLogger.ts'
-import { plainLogger } from './plainLogger.ts'
-import type { LoggerType } from './types.ts'
-
-/**
- * Optionally prefix a message with a [HH:MM:SS] timestamp when logLevel >= verbose.
- * Shared across all logger adapters to avoid duplication.
- */
-export function formatMessage(message: string, logLevel: number): string {
-  if (logLevel >= logLevelMap.verbose) {
-    const timestamp = new Date().toLocaleTimeString('en-US', {
-      hour12: false,
-      hour: '2-digit',
-      minute: '2-digit',
-      second: '2-digit',
-    })
-    return `${styleText('dim', `[${timestamp}]`)} ${message}`
-  }
-  return message
-}
-
-type ProgressState = {
-  totalPlugins: number
-  completedPlugins: number
-  failedPlugins: number
-  totalFiles: number
-  processedFiles: number
-  hrStart: [number, number]
-}
-
-/**
- * Build the progress summary line shared by clack and GitHub Actions loggers.
- * Returns null when there is nothing to display.
- */
-export function buildProgressLine(state: ProgressState): string | null {
-  const parts: string[] = []
-  const duration = formatHrtime(state.hrStart)
-
-  if (state.totalPlugins > 0) {
-    const pluginStr =
-      state.failedPlugins > 0
-        ? `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 ${styleText('green', state.processedFiles.toString())}/${state.totalFiles}`)
-  }
-
-  if (parts.length === 0) {
-    return null
-  }
-
-  parts.push(`${styleText('green', duration)} elapsed`)
-  return parts.join(styleText('dim', ' | '))
-}
-
-/**
- * Join a command and its optional args into a single display string.
- * e.g. ("prettier", ["--write", "."]) → "prettier --write ."
- */
-export function formatCommandWithArgs(command: string, args?: readonly string[]): string {
-  return args?.length ? `${command} ${args.join(' ')}` : command
-}
-
-function detectLogger(): LoggerType {
-  if (isGitHubActions()) {
-    return 'github-actions'
-  }
-  if (canUseTTY()) {
-    return 'clack'
-  }
-  return 'plain'
-}
-
-const logMapper = {
-  clack: clackLogger,
-  plain: plainLogger,
-  'github-actions': githubActionsLogger,
-} as const satisfies Record<LoggerType, Logger>
-
-export async function setupLogger(context: LoggerContext, { logLevel }: LoggerOptions): Promise<void> {
-  const type = detectLogger()
-
-  const logger = logMapper[type] as Logger
-
-  if (!logger) {
-    throw new Error(`Unknown adapter type: ${type}`)
-  }
-
-  // Install primary logger
-  const cleanup = await logger.install(context, { logLevel })
-
-  if (logLevel >= logLevelMap.debug) {
-    await fileSystemLogger.install(context, { logLevel })
-  }
-
-  return cleanup
-}

package/src/runners/agent.ts

@@ -1,149 +0,0 @@
-import net from 'node:net'
-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 { spawnAsync } from '@internals/utils'
-import { agentDefaults } from '../constants.ts'
-import { buildTelemetryEvent, sendTelemetry } from '../utils/telemetry.ts'
-
-type AgentStartOptions = {
-  port: string | undefined
-  host: string
-  configPath: string | undefined
-  allowWrite: boolean
-  allowAll: boolean
-  version: string
-}
-
-type ResolvedAgentStartEnvironment = {
-  port: string
-  host: string
-  allowWrite: boolean
-  allowAll: boolean
-  agentConfigPath: string
-  env: NodeJS.ProcessEnv
-}
-
-/**
- * Resolves the environment passed to the detached agent process using CLI values first, then environment values, then CLI defaults.
- */
-function resolveAgentStartEnvironment({ port, host, configPath, allowWrite, allowAll }: Omit<AgentStartOptions, 'version'>): ResolvedAgentStartEnvironment {
-  const resolvedPort = port ?? process.env.PORT ?? agentDefaults.port
-  const resolvedHost = host !== agentDefaults.host ? host : (process.env.HOST ?? agentDefaults.host)
-  const resolvedAllowAll = allowAll || process.env.KUBB_AGENT_ALLOW_ALL === 'true'
-  const resolvedAllowWrite = resolvedAllowAll || allowWrite || process.env.KUBB_AGENT_ALLOW_WRITE === 'true'
-  const agentRoot = process.env.KUBB_AGENT_ROOT ?? process.cwd()
-  const agentConfigPath = path.resolve(process.cwd(), configPath || process.env.KUBB_AGENT_CONFIG || agentDefaults.configFile)
-
-  return {
-    port: resolvedPort,
-    host: resolvedHost,
-    allowWrite: resolvedAllowWrite,
-    allowAll: resolvedAllowAll,
-    agentConfigPath,
-    env: {
-      ...process.env,
-      PORT: resolvedPort,
-      HOST: resolvedHost,
-      KUBB_AGENT_ROOT: agentRoot,
-      KUBB_AGENT_CONFIG: agentConfigPath,
-      KUBB_AGENT_ALLOW_WRITE: String(resolvedAllowWrite),
-      KUBB_AGENT_ALLOW_ALL: String(resolvedAllowAll),
-      KUBB_AGENT_TOKEN: process.env.KUBB_AGENT_TOKEN,
-      KUBB_AGENT_RETRY_TIMEOUT: process.env.KUBB_AGENT_RETRY_TIMEOUT ?? agentDefaults.retryTimeout,
-      KUBB_STUDIO_URL: process.env.KUBB_STUDIO_URL ?? agentDefaults.studioUrl,
-    },
-  }
-}
-
-function isPortAvailable(port: number, host: string): Promise<boolean> {
-  return new Promise((resolve) => {
-    const server = net.createServer()
-    server.once('error', () => resolve(false))
-    server.once('listening', () => {
-      server.close()
-      resolve(true)
-    })
-    server.listen(port, host)
-  })
-}
-
-export async function runAgentStart({ port, host, configPath, allowWrite, allowAll, version }: AgentStartOptions): Promise<void> {
-  const hrStart = process.hrtime()
-
-  try {
-    // 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
-    let agentPkgUrl: string
-    try {
-      agentPkgUrl = import.meta.resolve('@kubb/agent/package.json')
-    } catch (_e) {
-      console.error(`Import of '@kubb/agent' is required to start the Agent server`)
-      process.exit(1)
-    }
-    const agentPkgPath = fileURLToPath(agentPkgUrl)
-    const agentDir = path.dirname(agentPkgPath)
-    const serverPath = path.join(agentDir, agentDefaults.serverEntryPath)
-
-    const resolvedEnv = resolveAgentStartEnvironment({
-      port,
-      host,
-      configPath,
-      allowWrite,
-      allowAll,
-    })
-    const numericPort = Number(resolvedEnv.port)
-
-    if (!Number.isInteger(numericPort) || numericPort <= 0) {
-      throw new Error(`Invalid port "${resolvedEnv.port}". Provide a positive integer with --port or PORT.`)
-    }
-
-    clack.log.step(styleText('cyan', 'Starting agent server...'))
-    clack.log.info(styleText('dim', `Config: ${resolvedEnv.agentConfigPath}`))
-    clack.log.info(styleText('dim', `Host: ${resolvedEnv.host}`))
-    clack.log.info(styleText('dim', `Port: ${resolvedEnv.port}`))
-    if (!resolvedEnv.allowWrite && !resolvedEnv.allowAll) {
-      clack.log.warn(styleText('yellow', 'Filesystem writes disabled. Use --allow-write or --allow-all to enable.'))
-    }
-
-    if (!(await isPortAvailable(numericPort, resolvedEnv.host))) {
-      clack.log.error(styleText('red', `Port ${resolvedEnv.port} is already in use. Stop the existing process or choose a different port with --port.`))
-      process.exit(1)
-    }
-
-    // Spawns the server as a detached background process so the CLI can exit independently.
-    await spawnAsync('node', [serverPath], {
-      env: resolvedEnv.env,
-      cwd: process.cwd(),
-    })
-
-    await sendTelemetry(
-      buildTelemetryEvent({
-        command: 'agent',
-        kubbVersion: version,
-        hrStart,
-        status: 'success',
-      }),
-    )
-  } catch (error) {
-    await sendTelemetry(
-      buildTelemetryEvent({
-        command: 'agent',
-        kubbVersion: version,
-        hrStart,
-        status: 'failed',
-      }),
-    )
-    clack.log.error(styleText('red', 'Failed to start agent server'))
-    console.error(error)
-    process.exit(1)
-  }
-}