@kubb/mcp 5.0.0-beta.6 → 5.0.0-beta.61

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (20) hide show
  1. package/LICENSE +17 -10
  2. package/README.md +64 -17
  3. package/dist/index.cjs +322 -187
  4. package/dist/index.cjs.map +1 -1
  5. package/dist/index.d.ts +3 -4
  6. package/dist/index.js +322 -187
  7. package/dist/index.js.map +1 -1
  8. package/package.json +17 -25
  9. package/src/constants.ts +24 -0
  10. package/src/index.ts +1 -1
  11. package/src/schemas/generateSchema.ts +1 -1
  12. package/src/server.ts +9 -1
  13. package/src/tools/generate.ts +22 -24
  14. package/src/tools/init.ts +1 -1
  15. package/src/tools/validate.ts +4 -1
  16. package/src/{utils/loadUserConfig.ts → utils.ts} +63 -12
  17. package/src/types.ts +0 -23
  18. package/src/utils/resolveCwd.ts +0 -20
  19. package/src/utils/resolveUserConfig.ts +0 -13
  20. /package/dist/{chunk--u3MIqq1.js → chunk-C0LytTxp.js} +0 -0
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["#emitter","NodeEventEmitter","process"],"sources":["../package.json","../../../internals/utils/src/errors.ts","../../../internals/utils/src/asyncEventEmitter.ts","../../../internals/utils/src/promise.ts","../src/schemas/generateSchema.ts","../src/types.ts","../src/constants.ts","../src/utils/loadUserConfig.ts","../src/utils/resolveCwd.ts","../src/utils/resolveUserConfig.ts","../src/tools/generate.ts","../../../internals/shared/src/constants.ts","../../../internals/shared/src/init.ts","../src/schemas/initSchema.ts","../src/tools/init.ts","../src/schemas/validateSchema.ts","../src/tools/validate.ts","../src/server.ts","../src/index.ts"],"sourcesContent":["","/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n errors: Array<Error>\n\n constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n super(message, { cause: options.cause })\n this.name = 'BuildError'\n this.errors = options.errors\n }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n * throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string') // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n return error.cause instanceof Error ? error.cause : undefined\n}\n","import { EventEmitter as NodeEventEmitter } from 'node:events'\nimport { toError } from './errors.ts'\n\n/**\n * A function that can be registered as an event listener, synchronous or async.\n */\ntype AsyncListener<TArgs extends unknown[]> = (...args: TArgs) => void | Promise<void>\n\n/**\n * Typed `EventEmitter` that awaits all async listeners before resolving.\n * Wraps Node's `EventEmitter` with full TypeScript event-map inference.\n *\n * @example\n * ```ts\n * const emitter = new AsyncEventEmitter<{ build: [name: string] }>()\n * emitter.on('build', async (name) => { console.log(name) })\n * await emitter.emit('build', 'petstore') // all listeners awaited\n * ```\n */\nexport class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: unknown[] }> {\n /**\n * Maximum number of listeners per event before Node emits a memory-leak warning.\n * @default 10\n */\n constructor(maxListener = 10) {\n this.#emitter.setMaxListeners(maxListener)\n }\n\n #emitter = new NodeEventEmitter()\n\n /**\n * Emits `eventName` and awaits all registered listeners sequentially.\n * Throws if any listener rejects, wrapping the cause with the event name and serialized arguments.\n *\n * @example\n * ```ts\n * await emitter.emit('build', 'petstore')\n * ```\n */\n async emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArgs: TEvents[TEventName]): Promise<void> {\n const listeners = this.#emitter.listeners(eventName) as Array<AsyncListener<TEvents[TEventName]>>\n\n if (listeners.length === 0) {\n return\n }\n\n for (const listener of listeners) {\n try {\n await listener(...eventArgs)\n } catch (err) {\n let serializedArgs: string\n try {\n serializedArgs = JSON.stringify(eventArgs)\n } catch {\n serializedArgs = String(eventArgs)\n }\n throw new Error(`Error in async listener for \"${eventName}\" with eventArgs ${serializedArgs}`, { cause: toError(err) })\n }\n }\n }\n\n /**\n * Registers a persistent listener for `eventName`.\n *\n * @example\n * ```ts\n * emitter.on('build', async (name) => { console.log(name) })\n * ```\n */\n on<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n this.#emitter.on(eventName, handler as AsyncListener<unknown[]>)\n }\n\n /**\n * Registers a one-shot listener that removes itself after the first invocation.\n *\n * @example\n * ```ts\n * emitter.onOnce('build', async (name) => { console.log(name) })\n * ```\n */\n onOnce<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n const wrapper: AsyncListener<TEvents[TEventName]> = (...args) => {\n this.off(eventName, wrapper)\n return handler(...args)\n }\n this.on(eventName, wrapper)\n }\n\n /**\n * Removes a previously registered listener.\n *\n * @example\n * ```ts\n * emitter.off('build', handler)\n * ```\n */\n off<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n this.#emitter.off(eventName, handler as AsyncListener<unknown[]>)\n }\n\n /**\n * Returns the number of listeners registered for `eventName`.\n *\n * @example\n * ```ts\n * emitter.on('build', handler)\n * emitter.listenerCount('build') // 1\n * ```\n */\n listenerCount<TEventName extends keyof TEvents & string>(eventName: TEventName): number {\n return this.#emitter.listenerCount(eventName)\n }\n\n /**\n * Removes all listeners from every event channel.\n *\n * @example\n * ```ts\n * emitter.removeAll()\n * ```\n */\n removeAll(): void {\n this.#emitter.removeAllListeners()\n }\n}\n","/** A value that may already be resolved or still pending.\n *\n * @example\n * ```ts\n * function load(id: string): PossiblePromise<string> {\n * return cache.get(id) ?? fetchRemote(id)\n * }\n * ```\n */\nexport type PossiblePromise<T> = Promise<T> | T\n\n/** Returns `true` when `result` is a thenable `Promise`.\n *\n * @example\n * ```ts\n * isPromise(Promise.resolve(1)) // true\n * isPromise(42) // false\n * ```\n */\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n return result !== null && result !== undefined && typeof (result as Record<string, unknown>)['then'] === 'function'\n}\n\n/** Returns `true` when `result` is a fulfilled `Promise.allSettled` result.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseFulfilledResult).map((r) => r.value)\n * ```\n */\nexport function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T> {\n return result.status === 'fulfilled'\n}\n\n/** Returns `true` when `result` is a rejected `Promise.allSettled` result with a typed `reason`.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseRejectedResult<Error>).map((r) => r.reason.message)\n * ```\n */\nexport function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & { reason: T } {\n return result.status === 'rejected'\n}\n","import * as v from 'valibot'\n\nexport const generateSchema = v.object({\n config: v.optional(\n v.pipe(v.string(), v.minLength(1), v.description('Path to kubb.config file (supports .ts, .js, .cjs). If not provided, will look for kubb.config.{ts,js,cjs} in current directory')),\n ),\n input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI/Swagger spec file (overrides config)'))),\n output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory path (overrides config)'))),\n logLevel: v.optional(\n v.pipe(v.picklist(['silent', 'error', 'warn', 'info', 'verbose', 'debug']), v.description('Log level for build output')),\n 'info',\n ),\n})\n","export const NotifyTypes = {\n INFO: 'INFO',\n SUCCESS: 'SUCCESS',\n ERROR: 'ERROR',\n WARN: 'WARN',\n PLUGIN_START: 'PLUGIN_START',\n PLUGIN_END: 'PLUGIN_END',\n FILES_START: 'FILES_START',\n FILE_UPDATE: 'FILE_UPDATE',\n FILES_END: 'FILES_END',\n GENERATION_START: 'GENERATION_START',\n GENERATION_END: 'GENERATION_END',\n CONFIG_LOADED: 'CONFIG_LOADED',\n CONFIG_ERROR: 'CONFIG_ERROR',\n CONFIG_READY: 'CONFIG_READY',\n SETUP_START: 'SETUP_START',\n SETUP_END: 'SETUP_END',\n BUILD_START: 'BUILD_START',\n BUILD_END: 'BUILD_END',\n BUILD_FAILED: 'BUILD_FAILED',\n BUILD_SUCCESS: 'BUILD_SUCCESS',\n FATAL_ERROR: 'FATAL_ERROR',\n} as const\n","export const ALLOWED_CONFIG_EXTENSIONS = new Set(['.ts', '.mts', '.cts', '.js', '.mjs', '.cjs'])\n","import { existsSync } from 'node:fs'\nimport path from 'node:path'\nimport type { Config } from '@kubb/core'\nimport { createJiti } from 'jiti'\nimport { ALLOWED_CONFIG_EXTENSIONS } from '../constants.ts'\nimport { NotifyTypes } from '../types.ts'\n\ntype NotifyFunction = (type: string, message: string, data?: Record<string, unknown>) => Promise<void>\n\nconst jiti = createJiti(import.meta.url, {\n jsx: {\n runtime: 'automatic',\n importSource: '@kubb/renderer-jsx',\n },\n moduleCache: false,\n})\n\nconst loadedModules = new Map<string, unknown>()\n\nasync function loadModule(filePath: string): Promise<unknown> {\n const ext = path.extname(filePath)\n if (!ALLOWED_CONFIG_EXTENSIONS.has(ext)) {\n throw new Error(`Invalid config file extension \"${ext}\". Allowed: ${[...ALLOWED_CONFIG_EXTENSIONS].join(', ')}`)\n }\n if (loadedModules.has(filePath)) {\n return loadedModules.get(filePath)\n }\n const mod = await jiti.import(filePath, { default: true })\n loadedModules.set(filePath, mod)\n return mod\n}\n\nexport async function loadUserConfig(configPath: string | undefined, { notify }: { notify: NotifyFunction }): Promise<{ userConfig: Config; cwd: string }> {\n if (configPath) {\n const ext = path.extname(configPath)\n if (!ALLOWED_CONFIG_EXTENSIONS.has(ext)) {\n const msg = `Invalid config file extension \"${ext}\". Allowed: ${[...ALLOWED_CONFIG_EXTENSIONS].join(', ')}`\n await notify(NotifyTypes.CONFIG_ERROR, msg)\n throw new Error(msg)\n }\n const base = path.resolve(process.cwd())\n const resolvedConfigPath = path.resolve(base, configPath)\n const relative = path.relative(base, resolvedConfigPath)\n if (relative.startsWith('..') || path.isAbsolute(relative)) {\n const msg = 'Invalid config file path: must be within the current working directory'\n await notify(NotifyTypes.CONFIG_ERROR, msg)\n throw new Error(msg)\n }\n const cwd = path.dirname(resolvedConfigPath)\n try {\n const userConfig = (await loadModule(resolvedConfigPath)) as Config\n await notify(NotifyTypes.CONFIG_LOADED, `Loaded config from ${resolvedConfigPath}`)\n return { userConfig, cwd }\n } catch (error) {\n const msg = `Failed to load config: ${error instanceof Error ? error.message : String(error)}`\n await notify(NotifyTypes.CONFIG_ERROR, msg)\n throw new Error(msg)\n }\n }\n\n const cwd = process.cwd()\n const configFileNames = ['kubb.config.ts', 'kubb.config.mts', 'kubb.config.cts', 'kubb.config.js', 'kubb.config.cjs']\n\n for (const configFileName of configFileNames) {\n const configFilePath = path.resolve(process.cwd(), configFileName)\n if (!existsSync(configFilePath)) continue\n try {\n const userConfig = (await loadModule(configFilePath)) as Config\n await notify(NotifyTypes.CONFIG_LOADED, `Loaded ${configFileName} from current directory`)\n return { userConfig, cwd }\n } catch (err) {\n await notify(NotifyTypes.CONFIG_ERROR, `Failed to load ${configFileName}: ${err instanceof Error ? err.message : String(err)}`)\n }\n }\n\n await notify(NotifyTypes.CONFIG_ERROR, 'No config file found')\n throw new Error(`No config file found. Please provide a config path or create one of: ${configFileNames.join(', ')}`)\n}\n","import path from 'node:path'\nimport type { Config } from '@kubb/core'\n\n/**\n * Determine the root directory based on userConfig.root and resolvedConfigDir\n * 1. If userConfig.root exists and is absolute, use it as-is\n * 2. If userConfig.root exists and is relative, resolve it relative to config directory\n * 3. Otherwise, use the config directory as root\n */\nexport function resolveCwd(userConfig: Config, cwd: string): string {\n if (userConfig.root) {\n if (path.isAbsolute(userConfig.root)) {\n return userConfig.root\n }\n\n return path.resolve(cwd, userConfig.root)\n }\n\n return cwd\n}\n","import { isPromise } from '@internals/utils'\nimport type { CLIOptions, Config, PossibleConfig } from '@kubb/core'\n\nexport type ResolveUserConfigOptions = {\n configPath?: string\n logLevel?: string\n}\n\nexport async function resolveUserConfig(config: PossibleConfig<CLIOptions>, options: ResolveUserConfigOptions): Promise<Config> {\n const result = typeof config === 'function' ? config({ logLevel: options.logLevel as CLIOptions['logLevel'], config: options.configPath }) : config\n const resolved = isPromise(result) ? await result : result\n return (Array.isArray(resolved) ? resolved[0] : resolved) as Config\n}\n","import { AsyncEventEmitter, toError } from '@internals/utils'\nimport { type Config, createKubb, type KubbHooks } from '@kubb/core'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport type * as v from 'valibot'\nimport { generateSchema } from '../schemas/generateSchema.ts'\nimport { NotifyTypes } from '../types.ts'\nimport { loadUserConfig } from '../utils/loadUserConfig.ts'\nimport { resolveCwd } from '../utils/resolveCwd.ts'\nimport { resolveUserConfig } from '../utils/resolveUserConfig.ts'\n\nexport const generateTool = defineTool(\n {\n name: 'generate',\n description: 'Generate OpenAPI spec helpers using Kubb configuration',\n schema: generateSchema,\n },\n async function generate(schema: v.InferInput<typeof generateSchema>) {\n const { config: configPath, input, output, logLevel } = schema\n\n try {\n const hooks = new AsyncEventEmitter<KubbHooks>()\n const messages: string[] = []\n\n const notify = async (type: string, message: string, _data?: Record<string, unknown>) => {\n messages.push(`${type}: ${message}`)\n }\n\n hooks.on('kubb:info', async ({ message }: { message: string }) => {\n await notify(NotifyTypes.INFO, message)\n })\n\n hooks.on('kubb:success', async ({ message }: { message: string }) => {\n await notify(NotifyTypes.SUCCESS, message)\n })\n\n hooks.on('kubb:error', async ({ error }: { error: Error }) => {\n await notify(NotifyTypes.ERROR, error.message)\n })\n\n hooks.on('kubb:warn', async ({ message }: { message: string }) => {\n await notify(NotifyTypes.WARN, message)\n })\n\n hooks.on('kubb:plugin:start', async ({ plugin }) => {\n await notify(NotifyTypes.PLUGIN_START, `Plugin starting: ${plugin.name}`)\n })\n\n hooks.on('kubb:plugin:end', async ({ plugin, duration }) => {\n await notify(NotifyTypes.PLUGIN_END, `Plugin finished: ${plugin.name}`, { duration })\n })\n\n hooks.on('kubb:files:processing:start', async () => {\n await notify(NotifyTypes.FILES_START, 'Starting file processing')\n })\n\n hooks.on('kubb:file:processing:update', async ({ file }: { file: { name: string } }) => {\n await notify(NotifyTypes.FILE_UPDATE, `Processing file: ${file.name}`)\n })\n\n hooks.on('kubb:files:processing:end', async () => {\n await notify(NotifyTypes.FILES_END, 'File processing complete')\n })\n\n hooks.on('kubb:generation:start', async () => {\n await notify(NotifyTypes.GENERATION_START, 'Generation started')\n })\n\n hooks.on('kubb:generation:end', async () => {\n await notify(NotifyTypes.GENERATION_END, 'Generation ended')\n })\n\n let userConfig: Config\n let cwd: string\n\n try {\n const configResult = await loadUserConfig(configPath, { notify })\n userConfig = configResult.userConfig\n cwd = configResult.cwd\n\n if (Array.isArray(userConfig)) {\n throw new Error('Array type in kubb.config.ts is not supported in this tool. Please provide a single configuration object.')\n }\n\n userConfig = await resolveUserConfig(userConfig, {\n configPath,\n logLevel,\n })\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error)\n await notify(NotifyTypes.CONFIG_ERROR, errorMessage)\n return tool.error(errorMessage)\n }\n\n const inputPath = input ?? (userConfig.input && 'path' in userConfig.input ? userConfig.input.path : undefined)\n\n const config: Config = {\n ...userConfig,\n root: resolveCwd(userConfig, cwd),\n input: inputPath\n ? {\n ...userConfig.input,\n path: inputPath,\n }\n : userConfig.input,\n output: output\n ? {\n ...userConfig.output,\n path: output,\n }\n : userConfig.output,\n }\n\n await notify(NotifyTypes.CONFIG_READY, 'Configuration ready')\n await notify(NotifyTypes.SETUP_START, 'Setting up Kubb')\n\n const kubb = createKubb(config, { hooks })\n await kubb.setup()\n await notify(NotifyTypes.SETUP_END, 'Kubb setup complete')\n\n await notify(NotifyTypes.BUILD_START, 'Starting build')\n const { files, failedPlugins, error } = await kubb.safeBuild()\n await notify(NotifyTypes.BUILD_END, `Build complete - Generated ${files.length} files`)\n\n if (error || failedPlugins.size > 0) {\n const allErrors: Error[] = [\n error,\n ...Array.from(failedPlugins)\n .filter((it) => it.error)\n .map((it) => it.error),\n ].filter(Boolean)\n\n await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${allErrors.length} error(s)`)\n\n return tool.error(`Build failed:\\n${allErrors.map((err) => err.message).join('\\n')}\\n\\n${messages.join('\\n')}`)\n }\n\n await notify(NotifyTypes.BUILD_SUCCESS, `Build completed successfully - Generated ${files.length} files`)\n\n return tool.text(`Build completed successfully!\\n\\nGenerated ${files.length} files\\n\\n${messages.join('\\n')}`)\n } catch (caughtError) {\n const error = toError(caughtError)\n return tool.error(`Build error: ${error.message}\\n${error.stack ?? ''}`)\n }\n },\n)\n","import type { PluginOption } from './types.ts'\n\nexport const KUBB_CONFIG_FILENAME = 'kubb.config.ts' as const\n\nexport const initDefaults = {\n inputPath: './openapi.yaml',\n outputPath: './src/gen',\n plugins: ['plugin-ts'],\n} as const\n\nexport const availablePlugins: PluginOption[] = [\n {\n value: 'plugin-ts',\n label: 'TypeScript',\n hint: 'Recommended',\n packageName: '@kubb/plugin-ts',\n importName: 'pluginTs',\n category: 'types',\n },\n {\n value: 'plugin-client',\n label: 'Client (Fetch/Axios)',\n packageName: '@kubb/plugin-client',\n importName: 'pluginClient',\n category: 'client',\n },\n {\n value: 'plugin-react-query',\n label: 'React Query / TanStack Query',\n packageName: '@kubb/plugin-react-query',\n importName: 'pluginReactQuery',\n category: 'framework',\n },\n {\n value: 'plugin-vue-query',\n label: 'Vue Query',\n packageName: '@kubb/plugin-vue-query',\n importName: 'pluginVueQuery',\n category: 'framework',\n },\n {\n value: 'plugin-zod',\n label: 'Zod Schemas',\n packageName: '@kubb/plugin-zod',\n importName: 'pluginZod',\n category: 'validation',\n },\n {\n value: 'plugin-faker',\n label: 'Faker.js Mocks',\n packageName: '@kubb/plugin-faker',\n importName: 'pluginFaker',\n category: 'mocks',\n },\n {\n value: 'plugin-msw',\n label: 'MSW Handlers',\n packageName: '@kubb/plugin-msw',\n importName: 'pluginMsw',\n category: 'mocks',\n },\n {\n value: 'plugin-cypress',\n label: 'Cypress Tests',\n packageName: '@kubb/plugin-cypress',\n importName: 'pluginCypress',\n category: 'testing',\n },\n {\n value: 'plugin-mcp',\n label: 'MCP Server (AI / Model Context Protocol)',\n packageName: '@kubb/plugin-mcp',\n importName: 'pluginMcp',\n category: 'ai',\n },\n {\n value: 'plugin-redoc',\n label: 'ReDoc Documentation',\n packageName: '@kubb/plugin-redoc',\n importName: 'pluginRedoc',\n category: 'documentation',\n },\n]\n\nexport const pluginDefaultConfigs = {\n 'plugin-ts': `pluginTs({\n output: { path: 'models' },\n })`,\n 'plugin-client': `pluginClient({\n output: { path: 'clients' },\n })`,\n 'plugin-react-query': `pluginReactQuery({\n output: { path: 'hooks' },\n })`,\n 'plugin-vue-query': `pluginVueQuery({\n output: { path: 'hooks' },\n })`,\n 'plugin-zod': `pluginZod({\n output: { path: 'zod' },\n })`,\n 'plugin-faker': `pluginFaker({\n output: { path: 'mocks' },\n })`,\n 'plugin-msw': `pluginMsw({\n output: { path: 'msw' },\n })`,\n 'plugin-cypress': `pluginCypress({\n output: { path: 'cypress' },\n })`,\n 'plugin-mcp': `pluginMcp({\n output: { path: 'mcp' },\n })`,\n 'plugin-redoc': `pluginRedoc({\n output: { path: 'redoc' },\n })`,\n} as const satisfies Record<string, string>\n","import { pluginDefaultConfigs } from './constants.ts'\nimport type { PluginOption } from './types.ts'\n\nexport function generateConfigFile({\n selectedPlugins,\n inputPath,\n outputPath,\n}: {\n selectedPlugins: PluginOption[]\n inputPath: string\n outputPath: string\n}): string {\n const imports = selectedPlugins.map((plugin) => `import { ${plugin.importName} } from '${plugin.packageName}'`).join('\\n')\n\n const pluginConfigs = selectedPlugins\n .map((plugin) => {\n const config = (pluginDefaultConfigs as Record<string, string>)[plugin.value] ?? `${plugin.importName}()`\n return ` ${config},`\n })\n .join('\\n')\n\n return `import { defineConfig } from 'kubb'\n${imports}\n\nexport default defineConfig({\n root: '.',\n input: {\n path: '${inputPath}',\n },\n output: {\n path: '${outputPath}',\n clean: true,\n },\n plugins: [\n${pluginConfigs}\n ],\n})\n`\n}\n","import * as v from 'valibot'\n\nexport const initSchema = v.object({\n input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI spec (default: ./openapi.yaml)'))),\n output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory (default: ./src/gen)'))),\n plugins: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Comma-separated list of plugins: plugin-ts,plugin-zod,...'))),\n})\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { availablePlugins, generateConfigFile, KUBB_CONFIG_FILENAME, type PluginOption } from '@internals/shared'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport { initSchema } from '../schemas/initSchema.ts'\n\nexport function resolvePlugins(pluginsFlag: string | undefined): PluginOption[] {\n if (!pluginsFlag) {\n return []\n }\n const requested = pluginsFlag\n .split(',')\n .map((v) => v.trim())\n .filter(Boolean)\n return availablePlugins.filter((p) => requested.includes(p.value))\n}\n\nexport const initTool = defineTool(\n {\n name: 'init',\n description: 'Scaffold a kubb.config.ts in the current directory (non-interactive). Does not install packages.',\n schema: initSchema,\n },\n async ({ input = './openapi.yaml', output = './src/gen', plugins }) => {\n const selected = resolvePlugins(plugins)\n const content = generateConfigFile({ selectedPlugins: selected, inputPath: input, outputPath: output })\n const dest = path.join(process.cwd(), KUBB_CONFIG_FILENAME)\n if (fs.existsSync(dest)) {\n return tool.error(`${KUBB_CONFIG_FILENAME} already exists at ${dest}. Delete it first before running init again.`)\n }\n fs.writeFileSync(dest, content, 'utf-8')\n const packageList = ['kubb', ...selected.map((p) => p.packageName)].join(' ')\n return tool.text(`Created kubb.config.ts\\n\\nInstall packages:\\n npm install ${packageList}\\n\\nThen run:\\n npx kubb generate`)\n },\n)\n","import * as v from 'valibot'\n\nexport const validateSchema = v.object({\n input: v.pipe(v.string(), v.minLength(1), v.description('Path or URL to the OpenAPI/Swagger specification')),\n})\n","import { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport { validateSchema } from '../schemas/validateSchema.ts'\n\nexport const validateTool = defineTool(\n {\n name: 'validate',\n description: 'Validate an OpenAPI/Swagger specification file or URL',\n schema: validateSchema,\n },\n async ({ input }) => {\n let mod: typeof import('@kubb/adapter-oas')\n try {\n mod = await import('@kubb/adapter-oas')\n } catch {\n return tool.error('The validate tool requires @kubb/adapter-oas.\\nInstall: npm install @kubb/adapter-oas')\n }\n try {\n await mod.adapterOas().validate(input, { throwOnError: true })\n return tool.text(`Validation successful: ${input}`)\n } catch (err) {\n return tool.error(`Validation failed:\\n${err instanceof Error ? err.message : String(err)}`)\n }\n },\n)\n","import http from 'node:http'\nimport { createRequestListener } from '@remix-run/node-fetch-server'\nimport { ValibotJsonSchemaAdapter } from '@tmcp/adapter-valibot'\nimport { HttpTransport } from '@tmcp/transport-http'\nimport { StdioTransport } from '@tmcp/transport-stdio'\nimport { McpServer } from 'tmcp'\nimport { version } from '../package.json'\nimport { generateTool } from './tools/generate.ts'\nimport { initTool } from './tools/init.ts'\nimport { validateTool } from './tools/validate.ts'\n\nexport type ServerOptions = {\n port?: number\n host?: string\n}\n\nexport function createMcpServer() {\n const server = new McpServer({ name: 'Kubb', version }, { adapter: new ValibotJsonSchemaAdapter() })\n server.tools([generateTool, validateTool, initTool])\n return server\n}\n\nexport async function startServer({ port, host = 'localhost' }: ServerOptions = {}) {\n const server = createMcpServer()\n\n if (port === undefined) {\n new StdioTransport(server).listen()\n return\n }\n\n const transport = new HttpTransport(server, { path: '/mcp' })\n const httpServer = http.createServer(\n createRequestListener(async (request) => {\n const response = await transport.respond(request)\n return response ?? new Response('Not Found', { status: 404 })\n }),\n )\n httpServer.listen(port, host, () => {\n console.log(`Kubb MCP server on http://${host}:${port}`)\n })\n}\n","import { startServer } from './server.ts'\n\nexport { createMcpServer } from './server.ts'\nexport type { ServerOptions } from './server.ts'\n\nexport async function run(_argv?: string[], options?: import('./server.ts').ServerOptions): Promise<void> {\n await startServer(options)\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":["#emitter","NodeEventEmitter","#emitAll","process"],"sources":["../package.json","../../../internals/utils/src/errors.ts","../../../internals/utils/src/asyncEventEmitter.ts","../../../internals/utils/src/promise.ts","../../../internals/utils/src/runtime.ts","../src/constants.ts","../src/schemas/generateSchema.ts","../../../internals/shared/src/constants.ts","../../../internals/shared/src/init.ts","../../../internals/shared/src/loader.ts","../src/utils.ts","../src/tools/generate.ts","../src/schemas/initSchema.ts","../src/tools/init.ts","../src/schemas/validateSchema.ts","../src/tools/validate.ts","../src/server.ts","../src/index.ts"],"sourcesContent":["","/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n errors: Array<Error>\n\n constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n super(message, { cause: options.cause })\n this.name = 'BuildError'\n this.errors = options.errors\n }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n * throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string') // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n return error.cause instanceof Error ? error.cause : undefined\n}\n","import { EventEmitter as NodeEventEmitter } from 'node:events'\nimport { toError } from './errors.ts'\n\n/**\n * A function that can be registered as an event listener, synchronous or async.\n */\ntype AsyncListener<TArgs extends Array<unknown>> = (...args: TArgs) => void | Promise<void>\n\n/**\n * Typed `EventEmitter` that awaits all async listeners before resolving.\n * Wraps Node's `EventEmitter` with full TypeScript event-map inference.\n *\n * @example\n * ```ts\n * const emitter = new AsyncEventEmitter<{ build: [name: string] }>()\n * emitter.on('build', async (name) => { console.log(name) })\n * await emitter.emit('build', 'petstore') // all listeners awaited\n * ```\n */\nexport class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: Array<unknown> }> {\n /**\n * Maximum number of listeners per event before Node emits a memory-leak warning.\n * @default 10\n */\n constructor(maxListener = 10) {\n this.#emitter.setMaxListeners(maxListener)\n }\n\n #emitter = new NodeEventEmitter()\n\n /**\n * Emits `eventName` and awaits all registered listeners sequentially.\n * Throws if any listener rejects, wrapping the cause with the event name and serialized arguments.\n *\n * @example\n * ```ts\n * await emitter.emit('build', 'petstore')\n * ```\n */\n emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArgs: TEvents[TEventName]): Promise<void> | void {\n const listeners = this.#emitter.listeners(eventName) as Array<AsyncListener<TEvents[TEventName]>>\n\n if (listeners.length === 0) {\n return\n }\n\n return this.#emitAll(eventName, listeners, eventArgs)\n }\n\n async #emitAll<TEventName extends keyof TEvents & string>(\n eventName: TEventName,\n listeners: Array<AsyncListener<TEvents[TEventName]>>,\n eventArgs: TEvents[TEventName],\n ): Promise<void> {\n for (const listener of listeners) {\n try {\n await listener(...eventArgs)\n } catch (err) {\n let serializedArgs: string\n try {\n serializedArgs = JSON.stringify(eventArgs)\n } catch {\n serializedArgs = String(eventArgs)\n }\n throw new Error(`Error in async listener for \"${eventName}\" with eventArgs ${serializedArgs}`, { cause: toError(err) })\n }\n }\n }\n\n /**\n * Registers a persistent listener for `eventName`.\n *\n * @example\n * ```ts\n * emitter.on('build', async (name) => { console.log(name) })\n * ```\n */\n on<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n this.#emitter.on(eventName, handler as AsyncListener<Array<unknown>>)\n }\n\n /**\n * Registers a one-shot listener that removes itself after the first invocation.\n *\n * @example\n * ```ts\n * emitter.onOnce('build', async (name) => { console.log(name) })\n * ```\n */\n onOnce<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n const wrapper: AsyncListener<TEvents[TEventName]> = (...args) => {\n this.off(eventName, wrapper)\n return handler(...args)\n }\n this.on(eventName, wrapper)\n }\n\n /**\n * Removes a previously registered listener.\n *\n * @example\n * ```ts\n * emitter.off('build', handler)\n * ```\n */\n off<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n this.#emitter.off(eventName, handler as AsyncListener<Array<unknown>>)\n }\n\n /**\n * Returns the number of listeners registered for `eventName`.\n *\n * @example\n * ```ts\n * emitter.on('build', handler)\n * emitter.listenerCount('build') // 1\n * ```\n */\n listenerCount<TEventName extends keyof TEvents & string>(eventName: TEventName): number {\n return this.#emitter.listenerCount(eventName)\n }\n\n /**\n * Raises or lowers the per-event listener ceiling before Node warns about a memory leak.\n * Set this above the expected listener count when many listeners attach by design.\n *\n * @example\n * ```ts\n * emitter.setMaxListeners(40)\n * ```\n */\n setMaxListeners(max: number): void {\n this.#emitter.setMaxListeners(max)\n }\n\n /**\n * Returns the current per-event listener ceiling.\n */\n getMaxListeners(): number {\n return this.#emitter.getMaxListeners()\n }\n\n /**\n * Removes all listeners from every event channel.\n *\n * @example\n * ```ts\n * emitter.removeAll()\n * ```\n */\n removeAll(): void {\n this.#emitter.removeAllListeners()\n }\n}\n","function* chunks<T>(arr: ReadonlyArray<T>, size: number): Generator<Array<T>> {\n for (let i = 0; i < arr.length; i += size) {\n yield arr.slice(i, i + size)\n }\n}\n\nexport type ForBatchesOptions = {\n /**\n * Maximum batch size handed to `process`.\n * Parallel dispatch within a batch is the caller's responsibility\n * (typically via `Promise.all(batch.map(...))`).\n */\n concurrency: number\n /**\n * Called after every batch.\n *\n * Use a cheap, idempotent callback (e.g. one that short-circuits when there\n * is nothing new to do). The helper does not coalesce calls — if you need\n * throttling, do it inside `flush` itself.\n */\n flush?: () => Promise<void>\n}\n\n/**\n * Slices `source` into batches of `concurrency` items and awaits `process` for each batch.\n * Accepts both plain arrays (sync) and `AsyncIterable` (streaming).\n *\n * `process` controls whether items inside a batch run in parallel; this helper only\n * controls batch size and per-batch flushing.\n *\n * @example\n * ```ts\n * // parallel dispatch inside each batch\n * await forBatches(schemas, (batch) => Promise.all(batch.map(process)), { concurrency: 8 })\n *\n * // async iterable with a flush after every batch\n * await forBatches(stream.schemas, (batch) => dispatch(batch), { concurrency: 8, flush })\n * ```\n */\nexport async function forBatches<T>(\n source: ReadonlyArray<T> | AsyncIterable<T>,\n process: (batch: Array<T>) => Promise<unknown>,\n options: ForBatchesOptions,\n): Promise<void> {\n const { concurrency, flush } = options\n\n if (Array.isArray(source)) {\n for (const batch of chunks(source, concurrency)) {\n await process(batch)\n if (flush) await flush()\n }\n return\n }\n\n const batch: Array<T> = []\n for await (const item of source) {\n batch.push(item)\n if (batch.length >= concurrency) {\n await process(batch.splice(0))\n\n if (flush) await flush()\n }\n }\n if (batch.length > 0) {\n await process(batch.splice(0))\n\n if (flush) await flush()\n }\n}\n\n/** A value that may already be resolved or still pending.\n *\n * @example\n * ```ts\n * function load(id: string): PossiblePromise<string> {\n * return cache.get(id) ?? fetchRemote(id)\n * }\n * ```\n */\nexport type PossiblePromise<T> = Promise<T> | T\n\n/** Returns `true` when `result` is a thenable `Promise`.\n *\n * @example\n * ```ts\n * isPromise(Promise.resolve(1)) // true\n * isPromise(42) // false\n * ```\n */\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n return result !== null && result !== undefined && typeof (result as Record<string, unknown>)['then'] === 'function'\n}\n\n/** Returns `true` when `result` is a rejected `Promise.allSettled` result with a typed `reason`.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseRejectedResult<Error>).map((r) => r.reason.message)\n * ```\n */\nexport function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & { reason: T } {\n return result.status === 'rejected'\n}\n\ntype Store<TKey, TValue> = {\n has(key: TKey): boolean\n get(key: TKey): TValue | undefined\n set(key: TKey, value: TValue): unknown\n}\n\n/**\n * Wraps `factory` with a keyed cache backed by the provided store.\n *\n * Pass a `WeakMap` for object keys (results are GC-eligible when the key is\n * collected) or a `Map` for primitive keys. For multi-argument functions,\n * nest two `memoize` calls — the outer keyed by the first argument, the\n * inner (created once per outer miss) keyed by the second.\n *\n * Because the cache is owned by the caller, it can be shared, inspected, or\n * cleared independently of the memoized function.\n *\n * @example Single WeakMap key\n * ```ts\n * const cache = new WeakMap<SchemaNode, Set<string>>()\n * const getRefs = memoize(cache, (node) => collectRefs(node))\n * ```\n *\n * @example Single Map key (primitive)\n * ```ts\n * const cache = new Map<string, Resolver>()\n * const getResolver = memoize(cache, (name) => buildResolver(name))\n * ```\n *\n * @example Two-level (object + primitive)\n * ```ts\n * const outer = new WeakMap<Params[], Map<string, Params[]>>()\n * const fn = memoize(outer, (params) => memoize(new Map(), (key) => transform(params, key)))\n * fn(params)('camelcase')\n * ```\n */\nexport function memoize<TKey, TValue>(store: Store<TKey, TValue>, factory: (key: TKey) => TValue): (key: TKey) => TValue {\n return (key: TKey): TValue => {\n if (store.has(key)) return store.get(key)!\n const value = factory(key)\n store.set(key, value)\n return value\n }\n}\n\n/**\n * Container that switches between an eager `Array<T>` and a lazy `AsyncIterable<T>`.\n *\n * `Array<T>` by default. With `Stream` set to `true` it becomes `AsyncIterable<T>`, so large\n * collections can be produced lazily without holding every item in memory. Pairs with\n * {@link arrayToAsyncIterable}, which lifts a plain array into the streaming form.\n *\n * @example\n * ```ts\n * type Eager = Streamable<number> // Array<number>\n * type Lazy = Streamable<number, true> // AsyncIterable<number>\n * ```\n */\nexport type Streamable<T, Stream extends boolean = false> = Stream extends true ? AsyncIterable<T> : Array<T>\n\n/**\n * Wraps a plain array in a reusable `AsyncIterable`.\n * Each `[Symbol.asyncIterator]()` call returns a fresh generator so the\n * iterable can be consumed multiple times (e.g. once per plugin pre-scan).\n *\n * @example\n * ```ts\n * const stream = arrayToAsyncIterable([1, 2, 3])\n * for await (const n of stream) console.log(n) // 1, 2, 3\n * ```\n */\nexport function arrayToAsyncIterable<T>(arr: ReadonlyArray<T>): AsyncIterable<T> {\n return {\n [Symbol.asyncIterator]() {\n return (async function* () {\n yield* arr\n })()\n },\n }\n}\n","/**\n * Name of the JavaScript runtime executing the current process.\n */\ntype RuntimeName = 'bun' | 'deno' | 'node'\n\n/**\n * Detects the JavaScript runtime executing the current process and exposes its name and version.\n *\n * Prefer the shared {@link runtime} instance over constructing your own.\n */\nclass Runtime {\n /**\n * `true` when the current process is running under Bun.\n *\n * Detection keys off the global `Bun` object rather than `process.versions`,\n * because Bun polyfills `process.versions.node` for Node compatibility and would\n * otherwise look like Node.\n *\n * @example\n * ```ts\n * if (runtime.isBun) {\n * await Bun.write(path, data)\n * }\n * ```\n */\n get isBun(): boolean {\n return typeof Bun !== 'undefined'\n }\n\n /**\n * `true` when the current process is running under Deno.\n */\n get isDeno(): boolean {\n return typeof (globalThis as { Deno?: unknown }).Deno !== 'undefined'\n }\n\n /**\n * `true` when the current process is running under Node.\n *\n * Bun and Deno are excluded first so a polyfilled `process` does not register as Node.\n */\n get isNode(): boolean {\n return !this.isBun && !this.isDeno && typeof process !== 'undefined' && process.versions?.node != null\n }\n\n /**\n * Name of the runtime executing the current process.\n *\n * @example\n * ```ts\n * runtime.name // 'bun' when run with `bun kubb`, 'node' otherwise\n * ```\n */\n get name(): RuntimeName {\n if (this.isBun) return 'bun'\n if (this.isDeno) return 'deno'\n\n return 'node'\n }\n\n /**\n * Version of the active runtime, or an empty string when it cannot be read.\n *\n * @example\n * ```ts\n * runtime.version // '1.3.11' under Bun, '22.22.2' under Node\n * ```\n */\n get version(): string {\n if (this.isBun) return process.versions.bun ?? ''\n if (this.isDeno) return (globalThis as { Deno?: { version?: { deno?: string } } }).Deno?.version?.deno ?? ''\n\n return process.versions?.node ?? ''\n }\n}\n\n/**\n * Shared {@link Runtime} instance describing the JavaScript runtime executing the current process.\n */\nexport const runtime = new Runtime()\n","export const ALLOWED_CONFIG_EXTENSIONS = new Set(['.ts', '.mts', '.cts', '.js', '.mjs', '.cjs'])\n\nexport const NotifyTypes = {\n INFO: 'INFO',\n SUCCESS: 'SUCCESS',\n ERROR: 'ERROR',\n WARN: 'WARN',\n DIAGNOSTIC: 'DIAGNOSTIC',\n PLUGIN_START: 'PLUGIN_START',\n PLUGIN_END: 'PLUGIN_END',\n FILES_START: 'FILES_START',\n FILES_UPDATE: 'FILES_UPDATE',\n FILES_END: 'FILES_END',\n GENERATION_START: 'GENERATION_START',\n GENERATION_END: 'GENERATION_END',\n CONFIG_LOADED: 'CONFIG_LOADED',\n CONFIG_ERROR: 'CONFIG_ERROR',\n CONFIG_READY: 'CONFIG_READY',\n SETUP_START: 'SETUP_START',\n SETUP_END: 'SETUP_END',\n BUILD_START: 'BUILD_START',\n BUILD_END: 'BUILD_END',\n BUILD_FAILED: 'BUILD_FAILED',\n BUILD_SUCCESS: 'BUILD_SUCCESS',\n} as const\n","import * as v from 'valibot'\n\nexport const generateSchema = v.object({\n config: v.optional(\n v.pipe(v.string(), v.minLength(1), v.description('Path to kubb.config file (supports .ts, .js, .cjs). If not provided, will look for kubb.config.{ts,js,cjs} in current directory')),\n ),\n input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI/Swagger spec file (overrides config)'))),\n output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory path (overrides config)'))),\n logLevel: v.optional(\n v.pipe(v.picklist(['silent', 'info', 'verbose']), v.description('Log level for build output')),\n 'info',\n ),\n})\n","import type { PluginOption } from './types.ts'\n\nexport const KUBB_CONFIG_FILENAME = 'kubb.config.ts' as const\n\nexport const initDefaults = {\n inputPath: './openapi.yaml',\n outputPath: './src/gen',\n plugins: ['plugin-ts'],\n} as const\n\nexport const availablePlugins: Array<PluginOption> = [\n {\n value: 'plugin-ts',\n label: 'TypeScript',\n hint: 'Recommended',\n packageName: '@kubb/plugin-ts',\n importName: 'pluginTs',\n category: 'types',\n },\n {\n value: 'plugin-client',\n label: 'Client (Fetch/Axios)',\n packageName: '@kubb/plugin-client',\n importName: 'pluginClient',\n category: 'client',\n },\n {\n value: 'plugin-react-query',\n label: 'React Query / TanStack Query',\n packageName: '@kubb/plugin-react-query',\n importName: 'pluginReactQuery',\n category: 'framework',\n },\n {\n value: 'plugin-vue-query',\n label: 'Vue Query',\n packageName: '@kubb/plugin-vue-query',\n importName: 'pluginVueQuery',\n category: 'framework',\n },\n {\n value: 'plugin-zod',\n label: 'Zod Schemas',\n packageName: '@kubb/plugin-zod',\n importName: 'pluginZod',\n category: 'validation',\n },\n {\n value: 'plugin-faker',\n label: 'Faker.js Mocks',\n packageName: '@kubb/plugin-faker',\n importName: 'pluginFaker',\n category: 'mocks',\n },\n {\n value: 'plugin-msw',\n label: 'MSW Handlers',\n packageName: '@kubb/plugin-msw',\n importName: 'pluginMsw',\n category: 'mocks',\n },\n {\n value: 'plugin-cypress',\n label: 'Cypress Tests',\n packageName: '@kubb/plugin-cypress',\n importName: 'pluginCypress',\n category: 'testing',\n },\n {\n value: 'plugin-mcp',\n label: 'MCP Server (AI / Model Context Protocol)',\n packageName: '@kubb/plugin-mcp',\n importName: 'pluginMcp',\n category: 'ai',\n },\n {\n value: 'plugin-redoc',\n label: 'ReDoc Documentation',\n packageName: '@kubb/plugin-redoc',\n importName: 'pluginRedoc',\n category: 'documentation',\n },\n]\n\nexport const pluginDefaultConfigs = {\n 'plugin-ts': `pluginTs()`,\n 'plugin-client': `pluginClient()`,\n 'plugin-react-query': `pluginReactQuery()`,\n 'plugin-vue-query': `pluginVueQuery()`,\n 'plugin-zod': `pluginZod()`,\n 'plugin-faker': `pluginFaker()`,\n 'plugin-msw': `pluginMsw()`,\n 'plugin-cypress': `pluginCypress()`,\n 'plugin-mcp': `pluginMcp()`,\n 'plugin-redoc': `pluginRedoc()`,\n} as const satisfies Record<string, string>\n","import { pluginDefaultConfigs } from './constants.ts'\nimport type { PluginOption } from './types.ts'\n\nexport function generateConfigFile({\n selectedPlugins,\n inputPath,\n outputPath,\n}: {\n selectedPlugins: Array<PluginOption>\n inputPath: string\n outputPath: string\n}): string {\n const imports = selectedPlugins.map((plugin) => `import { ${plugin.importName} } from '${plugin.packageName}'`).join('\\n')\n\n const pluginConfigs = selectedPlugins\n .map((plugin) => {\n const config = (pluginDefaultConfigs as Record<string, string>)[plugin.value] ?? `${plugin.importName}()`\n return ` ${config},`\n })\n .join('\\n')\n\n return `import { defineConfig } from 'kubb'\n${imports}\n\nexport default defineConfig({\n root: '.',\n input: {\n path: '${inputPath}',\n },\n output: {\n path: '${outputPath}',\n clean: true,\n },\n plugins: [\n${pluginConfigs}\n ],\n})\n`\n}\n","import { pathToFileURL } from 'node:url'\nimport { runtime } from '@internals/utils'\nimport { createJiti } from 'jiti'\n\n/**\n * jiti options for loading Kubb config modules: the automatic JSX runtime pointed at\n * `@kubb/renderer-jsx`, and `moduleCache` off so a re-load re-evaluates the file.\n */\nconst JITI_OPTIONS = {\n jsx: { runtime: 'automatic', importSource: '@kubb/renderer-jsx' },\n moduleCache: false,\n} satisfies Parameters<typeof createJiti>[1]\n\n/**\n * Per-call options for {@link ModuleLoader.load}.\n */\nexport type LoadModuleOptions = {\n /**\n * Return the module's default export instead of the full namespace.\n */\n default?: boolean\n /**\n * Cache-bust token appended to the import URL on the native path so a repeated load re-evaluates\n * the file instead of returning the URL-cached module. Use a file's mtime in watch mode. Ignored\n * on the jiti path, which already re-evaluates because `moduleCache` is off.\n */\n bust?: string | number\n}\n\n/**\n * Loads `.ts`/`.js` modules with a runtime-aware strategy.\n */\nexport type ModuleLoader = {\n load<T = unknown>(filePath: string, options?: LoadModuleOptions): Promise<T>\n}\n\n/**\n * Creates a runtime-aware loader for Kubb's TypeScript and JavaScript config modules.\n *\n * On Bun and Deno it imports the file natively, skipping jiti's transform step, and falls back to\n * jiti only when the native import throws. On Node it always uses jiti, which transpiles TypeScript\n * and the `@kubb/renderer-jsx` JSX runtime on the fly. The jiti instance is created lazily, so the\n * Bun/Deno happy path never pays for it.\n *\n * @example\n * ```ts\n * const config = await createModuleLoader().load('/abs/kubb.config.ts', { default: true })\n * ```\n */\nexport function createModuleLoader(): ModuleLoader {\n let jiti: ReturnType<typeof createJiti> | undefined\n const getJiti = () => (jiti ??= createJiti(import.meta.url, JITI_OPTIONS))\n\n const viaJiti = <T>(filePath: string, options?: LoadModuleOptions) =>\n (options?.default ? getJiti().import(filePath, { default: true }) : getJiti().import(filePath)) as Promise<T>\n\n const viaNative = async <T>(filePath: string, options?: LoadModuleOptions): Promise<T> => {\n const href = pathToFileURL(filePath).href\n const url = options?.bust != null ? `${href}?t=${options.bust}` : href\n const mod = (await import(url)) as Record<string, unknown>\n return (options?.default ? (mod.default ?? mod) : mod) as T\n }\n\n return {\n async load(filePath, options) {\n if (runtime.isBun || runtime.isDeno) {\n try {\n return await viaNative(filePath, options)\n } catch {\n // A native import can trip over config-specific transforms (e.g. the @kubb/renderer-jsx\n // JSX runtime). Retry through jiti, which applies them and surfaces the real error if the\n // config itself is broken.\n return viaJiti(filePath, options)\n }\n }\n return viaJiti(filePath, options)\n },\n }\n}\n","import { existsSync } from 'node:fs'\nimport path from 'node:path'\nimport { createModuleLoader } from '@internals/shared'\nimport { isPromise } from '@internals/utils'\nimport type { CLIOptions, Config, PossibleConfig, SerializedDiagnostic } from '@kubb/core'\nimport { ALLOWED_CONFIG_EXTENSIONS, NotifyTypes } from './constants.ts'\n\n/**\n * Renders serialized diagnostics as a plain-text block for an AI assistant. Each entry\n * keeps the stable `code`, the source pointer, the suggested fix, and the docs link, so\n * the agent can act on the problem rather than parsing a bare message. No ANSI styling,\n * unlike the CLI renderer.\n */\nexport function formatDiagnostics(diagnostics: ReadonlyArray<SerializedDiagnostic>): string {\n return diagnostics.map((diagnostic) => formatDiagnostic(diagnostic)).join('\\n\\n')\n}\n\nfunction formatDiagnostic(diagnostic: SerializedDiagnostic): string {\n const { code, severity, message, location, help, plugin, docsUrl } = diagnostic\n const rule = plugin ? `${plugin}(${code})` : code\n const lines = [`${severity} ${rule}: ${message}`]\n\n if (location && 'pointer' in location) {\n lines.push(` at ${location.pointer}`)\n }\n if (help) {\n lines.push(` help: ${help}`)\n }\n if (docsUrl) {\n lines.push(` docs: ${docsUrl}`)\n }\n\n return lines.join('\\n')\n}\n\ntype NotifyFunction = (type: string, message: string, data?: Record<string, unknown>) => Promise<void>\n\nconst loader = createModuleLoader()\n\nconst loadedModules = new Map<string, unknown>()\n\nasync function loadModule(filePath: string): Promise<unknown> {\n const ext = path.extname(filePath)\n if (!ALLOWED_CONFIG_EXTENSIONS.has(ext)) {\n throw new Error(`Invalid config file extension \"${ext}\". Allowed: ${[...ALLOWED_CONFIG_EXTENSIONS].join(', ')}`)\n }\n if (loadedModules.has(filePath)) {\n return loadedModules.get(filePath)\n }\n const mod = await loader.load(filePath, { default: true })\n loadedModules.set(filePath, mod)\n return mod\n}\n\nexport async function loadUserConfig(configPath: string | undefined, { notify }: { notify: NotifyFunction }): Promise<{ userConfig: Config; cwd: string }> {\n if (configPath) {\n const ext = path.extname(configPath)\n if (!ALLOWED_CONFIG_EXTENSIONS.has(ext)) {\n const msg = `Invalid config file extension \"${ext}\". Allowed: ${[...ALLOWED_CONFIG_EXTENSIONS].join(', ')}`\n await notify(NotifyTypes.CONFIG_ERROR, msg)\n throw new Error(msg)\n }\n const base = path.resolve(process.cwd())\n const resolvedConfigPath = path.resolve(base, configPath)\n const relative = path.relative(base, resolvedConfigPath)\n if (relative.startsWith('..') || path.isAbsolute(relative)) {\n const msg = 'Invalid config file path: must be within the current working directory'\n await notify(NotifyTypes.CONFIG_ERROR, msg)\n throw new Error(msg)\n }\n const cwd = path.dirname(resolvedConfigPath)\n try {\n const userConfig = (await loadModule(resolvedConfigPath)) as Config\n await notify(NotifyTypes.CONFIG_LOADED, `Loaded config from ${resolvedConfigPath}`)\n return { userConfig, cwd }\n } catch (error) {\n const msg = `Failed to load config: ${error instanceof Error ? error.message : String(error)}`\n await notify(NotifyTypes.CONFIG_ERROR, msg)\n throw new Error(msg)\n }\n }\n\n const cwd = process.cwd()\n const configFileNames = ['kubb.config.ts', 'kubb.config.mts', 'kubb.config.cts', 'kubb.config.js', 'kubb.config.cjs']\n\n for (const configFileName of configFileNames) {\n const configFilePath = path.resolve(process.cwd(), configFileName)\n if (!existsSync(configFilePath)) continue\n try {\n const userConfig = (await loadModule(configFilePath)) as Config\n await notify(NotifyTypes.CONFIG_LOADED, `Loaded ${configFileName} from current directory`)\n return { userConfig, cwd }\n } catch (err) {\n await notify(NotifyTypes.CONFIG_ERROR, `Failed to load ${configFileName}: ${err instanceof Error ? err.message : String(err)}`)\n }\n }\n\n await notify(NotifyTypes.CONFIG_ERROR, 'No config file found')\n throw new Error(`No config file found. Please provide a config path or create one of: ${configFileNames.join(', ')}`)\n}\n\n/**\n * Determine the root directory based on userConfig.root and resolvedConfigDir\n * 1. If userConfig.root exists and is absolute, use it as-is\n * 2. If userConfig.root exists and is relative, resolve it relative to config directory\n * 3. Otherwise, use the config directory as root\n */\nexport function resolveCwd(userConfig: Config, cwd: string): string {\n if (userConfig.root) {\n if (path.isAbsolute(userConfig.root)) {\n return userConfig.root\n }\n\n return path.resolve(cwd, userConfig.root)\n }\n\n return cwd\n}\n\nexport type ResolveUserConfigOptions = {\n configPath?: string\n logLevel?: string\n}\n\nexport async function resolveUserConfig(config: PossibleConfig<CLIOptions>, options: ResolveUserConfigOptions): Promise<Config> {\n const result = typeof config === 'function' ? config({ logLevel: options.logLevel as CLIOptions['logLevel'], config: options.configPath }) : config\n const resolved = isPromise(result) ? await result : result\n return (Array.isArray(resolved) ? resolved[0] : resolved) as Config\n}\n","import { AsyncEventEmitter } from '@internals/utils'\nimport { type Config, createKubb, type Diagnostic, Diagnostics, type KubbHooks } from '@kubb/core'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport type * as v from 'valibot'\nimport { NotifyTypes } from '../constants.ts'\nimport { generateSchema } from '../schemas/generateSchema.ts'\nimport { formatDiagnostics, loadUserConfig, resolveCwd, resolveUserConfig } from '../utils.ts'\n\nexport const generateTool = defineTool(\n {\n name: 'generate',\n description: 'Generate OpenAPI spec helpers using Kubb configuration',\n schema: generateSchema,\n },\n async function generate(schema: v.InferInput<typeof generateSchema>) {\n const { config: configPath, input, output, logLevel } = schema\n\n try {\n const hooks = new AsyncEventEmitter<KubbHooks>()\n const messages: Array<string> = []\n\n const notify = async (type: string, message: string, data?: Record<string, unknown>) => {\n messages.push(data ? `${type}: ${message} ${JSON.stringify(data)}` : `${type}: ${message}`)\n }\n\n hooks.on('kubb:info', async ({ message }: { message: string }) => {\n await notify(NotifyTypes.INFO, message)\n })\n\n hooks.on('kubb:success', async ({ message }: { message: string }) => {\n await notify(NotifyTypes.SUCCESS, message)\n })\n\n hooks.on('kubb:error', async ({ error }: { error: Error }) => {\n await notify(NotifyTypes.ERROR, error.message)\n })\n\n hooks.on('kubb:warn', async ({ message }: { message: string }) => {\n await notify(NotifyTypes.WARN, message)\n })\n\n hooks.on('kubb:diagnostic', async ({ diagnostic }: { diagnostic: Diagnostic }) => {\n await notify(NotifyTypes.DIAGNOSTIC, diagnostic.message, Diagnostics.serialize(diagnostic))\n })\n\n hooks.on('kubb:plugin:start', async ({ plugin }) => {\n await notify(NotifyTypes.PLUGIN_START, `Plugin starting: ${plugin.name}`)\n })\n\n hooks.on('kubb:plugin:end', async ({ plugin, duration }) => {\n await notify(NotifyTypes.PLUGIN_END, `Plugin finished: ${plugin.name}`, { duration })\n })\n\n hooks.on('kubb:files:processing:start', async () => {\n await notify(NotifyTypes.FILES_START, 'Starting file processing')\n })\n\n hooks.on('kubb:files:processing:update', async ({ files }: { files: Array<{ file: { name: string } }> }) => {\n await notify(NotifyTypes.FILES_UPDATE, `Processing ${files.length} files`)\n })\n\n hooks.on('kubb:files:processing:end', async () => {\n await notify(NotifyTypes.FILES_END, 'File processing complete')\n })\n\n hooks.on('kubb:generation:start', async () => {\n await notify(NotifyTypes.GENERATION_START, 'Generation started')\n })\n\n hooks.on('kubb:generation:end', async () => {\n await notify(NotifyTypes.GENERATION_END, 'Generation ended')\n })\n\n let userConfig: Config\n let cwd: string\n\n try {\n const configResult = await loadUserConfig(configPath, { notify })\n userConfig = configResult.userConfig\n cwd = configResult.cwd\n\n if (Array.isArray(userConfig)) {\n throw new Error('Array type in kubb.config.ts is not supported in this tool. Please provide a single configuration object.')\n }\n\n userConfig = await resolveUserConfig(userConfig, {\n configPath,\n logLevel,\n })\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error)\n await notify(NotifyTypes.CONFIG_ERROR, errorMessage)\n return tool.error(errorMessage)\n }\n\n const inputPath = input ?? (userConfig.input && 'path' in userConfig.input ? userConfig.input.path : undefined)\n\n const config: Config = {\n ...userConfig,\n root: resolveCwd(userConfig, cwd),\n input: inputPath\n ? {\n ...userConfig.input,\n path: inputPath,\n }\n : userConfig.input,\n output: output\n ? {\n ...userConfig.output,\n path: output,\n }\n : userConfig.output,\n }\n\n await notify(NotifyTypes.CONFIG_READY, 'Configuration ready')\n await notify(NotifyTypes.SETUP_START, 'Setting up Kubb')\n\n const kubb = createKubb(config, { hooks })\n await kubb.setup()\n await notify(NotifyTypes.SETUP_END, 'Kubb setup complete')\n\n await notify(NotifyTypes.BUILD_START, 'Starting build')\n const { files, diagnostics } = await kubb.safeBuild()\n await notify(NotifyTypes.BUILD_END, `Build complete - Generated ${files.length} files`)\n\n const problems = diagnostics.filter(Diagnostics.isProblem)\n const errors = problems.filter((diagnostic) => diagnostic.severity === 'error')\n if (errors.length > 0) {\n await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${errors.length} diagnostic(s)`)\n\n const serialized = problems.map((diagnostic) => Diagnostics.serialize(diagnostic))\n return tool.error(`Build failed:\\n${formatDiagnostics(serialized)}\\n\\n\\`\\`\\`json\\n${JSON.stringify(serialized, null, 2)}\\n\\`\\`\\``)\n }\n\n await notify(NotifyTypes.BUILD_SUCCESS, `Build completed successfully - Generated ${files.length} files`)\n\n return tool.text(`Build completed successfully!\\n\\nGenerated ${files.length} files\\n\\n${messages.join('\\n')}`)\n } catch (caughtError) {\n const serialized = Diagnostics.serialize(Diagnostics.from(caughtError))\n return tool.error(`Build error:\\n${formatDiagnostics([serialized])}\\n\\n\\`\\`\\`json\\n${JSON.stringify(serialized, null, 2)}\\n\\`\\`\\``)\n }\n },\n)\n","import * as v from 'valibot'\n\nexport const initSchema = v.object({\n input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI spec (default: ./openapi.yaml)'))),\n output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory (default: ./src/gen)'))),\n plugins: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Comma-separated list of plugins: plugin-ts,plugin-zod,...'))),\n})\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { availablePlugins, generateConfigFile, KUBB_CONFIG_FILENAME, type PluginOption } from '@internals/shared'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport { initSchema } from '../schemas/initSchema.ts'\n\nexport function resolvePlugins(pluginsFlag: string | undefined): Array<PluginOption> {\n if (!pluginsFlag) {\n return []\n }\n const requested = pluginsFlag\n .split(',')\n .map((v) => v.trim())\n .filter(Boolean)\n return availablePlugins.filter((p) => requested.includes(p.value))\n}\n\nexport const initTool = defineTool(\n {\n name: 'init',\n description: 'Scaffold a kubb.config.ts in the current directory (non-interactive). Does not install packages.',\n schema: initSchema,\n },\n async ({ input = './openapi.yaml', output = './src/gen', plugins }) => {\n const selected = resolvePlugins(plugins)\n const content = generateConfigFile({ selectedPlugins: selected, inputPath: input, outputPath: output })\n const dest = path.join(process.cwd(), KUBB_CONFIG_FILENAME)\n if (fs.existsSync(dest)) {\n return tool.error(`${KUBB_CONFIG_FILENAME} already exists at ${dest}. Delete it first before running init again.`)\n }\n fs.writeFileSync(dest, content, 'utf-8')\n const packageList = ['kubb', ...selected.map((p) => p.packageName)].join(' ')\n return tool.text(`Created kubb.config.ts\\n\\nInstall packages:\\n npm install ${packageList}\\n\\nThen run:\\n npx kubb generate`)\n },\n)\n","import * as v from 'valibot'\n\nexport const validateSchema = v.object({\n input: v.pipe(v.string(), v.minLength(1), v.description('Path or URL to the OpenAPI/Swagger specification')),\n})\n","import { Diagnostics } from '@kubb/core'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport { validateSchema } from '../schemas/validateSchema.ts'\nimport { formatDiagnostics } from '../utils.ts'\n\nexport const validateTool = defineTool(\n {\n name: 'validate',\n description: 'Validate an OpenAPI/Swagger specification file or URL',\n schema: validateSchema,\n },\n async ({ input }) => {\n let mod: typeof import('@kubb/adapter-oas')\n try {\n mod = await import('@kubb/adapter-oas')\n } catch {\n return tool.error('The validate tool requires @kubb/adapter-oas.\\nInstall: npm install @kubb/adapter-oas')\n }\n try {\n await mod.adapterOas().validate(input, { throwOnError: true })\n return tool.text(`Validation successful: ${input}`)\n } catch (err) {\n const serialized = Diagnostics.serialize(Diagnostics.from(err))\n return tool.error(`Validation failed:\\n${formatDiagnostics([serialized])}\\n\\n\\`\\`\\`json\\n${JSON.stringify(serialized, null, 2)}\\n\\`\\`\\``)\n }\n },\n)\n","import http from 'node:http'\nimport { createRequestListener } from '@remix-run/node-fetch-server'\nimport { ValibotJsonSchemaAdapter } from '@tmcp/adapter-valibot'\nimport { HttpTransport } from '@tmcp/transport-http'\nimport { StdioTransport } from '@tmcp/transport-stdio'\nimport { McpServer } from 'tmcp'\nimport { version } from '../package.json'\nimport { generateTool } from './tools/generate.ts'\nimport { initTool } from './tools/init.ts'\nimport { validateTool } from './tools/validate.ts'\n\nexport type ServerOptions = {\n port?: number\n host?: string\n}\n\nexport function createMcpServer() {\n const server = new McpServer({ name: 'Kubb', version }, { adapter: new ValibotJsonSchemaAdapter(), capabilities: { tools: {} } })\n server.tools([generateTool, validateTool, initTool])\n return server\n}\n\nexport async function startServer({ port, host = 'localhost' }: ServerOptions = {}) {\n const server = createMcpServer()\n\n if (port === undefined) {\n new StdioTransport(server).listen()\n return\n }\n\n const transport = new HttpTransport(server, { path: '/mcp' })\n const httpServer = http.createServer(\n createRequestListener(async (request) => {\n const response = await transport.respond(request)\n return response ?? new Response('Not Found', { status: 404 })\n }),\n )\n httpServer.listen(port, host, () => {\n console.log(`Kubb MCP server on http://${host}:${port}`)\n })\n\n const closeServer = () => httpServer.close()\n process.once('SIGINT', closeServer)\n process.once('SIGTERM', closeServer)\n httpServer.once('close', () => {\n process.off('SIGINT', closeServer)\n process.off('SIGTERM', closeServer)\n })\n}\n","import { startServer } from './server.ts'\n\nexport { createMcpServer } from './server.ts'\nexport type { ServerOptions } from './server.ts'\n\nexport async function run(_argv?: Array<string>, options?: import('./server.ts').ServerOptions): Promise<void> {\n await startServer(options)\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,17 +1,15 @@
1
1
  {
2
2
  "name": "@kubb/mcp",
3
- "version": "5.0.0-beta.6",
4
- "description": "Model Context Protocol (MCP) server for Kubb, enabling AI assistants to generate code from OpenAPI specifications.",
3
+ "version": "5.0.0-beta.61",
4
+ "description": "MCP server for Kubb. Exposes code generation as a tool over the Model Context Protocol so AI assistants like Claude, Cursor, and other MCP-compatible clients can generate TypeScript types, clients, and more from OpenAPI specs.",
5
5
  "keywords": [
6
6
  "ai",
7
- "code-generation",
8
7
  "codegen",
9
8
  "kubb",
10
9
  "llm",
11
10
  "mcp",
12
11
  "model-context-protocol",
13
12
  "openapi",
14
- "swagger",
15
13
  "typescript"
16
14
  ],
17
15
  "license": "MIT",
@@ -49,44 +47,38 @@
49
47
  "registry": "https://registry.npmjs.org/"
50
48
  },
51
49
  "dependencies": {
52
- "@remix-run/node-fetch-server": "^0.13.0",
53
- "@tmcp/adapter-valibot": "^0.1.5",
54
- "@tmcp/transport-http": "^0.8.5",
55
- "@tmcp/transport-stdio": "^0.4.2",
50
+ "@remix-run/node-fetch-server": "^0.13.3",
51
+ "@tmcp/adapter-valibot": "^0.1.6",
52
+ "@tmcp/transport-http": "^0.8.6",
53
+ "@tmcp/transport-stdio": "^0.4.3",
56
54
  "jiti": "^2.7.0",
57
- "tmcp": "^1.19.3",
58
- "valibot": "^1.1.0",
59
- "@kubb/adapter-oas": "5.0.0-beta.6",
60
- "@kubb/core": "5.0.0-beta.6"
55
+ "tmcp": "^1.19.4",
56
+ "valibot": "^1.4.1",
57
+ "@kubb/core": "5.0.0-beta.61",
58
+ "@kubb/adapter-oas": "5.0.0-beta.61"
61
59
  },
62
60
  "devDependencies": {
63
61
  "@internals/shared": "0.0.0",
64
- "@internals/utils": "0.0.0",
65
- "@kubb/renderer-jsx": "5.0.0-beta.6"
62
+ "@kubb/renderer-jsx": "5.0.0-beta.61",
63
+ "@internals/utils": "0.0.0"
66
64
  },
67
65
  "peerDependencies": {
68
- "@kubb/renderer-jsx": "5.0.0-beta.6"
66
+ "@kubb/renderer-jsx": "5.0.0-beta.61"
69
67
  },
70
- "size-limit": [
71
- {
72
- "path": "./dist/*.js",
73
- "limit": "600 KiB",
74
- "gzip": true
75
- }
76
- ],
77
68
  "engines": {
78
69
  "node": ">=22"
79
70
  },
80
71
  "scripts": {
81
- "build": "tsdown && size-limit",
82
- "start:mcp": "bun --watch ./src/server.ts",
72
+ "build": "tsdown",
73
+ "clean": "node -e \"require('node:fs').rmSync('./dist', {recursive:true,force:true})\"",
83
74
  "debug:mcp": "npx -y @modelcontextprotocol/inspector node ./bin/kubb-mcp.cjs",
84
- "clean": "npx rimraf ./dist",
85
75
  "lint": "oxlint .",
86
76
  "lint:fix": "oxlint --fix .",
87
77
  "release": "pnpm publish --no-git-check",
88
78
  "release:canary": "bash ../../.github/canary.sh && node ../../scripts/build.js canary && pnpm publish --no-git-check",
79
+ "release:stage": "pnpm stage publish --no-git-check",
89
80
  "start": "tsdown --watch",
81
+ "start:mcp": "bun --watch ./src/server.ts",
90
82
  "test": "vitest --passWithNoTests",
91
83
  "typecheck": "tsc -p ./tsconfig.json --noEmit --emitDeclarationOnly false"
92
84
  }
package/src/constants.ts CHANGED
@@ -1 +1,25 @@
1
1
  export const ALLOWED_CONFIG_EXTENSIONS = new Set(['.ts', '.mts', '.cts', '.js', '.mjs', '.cjs'])
2
+
3
+ export const NotifyTypes = {
4
+ INFO: 'INFO',
5
+ SUCCESS: 'SUCCESS',
6
+ ERROR: 'ERROR',
7
+ WARN: 'WARN',
8
+ DIAGNOSTIC: 'DIAGNOSTIC',
9
+ PLUGIN_START: 'PLUGIN_START',
10
+ PLUGIN_END: 'PLUGIN_END',
11
+ FILES_START: 'FILES_START',
12
+ FILES_UPDATE: 'FILES_UPDATE',
13
+ FILES_END: 'FILES_END',
14
+ GENERATION_START: 'GENERATION_START',
15
+ GENERATION_END: 'GENERATION_END',
16
+ CONFIG_LOADED: 'CONFIG_LOADED',
17
+ CONFIG_ERROR: 'CONFIG_ERROR',
18
+ CONFIG_READY: 'CONFIG_READY',
19
+ SETUP_START: 'SETUP_START',
20
+ SETUP_END: 'SETUP_END',
21
+ BUILD_START: 'BUILD_START',
22
+ BUILD_END: 'BUILD_END',
23
+ BUILD_FAILED: 'BUILD_FAILED',
24
+ BUILD_SUCCESS: 'BUILD_SUCCESS',
25
+ } as const
package/src/index.ts CHANGED
@@ -3,6 +3,6 @@ import { startServer } from './server.ts'
3
3
  export { createMcpServer } from './server.ts'
4
4
  export type { ServerOptions } from './server.ts'
5
5
 
6
- export async function run(_argv?: string[], options?: import('./server.ts').ServerOptions): Promise<void> {
6
+ export async function run(_argv?: Array<string>, options?: import('./server.ts').ServerOptions): Promise<void> {
7
7
  await startServer(options)
8
8
  }
package/src/schemas/generateSchema.ts CHANGED
@@ -7,7 +7,7 @@ export const generateSchema = v.object({
7
7
  input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI/Swagger spec file (overrides config)'))),
8
8
  output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory path (overrides config)'))),
9
9
  logLevel: v.optional(
10
- v.pipe(v.picklist(['silent', 'error', 'warn', 'info', 'verbose', 'debug']), v.description('Log level for build output')),
10
+ v.pipe(v.picklist(['silent', 'info', 'verbose']), v.description('Log level for build output')),
11
11
  'info',
12
12
  ),
13
13
  })
package/src/server.ts CHANGED
@@ -15,7 +15,7 @@ export type ServerOptions = {
15
15
  }
16
16
 
17
17
  export function createMcpServer() {
18
- const server = new McpServer({ name: 'Kubb', version }, { adapter: new ValibotJsonSchemaAdapter() })
18
+ const server = new McpServer({ name: 'Kubb', version }, { adapter: new ValibotJsonSchemaAdapter(), capabilities: { tools: {} } })
19
19
  server.tools([generateTool, validateTool, initTool])
20
20
  return server
21
21
  }
@@ -38,4 +38,12 @@ export async function startServer({ port, host = 'localhost' }: ServerOptions =
38
38
  httpServer.listen(port, host, () => {
39
39
  console.log(`Kubb MCP server on http://${host}:${port}`)
40
40
  })
41
+
42
+ const closeServer = () => httpServer.close()
43
+ process.once('SIGINT', closeServer)
44
+ process.once('SIGTERM', closeServer)
45
+ httpServer.once('close', () => {
46
+ process.off('SIGINT', closeServer)
47
+ process.off('SIGTERM', closeServer)
48
+ })
41
49
  }
package/src/tools/generate.ts CHANGED
@@ -1,13 +1,11 @@
1
- import { AsyncEventEmitter, toError } from '@internals/utils'
2
- import { type Config, createKubb, type KubbHooks } from '@kubb/core'
1
+ import { AsyncEventEmitter } from '@internals/utils'
2
+ import { type Config, createKubb, type Diagnostic, Diagnostics, type KubbHooks } from '@kubb/core'
3
3
  import { defineTool } from 'tmcp/tool'
4
4
  import { tool } from 'tmcp/utils'
5
5
  import type * as v from 'valibot'
6
+ import { NotifyTypes } from '../constants.ts'
6
7
  import { generateSchema } from '../schemas/generateSchema.ts'
7
- import { NotifyTypes } from '../types.ts'
8
- import { loadUserConfig } from '../utils/loadUserConfig.ts'
9
- import { resolveCwd } from '../utils/resolveCwd.ts'
10
- import { resolveUserConfig } from '../utils/resolveUserConfig.ts'
8
+ import { formatDiagnostics, loadUserConfig, resolveCwd, resolveUserConfig } from '../utils.ts'
11
9
 
12
10
  export const generateTool = defineTool(
13
11
  {
@@ -20,10 +18,10 @@ export const generateTool = defineTool(
20
18
 
21
19
  try {
22
20
  const hooks = new AsyncEventEmitter<KubbHooks>()
23
- const messages: string[] = []
21
+ const messages: Array<string> = []
24
22
 
25
- const notify = async (type: string, message: string, _data?: Record<string, unknown>) => {
26
- messages.push(`${type}: ${message}`)
23
+ const notify = async (type: string, message: string, data?: Record<string, unknown>) => {
24
+ messages.push(data ? `${type}: ${message} ${JSON.stringify(data)}` : `${type}: ${message}`)
27
25
  }
28
26
 
29
27
  hooks.on('kubb:info', async ({ message }: { message: string }) => {
@@ -42,6 +40,10 @@ export const generateTool = defineTool(
42
40
  await notify(NotifyTypes.WARN, message)
43
41
  })
44
42
 
43
+ hooks.on('kubb:diagnostic', async ({ diagnostic }: { diagnostic: Diagnostic }) => {
44
+ await notify(NotifyTypes.DIAGNOSTIC, diagnostic.message, Diagnostics.serialize(diagnostic))
45
+ })
46
+
45
47
  hooks.on('kubb:plugin:start', async ({ plugin }) => {
46
48
  await notify(NotifyTypes.PLUGIN_START, `Plugin starting: ${plugin.name}`)
47
49
  })
@@ -54,8 +56,8 @@ export const generateTool = defineTool(
54
56
  await notify(NotifyTypes.FILES_START, 'Starting file processing')
55
57
  })
56
58
 
57
- hooks.on('kubb:file:processing:update', async ({ file }: { file: { name: string } }) => {
58
- await notify(NotifyTypes.FILE_UPDATE, `Processing file: ${file.name}`)
59
+ hooks.on('kubb:files:processing:update', async ({ files }: { files: Array<{ file: { name: string } }> }) => {
60
+ await notify(NotifyTypes.FILES_UPDATE, `Processing ${files.length} files`)
59
61
  })
60
62
 
61
63
  hooks.on('kubb:files:processing:end', async () => {
@@ -119,28 +121,24 @@ export const generateTool = defineTool(
119
121
  await notify(NotifyTypes.SETUP_END, 'Kubb setup complete')
120
122
 
121
123
  await notify(NotifyTypes.BUILD_START, 'Starting build')
122
- const { files, failedPlugins, error } = await kubb.safeBuild()
124
+ const { files, diagnostics } = await kubb.safeBuild()
123
125
  await notify(NotifyTypes.BUILD_END, `Build complete - Generated ${files.length} files`)
124
126
 
125
- if (error || failedPlugins.size > 0) {
126
- const allErrors: Error[] = [
127
- error,
128
- ...Array.from(failedPlugins)
129
- .filter((it) => it.error)
130
- .map((it) => it.error),
131
- ].filter(Boolean)
132
-
133
- await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${allErrors.length} error(s)`)
127
+ const problems = diagnostics.filter(Diagnostics.isProblem)
128
+ const errors = problems.filter((diagnostic) => diagnostic.severity === 'error')
129
+ if (errors.length > 0) {
130
+ await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${errors.length} diagnostic(s)`)
134
131
 
135
- return tool.error(`Build failed:\n${allErrors.map((err) => err.message).join('\n')}\n\n${messages.join('\n')}`)
132
+ const serialized = problems.map((diagnostic) => Diagnostics.serialize(diagnostic))
133
+ return tool.error(`Build failed:\n${formatDiagnostics(serialized)}\n\n\`\`\`json\n${JSON.stringify(serialized, null, 2)}\n\`\`\``)
136
134
  }
137
135
 
138
136
  await notify(NotifyTypes.BUILD_SUCCESS, `Build completed successfully - Generated ${files.length} files`)
139
137
 
140
138
  return tool.text(`Build completed successfully!\n\nGenerated ${files.length} files\n\n${messages.join('\n')}`)
141
139
  } catch (caughtError) {
142
- const error = toError(caughtError)
143
- return tool.error(`Build error: ${error.message}\n${error.stack ?? ''}`)
140
+ const serialized = Diagnostics.serialize(Diagnostics.from(caughtError))
141
+ return tool.error(`Build error:\n${formatDiagnostics([serialized])}\n\n\`\`\`json\n${JSON.stringify(serialized, null, 2)}\n\`\`\``)
144
142
  }
145
143
  },
146
144
  )
package/src/tools/init.ts CHANGED
@@ -6,7 +6,7 @@ import { defineTool } from 'tmcp/tool'
6
6
  import { tool } from 'tmcp/utils'
7
7
  import { initSchema } from '../schemas/initSchema.ts'
8
8
 
9
- export function resolvePlugins(pluginsFlag: string | undefined): PluginOption[] {
9
+ export function resolvePlugins(pluginsFlag: string | undefined): Array<PluginOption> {
10
10
  if (!pluginsFlag) {
11
11
  return []
12
12
  }
package/src/tools/validate.ts CHANGED
@@ -1,6 +1,8 @@
1
+ import { Diagnostics } from '@kubb/core'
1
2
  import { defineTool } from 'tmcp/tool'
2
3
  import { tool } from 'tmcp/utils'
3
4
  import { validateSchema } from '../schemas/validateSchema.ts'
5
+ import { formatDiagnostics } from '../utils.ts'
4
6
 
5
7
  export const validateTool = defineTool(
6
8
  {
@@ -19,7 +21,8 @@ export const validateTool = defineTool(
19
21
  await mod.adapterOas().validate(input, { throwOnError: true })
20
22
  return tool.text(`Validation successful: ${input}`)
21
23
  } catch (err) {
22
- return tool.error(`Validation failed:\n${err instanceof Error ? err.message : String(err)}`)
24
+ const serialized = Diagnostics.serialize(Diagnostics.from(err))
25
+ return tool.error(`Validation failed:\n${formatDiagnostics([serialized])}\n\n\`\`\`json\n${JSON.stringify(serialized, null, 2)}\n\`\`\``)
23
26
  }
24
27
  },
25
28
  )
package/src/{utils/loadUserConfig.ts → utils.ts} RENAMED
@@ -1,19 +1,41 @@
1
1
  import { existsSync } from 'node:fs'
2
2
  import path from 'node:path'
3
- import type { Config } from '@kubb/core'
4
- import { createJiti } from 'jiti'
5
- import { ALLOWED_CONFIG_EXTENSIONS } from '../constants.ts'
6
- import { NotifyTypes } from '../types.ts'
3
+ import { createModuleLoader } from '@internals/shared'
4
+ import { isPromise } from '@internals/utils'
5
+ import type { CLIOptions, Config, PossibleConfig, SerializedDiagnostic } from '@kubb/core'
6
+ import { ALLOWED_CONFIG_EXTENSIONS, NotifyTypes } from './constants.ts'
7
+
8
+ /**
9
+ * Renders serialized diagnostics as a plain-text block for an AI assistant. Each entry
10
+ * keeps the stable `code`, the source pointer, the suggested fix, and the docs link, so
11
+ * the agent can act on the problem rather than parsing a bare message. No ANSI styling,
12
+ * unlike the CLI renderer.
13
+ */
14
+ export function formatDiagnostics(diagnostics: ReadonlyArray<SerializedDiagnostic>): string {
15
+ return diagnostics.map((diagnostic) => formatDiagnostic(diagnostic)).join('\n\n')
16
+ }
17
+
18
+ function formatDiagnostic(diagnostic: SerializedDiagnostic): string {
19
+ const { code, severity, message, location, help, plugin, docsUrl } = diagnostic
20
+ const rule = plugin ? `${plugin}(${code})` : code
21
+ const lines = [`${severity} ${rule}: ${message}`]
22
+
23
+ if (location && 'pointer' in location) {
24
+ lines.push(` at ${location.pointer}`)
25
+ }
26
+ if (help) {
27
+ lines.push(` help: ${help}`)
28
+ }
29
+ if (docsUrl) {
30
+ lines.push(` docs: ${docsUrl}`)
31
+ }
32
+
33
+ return lines.join('\n')
34
+ }
7
35
 
8
36
  type NotifyFunction = (type: string, message: string, data?: Record<string, unknown>) => Promise<void>
9
37
 
10
- const jiti = createJiti(import.meta.url, {
11
- jsx: {
12
- runtime: 'automatic',
13
- importSource: '@kubb/renderer-jsx',
14
- },
15
- moduleCache: false,
16
- })
38
+ const loader = createModuleLoader()
17
39
 
18
40
  const loadedModules = new Map<string, unknown>()
19
41
 
@@ -25,7 +47,7 @@ async function loadModule(filePath: string): Promise<unknown> {
25
47
  if (loadedModules.has(filePath)) {
26
48
  return loadedModules.get(filePath)
27
49
  }
28
- const mod = await jiti.import(filePath, { default: true })
50
+ const mod = await loader.load(filePath, { default: true })
29
51
  loadedModules.set(filePath, mod)
30
52
  return mod
31
53
  }
@@ -76,3 +98,32 @@ export async function loadUserConfig(configPath: string | undefined, { notify }:
76
98
  await notify(NotifyTypes.CONFIG_ERROR, 'No config file found')
77
99
  throw new Error(`No config file found. Please provide a config path or create one of: ${configFileNames.join(', ')}`)
78
100
  }
101
+
102
+ /**
103
+ * Determine the root directory based on userConfig.root and resolvedConfigDir
104
+ * 1. If userConfig.root exists and is absolute, use it as-is
105
+ * 2. If userConfig.root exists and is relative, resolve it relative to config directory
106
+ * 3. Otherwise, use the config directory as root
107
+ */
108
+ export function resolveCwd(userConfig: Config, cwd: string): string {
109
+ if (userConfig.root) {
110
+ if (path.isAbsolute(userConfig.root)) {
111
+ return userConfig.root
112
+ }
113
+
114
+ return path.resolve(cwd, userConfig.root)
115
+ }
116
+
117
+ return cwd
118
+ }
119
+
120
+ export type ResolveUserConfigOptions = {
121
+ configPath?: string
122
+ logLevel?: string
123
+ }
124
+
125
+ export async function resolveUserConfig(config: PossibleConfig<CLIOptions>, options: ResolveUserConfigOptions): Promise<Config> {
126
+ const result = typeof config === 'function' ? config({ logLevel: options.logLevel as CLIOptions['logLevel'], config: options.configPath }) : config
127
+ const resolved = isPromise(result) ? await result : result
128
+ return (Array.isArray(resolved) ? resolved[0] : resolved) as Config
129
+ }
package/src/types.ts DELETED
@@ -1,23 +0,0 @@
1
- export const NotifyTypes = {
2
- INFO: 'INFO',
3
- SUCCESS: 'SUCCESS',
4
- ERROR: 'ERROR',
5
- WARN: 'WARN',
6
- PLUGIN_START: 'PLUGIN_START',
7
- PLUGIN_END: 'PLUGIN_END',
8
- FILES_START: 'FILES_START',
9
- FILE_UPDATE: 'FILE_UPDATE',
10
- FILES_END: 'FILES_END',
11
- GENERATION_START: 'GENERATION_START',
12
- GENERATION_END: 'GENERATION_END',
13
- CONFIG_LOADED: 'CONFIG_LOADED',
14
- CONFIG_ERROR: 'CONFIG_ERROR',
15
- CONFIG_READY: 'CONFIG_READY',
16
- SETUP_START: 'SETUP_START',
17
- SETUP_END: 'SETUP_END',
18
- BUILD_START: 'BUILD_START',
19
- BUILD_END: 'BUILD_END',
20
- BUILD_FAILED: 'BUILD_FAILED',
21
- BUILD_SUCCESS: 'BUILD_SUCCESS',
22
- FATAL_ERROR: 'FATAL_ERROR',
23
- } as const