@schmock/core 1.0.2 → 1.0.4

package/dist/builder.d.ts

@@ -42,8 +42,8 @@ export declare class CallableMockInstance {
     private runPluginPipeline;
     /**
      * Find a route that matches the given method and path
-     * Uses two-pass matching: exact routes first, then parameterized routes
-     * Searches in reverse order to prefer most recently defined routes
+     * 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

package/dist/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,SAAS,EAET,YAAY,EACZ,UAAU,EACV,MAAM,EAGN,cAAc,EACd,QAAQ,EACR,WAAW,EACX,QAAQ,EACT,MAAM,YAAY,CAAC;AA4CpB;;;;GAIG;AACH,qBAAa,oBAAoB;IAKnB,OAAO,CAAC,YAAY;IAJhC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAc;gBAER,YAAY,GAAE,YAAiB;IAanD,WAAW,CACT,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,WAAW,GAClB,IAAI;IA4DP,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAepB,MAAM,CACV,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC;IAiLpB;;;;OAIG;YACW,UAAU;IAcxB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IA0DrB;;;;;;;;;;OAUG;YACW,iBAAiB;IAmF/B;;;;;;;;OAQG;IACH,OAAO,CAAC,SAAS;IA+BjB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;CActB"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,SAAS,EAET,YAAY,EACZ,UAAU,EACV,MAAM,EAGN,cAAc,EACd,QAAQ,EACR,WAAW,EACX,QAAQ,EACT,MAAM,YAAY,CAAC;AA4CpB;;;;GAIG;AACH,qBAAa,oBAAoB;IAKnB,OAAO,CAAC,YAAY;IAJhC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAc;gBAER,YAAY,GAAE,YAAiB;IAanD,WAAW,CACT,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,WAAW,GAClB,IAAI;IAuEP,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAepB,MAAM,CACV,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC;IAiLpB;;;;OAIG;YACW,UAAU;IAcxB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IA0DrB;;;;;;;;;;OAUG;YACW,iBAAiB;IAuF/B;;;;;;;;OAQG;IACH,OAAO,CAAC,SAAS;IA6BjB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;CActB"}

package/dist/builder.js

@@ -88,6 +88,11 @@ export class CallableMockInstance {
         }
         // Parse the route key to create pattern and extract parameters
         const parsed = parseRouteKey(route);
+        // Check for duplicate routes
+        const existing = this.routes.find((r) => r.method === parsed.method && r.path === parsed.path);
+        if (existing) {
+            this.logger.log("warning", `Duplicate route: ${route} — first registration wins`);
+        }
         // Compile the route
         const compiledRoute = {
             pattern: parsed.pattern,
@@ -116,7 +121,7 @@ export class CallableMockInstance {
         return this;
     }
     async handle(method, path, options) {
-        const requestId = Math.random().toString(36).substring(7);
+        const requestId = Math.random().toString(36).substring(2, 10) || "00000000";
         this.logger.log("request", `[${requestId}] ${method} ${path}`, {
             headers: options?.headers,
             query: options?.query,
@@ -365,7 +370,9 @@ export class CallableMockInstance {
                         if (errorResult) {
                             this.logger.log("pipeline", `Plugin ${plugin.name} handled error`);
                             // If error handler returns response, use it and stop pipeline
-                            if (typeof errorResult === "object" && errorResult.status) {
+                            if (typeof errorResult === "object" &&
+                                errorResult !== null &&
+                                "status" in errorResult) {
                                 // Return the error response as the current response, stop pipeline
                                 response = errorResult;
                                 break;
@@ -383,17 +390,16 @@ export class CallableMockInstance {
     }
     /**
      * Find a route that matches the given method and path
-     * Uses two-pass matching: exact routes first, then parameterized routes
-     * Searches in reverse order to prefer most recently defined routes
+     * 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) {
-        // First pass: Look for exact matches (routes without parameters)
-        for (let i = this.routes.length - 1; i >= 0; i--) {
-            const route = this.routes[i];
+        // First pass: Look for static routes (routes without parameters)
+        for (const route of this.routes) {
             if (route.method === method &&
                 route.params.length === 0 &&
                 route.pattern.test(path)) {
@@ -401,8 +407,7 @@ export class CallableMockInstance {
             }
         }
         // Second pass: Look for parameterized routes
-        for (let i = this.routes.length - 1; i >= 0; i--) {
-            const route = this.routes[i];
+        for (const route of this.routes) {
             if (route.method === method &&
                 route.params.length > 0 &&
                 route.pattern.test(path)) {

package/dist/constants.d.ts

@@ -0,0 +1,6 @@
+import type { HttpMethod } from "./types.js";
+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;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +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"}

package/dist/constants.js

@@ -0,0 +1,20 @@
+export const ROUTE_NOT_FOUND_CODE = "ROUTE_NOT_FOUND";
+export const HTTP_METHODS = [
+    "GET",
+    "POST",
+    "PUT",
+    "DELETE",
+    "PATCH",
+    "HEAD",
+    "OPTIONS",
+];
+export function isHttpMethod(method) {
+    return HTTP_METHODS.includes(method);
+}
+export function toHttpMethod(method) {
+    const upper = method.toUpperCase();
+    if (!isHttpMethod(upper)) {
+        throw new Error(`Invalid HTTP method: "${method}"`);
+    }
+    return upper;
+}

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;CAMpC;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;;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

@@ -9,7 +9,9 @@ export class SchmockError extends Error {
         this.code = code;
         this.context = context;
         this.name = "SchmockError";
-        Error.captureStackTrace(this, this.constructor);
+        if (typeof Error.captureStackTrace === "function") {
+            Error.captureStackTrace(this, this.constructor);
+        }
     }
 }
 /**

package/dist/index.d.ts

@@ -23,6 +23,7 @@ import type { CallableMockInstance, GlobalConfig } from "./types.js";
  * @returns A callable mock instance
  */
 export declare function schmock(config?: GlobalConfig): CallableMockInstance;
+export { HTTP_METHODS, isHttpMethod, ROUTE_NOT_FOUND_CODE, toHttpMethod, } from "./constants.js";
 export { PluginError, ResourceLimitError, ResponseGenerationError, RouteDefinitionError, RouteNotFoundError, RouteParseError, SchemaGenerationError, SchemaValidationError, SchmockError, } from "./errors.js";
-export type { CallableMockInstance, Generator, GeneratorFunction, GlobalConfig, HttpMethod, Plugin, PluginContext, PluginResult, RequestContext, RequestOptions, Response, ResponseResult, RouteConfig, RouteKey, } from "./types.js";
+export type { CallableMockInstance, Generator, GeneratorFunction, GlobalConfig, HttpMethod, Plugin, PluginContext, PluginResult, RequestContext, RequestOptions, Response, ResponseBody, ResponseResult, RouteConfig, RouteKey, StaticData, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EAEpB,YAAY,EAIb,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,oBAAoB,CAsBnE;AAGD,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,oBAAoB,EACpB,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,MAAM,EACN,aAAa,EACb,YAAY,EACZ,cAAc,EACd,cAAc,EACd,QAAQ,EACR,cAAc,EACd,WAAW,EACX,QAAQ,GACT,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EAEpB,YAAY,EAIb,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,oBAAoB,CAsBnE;AAGD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,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;AAGrB,YAAY,EACV,oBAAoB,EACpB,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,MAAM,EACN,aAAa,EACb,YAAY,EACZ,cAAc,EACd,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,WAAW,EACX,QAAQ,EACR,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -38,5 +38,7 @@ export function schmock(config) {
     callableInstance.handle = instance.handle.bind(instance);
     return callableInstance;
 }
+// Re-export constants and utilities
+export { HTTP_METHODS, isHttpMethod, ROUTE_NOT_FOUND_CODE, toHttpMethod, } from "./constants.js";
 // Re-export errors
 export { PluginError, ResourceLimitError, ResponseGenerationError, RouteDefinitionError, RouteNotFoundError, RouteParseError, SchemaGenerationError, SchemaValidationError, SchmockError, } from "./errors.js";

package/dist/types.d.ts

@@ -39,7 +39,7 @@ export interface Plugin {
      * @param response - Response from previous plugin (if any)
      * @returns Updated context and response
      */
-    process(context: PluginContext, response?: any): PluginResult | Promise<PluginResult>;
+    process(context: PluginContext, response?: unknown): PluginResult | Promise<PluginResult>;
     /**
      * Called when an error occurs
      * Can handle, transform, or suppress errors
@@ -56,7 +56,7 @@ export interface PluginResult {
     /** Updated context */
     context: PluginContext;
     /** Response data (if generated/modified) */
-    response?: any;
+    response?: unknown;
 }
 /**
  * Context passed through plugin pipeline
@@ -65,7 +65,7 @@ export interface PluginContext {
     /** Request path */
     path: string;
     /** Matched route configuration */
-    route: any;
+    route: RouteConfig;
     /** HTTP method */
     method: HttpMethod;
     /** Route parameters */
@@ -75,11 +75,11 @@ export interface PluginContext {
     /** Request headers */
     headers: Record<string, string>;
     /** Request body */
-    body?: any;
+    body?: unknown;
     /** Shared state between plugins for this request */
-    state: Map<string, any>;
+    state: Map<string, unknown>;
     /** Route-specific state */
-    routeState?: any;
+    routeState?: Record<string, unknown>;
 }
 /**
  * Global configuration options for the mock instance
@@ -92,7 +92,7 @@ export interface GlobalConfig {
     /** Enable debug mode for detailed logging */
     debug?: boolean;
     /** Initial shared state object */
-    state?: any;
+    state?: Record<string, unknown>;
 }
 /**
  * Route-specific configuration options
@@ -111,10 +111,14 @@ export type Generator = GeneratorFunction | StaticData | JSONSchema;
  * Function that generates responses
  */
 export type GeneratorFunction = (context: RequestContext) => ResponseResult | Promise<ResponseResult>;
+/**
+ * Response body type alias
+ */
+export type ResponseBody = unknown;
 /**
  * Static data (non-function) that gets returned as-is
  */
-export type StaticData = any;
+export type StaticData = string | number | boolean | null | undefined | Record<string, unknown> | unknown[];
 /**
  * Context passed to generator functions
  */
@@ -130,9 +134,9 @@ export interface RequestContext {
     /** Request headers */
     headers: Record<string, string>;
     /** Request body (for POST, PUT, PATCH) */
-    body?: any;
+    body?: unknown;
     /** Shared mutable state */
-    state: any;
+    state: Record<string, unknown>;
 }
 /**
  * Response result types:
@@ -140,13 +144,13 @@ export interface RequestContext {
  * - [status, body]: custom status with body
  * - [status, body, headers]: custom status, body, and headers
  */
-export type ResponseResult = any | [number, any] | [number, any, Record<string, string>];
+export type ResponseResult = ResponseBody | [number, ResponseBody] | [number, ResponseBody, Record<string, string>];
 /**
  * Response object returned by handle method
  */
 export interface Response {
     status: number;
-    body: any;
+    body: unknown;
     headers: Record<string, string>;
 }
 /**
@@ -154,7 +158,7 @@ export interface Response {
  */
 export interface RequestOptions {
     headers?: Record<string, string>;
-    body?: any;
+    body?: unknown;
     query?: Record<string, string>;
 }
 /**

package/dist/types.d.ts.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@schmock/core",
   "description": "Core functionality for Schmock",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -31,9 +31,9 @@
   },
   "license": "MIT",
   "devDependencies": {
-    "@amiceli/vitest-cucumber": "^6.1.0",
-    "@types/node": "^24.9.1",
-    "@vitest/ui": "^4.0.15",
+    "@amiceli/vitest-cucumber": "^6.2.0",
+    "@types/node": "^25.1.0",
+    "@vitest/ui": "^4.0.16",
     "vitest": "^4.0.15"
   }
 }

package/src/builder.ts

@@ -128,6 +128,17 @@ export class CallableMockInstance {
     // Parse the route key to create pattern and extract parameters
     const parsed = parseRouteKey(route);
 
+    // Check for duplicate routes
+    const existing = this.routes.find(
+      (r) => r.method === parsed.method && r.path === parsed.path,
+    );
+    if (existing) {
+      this.logger.log(
+        "warning",
+        `Duplicate route: ${route} — first registration wins`,
+      );
+    }
+
     // Compile the route
     const compiledRoute: CompiledCallableRoute = {
       pattern: parsed.pattern,
@@ -168,7 +179,7 @@ export class CallableMockInstance {
     path: string,
     options?: RequestOptions,
   ): Promise<Response> {
-    const requestId = Math.random().toString(36).substring(7);
+    const requestId = Math.random().toString(36).substring(2, 10) || "00000000";
     this.logger.log("request", `[${requestId}] ${method} ${path}`, {
       headers: options?.headers,
       query: options?.query,
@@ -502,7 +513,11 @@ export class CallableMockInstance {
                 `Plugin ${plugin.name} handled error`,
               );
               // If error handler returns response, use it and stop pipeline
-              if (typeof errorResult === "object" && errorResult.status) {
+              if (
+                typeof errorResult === "object" &&
+                errorResult !== null &&
+                "status" in errorResult
+              ) {
                 // Return the error response as the current response, stop pipeline
                 response = errorResult;
                 break;
@@ -525,8 +540,8 @@ export class CallableMockInstance {
 
   /**
    * Find a route that matches the given method and path
-   * Uses two-pass matching: exact routes first, then parameterized routes
-   * Searches in reverse order to prefer most recently defined routes
+   * 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
@@ -536,9 +551,8 @@ export class CallableMockInstance {
     method: HttpMethod,
     path: string,
   ): CompiledCallableRoute | undefined {
-    // First pass: Look for exact matches (routes without parameters)
-    for (let i = this.routes.length - 1; i >= 0; i--) {
-      const route = this.routes[i];
+    // First pass: Look for static routes (routes without parameters)
+    for (const route of this.routes) {
       if (
         route.method === method &&
         route.params.length === 0 &&
@@ -549,8 +563,7 @@ export class CallableMockInstance {
     }
 
     // Second pass: Look for parameterized routes
-    for (let i = this.routes.length - 1; i >= 0; i--) {
-      const route = this.routes[i];
+    for (const route of this.routes) {
       if (
         route.method === method &&
         route.params.length > 0 &&

package/src/constants.test.ts

@@ -0,0 +1,59 @@
+import { describe, expect, it } from "vitest";
+import {
+  HTTP_METHODS,
+  isHttpMethod,
+  ROUTE_NOT_FOUND_CODE,
+  toHttpMethod,
+} from "./constants";
+
+describe("constants", () => {
+  it("exports ROUTE_NOT_FOUND_CODE", () => {
+    expect(ROUTE_NOT_FOUND_CODE).toBe("ROUTE_NOT_FOUND");
+  });
+
+  it("exports all HTTP methods", () => {
+    expect(HTTP_METHODS).toEqual([
+      "GET",
+      "POST",
+      "PUT",
+      "DELETE",
+      "PATCH",
+      "HEAD",
+      "OPTIONS",
+    ]);
+  });
+});
+
+describe("isHttpMethod", () => {
+  it("returns true for valid HTTP methods", () => {
+    for (const method of HTTP_METHODS) {
+      expect(isHttpMethod(method)).toBe(true);
+    }
+  });
+
+  it("returns false for invalid methods", () => {
+    expect(isHttpMethod("INVALID")).toBe(false);
+    expect(isHttpMethod("")).toBe(false);
+    expect(isHttpMethod("get")).toBe(false);
+  });
+});
+
+describe("toHttpMethod", () => {
+  it("converts lowercase to uppercase", () => {
+    expect(toHttpMethod("get")).toBe("GET");
+    expect(toHttpMethod("post")).toBe("POST");
+    expect(toHttpMethod("delete")).toBe("DELETE");
+  });
+
+  it("returns already uppercase methods", () => {
+    expect(toHttpMethod("GET")).toBe("GET");
+    expect(toHttpMethod("PATCH")).toBe("PATCH");
+  });
+
+  it("throws for invalid methods", () => {
+    expect(() => toHttpMethod("INVALID")).toThrow(
+      'Invalid HTTP method: "INVALID"',
+    );
+    expect(() => toHttpMethod("")).toThrow('Invalid HTTP method: ""');
+  });
+});

package/src/constants.ts

@@ -0,0 +1,25 @@
+import type { HttpMethod } from "./types.js";
+
+export const ROUTE_NOT_FOUND_CODE = "ROUTE_NOT_FOUND" as const;
+
+export const HTTP_METHODS: readonly HttpMethod[] = [
+  "GET",
+  "POST",
+  "PUT",
+  "DELETE",
+  "PATCH",
+  "HEAD",
+  "OPTIONS",
+] as const;
+
+export function isHttpMethod(method: string): method is HttpMethod {
+  return HTTP_METHODS.includes(method as HttpMethod);
+}
+
+export function toHttpMethod(method: string): HttpMethod {
+  const upper = method.toUpperCase();
+  if (!isHttpMethod(upper)) {
+    throw new Error(`Invalid HTTP method: "${method}"`);
+  }
+  return upper;
+}

package/src/errors.ts

@@ -9,7 +9,9 @@ export class SchmockError extends Error {
   ) {
     super(message);
     this.name = "SchmockError";
-    Error.captureStackTrace(this, this.constructor);
+    if (typeof Error.captureStackTrace === "function") {
+      Error.captureStackTrace(this, this.constructor);
+    }
   }
 }
 

package/src/index.ts

@@ -55,6 +55,13 @@ export function schmock(config?: GlobalConfig): CallableMockInstance {
   return callableInstance as CallableMockInstance;
 }
 
+// Re-export constants and utilities
+export {
+  HTTP_METHODS,
+  isHttpMethod,
+  ROUTE_NOT_FOUND_CODE,
+  toHttpMethod,
+} from "./constants.js";
 // Re-export errors
 export {
   PluginError,
@@ -81,7 +88,9 @@ export type {
   RequestContext,
   RequestOptions,
   Response,
+  ResponseBody,
   ResponseResult,
   RouteConfig,
   RouteKey,
+  StaticData,
 } from "./types.js";

package/src/route-matching.test.ts

@@ -128,7 +128,7 @@ describe("route matching", () => {
   });
 
   describe("route precedence and conflicts", () => {
-    it("matches most recently defined route when patterns overlap", async () => {
+    it("prioritizes static routes over parameterized routes", async () => {
       const mock = schmock();
       mock("GET /users/:id", "parameterized");
       mock("GET /users/special", "static");
@@ -136,7 +136,7 @@ describe("route matching", () => {
       const paramResponse = await mock.handle("GET", "/users/123");
       const staticResponse = await mock.handle("GET", "/users/special");
 
-      // The static route should be matched since it was defined later
+      // Static routes should always be checked before parameterized routes
       expect(paramResponse.body).toBe("parameterized");
       expect(staticResponse.body).toBe("static");
     });
@@ -153,18 +153,61 @@ describe("route matching", () => {
       expect(v1Response.body).toBe("v1-specific");
     });
 
-    it("matches first matching route in definition order", async () => {
+    it("matches routes in registration order (first registered wins)", async () => {
       const mock = schmock();
       mock("GET /:type/items", "first");
       mock("GET /shop/:category", "second");
 
       const response = await mock.handle("GET", "/shop/items");
 
-      // Both routes match, but with reverse order search, the second route should win
-      // /:type/items matches with type="shop"
-      // /shop/:category matches with category="items"
-      // Since we search in reverse, /shop/:category (more specific) should match
-      expect(response.body).toBe("second");
+      // Both routes match, but the first registered route should win
+      // This matches the behavior of Express, Hono, Fastify, etc.
+      expect(response.body).toBe("first");
+    });
+
+    it("matches specific routes before wildcard when registered in natural order", async () => {
+      // Bug report reproduction: natural order (specific before wildcard)
+      const mock = schmock();
+      mock("GET /api/items/special", () => ({ type: "special" }));
+      mock("GET /api/items/:id", () => ({ type: "generic" }));
+
+      const specialResult = await mock.handle("GET", "/api/items/special");
+      const genericResult = await mock.handle("GET", "/api/items/123");
+
+      // Static route should match for /api/items/special
+      expect(specialResult.body).toEqual({ type: "special" });
+      // Parameterized route should match for /api/items/123
+      expect(genericResult.body).toEqual({ type: "generic" });
+    });
+
+    it("matches multiple specific routes before wildcard", async () => {
+      // Bug report scenario with multiple specific routes
+      const mock = schmock();
+      mock("GET /api/vulns/aggregated", "aggregated");
+      mock("GET /api/vulns/count", "count");
+      mock("GET /api/vulns/familyList", "familyList");
+      mock("GET /api/vulns/:vulnId", "byId");
+
+      const aggregatedRes = await mock.handle("GET", "/api/vulns/aggregated");
+      const countRes = await mock.handle("GET", "/api/vulns/count");
+      const familyListRes = await mock.handle("GET", "/api/vulns/familyList");
+      const byIdRes = await mock.handle("GET", "/api/vulns/CVE-2024-1234");
+
+      expect(aggregatedRes.body).toBe("aggregated");
+      expect(countRes.body).toBe("count");
+      expect(familyListRes.body).toBe("familyList");
+      expect(byIdRes.body).toBe("byId");
+    });
+
+    it("matches overlapping parameterized routes in registration order", async () => {
+      const mock = schmock();
+      mock("GET /api/:org/users/:id", "first-pattern");
+      mock("GET /api/:version/users/:userId", "second-pattern");
+
+      const response = await mock.handle("GET", "/api/acme/users/123");
+
+      // When both routes are parameterized and match, first registered wins
+      expect(response.body).toBe("first-pattern");
     });
   });
 
@@ -268,7 +311,7 @@ describe("route matching", () => {
       mock("GET /items/:id", ({ params }) => ({
         id: params.id,
         type: typeof params.id,
-        parsed: Number.parseInt(params.id),
+        parsed: Number.parseInt(params.id, 10),
       }));
 
       const response = await mock.handle("GET", "/items/12345");

package/src/steps/developer-experience.steps.ts

@@ -413,6 +413,24 @@ describeFeature(feature, ({ Scenario }) => {
     });
   });
 
+  Scenario("Registering duplicate routes first route wins", ({ Given, When, Then }) => {
+    Given("I create a mock with duplicate routes:", (_, docString: string) => {
+      mock = schmock();
+      mock('GET /items', [{ id: 1 }]);
+      mock('GET /items', [{ id: 2 }]);
+    });
+
+    When("I request {string}", async (_, request: string) => {
+      const [method, path] = request.split(" ");
+      response = await mock.handle(method as any, path);
+    });
+
+    Then("the first route response should win:", (_, docString: string) => {
+      const expected = JSON.parse(docString);
+      expect(response.body).toEqual(expected);
+    });
+  });
+
   Scenario("Plugin returning unexpected structure", ({ Given, When, Then, And }) => {
     Given("I create a mock with malformed plugin:", (_, docString: string) => {
       mock = schmock();

package/src/steps/error-handling.steps.ts

@@ -361,6 +361,31 @@ describeFeature(feature, ({ Scenario }) => {
     });
   });
 
+  Scenario("Plugin onError returns response with status 0", ({ Given, When, Then, And }) => {
+    Given("I create a mock with status-zero error handler:", (_, docString: string) => {
+      mock = schmock();
+      const plugin = {
+        name: 'zero-status',
+        process: () => { throw new Error('fail'); },
+        onError: () => ({ status: 0, body: 'zero status', headers: {} })
+      };
+      mock('GET /zero', 'original').pipe(plugin);
+    });
+
+    When("I request {string}", async (_, request: string) => {
+      const [method, path] = request.split(" ");
+      response = await mock.handle(method as any, path);
+    });
+
+    Then("I should receive status {int}", (_, status: number) => {
+      expect(response.status).toBe(status);
+    });
+
+    And("I should receive text {string}", (_, expectedText: string) => {
+      expect(response.body).toBe(expectedText);
+    });
+  });
+
   Scenario("Plugin null/undefined return handling", ({ Given, When, Then, And }) => {
     Given("I create a mock with null-returning plugin:", (_, docString: string) => {
       mock = schmock();

package/src/types.ts

@@ -52,7 +52,7 @@ export interface Plugin {
    */
   process(
     context: PluginContext,
-    response?: any,
+    response?: unknown,
   ): PluginResult | Promise<PluginResult>;
 
   /**
@@ -79,7 +79,7 @@ export interface PluginResult {
   /** Updated context */
   context: PluginContext;
   /** Response data (if generated/modified) */
-  response?: any;
+  response?: unknown;
 }
 
 /**
@@ -89,7 +89,7 @@ export interface PluginContext {
   /** Request path */
   path: string;
   /** Matched route configuration */
-  route: any;
+  route: RouteConfig;
   /** HTTP method */
   method: HttpMethod;
   /** Route parameters */
@@ -99,11 +99,11 @@ export interface PluginContext {
   /** Request headers */
   headers: Record<string, string>;
   /** Request body */
-  body?: any;
+  body?: unknown;
   /** Shared state between plugins for this request */
-  state: Map<string, any>;
+  state: Map<string, unknown>;
   /** Route-specific state */
-  routeState?: any;
+  routeState?: Record<string, unknown>;
 }
 
 /**
@@ -117,7 +117,7 @@ export interface GlobalConfig {
   /** Enable debug mode for detailed logging */
   debug?: boolean;
   /** Initial shared state object */
-  state?: any;
+  state?: Record<string, unknown>;
 }
 
 /**
@@ -142,10 +142,22 @@ export type GeneratorFunction = (
   context: RequestContext,
 ) => ResponseResult | Promise<ResponseResult>;
 
+/**
+ * Response body type alias
+ */
+export type ResponseBody = unknown;
+
 /**
  * Static data (non-function) that gets returned as-is
  */
-export type StaticData = any;
+export type StaticData =
+  | string
+  | number
+  | boolean
+  | null
+  | undefined
+  | Record<string, unknown>
+  | unknown[];
 
 /**
  * Context passed to generator functions
@@ -162,9 +174,9 @@ export interface RequestContext {
   /** Request headers */
   headers: Record<string, string>;
   /** Request body (for POST, PUT, PATCH) */
-  body?: any;
+  body?: unknown;
   /** Shared mutable state */
-  state: any;
+  state: Record<string, unknown>;
 }
 
 /**
@@ -174,16 +186,16 @@ export interface RequestContext {
  * - [status, body, headers]: custom status, body, and headers
  */
 export type ResponseResult =
-  | any
-  | [number, any]
-  | [number, any, Record<string, string>];
+  | ResponseBody
+  | [number, ResponseBody]
+  | [number, ResponseBody, Record<string, string>];
 
 /**
  * Response object returned by handle method
  */
 export interface Response {
   status: number;
-  body: any;
+  body: unknown;
   headers: Record<string, string>;
 }
 
@@ -192,7 +204,7 @@ export interface Response {
  */
 export interface RequestOptions {
   headers?: Record<string, string>;
-  body?: any;
+  body?: unknown;
   query?: Record<string, string>;
 }