@kubb/cli 5.0.0-beta.8 → 5.0.0-beta.81

package/src/commands/generate.ts

@@ -1,59 +0,0 @@
-import { defineCommand } from '@internals/utils'
-
-export const command = defineCommand({
-  name: 'generate',
-  description:
-    'Generate TypeScript types, API clients, React Query hooks, Zod schemas, and more from an OpenAPI specification. Reads kubb.config.ts by default. Pass an OpenAPI file path as the first argument to override the input without editing the config.',
-  arguments: ['[input]'],
-  examples: ['kubb generate', 'kubb generate ./openapi.yaml', 'kubb generate --config kubb.config.ts', 'kubb generate --watch'],
-  options: {
-    config: {
-      type: 'string',
-      description: 'Path to the Kubb config',
-      short: 'c',
-    },
-    logLevel: {
-      type: 'string',
-      description: 'Info, silent, verbose or debug',
-      short: 'l',
-      default: 'info',
-      hint: 'silent|info|verbose|debug',
-      enum: ['silent', 'info', 'verbose', 'debug'],
-    },
-    watch: {
-      type: 'boolean',
-      description: 'Watch mode based on the input file',
-      short: 'w',
-      default: false,
-    },
-    debug: {
-      type: 'boolean',
-      description: 'Override logLevel to debug',
-      short: 'd',
-      default: false,
-    },
-    verbose: {
-      type: 'boolean',
-      description: 'Override logLevel to verbose',
-      short: 'v',
-      default: false,
-    },
-    silent: {
-      type: 'boolean',
-      description: 'Override logLevel to silent',
-      short: 's',
-      default: false,
-    },
-  },
-  async run({ values, positionals }) {
-    const logLevel = values.debug ? 'debug' : values.verbose ? 'verbose' : values.silent ? 'silent' : values.logLevel
-    const { run } = await import('../runners/generate/run.ts')
-
-    await run({
-      input: positionals[0],
-      configPath: values.config,
-      logLevel,
-      watch: values.watch,
-    })
-  },
-})

package/src/commands/init.ts

@@ -1,51 +0,0 @@
-import { defineCommand } from '@internals/utils'
-import { version } from '../../package.json'
-
-export const command = defineCommand({
-  name: 'init',
-  description:
-    'Scaffold a kubb.config.ts and install plugins for code generation from an OpenAPI spec. Run without flags for interactive setup, or pass --input, --output, and --plugins to skip the prompts.',
-  examples: [
-    'kubb init',
-    'kubb init --yes',
-    'kubb init --input ./openapi.yaml --output ./src/gen --plugins plugin-ts,plugin-zod',
-    'kubb init --plugins plugin-ts,plugin-client,plugin-react-query',
-  ],
-  options: {
-    yes: {
-      type: 'boolean',
-      description: 'Skip prompts and use default options',
-      short: 'y',
-      default: false,
-    },
-    input: {
-      type: 'string',
-      description: 'Path to the OpenAPI specification',
-      short: 'i',
-      hint: 'path',
-    },
-    output: {
-      type: 'string',
-      description: 'Output directory for generated files',
-      short: 'o',
-      hint: 'path',
-    },
-    plugins: {
-      type: 'string',
-      description:
-        'Comma-separated list of plugins to use (plugin-ts, plugin-client, plugin-react-query, plugin-vue-query, plugin-zod, plugin-faker, plugin-msw, plugin-cypress, plugin-mcp, plugin-redoc)',
-      hint: 'plugin-ts,plugin-zod,...',
-    },
-  },
-  async run({ values }) {
-    const { run } = await import('../runners/init/run.ts')
-
-    await run({
-      yes: values.yes,
-      version,
-      input: values.input,
-      output: values.output,
-      plugins: values.plugins,
-    })
-  },
-})

package/src/commands/mcp.ts

@@ -1,36 +0,0 @@
-import { defineCommand } from '@internals/utils'
-import { version } from '../../package.json'
-
-export const command = defineCommand({
-  name: 'mcp',
-  description:
-    'Start a Model Context Protocol (MCP) server that exposes Kubb code generation as tools for AI assistants. Once running, configure your AI client (Claude, Cursor, Windsurf, etc.) to connect to it — the assistant can then call kubb generate directly without leaving the chat.',
-  examples: [
-    'kubb mcp',
-    'kubb mcp --port 3001',
-    '# Then add to your MCP client config:',
-    '# { "mcpServers": { "kubb": { "command": "npx", "args": ["kubb", "mcp"] } } }',
-  ],
-  options: {
-    port: {
-      type: 'string',
-      short: 'p',
-      description: 'Port for HTTP MCP server (omit for stdio)',
-      hint: 'number',
-    },
-    host: {
-      type: 'string',
-      description: 'Hostname to bind to (HTTP mode only)',
-      default: 'localhost',
-    },
-  },
-  async run({ values }) {
-    const { run } = await import('../runners/mcp/run.ts')
-
-    await run({
-      version,
-      port: values.port,
-      host: values.host,
-    })
-  },
-})

package/src/commands/validate.ts

@@ -1,22 +0,0 @@
-import { defineCommand } from '@internals/utils'
-import { version } from '../../package.json'
-
-export const command = defineCommand({
-  name: 'validate',
-  description:
-    'Parse and validate an OpenAPI/Swagger file for structural correctness. Reports schema errors, missing required fields, and malformed references. Use this before running generate to catch spec issues early.',
-  examples: ['kubb validate --input ./openapi.yaml', 'kubb validate --input https://petstore3.swagger.io/api/v3/openapi.json'],
-  options: {
-    input: {
-      type: 'string',
-      description: 'Path or URL to the OpenAPI/Swagger file to validate',
-      short: 'i',
-      required: true,
-    },
-  },
-  async run({ values }) {
-    const { run } = await import('../runners/validate/run.ts')
-
-    await run({ input: values.input, version })
-  },
-})

package/src/constants.ts

@@ -1,48 +0,0 @@
-import { KUBB_CONFIG_FILENAME } from '@internals/shared'
-
-/**
- * NPM registry endpoint used to check for @kubb/cli updates.
- */
-export const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const
-
-/**
- * OpenTelemetry ingestion endpoint for anonymous usage telemetry.
- */
-export const OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const
-
-/**
- * Horizontal rule rendered above/below the plain-logger generation summary.
- */
-export const SUMMARY_SEPARATOR = '─'.repeat(27)
-
-/**
- * Maximum number of █ characters in a plugin timing bar.
- */
-export const SUMMARY_MAX_BAR_LENGTH = 10 as const
-
-/**
- * Divides elapsed milliseconds into bar-length units (1 block per 100 ms).
- */
-export const SUMMARY_TIME_SCALE_DIVISOR = 100 as const
-
-/**
- * Glob pattern for paths the file watcher ignores.
- */
-export const WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const
-
-/**
- * Flags that short-circuit execution (help/version) — no telemetry notice is shown.
- */
-export const QUIET_FLAGS = new Set(['--help', '-h', '--version', '-v'] as const)
-
-export const agentDefaults = {
-  port: '3000',
-  host: 'localhost',
-  configFile: KUBB_CONFIG_FILENAME,
-  retryTimeout: '30000',
-  studioUrl: 'https://kubb.studio',
-  /**
-   * Relative path from the @kubb/agent package root to the server entry.
-   */
-  serverEntryPath: '.output/server/index.mjs',
-} as const

package/src/index.ts

@@ -1,45 +0,0 @@
-import { styleText } from 'node:util'
-import { createCLI, isFlag } from '@internals/utils'
-import { version } from '../package.json'
-import { QUIET_FLAGS } from './constants.ts'
-import { isTelemetryDisabled } from './telemetry.ts'
-
-const cli = createCLI()
-
-function shouldShowTelemetryNotice(argv: Array<string>): boolean {
-  if (isTelemetryDisabled()) {
-    return false
-  }
-
-  // Skip when the user is just asking for help or version info
-  if (argv.some((arg) => isFlag(QUIET_FLAGS, arg))) {
-    return false
-  }
-
-  // Skip in non-interactive / scripting contexts
-  if (!process.stdout.isTTY) {
-    return false
-  }
-
-  return true
-}
-
-export async function run(argv: Array<string> = process.argv): Promise<void> {
-  if (shouldShowTelemetryNotice(argv)) {
-    console.log(
-      `${styleText('yellow', 'Notice:')} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \nTo disable, set ${styleText('cyan', 'KUBB_DISABLE_TELEMETRY=1')}.\n`,
-    )
-  }
-
-  const { command: generateCommand } = await import('./commands/generate.ts')
-  const { command: validateCommand } = await import('./commands/validate.ts')
-  const { command: mcpCommand } = await import('./commands/mcp.ts')
-  const { command: agentCommand } = await import('./commands/agent.ts')
-  const { command: initCommand } = await import('./commands/init.ts')
-
-  await cli.run([generateCommand, validateCommand, mcpCommand, agentCommand, initCommand], argv, {
-    programName: 'kubb',
-    defaultCommandName: 'generate',
-    version,
-  })
-}