@kubb/cli 3.13.1 → 3.14.0

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@kubb/cli",
-  "version": "3.13.1",
-  "description": "Generator cli",
+  "version": "3.14.0",
+  "description": "Command-line interface for Kubb, enabling easy generation of TypeScript, React-Query, Zod, and other code from OpenAPI specifications.",
   "keywords": [
+    "cli",
+    "command-line",
     "typescript",
-    "plugins",
-    "kubb",
+    "openapi",
+    "swagger",
+    "code-generator",
     "codegen",
-    "cli"
+    "plugins",
+    "kubb"
   ],
   "repository": {
     "type": "git",
@@ -52,8 +56,8 @@
     "p-queue": "^8.1.0",
     "semver": "^7.7.2",
     "string-argv": "^0.3.2",
-    "@kubb/core": "3.13.1",
-    "@kubb/ui": "3.13.1"
+    "@kubb/core": "3.14.0",
+    "@kubb/ui": "3.14.0"
   },
   "devDependencies": {
     "@types/cli-progress": "^3.11.6",
@@ -62,10 +66,11 @@
     "source-map-support": "^0.5.21",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
-    "@kubb/config-ts": "3.13.1",
-    "@kubb/config-tsup": "3.13.1",
-    "@kubb/mcp": "3.13.1",
-    "@kubb/plugin-oas": "3.13.1"
+    "@kubb/config-ts": "3.14.0",
+    "@kubb/config-tsup": "3.14.0",
+    "@kubb/mcp": "3.14.0",
+    "@kubb/oas": "3.14.0",
+    "@kubb/plugin-oas": "3.14.0"
   },
   "engines": {
     "node": ">=20"

package/src/commands/mcp.ts

@@ -0,0 +1,52 @@
+import type { ArgsDef, ParsedArgs } from 'citty'
+import { defineCommand, showUsage } from 'citty'
+import consola from 'consola'
+import { createJiti } from 'jiti'
+
+const jiti = createJiti(import.meta.url, {
+  sourceMaps: true,
+})
+
+const args = {
+  help: {
+    type: 'boolean',
+    description: 'Show help',
+    alias: 'h',
+    default: false,
+  },
+} as const satisfies ArgsDef
+
+export type Args = ParsedArgs<typeof args>
+
+const command = defineCommand({
+  meta: {
+    name: 'mcp',
+    description: 'Start the server to enable the MCP client to interact with the LLM.',
+  },
+  args,
+  async run(commandContext) {
+    const { args } = commandContext
+
+    if (args.help) {
+      return showUsage(command)
+    }
+
+    let mod: any
+    try {
+      mod = await jiti.import('@kubb/mcp', { default: true })
+    } catch (_e) {
+      consola.error(`Import of '@kubb/mcp' is required to start the MCP server`)
+    }
+
+    const { startServer } = mod
+    try {
+      consola.start('Starting MCP server...')
+      consola.warn('This feature is still under development — use with caution')
+      await startServer()
+    } catch (e) {
+      consola.error((e as Error)?.message)
+    }
+  },
+})
+
+export default command

package/src/commands/validate.ts

@@ -0,0 +1,63 @@
+import process from 'node:process'
+import type { ArgsDef, ParsedArgs } from 'citty'
+import { defineCommand, showUsage } from 'citty'
+import consola from 'consola'
+import { createJiti } from 'jiti'
+
+const jiti = createJiti(import.meta.url, {
+  sourceMaps: true,
+})
+
+const args = {
+  input: {
+    type: 'string',
+    description: 'Path to Swagger/OpenAPI file',
+    alias: 'i',
+  },
+  help: {
+    type: 'boolean',
+    description: 'Show help',
+    alias: 'h',
+    default: false,
+  },
+} as const satisfies ArgsDef
+
+export type Args = ParsedArgs<typeof args>
+
+const command = defineCommand({
+  meta: {
+    name: 'validate',
+    description: 'Validate a Swagger/OpenAPI file',
+  },
+  args,
+  async run(commandContext) {
+    const { args } = commandContext
+
+    if (args.help) {
+      return showUsage(command)
+    }
+
+    if (args.input) {
+      let mod: any
+      try {
+        mod = await jiti.import('@kubb/oas', { default: true })
+      } catch (_e) {
+        consola.error(`Import of '@kubb/oas' is required to do validation`)
+      }
+
+      const { parse } = mod
+      try {
+        const oas = await parse(args.input)
+        await oas.valdiate()
+
+        consola.success('Validation success')
+      } catch (e) {
+        consola.fail('Validation failed')
+        consola.log((e as Error)?.message)
+        process.exit(1)
+      }
+    }
+  },
+})
+
+export default command

package/src/index.ts

@@ -1,10 +1,9 @@
 import { defineCommand, runCommand, runMain } from 'citty'
+import consola from 'consola'
+import { default as gradientString } from 'gradient-string'
 import getLatestVersion from 'latest-version'
 import { lt } from 'semver'
-import { default as gradientString } from 'gradient-string'
-
 import { version } from '../package.json'
-import consola from 'consola'
 
 const name = 'kubb'
 
@@ -34,7 +33,7 @@ Run \`npm install -g @kubb/cli\` to update`,
       }
     } catch (_e) {}
 
-    if (!['generate'].includes(rawArgs[0] as string)) {
+    if (!['generate', 'validate', 'mcp'].includes(rawArgs[0] as string)) {
       console.log(rawArgs[0])
       // generate is not being used
       const generateCommand = await import('./commands/generate.ts').then((r) => r.default)
@@ -46,6 +45,8 @@ Run \`npm install -g @kubb/cli\` to update`,
   },
   subCommands: {
     generate: () => import('./commands/generate.ts').then((r) => r.default),
+    validate: () => import('./commands/validate.ts').then((r) => r.default),
+    mcp: () => import('./commands/mcp.ts').then((r) => r.default),
   },
 })
 

package/src/runners/generate.ts

@@ -1,17 +1,13 @@
-import { LogMapper } from '@kubb/core/logger'
-
-import { colors } from 'consola/utils'
-
+import process from 'node:process'
 import { type Config, safeBuild, setup } from '@kubb/core'
+import { createLogger, LogMapper } from '@kubb/core/logger'
+import { Presets, SingleBar } from 'cli-progress'
+import { colors } from 'consola/utils'
+import type { Args } from '../commands/generate.ts'
 import { executeHooks } from '../utils/executeHooks.ts'
 import { getErrorCauses } from '../utils/getErrorCauses.ts'
 import { getSummary } from '../utils/getSummary.ts'
 
-import { createLogger } from '@kubb/core/logger'
-import { Presets, SingleBar } from 'cli-progress'
-import type { Args } from '../commands/generate.ts'
-import process from 'node:process'
-
 type GenerateProps = {
   input?: string
   config: Config
@@ -134,7 +130,7 @@ export async function generate({ input, config, progressCache, args }: GenerateP
 
     logger.consola?.error(error)
 
-    process.exit(0)
+    process.exit(1)
   }
 
   if (config.hooks) {