@kubb/core 4.21.2 → 4.22.1

package/dist/index.d.cts

@@ -1,8 +1,9 @@
 import { t as __name } from "./chunk-DlpkT3g-.cjs";
-import { A as StreamEvents, C as UserLogger, D as HealthResponse, E as ConnectResponse, F as AsyncEventEmitter, M as KubbEvents, N as PluginManager, O as StreamEvent, P as getMode, S as UserConfig, T as UserPluginWithLifeCycle, _ as PluginLifecycleHooks, a as InputData, b as ResolveNameParams, c as Logger, d as Output, f as Plugin, g as PluginLifecycle, h as PluginKey, i as Group, j as PossiblePromise, k as StreamEventType, l as LoggerContext, m as PluginFactoryOptions, n as Config, o as InputPath, p as PluginContext, r as GetPluginFactoryOptions, s as LogLevel, t as BarrelType, u as LoggerOptions, v as PluginParameter, w as UserPlugin, x as ResolvePathParams, y as PluginWithLifeCycle } from "./types-DalqcJjU.cjs";
-import { n as getBarrelFiles, t as FileMetaBase } from "./getBarrelFiles-g6fYZe8A.cjs";
+import { A as AsyncEventEmitter, C as UserLogger, D as KubbEvents, E as PossiblePromise, O as PluginManager, S as UserConfig, T as UserPluginWithLifeCycle, _ as PluginLifecycleHooks, a as InputData, b as ResolveNameParams, c as Logger, d as Output, f as Plugin, g as PluginLifecycle, h as PluginKey, i as Group, k as getMode, l as LoggerContext, m as PluginFactoryOptions, n as Config, o as InputPath, p as PluginContext, r as GetPluginFactoryOptions, s as LogLevel, t as BarrelType, u as LoggerOptions, v as PluginParameter, w as UserPlugin, x as ResolvePathParams, y as PluginWithLifeCycle } from "./types-ulibr7zw.cjs";
+import { m as getBarrelFiles, p as FileMetaBase } from "./index-BfAwjQCB.cjs";
 import { KubbFile } from "@kubb/fabric-core/types";
 import { Fabric } from "@kubb/react-fabric";
+import { Server } from "node:http";
 
 //#region src/BaseGenerator.d.ts
 /**
@@ -156,5 +157,128 @@ declare class PromiseManager<TState = any> {
   }): TOutput;
 }
 //#endregion
-export { BarrelType, BaseGenerator, type CLIOptions, Config, ConnectResponse, type FileMetaBase, GetPluginFactoryOptions, Group, HealthResponse, InputData, InputPath, KubbEvents, LogLevel, Logger, LoggerContext, LoggerOptions, Output, PackageManager, Plugin, PluginContext, PluginFactoryOptions, PluginKey, PluginLifecycle, PluginLifecycleHooks, PluginManager, PluginParameter, PluginWithLifeCycle, PromiseManager, ResolveNameParams, ResolvePathParams, StreamEvent, StreamEventType, StreamEvents, UserConfig, UserLogger, UserPlugin, UserPluginWithLifeCycle, build, build as default, defineConfig, defineLogger, definePlugin, getBarrelFiles, getMode, isInputPath, safeBuild, setup };
+//#region src/server/index.d.ts
+/**
+ * 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.
+ */
+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': [];
+}
+type SseEventType = keyof SseEvents;
+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 */
+type HealthResponse = {
+  status: 'ok';
+  version: string;
+  configPath: string;
+};
+/** GET /api/info */
+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 asd KubbEvents but with server lifecycle events
+ */
+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': [];
+};
+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>;
+};
+declare function startServer({
+  port,
+  host,
+  configPath,
+  config,
+  version,
+  events,
+  onGenerate
+}: ServerOptions): Promise<Server>;
+//#endregion
+export { BarrelType, BaseGenerator, type CLIOptions, Config, type FileMetaBase, GetPluginFactoryOptions, Group, type HealthResponse, type InfoResponse, InputData, InputPath, KubbEvents, LogLevel, Logger, LoggerContext, LoggerOptions, Output, PackageManager, Plugin, PluginContext, PluginFactoryOptions, PluginKey, PluginLifecycle, PluginLifecycleHooks, PluginManager, PluginParameter, PluginWithLifeCycle, PromiseManager, ResolveNameParams, ResolvePathParams, type ServerEvents, type SseEvent, type SseEventType, type SseEvents, UserConfig, UserLogger, UserPlugin, UserPluginWithLifeCycle, build, build as default, defineConfig, defineLogger, definePlugin, getBarrelFiles, getMode, isInputPath, safeBuild, setup, startServer };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import { t as __name } from "./chunk-iVr_oF3V.js";
-import { A as StreamEvents, C as UserLogger, D as HealthResponse, E as ConnectResponse, F as AsyncEventEmitter, M as KubbEvents, N as PluginManager, O as StreamEvent, P as getMode, S as UserConfig, T as UserPluginWithLifeCycle, _ as PluginLifecycleHooks, a as InputData, b as ResolveNameParams, c as Logger, d as Output, f as Plugin, g as PluginLifecycle, h as PluginKey, i as Group, j as PossiblePromise, k as StreamEventType, l as LoggerContext, m as PluginFactoryOptions, n as Config, o as InputPath, p as PluginContext, r as GetPluginFactoryOptions, s as LogLevel, t as BarrelType, u as LoggerOptions, v as PluginParameter, w as UserPlugin, x as ResolvePathParams, y as PluginWithLifeCycle } from "./types-Dv2RimvH.js";
-import { n as getBarrelFiles, t as FileMetaBase } from "./getBarrelFiles-D_2NWu2Q.js";
+import { A as AsyncEventEmitter, C as UserLogger, D as KubbEvents, E as PossiblePromise, O as PluginManager, S as UserConfig, T as UserPluginWithLifeCycle, _ as PluginLifecycleHooks, a as InputData, b as ResolveNameParams, c as Logger, d as Output, f as Plugin, g as PluginLifecycle, h as PluginKey, i as Group, k as getMode, l as LoggerContext, m as PluginFactoryOptions, n as Config, o as InputPath, p as PluginContext, r as GetPluginFactoryOptions, s as LogLevel, t as BarrelType, u as LoggerOptions, v as PluginParameter, w as UserPlugin, x as ResolvePathParams, y as PluginWithLifeCycle } from "./types-Cn3Gwsf3.js";
+import { m as getBarrelFiles, p as FileMetaBase } from "./index-C0nP9vjm.js";
 import { Fabric } from "@kubb/react-fabric";
+import { Server } from "node:http";
 import { KubbFile } from "@kubb/fabric-core/types";
 
 //#region src/BaseGenerator.d.ts
@@ -156,5 +157,128 @@ declare class PromiseManager<TState = any> {
   }): TOutput;
 }
 //#endregion
-export { BarrelType, BaseGenerator, type CLIOptions, Config, ConnectResponse, type FileMetaBase, GetPluginFactoryOptions, Group, HealthResponse, InputData, InputPath, KubbEvents, LogLevel, Logger, LoggerContext, LoggerOptions, Output, PackageManager, Plugin, PluginContext, PluginFactoryOptions, PluginKey, PluginLifecycle, PluginLifecycleHooks, PluginManager, PluginParameter, PluginWithLifeCycle, PromiseManager, ResolveNameParams, ResolvePathParams, StreamEvent, StreamEventType, StreamEvents, UserConfig, UserLogger, UserPlugin, UserPluginWithLifeCycle, build, build as default, defineConfig, defineLogger, definePlugin, getBarrelFiles, getMode, isInputPath, safeBuild, setup };
+//#region src/server/index.d.ts
+/**
+ * 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.
+ */
+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': [];
+}
+type SseEventType = keyof SseEvents;
+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 */
+type HealthResponse = {
+  status: 'ok';
+  version: string;
+  configPath: string;
+};
+/** GET /api/info */
+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 asd KubbEvents but with server lifecycle events
+ */
+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': [];
+};
+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>;
+};
+declare function startServer({
+  port,
+  host,
+  configPath,
+  config,
+  version,
+  events,
+  onGenerate
+}: ServerOptions): Promise<Server>;
+//#endregion
+export { BarrelType, BaseGenerator, type CLIOptions, Config, type FileMetaBase, GetPluginFactoryOptions, Group, type HealthResponse, type InfoResponse, InputData, InputPath, KubbEvents, LogLevel, Logger, LoggerContext, LoggerOptions, Output, PackageManager, Plugin, PluginContext, PluginFactoryOptions, PluginKey, PluginLifecycle, PluginLifecycleHooks, PluginManager, PluginParameter, PluginWithLifeCycle, PromiseManager, ResolveNameParams, ResolvePathParams, type ServerEvents, type SseEvent, type SseEventType, type SseEvents, UserConfig, UserLogger, UserPlugin, UserPluginWithLifeCycle, build, build as default, defineConfig, defineLogger, definePlugin, getBarrelFiles, getMode, isInputPath, safeBuild, setup, startServer };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk-iVr_oF3V.js";
-import { a as getElapsedMs, c as getMode, d as PromiseManager, f as Queue, i as formatMs, n as URLPath, o as AsyncEventEmitter, p as BuildError, s as PluginManager, t as getBarrelFiles } from "./getBarrelFiles-gRyVPFBP.js";
+import { E as BuildError, T as Queue, _ as formatMs, b as PluginManager, h as URLPath, l as getBarrelFiles, n as serializePluginOptions, v as getElapsedMs, w as PromiseManager, x as getMode, y as AsyncEventEmitter } from "./utils-C3cuilmF.js";
 import { a as exists, i as readSync, n as getRelativePath, o as clean, r as read, t as write } from "./fs-Parec-wn.js";
 import "./transformers-8ju9ixkG.js";
 import mod from "node:module";
@@ -10,8 +10,9 @@ import { fsPlugin } from "@kubb/react-fabric/plugins";
 import process$1, { version } from "node:process";
 import os from "node:os";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import fs, { promises } from "node:fs";
+import fs, { promises, readFileSync } from "node:fs";
 import { coerce, satisfies } from "semver";
+import { createServer } from "node:http";
 
 //#region src/BaseGenerator.ts
 /**
@@ -68,7 +69,7 @@ function isInputPath(config) {
 
 //#endregion
 //#region package.json
-var version$1 = "4.21.2";
+var version$1 = "4.22.1";
 
 //#endregion
 //#region src/utils/diagnostics.ts
@@ -609,6 +610,141 @@ var PackageManager = class PackageManager {
 	}
 };
 
+//#endregion
+//#region src/server/index.ts
+async function startServer({ port, host, configPath, config, version: version$2, events, onGenerate }) {
+	const server = createServer(async (req, res) => {
+		function send(type, ...data) {
+			const event = {
+				type,
+				data,
+				timestamp: Date.now()
+			};
+			res.write(`data: ${JSON.stringify(event)}\n\n`);
+		}
+		events.on("plugin:start", (plugin) => send("plugin:start", plugin));
+		events.on("plugin:end", (plugin, meta) => send("plugin:end", plugin, meta));
+		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 }));
+		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));
+		events.on("generation:start", (config$1) => {
+			send("generation:start", {
+				name: config$1.name,
+				plugins: config$1.plugins?.length || 0
+			});
+		});
+		events.on("generation:end", (config$1, files, sources) => {
+			const sourcesRecord = {};
+			sources.forEach((value, key) => {
+				sourcesRecord[key] = value;
+			});
+			send("generation:end", config$1, files, sourcesRecord);
+		});
+		events.on("error", (error) => {
+			send("error", {
+				message: error.message,
+				stack: error.stack
+			});
+		});
+		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;
+		}
+		if (req.url === "/api/health" && req.method === "GET") {
+			res.writeHead(200, { "Content-Type": "application/json" });
+			const body = {
+				status: "ok",
+				version: version$2,
+				configPath: path.relative(process$1.cwd(), configPath)
+			};
+			res.end(JSON.stringify(body));
+			return;
+		}
+		if (req.url === "/api/info" && req.method === "GET") {
+			res.writeHead(200, { "Content-Type": "application/json" });
+			let specContent;
+			if (config && "path" in config.input) {
+				const specPath = path.resolve(process$1.cwd(), config.root, config.input.path);
+				try {
+					specContent = readFileSync(specPath, "utf-8");
+				} catch {}
+			}
+			const body = {
+				version: version$2,
+				configPath: path.relative(process$1.cwd(), configPath),
+				spec: specContent,
+				config: {
+					name: config.name,
+					root: config.root,
+					input: { path: "path" in config.input ? config.input.path : void 0 },
+					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;
+		}
+		if (req.url === "/api/generate" && req.method === "POST") {
+			try {
+				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 : void 0
+				});
+			} finally {
+				send("lifecycle:end");
+				res.end();
+			}
+			return;
+		}
+		res.writeHead(404, { "Content-Type": "application/json" });
+		res.end(JSON.stringify({ error: "Not found" }));
+	});
+	return new Promise((resolve$1) => {
+		server.listen(port, host, () => {
+			const address = server.address();
+			const serverUrl = `http://${host}:${typeof address === "object" && address ? address.port : port}`;
+			events.emit("server:start", serverUrl, path.relative(process$1.cwd(), configPath));
+			resolve$1(server);
+		});
+		process$1.on("SIGINT", () => {
+			events.emit("server:shutdown");
+			server.close(() => {
+				events.emit("server:stopped");
+				process$1.exit(0);
+			});
+		});
+	});
+}
+
 //#endregion
 //#region src/types.ts
 const LogLevel = {
@@ -621,5 +757,5 @@ const LogLevel = {
 };
 
 //#endregion
-export { BaseGenerator, LogLevel, PackageManager, PluginManager, PromiseManager, build, build as default, defineConfig, defineLogger, definePlugin, getBarrelFiles, getMode, isInputPath, safeBuild, setup };
+export { BaseGenerator, LogLevel, PackageManager, PluginManager, PromiseManager, build, build as default, defineConfig, defineLogger, definePlugin, getBarrelFiles, getMode, isInputPath, safeBuild, setup, startServer };
 //# sourceMappingURL=index.js.map