@zze/mock-server 0.2.5 → 0.5.0

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"}

package/dist/schemas/scenario.schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ScenarioConfigSchema = exports.DelaySchema = exports.ResponseBodySchema = exports.NameSchema = exports.IdSchema = void 0;
+exports.ScenarioConfigSchema = exports.FilePathSchema = exports.DelaySchema = exports.ResponseBodySchema = exports.NameSchema = exports.IdSchema = void 0;
 exports.validateUniqueScenarioIds = validateUniqueScenarioIds;
 const zod_1 = require("zod");
 const http_schema_js_1 = require("./http.schema.js");
@@ -43,17 +43,37 @@ exports.DelaySchema = zod_1.z
     .max(30000)
     .optional()
     .describe('Response delay in milliseconds');
+/**
+ * File path for file download responses
+ * Relative to the config directory
+ */
+exports.FilePathSchema = zod_1.z
+    .string()
+    .min(1)
+    .max(1000)
+    .describe('File path relative to the config directory (e.g., "./assets/report.pdf")');
 /**
  * Scenario configuration schema
  * Defines a single response scenario for an endpoint
  */
-exports.ScenarioConfigSchema = zod_1.z.object({
+exports.ScenarioConfigSchema = zod_1.z
+    .object({
     id: exports.IdSchema.describe('Unique scenario identifier'),
     name: exports.NameSchema.describe('Human-readable scenario name'),
     status: http_schema_js_1.HttpStatusCodeSchema,
     headers: http_schema_js_1.HttpHeadersSchema,
-    body: exports.ResponseBodySchema.describe('Response body'),
+    body: exports.ResponseBodySchema.describe('Response body').optional(),
+    file: exports.FilePathSchema.optional(),
     delay: exports.DelaySchema,
+})
+    .superRefine((data, ctx) => {
+    if (data.body !== undefined && data.file !== undefined) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: `Scenario "${data.id}": cannot specify both 'body' and 'file' — use one or the other`,
+            path: ['file'],
+        });
+    }
 });
 /**
  * Validates that scenario IDs are unique within an array

package/dist/server/__tests__/mock-server-app.test.js

@@ -294,3 +294,40 @@ const mockFlows = [
         (0, vitest_1.expect)(app.getOptions().port).toBe(5000);
     });
 });
+(0, vitest_1.describe)('multipart upload support', () => {
+    let serverApp;
+    const uploadEndpoint = {
+        id: 'upload-avatar',
+        path: '/users/:id/avatar',
+        method: 'POST',
+        scenarios: [
+            { id: 'success', name: 'Uploaded', status: 200, body: { url: '/cdn/avatar.jpg' } },
+            { id: 'too-large', name: 'Too Large', status: 413, body: { error: 'File too large' } },
+        ],
+        defaultScenarioId: 'success',
+    };
+    (0, vitest_1.beforeEach)(() => {
+        serverApp = new mock_server_app_js_1.MockServerApp({ port: 0 });
+        serverApp.registerConfig([uploadEndpoint], []);
+    });
+    (0, vitest_1.afterEach)(async () => {
+        if (serverApp.isRunning()) {
+            await serverApp.stop();
+        }
+    });
+    (0, vitest_1.it)('should accept multipart/form-data and return active scenario', async () => {
+        const res = await (0, supertest_1.default)(serverApp.getApp())
+            .post('/api/users/123/avatar')
+            .attach('file', Buffer.from('fake image data'), { filename: 'avatar.png', contentType: 'image/png' })
+            .expect(200);
+        (0, vitest_1.expect)(res.body).toEqual({ url: '/cdn/avatar.jpg' });
+    });
+    (0, vitest_1.it)('should return the active scenario regardless of uploaded file', async () => {
+        serverApp.getStateManager().activateScenario('upload-avatar', 'too-large');
+        const res = await (0, supertest_1.default)(serverApp.getApp())
+            .post('/api/users/123/avatar')
+            .attach('file', Buffer.from('big file'), { filename: 'big.png', contentType: 'image/png' })
+            .expect(413);
+        (0, vitest_1.expect)(res.body).toEqual({ error: 'File too large' });
+    });
+});