@kubb/core 4.23.0 → 4.24.1

package/dist/utils.js

@@ -1,4 +1,265 @@
-import { C as setUniqueName, S as getUniqueName, _ as formatMs, a as isPromise, c as getNestedAccessor, d as executeIfOnline, f as isOnline, g as formatHrtime, h as URLPath, i as renderTemplate, l as getBarrelFiles, m as buildJSDoc, n as serializePluginOptions, o as isPromiseFulfilledResult, p as Cache, r as resolveModuleSource, s as isPromiseRejectedResult, t as timeout, u as FunctionParams, v as getElapsedMs, y as AsyncEventEmitter } from "./utils-C3cuilmF.js";
-import "./transformers-8ju9ixkG.js";
+import { t as __name } from "./chunk-iVr_oF3V.js";
+import { a as getElapsedMs, i as formatMs, l as getUniqueName, n as URLPath, o as AsyncEventEmitter, r as formatHrtime, t as getBarrelFiles, u as setUniqueName } from "./getBarrelFiles-gRyVPFBP.js";
+import { m as camelCase } from "./transformers-8ju9ixkG.js";
+import path from "node:path";
+import { orderBy } from "natural-orderby";
+import { fileURLToPath } from "node:url";
+import { readFileSync } from "node:fs";
+import dns from "node:dns";
+import createJiti from "jiti";
 
-export { AsyncEventEmitter, Cache, FunctionParams, URLPath, buildJSDoc, executeIfOnline, formatHrtime, formatMs, getBarrelFiles, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, renderTemplate, resolveModuleSource, serializePluginOptions, setUniqueName, timeout };
+//#region src/utils/buildJSDoc.ts
+/**
+* Builds a JSDoc comment block with custom indentation.
+* @param comments - Array of comment strings to include in the JSDoc block
+* @param options - Configuration options for formatting
+* @returns Formatted JSDoc string or fallback string if no comments
+*/
+function buildJSDoc(comments, options = {}) {
+	const { indent = "   * ", suffix = "\n  ", fallback = "  " } = options;
+	if (comments.length === 0) return fallback;
+	return `/**\n${comments.map((c) => `${indent}${c}`).join("\n")}\n   */${suffix}`;
+}
+
+//#endregion
+//#region src/utils/Cache.ts
+var Cache = class {
+	#buffer = /* @__PURE__ */ new Map();
+	async get(key) {
+		return this.#buffer.get(key) ?? null;
+	}
+	async set(key, value) {
+		this.#buffer.set(key, value);
+	}
+	async delete(key) {
+		this.#buffer.delete(key);
+	}
+	async clear() {
+		this.#buffer.clear();
+	}
+	async keys() {
+		return [...this.#buffer.keys()];
+	}
+	async values() {
+		return [...this.#buffer.values()];
+	}
+	async flush() {}
+};
+
+//#endregion
+//#region src/utils/checkOnlineStatus.ts
+/**
+* Check if the system has internet connectivity
+* Uses DNS lookup to well-known stable domains as a lightweight connectivity test
+*/
+async function isOnline() {
+	for (const domain of [
+		"dns.google.com",
+		"cloudflare.com",
+		"one.one.one.one"
+	]) try {
+		await dns.promises.resolve(domain);
+		return true;
+	} catch {}
+	return false;
+}
+/**
+* Execute a function only if online, otherwise silently skip
+*/
+async function executeIfOnline(fn) {
+	if (!await isOnline()) return null;
+	try {
+		return await fn();
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+//#region src/utils/FunctionParams.ts
+/**
+* @deprecated
+*/
+var FunctionParams = class FunctionParams {
+	#items = [];
+	constructor() {
+		return this;
+	}
+	get items() {
+		return this.#items.flat();
+	}
+	add(item) {
+		if (!item) return this;
+		if (Array.isArray(item)) {
+			item.filter(Boolean).forEach((it) => {
+				this.#items.push(it);
+			});
+			return this;
+		}
+		this.#items.push(item);
+		return this;
+	}
+	static #orderItems(items) {
+		return orderBy(items.filter(Boolean), [(v) => {
+			if (Array.isArray(v)) return;
+			return !v.default;
+		}, (v) => {
+			if (Array.isArray(v)) return;
+			return v.required ?? true;
+		}], ["desc", "desc"]);
+	}
+	static #addParams(acc, item) {
+		const { enabled = true, name, type, required = true, ...rest } = item;
+		if (!enabled) return acc;
+		if (!name) {
+			acc.push(`${type}${rest.default ? ` = ${rest.default}` : ""}`);
+			return acc;
+		}
+		const parameterName = name.startsWith("{") ? name : camelCase(name);
+		if (type) if (required) acc.push(`${parameterName}: ${type}${rest.default ? ` = ${rest.default}` : ""}`);
+		else acc.push(`${parameterName}?: ${type}`);
+		else acc.push(`${parameterName}`);
+		return acc;
+	}
+	static toObject(items) {
+		let type = [];
+		let name = [];
+		const enabled = items.every((item) => item.enabled) ? items.at(0)?.enabled : true;
+		const required = items.every((item) => item.required) ?? true;
+		items.forEach((item) => {
+			name = FunctionParams.#addParams(name, {
+				...item,
+				type: void 0
+			});
+			if (items.some((item$1) => item$1.type)) type = FunctionParams.#addParams(type, item);
+		});
+		return {
+			name: `{ ${name.join(", ")} }`,
+			type: type.length ? `{ ${type.join("; ")} }` : void 0,
+			enabled,
+			required
+		};
+	}
+	toObject() {
+		const items = FunctionParams.#orderItems(this.#items).flat();
+		return FunctionParams.toObject(items);
+	}
+	static toString(items) {
+		return FunctionParams.#orderItems(items).reduce((acc, item) => {
+			if (Array.isArray(item)) {
+				if (item.length <= 0) return acc;
+				const subItems = FunctionParams.#orderItems(item);
+				const objectItem = FunctionParams.toObject(subItems);
+				return FunctionParams.#addParams(acc, objectItem);
+			}
+			return FunctionParams.#addParams(acc, item);
+		}, []).join(", ");
+	}
+	toString() {
+		const items = FunctionParams.#orderItems(this.#items);
+		return FunctionParams.toString(items);
+	}
+};
+
+//#endregion
+//#region src/utils/getNestedAccessor.ts
+/**
+* Converts a param path (string with dot notation or array of strings) to a JavaScript accessor expression.
+* @param param - The param path, e.g., 'pagination.next.id' or ['pagination', 'next', 'id']
+* @param accessor - The base accessor, e.g., 'lastPage' or 'firstPage'
+* @returns A JavaScript accessor expression, e.g., "lastPage?.['pagination']?.['next']?.['id']", or undefined if param is empty
+*
+* @example
+* ```ts
+* getNestedAccessor('pagination.next.id', 'lastPage')
+* // returns: "lastPage?.['pagination']?.['next']?.['id']"
+*
+* getNestedAccessor(['pagination', 'next', 'id'], 'lastPage')
+* // returns: "lastPage?.['pagination']?.['next']?.['id']"
+*
+* getNestedAccessor('', 'lastPage')
+* // returns: undefined
+* ```
+*/
+function getNestedAccessor(param, accessor) {
+	const parts = Array.isArray(param) ? param : param.split(".");
+	if (parts.length === 0 || parts.length === 1 && parts[0] === "") return;
+	return parts.reduce((acc, part) => `${acc}?.['${part}']`, accessor);
+}
+
+//#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/renderTemplate.ts
+function renderTemplate(template, data = void 0) {
+	if (!data || !Object.keys(data).length) return template.replace(/{{(.*?)}}/g, "");
+	return template.match(/{{(.*?)}}/g)?.reduce((prev, curr) => {
+		const index = curr.split(/{{|}}/).filter(Boolean)[0]?.trim();
+		if (index === void 0) return prev;
+		const value = data[index];
+		if (value === void 0) return prev;
+		return prev.replace(curr, () => {
+			if (typeof value === "boolean") return `${value.toString()}` || "false";
+			return value || "";
+		}).trim();
+	}, template) || "";
+}
+
+//#endregion
+//#region src/utils/resolveModuleSource.ts
+function resolveModuleSource(pkgName) {
+	const parentURL = import.meta.url;
+	const resolved = createJiti(parentURL).esmResolve(pkgName, parentURL);
+	const filePath = resolved.startsWith("file:") ? fileURLToPath(resolved) : resolved;
+	return {
+		path: filePath,
+		source: readFileSync(filePath, { encoding: "utf-8" }),
+		ext: path.extname(filePath)
+	};
+}
+
+//#endregion
+//#region src/utils/serializePluginOptions.ts
+/**
+* Serialize plugin options for safe JSON transport.
+* Strips functions, symbols, and undefined values recursively.
+*/
+function serializePluginOptions(options) {
+	if (options === null || options === void 0) return {};
+	if (typeof options !== "object") return options;
+	if (Array.isArray(options)) return options.map(serializePluginOptions);
+	const serialized = {};
+	for (const [key, value] of Object.entries(options)) {
+		if (typeof value === "function" || typeof value === "symbol" || value === void 0) continue;
+		if (typeof value === "object" && value !== null) serialized[key] = serializePluginOptions(value);
+		else serialized[key] = value;
+	}
+	return serialized;
+}
+
+//#endregion
+//#region src/utils/timeout.ts
+async function timeout(ms) {
+	return new Promise((resolve$1) => {
+		const timeout$1 = setTimeout(() => {
+			resolve$1(timeout$1);
+		}, ms);
+	}).then((timeout$1) => {
+		clearTimeout(timeout$1);
+		return true;
+	});
+}
+
+//#endregion
+export { AsyncEventEmitter, Cache, FunctionParams, URLPath, buildJSDoc, executeIfOnline, formatHrtime, formatMs, getBarrelFiles, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, renderTemplate, resolveModuleSource, serializePluginOptions, setUniqueName, timeout };
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +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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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/core",
-  "version": "4.23.0",
+  "version": "4.24.1",
   "description": "Core functionality for Kubb's plugin-based code generation system, providing the foundation for transforming OpenAPI specifications.",
   "keywords": [
     "typescript",

package/src/index.ts

@@ -7,7 +7,6 @@ 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 { startServer } from './server/index.ts'
 export * from './types.ts'
 export type { FileMetaBase } from './utils/getBarrelFiles.ts'
 export { getBarrelFiles } from './utils/getBarrelFiles.ts'

package/src/server/index.ts

@@ -1,11 +1,5 @@
-import { readFileSync } from 'node:fs'
-import type { IncomingMessage, Server, ServerResponse } from 'node:http'
-import { createServer } from 'node:http'
-import path from 'node:path'
-import process from 'node:process'
 import type { KubbFile } from '@kubb/fabric-core/types'
 import type { Config, KubbEvents } from '../types.ts'
-import { type AsyncEventEmitter, serializePluginOptions } from '../utils/index.ts'
 
 /**
  * Typed SSE events sent by the Kubb server.
@@ -76,8 +70,9 @@ export type InfoResponse = {
     }>
   }
 }
+
 /**
- * Same events asd KubbEvents but with server lifecycle events
+ * Same events as KubbEvents but with server lifecycle events
  */
 export type ServerEvents = KubbEvents & {
   /**
@@ -93,189 +88,3 @@ export type ServerEvents = KubbEvents & {
    */
   'server:stopped': []
 }
-
-type ServerOptions = {
-  port: number
-  host: string
-  configPath: string
-  config: Config
-  version: string
-  /**
-   * Event emitter for both server lifecycle and generation events
-   */
-  events: AsyncEventEmitter<ServerEvents>
-  /**
-   * Callback to handle code generation
-   * Should use the events emitter to emit generation events
-   */
-  onGenerate: () => Promise<void>
-}
-
-export async function startServer({ port, host, configPath, config, version, events, onGenerate }: ServerOptions): Promise<Server> {
-  const server = createServer(async (req: IncomingMessage, res: ServerResponse) => {
-    // Helper to send SSE events
-    function send<T extends SseEventType>(type: T, ...data: SseEvents[T]) {
-      const event: SseEvent = { type, data, timestamp: Date.now() }
-
-      res.write(`data: ${JSON.stringify(event)}\n\n`)
-    }
-
-    // Forward specific events to SSE stream with proper transformations
-    events.on('plugin:start', (plugin) => send('plugin:start', plugin))
-    events.on('plugin:end', (plugin, meta) => send('plugin:end', plugin, meta))
-
-    // Transform files:processing events to match StreamEvents format
-    events.on('files:processing:start', (files) => send('files:processing:start', { total: files.length }))
-    events.on('file:processing:update', (meta) => {
-      send('file:processing:update', {
-        file: meta.file.path,
-        processed: meta.processed,
-        total: meta.total,
-        percentage: meta.percentage,
-      })
-    })
-    events.on('files:processing:end', (files) => send('files:processing:end', { total: files.length }))
-
-    // Simple passthrough events
-    events.on('info', (message, info) => send('info', message, info))
-    events.on('success', (message, info) => send('success', message, info))
-    events.on('warn', (message, info) => send('warn', message, info))
-
-    // Transform generation events to match StreamEvents format
-    events.on('generation:start', (config) => {
-      send('generation:start', {
-        name: config.name,
-        plugins: config.plugins?.length || 0,
-      })
-    })
-    events.on('generation:end', (config, files, sources) => {
-      // Convert Map to Record for JSON serialization
-      const sourcesRecord: Record<string, string> = {}
-      sources.forEach((value, key) => {
-        sourcesRecord[key] = value
-      })
-      send('generation:end', config, files, sourcesRecord)
-    })
-
-    // Special handling for error events
-    events.on('error', (error: Error) => {
-      send('error', {
-        message: error.message,
-        stack: error.stack,
-      })
-    })
-
-    // CORS headers
-    res.setHeader('Access-Control-Allow-Origin', '*')
-    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS')
-    res.setHeader('Access-Control-Allow-Headers', 'Content-Type')
-
-    if (req.method === 'OPTIONS') {
-      res.writeHead(204)
-      res.end()
-      return
-    }
-
-    // Health check endpoint
-    if (req.url === '/api/health' && req.method === 'GET') {
-      res.writeHead(200, { 'Content-Type': 'application/json' })
-      const body: HealthResponse = { status: 'ok', version, configPath: path.relative(process.cwd(), configPath) }
-
-      res.end(JSON.stringify(body))
-
-      return
-    }
-
-    // Connect endpoint - returns config metadata and OpenAPI spec
-    if (req.url === '/api/info' && req.method === 'GET') {
-      res.writeHead(200, { 'Content-Type': 'application/json' })
-
-      // Read OpenAPI spec if available
-      let specContent: string | undefined
-      if (config && 'path' in config.input) {
-        const specPath = path.resolve(process.cwd(), config.root, config.input.path)
-        try {
-          specContent = readFileSync(specPath, 'utf-8')
-        } catch {
-          // Spec file not found or unreadable
-        }
-      }
-
-      const body: InfoResponse = {
-        version,
-        configPath: path.relative(process.cwd(), configPath),
-        spec: specContent,
-        config: {
-          name: config.name,
-          root: config.root,
-          input: {
-            path: 'path' in config.input ? config.input.path : undefined,
-          },
-          output: {
-            path: config.output.path,
-            write: config.output.write,
-            extension: config.output.extension,
-            barrelType: config.output.barrelType,
-          },
-          plugins: config.plugins?.map((plugin) => ({
-            name: `@kubb/${plugin.name}`,
-            options: serializePluginOptions(plugin.options),
-          })),
-        },
-      }
-
-      res.end(JSON.stringify(body))
-      return
-    }
-
-    // Generate endpoint
-    if (req.url === '/api/generate' && req.method === 'POST') {
-      try {
-        // Set SSE headers
-        res.writeHead(200, {
-          'Content-Type': 'text/event-stream',
-          'Cache-Control': 'no-cache',
-          Connection: 'keep-alive',
-        })
-
-        await onGenerate()
-      } catch (error) {
-        send('error', {
-          message: error instanceof Error ? error.message : 'Unknown error',
-          stack: error instanceof Error ? error.stack : undefined,
-        })
-      } finally {
-        send('lifecycle:end')
-
-        res.end()
-      }
-
-      return
-    }
-
-    // 404 for other routes
-    res.writeHead(404, { 'Content-Type': 'application/json' })
-    res.end(JSON.stringify({ error: 'Not found' }))
-  })
-
-  return new Promise((resolve) => {
-    server.listen(port, host, () => {
-      const address = server.address()
-      const actualPort = typeof address === 'object' && address ? address.port : port
-      const serverUrl = `http://${host}:${actualPort}`
-
-      events.emit('server:start', serverUrl, path.relative(process.cwd(), configPath))
-
-      resolve(server)
-    })
-
-    // Graceful shutdown
-    process.on('SIGINT', () => {
-      events.emit('server:shutdown')
-      server.close(() => {
-        events.emit('server:stopped')
-        process.exit(0)
-      })
-    })
-  })
-}

package/src/types.ts

@@ -392,4 +392,92 @@ 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'