@schmock/core 1.1.0 → 1.2.1

package/dist/builder.d.ts

@@ -10,8 +10,10 @@ export declare class CallableMockInstance {
     private plugins;
     private logger;
     private requestHistory;
+    private callableRef;
     constructor(globalConfig?: Schmock.GlobalConfig);
     defineRoute(route: Schmock.RouteKey, generator: Schmock.Generator, config: Schmock.RouteConfig): this;
+    setCallableRef(ref: Schmock.CallableMockInstance): void;
     pipe(plugin: Schmock.Plugin): this;
     history(method?: Schmock.HttpMethod, path?: string): Schmock.RequestRecord[];
     called(method?: Schmock.HttpMethod, path?: string): boolean;

package/dist/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAyEA;;;;GAIG;AACH,qBAAa,oBAAoB;IAOnB,OAAO,CAAC,YAAY;IANhC,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;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,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI;IAiBlC,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,KAAK,IAAI,IAAI;IAab,YAAY,IAAI,IAAI;IAKpB,UAAU,IAAI,IAAI;IASZ,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;IAoL5B;;;;OAIG;YACW,UAAU;IAcxB;;;;;;;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":"AA0EA;;;;GAIG;AACH,qBAAa,oBAAoB;IAQnB,OAAO,CAAC,YAAY;IAPhC,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;gBAE1C,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,KAAK,IAAI,IAAI;IAab,YAAY,IAAI,IAAI;IAKpB,UAAU,IAAI,IAAI;IASZ,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;IAoL5B;;;;OAIG;YACW,UAAU;IAcxB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAwDrB;;;;;;;;;;OAUG;YACW,iBAAiB;IAqG/B;;;;;;;;OAQG;IACH,OAAO,CAAC,SAAS;IA0BjB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;CActB"}

package/dist/builder.js

@@ -1,3 +1,4 @@
+import { isStatusTuple } from "./constants.js";
 import { PluginError, RouteDefinitionError, RouteNotFoundError, SchmockError, } from "./errors.js";
 import { parseRouteKey } from "./parser.js";
 function errorMessage(error) {
@@ -55,6 +56,7 @@ export class CallableMockInstance {
     plugins = [];
     logger;
     requestHistory = [];
+    callableRef;
     constructor(globalConfig = {}) {
         this.globalConfig = globalConfig;
         this.logger = new DebugLogger(globalConfig.debug || false);
@@ -135,6 +137,9 @@ export class CallableMockInstance {
         });
         return this;
     }
+    setCallableRef(ref) {
+        this.callableRef = ref;
+    }
     pipe(plugin) {
         this.plugins.push(plugin);
         this.logger.log("plugin", `Registered plugin: ${plugin.name}@${plugin.version || "unknown"}`, {
@@ -143,6 +148,9 @@ export class CallableMockInstance {
             hasProcess: typeof plugin.process === "function",
             hasOnError: typeof plugin.onError === "function",
         });
+        if (plugin.install && this.callableRef) {
+            plugin.install(this.callableRef);
+        }
         return this;
     }
     // ===== Request Spy / History API =====
@@ -367,7 +375,7 @@ export class CallableMockInstance {
             };
         }
         // Handle tuple response format [status, body, headers?]
-        if (Array.isArray(result) && typeof result[0] === "number") {
+        if (isStatusTuple(result)) {
             [status, body, headers = {}] = result;
             tupleFormat = true;
         }

package/dist/constants.d.ts

@@ -3,4 +3,9 @@ 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;
+/**
+ * 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.
+ */
+export declare function isStatusTuple(value: unknown): value is [number, unknown] | [number, unknown, Record<string, string>];
 //# sourceMappingURL=constants.d.ts.map

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

package/dist/constants.js

@@ -18,3 +18,14 @@ export function toHttpMethod(method) {
     }
     return upper;
 }
+/**
+ * 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.
+ */
+export function isStatusTuple(value) {
+    return (Array.isArray(value) &&
+        (value.length === 2 || value.length === 3) &&
+        typeof value[0] === "number" &&
+        value[0] >= 100 &&
+        value[0] <= 599);
+}

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, ROUTE_NOT_FOUND_CODE, toHttpMethod, } from "./constants.js";
+export { HTTP_METHODS, isHttpMethod, isStatusTuple, 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, RequestRecord, 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":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CACrB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,GAC5B,OAAO,CAAC,oBAAoB,CA+B9B;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;AAErB,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,QAAQ,EACR,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,CAiC9B;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,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,QAAQ,EACR,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -43,9 +43,10 @@ export function schmock(config) {
         resetHistory: instance.resetHistory.bind(instance),
         resetState: instance.resetState.bind(instance),
     });
+    instance.setCallableRef(callableInstance);
     return callableInstance;
 }
 // Re-export constants and utilities
-export { HTTP_METHODS, isHttpMethod, ROUTE_NOT_FOUND_CODE, toHttpMethod, } from "./constants.js";
+export { HTTP_METHODS, isHttpMethod, isStatusTuple, 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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@schmock/core",
   "description": "Core functionality for Schmock",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -32,8 +32,8 @@
   "license": "MIT",
   "devDependencies": {
     "@amiceli/vitest-cucumber": "^6.2.0",
-    "@types/node": "^25.1.0",
-    "@vitest/ui": "^4.0.16",
-    "vitest": "^4.0.15"
+    "@types/node": "^25.2.1",
+    "@vitest/ui": "^4.0.18",
+    "vitest": "^4.0.18"
   }
 }

package/src/builder.ts

@@ -1,3 +1,4 @@
+import { isStatusTuple } from "./constants.js";
 import {
   PluginError,
   RouteDefinitionError,
@@ -82,6 +83,7 @@ export class CallableMockInstance {
   private plugins: Schmock.Plugin[] = [];
   private logger: DebugLogger;
   private requestHistory: Schmock.RequestRecord[] = [];
+  private callableRef: Schmock.CallableMockInstance | undefined;
 
   constructor(private globalConfig: Schmock.GlobalConfig = {}) {
     this.logger = new DebugLogger(globalConfig.debug || false);
@@ -185,6 +187,10 @@ export class CallableMockInstance {
     return this;
   }
 
+  setCallableRef(ref: Schmock.CallableMockInstance): void {
+    this.callableRef = ref;
+  }
+
   pipe(plugin: Schmock.Plugin): this {
     this.plugins.push(plugin);
     this.logger.log(
@@ -197,6 +203,9 @@ export class CallableMockInstance {
         hasOnError: typeof plugin.onError === "function",
       },
     );
+    if (plugin.install && this.callableRef) {
+      plugin.install(this.callableRef);
+    }
     return this;
   }
 
@@ -502,7 +511,7 @@ export class CallableMockInstance {
     }
 
     // Handle tuple response format [status, body, headers?]
-    if (Array.isArray(result) && typeof result[0] === "number") {
+    if (isStatusTuple(result)) {
       [status, body, headers = {}] = result;
       tupleFormat = true;
     }

package/src/constants.ts

@@ -23,3 +23,19 @@ export function toHttpMethod(method: string): HttpMethod {
   }
   return upper;
 }
+
+/**
+ * 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.
+ */
+export function isStatusTuple(
+  value: unknown,
+): value is [number, unknown] | [number, unknown, Record<string, string>] {
+  return (
+    Array.isArray(value) &&
+    (value.length === 2 || value.length === 3) &&
+    typeof value[0] === "number" &&
+    value[0] >= 100 &&
+    value[0] <= 599
+  );
+}

package/src/index.ts

@@ -55,6 +55,8 @@ export function schmock(
     },
   );
 
+  instance.setCallableRef(callableInstance);
+
   return callableInstance;
 }
 
@@ -62,6 +64,7 @@ export function schmock(
 export {
   HTTP_METHODS,
   isHttpMethod,
+  isStatusTuple,
   ROUTE_NOT_FOUND_CODE,
   toHttpMethod,
 } from "./constants.js";

package/src/parser.property.test.ts

@@ -124,9 +124,7 @@ const namespace = fc.oneof(
   safeSeg.map((s) => `/${s}/`), // trailing slash
   fc.constant(""),
   safeSeg.map((s) => `//${s}`), // double leading slash
-  fc
-    .tuple(safeSeg, safeSeg)
-    .map(([a, b]) => `/${a}/${b}`), // nested
+  fc.tuple(safeSeg, safeSeg).map(([a, b]) => `/${a}/${b}`), // nested
 );
 
 // ============================================================

package/src/plugin-system.test.ts

@@ -420,6 +420,97 @@ describe("plugin system", () => {
     });
   });
 
+  describe("plugin install hook", () => {
+    it("calls install with callable instance when pipe() is invoked", () => {
+      const mock = schmock();
+      let receivedInstance: unknown;
+
+      const plugin: Schmock.Plugin = {
+        name: "install-test",
+        install(instance) {
+          receivedInstance = instance;
+        },
+        process: (ctx: any, res: any) => ({ context: ctx, response: res }),
+      };
+
+      mock.pipe(plugin);
+      expect(receivedInstance).toBe(mock);
+    });
+
+    it("works normally when plugin has no install method", async () => {
+      const mock = schmock();
+
+      const plugin: Schmock.Plugin = {
+        name: "no-install",
+        process: (ctx: any, res: any) => ({ context: ctx, response: res }),
+      };
+
+      mock("GET /test", "hello").pipe(plugin);
+      const response = await mock.handle("GET", "/test");
+      expect(response.body).toBe("hello");
+    });
+
+    it("allows install to register routes on the instance", async () => {
+      const mock = schmock();
+
+      const plugin: Schmock.Plugin = {
+        name: "route-installer",
+        install(instance) {
+          instance("GET /installed", { message: "from-install" });
+        },
+        process: (ctx: any, res: any) => ({ context: ctx, response: res }),
+      };
+
+      mock.pipe(plugin);
+
+      const response = await mock.handle("GET", "/installed");
+      expect(response.status).toBe(200);
+      expect(response.body).toEqual({ message: "from-install" });
+    });
+
+    it("allows install to register multiple routes", async () => {
+      const mock = schmock();
+
+      const plugin: Schmock.Plugin = {
+        name: "multi-route-installer",
+        install(instance) {
+          instance("GET /a", "route-a");
+          instance("POST /b", "route-b");
+        },
+        process: (ctx: any, res: any) => ({ context: ctx, response: res }),
+      };
+
+      mock.pipe(plugin);
+
+      const responseA = await mock.handle("GET", "/a");
+      expect(responseA.body).toBe("route-a");
+
+      const responseB = await mock.handle("POST", "/b");
+      expect(responseB.body).toBe("route-b");
+    });
+
+    it("routes registered in install work with generator functions", async () => {
+      const mock = schmock();
+
+      const plugin: Schmock.Plugin = {
+        name: "generator-installer",
+        install(instance) {
+          instance("GET /items/:id", (ctx) => ({
+            id: ctx.params.id,
+            name: "test",
+          }));
+        },
+        process: (ctx: any, res: any) => ({ context: ctx, response: res }),
+      };
+
+      mock.pipe(plugin);
+
+      const response = await mock.handle("GET", "/items/42");
+      expect(response.status).toBe(200);
+      expect(response.body).toEqual({ id: "42", name: "test" });
+    });
+  });
+
   describe("debug logging", () => {
     it("logs plugin pipeline execution with debug enabled", async () => {
       const mock = schmock({ debug: true });

package/src/response-parsing.test.ts

@@ -3,15 +3,14 @@ import { schmock } from "./index";
 
 describe("response parsing", () => {
   describe("tuple response formats", () => {
-    it("handles status-only tuple [status]", async () => {
+    it("treats single-element array [status] as data, not tuple", async () => {
       const mock = schmock();
       mock("GET /status-only", () => [204] as [number]);
 
       const response = await mock.handle("GET", "/status-only");
 
-      expect(response.status).toBe(204);
-      expect(response.body).toBeUndefined();
-      expect(response.headers).toEqual({});
+      expect(response.status).toBe(200);
+      expect(response.body).toEqual([204]);
     });
 
     it("handles [status, body] tuple", async () => {
@@ -61,7 +60,7 @@ describe("response parsing", () => {
       expect(response.headers).toEqual({});
     });
 
-    it("ignores extra tuple elements beyond [status, body, headers]", async () => {
+    it("treats arrays with more than 3 elements as data, not tuple", async () => {
       const mock = schmock();
       mock(
         "GET /extra",
@@ -71,8 +70,13 @@ describe("response parsing", () => {
       const response = await mock.handle("GET", "/extra");
 
       expect(response.status).toBe(200);
-      expect(response.body).toBe("data");
-      expect(response.headers).toEqual({});
+      expect(response.body).toEqual([
+        200,
+        "data",
+        {},
+        "ignored",
+        "also-ignored",
+      ]);
     });
 
     it("treats non-numeric first element as body, not status", async () => {

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

@@ -342,7 +342,7 @@ describeFeature(feature, ({ Scenario }) => {
   Scenario("Response tuple format edge cases", ({ Given, When, Then, And }) => {
     Given("I create a mock with three tuple response routes", () => {
       mock = schmock();
-      mock("GET /created", [201]);
+      mock("GET /created", [201, null]);
       mock("GET /with-headers", [200, { data: true }, { "x-custom": "header" }]);
       mock("GET /empty-with-status", [204, null]);
     });