@kubb/core 5.0.0-beta.7 → 5.0.0-beta.71

package/src/mocks.ts

@@ -1,178 +0,0 @@
-import { resolve } from 'node:path'
-import type { FileNode, OperationNode, SchemaNode, Visitor } from '@kubb/ast'
-import { transform } from '@kubb/ast'
-import { FileManager } from './FileManager.ts'
-import { PluginDriver } from './PluginDriver.ts'
-import { applyHookResult } from './renderNode.ts'
-import type { Adapter, AdapterFactoryOptions, Config, Generator, GeneratorContext, NormalizedPlugin, PluginFactoryOptions } from './types.ts'
-
-/**
-
- * Creates a minimal `PluginDriver` mock for unit tests.
- */
-export function createMockedPluginDriver(options: { name?: string; plugin?: NormalizedPlugin; config?: Config } = {}): PluginDriver {
-  return {
-    config: options?.config ?? {
-      root: '.',
-      output: {
-        path: './path',
-      },
-    },
-    getPlugin(_pluginName: string): NormalizedPlugin | undefined {
-      return options?.plugin
-    },
-    getResolver: (_pluginName: string) => options?.plugin?.resolver,
-    fileManager: new FileManager(),
-  } as unknown as PluginDriver
-}
-
-/**
- * Creates a minimal `Adapter` mock for unit tests.
- * `parse` returns an empty `InputNode` by default; override via `options.parse`.
- * `getImports` returns `[]` by default.
- */
-export function createMockedAdapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions>(
-  options: {
-    name?: TOptions['name']
-    resolvedOptions?: TOptions['resolvedOptions']
-    inputNode?: Adapter<TOptions>['inputNode']
-    parse?: Adapter<TOptions>['parse']
-    getImports?: Adapter<TOptions>['getImports']
-  } = {},
-): Adapter<TOptions> {
-  const inputNode = options.inputNode ?? null
-  return {
-    name: (options.name ?? 'oas') as TOptions['name'],
-    options: (options.resolvedOptions ?? {}) as TOptions['resolvedOptions'],
-    inputNode,
-    parse: options.parse ?? (async () => ({ kind: 'Input' as const, schemas: [], operations: [] })),
-    getImports: options.getImports ?? ((_node: SchemaNode, _resolve: (schemaName: string) => { name: string; path: string }) => []),
-  } as Adapter<TOptions>
-}
-
-/**
- * Creates a minimal plugin mock for unit tests.
- *
- * @example
- * `const plugin = createMockedPlugin<PluginTs>({ name: '@kubb/plugin-ts', options })`
- */
-export function createMockedPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(params: {
-  name: TOptions['name']
-  options: TOptions['resolvedOptions']
-  resolver?: TOptions['resolver']
-  transformer?: Visitor
-  dependencies?: Array<string>
-}): NormalizedPlugin<TOptions> {
-  return {
-    name: params.name,
-    options: params.options,
-    resolver: params.resolver,
-    transformer: params.transformer,
-    dependencies: params.dependencies,
-    hooks: {},
-  } as unknown as NormalizedPlugin<TOptions>
-}
-
-type RenderGeneratorOptions<TOptions extends PluginFactoryOptions> = {
-  config: Config
-  adapter: Adapter
-  driver: PluginDriver
-  plugin: NormalizedPlugin<TOptions>
-  options: TOptions['resolvedOptions']
-  resolver: TOptions['resolver']
-}
-
-function createMockedPluginContext<TOptions extends PluginFactoryOptions>(opts: RenderGeneratorOptions<TOptions>): Omit<GeneratorContext<TOptions>, 'options'> {
-  const root = resolve(opts.config.root, opts.config.output.path)
-
-  return {
-    config: opts.config,
-    root,
-    getMode: (output: { path: string }) => PluginDriver.getMode(resolve(root, output.path)),
-    adapter: opts.adapter,
-    resolver: opts.resolver,
-    plugin: opts.plugin,
-    driver: opts.driver,
-    getResolver: (name: string) => opts.driver.getResolver(name),
-    inputNode: { kind: 'Input', schemas: [], operations: [] },
-    addFile: async (...files: Array<FileNode>) => opts.driver.fileManager.add(...files),
-    upsertFile: async (...files: Array<FileNode>) => opts.driver.fileManager.upsert(...files),
-    hooks: opts.driver.hooks ?? ({} as never),
-    warn: (msg: string) => console.warn(msg),
-    error: (msg: string) => console.error(msg),
-    info: (msg: string) => console.info(msg),
-    openInStudio: async () => {},
-  } as unknown as Omit<GeneratorContext<TOptions>, 'options'>
-}
-
-/**
- * Renders a generator's `schema` method in a test context.
- *
- * @example
- * ```ts
- * await renderGeneratorSchema(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
- * await matchFiles(driver.fileManager.files)
- * ```
- */
-export async function renderGeneratorSchema<TOptions extends PluginFactoryOptions>(
-  generator: Generator<TOptions>,
-  node: SchemaNode,
-  opts: RenderGeneratorOptions<TOptions>,
-): Promise<void> {
-  if (!generator.schema) return
-  const context = createMockedPluginContext(opts)
-  const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node
-  const result = await generator.schema(transformedNode, {
-    ...context,
-    options: opts.options,
-  })
-  await applyHookResult(result, opts.driver, generator.renderer ?? undefined)
-}
-
-/**
- * Renders a generator's `operation` method in a test context.
- *
- * @example
- * ```ts
- * await renderGeneratorOperation(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
- * await matchFiles(driver.fileManager.files)
- * ```
- */
-export async function renderGeneratorOperation<TOptions extends PluginFactoryOptions>(
-  generator: Generator<TOptions>,
-  node: OperationNode,
-  opts: RenderGeneratorOptions<TOptions>,
-): Promise<void> {
-  if (!generator.operation) return
-  const context = createMockedPluginContext(opts)
-  const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node
-  const result = await generator.operation(transformedNode, {
-    ...context,
-    options: opts.options,
-  })
-  await applyHookResult(result, opts.driver, generator.renderer ?? undefined)
-}
-
-/**
- * Renders a generator's `operations` method in a test context.
- *
- * @example
- * ```ts
- * await renderGeneratorOperations(classClientGenerator, nodes, { config, adapter, driver, plugin, options, resolver })
- * await matchFiles(driver.fileManager.files)
- * ```
- */
-export async function renderGeneratorOperations<TOptions extends PluginFactoryOptions>(
-  generator: Generator<TOptions>,
-  nodes: Array<OperationNode>,
-  opts: RenderGeneratorOptions<TOptions>,
-): Promise<void> {
-  if (!generator.operations) return
-  const context = createMockedPluginContext(opts)
-  const transformedNodes = opts.plugin.transformer ? nodes.map((n) => transform(n, opts.plugin.transformer!)) : nodes
-  const result = await generator.operations(transformedNodes, {
-    ...context,
-    options: opts.options,
-  })
-  await applyHookResult(result, opts.driver, generator.renderer ?? undefined)
-}

package/src/renderNode.ts

@@ -1,35 +0,0 @@
-import type { FileNode } from '@kubb/ast'
-import type { RendererFactory } from './createRenderer.ts'
-import type { PluginDriver } from './PluginDriver.ts'
-
-/**
- * Handles the return value of a plugin AST hook or generator method.
- *
- * - Renderer output → rendered via the provided `rendererFactory` (e.g. JSX), files stored in `driver.fileManager`
- * - `Array<FileNode>` → added directly into `driver.fileManager`
- * - `void` / `null` / `undefined` → no-op (plugin handled it via `this.upsertFile`)
- *
- * Pass a `rendererFactory` (e.g. `jsxRenderer` from `@kubb/renderer-jsx`) when the result
- * may be a renderer element. Generators that only return `Array<FileNode>` do not need one.
- */
-export async function applyHookResult<TElement = unknown>(
-  result: TElement | Array<FileNode> | void,
-  driver: PluginDriver,
-  rendererFactory?: RendererFactory<TElement>,
-): Promise<void> {
-  if (!result) return
-
-  if (Array.isArray(result)) {
-    driver.fileManager.upsert(...(result as Array<FileNode>))
-    return
-  }
-
-  if (!rendererFactory) {
-    return
-  }
-
-  const renderer = rendererFactory()
-  await renderer.render(result)
-  driver.fileManager.upsert(...renderer.files)
-  renderer.unmount()
-}

package/src/storages/fsStorage.ts

@@ -1,114 +0,0 @@
-import type { Dirent } from 'node:fs'
-import { access, readdir, readFile, rm } from 'node:fs/promises'
-import { join, resolve } from 'node:path'
-import { clean, write } from '@internals/utils'
-import { createStorage } from '../createStorage.ts'
-
-/**
- * Detects the filesystem error used to indicate that a path does not exist.
- */
-function isMissingPathError(error: unknown): error is NodeJS.ErrnoException {
-  return typeof error === 'object' && error !== null && 'code' in error && (error as NodeJS.ErrnoException).code === 'ENOENT'
-}
-
-/**
- * Built-in filesystem storage driver.
- *
- * This is the default storage when no `storage` option is configured in the root config.
- * Keys are resolved against `process.cwd()`, so root-relative paths such as
- * `src/gen/api/getPets.ts` are written to the correct location without extra configuration.
- *
- * Internally uses the `write` utility from `@internals/utils`, which:
- * - trims leading/trailing whitespace before writing
- * - skips the write when file content is already identical (deduplication)
- * - creates missing parent directories automatically
- * - supports Bun's native file API when running under Bun
- *
- * @example
- * ```ts
- * import { fsStorage } from '@kubb/core'
- * import { defineConfig } from 'kubb'
- *
- * export default defineConfig({
- *   input:  { path: './petStore.yaml' },
- *   output: { path: './src/gen' },
- *   storage: fsStorage(),
- * })
- * ```
- */
-export const fsStorage = createStorage(() => ({
-  name: 'fs',
-  async hasItem(key: string) {
-    try {
-      await access(resolve(key))
-      return true
-    } catch (error) {
-      if (isMissingPathError(error)) {
-        return false
-      }
-
-      throw new Error(`Failed to access storage item "${key}"`, {
-        cause: error as Error,
-      })
-    }
-  },
-  async getItem(key: string) {
-    try {
-      return await readFile(resolve(key), 'utf8')
-    } catch (error) {
-      if (isMissingPathError(error)) {
-        return null
-      }
-
-      throw new Error(`Failed to read storage item "${key}"`, {
-        cause: error as Error,
-      })
-    }
-  },
-  async setItem(key: string, value: string) {
-    await write(resolve(key), value, { sanity: false })
-  },
-  async removeItem(key: string) {
-    await rm(resolve(key), { force: true })
-  },
-  async getKeys(base?: string) {
-    const keys: Array<string> = []
-    const resolvedBase = resolve(base ?? process.cwd())
-
-    async function walk(dir: string, prefix: string): Promise<void> {
-      let entries: Array<Dirent>
-      try {
-        entries = (await readdir(dir, {
-          withFileTypes: true,
-        })) as Array<Dirent>
-      } catch (error) {
-        if (isMissingPathError(error)) {
-          return
-        }
-
-        throw new Error(`Failed to list storage keys under "${resolvedBase}"`, {
-          cause: error as Error,
-        })
-      }
-      for (const entry of entries) {
-        const rel = prefix ? `${prefix}/${entry.name}` : entry.name
-        if (entry.isDirectory()) {
-          await walk(join(dir, entry.name), rel)
-        } else {
-          keys.push(rel)
-        }
-      }
-    }
-
-    await walk(resolvedBase, '')
-
-    return keys
-  },
-  async clear(base?: string) {
-    if (!base) {
-      return
-    }
-
-    await clean(resolve(base))
-  },
-}))

package/src/storages/memoryStorage.ts

@@ -1,55 +0,0 @@
-import { createStorage } from '../createStorage.ts'
-
-/**
- * In-memory storage driver. Useful for testing and dry-run scenarios where
- * generated output should be captured without touching the filesystem.
- *
- * All data lives in a `Map` scoped to the storage instance and is discarded
- * when the instance is garbage-collected.
- *
- * @example
- * ```ts
- * import { memoryStorage } from '@kubb/core'
- * import { defineConfig } from 'kubb'
- *
- * export default defineConfig({
- *   input:  { path: './petStore.yaml' },
- *   output: { path: './src/gen' },
- *   storage: memoryStorage(),
- * })
- * ```
- */
-export const memoryStorage = createStorage(() => {
-  const store = new Map<string, string>()
-
-  return {
-    name: 'memory',
-    async hasItem(key: string) {
-      return store.has(key)
-    },
-    async getItem(key: string) {
-      return store.get(key) ?? null
-    },
-    async setItem(key: string, value: string) {
-      store.set(key, value)
-    },
-    async removeItem(key: string) {
-      store.delete(key)
-    },
-    async getKeys(base?: string) {
-      const keys = [...store.keys()]
-      return base ? keys.filter((k) => k.startsWith(base)) : keys
-    },
-    async clear(base?: string) {
-      if (!base) {
-        store.clear()
-        return
-      }
-      for (const key of store.keys()) {
-        if (key.startsWith(base)) {
-          store.delete(key)
-        }
-      }
-    },
-  }
-})