@zze/mock-server 0.2.6 → 0.6.0

package/dist/config/types.d.ts

@@ -1,4 +1,12 @@
 import type { EndpointConfig, FlowConfig } from '../schemas/index.js';
+export type RuntimeEndpointConfig = EndpointConfig & {
+    sourceFile?: string;
+};
+/** Validated endpoint config with loader-derived metadata */
+export type LoadedEndpointConfig = RuntimeEndpointConfig & {
+    /** Path relative to the endpoints directory, normalized for API consumers */
+    sourceFile: string;
+};
 /**
  * Options for initializing the MockServer
  */
@@ -16,7 +24,7 @@ export interface MockServerOptions {
  * Loaded configuration from disk
  */
 export interface LoadedConfig {
-    endpoints: EndpointConfig[];
+    endpoints: LoadedEndpointConfig[];
     flows: FlowConfig[];
 }
 /**

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

@@ -1 +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"}
+{"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,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,GAAG;IACzD,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;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,oBAAoB,EAAE,CAAC;IAClC,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/mock-server.d.ts

@@ -38,6 +38,15 @@ export interface MockServerOptions {
      * Options for the file watcher (only used when hotReload is true).
      */
     watcherOptions?: WatcherOptions;
+    /**
+     * Global delay applied to every response when the matched scenario has no explicit `delay`.
+     * A number is a fixed millisecond value; a tuple [min, max] produces a random value in that range.
+     * Scenario-level `delay` always takes precedence.
+     * @example
+     * globalDelay: 200          // every response waits 200 ms (unless scenario overrides)
+     * globalDelay: [100, 500]   // each response waits a random 100-500 ms
+     */
+    globalDelay?: number | [number, number];
 }
 /**
  * Current state of the mock server

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

@@ -1 +1 @@
-{"version":3,"file":"mock-server.d.ts","sourceRoot":"","sources":["../src/mock-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mock-server.d.ts","sourceRoot":"","sources":["../src/mock-server.ts"],"names":[],"mappings":"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"}

package/dist/mock-server.js

@@ -57,6 +57,7 @@ class MockServer {
             apiPrefix: options.apiPrefix ?? '/api',
             hotReload: options.hotReload ?? true,
             watcherOptions: options.watcherOptions,
+            globalDelay: options.globalDelay,
         };
         // Create config loader
         this.configLoader = new config_loader_js_1.ConfigLoader(this.options.configPath);
@@ -85,6 +86,8 @@ class MockServer {
                 port: this.options.port,
                 apiPrefix: this.options.apiPrefix,
                 hotReload: this.options.hotReload,
+                configPath: this.options.configPath,
+                globalDelay: this.options.globalDelay,
             };
             this.serverApp = new mock_server_app_js_1.MockServerApp(serverOptions);
             // Set config writer for endpoint/flow management via admin API

package/dist/resolver/__tests__/response-resolver.test.js

@@ -355,4 +355,138 @@ const mockEndpoints = [
         const resolver = (0, response_resolver_js_1.createResponseResolver)(stateManager);
         (0, vitest_1.expect)(resolver).toBeInstanceOf(response_resolver_js_1.ResponseResolver);
     });
+    (0, vitest_1.it)('should accept optional configPath', () => {
+        const stateManager = new index_js_1.StateManager();
+        const resolver = (0, response_resolver_js_1.createResponseResolver)(stateManager, '/some/path');
+        (0, vitest_1.expect)(resolver).toBeInstanceOf(response_resolver_js_1.ResponseResolver);
+    });
+});
+(0, vitest_1.describe)('file response', () => {
+    let stateManager;
+    let resolver;
+    const fileEndpoint = {
+        id: 'download-report',
+        path: '/reports/report.pdf',
+        method: 'GET',
+        scenarios: [
+            {
+                id: 'pdf',
+                name: 'PDF Report',
+                status: 200,
+                file: './fixtures/report.pdf',
+            },
+        ],
+        defaultScenarioId: 'pdf',
+    };
+    const jsonEndpoint = {
+        id: 'get-data',
+        path: '/data',
+        method: 'GET',
+        scenarios: [{ id: 'success', name: 'Success', status: 200, body: { ok: true } }],
+        defaultScenarioId: 'success',
+    };
+    (0, vitest_1.beforeEach)(() => {
+        stateManager = new index_js_1.StateManager();
+        stateManager.setEndpoints([fileEndpoint, jsonEndpoint]);
+        resolver = (0, response_resolver_js_1.createResponseResolver)(stateManager, '/config/path');
+        resolver.setEndpoints([fileEndpoint, jsonEndpoint]);
+    });
+    (0, vitest_1.it)('should resolve filePath in ResolvedResponse when scenario has file', () => {
+        const req = createMockRequest();
+        const resolved = resolver.resolveResponse('download-report', req);
+        (0, vitest_1.expect)(resolved).not.toBeNull();
+        (0, vitest_1.expect)(resolved.filePath).toBe('/config/path/fixtures/report.pdf');
+        (0, vitest_1.expect)(resolved.body).toBeUndefined();
+    });
+    (0, vitest_1.it)('should update filePath when configPath changes via setConfigPath', () => {
+        resolver.setConfigPath('/new/config');
+        const req = createMockRequest();
+        const resolved = resolver.resolveResponse('download-report', req);
+        (0, vitest_1.expect)(resolved.filePath).toBe('/new/config/fixtures/report.pdf');
+    });
+    (0, vitest_1.it)('should not set filePath for JSON scenarios', () => {
+        const req = createMockRequest();
+        const resolved = resolver.resolveResponse('get-data', req);
+        (0, vitest_1.expect)(resolved.filePath).toBeUndefined();
+    });
+});
+(0, vitest_1.describe)('resolveDelay', () => {
+    (0, vitest_1.it)('should return scenario delay when defined', () => {
+        (0, vitest_1.expect)((0, response_resolver_js_1.resolveDelay)(200)).toBe(200);
+    });
+    (0, vitest_1.it)('should return scenario delay even when globalDelay is also set', () => {
+        (0, vitest_1.expect)((0, response_resolver_js_1.resolveDelay)(50, 500)).toBe(50);
+        (0, vitest_1.expect)((0, response_resolver_js_1.resolveDelay)(0, 500)).toBe(0);
+    });
+    (0, vitest_1.it)('should return 0 when neither scenario delay nor globalDelay is set', () => {
+        (0, vitest_1.expect)((0, response_resolver_js_1.resolveDelay)(undefined)).toBe(0);
+        (0, vitest_1.expect)((0, response_resolver_js_1.resolveDelay)(undefined, undefined)).toBe(0);
+    });
+    (0, vitest_1.it)('should return static globalDelay when scenario has no delay', () => {
+        (0, vitest_1.expect)((0, response_resolver_js_1.resolveDelay)(undefined, 300)).toBe(300);
+    });
+    (0, vitest_1.it)('should return a value within [min, max] range when globalDelay is a tuple', () => {
+        const results = Array.from({ length: 50 }, () => (0, response_resolver_js_1.resolveDelay)(undefined, [100, 200]));
+        for (const r of results) {
+            (0, vitest_1.expect)(r).toBeGreaterThanOrEqual(100);
+            (0, vitest_1.expect)(r).toBeLessThanOrEqual(200);
+        }
+    });
+});
+(0, vitest_1.describe)('ResponseResolver globalDelay', () => {
+    const endpoint = {
+        id: 'ep',
+        path: '/ep',
+        method: 'GET',
+        scenarios: [
+            { id: 'no-delay', name: 'No delay', status: 200, body: 'ok' },
+            { id: 'with-delay', name: 'With delay', status: 200, body: 'ok', delay: 10 },
+        ],
+        defaultScenarioId: 'no-delay',
+    };
+    (0, vitest_1.it)('should apply static globalDelay when scenario has no delay', () => {
+        const sm = new index_js_1.StateManager();
+        sm.setEndpoints([endpoint]);
+        const resolver = (0, response_resolver_js_1.createResponseResolver)(sm, '', 150);
+        resolver.setEndpoints([endpoint]);
+        const resolved = resolver.resolveResponse('ep', createMockRequest());
+        (0, vitest_1.expect)(resolved.delay).toBe(150);
+    });
+    (0, vitest_1.it)('should apply a range globalDelay within bounds', () => {
+        const sm = new index_js_1.StateManager();
+        sm.setEndpoints([endpoint]);
+        const resolver = (0, response_resolver_js_1.createResponseResolver)(sm, '', [50, 100]);
+        resolver.setEndpoints([endpoint]);
+        for (let i = 0; i < 20; i++) {
+            const resolved = resolver.resolveResponse('ep', createMockRequest());
+            (0, vitest_1.expect)(resolved.delay).toBeGreaterThanOrEqual(50);
+            (0, vitest_1.expect)(resolved.delay).toBeLessThanOrEqual(100);
+        }
+    });
+    (0, vitest_1.it)('should use scenario delay over globalDelay when scenario has delay set', () => {
+        const sm = new index_js_1.StateManager();
+        sm.setEndpoints([endpoint]);
+        sm.activateScenario('ep', 'with-delay');
+        const resolver = (0, response_resolver_js_1.createResponseResolver)(sm, '', 999);
+        resolver.setEndpoints([endpoint]);
+        const resolved = resolver.resolveResponse('ep', createMockRequest());
+        (0, vitest_1.expect)(resolved.delay).toBe(10);
+    });
+    (0, vitest_1.it)('should default to 0 delay when no scenario delay and no globalDelay', () => {
+        const sm = new index_js_1.StateManager();
+        sm.setEndpoints([endpoint]);
+        const resolver = (0, response_resolver_js_1.createResponseResolver)(sm);
+        resolver.setEndpoints([endpoint]);
+        const resolved = resolver.resolveResponse('ep', createMockRequest());
+        (0, vitest_1.expect)(resolved.delay).toBe(0);
+    });
+    (0, vitest_1.it)('should update globalDelay via setGlobalDelay', () => {
+        const sm = new index_js_1.StateManager();
+        sm.setEndpoints([endpoint]);
+        const resolver = (0, response_resolver_js_1.createResponseResolver)(sm);
+        resolver.setEndpoints([endpoint]);
+        resolver.setGlobalDelay(250);
+        const resolved = resolver.resolveResponse('ep', createMockRequest());
+        (0, vitest_1.expect)(resolved.delay).toBe(250);
+    });
 });

package/dist/resolver/response-resolver.d.ts

@@ -10,7 +10,17 @@ export declare class ResponseResolver {
     private stateManager;
     private endpoints;
     private routeMap;
-    constructor(stateManager: StateManager);
+    private configPath;
+    private globalDelay;
+    constructor(stateManager: StateManager, configPath?: string, globalDelay?: number | [number, number]);
+    /**
+     * Update the config path (used when config is reloaded from a new location)
+     */
+    setConfigPath(configPath: string): void;
+    /**
+     * Update the global delay at runtime
+     */
+    setGlobalDelay(globalDelay: number | [number, number] | undefined): void;
     /**
      * Register endpoints for routing
      */
@@ -66,8 +76,14 @@ export declare class ResponseResolver {
      */
     handleRequest(endpointId: string, req: Request, res: Response): Promise<boolean>;
 }
+/**
+ * Resolve the effective delay for a response.
+ * The scenario's own delay (when defined) always wins over the global fallback.
+ * A globalDelay tuple [min, max] produces a uniformly distributed random value.
+ */
+export declare function resolveDelay(scenarioDelay: number | undefined, globalDelay?: number | [number, number]): number;
 /**
  * Create a new ResponseResolver instance
  */
-export declare function createResponseResolver(stateManager: StateManager): ResponseResolver;
+export declare function createResponseResolver(stateManager: StateManager, configPath?: string, globalDelay?: number | [number, number]): ResponseResolver;
 //# sourceMappingURL=response-resolver.d.ts.map

package/dist/resolver/response-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-resolver.d.ts","sourceRoot":"","sources":["../../src/resolver/response-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAiB,MAAM,YAAY,CAAC;AAGlF;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,QAAQ,CAA0C;gBAE9C,YAAY,EAAE,YAAY;IAItC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI;IAY/C;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAKjE;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAI1D;;OAEG;IACH,YAAY,IAAI,cAAc,EAAE;IAIhC;;;OAGG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI;IAc1E;;OAEG;IACH,sBAAsB,CACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,GACX,gBAAgB,GAAG,IAAI;IAS1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc;IAYlD;;OAEG;IACG,YAAY,CAChB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC;IAOnB;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C;;OAEG;IACG,YAAY,CAChB,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,IAAI,CAAC;IAyBhB;;;OAGG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,OAAO,CAAC;CASpB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,YAAY,GAAG,gBAAgB,CAEnF"}
+{"version":3,"file":"response-resolver.d.ts","sourceRoot":"","sources":["../../src/resolver/response-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAiB,MAAM,YAAY,CAAC;AAGlF;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAwC;gBAGzD,YAAY,EAAE,YAAY,EAC1B,UAAU,GAAE,MAAW,EACvB,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAOzC;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIvC;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,IAAI;IAIxE;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI;IAY/C;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAKjE;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAI1D;;OAEG;IACH,YAAY,IAAI,cAAc,EAAE;IAIhC;;;OAGG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI;IAc1E;;OAEG;IACH,sBAAsB,CACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,GACX,gBAAgB,GAAG,IAAI;IAS1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc;IAYlD;;OAEG;IACG,YAAY,CAChB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC;IAOnB;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C;;OAEG;IACG,YAAY,CAChB,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,IAAI,CAAC;IA2ChB;;;OAGG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,OAAO,CAAC;CASpB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,YAAY,EAC1B,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,gBAAgB,CAElB"}

package/dist/resolver/response-resolver.js

@@ -1,17 +1,36 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResponseResolver = void 0;
+exports.resolveDelay = resolveDelay;
 exports.createResponseResolver = createResponseResolver;
+const path_1 = __importDefault(require("path"));
 const types_js_1 = require("./types.js");
 /**
  * Resolves which response to send for incoming requests
  * Uses StateManager to determine active scenario based on priority chain
  */
 class ResponseResolver {
-    constructor(stateManager) {
+    constructor(stateManager, configPath = '', globalDelay) {
         this.endpoints = new Map();
         this.routeMap = new Map();
         this.stateManager = stateManager;
+        this.configPath = configPath;
+        this.globalDelay = globalDelay;
+    }
+    /**
+     * Update the config path (used when config is reloaded from a new location)
+     */
+    setConfigPath(configPath) {
+        this.configPath = configPath;
+    }
+    /**
+     * Update the global delay at runtime
+     */
+    setGlobalDelay(globalDelay) {
+        this.globalDelay = globalDelay;
     }
     /**
      * Register endpoints for routing
@@ -80,14 +99,18 @@ class ResponseResolver {
      * Build the resolved response from endpoint and scenario
      */
     buildResponse(endpoint, scenario, req) {
-        return {
+        const resolved = {
             status: scenario.status,
             headers: scenario.headers ?? {},
             body: scenario.body,
-            delay: scenario.delay ?? 0,
+            delay: resolveDelay(scenario.delay, this.globalDelay),
             scenario,
             endpoint,
         };
+        if (scenario.file) {
+            resolved.filePath = path_1.default.resolve(this.configPath, scenario.file);
+        }
+        return resolved;
     }
     /**
      * Create request context for dynamic body functions
@@ -130,6 +153,24 @@ class ResponseResolver {
         for (const [key, value] of Object.entries(resolved.headers)) {
             res.setHeader(key, value);
         }
+        // File download response
+        if ((0, types_js_1.isFileResponse)(resolved)) {
+            await new Promise((resolve, reject) => {
+                res.status(resolved.status).sendFile(resolved.filePath, (err) => {
+                    if (err) {
+                        // File not found or send error
+                        if (!res.headersSent) {
+                            res.status(404).json({ error: `File not found: ${resolved.filePath}` });
+                        }
+                        resolve();
+                    }
+                    else {
+                        resolve();
+                    }
+                });
+            });
+            return;
+        }
         // Evaluate body (handle dynamic functions)
         const context = this.createRequestContext(req);
         const body = await this.evaluateBody(resolved.body, context);
@@ -159,9 +200,25 @@ class ResponseResolver {
     }
 }
 exports.ResponseResolver = ResponseResolver;
+/**
+ * Resolve the effective delay for a response.
+ * The scenario's own delay (when defined) always wins over the global fallback.
+ * A globalDelay tuple [min, max] produces a uniformly distributed random value.
+ */
+function resolveDelay(scenarioDelay, globalDelay) {
+    if (scenarioDelay !== undefined)
+        return scenarioDelay;
+    if (globalDelay === undefined)
+        return 0;
+    if (Array.isArray(globalDelay)) {
+        const [min, max] = globalDelay;
+        return Math.floor(Math.random() * (max - min + 1)) + min;
+    }
+    return globalDelay;
+}
 /**
  * Create a new ResponseResolver instance
  */
-function createResponseResolver(stateManager) {
-    return new ResponseResolver(stateManager);
+function createResponseResolver(stateManager, configPath, globalDelay) {
+    return new ResponseResolver(stateManager, configPath, globalDelay);
 }

package/dist/resolver/types.d.ts

@@ -10,6 +10,8 @@ export interface ResolvedResponse {
     headers: Record<string, string>;
     /** Response body */
     body: unknown;
+    /** Absolute path to file for file download responses */
+    filePath?: string;
     /** Delay in milliseconds before sending response */
     delay: number;
     /** The scenario that was resolved */
@@ -17,6 +19,12 @@ export interface ResolvedResponse {
     /** The endpoint that was matched */
     endpoint: EndpointConfig;
 }
+/**
+ * Check if a resolved response is a file download
+ */
+export declare function isFileResponse(resolved: ResolvedResponse): resolved is ResolvedResponse & {
+    filePath: string;
+};
 /**
  * Context passed to dynamic body functions
  */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resolver/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,oBAAoB;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,QAAQ,EAAE,cAAc,CAAC;IACzB,oCAAoC;IACpC,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,mBAAmB;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,aAAa,CAElE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resolver/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,oBAAoB;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,QAAQ,EAAE,cAAc,CAAC;IACzB,oCAAoC;IACpC,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,QAAQ,IAAI,gBAAgB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAE9G;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,mBAAmB;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,aAAa,CAElE"}

package/dist/resolver/types.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFileResponse = isFileResponse;
 exports.isDynamicBody = isDynamicBody;
+/**
+ * Check if a resolved response is a file download
+ */
+function isFileResponse(resolved) {
+    return resolved.filePath !== undefined;
+}
 /**
  * Check if a value is a dynamic body function
  */

package/dist/schemas/__tests__/endpoint.schema.test.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const vitest_1 = require("vitest");
 const endpoint_schema_js_1 = require("../endpoint.schema.js");
+const scenario_schema_js_1 = require("../scenario.schema.js");
 (0, vitest_1.describe)('EndpointConfigSchema', () => {
     const validEndpoint = {
         id: 'get-user-data',
@@ -101,3 +102,50 @@ const endpoint_schema_js_1 = require("../endpoint.schema.js");
         (0, vitest_1.expect)(result.duplicates).toContain('users');
     });
 });
+(0, vitest_1.describe)('ScenarioConfigSchema - file field', () => {
+    const baseScenario = {
+        id: 'download',
+        name: 'Download',
+        status: 200,
+    };
+    (0, vitest_1.it)('should accept a scenario with only a file field', () => {
+        const result = scenario_schema_js_1.ScenarioConfigSchema.safeParse({
+            ...baseScenario,
+            file: './assets/report.pdf',
+        });
+        (0, vitest_1.expect)(result.success).toBe(true);
+        if (result.success) {
+            (0, vitest_1.expect)(result.data.file).toBe('./assets/report.pdf');
+            (0, vitest_1.expect)(result.data.body).toBeUndefined();
+        }
+    });
+    (0, vitest_1.it)('should accept a scenario with only a body field', () => {
+        const result = scenario_schema_js_1.ScenarioConfigSchema.safeParse({
+            ...baseScenario,
+            body: { ok: true },
+        });
+        (0, vitest_1.expect)(result.success).toBe(true);
+    });
+    (0, vitest_1.it)('should accept a scenario with neither body nor file', () => {
+        const result = scenario_schema_js_1.ScenarioConfigSchema.safeParse(baseScenario);
+        (0, vitest_1.expect)(result.success).toBe(true);
+    });
+    (0, vitest_1.it)('should reject a scenario with both body and file', () => {
+        const result = scenario_schema_js_1.ScenarioConfigSchema.safeParse({
+            ...baseScenario,
+            body: { data: 'some json' },
+            file: './assets/report.pdf',
+        });
+        (0, vitest_1.expect)(result.success).toBe(false);
+        if (!result.success) {
+            (0, vitest_1.expect)(result.error.issues[0].message).toContain("cannot specify both 'body' and 'file'");
+        }
+    });
+    (0, vitest_1.it)('should reject an empty file path', () => {
+        const result = scenario_schema_js_1.ScenarioConfigSchema.safeParse({
+            ...baseScenario,
+            file: '',
+        });
+        (0, vitest_1.expect)(result.success).toBe(false);
+    });
+});

package/dist/schemas/endpoint.schema.d.ts

@@ -11,26 +11,45 @@ export declare const EndpointConfigSchema: z.ZodEffects<z.ZodObject<{
     id: z.ZodString;
     path: z.ZodString;
     method: z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "OPTIONS", "HEAD"]>;
-    scenarios: z.ZodArray<z.ZodObject<{
+    scenarios: z.ZodArray<z.ZodEffects<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         status: z.ZodNumber;
         headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        body: z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodUnknown, "many">, z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodFunction<z.ZodTuple<[z.ZodAny], z.ZodUnknown>, z.ZodAny>]>;
+        body: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodUnknown, "many">, z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodFunction<z.ZodTuple<[z.ZodAny], z.ZodUnknown>, z.ZodAny>]>>;
+        file: z.ZodOptional<z.ZodString>;
         delay: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         status: number;
         id: string;
         name: string;
-        body: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null;
         headers?: Record<string, string> | undefined;
+        body?: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null | undefined;
+        file?: string | undefined;
         delay?: number | undefined;
     }, {
         status: number;
         id: string;
         name: string;
-        body: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null;
         headers?: Record<string, string> | undefined;
+        body?: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null | undefined;
+        file?: string | undefined;
+        delay?: number | undefined;
+    }>, {
+        status: number;
+        id: string;
+        name: string;
+        headers?: Record<string, string> | undefined;
+        body?: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null | undefined;
+        file?: string | undefined;
+        delay?: number | undefined;
+    }, {
+        status: number;
+        id: string;
+        name: string;
+        headers?: Record<string, string> | undefined;
+        body?: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null | undefined;
+        file?: string | undefined;
         delay?: number | undefined;
     }>, "many">;
     defaultScenarioId: z.ZodString;
@@ -42,8 +61,9 @@ export declare const EndpointConfigSchema: z.ZodEffects<z.ZodObject<{
         status: number;
         id: string;
         name: string;
-        body: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null;
         headers?: Record<string, string> | undefined;
+        body?: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null | undefined;
+        file?: string | undefined;
         delay?: number | undefined;
     }[];
     defaultScenarioId: string;
@@ -55,8 +75,9 @@ export declare const EndpointConfigSchema: z.ZodEffects<z.ZodObject<{
         status: number;
         id: string;
         name: string;
-        body: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null;
         headers?: Record<string, string> | undefined;
+        body?: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null | undefined;
+        file?: string | undefined;
         delay?: number | undefined;
     }[];
     defaultScenarioId: string;
@@ -68,8 +89,9 @@ export declare const EndpointConfigSchema: z.ZodEffects<z.ZodObject<{
         status: number;
         id: string;
         name: string;
-        body: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null;
         headers?: Record<string, string> | undefined;
+        body?: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null | undefined;
+        file?: string | undefined;
         delay?: number | undefined;
     }[];
     defaultScenarioId: string;
@@ -81,8 +103,9 @@ export declare const EndpointConfigSchema: z.ZodEffects<z.ZodObject<{
         status: number;
         id: string;
         name: string;
-        body: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null;
         headers?: Record<string, string> | undefined;
+        body?: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null | undefined;
+        file?: string | undefined;
         delay?: number | undefined;
     }[];
     defaultScenarioId: string;

package/dist/schemas/endpoint.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endpoint.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/endpoint.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;GAEG;AACH,eAAO,MAAM,UAAU,aAKuC,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8B7B,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,cAAc,EAAE,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAgBxE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,cAAc,EAAE,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAgB1C"}
+{"version":3,"file":"endpoint.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/endpoint.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;GAEG;AACH,eAAO,MAAM,UAAU,aAKuC,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8B7B,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,cAAc,EAAE,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAgBxE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,cAAc,EAAE,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAgB1C"}

package/dist/schemas/scenario.schema.d.ts

@@ -17,30 +17,54 @@ export type ResponseBody = z.infer<typeof ResponseBodySchema>;
  * Response delay in milliseconds (0-30000ms max to prevent hanging)
  */
 export declare const DelaySchema: z.ZodOptional<z.ZodNumber>;
+/**
+ * File path for file download responses
+ * Relative to the config directory
+ */
+export declare const FilePathSchema: z.ZodString;
 /**
  * Scenario configuration schema
  * Defines a single response scenario for an endpoint
  */
-export declare const ScenarioConfigSchema: z.ZodObject<{
+export declare const ScenarioConfigSchema: z.ZodEffects<z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     status: z.ZodNumber;
     headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    body: z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodUnknown, "many">, z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodFunction<z.ZodTuple<[z.ZodAny], z.ZodUnknown>, z.ZodAny>]>;
+    body: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodUnknown, "many">, z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodFunction<z.ZodTuple<[z.ZodAny], z.ZodUnknown>, z.ZodAny>]>>;
+    file: z.ZodOptional<z.ZodString>;
     delay: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     status: number;
     id: string;
     name: string;
-    body: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null;
     headers?: Record<string, string> | undefined;
+    body?: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null | undefined;
+    file?: string | undefined;
+    delay?: number | undefined;
+}, {
+    status: number;
+    id: string;
+    name: string;
+    headers?: Record<string, string> | undefined;
+    body?: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null | undefined;
+    file?: string | undefined;
+    delay?: number | undefined;
+}>, {
+    status: number;
+    id: string;
+    name: string;
+    headers?: Record<string, string> | undefined;
+    body?: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null | undefined;
+    file?: string | undefined;
     delay?: number | undefined;
 }, {
     status: number;
     id: string;
     name: string;
-    body: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null;
     headers?: Record<string, string> | undefined;
+    body?: string | number | boolean | unknown[] | Record<string, unknown> | ((args_0: any, ...args: unknown[]) => any) | null | undefined;
+    file?: string | undefined;
     delay?: number | undefined;
 }>;
 export type ScenarioConfig = z.infer<typeof ScenarioConfigSchema>;

package/dist/schemas/scenario.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scenario.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/scenario.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,QAAQ,aAOlB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,UAAU,aAIW,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,0MAQ7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,WAAW,4BAMqB,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;EAO/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,cAAc,EAAE,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAgB1C"}
+{"version":3,"file":"scenario.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/scenario.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,QAAQ,aAOlB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,UAAU,aAIW,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,0MAQ7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,WAAW,4BAMqB,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,cAAc,aAI4D,CAAC;AAExF;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB7B,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,cAAc,EAAE,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAgB1C"}