@zze/mock-server 0.2.4

package/dist/config/file-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../../src/config/file-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AASrE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAE3E;AAiCD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAgCpF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIvD"}

package/dist/config/file-loader.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSupportedExtension = isSupportedExtension;
+exports.loadConfigFile = loadConfigFile;
+exports.clearModuleCache = clearModuleCache;
+const jiti_1 = require("jiti");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const url_1 = require("url");
+const types_js_1 = require("./types.js");
+// Create jiti instance for loading TS/JS files
+const jiti = (0, jiti_1.createJiti)((0, url_1.pathToFileURL)(__filename).href, {
+    interopDefault: true,
+    moduleCache: false, // Disable cache for hot reload support
+});
+/**
+ * Check if a file extension is supported
+ */
+function isSupportedExtension(ext) {
+    return types_js_1.SUPPORTED_EXTENSIONS.includes(ext);
+}
+/**
+ * Load a JSON file
+ */
+async function loadJsonFile(filePath) {
+    const content = await (0, promises_1.readFile)(filePath, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Load a JS/TS file using jiti
+ */
+async function loadJsOrTsFile(filePath) {
+    // Clear module from cache to support hot reload
+    const fileUrl = (0, url_1.pathToFileURL)(filePath).href;
+    try {
+        const module = await jiti.import(fileUrl);
+        // Handle default exports
+        if (module && typeof module === 'object' && 'default' in module) {
+            return module.default;
+        }
+        return module;
+    }
+    catch (error) {
+        throw new Error(`Failed to load ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Load a single configuration file
+ * Supports .json, .js, .ts, .mjs, .mts extensions
+ */
+async function loadConfigFile(filePath) {
+    const ext = (0, path_1.extname)(filePath).toLowerCase();
+    if (!isSupportedExtension(ext)) {
+        return {
+            success: false,
+            filePath,
+            error: `Unsupported file extension: ${ext}. Supported: ${types_js_1.SUPPORTED_EXTENSIONS.join(', ')}`,
+        };
+    }
+    try {
+        let data;
+        if (ext === '.json') {
+            data = await loadJsonFile(filePath);
+        }
+        else {
+            data = await loadJsOrTsFile(filePath);
+        }
+        return {
+            success: true,
+            filePath,
+            data: data,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            filePath,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Clear the jiti module cache for a specific file
+ * Used during hot reload to ensure fresh imports
+ */
+function clearModuleCache(filePath) {
+    const fileUrl = (0, url_1.pathToFileURL)(filePath).href;
+    // jiti handles cache internally, but we can force fresh import by using moduleCache: false
+    // Additional cache busting could be implemented here if needed
+}

package/dist/config/file-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-loader.js","sourceRoot":"","sources":["../../src/config/file-loader.ts"],"names":[],"mappings":";;AAgBA,oDAEC;AAqCD,wCAgCC;AAMD,4CAIC;AAjGD,+BAAkC;AAClC,0CAAuC;AACvC,+BAA+B;AAC/B,6BAAoC;AAEpC,yCAAkD;AAElD,+CAA+C;AAC/C,MAAM,IAAI,GAAG,IAAA,iBAAU,EAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;IACvC,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,KAAK,EAAE,uCAAuC;CAC5D,CAAC,CAAC;AAEH;;GAEG;AACH,SAAgB,oBAAoB,CAAC,GAAW;IAC9C,OAAO,+BAAoB,CAAC,QAAQ,CAAC,GAAyB,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC1C,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,cAAc,CAAC,QAAgB;IAC5C,gDAAgD;IAChD,MAAM,OAAO,GAAG,IAAA,mBAAa,EAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE1C,yBAAyB;QACzB,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YAChE,OAAQ,MAA+B,CAAC,OAAO,CAAC;QAClD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,kBAAkB,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACxF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,cAAc,CAAI,QAAgB;IACtD,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAE5C,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ;YACR,KAAK,EAAE,+BAA+B,GAAG,gBAAgB,+BAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAC3F,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,IAAI,IAAa,CAAC;QAElB,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,IAAI,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ;YACR,IAAI,EAAE,IAAS;SAChB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ;YACR,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,OAAO,GAAG,IAAA,mBAAa,EAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;IAC7C,2FAA2F;IAC3F,+DAA+D;AACjE,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,7 @@
+export type { MockServerOptions, LoadedConfig, FileLoadResult, ConfigLoadResult, SupportedExtension, } from './types.js';
+export { SUPPORTED_EXTENSIONS } from './types.js';
+export { loadConfigFile, isSupportedExtension, clearModuleCache, } from './file-loader.js';
+export { discoverConfigFiles, directoryExists, getConfigDirectories, type DiscoveryOptions, } from './config-discovery.js';
+export { ConfigLoader, createConfigLoader } from './config-loader.js';
+export { ConfigWriter, createConfigWriter, type ConfigWriterOptions, type WriteResult, } from './config-writer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGtE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConfigWriter = exports.ConfigWriter = exports.createConfigLoader = exports.ConfigLoader = exports.getConfigDirectories = exports.directoryExists = exports.discoverConfigFiles = exports.clearModuleCache = exports.isSupportedExtension = exports.loadConfigFile = exports.SUPPORTED_EXTENSIONS = void 0;
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "SUPPORTED_EXTENSIONS", { enumerable: true, get: function () { return types_js_1.SUPPORTED_EXTENSIONS; } });
+// File loader
+var file_loader_js_1 = require("./file-loader.js");
+Object.defineProperty(exports, "loadConfigFile", { enumerable: true, get: function () { return file_loader_js_1.loadConfigFile; } });
+Object.defineProperty(exports, "isSupportedExtension", { enumerable: true, get: function () { return file_loader_js_1.isSupportedExtension; } });
+Object.defineProperty(exports, "clearModuleCache", { enumerable: true, get: function () { return file_loader_js_1.clearModuleCache; } });
+// Config discovery
+var config_discovery_js_1 = require("./config-discovery.js");
+Object.defineProperty(exports, "discoverConfigFiles", { enumerable: true, get: function () { return config_discovery_js_1.discoverConfigFiles; } });
+Object.defineProperty(exports, "directoryExists", { enumerable: true, get: function () { return config_discovery_js_1.directoryExists; } });
+Object.defineProperty(exports, "getConfigDirectories", { enumerable: true, get: function () { return config_discovery_js_1.getConfigDirectories; } });
+// Config loader
+var config_loader_js_1 = require("./config-loader.js");
+Object.defineProperty(exports, "ConfigLoader", { enumerable: true, get: function () { return config_loader_js_1.ConfigLoader; } });
+Object.defineProperty(exports, "createConfigLoader", { enumerable: true, get: function () { return config_loader_js_1.createConfigLoader; } });
+// Config writer
+var config_writer_js_1 = require("./config-writer.js");
+Object.defineProperty(exports, "ConfigWriter", { enumerable: true, get: function () { return config_writer_js_1.ConfigWriter; } });
+Object.defineProperty(exports, "createConfigWriter", { enumerable: true, get: function () { return config_writer_js_1.createConfigWriter; } });

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":";;;AASA,uCAAkD;AAAzC,gHAAA,oBAAoB,OAAA;AAE7B,cAAc;AACd,mDAI0B;AAHxB,gHAAA,cAAc,OAAA;AACd,sHAAA,oBAAoB,OAAA;AACpB,kHAAA,gBAAgB,OAAA;AAGlB,mBAAmB;AACnB,6DAK+B;AAJ7B,0HAAA,mBAAmB,OAAA;AACnB,sHAAA,eAAe,OAAA;AACf,2HAAA,oBAAoB,OAAA;AAItB,gBAAgB;AAChB,uDAAsE;AAA7D,gHAAA,YAAY,OAAA;AAAE,sHAAA,kBAAkB,OAAA;AAEzC,gBAAgB;AAChB,uDAK4B;AAJ1B,gHAAA,YAAY,OAAA;AACZ,sHAAA,kBAAkB,OAAA"}

package/dist/config/types.d.ts

@@ -0,0 +1,47 @@
+import type { EndpointConfig, FlowConfig } from '../schemas/index.js';
+/**
+ * Options for initializing the MockServer
+ */
+export interface MockServerOptions {
+    /** Base directory containing endpoints/ and flows/ folders */
+    configPath: string;
+    /** Port to run the server on (default: 3001) */
+    port?: number;
+    /** API prefix for mock endpoints (default: '/api') */
+    apiPrefix?: string;
+    /** Enable hot reload of config files (default: true in dev) */
+    hotReload?: boolean;
+}
+/**
+ * Loaded configuration from disk
+ */
+export interface LoadedConfig {
+    endpoints: EndpointConfig[];
+    flows: FlowConfig[];
+}
+/**
+ * Result of loading a single config file
+ */
+export interface FileLoadResult<T> {
+    success: boolean;
+    filePath: string;
+    data?: T;
+    error?: string;
+}
+/**
+ * Result of loading all configuration
+ */
+export interface ConfigLoadResult {
+    success: boolean;
+    config?: LoadedConfig;
+    errors: Array<{
+        filePath: string;
+        error: string;
+    }>;
+}
+/**
+ * Supported file extensions for config files
+ */
+export declare const SUPPORTED_EXTENSIONS: readonly [".json", ".js", ".ts", ".mjs", ".mts"];
+export type SupportedExtension = (typeof SUPPORTED_EXTENSIONS)[number];
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,KAAK,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,kDAAmD,CAAC;AAErF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/config/types.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_EXTENSIONS = void 0;
+/**
+ * Supported file extensions for config files
+ */
+exports.SUPPORTED_EXTENSIONS = ['.json', '.js', '.ts', '.mjs', '.mts'];

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":";;;AA8CA;;GAEG;AACU,QAAA,oBAAoB,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @zze/mock-server - A reusable Node.js mock server for microfrontend development
+ *
+ * @example
+ * ```typescript
+ * import { MockServer } from '@zze/mock-server';
+ *
+ * const server = new MockServer({
+ *   configPath: './mock-config',
+ *   port: 3001,
+ *   apiPrefix: '/api',
+ *   hotReload: true
+ * });
+ *
+ * await server.start();
+ * console.log('Mock server running on port 3001');
+ *
+ * // Later...
+ * await server.stop();
+ * ```
+ */
+export { MockServer, createMockServer, type MockServerOptions, type MockServerState, type OnReloadCallback, type OnErrorCallback, } from './mock-server.js';
+export type { EndpointConfig, ScenarioConfig, FlowConfig, HttpMethod, ResponseBody, } from './schemas/index.js';
+export type { ServerOptions, ServerState, RegisteredRoute } from './server/types.js';
+export type { ReloadEvent, WatcherOptions, WatcherEvent } from './watcher/types.js';
+export type { LoadedConfig, ConfigLoadResult } from './config/types.js';
+export { ADMIN_UI_PATH } from './server/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrF,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpF,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGxE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * @zze/mock-server - A reusable Node.js mock server for microfrontend development
+ *
+ * @example
+ * ```typescript
+ * import { MockServer } from '@zze/mock-server';
+ *
+ * const server = new MockServer({
+ *   configPath: './mock-config',
+ *   port: 3001,
+ *   apiPrefix: '/api',
+ *   hotReload: true
+ * });
+ *
+ * await server.start();
+ * console.log('Mock server running on port 3001');
+ *
+ * // Later...
+ * await server.stop();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADMIN_UI_PATH = exports.createMockServer = exports.MockServer = void 0;
+// Main public API
+var mock_server_js_1 = require("./mock-server.js");
+Object.defineProperty(exports, "MockServer", { enumerable: true, get: function () { return mock_server_js_1.MockServer; } });
+Object.defineProperty(exports, "createMockServer", { enumerable: true, get: function () { return mock_server_js_1.createMockServer; } });
+// Re-export the admin path constant for consumers who need it
+var index_js_1 = require("./server/index.js");
+Object.defineProperty(exports, "ADMIN_UI_PATH", { enumerable: true, get: function () { return index_js_1.ADMIN_UI_PATH; } });

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,kBAAkB;AAClB,mDAO0B;AANxB,4GAAA,UAAU,OAAA;AACV,kHAAA,gBAAgB,OAAA;AAqBlB,8DAA8D;AAC9D,8CAAkD;AAAzC,yGAAA,aAAa,OAAA"}

package/dist/mock-server.d.ts

@@ -0,0 +1,243 @@
+/**
+ * MockServer - Public API for the mock server package
+ *
+ * This is the main entry point for consumers of the package.
+ * It provides a simple interface to configure, start, and stop the mock server.
+ */
+import type { WatcherOptions } from './watcher/types.js';
+import type { ReloadEvent } from './watcher/types.js';
+import type { EndpointConfig, FlowConfig } from './schemas/index.js';
+import type { Server } from 'http';
+import type { Express } from 'express';
+/**
+ * Options for creating a MockServer instance
+ */
+export interface MockServerOptions {
+    /**
+     * Path to the configuration directory containing endpoints/ and flows/ subdirectories.
+     * Can be absolute or relative to the current working directory.
+     */
+    configPath: string;
+    /**
+     * Port to run the server on.
+     * @default 3001
+     */
+    port?: number;
+    /**
+     * API prefix for mock endpoints.
+     * @default '/api'
+     */
+    apiPrefix?: string;
+    /**
+     * Enable hot reload of configuration files.
+     * When enabled, changes to config files will automatically update the server.
+     * @default true
+     */
+    hotReload?: boolean;
+    /**
+     * Options for the file watcher (only used when hotReload is true).
+     */
+    watcherOptions?: WatcherOptions;
+}
+/**
+ * Current state of the mock server
+ */
+export interface MockServerState {
+    /** Whether the server is currently running */
+    running: boolean;
+    /** The port the server is listening on (null if not running) */
+    port: number | null;
+    /** Number of registered endpoints */
+    endpointCount: number;
+    /** Number of registered flows */
+    flowCount: number;
+    /** Whether hot reload is enabled and active */
+    hotReloadActive: boolean;
+    /** Currently active flow ID */
+    activeFlowId: string | null;
+    /** Map of endpoint IDs to their active scenario IDs */
+    activeScenarios: Record<string, string | null>;
+}
+/**
+ * Callback for reload events
+ */
+export type OnReloadCallback = (event: ReloadEvent) => void | Promise<void>;
+/**
+ * Callback for error events
+ */
+export type OnErrorCallback = (error: Error) => void;
+/**
+ * MockServer - Main class for creating and managing a mock server
+ *
+ * @example
+ * ```typescript
+ * import { MockServer } from '@zze/mock-server';
+ *
+ * const server = new MockServer({
+ *   configPath: './mock-config',
+ *   port: 3001,
+ *   apiPrefix: '/api',
+ *   hotReload: true
+ * });
+ *
+ * await server.start();
+ * console.log('Mock server running on port 3001');
+ *
+ * // Later...
+ * await server.stop();
+ * ```
+ */
+export declare class MockServer {
+    private readonly options;
+    private configLoader;
+    private configWriter;
+    private serverApp;
+    private watcher;
+    private reloadCallbacks;
+    private errorCallbacks;
+    private loadedEndpoints;
+    private loadedFlows;
+    /**
+     * Create a new MockServer instance
+     *
+     * @param options - Configuration options for the server
+     */
+    constructor(options: MockServerOptions);
+    /**
+     * Start the mock server
+     *
+     * This method:
+     * 1. Loads configuration from the config directory
+     * 2. Creates and starts the Express server
+     * 3. Optionally starts the file watcher for hot reload
+     *
+     * @returns Promise that resolves when the server is ready
+     * @throws Error if configuration loading fails or server fails to start
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the mock server
+     *
+     * This method:
+     * 1. Stops the file watcher (if running)
+     * 2. Stops the Express server
+     *
+     * @returns Promise that resolves when the server has stopped
+     */
+    stop(): Promise<void>;
+    /**
+     * Restart the mock server
+     *
+     * This is a convenience method that stops and starts the server.
+     *
+     * @returns Promise that resolves when the server has restarted
+     */
+    restart(): Promise<void>;
+    /**
+     * Manually trigger a configuration reload
+     *
+     * This reloads all configuration files and updates the server routes.
+     * Useful when hot reload is disabled but you want to reload manually.
+     *
+     * @returns Promise that resolves when the reload is complete
+     */
+    reload(): Promise<void>;
+    /**
+     * Get the current state of the mock server
+     *
+     * @returns Current server state
+     */
+    getState(): MockServerState;
+    /**
+     * Get the configuration path
+     *
+     * @returns The configuration directory path
+     */
+    getConfigPath(): string;
+    /**
+     * Get the server options
+     *
+     * @returns The effective server options (with defaults applied)
+     */
+    getOptions(): MockServerOptions;
+    /**
+     * Get the underlying Express app instance
+     *
+     * This is useful for adding custom middleware or routes.
+     * Returns null if the server is not running.
+     *
+     * @returns Express app or null
+     */
+    getApp(): Express | null;
+    /**
+     * Get the underlying HTTP server instance
+     *
+     * Returns null if the server is not running.
+     *
+     * @returns HTTP server or null
+     */
+    getHttpServer(): Server | null;
+    /**
+     * Get the loaded endpoints
+     *
+     * @returns Array of endpoint configurations or empty array if not running
+     */
+    getEndpoints(): EndpointConfig[];
+    /**
+     * Get the loaded flows
+     *
+     * @returns Array of flow configurations or empty array if not running
+     */
+    getFlows(): FlowConfig[];
+    /**
+     * Activate a specific scenario for an endpoint
+     *
+     * @param endpointId - The endpoint ID
+     * @param scenarioId - The scenario ID to activate
+     */
+    activateScenario(endpointId: string, scenarioId: string): void;
+    /**
+     * Activate a flow
+     *
+     * @param flowId - The flow ID to activate, or null to deactivate
+     */
+    activateFlow(flowId: string | null): void;
+    /**
+     * Reset the server state to defaults
+     *
+     * This clears the active flow and resets all endpoint scenarios to their defaults.
+     */
+    reset(): void;
+    /**
+     * Register a callback to be called when configuration is reloaded
+     *
+     * @param callback - Function to call on reload
+     * @returns Function to unregister the callback
+     */
+    onReload(callback: OnReloadCallback): () => void;
+    /**
+     * Register a callback to be called on errors
+     *
+     * @param callback - Function to call on error
+     * @returns Function to unregister the callback
+     */
+    onError(callback: OnErrorCallback): () => void;
+    /**
+     * Start the file watcher for hot reload
+     */
+    private startWatcher;
+    /**
+     * Emit an error to all registered error callbacks
+     */
+    private emitError;
+}
+/**
+ * Create a new MockServer instance
+ *
+ * This is a convenience function for creating a MockServer.
+ *
+ * @param options - Configuration options for the server
+ * @returns A new MockServer instance
+ */
+export declare function createMockServer(options: MockServerOptions): MockServer;
+//# sourceMappingURL=mock-server.d.ts.map

package/dist/mock-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-server.d.ts","sourceRoot":"","sources":["../src/mock-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGvC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,eAAe,EAAE,OAAO,CAAC;IACzB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IACF,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,WAAW,CAAoB;IAEvC;;;;OAIG;gBACS,OAAO,EAAE,iBAAiB;IAoBtC;;;;;;;;;;OAUG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC5B;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;;;;;;OAOG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB7B;;;;OAIG;IACH,QAAQ,IAAI,eAAe;IA4B3B;;;;OAIG;IACH,aAAa,IAAI,MAAM;IAIvB;;;;OAIG;IACH,UAAU,IAAI,iBAAiB;IAI/B;;;;;;;OAOG;IACH,MAAM,IAAI,OAAO,GAAG,IAAI;IAIxB;;;;;;OAMG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B;;;;OAIG;IACH,YAAY,IAAI,cAAc,EAAE;IAIhC;;;;OAIG;IACH,QAAQ,IAAI,UAAU,EAAE;IAIxB;;;;;OAKG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAQ9D;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAYzC;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAQb;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAUhD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAU9C;;OAEG;YACW,YAAY;IAyC1B;;OAEG;IACH,OAAO,CAAC,SAAS;CASlB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAEvE"}