@schmock/core 1.9.0 → 1.9.2

package/dist/builder.d.ts

@@ -39,45 +39,5 @@ export declare class CallableMockInstance {
      * @private
      */
     private applyDelay;
-    /**
-     * Parse and normalize response result into Response object
-     * Handles tuple format [status, body, headers], direct values, and response objects
-     * @param result - Raw result from generator or plugin
-     * @param routeConfig - Route configuration for content-type defaults
-     * @returns Normalized Response object with status, body, and headers
-     * @private
-     */
-    private parseResponse;
-    /**
-     * Run all registered plugins in sequence
-     * First plugin to set response becomes generator, subsequent plugins transform
-     * Handles plugin errors via onError hooks
-     * @param context - Plugin context with request details
-     * @param initialResponse - Initial response from route generator
-     * @param _routeConfig - Route config (unused but kept for signature)
-     * @param _requestId - Request ID (unused but kept for signature)
-     * @returns Updated context and final response after all plugins
-     * @private
-     */
-    private runPluginPipeline;
-    /**
-     * Find a route that matches the given method and path
-     * Uses two-pass matching: static routes first, then parameterized routes
-     * Matches routes in registration order (first registered wins)
-     * @param method - HTTP method to match
-     * @param path - Request path to match
-     * @returns Matched compiled route or undefined if no match
-     * @private
-     */
-    private findRoute;
-    /**
-     * Extract parameter values from path based on route pattern
-     * Maps capture groups from regex match to parameter names
-     * @param route - Compiled route with pattern and param names
-     * @param path - Request path to extract values from
-     * @returns Object mapping parameter names to extracted values
-     * @private
-     */
-    private extractParams;
 }
 //# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAkFA;;;;GAIG;AACH,qBAAa,oBAAoB;IAYnB,OAAO,CAAC,YAAY;IAXhC,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;IAEnD,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;IAqFP,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,oBAAoB,GAAG,IAAI;IAIvD,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI;IAoBlC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE;IAS5E,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;IAYpC,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;IAeb,YAAY,IAAI,IAAI;IAKpB,UAAU,IAAI,IAAI;IAWlB,MAAM,CAAC,IAAI,SAAI,EAAE,QAAQ,SAAc,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;IAuCrE,KAAK,IAAI,IAAI;IAUP,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;IAgN5B;;;;OAIG;YACW,UAAU;IAgBxB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAwDrB;;;;;;;;;;OAUG;YACW,iBAAiB;IAqG/B;;;;;;;;OAQG;IACH,OAAO,CAAC,SAAS;IA0BjB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;CActB"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAuDA;;;;GAIG;AACH,qBAAa,oBAAoB;IAYnB,OAAO,CAAC,YAAY;IAXhC,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;IAEnD,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;IAiFP,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,oBAAoB,GAAG,IAAI;IAIvD,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI;IAoBlC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE;IAS5E,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;IAYpC,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;IAeb,YAAY,IAAI,IAAI;IAKpB,UAAU,IAAI,IAAI;IAWlB,MAAM,CAAC,IAAI,SAAI,EAAE,QAAQ,SAAc,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;IAqDrE,KAAK,IAAI,IAAI;IAUP,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;IAoO5B;;;;OAIG;YACW,UAAU;CAezB"}

package/dist/builder.js

@@ -1,11 +1,11 @@
 import { createServer } from "node:http";
-import { isStatusTuple, toHttpMethod } from "./constants.js";
-import { PluginError, RouteDefinitionError, RouteNotFoundError, SchmockError, } from "./errors.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 { parseRouteKey } from "./parser.js";
-function errorMessage(error) {
-    return error instanceof Error ? error.message : "Unknown error";
-}
+import { runPluginPipeline } from "./plugin-pipeline.js";
+import { parseResponse } from "./response-parser.js";
+import { extractParams, findRoute, isGeneratorFunction, } from "./route-matcher.js";
 /**
  * Debug logger that respects debug mode configuration
  */
@@ -37,15 +37,6 @@ class DebugLogger {
         console.timeEnd(`[SCHMOCK] ${label}`);
     }
 }
-function isGeneratorFunction(gen) {
-    return typeof gen === "function";
-}
-function isResponseObject(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        "status" in value &&
-        "body" in value);
-}
 /**
  * Callable mock instance that implements the new API.
  *
@@ -128,10 +119,7 @@ export class CallableMockInstance {
         // Store static routes (no params) in Map for O(1) lookup
         // Only store the first registration — "first registration wins" semantics
         if (parsed.params.length === 0) {
-            const normalizedPath = parsed.path.endsWith("/") && parsed.path !== "/"
-                ? parsed.path.slice(0, -1)
-                : parsed.path;
-            const key = `${parsed.method} ${normalizedPath}`;
+            const key = `${parsed.method} ${normalizePath(parsed.path)}`;
             if (!this.staticRoutes.has(key)) {
                 this.staticRoutes.set(key, compiledRoute);
             }
@@ -161,26 +149,26 @@ export class CallableMockInstance {
     }
     // ===== Request Spy / History API =====
     history(method, path) {
-        if (method && path) {
-            return this.requestHistory.filter((r) => r.method === method && r.path === path);
+        if (method || path) {
+            return this.requestHistory.filter((r) => (!method || r.method === method) && (!path || r.path === path));
         }
         return [...this.requestHistory];
     }
     called(method, path) {
-        if (method && path) {
-            return this.requestHistory.some((r) => r.method === method && r.path === path);
+        if (method || path) {
+            return this.requestHistory.some((r) => (!method || r.method === method) && (!path || r.path === path));
         }
         return this.requestHistory.length > 0;
     }
     callCount(method, path) {
-        if (method && path) {
-            return this.requestHistory.filter((r) => r.method === method && r.path === path).length;
+        if (method || path) {
+            return this.requestHistory.filter((r) => (!method || r.method === method) && (!path || r.path === path)).length;
         }
         return this.requestHistory.length;
     }
     lastRequest(method, path) {
-        if (method && path) {
-            const filtered = this.requestHistory.filter((r) => r.method === method && r.path === path);
+        if (method || path) {
+            const filtered = this.requestHistory.filter((r) => (!method || r.method === method) && (!path || r.path === path));
             return filtered[filtered.length - 1];
         }
         return this.requestHistory[this.requestHistory.length - 1];
@@ -194,7 +182,7 @@ export class CallableMockInstance {
         }));
     }
     getState() {
-        return this.globalConfig.state || {};
+        return { ...(this.globalConfig.state || {}) };
     }
     // ===== Lifecycle Events =====
     on(event, listener) {
@@ -251,14 +239,29 @@ export class CallableMockInstance {
             throw new SchmockError("Server is already running", "SERVER_ALREADY_RUNNING");
         }
         const httpServer = createServer((req, res) => {
-            const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
-            const method = toHttpMethod(req.method ?? "GET");
-            const path = url.pathname;
-            const headers = parseNodeHeaders(req);
-            const query = parseNodeQuery(url);
-            void collectBody(req, headers).then((body) => this.handle(method, path, { headers, body, query }).then((schmockResponse) => {
+            const handleRequest = async () => {
+                const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
+                const method = toHttpMethod(req.method ?? "GET");
+                const path = url.pathname;
+                const headers = parseNodeHeaders(req);
+                const query = parseNodeQuery(url);
+                const body = await collectBody(req, headers);
+                const schmockResponse = await this.handle(method, path, {
+                    headers,
+                    body,
+                    query,
+                });
                 writeSchmockResponse(res, schmockResponse);
-            }));
+            };
+            handleRequest().catch((error) => {
+                if (!res.headersSent) {
+                    res.writeHead(500, { "content-type": "application/json" });
+                }
+                res.end(JSON.stringify({
+                    error: error instanceof Error ? error.message : "Internal Server Error",
+                    code: "SERVER_ERROR",
+                }));
+            });
         });
         this.server = httpServer;
         return new Promise((resolve, reject) => {
@@ -282,18 +285,20 @@ export class CallableMockInstance {
         this.logger.log("server", "Server stopped");
     }
     async handle(method, path, options) {
-        const requestId = crypto.randomUUID();
         const handleStart = performance.now();
+        const requestId = this.globalConfig.debug ? crypto.randomUUID() : "";
+        const reqQuery = options?.query || {};
+        const reqHeaders = options?.headers || {};
         this.logger.log("request", `[${requestId}] ${method} ${path}`, {
-            headers: options?.headers,
-            query: options?.query,
+            headers: reqHeaders,
+            query: reqQuery,
             bodyType: options?.body ? typeof options.body : "none",
         });
         this.logger.time(`request-${requestId}`);
         this.emit("request:start", {
             method,
             path,
-            headers: options?.headers || {},
+            headers: reqHeaders,
         });
         try {
             // Apply namespace if configured
@@ -316,6 +321,12 @@ export class CallableMockInstance {
                         body: { error: error.message, code: error.code },
                         headers: {},
                     };
+                    this.emit("request:end", {
+                        method,
+                        path,
+                        status: 404,
+                        duration: performance.now() - handleStart,
+                    });
                     this.logger.timeEnd(`request-${requestId}`);
                     return response;
                 }
@@ -324,7 +335,7 @@ export class CallableMockInstance {
                 requestPath = stripped.startsWith("/") ? stripped : `/${stripped}`;
             }
             // Find matching route
-            const matchedRoute = this.findRoute(method, requestPath);
+            const matchedRoute = findRoute(method, requestPath, this.staticRoutes, this.routes);
             if (!matchedRoute) {
                 this.logger.log("route", `[${requestId}] No route found for ${method} ${requestPath}`);
                 this.emit("request:notfound", { method, path: requestPath });
@@ -345,7 +356,7 @@ export class CallableMockInstance {
             }
             this.logger.log("route", `[${requestId}] Matched route: ${method} ${matchedRoute.path}`);
             // Extract parameters from the matched route
-            const params = this.extractParams(matchedRoute, requestPath);
+            const params = extractParams(matchedRoute, requestPath);
             this.emit("request:match", {
                 method,
                 path: requestPath,
@@ -357,8 +368,8 @@ export class CallableMockInstance {
                 method,
                 path: requestPath,
                 params,
-                query: options?.query || {},
-                headers: options?.headers || {},
+                query: reqQuery,
+                headers: reqHeaders,
                 body: options?.body,
                 state: this.globalConfig.state || {},
             };
@@ -375,15 +386,15 @@ export class CallableMockInstance {
                 route: matchedRoute.config,
                 method,
                 params,
-                query: options?.query || {},
-                headers: options?.headers || {},
+                query: reqQuery,
+                headers: reqHeaders,
                 body: options?.body,
                 state: new Map(),
                 routeState: this.globalConfig.state || {},
             };
             // Run plugin pipeline to transform the response
             try {
-                const pipelineResult = await this.runPluginPipeline(pluginContext, result, matchedRoute.config, requestId);
+                const pipelineResult = await runPluginPipeline(this.plugins, pluginContext, result, this.logger);
                 pluginContext = pipelineResult.context;
                 result = pipelineResult.response;
             }
@@ -392,7 +403,7 @@ export class CallableMockInstance {
                 throw error;
             }
             // Parse and prepare response
-            const response = this.parseResponse(result, matchedRoute.config);
+            const response = parseResponse(result, matchedRoute.config);
             // Apply delay (route-level overrides global)
             await this.applyDelay(matchedRoute.config.delay);
             // Record request in history
@@ -400,8 +411,8 @@ export class CallableMockInstance {
                 method,
                 path: requestPath,
                 params,
-                query: options?.query || {},
-                headers: options?.headers || {},
+                query: reqQuery,
+                headers: reqHeaders,
                 body: options?.body,
                 timestamp: Date.now(),
                 response: { status: response.status, body: response.body },
@@ -434,6 +445,12 @@ export class CallableMockInstance {
             };
             // Apply delay even for error responses
             await this.applyDelay();
+            this.emit("request:end", {
+                method,
+                path,
+                status: 500,
+                duration: performance.now() - handleStart,
+            });
             this.logger.log("error", `[${requestId}] Returning error response 500`);
             this.logger.timeEnd(`request-${requestId}`);
             return errorResponse;
@@ -455,173 +472,4 @@ export class CallableMockInstance {
             : effectiveDelay;
         await new Promise((resolve) => setTimeout(resolve, ms));
     }
-    /**
-     * Parse and normalize response result into Response object
-     * Handles tuple format [status, body, headers], direct values, and response objects
-     * @param result - Raw result from generator or plugin
-     * @param routeConfig - Route configuration for content-type defaults
-     * @returns Normalized Response object with status, body, and headers
-     * @private
-     */
-    parseResponse(result, routeConfig) {
-        let status = 200;
-        let body = result;
-        let headers = {};
-        let tupleFormat = false;
-        // Handle already-formed response objects (from plugin error recovery)
-        if (isResponseObject(result)) {
-            return {
-                status: result.status,
-                body: result.body,
-                headers: result.headers || {},
-            };
-        }
-        // Handle tuple response format [status, body, headers?]
-        if (isStatusTuple(result)) {
-            [status, body, headers = {}] = result;
-            tupleFormat = true;
-        }
-        // Handle null/undefined responses with 204 No Content
-        // But don't auto-convert if tuple format was used (status was explicitly provided)
-        if (body === null || body === undefined) {
-            if (!tupleFormat) {
-                status = status === 200 ? 204 : status; // Only change to 204 if status wasn't explicitly set via tuple
-            }
-            body = undefined; // Ensure body is undefined for null responses
-        }
-        // Add content-type header from route config if it exists and headers don't already have it
-        // But only if this isn't a tuple response (where headers are explicitly controlled)
-        if (!headers["content-type"] && routeConfig.contentType && !tupleFormat) {
-            headers["content-type"] = routeConfig.contentType;
-            // Handle special conversion cases when contentType is explicitly set
-            if (routeConfig.contentType === "text/plain" && body !== undefined) {
-                if (typeof body === "object" && !Buffer.isBuffer(body)) {
-                    body = JSON.stringify(body);
-                }
-                else if (typeof body !== "string") {
-                    body = String(body);
-                }
-            }
-        }
-        return {
-            status,
-            body,
-            headers,
-        };
-    }
-    /**
-     * Run all registered plugins in sequence
-     * First plugin to set response becomes generator, subsequent plugins transform
-     * Handles plugin errors via onError hooks
-     * @param context - Plugin context with request details
-     * @param initialResponse - Initial response from route generator
-     * @param _routeConfig - Route config (unused but kept for signature)
-     * @param _requestId - Request ID (unused but kept for signature)
-     * @returns Updated context and final response after all plugins
-     * @private
-     */
-    async runPluginPipeline(context, initialResponse, _routeConfig, _requestId) {
-        let currentContext = context;
-        let response = initialResponse;
-        this.logger.log("pipeline", `Running plugin pipeline for ${this.plugins.length} plugins`);
-        for (const plugin of this.plugins) {
-            this.logger.log("pipeline", `Processing plugin: ${plugin.name}`);
-            try {
-                const result = await plugin.process(currentContext, response);
-                if (!result || !result.context) {
-                    throw new Error(`Plugin ${plugin.name} didn't return valid result`);
-                }
-                currentContext = result.context;
-                // First plugin to set response becomes the generator
-                if (result.response !== undefined &&
-                    (response === undefined || response === null)) {
-                    this.logger.log("pipeline", `Plugin ${plugin.name} generated response`);
-                    response = result.response;
-                }
-                else if (result.response !== undefined && response !== undefined) {
-                    this.logger.log("pipeline", `Plugin ${plugin.name} transformed response`);
-                    response = result.response;
-                }
-            }
-            catch (error) {
-                this.logger.log("pipeline", `Plugin ${plugin.name} failed: ${errorMessage(error)}`);
-                // Try error handling if plugin has onError hook
-                if (plugin.onError) {
-                    try {
-                        const pluginError = error instanceof Error ? error : new Error(errorMessage(error));
-                        const errorResult = await plugin.onError(pluginError, currentContext);
-                        if (errorResult) {
-                            this.logger.log("pipeline", `Plugin ${plugin.name} handled error`);
-                            // Error return → transform the thrown error
-                            if (errorResult instanceof Error) {
-                                throw new PluginError(plugin.name, errorResult);
-                            }
-                            // ResponseResult return → recover, stop pipeline
-                            if (typeof errorResult === "object" &&
-                                errorResult !== null &&
-                                "status" in errorResult) {
-                                response = errorResult;
-                                break;
-                            }
-                        }
-                        // void/falsy return → propagate original error below
-                    }
-                    catch (hookError) {
-                        // If the hook itself threw (including our PluginError above), re-throw it
-                        if (hookError instanceof PluginError) {
-                            throw hookError;
-                        }
-                        this.logger.log("pipeline", `Plugin ${plugin.name} error handler failed: ${errorMessage(hookError)}`);
-                    }
-                }
-                const cause = error instanceof Error ? error : new Error(errorMessage(error));
-                throw new PluginError(plugin.name, cause);
-            }
-        }
-        return { context: currentContext, response };
-    }
-    /**
-     * Find a route that matches the given method and path
-     * Uses two-pass matching: static routes first, then parameterized routes
-     * Matches routes in registration order (first registered wins)
-     * @param method - HTTP method to match
-     * @param path - Request path to match
-     * @returns Matched compiled route or undefined if no match
-     * @private
-     */
-    findRoute(method, path) {
-        // O(1) lookup for static routes
-        const normalizedPath = path.endsWith("/") && path !== "/" ? path.slice(0, -1) : path;
-        const staticMatch = this.staticRoutes.get(`${method} ${normalizedPath}`);
-        if (staticMatch) {
-            return staticMatch;
-        }
-        // Fall through to parameterized route scan
-        for (const route of this.routes) {
-            if (route.method === method &&
-                route.params.length > 0 &&
-                route.pattern.test(path)) {
-                return route;
-            }
-        }
-        return undefined;
-    }
-    /**
-     * Extract parameter values from path based on route pattern
-     * Maps capture groups from regex match to parameter names
-     * @param route - Compiled route with pattern and param names
-     * @param path - Request path to extract values from
-     * @returns Object mapping parameter names to extracted values
-     * @private
-     */
-    extractParams(route, path) {
-        const match = path.match(route.pattern);
-        if (!match)
-            return {};
-        const params = {};
-        route.params.forEach((param, index) => {
-            params[param] = match[index + 1];
-        });
-        return params;
-    }
 }

package/dist/constants.d.ts

@@ -3,6 +3,8 @@ export declare const ROUTE_NOT_FOUND_CODE: "ROUTE_NOT_FOUND";
 export declare const HTTP_METHODS: readonly HttpMethod[];
 export declare function isHttpMethod(method: string): method is HttpMethod;
 export declare function toHttpMethod(method: string): HttpMethod;
+export declare function normalizePath(path: string): string;
+export declare function toRouteKey(method: HttpMethod, path: string): Schmock.RouteKey;
 /**
  * Check if a value is a status tuple: [status, body] or [status, body, headers]
  * Guards against misinterpreting numeric arrays like [1, 2, 3] as tuples.

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,oBAAoB,EAAG,iBAA0B,CAAC;AAE/D,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAQpC,CAAC;AAEX,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,UAAU,CAEjE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAMvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQxE"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,oBAAoB,EAAG,iBAA0B,CAAC;AAE/D,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAQpC,CAAC;AAEX,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,UAAU,CAEjE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAMvD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAG7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQxE"}

package/dist/constants.js

@@ -18,6 +18,13 @@ export function toHttpMethod(method) {
     }
     return upper;
 }
+export function normalizePath(path) {
+    return path.endsWith("/") && path !== "/" ? path.slice(0, -1) : path;
+}
+export function toRouteKey(method, path) {
+    const key = `${method} ${path}`;
+    return key;
+}
 /**
  * Check if a value is a status tuple: [status, body] or [status, body, headers]
  * Guards against misinterpreting numeric arrays like [1, 2, 3] as tuples.

package/dist/errors.d.ts

@@ -1,3 +1,4 @@
+export declare function errorMessage(error: unknown): string;
 /**
  * Base error class for all Schmock errors
  */

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,YAAA;CAQpC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAOzC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ7C;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAQxC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,YAAY;gBAC/B,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAO7C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ7C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;gBACzC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAQnE;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;gBACzC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,OAAO;CAQ1D;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAQ7D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,YAAA;CAQpC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAOzC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ7C;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAQxC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,YAAY;gBAC/B,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAO7C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ7C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;gBACzC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAQnE;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;gBACzC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,OAAO;CAQ1D;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAQ7D"}

package/dist/errors.js

@@ -1,3 +1,6 @@
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : "Unknown error";
+}
 /**
  * Base error class for all Schmock errors
  */

package/dist/http-helpers.d.ts

@@ -12,8 +12,11 @@ export declare function parseNodeQuery(url: URL): Record<string, string>;
  * Collect and parse the request body from a Node.js IncomingMessage.
  * Returns parsed JSON if content-type includes "json", otherwise the raw string.
  * Returns undefined for empty bodies.
+ * @param req - Node.js IncomingMessage
+ * @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>): Promise<unknown>;
+export declare function collectBody(req: IncomingMessage, 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.

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;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAsBlB;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,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"}

package/dist/http-helpers.js

@@ -21,15 +21,30 @@ export function parseNodeQuery(url) {
     });
     return query;
 }
+/** Default body size limit: 10 MB */
+const DEFAULT_MAX_BODY_SIZE = 10 * 1024 * 1024;
 /**
  * Collect and parse the request body from a Node.js IncomingMessage.
  * Returns parsed JSON if content-type includes "json", otherwise the raw string.
  * Returns undefined for empty bodies.
+ * @param req - Node.js IncomingMessage
+ * @param headers - Parsed request headers
+ * @param maxBodySize - Maximum body size in bytes (default: 10 MB)
  */
-export function collectBody(req, headers) {
-    return new Promise((resolve) => {
+export function collectBody(req, headers, maxBodySize = DEFAULT_MAX_BODY_SIZE) {
+    return new Promise((resolve, reject) => {
         const chunks = [];
-        req.on("data", (chunk) => chunks.push(chunk));
+        let totalSize = 0;
+        req.on("error", reject);
+        req.on("data", (chunk) => {
+            totalSize += chunk.length;
+            if (totalSize > maxBodySize) {
+                req.destroy();
+                reject(Object.assign(new Error("Request body too large"), { status: 413 }));
+                return;
+            }
+            chunks.push(chunk);
+        });
         req.on("end", () => {
             const raw = Buffer.concat(chunks).toString();
             if (!raw) {

package/dist/index.d.ts

@@ -22,7 +22,7 @@
  * @returns A callable mock instance
  */
 export declare function schmock(config?: Schmock.GlobalConfig): Schmock.CallableMockInstance;
-export { HTTP_METHODS, isHttpMethod, isStatusTuple, ROUTE_NOT_FOUND_CODE, toHttpMethod, } from "./constants.js";
+export { HTTP_METHODS, isHttpMethod, isStatusTuple, ROUTE_NOT_FOUND_CODE, toHttpMethod, toRouteKey, } from "./constants.js";
 export { PluginError, ResourceLimitError, ResponseGenerationError, RouteDefinitionError, RouteNotFoundError, RouteParseError, SchemaGenerationError, SchemaValidationError, SchmockError, } from "./errors.js";
 export { collectBody, parseNodeHeaders, parseNodeQuery, writeSchmockResponse, } from "./http-helpers.js";
 export type { CallableMockInstance, Generator, GeneratorFunction, GlobalConfig, HttpMethod, Plugin, PluginContext, PluginResult, RequestContext, RequestOptions, RequestRecord, Response, ResponseBody, ResponseResult, RouteConfig, RouteInfo, RouteKey, ServerInfo, StaticData, } from "./types.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,CAmD9B;AAGD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,YAAY,GACb,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,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,oBAAoB,EACpB,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,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,CAmD9B;AAGD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,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,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,oBAAoB,EACpB,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,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,7 +59,7 @@ export function schmock(config) {
     return callableInstance;
 }
 // Re-export constants and utilities
-export { HTTP_METHODS, isHttpMethod, isStatusTuple, ROUTE_NOT_FOUND_CODE, toHttpMethod, } from "./constants.js";
+export { HTTP_METHODS, isHttpMethod, isStatusTuple, ROUTE_NOT_FOUND_CODE, toHttpMethod, toRouteKey, } from "./constants.js";
 // Re-export errors
 export { PluginError, ResourceLimitError, ResponseGenerationError, RouteDefinitionError, RouteNotFoundError, RouteParseError, SchemaGenerationError, SchemaValidationError, SchmockError, } from "./errors.js";
 // Re-export HTTP server helpers

package/dist/plugin-pipeline.d.ts

@@ -0,0 +1,15 @@
+/** Structural typing — DebugLogger satisfies this without an import */
+interface PipelineLogger {
+    log(category: string, message: string, data?: unknown): void;
+}
+/**
+ * Run all registered plugins in sequence
+ * First plugin to set response becomes generator, subsequent plugins transform
+ * Handles plugin errors via onError hooks
+ */
+export declare function runPluginPipeline(plugins: Schmock.Plugin[], context: Schmock.PluginContext, initialResponse: unknown, logger: PipelineLogger): Promise<{
+    context: Schmock.PluginContext;
+    response?: unknown;
+}>;
+export {};
+//# sourceMappingURL=plugin-pipeline.d.ts.map

package/dist/plugin-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-pipeline.d.ts","sourceRoot":"","sources":["../src/plugin-pipeline.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,UAAU,cAAc;IACtB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9D;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,EACzB,OAAO,EAAE,OAAO,CAAC,aAAa,EAC9B,eAAe,EAAE,OAAO,EACxB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAkFjE"}