@schmock/core 2.2.2 → 2.3.0

package/dist/binary.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Browser-safe binary body detection.
+ *
+ * Every ArrayBuffer view is accepted, including DataView, typed arrays backed
+ * by SharedArrayBuffer, and Node.js Buffer without referencing its global.
+ */
+export declare function isBinaryBody(value: unknown): value is ArrayBuffer | ArrayBufferView;
+//# sourceMappingURL=binary.d.ts.map

package/dist/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../src/binary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,WAAW,GAAG,eAAe,CAExC"}

package/dist/binary.js

@@ -0,0 +1,9 @@
+/**
+ * Browser-safe binary body detection.
+ *
+ * Every ArrayBuffer view is accepted, including DataView, typed arrays backed
+ * by SharedArrayBuffer, and Node.js Buffer without referencing its global.
+ */
+export function isBinaryBody(value) {
+    return value instanceof ArrayBuffer || ArrayBuffer.isView(value);
+}

package/dist/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAuDA;;;;GAIG;AACH,qBAAa,oBAAoB;;IAanB,OAAO,CAAC,YAAY;IAZhC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,YAAY,CAA4C;IAChE,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,WAAW,CAA2C;IAC9D,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,eAAe,CAAwC;IAE/D,OAAO,CAAC,SAAS,CAAoC;gBAEjC,YAAY,GAAE,OAAO,CAAC,YAAiB;IAa3D,WAAW,CACT,KAAK,EAAE,OAAO,CAAC,QAAQ,EACvB,SAAS,EAAE,OAAO,CAAC,SAAS,EAC5B,MAAM,EAAE,OAAO,CAAC,WAAW,GAC1B,IAAI;IAsFP,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,oBAAoB,GAAG,IAAI;IAIvD,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI;IAoBlC;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE;IAW5E,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO;IAS3D,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAS7D,WAAW,CACT,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAC3B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,GAAG,SAAS;IAgBpC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE;IAQhC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMnC,EAAE,CAAC,CAAC,SAAS,OAAO,CAAC,YAAY,EAC/B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,IAAI;IAUP,GAAG,CAAC,CAAC,SAAS,OAAO,CAAC,YAAY,EAChC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,IAAI;IAKP,OAAO,CAAC,IAAI;IAWZ,KAAK,IAAI,IAAI;IAiBb,YAAY,IAAI,IAAI;IAKpB,UAAU,IAAI,IAAI;IAWlB,MAAM,CAAC,IAAI,SAAI,EAAE,QAAQ,SAAc,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;IAgErE,KAAK,IAAI,IAAI;IAab,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC,eAAe;IAgBhE,MAAM,CACV,MAAM,EAAE,OAAO,CAAC,UAAU,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,GAC/B,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;IA+O5B;;;;OAIG;YACW,UAAU;CAezB"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AA4DA;;;;GAIG;AACH,qBAAa,oBAAoB;;IAanB,OAAO,CAAC,YAAY;IAZhC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,YAAY,CAA4C;IAChE,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,WAAW,CAA2C;IAC9D,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,eAAe,CAAwC;IAE/D,OAAO,CAAC,SAAS,CAAoC;gBAEjC,YAAY,GAAE,OAAO,CAAC,YAAiB;IAa3D,WAAW,CACT,KAAK,EAAE,OAAO,CAAC,QAAQ,EACvB,SAAS,EAAE,OAAO,CAAC,SAAS,EAC5B,MAAM,EAAE,OAAO,CAAC,WAAW,GAC1B,IAAI;IAsFP,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,oBAAoB,GAAG,IAAI;IAIvD,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI;IAoBlC;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE;IAW5E,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO;IAS3D,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAS7D,WAAW,CACT,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAC3B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,GAAG,SAAS;IAgBpC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE;IAQhC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMnC,EAAE,CAAC,CAAC,SAAS,OAAO,CAAC,YAAY,EAC/B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,IAAI;IAUP,GAAG,CAAC,CAAC,SAAS,OAAO,CAAC,YAAY,EAChC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,IAAI;IAKP,OAAO,CAAC,IAAI;IAWZ,KAAK,IAAI,IAAI;IAiBb,YAAY,IAAI,IAAI;IAKpB,UAAU,IAAI,IAAI;IAWlB,MAAM,CAAC,IAAI,SAAI,EAAE,QAAQ,SAAc,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;IAwErE,KAAK,IAAI,IAAI;IAab,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC,eAAe;IAgBhE,MAAM,CACV,MAAM,EAAE,OAAO,CAAC,UAAU,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,GAC/B,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;IAgR5B;;;;OAIG;YACW,UAAU;CAgBzB"}

package/dist/builder.js

@@ -1,9 +1,10 @@
+import { isBinaryBody } from "./binary.js";
 import { normalizePath, toHttpMethod } from "./constants.js";
 import { errorMessage, RouteDefinitionError, RouteNotFoundError, SchmockError, } from "./errors.js";
 import { collectBody, parseNodeHeaders, parseNodeQuery, writeSchmockResponse, } from "./http-helpers.js";
 import { createFetchInterceptor } from "./interceptor.js";
 import { parseRouteKey } from "./parser.js";
-import { runPluginPipeline } from "./plugin-pipeline.js";
+import { recoverGeneratorError, runPluginBeforeRequest, runPluginPipeline, } from "./plugin-pipeline.js";
 import { parseResponse } from "./response-parser.js";
 import { extractParams, findRoute, isGeneratorFunction, } from "./route-matcher.js";
 /**
@@ -83,8 +84,8 @@ export class CallableMockInstance {
                 // Default to plain text for primitives
                 routeConfig.contentType = "text/plain";
             }
-            else if (Buffer.isBuffer(generator)) {
-                // Default to octet-stream for buffers
+            else if (isBinaryBody(generator)) {
+                // Default to octet-stream for browser and Node binary values
                 routeConfig.contentType = "application/octet-stream";
             }
             else {
@@ -298,8 +299,16 @@ export class CallableMockInstance {
         });
         this.server = httpServer;
         return new Promise((resolve, reject) => {
-            httpServer.on("error", reject);
+            const handleStartupError = (error) => {
+                if (this.server === httpServer) {
+                    this.server = undefined;
+                    this.serverInfo = undefined;
+                }
+                reject(error);
+            };
+            httpServer.once("error", handleStartupError);
             httpServer.listen(port, hostname, () => {
+                httpServer.off("error", handleStartupError);
                 const addr = httpServer.address();
                 const actualPort = addr !== null && typeof addr === "object" ? addr.port : port;
                 this.serverInfo = { port: actualPort, hostname };
@@ -361,7 +370,7 @@ export class CallableMockInstance {
                     const response = {
                         status: 404,
                         body: { error: error.message, code: error.code },
-                        headers: {},
+                        headers: { "content-type": "application/json" },
                     };
                     this.emit("request:end", {
                         method,
@@ -385,7 +394,7 @@ export class CallableMockInstance {
                 const response = {
                     status: 404,
                     body: { error: error.message, code: error.code },
-                    headers: {},
+                    headers: { "content-type": "application/json" },
                 };
                 this.emit("request:end", {
                     method,
@@ -405,24 +414,8 @@ export class CallableMockInstance {
                 routePath: matchedRoute.path,
                 params,
             });
-            // Generate initial response from route handler
-            const context = {
-                method,
-                path: requestPath,
-                params,
-                query: reqQuery,
-                headers: reqHeaders,
-                body: options?.body,
-                state: this.globalConfig.state || {},
-            };
-            let result;
-            if (isGeneratorFunction(matchedRoute.generator)) {
-                result = await matchedRoute.generator(context);
-            }
-            else {
-                result = matchedRoute.generator;
-            }
-            // Build plugin context
+            // Build plugin context before route code so request guards can reject
+            // invalid or unauthorized requests without triggering side effects.
             let pluginContext = {
                 path: requestPath,
                 route: matchedRoute.config,
@@ -434,11 +427,48 @@ export class CallableMockInstance {
                 state: new Map(),
                 routeState: this.globalConfig.state || {},
             };
+            const preflightResult = await runPluginBeforeRequest(this.plugins, pluginContext, this.logger);
+            pluginContext = preflightResult.context;
+            if (preflightResult.requestShortCircuited === true) {
+                pluginContext = { ...pluginContext, requestShortCircuited: true };
+            }
+            let result = preflightResult.response;
+            let skipPostProcessing = preflightResult.recoveredFromError === true;
+            if (result === undefined) {
+                const context = {
+                    method: pluginContext.method,
+                    path: pluginContext.path,
+                    params: pluginContext.params,
+                    query: pluginContext.query,
+                    headers: pluginContext.headers,
+                    body: pluginContext.body,
+                    state: pluginContext.routeState ?? this.globalConfig.state ?? {},
+                };
+                try {
+                    if (isGeneratorFunction(matchedRoute.generator)) {
+                        result = await matchedRoute.generator(context);
+                    }
+                    else {
+                        result = matchedRoute.generator;
+                    }
+                }
+                catch (error) {
+                    const recovery = await recoverGeneratorError(this.plugins, pluginContext, error, this.logger);
+                    pluginContext = recovery.context;
+                    result = recovery.response;
+                    skipPostProcessing = recovery.recoveredFromError === true;
+                }
+            }
             // Run plugin pipeline to transform the response
             try {
-                const pipelineResult = await runPluginPipeline(this.plugins, pluginContext, result, this.logger);
-                pluginContext = pipelineResult.context;
-                result = pipelineResult.response;
+                if (skipPostProcessing) {
+                    this.logger.log("pipeline", "Skipping response processors after error recovery");
+                }
+                else {
+                    const pipelineResult = await runPluginPipeline(this.plugins, pluginContext, result, this.logger);
+                    pluginContext = pipelineResult.context;
+                    result = pipelineResult.response;
+                }
             }
             catch (error) {
                 this.logger.log("error", `[${requestId}] Plugin pipeline error: ${errorMessage(error)}`);
@@ -489,7 +519,7 @@ export class CallableMockInstance {
                     error: errorMessage(error),
                     code: error instanceof SchmockError ? error.code : "INTERNAL_ERROR",
                 },
-                headers: {},
+                headers: { "content-type": "application/json" },
             };
             // Apply delay even for error responses
             await this.applyDelay();
@@ -514,10 +544,11 @@ export class CallableMockInstance {
         if (!effectiveDelay) {
             return;
         }
-        const ms = Array.isArray(effectiveDelay)
+        const configuredMs = Array.isArray(effectiveDelay)
             ? Math.random() * (effectiveDelay[1] - effectiveDelay[0]) +
                 effectiveDelay[0]
             : effectiveDelay;
+        const ms = Math.max(0, configuredMs);
         await new Promise((resolve) => setTimeout(resolve, ms));
     }
 }

package/dist/http-helpers.d.ts

@@ -1,9 +1,20 @@
-import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ServerResponse } from "node:http";
+interface RequestWithHeaders {
+    readonly headers: {
+        readonly [header: string]: string | string[] | undefined;
+    };
+}
+interface BodyReadable {
+    on(event: "error", listener: (error: Error) => void): this;
+    on(event: "data", listener: (chunk: Buffer) => void): this;
+    on(event: "end", listener: () => void): this;
+    destroy(error?: Error): this;
+}
 /**
  * Convert Node.js IncomingMessage headers to a flat Record<string, string>.
  * Drops array-valued headers (keeps only string values).
  */
-export declare function parseNodeHeaders(req: IncomingMessage): Record<string, string>;
+export declare function parseNodeHeaders(req: RequestWithHeaders): Record<string, string>;
 /**
  * Extract query parameters from a URL as a flat Record<string, string>.
  */
@@ -16,10 +27,11 @@ export declare function parseNodeQuery(url: URL): Record<string, string>;
  * @param headers - Parsed request headers
  * @param maxBodySize - Maximum body size in bytes (default: 10 MB)
  */
-export declare function collectBody(req: IncomingMessage, headers: Record<string, string>, maxBodySize?: number): Promise<unknown>;
+export declare function collectBody(req: BodyReadable, headers: Record<string, string>, maxBodySize?: number): Promise<unknown>;
 /**
  * Write a Schmock Response to a Node.js ServerResponse.
  * Serializes non-string bodies as JSON and sets content-type when missing.
  */
 export declare function writeSchmockResponse(res: ServerResponse, response: Schmock.Response, extraHeaders?: Record<string, string>): void;
+export {};
 //# sourceMappingURL=http-helpers.d.ts.map

package/dist/http-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-helpers.d.ts","sourceRoot":"","sources":["../src/http-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ7E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM/D;AAKD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,WAAW,SAAwB,GAClC,OAAO,CAAC,OAAO,CAAC,CAqClB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,IAAI,CAuBN"}
+{"version":3,"file":"http-helpers.d.ts","sourceRoot":"","sources":["../src/http-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;KAC1D,CAAC;CACH;AAED,UAAU,YAAY;IACpB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3D,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3D,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,kBAAkB,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM/D;AAKD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,WAAW,SAAwB,GAClC,OAAO,CAAC,OAAO,CAAC,CAqClB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,IAAI,CA2CN"}

package/dist/http-helpers.js

@@ -1,3 +1,4 @@
+import { isBinaryBody } from "./binary.js";
 /**
  * Convert Node.js IncomingMessage headers to a flat Record<string, string>.
  * Drops array-valued headers (keeps only string values).
@@ -75,16 +76,33 @@ export function writeSchmockResponse(res, response, extraHeaders) {
         ...response.headers,
         ...extraHeaders,
     };
-    if (!responseHeaders["content-type"] &&
+    const hasContentType = Object.keys(responseHeaders).some((header) => header.toLowerCase() === "content-type");
+    if (!hasContentType &&
+        response.body !== undefined &&
+        isBinaryBody(response.body)) {
+        responseHeaders["content-type"] = "application/octet-stream";
+    }
+    else if (!hasContentType &&
         response.body !== undefined &&
         typeof response.body !== "string") {
         responseHeaders["content-type"] = "application/json";
     }
-    const responseBody = response.body === undefined
-        ? undefined
-        : typeof response.body === "string"
-            ? response.body
-            : JSON.stringify(response.body);
+    let responseBody;
+    if (response.body === undefined) {
+        responseBody = undefined;
+    }
+    else if (typeof response.body === "string") {
+        responseBody = response.body;
+    }
+    else if (response.body instanceof ArrayBuffer) {
+        responseBody = new Uint8Array(response.body);
+    }
+    else if (ArrayBuffer.isView(response.body)) {
+        responseBody = new Uint8Array(response.body.buffer, response.body.byteOffset, response.body.byteLength);
+    }
+    else {
+        responseBody = JSON.stringify(response.body);
+    }
     res.writeHead(response.status, responseHeaders);
     res.end(responseBody);
 }

package/dist/index.d.ts

@@ -28,7 +28,7 @@ namespace Schmock {
    * 'DELETE /api/posts/:postId/comments/:commentId'
    */
   type RouteKey = `${HttpMethod} ${string}`;
-  
+
   /**
    * Plugin interface for extending Schmock functionality
    */
@@ -45,6 +45,15 @@ namespace Schmock {
      */
     install?(instance: CallableMockInstance): void;
 
+    /**
+     * Inspect or transform a request before its route generator executes.
+     * Returning a response short-circuits the generator, while returning only
+     * a context allows request changes to flow into the generator.
+     */
+    beforeRequest?(
+      context: PluginContext,
+    ): PluginResult | void | Promise<PluginResult | void>;
+
     /**
      * Process the request through this plugin
      * First plugin to set response becomes the generator, others transform
@@ -52,16 +61,22 @@ namespace Schmock {
      * @param response - Response from previous plugin (if any)
      * @returns Updated context and response
      */
-    process(context: PluginContext, response?: unknown): PluginResult | Promise<PluginResult>;
+    process(
+      context: PluginContext,
+      response?: unknown,
+    ): PluginResult | Promise<PluginResult>;
 
     /**
-     * Called when an error occurs
-     * Can handle, transform, or suppress errors
+     * Called when this plugin or an earlier pipeline stage fails. If this hook
+     * does not recover, downstream handlers are tried in registration order.
      * @param error - The error that occurred
      * @param context - Plugin context
      * @returns Modified error, response data, or void to continue error propagation
      */
-    onError?(error: Error, context: PluginContext): Error | ResponseResult | void | Promise<Error | ResponseResult | void>;
+    onError?(
+      error: Error,
+      context: PluginContext,
+    ): Error | ResponseResult | void | Promise<Error | ResponseResult | void>;
   }
 
   /**
@@ -99,6 +114,8 @@ namespace Schmock {
     body?: unknown;
     /** Shared state between plugins for this request */
     state: Map<string, unknown>;
+    /** True when a beforeRequest hook supplied the response instead of the route generator. */
+    requestShortCircuited?: boolean;
     /** Route-specific state */
     routeState?: Record<string, unknown>;
   }
@@ -148,20 +165,28 @@ namespace Schmock {
   /**
    * Generator types that can be passed to route definitions
    */
-  type Generator = 
-    | GeneratorFunction
-    | StaticData
-    | JSONSchema7;
+  type Generator = GeneratorFunction | StaticData | JSONSchema7;
 
   /**
    * Function that generates responses
    */
-  type GeneratorFunction = (context: RequestContext) => ResponseResult | Promise<ResponseResult>;
+  type GeneratorFunction = (
+    context: RequestContext,
+  ) => ResponseResult | Promise<ResponseResult>;
 
   /**
    * Static data (non-function) that gets returned as-is
    */
-  type StaticData = string | number | boolean | null | undefined | Record<string, unknown> | unknown[];
+  type StaticData =
+    | string
+    | number
+    | boolean
+    | null
+    | undefined
+    | Record<string, unknown>
+    | unknown[]
+    | ArrayBuffer
+    | ArrayBufferView;
 
   /**
    * Context passed to generator functions
@@ -240,12 +265,12 @@ namespace Schmock {
   interface CallableMockInstance {
     /**
      * Define a route by calling the instance directly
-     * 
+     *
      * @param route - Route pattern in format 'METHOD /path'
      * @param generator - Response generator (function, static data, or schema)
      * @param config - Route-specific configuration
      * @returns The same instance for method chaining
-     * 
+     *
      * @example
      * ```typescript
      * const mock = schmock()
@@ -253,19 +278,22 @@ namespace Schmock {
      * mock('POST /users', userData, { contentType: 'application/json' })
      * ```
      */
-    (route: RouteKey, generator: Generator, config?: RouteConfig): CallableMockInstance;
+    (
+      route: RouteKey,
+      generator: Generator,
+      config?: RouteConfig,
+    ): CallableMockInstance;
 
     /**
      * Add a plugin to the pipeline
-     * 
+     *
      * @param plugin - Plugin to add to the pipeline
      * @returns The same instance for method chaining
-     * 
+     *
      * @example
      * ```typescript
+     * mock.pipe(authPlugin()).pipe(corsPlugin())
      * mock('GET /users', generator, config)
-     *   .pipe(authPlugin())
-     *   .pipe(corsPlugin())
      * ```
      */
     pipe(plugin: Plugin): CallableMockInstance;
@@ -285,7 +313,11 @@ namespace Schmock {
      * })
      * ```
      */
-    handle(method: HttpMethod, path: string, options?: RequestOptions): Promise<Response>;
+    handle(
+      method: HttpMethod,
+      path: string,
+      options?: RequestOptions,
+    ): Promise<Response>;
 
     // ===== Request Spy / History API =====
 
@@ -347,12 +379,18 @@ namespace Schmock {
     /**
      * Register an event listener
      */
-    on<E extends SchmockEvent>(event: E, listener: (data: SchmockEventMap[E]) => void): CallableMockInstance;
+    on<E extends SchmockEvent>(
+      event: E,
+      listener: (data: SchmockEventMap[E]) => void,
+    ): CallableMockInstance;
 
     /**
      * Remove an event listener
      */
-    off<E extends SchmockEvent>(event: E, listener: (data: SchmockEventMap[E]) => void): CallableMockInstance;
+    off<E extends SchmockEvent>(
+      event: E,
+      listener: (data: SchmockEventMap[E]) => void,
+    ): CallableMockInstance;
 
     // ===== Introspection =====
 
@@ -555,6 +593,8 @@ namespace Schmock {
   interface CrudOperationMeta {
     /** Full success response schema (wrapper + items) */
     responseSchema?: JSONSchema7;
+    /** Concrete success status selected from the operation contract. */
+    responseStatus?: number;
     /** Response headers from spec */
     responseHeaders?: Record<string, ResponseHeaderDef>;
     /** Error response schemas keyed by status code */
@@ -627,14 +667,24 @@ namespace Schmock {
     passthrough?: boolean;
     errorFormatter?: (error: Error, request: unknown) => unknown;
     transformRequest?: (request: unknown) => AdapterRequestOverride;
-    transformResponse?: (
-      response: Response,
-      request: unknown,
-    ) => Response;
+    transformResponse?: (response: Response, request: unknown) => Response;
   }
 
   // ===== OpenAPI Plugin Options =====
 
+  /** A callback request resolved from an OpenAPI callback expression. */
+  interface OpenApiCallbackRequest {
+    url: string;
+    method: HttpMethod;
+    headers: Record<string, string>;
+    body?: unknown;
+  }
+
+  /** Explicit application-owned delivery for OpenAPI callbacks. */
+  interface OpenApiCallbackOptions {
+    dispatch(request: OpenApiCallbackRequest): void | Promise<void>;
+  }
+
   /**
    * Options for the OpenAPI plugin
    */
@@ -643,6 +693,7 @@ namespace Schmock {
     seed?: SeedConfig;
     validateRequests?: boolean;
     validateResponses?: boolean;
+    /** @deprecated Unsupported. Supplying this option throws OPENAPI_UNSUPPORTED_OPTION. */
     queryFeatures?: {
       pagination?: boolean;
       sorting?: boolean;
@@ -652,12 +703,24 @@ namespace Schmock {
     debug?: boolean;
     fakerSeed?: number;
     security?: boolean;
+    /**
+     * Enable callback delivery through an application-supplied dispatcher.
+     * Callbacks are disabled when this option is omitted; Schmock never
+     * performs callback network requests implicitly.
+     */
+    callbacks?: OpenApiCallbackOptions;
     /** Replace response schemas for specific routes. Key format: "METHOD /path" or "METHOD /path STATUS" */
     schemas?: Record<string, import("json-schema").JSONSchema7>;
     /** Called before generating a response body. Return a schema to replace the original, or void to keep it. */
     onSchema?: (
       schema: import("json-schema").JSONSchema7,
-      context: { method: string; path: string; params: Record<string, string>; query: Record<string, string>; headers: Record<string, string> },
+      context: {
+        method: string;
+        path: string;
+        params: Record<string, string>;
+        query: Record<string, string>;
+        headers: Record<string, string>;
+      },
     ) => import("json-schema").JSONSchema7 | undefined;
   }
 
@@ -698,7 +761,6 @@ namespace Schmock {
     hostname: string;
     close(): void;
   }
-
 }
 }
 // >>> schmock ambient namespace <<<
@@ -726,6 +788,7 @@ namespace Schmock {
  * @returns A callable mock instance
  */
 export declare function schmock(config?: Schmock.GlobalConfig): Schmock.CallableMockInstance;
+export { isBinaryBody } from "./binary.js";
 export { HTTP_METHODS, isHttpMethod, isRouteNotFound, isStatusTuple, ROUTE_NOT_FOUND_CODE, toHttpMethod, toRouteKey, } from "./constants.js";
 export { PluginError, ResourceLimitError, ResponseGenerationError, RouteDefinitionError, RouteNotFoundError, RouteParseError, SchemaGenerationError, SchemaValidationError, SchmockError, } from "./errors.js";
 export { badRequest, created, forbidden, noContent, notFound, paginate, serverError, unauthorized, } from "./helpers.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CACrB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,GAC5B,OAAO,CAAC,oBAAoB,CAqD9B;AAGD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,UAAU,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,YAAY,EACV,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,aAAa,EACb,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,WAAW,EACX,SAAS,EACT,QAAQ,EACR,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CACrB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,GAC5B,OAAO,CAAC,oBAAoB,CAqD9B;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,UAAU,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,YAAY,EACV,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,aAAa,EACb,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,WAAW,EACX,SAAS,EACT,QAAQ,EACR,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -59,6 +59,7 @@ export function schmock(config) {
     instance.setCallableRef(callableInstance);
     return callableInstance;
 }
+export { isBinaryBody } from "./binary.js";
 // Re-export constants and utilities
 export { HTTP_METHODS, isHttpMethod, isRouteNotFound, isStatusTuple, ROUTE_NOT_FOUND_CODE, toHttpMethod, toRouteKey, } from "./constants.js";
 // Re-export errors

package/dist/interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../src/interceptor.ts"],"names":[],"mappings":"AA2JA;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,CACN,MAAM,EAAE,OAAO,CAAC,UAAU,EAC1B,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,KACpC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC9B,OAAO,GAAE,OAAO,CAAC,gBAAqB,GACrC,OAAO,CAAC,eAAe,CA0JzB"}
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../src/interceptor.ts"],"names":[],"mappings":"AAwPA;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,CACN,MAAM,EAAE,OAAO,CAAC,UAAU,EAC1B,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,KACpC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC9B,OAAO,GAAE,OAAO,CAAC,gBAAqB,GACrC,OAAO,CAAC,eAAe,CAoJzB"}