@schmock/core 1.12.0 → 2.0.0

package/dist/builder.d.ts

@@ -13,6 +13,7 @@ export declare class CallableMockInstance {
     private callableRef;
     private server;
     private serverInfo;
+    private interceptHandle;
     private listeners;
     constructor(globalConfig?: Schmock.GlobalConfig);
     defineRoute(route: Schmock.RouteKey, generator: Schmock.Generator, config: Schmock.RouteConfig): this;
@@ -32,6 +33,7 @@ export declare class CallableMockInstance {
     resetState(): void;
     listen(port?: number, hostname?: string): Promise<Schmock.ServerInfo>;
     close(): void;
+    intercept(options?: Schmock.InterceptOptions): Schmock.InterceptHandle;
     handle(method: Schmock.HttpMethod, path: string, options?: Schmock.RequestOptions): Promise<Schmock.Response>;
     /**
      * Apply configured response delay

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;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"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAwDA;;;;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;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;IAYb,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;IAoO5B;;;;OAIG;YACW,UAAU;CAezB"}

package/dist/builder.js

@@ -2,6 +2,7 @@ import { createServer } from "node:http";
 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 { parseResponse } from "./response-parser.js";
@@ -52,6 +53,7 @@ export class CallableMockInstance {
     callableRef;
     server;
     serverInfo;
+    interceptHandle = null;
     // biome-ignore lint/complexity/noBannedTypes: internal storage for event listeners with varying signatures
     listeners = new Map();
     constructor(globalConfig = {}) {
@@ -284,6 +286,14 @@ export class CallableMockInstance {
         this.serverInfo = undefined;
         this.logger.log("server", "Server stopped");
     }
+    // ===== Fetch Interceptor =====
+    intercept(options) {
+        if (this.interceptHandle?.active) {
+            throw new SchmockError("Already intercepting. Call restore() first.", "ALREADY_INTERCEPTING");
+        }
+        this.interceptHandle = createFetchInterceptor((method, path, opts) => this.handle(method, path, opts), options);
+        return this.interceptHandle;
+    }
     async handle(method, path, options) {
         const handleStart = performance.now();
         const requestId = this.globalConfig.debug ? crypto.randomUUID() : "";

package/dist/constants.d.ts

@@ -5,6 +5,14 @@ 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 Schmock response is a route-not-found response.
+ * Used by adapters to decide whether to pass through to the real backend.
+ */
+export declare function isRouteNotFound(response: {
+    status: number;
+    body: unknown;
+}): boolean;
 /**
  * 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,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"}
+{"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,eAAe,CAAC,QAAQ,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CASV;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

@@ -25,6 +25,18 @@ export function toRouteKey(method, path) {
     const key = `${method} ${path}`;
     return key;
 }
+/**
+ * Check if a Schmock response is a route-not-found response.
+ * Used by adapters to decide whether to pass through to the real backend.
+ */
+export function isRouteNotFound(response) {
+    const { status, body } = response;
+    return (status === 404 &&
+        body !== null &&
+        typeof body === "object" &&
+        "code" in body &&
+        body.code === ROUTE_NOT_FOUND_CODE);
+}
 /**
  * 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/helpers.d.ts

@@ -0,0 +1,9 @@
+export declare function notFound(message?: string | object): [number, object];
+export declare function badRequest(message?: string | object): [number, object];
+export declare function unauthorized(message?: string | object): [number, object];
+export declare function forbidden(message?: string | object): [number, object];
+export declare function serverError(message?: string | object): [number, object];
+export declare function created(body: object): [number, object];
+export declare function noContent(): [number, null];
+export declare function paginate<T>(items: T[], options?: Schmock.PaginateOptions): Schmock.PaginatedResponse<T>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CACtB,OAAO,GAAE,MAAM,GAAG,MAAoB,GACrC,CAAC,MAAM,EAAE,MAAM,CAAC,CAGlB;AAED,wBAAgB,UAAU,CACxB,OAAO,GAAE,MAAM,GAAG,MAAsB,GACvC,CAAC,MAAM,EAAE,MAAM,CAAC,CAGlB;AAED,wBAAgB,YAAY,CAC1B,OAAO,GAAE,MAAM,GAAG,MAAuB,GACxC,CAAC,MAAM,EAAE,MAAM,CAAC,CAGlB;AAED,wBAAgB,SAAS,CACvB,OAAO,GAAE,MAAM,GAAG,MAAoB,GACrC,CAAC,MAAM,EAAE,MAAM,CAAC,CAGlB;AAED,wBAAgB,WAAW,CACzB,OAAO,GAAE,MAAM,GAAG,MAAgC,GACjD,CAAC,MAAM,EAAE,MAAM,CAAC,CAGlB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtD;AAED,wBAAgB,SAAS,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAE1C;AAED,wBAAgB,QAAQ,CAAC,CAAC,EACxB,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,GAAE,OAAO,CAAC,eAAoB,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAS9B"}

package/dist/helpers.js

@@ -0,0 +1,37 @@
+/// <reference path="../schmock.d.ts" />
+export function notFound(message = "Not Found") {
+    const body = typeof message === "string" ? { message } : message;
+    return [404, body];
+}
+export function badRequest(message = "Bad Request") {
+    const body = typeof message === "string" ? { message } : message;
+    return [400, body];
+}
+export function unauthorized(message = "Unauthorized") {
+    const body = typeof message === "string" ? { message } : message;
+    return [401, body];
+}
+export function forbidden(message = "Forbidden") {
+    const body = typeof message === "string" ? { message } : message;
+    return [403, body];
+}
+export function serverError(message = "Internal Server Error") {
+    const body = typeof message === "string" ? { message } : message;
+    return [500, body];
+}
+export function created(body) {
+    return [201, body];
+}
+export function noContent() {
+    return [204, null];
+}
+export function paginate(items, options = {}) {
+    const page = options.page || 1;
+    const pageSize = options.pageSize || 10;
+    const total = items.length;
+    const totalPages = Math.ceil(total / pageSize);
+    const start = (page - 1) * pageSize;
+    const end = start + pageSize;
+    const data = items.slice(start, end);
+    return { data, page, pageSize, total, totalPages };
+}

package/dist/index.d.ts

@@ -22,8 +22,10 @@
  * @returns A callable mock instance
  */
 export declare function schmock(config?: Schmock.GlobalConfig): Schmock.CallableMockInstance;
-export { HTTP_METHODS, isHttpMethod, isStatusTuple, ROUTE_NOT_FOUND_CODE, toHttpMethod, toRouteKey, } from "./constants.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";
 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";
+export { createFetchInterceptor } from "./interceptor.js";
+export type { AdapterRequest, AdapterResponse, CallableMockInstance, Generator, GeneratorFunction, GlobalConfig, HttpMethod, InterceptHandle, InterceptOptions, Plugin, PluginContext, PluginResult, RequestContext, RequestOptions, RequestRecord, Response, ResponseBody, ResponseResult, RouteConfig, RouteInfo, RouteKey, ServerInfo, 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":"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"}
+{"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"}

package/dist/index.js

@@ -54,13 +54,19 @@ export function schmock(config) {
         getState: instance.getState.bind(instance),
         listen: instance.listen.bind(instance),
         close: instance.close.bind(instance),
+        intercept: (options) => instance.intercept(options),
     });
     instance.setCallableRef(callableInstance);
     return callableInstance;
 }
 // Re-export constants and utilities
-export { HTTP_METHODS, isHttpMethod, isStatusTuple, ROUTE_NOT_FOUND_CODE, toHttpMethod, toRouteKey, } from "./constants.js";
+export { HTTP_METHODS, isHttpMethod, isRouteNotFound, 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 response helpers
+export { badRequest, created, forbidden, noContent, notFound, paginate, serverError, unauthorized, } from "./helpers.js";
 // Re-export HTTP server helpers
 export { collectBody, parseNodeHeaders, parseNodeQuery, writeSchmockResponse, } from "./http-helpers.js";
+// Re-export types
+// Re-export interceptor
+export { createFetchInterceptor } from "./interceptor.js";

package/dist/interceptor.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Create a fetch interceptor that routes requests through mock.handle().
+ */
+export declare function createFetchInterceptor(handle: (method: Schmock.HttpMethod, path: string, requestOptions?: Schmock.RequestOptions) => Promise<Schmock.Response>, options?: Schmock.InterceptOptions): Schmock.InterceptHandle;
+//# sourceMappingURL=interceptor.d.ts.map

package/dist/interceptor.d.ts.map

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

package/dist/interceptor.js

@@ -0,0 +1,196 @@
+/// <reference path="../schmock.d.ts" />
+import { isRouteNotFound, toHttpMethod } from "./constants.js";
+/**
+ * Extract pathname from a URL string, handling both absolute and relative URLs.
+ */
+function extractPathname(url) {
+    const queryStart = url.indexOf("?");
+    const urlWithoutQuery = queryStart === -1 ? url : url.slice(0, queryStart);
+    if (urlWithoutQuery.includes("://")) {
+        try {
+            return new URL(urlWithoutQuery).pathname;
+        }
+        catch {
+            // Fall through to simple extraction
+        }
+    }
+    if (!urlWithoutQuery.startsWith("/")) {
+        return `/${urlWithoutQuery}`;
+    }
+    return urlWithoutQuery;
+}
+/**
+ * Extract query parameters from a URL string.
+ */
+function extractQuery(url) {
+    const queryStart = url.indexOf("?");
+    if (queryStart === -1)
+        return {};
+    const params = new URLSearchParams(url.slice(queryStart + 1));
+    const result = {};
+    params.forEach((value, key) => {
+        result[key] = value;
+    });
+    return result;
+}
+/**
+ * Extract headers from fetch init or Request object.
+ */
+function extractHeaders(input, init) {
+    const headers = {};
+    const raw = input instanceof Request ? input.headers : init?.headers;
+    if (!raw)
+        return headers;
+    if (raw instanceof Headers) {
+        raw.forEach((value, key) => {
+            headers[key] = value;
+        });
+    }
+    else if (Array.isArray(raw)) {
+        for (const [key, value] of raw) {
+            headers[key] = value;
+        }
+    }
+    else {
+        Object.assign(headers, raw);
+    }
+    return headers;
+}
+/**
+ * Extract body from fetch init, parsing JSON when possible.
+ */
+async function extractBody(input, init) {
+    const rawBody = input instanceof Request ? input.body : init?.body;
+    if (rawBody === null || rawBody === undefined)
+        return undefined;
+    // String body — try to parse as JSON
+    const bodyInit = init?.body;
+    if (typeof bodyInit === "string") {
+        try {
+            return JSON.parse(bodyInit);
+        }
+        catch {
+            return bodyInit;
+        }
+    }
+    // Request with body — clone and read
+    if (input instanceof Request && input.body) {
+        try {
+            return await input.clone().json();
+        }
+        catch {
+            try {
+                return await input.clone().text();
+            }
+            catch {
+                return undefined;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Create a fetch interceptor that routes requests through mock.handle().
+ */
+export function createFetchInterceptor(handle, options = {}) {
+    const { baseUrl, passthrough = true, beforeRequest, beforeResponse, errorFormatter, } = options;
+    const originalFetch = globalThis.fetch;
+    let active = true;
+    globalThis.fetch = async (input, init) => {
+        // Resolve the URL string
+        const urlString = input instanceof Request
+            ? input.url
+            : input instanceof URL
+                ? input.href
+                : input;
+        const path = extractPathname(urlString);
+        // BaseUrl filter — non-matching requests go straight to real fetch
+        if (baseUrl && !path.startsWith(baseUrl)) {
+            return originalFetch(input, init);
+        }
+        // Build adapter request
+        const method = input instanceof Request ? input.method : (init?.method ?? "GET");
+        const headers = extractHeaders(input, init);
+        const query = extractQuery(urlString);
+        const body = await extractBody(input, init);
+        let adapterRequest = {
+            method,
+            path,
+            headers,
+            body,
+            query,
+        };
+        try {
+            // Apply beforeRequest hook
+            if (beforeRequest) {
+                const modified = await beforeRequest(adapterRequest);
+                if (modified) {
+                    adapterRequest = modified;
+                }
+            }
+            const schmockResponse = await handle(toHttpMethod(adapterRequest.method), adapterRequest.path, {
+                headers: adapterRequest.headers,
+                body: adapterRequest.body,
+                query: adapterRequest.query,
+            });
+            // Route not found — passthrough or 404
+            if (isRouteNotFound(schmockResponse)) {
+                if (passthrough) {
+                    return originalFetch(input, init);
+                }
+                return new Response(JSON.stringify({
+                    error: "No matching mock route found",
+                    code: "ROUTE_NOT_FOUND",
+                }), {
+                    status: 404,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            // Apply beforeResponse hook
+            let response = schmockResponse;
+            if (beforeResponse) {
+                const modified = await beforeResponse(response, adapterRequest);
+                if (modified) {
+                    response = modified;
+                }
+            }
+            // Build fetch Response
+            const responseHeaders = new Headers(response.headers);
+            if (!responseHeaders.has("content-type") &&
+                response.body !== null &&
+                response.body !== undefined) {
+                responseHeaders.set("content-type", "application/json");
+            }
+            const responseBody = response.body === null || response.body === undefined
+                ? null
+                : typeof response.body === "string"
+                    ? response.body
+                    : JSON.stringify(response.body);
+            return new Response(responseBody, {
+                status: response.status,
+                headers: responseHeaders,
+            });
+        }
+        catch (error) {
+            if (errorFormatter) {
+                const formatted = errorFormatter(error instanceof Error ? error : new Error(String(error)));
+                return new Response(JSON.stringify(formatted), {
+                    status: 500,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            throw error;
+        }
+    };
+    return {
+        restore() {
+            if (active) {
+                globalThis.fetch = originalFetch;
+                active = false;
+            }
+        },
+        get active() {
+            return active;
+        },
+    };
+}

package/dist/plugin-pipeline.js

@@ -12,7 +12,7 @@ export async function runPluginPipeline(plugins, context, initialResponse, logge
         logger.log("pipeline", `Processing plugin: ${plugin.name}`);
         try {
             const result = await plugin.process(currentContext, response);
-            if (!result || !result.context) {
+            if (!result?.context) {
                 throw new Error(`Plugin ${plugin.name} didn't return valid result`);
             }
             currentContext = result.context;

package/dist/types.d.ts

@@ -26,4 +26,8 @@ export type SeedSource = Schmock.SeedSource;
 export type SeedConfig = Schmock.SeedConfig;
 export type CliOptions = Schmock.CliOptions;
 export type CliServer = Schmock.CliServer;
+export type AdapterRequest = Schmock.AdapterRequest;
+export type AdapterResponse = Schmock.AdapterResponse;
+export type InterceptOptions = Schmock.InterceptOptions;
+export type InterceptHandle = Schmock.InterceptHandle;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;AACxC,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;AAChD,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;AACpD,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;AACpD,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;AACxC,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;AACpD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;AAC9C,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAC1C,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;AAC1D,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;AAChE,MAAM,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;AACpC,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;AAChD,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAC5C,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;AAClD,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAC5C,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAC1C,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC5D,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;AAClE,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;AACpD,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAC5C,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAC5C,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAC5C,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;AACxC,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;AAChD,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;AACpD,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;AACpD,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;AACxC,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;AACpD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;AAC9C,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAC1C,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;AAC1D,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;AAChE,MAAM,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;AACpC,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;AAChD,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAC5C,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;AAClD,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAC5C,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAC1C,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC5D,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;AAClE,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;AACpD,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAC5C,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAC5C,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAC5C,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAC1C,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;AACpD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;AACtD,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@schmock/core",
   "description": "Core functionality for Schmock",
-  "version": "1.12.0",
+  "version": "2.0.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -35,7 +35,7 @@
     "@amiceli/vitest-cucumber": "^6.3.0",
     "@types/json-schema": "^7.0.15",
     "@types/node": "^25.5.0",
-    "@vitest/ui": "^4.1.1",
-    "vitest": "^4.1.1"
+    "@vitest/ui": "^4.1.2",
+    "vitest": "^4.1.2"
   }
 }

package/src/builder.ts

@@ -13,6 +13,7 @@ import {
   parseNodeQuery,
   writeSchmockResponse,
 } from "./http-helpers.js";
+import { createFetchInterceptor } from "./interceptor.js";
 import { parseRouteKey } from "./parser.js";
 import { runPluginPipeline } from "./plugin-pipeline.js";
 import { parseResponse } from "./response-parser.js";
@@ -67,6 +68,7 @@ export class CallableMockInstance {
   private callableRef: Schmock.CallableMockInstance | undefined;
   private server: Server | undefined;
   private serverInfo: Schmock.ServerInfo | undefined;
+  private interceptHandle: Schmock.InterceptHandle | null = null;
   // biome-ignore lint/complexity/noBannedTypes: internal storage for event listeners with varying signatures
   private listeners = new Map<string, Set<Function>>();
 
@@ -374,6 +376,24 @@ export class CallableMockInstance {
     this.logger.log("server", "Server stopped");
   }
 
+  // ===== Fetch Interceptor =====
+
+  intercept(options?: Schmock.InterceptOptions): Schmock.InterceptHandle {
+    if (this.interceptHandle?.active) {
+      throw new SchmockError(
+        "Already intercepting. Call restore() first.",
+        "ALREADY_INTERCEPTING",
+      );
+    }
+
+    this.interceptHandle = createFetchInterceptor(
+      (method, path, opts) => this.handle(method, path, opts),
+      options,
+    );
+
+    return this.interceptHandle;
+  }
+
   async handle(
     method: Schmock.HttpMethod,
     path: string,

package/src/constants.test.ts

@@ -2,6 +2,7 @@ import { describe, expect, it } from "vitest";
 import {
   HTTP_METHODS,
   isHttpMethod,
+  isRouteNotFound,
   ROUTE_NOT_FOUND_CODE,
   toHttpMethod,
 } from "./constants";
@@ -57,3 +58,42 @@ describe("toHttpMethod", () => {
     expect(() => toHttpMethod("")).toThrow('Invalid HTTP method: ""');
   });
 });
+
+describe("isRouteNotFound", () => {
+  it("returns true for a route-not-found response", () => {
+    const response = {
+      status: 404,
+      body: { error: "Route not found", code: ROUTE_NOT_FOUND_CODE },
+      headers: {},
+    };
+    expect(isRouteNotFound(response)).toBe(true);
+  });
+
+  it("returns false for a regular 404 response", () => {
+    const response = {
+      status: 404,
+      body: { message: "User not found" },
+      headers: {},
+    };
+    expect(isRouteNotFound(response)).toBe(false);
+  });
+
+  it("returns false for a non-404 response", () => {
+    const response = {
+      status: 200,
+      body: { code: ROUTE_NOT_FOUND_CODE },
+      headers: {},
+    };
+    expect(isRouteNotFound(response)).toBe(false);
+  });
+
+  it("returns false when body is null", () => {
+    const response = { status: 404, body: null, headers: {} };
+    expect(isRouteNotFound(response)).toBe(false);
+  });
+
+  it("returns false when body is a string", () => {
+    const response = { status: 404, body: "not found", headers: {} };
+    expect(isRouteNotFound(response)).toBe(false);
+  });
+});

package/src/constants.ts

@@ -33,6 +33,24 @@ export function toRouteKey(method: HttpMethod, path: string): Schmock.RouteKey {
   return key;
 }
 
+/**
+ * Check if a Schmock response is a route-not-found response.
+ * Used by adapters to decide whether to pass through to the real backend.
+ */
+export function isRouteNotFound(response: {
+  status: number;
+  body: unknown;
+}): boolean {
+  const { status, body } = response;
+  return (
+    status === 404 &&
+    body !== null &&
+    typeof body === "object" &&
+    "code" in body &&
+    body.code === ROUTE_NOT_FOUND_CODE
+  );
+}
+
 /**
  * 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.