@kubb/mcp 5.0.0-beta.62 → 5.0.0-beta.64

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 (17) hide show
  1. package/dist/index.cjs +50 -32
  2. package/dist/index.cjs.map +1 -1
  3. package/dist/index.d.ts +13 -7
  4. package/dist/index.js +51 -32
  5. package/dist/index.js.map +1 -1
  6. package/package.json +5 -8
  7. package/src/constants.ts +0 -25
  8. package/src/index.ts +0 -8
  9. package/src/schemas/generateSchema.ts +0 -13
  10. package/src/schemas/initSchema.ts +0 -7
  11. package/src/schemas/validateSchema.ts +0 -5
  12. package/src/server.ts +0 -49
  13. package/src/tools/generate.ts +0 -144
  14. package/src/tools/init.ts +0 -37
  15. package/src/tools/validate.ts +0 -28
  16. package/src/utils.ts +0 -129
  17. /package/dist/{chunk-C0LytTxp.js → rolldown-runtime-C0LytTxp.js} +0 -0
package/dist/index.js.map CHANGED
@@ -1 +1 @@
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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"}
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","/**\n * File extensions a Kubb config is allowed to use. A config path with any other\n * extension is rejected before it is loaded.\n */\nexport const ALLOWED_CONFIG_EXTENSIONS = new Set(['.ts', '.mts', '.cts', '.js', '.mjs', '.cjs'])\n\n/**\n * Notification kinds reported back to the MCP client while loading config and\n * running generation, covering progress, results, and errors.\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, message, location, help, plugin, docsUrl } = diagnostic\n const lines = [plugin ? `[${code}] ${plugin}: ${message}` : `[${code}]: ${message}`]\n\n if (location && 'pointer' in location) {\n lines.push(` at: ${location.pointer}`)\n }\n if (help) {\n lines.push(` fix: ${help}`)\n }\n if (docsUrl) {\n lines.push(` see: ${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\n/**\n * Loads the user's Kubb config and returns it with the directory it was found in.\n *\n * When `configPath` is given it must use an allowed extension and resolve inside\n * the current working directory, otherwise loading throws. When omitted, the\n * known `kubb.config.*` file names are tried in the current directory. Every\n * outcome is reported through `notify` before the function returns or throws.\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\n/**\n * Inputs forwarded to a config when it is defined as a function.\n */\nexport type ResolveUserConfigOptions = {\n /**\n * Path of the loaded config, passed through to the config function as `config`.\n */\n configPath?: string\n /**\n * Log level passed through to the config function.\n */\n logLevel?: string\n}\n\n/**\n * Normalizes a possible config into a single resolved `Config`.\n *\n * Calls the config when it is a function, awaits it when it is a promise, and\n * picks the first entry when it resolves to an array.\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\n/**\n * Resolves a comma-separated plugin flag into the matching known plugin options.\n * Unrecognized names are dropped, and a missing flag yields an empty list.\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 { ValibotJsonSchemaAdapter } from '@tmcp/adapter-valibot'\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\n/**\n * Builds the Kubb MCP server with the generate, validate, and init tools registered.\n *\n * @example\n * `const server = createMcpServer()`\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\n/**\n * Starts the Kubb MCP server over stdio, the transport every local MCP client\n * (Claude, Copilot, editors) uses when it launches the server as a subprocess.\n */\nexport async function startServer() {\n new StdioTransport(createMcpServer()).listen()\n}\n","import { startServer } from './server.ts'\n\nexport { createMcpServer } from './server.ts'\n\n/**\n * Entry point that starts the MCP server over stdio. The argument is accepted\n * for CLI parity but ignored.\n */\nexport async function run(_argv?: Array<string>): Promise<void> {\n await startServer()\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kubb/mcp",
3
- "version": "5.0.0-beta.62",
3
+ "version": "5.0.0-beta.64",
4
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",
@@ -23,7 +23,6 @@
23
23
  "kubb-mcp": "bin/kubb-mcp.cjs"
24
24
  },
25
25
  "files": [
26
- "src",
27
26
  "dist",
28
27
  "bin",
29
28
  "!/**/**.test.**",
@@ -47,23 +46,21 @@
47
46
  "registry": "https://registry.npmjs.org/"
48
47
  },
49
48
  "dependencies": {
50
- "@remix-run/node-fetch-server": "^0.13.3",
51
49
  "@tmcp/adapter-valibot": "^0.1.6",
52
- "@tmcp/transport-http": "^0.8.6",
53
50
  "@tmcp/transport-stdio": "^0.4.3",
54
51
  "jiti": "^2.7.0",
55
52
  "tmcp": "^1.19.4",
56
53
  "valibot": "^1.4.1",
57
- "@kubb/adapter-oas": "5.0.0-beta.62",
58
- "@kubb/core": "5.0.0-beta.62"
54
+ "@kubb/adapter-oas": "5.0.0-beta.64",
55
+ "@kubb/core": "5.0.0-beta.64"
59
56
  },
60
57
  "devDependencies": {
61
58
  "@internals/shared": "0.0.0",
62
59
  "@internals/utils": "0.0.0",
63
- "@kubb/renderer-jsx": "5.0.0-beta.62"
60
+ "@kubb/renderer-jsx": "5.0.0-beta.64"
64
61
  },
65
62
  "peerDependencies": {
66
- "@kubb/renderer-jsx": "5.0.0-beta.62"
63
+ "@kubb/renderer-jsx": "5.0.0-beta.64"
67
64
  },
68
65
  "engines": {
69
66
  "node": ">=22"
package/src/constants.ts DELETED
@@ -1,25 +0,0 @@
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 DELETED
@@ -1,8 +0,0 @@
1
- import { startServer } from './server.ts'
2
-
3
- export { createMcpServer } from './server.ts'
4
- export type { ServerOptions } from './server.ts'
5
-
6
- export async function run(_argv?: Array<string>, options?: import('./server.ts').ServerOptions): Promise<void> {
7
- await startServer(options)
8
- }
package/src/schemas/generateSchema.ts DELETED
@@ -1,13 +0,0 @@
1
- import * as v from 'valibot'
2
-
3
- export const generateSchema = v.object({
4
- config: v.optional(
5
- 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')),
6
- ),
7
- input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI/Swagger spec file (overrides config)'))),
8
- output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory path (overrides config)'))),
9
- logLevel: v.optional(
10
- v.pipe(v.picklist(['silent', 'info', 'verbose']), v.description('Log level for build output')),
11
- 'info',
12
- ),
13
- })
package/src/schemas/initSchema.ts DELETED
@@ -1,7 +0,0 @@
1
- import * as v from 'valibot'
2
-
3
- export const initSchema = v.object({
4
- input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI spec (default: ./openapi.yaml)'))),
5
- output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory (default: ./src/gen)'))),
6
- plugins: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Comma-separated list of plugins: plugin-ts,plugin-zod,...'))),
7
- })
package/src/schemas/validateSchema.ts DELETED
@@ -1,5 +0,0 @@
1
- import * as v from 'valibot'
2
-
3
- export const validateSchema = v.object({
4
- input: v.pipe(v.string(), v.minLength(1), v.description('Path or URL to the OpenAPI/Swagger specification')),
5
- })
package/src/server.ts DELETED
@@ -1,49 +0,0 @@
1
- import http from 'node:http'
2
- import { createRequestListener } from '@remix-run/node-fetch-server'
3
- import { ValibotJsonSchemaAdapter } from '@tmcp/adapter-valibot'
4
- import { HttpTransport } from '@tmcp/transport-http'
5
- import { StdioTransport } from '@tmcp/transport-stdio'
6
- import { McpServer } from 'tmcp'
7
- import { version } from '../package.json'
8
- import { generateTool } from './tools/generate.ts'
9
- import { initTool } from './tools/init.ts'
10
- import { validateTool } from './tools/validate.ts'
11
-
12
- export type ServerOptions = {
13
- port?: number
14
- host?: string
15
- }
16
-
17
- export function createMcpServer() {
18
- const server = new McpServer({ name: 'Kubb', version }, { adapter: new ValibotJsonSchemaAdapter(), capabilities: { tools: {} } })
19
- server.tools([generateTool, validateTool, initTool])
20
- return server
21
- }
22
-
23
- export async function startServer({ port, host = 'localhost' }: ServerOptions = {}) {
24
- const server = createMcpServer()
25
-
26
- if (port === undefined) {
27
- new StdioTransport(server).listen()
28
- return
29
- }
30
-
31
- const transport = new HttpTransport(server, { path: '/mcp' })
32
- const httpServer = http.createServer(
33
- createRequestListener(async (request) => {
34
- const response = await transport.respond(request)
35
- return response ?? new Response('Not Found', { status: 404 })
36
- }),
37
- )
38
- httpServer.listen(port, host, () => {
39
- console.log(`Kubb MCP server on http://${host}:${port}`)
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
- })
49
- }
package/src/tools/generate.ts DELETED
@@ -1,144 +0,0 @@
1
- import { AsyncEventEmitter } from '@internals/utils'
2
- import { type Config, createKubb, type Diagnostic, Diagnostics, type KubbHooks } from '@kubb/core'
3
- import { defineTool } from 'tmcp/tool'
4
- import { tool } from 'tmcp/utils'
5
- import type * as v from 'valibot'
6
- import { NotifyTypes } from '../constants.ts'
7
- import { generateSchema } from '../schemas/generateSchema.ts'
8
- import { formatDiagnostics, loadUserConfig, resolveCwd, resolveUserConfig } from '../utils.ts'
9
-
10
- export const generateTool = defineTool(
11
- {
12
- name: 'generate',
13
- description: 'Generate OpenAPI spec helpers using Kubb configuration',
14
- schema: generateSchema,
15
- },
16
- async function generate(schema: v.InferInput<typeof generateSchema>) {
17
- const { config: configPath, input, output, logLevel } = schema
18
-
19
- try {
20
- const hooks = new AsyncEventEmitter<KubbHooks>()
21
- const messages: Array<string> = []
22
-
23
- const notify = async (type: string, message: string, data?: Record<string, unknown>) => {
24
- messages.push(data ? `${type}: ${message} ${JSON.stringify(data)}` : `${type}: ${message}`)
25
- }
26
-
27
- hooks.on('kubb:info', async ({ message }: { message: string }) => {
28
- await notify(NotifyTypes.INFO, message)
29
- })
30
-
31
- hooks.on('kubb:success', async ({ message }: { message: string }) => {
32
- await notify(NotifyTypes.SUCCESS, message)
33
- })
34
-
35
- hooks.on('kubb:error', async ({ error }: { error: Error }) => {
36
- await notify(NotifyTypes.ERROR, error.message)
37
- })
38
-
39
- hooks.on('kubb:warn', async ({ message }: { message: string }) => {
40
- await notify(NotifyTypes.WARN, message)
41
- })
42
-
43
- hooks.on('kubb:diagnostic', async ({ diagnostic }: { diagnostic: Diagnostic }) => {
44
- await notify(NotifyTypes.DIAGNOSTIC, diagnostic.message, Diagnostics.serialize(diagnostic))
45
- })
46
-
47
- hooks.on('kubb:plugin:start', async ({ plugin }) => {
48
- await notify(NotifyTypes.PLUGIN_START, `Plugin starting: ${plugin.name}`)
49
- })
50
-
51
- hooks.on('kubb:plugin:end', async ({ plugin, duration }) => {
52
- await notify(NotifyTypes.PLUGIN_END, `Plugin finished: ${plugin.name}`, { duration })
53
- })
54
-
55
- hooks.on('kubb:files:processing:start', async () => {
56
- await notify(NotifyTypes.FILES_START, 'Starting file processing')
57
- })
58
-
59
- hooks.on('kubb:files:processing:update', async ({ files }: { files: Array<{ file: { name: string } }> }) => {
60
- await notify(NotifyTypes.FILES_UPDATE, `Processing ${files.length} files`)
61
- })
62
-
63
- hooks.on('kubb:files:processing:end', async () => {
64
- await notify(NotifyTypes.FILES_END, 'File processing complete')
65
- })
66
-
67
- hooks.on('kubb:generation:start', async () => {
68
- await notify(NotifyTypes.GENERATION_START, 'Generation started')
69
- })
70
-
71
- hooks.on('kubb:generation:end', async () => {
72
- await notify(NotifyTypes.GENERATION_END, 'Generation ended')
73
- })
74
-
75
- let userConfig: Config
76
- let cwd: string
77
-
78
- try {
79
- const configResult = await loadUserConfig(configPath, { notify })
80
- userConfig = configResult.userConfig
81
- cwd = configResult.cwd
82
-
83
- if (Array.isArray(userConfig)) {
84
- throw new Error('Array type in kubb.config.ts is not supported in this tool. Please provide a single configuration object.')
85
- }
86
-
87
- userConfig = await resolveUserConfig(userConfig, {
88
- configPath,
89
- logLevel,
90
- })
91
- } catch (error) {
92
- const errorMessage = error instanceof Error ? error.message : String(error)
93
- await notify(NotifyTypes.CONFIG_ERROR, errorMessage)
94
- return tool.error(errorMessage)
95
- }
96
-
97
- const inputPath = input ?? (userConfig.input && 'path' in userConfig.input ? userConfig.input.path : undefined)
98
-
99
- const config: Config = {
100
- ...userConfig,
101
- root: resolveCwd(userConfig, cwd),
102
- input: inputPath
103
- ? {
104
- ...userConfig.input,
105
- path: inputPath,
106
- }
107
- : userConfig.input,
108
- output: output
109
- ? {
110
- ...userConfig.output,
111
- path: output,
112
- }
113
- : userConfig.output,
114
- }
115
-
116
- await notify(NotifyTypes.CONFIG_READY, 'Configuration ready')
117
- await notify(NotifyTypes.SETUP_START, 'Setting up Kubb')
118
-
119
- const kubb = createKubb(config, { hooks })
120
- await kubb.setup()
121
- await notify(NotifyTypes.SETUP_END, 'Kubb setup complete')
122
-
123
- await notify(NotifyTypes.BUILD_START, 'Starting build')
124
- const { files, diagnostics } = await kubb.safeBuild()
125
- await notify(NotifyTypes.BUILD_END, `Build complete - Generated ${files.length} files`)
126
-
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)`)
131
-
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\`\`\``)
134
- }
135
-
136
- await notify(NotifyTypes.BUILD_SUCCESS, `Build completed successfully - Generated ${files.length} files`)
137
-
138
- return tool.text(`Build completed successfully!\n\nGenerated ${files.length} files\n\n${messages.join('\n')}`)
139
- } catch (caughtError) {
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\`\`\``)
142
- }
143
- },
144
- )
package/src/tools/init.ts DELETED
@@ -1,37 +0,0 @@
1
- import fs from 'node:fs'
2
- import path from 'node:path'
3
- import process from 'node:process'
4
- import { availablePlugins, generateConfigFile, KUBB_CONFIG_FILENAME, type PluginOption } from '@internals/shared'
5
- import { defineTool } from 'tmcp/tool'
6
- import { tool } from 'tmcp/utils'
7
- import { initSchema } from '../schemas/initSchema.ts'
8
-
9
- export function resolvePlugins(pluginsFlag: string | undefined): Array<PluginOption> {
10
- if (!pluginsFlag) {
11
- return []
12
- }
13
- const requested = pluginsFlag
14
- .split(',')
15
- .map((v) => v.trim())
16
- .filter(Boolean)
17
- return availablePlugins.filter((p) => requested.includes(p.value))
18
- }
19
-
20
- export const initTool = defineTool(
21
- {
22
- name: 'init',
23
- description: 'Scaffold a kubb.config.ts in the current directory (non-interactive). Does not install packages.',
24
- schema: initSchema,
25
- },
26
- async ({ input = './openapi.yaml', output = './src/gen', plugins }) => {
27
- const selected = resolvePlugins(plugins)
28
- const content = generateConfigFile({ selectedPlugins: selected, inputPath: input, outputPath: output })
29
- const dest = path.join(process.cwd(), KUBB_CONFIG_FILENAME)
30
- if (fs.existsSync(dest)) {
31
- return tool.error(`${KUBB_CONFIG_FILENAME} already exists at ${dest}. Delete it first before running init again.`)
32
- }
33
- fs.writeFileSync(dest, content, 'utf-8')
34
- const packageList = ['kubb', ...selected.map((p) => p.packageName)].join(' ')
35
- return tool.text(`Created kubb.config.ts\n\nInstall packages:\n npm install ${packageList}\n\nThen run:\n npx kubb generate`)
36
- },
37
- )
package/src/tools/validate.ts DELETED
@@ -1,28 +0,0 @@
1
- import { Diagnostics } from '@kubb/core'
2
- import { defineTool } from 'tmcp/tool'
3
- import { tool } from 'tmcp/utils'
4
- import { validateSchema } from '../schemas/validateSchema.ts'
5
- import { formatDiagnostics } from '../utils.ts'
6
-
7
- export const validateTool = defineTool(
8
- {
9
- name: 'validate',
10
- description: 'Validate an OpenAPI/Swagger specification file or URL',
11
- schema: validateSchema,
12
- },
13
- async ({ input }) => {
14
- let mod: typeof import('@kubb/adapter-oas')
15
- try {
16
- mod = await import('@kubb/adapter-oas')
17
- } catch {
18
- return tool.error('The validate tool requires @kubb/adapter-oas.\nInstall: npm install @kubb/adapter-oas')
19
- }
20
- try {
21
- await mod.adapterOas().validate(input, { throwOnError: true })
22
- return tool.text(`Validation successful: ${input}`)
23
- } catch (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\`\`\``)
26
- }
27
- },
28
- )