@kubb/core 4.24.1 → 4.25.1

package/dist/utils.js

@@ -6,6 +6,7 @@ import { orderBy } from "natural-orderby";
 import { fileURLToPath } from "node:url";
 import { readFileSync } from "node:fs";
 import dns from "node:dns";
+import { execaCommand } from "execa";
 import createJiti from "jiti";
 
 //#region src/utils/buildJSDoc.ts
@@ -161,6 +162,132 @@ var FunctionParams = class FunctionParams {
 	}
 };
 
+//#endregion
+//#region src/utils/formatters.ts
+const formatters = {
+	prettier: {
+		command: "prettier",
+		args: (outputPath) => [
+			"--ignore-unknown",
+			"--write",
+			outputPath
+		],
+		errorMessage: "Prettier not found"
+	},
+	biome: {
+		command: "biome",
+		args: (outputPath) => [
+			"format",
+			"--write",
+			outputPath
+		],
+		errorMessage: "Biome not found"
+	},
+	oxfmt: {
+		command: "oxfmt",
+		args: (outputPath) => [outputPath],
+		errorMessage: "Oxfmt not found"
+	}
+};
+/**
+* Check if a formatter command is available in the system.
+*
+* @param formatter - The formatter to check ('biome', 'prettier', or 'oxfmt')
+* @returns Promise that resolves to true if the formatter is available, false otherwise
+*
+* @remarks
+* This function checks availability by running `<formatter> --version` command.
+* All supported formatters (biome, prettier, oxfmt) implement the --version flag.
+*/
+async function isFormatterAvailable(formatter) {
+	try {
+		await execaCommand(`${formatter} --version`, { stdio: "ignore" });
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* Detect which formatter is available in the system.
+*
+* @returns Promise that resolves to the first available formatter or undefined if none are found
+*
+* @remarks
+* Checks in order of preference: biome, oxfmt, prettier.
+* Uses the `--version` flag to detect if each formatter command is available.
+* This is a reliable method as all supported formatters implement this flag.
+*
+* @example
+* ```typescript
+* const formatter = await detectFormatter()
+* if (formatter) {
+*   console.log(`Using ${formatter} for formatting`)
+* } else {
+*   console.log('No formatter found')
+* }
+* ```
+*/
+async function detectFormatter() {
+	for (const formatter of [
+		"biome",
+		"oxfmt",
+		"prettier"
+	]) if (await isFormatterAvailable(formatter)) return formatter;
+}
+
+//#endregion
+//#region src/utils/getPlugins.ts
+function isJSONPlugins(plugins) {
+	return !!plugins?.some((plugin) => {
+		return Array.isArray(plugin) && typeof plugin?.at(0) === "string";
+	});
+}
+function isObjectPlugins(plugins) {
+	return plugins instanceof Object && !Array.isArray(plugins);
+}
+function getPlugins(plugins) {
+	if (isObjectPlugins(plugins)) throw new Error("Object plugins are not supported anymore, best to use http://kubb.dev/getting-started/configure#json");
+	if (isJSONPlugins(plugins)) throw new Error("JSON plugins are not supported anymore, best to use http://kubb.dev/getting-started/configure#json");
+	return Promise.resolve(plugins);
+}
+
+//#endregion
+//#region src/utils/promise.ts
+function isPromise(result) {
+	return !!result && typeof result?.then === "function";
+}
+function isPromiseFulfilledResult(result) {
+	return result.status === "fulfilled";
+}
+function isPromiseRejectedResult(result) {
+	return result.status === "rejected";
+}
+
+//#endregion
+//#region src/utils/getConfigs.ts
+/**
+* Converting UserConfig to Config Array without a change in the object beside the JSON convert.
+*/
+async function getConfigs(config, args) {
+	let kubbUserConfig = Promise.resolve(config);
+	if (typeof config === "function") {
+		const possiblePromise = config(args);
+		if (isPromise(possiblePromise)) kubbUserConfig = possiblePromise;
+		kubbUserConfig = Promise.resolve(possiblePromise);
+	}
+	let JSONConfig = await kubbUserConfig;
+	if (!Array.isArray(JSONConfig)) JSONConfig = [JSONConfig];
+	const results = [];
+	for (const item of JSONConfig) {
+		const plugins = item.plugins ? await getPlugins(item.plugins) : void 0;
+		results.push({
+			...item,
+			plugins
+		});
+	}
+	return results;
+}
+
 //#endregion
 //#region src/utils/getNestedAccessor.ts
 /**
@@ -188,15 +315,42 @@ function getNestedAccessor(param, accessor) {
 }
 
 //#endregion
-//#region src/utils/promise.ts
-function isPromise(result) {
-	return !!result && typeof result?.then === "function";
-}
-function isPromiseFulfilledResult(result) {
-	return result.status === "fulfilled";
+//#region src/utils/linters.ts
+const linters = {
+	eslint: {
+		command: "eslint",
+		args: (outputPath) => [outputPath, "--fix"],
+		errorMessage: "Eslint not found"
+	},
+	biome: {
+		command: "biome",
+		args: (outputPath) => [
+			"lint",
+			"--fix",
+			outputPath
+		],
+		errorMessage: "Biome not found"
+	},
+	oxlint: {
+		command: "oxlint",
+		args: (outputPath) => ["--fix", outputPath],
+		errorMessage: "Oxlint not found"
+	}
+};
+async function isLinterAvailable(linter) {
+	try {
+		await execaCommand(`${linter} --version`, { stdio: "ignore" });
+		return true;
+	} catch {
+		return false;
+	}
 }
-function isPromiseRejectedResult(result) {
-	return result.status === "rejected";
+async function detectLinter() {
+	for (const linter of [
+		"biome",
+		"oxlint",
+		"eslint"
+	]) if (await isLinterAvailable(linter)) return linter;
 }
 
 //#endregion
@@ -261,5 +415,5 @@ async function timeout(ms) {
 }
 
 //#endregion
-export { AsyncEventEmitter, Cache, FunctionParams, URLPath, buildJSDoc, executeIfOnline, formatHrtime, formatMs, getBarrelFiles, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, renderTemplate, resolveModuleSource, serializePluginOptions, setUniqueName, timeout };
+export { AsyncEventEmitter, Cache, FunctionParams, URLPath, buildJSDoc, detectFormatter, detectLinter, executeIfOnline, formatHrtime, formatMs, formatters, getBarrelFiles, getConfigs, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, linters, renderTemplate, resolveModuleSource, serializePluginOptions, setUniqueName, timeout };
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":["#buffer","#items","#orderItems","#addParams","item","timeout"],"sources":["../src/utils/buildJSDoc.ts","../src/utils/Cache.ts","../src/utils/checkOnlineStatus.ts","../src/utils/FunctionParams.ts","../src/utils/getNestedAccessor.ts","../src/utils/promise.ts","../src/utils/renderTemplate.ts","../src/utils/resolveModuleSource.ts","../src/utils/serializePluginOptions.ts","../src/utils/timeout.ts"],"sourcesContent":["/**\n * Builds a JSDoc comment block with custom indentation.\n * @param comments - Array of comment strings to include in the JSDoc block\n * @param options - Configuration options for formatting\n * @returns Formatted JSDoc string or fallback string if no comments\n */\nexport function buildJSDoc(\n  comments: Array<string>,\n  options: {\n    /**\n     * String to use for indenting each line of the JSDoc comment\n     * @default '   * ' (3 spaces + asterisk + space)\n     */\n    indent?: string\n    /**\n     * String to append after the closing JSDoc tag\n     * @default '\\n  ' (newline + 2 spaces)\n     */\n    suffix?: string\n    /**\n     * String to return when there are no comments\n     * @default '  ' (2 spaces)\n     */\n    fallback?: string\n  } = {},\n): string {\n  const { indent = '   * ', suffix = '\\n  ', fallback = '  ' } = options\n\n  if (comments.length === 0) {\n    return fallback\n  }\n\n  return `/**\\n${comments.map((c) => `${indent}${c}`).join('\\n')}\\n   */${suffix}`\n}\n","export class Cache<T> {\n  #buffer = new Map<string, T>()\n\n  async get(key: string): Promise<T | null> {\n    return this.#buffer.get(key) ?? null\n  }\n\n  async set(key: string, value: T): Promise<void> {\n    this.#buffer.set(key, value)\n  }\n\n  async delete(key: string): Promise<void> {\n    this.#buffer.delete(key)\n  }\n\n  async clear(): Promise<void> {\n    this.#buffer.clear()\n  }\n\n  async keys(): Promise<string[]> {\n    return [...this.#buffer.keys()]\n  }\n\n  async values(): Promise<T[]> {\n    return [...this.#buffer.values()]\n  }\n\n  async flush(): Promise<void> {\n    // No-op for base cache\n  }\n}\n","import dns from 'node:dns'\n\n/**\n * Check if the system has internet connectivity\n * Uses DNS lookup to well-known stable domains as a lightweight connectivity test\n */\nexport async function isOnline(): Promise<boolean> {\n  const testDomains = [\n    'dns.google.com', // Google Public DNS\n    'cloudflare.com', // Cloudflare\n    'one.one.one.one', // Cloudflare DNS\n  ]\n\n  for (const domain of testDomains) {\n    try {\n      await dns.promises.resolve(domain)\n      return true\n    } catch {\n      // Try next domain\n    }\n  }\n\n  return false\n}\n\n/**\n * Execute a function only if online, otherwise silently skip\n */\nexport async function executeIfOnline<T>(fn: () => Promise<T>): Promise<T | null> {\n  const online = await isOnline()\n  if (!online) {\n    return null\n  }\n\n  try {\n    return await fn()\n  } catch {\n    return null\n  }\n}\n","import { orderBy } from 'natural-orderby'\n\nimport { camelCase } from '../transformers/casing.ts'\n\ntype FunctionParamsASTWithoutType = {\n  name?: string\n  type?: string\n  /**\n   * @default true\n   */\n  required?: boolean\n  /**\n   * @default true\n   */\n  enabled?: boolean\n  default?: string\n}\n\ntype FunctionParamsASTWithType = {\n  name?: never\n  type: string\n  /**\n   * @default true\n   */\n  required?: boolean\n  /**\n   * @default true\n   */\n  enabled?: boolean\n  default?: string\n}\n/**\n * @deprecated\n */\nexport type FunctionParamsAST = FunctionParamsASTWithoutType | FunctionParamsASTWithType\n\n/**\n * @deprecated\n */\nexport class FunctionParams {\n  #items: Array<FunctionParamsAST | FunctionParamsAST[]> = []\n  constructor() {\n    return this\n  }\n\n  get items(): FunctionParamsAST[] {\n    return this.#items.flat()\n  }\n\n  add(item: FunctionParamsAST | Array<FunctionParamsAST | FunctionParamsAST[] | undefined> | undefined): FunctionParams {\n    if (!item) {\n      return this\n    }\n\n    if (Array.isArray(item)) {\n      item.filter(Boolean).forEach((it) => {\n        this.#items.push(it)\n      })\n      return this\n    }\n    this.#items.push(item)\n\n    return this\n  }\n  static #orderItems(items: Array<FunctionParamsAST | FunctionParamsAST[]>) {\n    return orderBy(\n      items.filter(Boolean),\n      [\n        (v) => {\n          if (Array.isArray(v)) {\n            return undefined\n          }\n          return !v.default\n        },\n        (v) => {\n          if (Array.isArray(v)) {\n            return undefined\n          }\n          return v.required ?? true\n        },\n      ],\n      ['desc', 'desc'],\n    )\n  }\n\n  static #addParams(acc: string[], item: FunctionParamsAST) {\n    const { enabled = true, name, type, required = true, ...rest } = item\n\n    if (!enabled) {\n      return acc\n    }\n\n    if (!name) {\n      // when name is not se we uses TypeScript generics\n      acc.push(`${type}${rest.default ? ` = ${rest.default}` : ''}`)\n\n      return acc\n    }\n    // TODO check whey we still need the camelcase here\n    const parameterName = name.startsWith('{') ? name : camelCase(name)\n\n    if (type) {\n      if (required) {\n        acc.push(`${parameterName}: ${type}${rest.default ? ` = ${rest.default}` : ''}`)\n      } else {\n        acc.push(`${parameterName}?: ${type}`)\n      }\n    } else {\n      acc.push(`${parameterName}`)\n    }\n\n    return acc\n  }\n\n  static toObject(items: FunctionParamsAST[]): FunctionParamsAST {\n    let type: string[] = []\n    let name: string[] = []\n\n    const enabled = items.every((item) => item.enabled) ? items.at(0)?.enabled : true\n    const required = items.every((item) => item.required) ?? true\n\n    items.forEach((item) => {\n      name = FunctionParams.#addParams(name, { ...item, type: undefined })\n      if (items.some((item) => item.type)) {\n        type = FunctionParams.#addParams(type, item)\n      }\n    })\n\n    return {\n      name: `{ ${name.join(', ')} }`,\n      type: type.length ? `{ ${type.join('; ')} }` : undefined,\n      enabled,\n      required,\n    }\n  }\n\n  toObject(): FunctionParamsAST {\n    const items = FunctionParams.#orderItems(this.#items).flat()\n\n    return FunctionParams.toObject(items)\n  }\n\n  static toString(items: (FunctionParamsAST | FunctionParamsAST[])[]): string {\n    const sortedData = FunctionParams.#orderItems(items)\n\n    return sortedData\n      .reduce((acc, item) => {\n        if (Array.isArray(item)) {\n          if (item.length <= 0) {\n            return acc\n          }\n          const subItems = FunctionParams.#orderItems(item) as FunctionParamsAST[]\n          const objectItem = FunctionParams.toObject(subItems)\n\n          return FunctionParams.#addParams(acc, objectItem)\n        }\n\n        return FunctionParams.#addParams(acc, item)\n      }, [] as string[])\n      .join(', ')\n  }\n\n  toString(): string {\n    const items = FunctionParams.#orderItems(this.#items)\n\n    return FunctionParams.toString(items)\n  }\n}\n","/**\n * Converts a param path (string with dot notation or array of strings) to a JavaScript accessor expression.\n * @param param - The param path, e.g., 'pagination.next.id' or ['pagination', 'next', 'id']\n * @param accessor - The base accessor, e.g., 'lastPage' or 'firstPage'\n * @returns A JavaScript accessor expression, e.g., \"lastPage?.['pagination']?.['next']?.['id']\", or undefined if param is empty\n *\n * @example\n * ```ts\n * getNestedAccessor('pagination.next.id', 'lastPage')\n * // returns: \"lastPage?.['pagination']?.['next']?.['id']\"\n *\n * getNestedAccessor(['pagination', 'next', 'id'], 'lastPage')\n * // returns: \"lastPage?.['pagination']?.['next']?.['id']\"\n *\n * getNestedAccessor('', 'lastPage')\n * // returns: undefined\n * ```\n */\nexport function getNestedAccessor(param: string | string[], accessor: string): string | undefined {\n  const parts = Array.isArray(param) ? param : param.split('.')\n  if (parts.length === 0 || (parts.length === 1 && parts[0] === '')) {\n    return undefined\n  }\n  return parts.reduce((acc, part) => `${acc}?.['${part}']`, accessor)\n}\n","import type { PossiblePromise } from './types.ts'\n\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n  return !!result && typeof (result as Promise<unknown>)?.then === 'function'\n}\n\nexport function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T> {\n  return result.status === 'fulfilled'\n}\n\nexport function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & { reason: T } {\n  return result.status === 'rejected'\n}\n","export function renderTemplate<TData extends Record<string, unknown> = Record<string, unknown>>(template: string, data: TData | undefined = undefined): string {\n  if (!data || !Object.keys(data).length) {\n    return template.replace(/{{(.*?)}}/g, '')\n  }\n\n  const matches = template.match(/{{(.*?)}}/g)\n\n  return (\n    matches?.reduce((prev, curr) => {\n      const index = curr.split(/{{|}}/).filter(Boolean)[0]?.trim()\n      if (index === undefined) {\n        return prev\n      }\n      const value = data[index]\n\n      if (value === undefined) {\n        return prev\n      }\n\n      return prev\n        .replace(curr, () => {\n          if (typeof value === 'boolean') {\n            return `${value.toString()}` || 'false'\n          }\n\n          return (value as string) || ''\n        })\n        .trim()\n    }, template) || ''\n  )\n}\n","import { readFileSync } from 'node:fs'\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport createJiti from 'jiti'\n\nexport function resolveModuleSource(pkgName: string) {\n  const parentURL = import.meta.url\n  const jiti = createJiti(parentURL)\n\n  const resolved = jiti.esmResolve(pkgName, parentURL)\n  const filePath = resolved.startsWith('file:') ? fileURLToPath(resolved) : resolved\n  const source = readFileSync(filePath, { encoding: 'utf-8' })\n  const ext = path.extname(filePath)\n  return { path: filePath, source, ext } as const\n}\n","/**\n * Serialize plugin options for safe JSON transport.\n * Strips functions, symbols, and undefined values recursively.\n */\nexport function serializePluginOptions(options: unknown): unknown {\n  if (options === null || options === undefined) {\n    return {}\n  }\n  if (typeof options !== 'object') {\n    return options\n  }\n  if (Array.isArray(options)) {\n    return options.map(serializePluginOptions)\n  }\n\n  const serialized: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(options)) {\n    if (typeof value === 'function' || typeof value === 'symbol' || value === undefined) {\n      continue\n    }\n    if (typeof value === 'object' && value !== null) {\n      serialized[key] = serializePluginOptions(value)\n    } else {\n      serialized[key] = value\n    }\n  }\n  return serialized\n}\n","export async function timeout(ms: number): Promise<unknown> {\n  return new Promise((resolve) => {\n    const timeout = setTimeout(() => {\n      resolve(timeout)\n    }, ms)\n  }).then((timeout) => {\n    clearTimeout(timeout as NodeJS.Timeout)\n\n    return true\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils.js","names":["#buffer","#items","#orderItems","#addParams","item","timeout"],"sources":["../src/utils/buildJSDoc.ts","../src/utils/Cache.ts","../src/utils/checkOnlineStatus.ts","../src/utils/FunctionParams.ts","../src/utils/formatters.ts","../src/utils/getPlugins.ts","../src/utils/promise.ts","../src/utils/getConfigs.ts","../src/utils/getNestedAccessor.ts","../src/utils/linters.ts","../src/utils/renderTemplate.ts","../src/utils/resolveModuleSource.ts","../src/utils/serializePluginOptions.ts","../src/utils/timeout.ts"],"sourcesContent":["/**\n * Builds a JSDoc comment block with custom indentation.\n * @param comments - Array of comment strings to include in the JSDoc block\n * @param options - Configuration options for formatting\n * @returns Formatted JSDoc string or fallback string if no comments\n */\nexport function buildJSDoc(\n  comments: Array<string>,\n  options: {\n    /**\n     * String to use for indenting each line of the JSDoc comment\n     * @default '   * ' (3 spaces + asterisk + space)\n     */\n    indent?: string\n    /**\n     * String to append after the closing JSDoc tag\n     * @default '\\n  ' (newline + 2 spaces)\n     */\n    suffix?: string\n    /**\n     * String to return when there are no comments\n     * @default '  ' (2 spaces)\n     */\n    fallback?: string\n  } = {},\n): string {\n  const { indent = '   * ', suffix = '\\n  ', fallback = '  ' } = options\n\n  if (comments.length === 0) {\n    return fallback\n  }\n\n  return `/**\\n${comments.map((c) => `${indent}${c}`).join('\\n')}\\n   */${suffix}`\n}\n","export class Cache<T> {\n  #buffer = new Map<string, T>()\n\n  async get(key: string): Promise<T | null> {\n    return this.#buffer.get(key) ?? null\n  }\n\n  async set(key: string, value: T): Promise<void> {\n    this.#buffer.set(key, value)\n  }\n\n  async delete(key: string): Promise<void> {\n    this.#buffer.delete(key)\n  }\n\n  async clear(): Promise<void> {\n    this.#buffer.clear()\n  }\n\n  async keys(): Promise<string[]> {\n    return [...this.#buffer.keys()]\n  }\n\n  async values(): Promise<T[]> {\n    return [...this.#buffer.values()]\n  }\n\n  async flush(): Promise<void> {\n    // No-op for base cache\n  }\n}\n","import dns from 'node:dns'\n\n/**\n * Check if the system has internet connectivity\n * Uses DNS lookup to well-known stable domains as a lightweight connectivity test\n */\nexport async function isOnline(): Promise<boolean> {\n  const testDomains = [\n    'dns.google.com', // Google Public DNS\n    'cloudflare.com', // Cloudflare\n    'one.one.one.one', // Cloudflare DNS\n  ]\n\n  for (const domain of testDomains) {\n    try {\n      await dns.promises.resolve(domain)\n      return true\n    } catch {\n      // Try next domain\n    }\n  }\n\n  return false\n}\n\n/**\n * Execute a function only if online, otherwise silently skip\n */\nexport async function executeIfOnline<T>(fn: () => Promise<T>): Promise<T | null> {\n  const online = await isOnline()\n  if (!online) {\n    return null\n  }\n\n  try {\n    return await fn()\n  } catch {\n    return null\n  }\n}\n","import { orderBy } from 'natural-orderby'\n\nimport { camelCase } from '../transformers/casing.ts'\n\ntype FunctionParamsASTWithoutType = {\n  name?: string\n  type?: string\n  /**\n   * @default true\n   */\n  required?: boolean\n  /**\n   * @default true\n   */\n  enabled?: boolean\n  default?: string\n}\n\ntype FunctionParamsASTWithType = {\n  name?: never\n  type: string\n  /**\n   * @default true\n   */\n  required?: boolean\n  /**\n   * @default true\n   */\n  enabled?: boolean\n  default?: string\n}\n/**\n * @deprecated\n */\nexport type FunctionParamsAST = FunctionParamsASTWithoutType | FunctionParamsASTWithType\n\n/**\n * @deprecated\n */\nexport class FunctionParams {\n  #items: Array<FunctionParamsAST | FunctionParamsAST[]> = []\n  constructor() {\n    return this\n  }\n\n  get items(): FunctionParamsAST[] {\n    return this.#items.flat()\n  }\n\n  add(item: FunctionParamsAST | Array<FunctionParamsAST | FunctionParamsAST[] | undefined> | undefined): FunctionParams {\n    if (!item) {\n      return this\n    }\n\n    if (Array.isArray(item)) {\n      item.filter(Boolean).forEach((it) => {\n        this.#items.push(it)\n      })\n      return this\n    }\n    this.#items.push(item)\n\n    return this\n  }\n  static #orderItems(items: Array<FunctionParamsAST | FunctionParamsAST[]>) {\n    return orderBy(\n      items.filter(Boolean),\n      [\n        (v) => {\n          if (Array.isArray(v)) {\n            return undefined\n          }\n          return !v.default\n        },\n        (v) => {\n          if (Array.isArray(v)) {\n            return undefined\n          }\n          return v.required ?? true\n        },\n      ],\n      ['desc', 'desc'],\n    )\n  }\n\n  static #addParams(acc: string[], item: FunctionParamsAST) {\n    const { enabled = true, name, type, required = true, ...rest } = item\n\n    if (!enabled) {\n      return acc\n    }\n\n    if (!name) {\n      // when name is not se we uses TypeScript generics\n      acc.push(`${type}${rest.default ? ` = ${rest.default}` : ''}`)\n\n      return acc\n    }\n    // TODO check whey we still need the camelcase here\n    const parameterName = name.startsWith('{') ? name : camelCase(name)\n\n    if (type) {\n      if (required) {\n        acc.push(`${parameterName}: ${type}${rest.default ? ` = ${rest.default}` : ''}`)\n      } else {\n        acc.push(`${parameterName}?: ${type}`)\n      }\n    } else {\n      acc.push(`${parameterName}`)\n    }\n\n    return acc\n  }\n\n  static toObject(items: FunctionParamsAST[]): FunctionParamsAST {\n    let type: string[] = []\n    let name: string[] = []\n\n    const enabled = items.every((item) => item.enabled) ? items.at(0)?.enabled : true\n    const required = items.every((item) => item.required) ?? true\n\n    items.forEach((item) => {\n      name = FunctionParams.#addParams(name, { ...item, type: undefined })\n      if (items.some((item) => item.type)) {\n        type = FunctionParams.#addParams(type, item)\n      }\n    })\n\n    return {\n      name: `{ ${name.join(', ')} }`,\n      type: type.length ? `{ ${type.join('; ')} }` : undefined,\n      enabled,\n      required,\n    }\n  }\n\n  toObject(): FunctionParamsAST {\n    const items = FunctionParams.#orderItems(this.#items).flat()\n\n    return FunctionParams.toObject(items)\n  }\n\n  static toString(items: (FunctionParamsAST | FunctionParamsAST[])[]): string {\n    const sortedData = FunctionParams.#orderItems(items)\n\n    return sortedData\n      .reduce((acc, item) => {\n        if (Array.isArray(item)) {\n          if (item.length <= 0) {\n            return acc\n          }\n          const subItems = FunctionParams.#orderItems(item) as FunctionParamsAST[]\n          const objectItem = FunctionParams.toObject(subItems)\n\n          return FunctionParams.#addParams(acc, objectItem)\n        }\n\n        return FunctionParams.#addParams(acc, item)\n      }, [] as string[])\n      .join(', ')\n  }\n\n  toString(): string {\n    const items = FunctionParams.#orderItems(this.#items)\n\n    return FunctionParams.toString(items)\n  }\n}\n","import { execaCommand } from 'execa'\n\nexport const formatters = {\n  prettier: {\n    command: 'prettier',\n    args: (outputPath: string) => ['--ignore-unknown', '--write', outputPath],\n    errorMessage: 'Prettier not found',\n  },\n  biome: {\n    command: 'biome',\n    args: (outputPath: string) => ['format', '--write', outputPath],\n    errorMessage: 'Biome not found',\n  },\n  oxfmt: {\n    command: 'oxfmt',\n    args: (outputPath: string) => [outputPath],\n    errorMessage: 'Oxfmt not found',\n  },\n} as const\n\ntype Formatter = keyof typeof formatters\n\n/**\n * Check if a formatter command is available in the system.\n *\n * @param formatter - The formatter to check ('biome', 'prettier', or 'oxfmt')\n * @returns Promise that resolves to true if the formatter is available, false otherwise\n *\n * @remarks\n * This function checks availability by running `<formatter> --version` command.\n * All supported formatters (biome, prettier, oxfmt) implement the --version flag.\n */\nasync function isFormatterAvailable(formatter: Formatter): Promise<boolean> {\n  try {\n    // Try to get the version of the formatter to check if it's installed\n    await execaCommand(`${formatter} --version`, { stdio: 'ignore' })\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * Detect which formatter is available in the system.\n *\n * @returns Promise that resolves to the first available formatter or undefined if none are found\n *\n * @remarks\n * Checks in order of preference: biome, oxfmt, prettier.\n * Uses the `--version` flag to detect if each formatter command is available.\n * This is a reliable method as all supported formatters implement this flag.\n *\n * @example\n * ```typescript\n * const formatter = await detectFormatter()\n * if (formatter) {\n *   console.log(`Using ${formatter} for formatting`)\n * } else {\n *   console.log('No formatter found')\n * }\n * ```\n */\nexport async function detectFormatter(): Promise<Formatter | undefined> {\n  const formatters: Formatter[] = ['biome', 'oxfmt', 'prettier']\n\n  for (const formatter of formatters) {\n    if (await isFormatterAvailable(formatter)) {\n      return formatter\n    }\n  }\n\n  return undefined\n}\n","import type { UserConfig } from '../types.ts'\n\nfunction isJSONPlugins(plugins: UserConfig['plugins']) {\n  return !!(plugins as any)?.some((plugin: any) => {\n    return Array.isArray(plugin) && typeof plugin?.at(0) === 'string'\n  })\n}\n\nfunction isObjectPlugins(plugins: UserConfig['plugins']): plugins is any {\n  return plugins instanceof Object && !Array.isArray(plugins)\n}\n\nexport function getPlugins(plugins: UserConfig['plugins']): Promise<UserConfig['plugins']> {\n  if (isObjectPlugins(plugins)) {\n    throw new Error('Object plugins are not supported anymore, best to use http://kubb.dev/getting-started/configure#json')\n  }\n\n  if (isJSONPlugins(plugins)) {\n    throw new Error('JSON plugins are not supported anymore, best to use http://kubb.dev/getting-started/configure#json')\n  }\n\n  return Promise.resolve(plugins)\n}\n","import type { PossiblePromise } from './types.ts'\n\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n  return !!result && typeof (result as Promise<unknown>)?.then === 'function'\n}\n\nexport function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T> {\n  return result.status === 'fulfilled'\n}\n\nexport function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & { reason: T } {\n  return result.status === 'rejected'\n}\n","import type { CLIOptions, defineConfig } from '../config.ts'\nimport type { Config, UserConfig } from '../types.ts'\nimport { getPlugins } from './getPlugins.ts'\nimport { isPromise } from './promise.ts'\n\n/**\n * Converting UserConfig to Config Array without a change in the object beside the JSON convert.\n */\nexport async function getConfigs(config: ReturnType<typeof defineConfig> | UserConfig, args: CLIOptions): Promise<Array<Config>> {\n  let kubbUserConfig = Promise.resolve(config) as Promise<UserConfig | Array<UserConfig>>\n\n  // for ts or js files\n  if (typeof config === 'function') {\n    const possiblePromise = config(args as CLIOptions)\n    if (isPromise(possiblePromise)) {\n      kubbUserConfig = possiblePromise\n    }\n    kubbUserConfig = Promise.resolve(possiblePromise)\n  }\n\n  let JSONConfig = await kubbUserConfig\n\n  if (!Array.isArray(JSONConfig)) {\n    JSONConfig = [JSONConfig]\n  }\n\n  const results: Array<Config> = []\n\n  for (const item of JSONConfig) {\n    const plugins = item.plugins ? await getPlugins(item.plugins) : undefined\n\n    results.push({\n      ...item,\n      plugins,\n    } as Config)\n  }\n\n  return results\n}\n","/**\n * Converts a param path (string with dot notation or array of strings) to a JavaScript accessor expression.\n * @param param - The param path, e.g., 'pagination.next.id' or ['pagination', 'next', 'id']\n * @param accessor - The base accessor, e.g., 'lastPage' or 'firstPage'\n * @returns A JavaScript accessor expression, e.g., \"lastPage?.['pagination']?.['next']?.['id']\", or undefined if param is empty\n *\n * @example\n * ```ts\n * getNestedAccessor('pagination.next.id', 'lastPage')\n * // returns: \"lastPage?.['pagination']?.['next']?.['id']\"\n *\n * getNestedAccessor(['pagination', 'next', 'id'], 'lastPage')\n * // returns: \"lastPage?.['pagination']?.['next']?.['id']\"\n *\n * getNestedAccessor('', 'lastPage')\n * // returns: undefined\n * ```\n */\nexport function getNestedAccessor(param: string | string[], accessor: string): string | undefined {\n  const parts = Array.isArray(param) ? param : param.split('.')\n  if (parts.length === 0 || (parts.length === 1 && parts[0] === '')) {\n    return undefined\n  }\n  return parts.reduce((acc, part) => `${acc}?.['${part}']`, accessor)\n}\n","import { execaCommand } from 'execa'\n\nexport const linters = {\n  eslint: {\n    command: 'eslint',\n    args: (outputPath: string) => [outputPath, '--fix'],\n    errorMessage: 'Eslint not found',\n  },\n  biome: {\n    command: 'biome',\n    args: (outputPath: string) => ['lint', '--fix', outputPath],\n    errorMessage: 'Biome not found',\n  },\n  oxlint: {\n    command: 'oxlint',\n    args: (outputPath: string) => ['--fix', outputPath],\n    errorMessage: 'Oxlint not found',\n  },\n} as const\n\ntype Linter = keyof typeof linters\n\nasync function isLinterAvailable(linter: Linter): Promise<boolean> {\n  try {\n    await execaCommand(`${linter} --version`, { stdio: 'ignore' })\n    return true\n  } catch {\n    return false\n  }\n}\n\nexport async function detectLinter(): Promise<Linter | undefined> {\n  const linters: Linter[] = ['biome', 'oxlint', 'eslint']\n\n  for (const linter of linters) {\n    if (await isLinterAvailable(linter)) {\n      return linter\n    }\n  }\n\n  return undefined\n}\n","export function renderTemplate<TData extends Record<string, unknown> = Record<string, unknown>>(template: string, data: TData | undefined = undefined): string {\n  if (!data || !Object.keys(data).length) {\n    return template.replace(/{{(.*?)}}/g, '')\n  }\n\n  const matches = template.match(/{{(.*?)}}/g)\n\n  return (\n    matches?.reduce((prev, curr) => {\n      const index = curr.split(/{{|}}/).filter(Boolean)[0]?.trim()\n      if (index === undefined) {\n        return prev\n      }\n      const value = data[index]\n\n      if (value === undefined) {\n        return prev\n      }\n\n      return prev\n        .replace(curr, () => {\n          if (typeof value === 'boolean') {\n            return `${value.toString()}` || 'false'\n          }\n\n          return (value as string) || ''\n        })\n        .trim()\n    }, template) || ''\n  )\n}\n","import { readFileSync } from 'node:fs'\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport createJiti from 'jiti'\n\nexport function resolveModuleSource(pkgName: string) {\n  const parentURL = import.meta.url\n  const jiti = createJiti(parentURL)\n\n  const resolved = jiti.esmResolve(pkgName, parentURL)\n  const filePath = resolved.startsWith('file:') ? fileURLToPath(resolved) : resolved\n  const source = readFileSync(filePath, { encoding: 'utf-8' })\n  const ext = path.extname(filePath)\n  return { path: filePath, source, ext } as const\n}\n","/**\n * Serialize plugin options for safe JSON transport.\n * Strips functions, symbols, and undefined values recursively.\n */\nexport function serializePluginOptions(options: unknown): unknown {\n  if (options === null || options === undefined) {\n    return {}\n  }\n  if (typeof options !== 'object') {\n    return options\n  }\n  if (Array.isArray(options)) {\n    return options.map(serializePluginOptions)\n  }\n\n  const serialized: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(options)) {\n    if (typeof value === 'function' || typeof value === 'symbol' || value === undefined) {\n      continue\n    }\n    if (typeof value === 'object' && value !== null) {\n      serialized[key] = serializePluginOptions(value)\n    } else {\n      serialized[key] = value\n    }\n  }\n  return serialized\n}\n","export async function timeout(ms: number): Promise<unknown> {\n  return new Promise((resolve) => {\n    const timeout = setTimeout(() => {\n      resolve(timeout)\n    }, ms)\n  }).then((timeout) => {\n    clearTimeout(timeout as NodeJS.Timeout)\n\n    return true\n  })\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/core",
-  "version": "4.24.1",
+  "version": "4.25.1",
   "description": "Core functionality for Kubb's plugin-based code generation system, providing the foundation for transforming OpenAPI specifications.",
   "keywords": [
     "typescript",
@@ -88,6 +88,7 @@
   "dependencies": {
     "@kubb/react-fabric": "0.12.11",
     "camelcase": "^8.0.0",
+    "execa": "^9.6.1",
     "find-up": "^7.0.0",
     "fs-extra": "^11.3.3",
     "jiti": "^2.6.1",

package/src/index.ts

@@ -6,7 +6,6 @@ export { definePlugin } from './definePlugin.ts'
 export { PackageManager } from './PackageManager.ts'
 export { getMode, PluginManager } from './PluginManager.ts'
 export { PromiseManager } from './PromiseManager.ts'
-export type { HealthResponse, InfoResponse, ServerEvents, SseEvent, SseEvents, SseEventType } from './server/index.ts'
 export * from './types.ts'
 export type { FileMetaBase } from './utils/getBarrelFiles.ts'
 export { getBarrelFiles } from './utils/getBarrelFiles.ts'

package/src/types.ts

@@ -392,92 +392,4 @@ export type Logger<TOptions extends LoggerOptions = LoggerOptions> = {
 
 export type UserLogger<TOptions extends LoggerOptions = LoggerOptions> = Omit<Logger<TOptions>, 'logLevel'>
 
-/**
- * Typed SSE events sent by the Kubb server.
- * Follows the same tuple structure as {@link KubbEvents}.
- * Reusable in consumers like kubb-playground to parse incoming events.
- */
-export interface SseEvents {
-  'plugin:start': [plugin: { name: string }]
-  'plugin:end': [plugin: { name: string }, meta: { duration: number; success: boolean }]
-  'files:processing:start': [meta: { total: number }]
-  'file:processing:update': [
-    meta: {
-      file: string
-      processed: number
-      total: number
-      percentage: number
-    },
-  ]
-  'files:processing:end': [meta: { total: number }]
-  info: [message: string, info?: string]
-  success: [message: string, info?: string]
-  warn: [message: string, info?: string]
-  error: [error: { message: string; stack?: string }]
-  'generation:start': [config: { name?: string; plugins: number }]
-  'generation:end': [Config: Config, files: Array<KubbFile.ResolvedFile>, sources: Record<KubbFile.Path, string>]
-  'lifecycle:end': []
-}
-
-export type SseEventType = keyof SseEvents
-
-export type SseEvent<T extends SseEventType = SseEventType> = {
-  type: T
-  data: SseEvents[T]
-  timestamp: number
-}
-
-/**
- * API response types for the Kubb stream server endpoints.
- */
-
-/** GET /api/health */
-export type HealthResponse = {
-  status: 'ok'
-  version: string
-  configPath: string
-}
-
-/** GET /api/info */
-export type InfoResponse = {
-  version: string
-  configPath: string
-  spec?: string
-  config: {
-    name?: string
-    root: string
-    input: {
-      path?: string
-    }
-    output: {
-      path: string
-      write?: boolean
-      extension?: Record<string, string>
-      barrelType?: string | false
-    }
-    plugins?: Array<{
-      name: string
-      options: unknown
-    }>
-  }
-}
-
-/**
- * Same events as KubbEvents but with server lifecycle events
- */
-export type ServerEvents = KubbEvents & {
-  /**
-   * Emitted when the server starts successfully
-   */
-  'server:start': [serverUrl: string, configPath: string]
-  /**
-   * Emitted when the server is shutting down
-   */
-  'server:shutdown': []
-  /**
-   * Emitted when the server has stopped
-   */
-  'server:stopped': []
-}
-
 export type { KubbEvents } from './Kubb.ts'

package/src/utils/formatters.ts

@@ -0,0 +1,73 @@
+import { execaCommand } from 'execa'
+
+export const formatters = {
+  prettier: {
+    command: 'prettier',
+    args: (outputPath: string) => ['--ignore-unknown', '--write', outputPath],
+    errorMessage: 'Prettier not found',
+  },
+  biome: {
+    command: 'biome',
+    args: (outputPath: string) => ['format', '--write', outputPath],
+    errorMessage: 'Biome not found',
+  },
+  oxfmt: {
+    command: 'oxfmt',
+    args: (outputPath: string) => [outputPath],
+    errorMessage: 'Oxfmt not found',
+  },
+} as const
+
+type Formatter = keyof typeof formatters
+
+/**
+ * Check if a formatter command is available in the system.
+ *
+ * @param formatter - The formatter to check ('biome', 'prettier', or 'oxfmt')
+ * @returns Promise that resolves to true if the formatter is available, false otherwise
+ *
+ * @remarks
+ * This function checks availability by running `<formatter> --version` command.
+ * All supported formatters (biome, prettier, oxfmt) implement the --version flag.
+ */
+async function isFormatterAvailable(formatter: Formatter): Promise<boolean> {
+  try {
+    // Try to get the version of the formatter to check if it's installed
+    await execaCommand(`${formatter} --version`, { stdio: 'ignore' })
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * Detect which formatter is available in the system.
+ *
+ * @returns Promise that resolves to the first available formatter or undefined if none are found
+ *
+ * @remarks
+ * Checks in order of preference: biome, oxfmt, prettier.
+ * Uses the `--version` flag to detect if each formatter command is available.
+ * This is a reliable method as all supported formatters implement this flag.
+ *
+ * @example
+ * ```typescript
+ * const formatter = await detectFormatter()
+ * if (formatter) {
+ *   console.log(`Using ${formatter} for formatting`)
+ * } else {
+ *   console.log('No formatter found')
+ * }
+ * ```
+ */
+export async function detectFormatter(): Promise<Formatter | undefined> {
+  const formatters: Formatter[] = ['biome', 'oxfmt', 'prettier']
+
+  for (const formatter of formatters) {
+    if (await isFormatterAvailable(formatter)) {
+      return formatter
+    }
+  }
+
+  return undefined
+}

package/src/utils/getConfigs.ts

@@ -0,0 +1,39 @@
+import type { CLIOptions, defineConfig } from '../config.ts'
+import type { Config, UserConfig } from '../types.ts'
+import { getPlugins } from './getPlugins.ts'
+import { isPromise } from './promise.ts'
+
+/**
+ * Converting UserConfig to Config Array without a change in the object beside the JSON convert.
+ */
+export async function getConfigs(config: ReturnType<typeof defineConfig> | UserConfig, args: CLIOptions): Promise<Array<Config>> {
+  let kubbUserConfig = Promise.resolve(config) as Promise<UserConfig | Array<UserConfig>>
+
+  // for ts or js files
+  if (typeof config === 'function') {
+    const possiblePromise = config(args as CLIOptions)
+    if (isPromise(possiblePromise)) {
+      kubbUserConfig = possiblePromise
+    }
+    kubbUserConfig = Promise.resolve(possiblePromise)
+  }
+
+  let JSONConfig = await kubbUserConfig
+
+  if (!Array.isArray(JSONConfig)) {
+    JSONConfig = [JSONConfig]
+  }
+
+  const results: Array<Config> = []
+
+  for (const item of JSONConfig) {
+    const plugins = item.plugins ? await getPlugins(item.plugins) : undefined
+
+    results.push({
+      ...item,
+      plugins,
+    } as Config)
+  }
+
+  return results
+}

package/src/utils/getPlugins.ts

@@ -0,0 +1,23 @@
+import type { UserConfig } from '../types.ts'
+
+function isJSONPlugins(plugins: UserConfig['plugins']) {
+  return !!(plugins as any)?.some((plugin: any) => {
+    return Array.isArray(plugin) && typeof plugin?.at(0) === 'string'
+  })
+}
+
+function isObjectPlugins(plugins: UserConfig['plugins']): plugins is any {
+  return plugins instanceof Object && !Array.isArray(plugins)
+}
+
+export function getPlugins(plugins: UserConfig['plugins']): Promise<UserConfig['plugins']> {
+  if (isObjectPlugins(plugins)) {
+    throw new Error('Object plugins are not supported anymore, best to use http://kubb.dev/getting-started/configure#json')
+  }
+
+  if (isJSONPlugins(plugins)) {
+    throw new Error('JSON plugins are not supported anymore, best to use http://kubb.dev/getting-started/configure#json')
+  }
+
+  return Promise.resolve(plugins)
+}

package/src/utils/index.ts

@@ -5,8 +5,11 @@ export { executeIfOnline, isOnline } from './checkOnlineStatus.ts'
 export type { FunctionParamsAST } from './FunctionParams.ts'
 export { FunctionParams } from './FunctionParams.ts'
 export { formatHrtime, formatMs, getElapsedMs } from './formatHrtime.ts'
+export { detectFormatter, formatters } from './formatters.ts'
 export { getBarrelFiles } from './getBarrelFiles.ts'
+export { getConfigs } from './getConfigs.ts'
 export { getNestedAccessor } from './getNestedAccessor.ts'
+export { detectLinter, linters } from './linters.ts'
 export {
   isPromise,
   isPromiseFulfilledResult,

package/src/utils/linters.ts

@@ -0,0 +1,42 @@
+import { execaCommand } from 'execa'
+
+export const linters = {
+  eslint: {
+    command: 'eslint',
+    args: (outputPath: string) => [outputPath, '--fix'],
+    errorMessage: 'Eslint not found',
+  },
+  biome: {
+    command: 'biome',
+    args: (outputPath: string) => ['lint', '--fix', outputPath],
+    errorMessage: 'Biome not found',
+  },
+  oxlint: {
+    command: 'oxlint',
+    args: (outputPath: string) => ['--fix', outputPath],
+    errorMessage: 'Oxlint not found',
+  },
+} as const
+
+type Linter = keyof typeof linters
+
+async function isLinterAvailable(linter: Linter): Promise<boolean> {
+  try {
+    await execaCommand(`${linter} --version`, { stdio: 'ignore' })
+    return true
+  } catch {
+    return false
+  }
+}
+
+export async function detectLinter(): Promise<Linter | undefined> {
+  const linters: Linter[] = ['biome', 'oxlint', 'eslint']
+
+  for (const linter of linters) {
+    if (await isLinterAvailable(linter)) {
+      return linter
+    }
+  }
+
+  return undefined
+}

package/dist/getBarrelFiles-CvaEQ7z_.d.ts

@@ -1,35 +0,0 @@
-import { t as __name } from "./chunk-iVr_oF3V.js";
-import { f as Plugin, t as BarrelType } from "./types-Cn3Gwsf3.js";
-import { KubbFile } from "@kubb/fabric-core/types";
-
-//#region src/utils/getBarrelFiles.d.ts
-type FileMetaBase = {
-  pluginKey?: Plugin['key'];
-};
-type AddIndexesProps = {
-  type: BarrelType | false | undefined;
-  /**
-   * Root based on root and output.path specified in the config
-   */
-  root: string;
-  /**
-   * Output for plugin
-   */
-  output: {
-    path: string;
-  };
-  group?: {
-    output: string;
-    exportAs: string;
-  };
-  meta?: FileMetaBase;
-};
-declare function getBarrelFiles(files: Array<KubbFile.ResolvedFile>, {
-  type,
-  meta,
-  root,
-  output
-}: AddIndexesProps): Promise<KubbFile.File[]>;
-//#endregion
-export { getBarrelFiles as n, FileMetaBase as t };
-//# sourceMappingURL=getBarrelFiles-CvaEQ7z_.d.ts.map