@schmock/core 2.3.0 → 2.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Khalic Lab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# @schmock/core
+
+Core mock builder, routing, and plugin pipeline for Schmock.
+
+Part of [Schmock](https://github.com/khalic-lab/schmock) — mock APIs from OpenAPI specs or hand-crafted routes.
+
+## Install
+
+```bash
+bun add -d @schmock/core
+```
+
+## Usage
+
+```typescript
+import { schmock } from "@schmock/core";
+
+const mock = schmock();
+
+mock("GET /users", [{ id: 1, name: "Alice" }]);
+mock("POST /users", ({ body }) => [201, body]);
+
+const response = await mock.handle("GET", "/users");
+// → { status: 200, body: [{ id: 1, name: "Alice" }] }
+```
+
+## Documentation
+
+- [Getting started](https://github.com/khalic-lab/schmock/blob/main/docs/getting-started.md)
+- [API reference](https://github.com/khalic-lab/schmock/blob/main/docs/api.md)
+- [Plugin development](https://github.com/khalic-lab/schmock/blob/main/docs/plugins.md)
+
+## License
+
+MIT © Khalic Lab

package/dist/abort.d.ts

@@ -0,0 +1,3 @@
+export declare function throwIfAborted(signal?: AbortSignal): void;
+export declare function awaitWithAbort<T>(value: T | PromiseLike<T>, signal?: AbortSignal): Promise<T>;
+//# sourceMappingURL=abort.d.ts.map

package/dist/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AASA,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAEzD;AAED,wBAAgB,cAAc,CAAC,CAAC,EAC9B,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EACzB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,CAAC,CAmBZ"}

package/dist/abort.js

@@ -0,0 +1,30 @@
+function abortReason(signal) {
+    if ("reason" in signal && signal.reason !== undefined) {
+        return signal.reason;
+    }
+    const error = new Error("Request aborted");
+    error.name = "AbortError";
+    return error;
+}
+export function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw abortReason(signal);
+}
+export function awaitWithAbort(value, signal) {
+    if (!signal)
+        return Promise.resolve(value);
+    throwIfAborted(signal);
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (action) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener("abort", abort);
+            action();
+        };
+        const abort = () => finish(() => reject(abortReason(signal)));
+        signal.addEventListener("abort", abort, { once: true });
+        Promise.resolve(value).then((result) => finish(() => resolve(result)), (error) => finish(() => reject(error)));
+    });
+}

package/dist/builder.d.ts

@@ -1,3 +1,20 @@
+import type { CompiledCallableRoute } from "./route-matcher.js";
+interface RequestAdmission {
+    readonly requestGeneration: RequestGeneration;
+    readonly historyGeneration: symbol;
+    readonly plugins: readonly Schmock.Plugin[];
+    readonly routes: CompiledCallableRoute[];
+    readonly staticRoutes: Map<string, CompiledCallableRoute>;
+    readonly state: Record<string, unknown>;
+    readonly namespace?: string;
+    readonly globalDelay?: number | [number, number];
+    readonly maxHistorySize?: number;
+    released: boolean;
+}
+interface RequestGeneration {
+    activeAdmissions: number;
+    retiredPlugins?: readonly Schmock.Plugin[];
+}
 /**
  * Callable mock instance that implements the new API.
  *
@@ -5,7 +22,6 @@
  */
 export declare class CallableMockInstance {
     #private;
-    private globalConfig;
     private routes;
     private staticRoutes;
     private plugins;
@@ -13,19 +29,19 @@ export declare class CallableMockInstance {
     private requestHistory;
     private callableRef;
     private server;
-    private serverInfo;
-    private interceptHandle;
+    private pendingServerStart;
+    private serverCloseBarrier;
+    private interceptHandles;
+    private requestGeneration;
+    private historyGeneration;
+    private interceptOwner;
+    private globalConfig;
     private listeners;
     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;
-    /**
-     * FIX 2.3: Deep-clone a request record so callers cannot corrupt internal
-     * history by mutating nested body/response objects.
-     * Falls back to a shallow spread for bodies that are not structuredClone-able
-     * (e.g. Buffers, streams — rare in practice but defensively handled).
-     */
+    private uninstallPlugins;
     private cloneRecord;
     history(method?: Schmock.HttpMethod, path?: string): Schmock.RequestRecord[];
     called(method?: Schmock.HttpMethod, path?: string): boolean;
@@ -39,10 +55,14 @@ export declare class CallableMockInstance {
     reset(): void;
     resetHistory(): void;
     resetState(): void;
+    createRequestAdmission(): {
+        handle: (method: Schmock.HttpMethod, path: string, options?: Schmock.RequestOptions) => Promise<Schmock.Response>;
+        release: () => 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>;
+    handle(method: Schmock.HttpMethod, path: string, options?: Schmock.RequestOptions, admission?: RequestAdmission): Promise<Schmock.Response>;
     /**
      * Apply configured response delay
      * Supports both fixed delays and random delays within a range
@@ -50,4 +70,5 @@ export declare class CallableMockInstance {
      */
     private applyDelay;
 }
+export {};
 //# 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":"AA4DA;;;;GAIG;AACH,qBAAa,oBAAoB;;IAanB,OAAO,CAAC,YAAY;IAZhC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,YAAY,CAA4C;IAChE,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,WAAW,CAA2C;IAC9D,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,eAAe,CAAwC;IAE/D,OAAO,CAAC,SAAS,CAAoC;gBAEjC,YAAY,GAAE,OAAO,CAAC,YAAiB;IAa3D,WAAW,CACT,KAAK,EAAE,OAAO,CAAC,QAAQ,EACvB,SAAS,EAAE,OAAO,CAAC,SAAS,EAC5B,MAAM,EAAE,OAAO,CAAC,WAAW,GAC1B,IAAI;IAsFP,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,oBAAoB,GAAG,IAAI;IAIvD,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI;IAoBlC;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE;IAW5E,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO;IAS3D,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAS7D,WAAW,CACT,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAC3B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,GAAG,SAAS;IAgBpC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE;IAQhC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMnC,EAAE,CAAC,CAAC,SAAS,OAAO,CAAC,YAAY,EAC/B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,IAAI;IAUP,GAAG,CAAC,CAAC,SAAS,OAAO,CAAC,YAAY,EAChC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,IAAI;IAKP,OAAO,CAAC,IAAI;IAWZ,KAAK,IAAI,IAAI;IAiBb,YAAY,IAAI,IAAI;IAKpB,UAAU,IAAI,IAAI;IAWlB,MAAM,CAAC,IAAI,SAAI,EAAE,QAAQ,SAAc,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;IAwErE,KAAK,IAAI,IAAI;IAab,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC,eAAe;IAgBhE,MAAM,CACV,MAAM,EAAE,OAAO,CAAC,UAAU,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,GAC/B,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;IAgR5B;;;;OAIG;YACW,UAAU;CAgBzB"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAqBhE,UAAU,gBAAgB;IACxB,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,CAAC,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,iBAAiB;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,SAAS,OAAO,CAAC,MAAM,EAAE,CAAC;CAC5C;AA+KD;;;;GAIG;AACH,qBAAa,oBAAoB;;IAC/B,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,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,gBAAgB,CAAsC;IAC9D,OAAO,CAAC,iBAAiB,CAA8C;IACvE,OAAO,CAAC,iBAAiB,CAAwC;IACjE,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,YAAY,CAAuB;IAE3C,OAAO,CAAC,SAAS,CAAoC;gBAEzC,YAAY,GAAE,OAAO,CAAC,YAAiB;IAkBnD,WAAW,CACT,KAAK,EAAE,OAAO,CAAC,QAAQ,EACvB,SAAS,EAAE,OAAO,CAAC,SAAS,EAC5B,MAAM,EAAE,OAAO,CAAC,WAAW,GAC1B,IAAI;IAsFP,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,oBAAoB,GAAG,IAAI;IAIvD,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI;IA8GlC,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,WAAW;IAkCnB,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;IAO3D,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAQ7D,WAAW,CACT,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,EAC3B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,GAAG,SAAS;IAgBpC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE;IAQhC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMnC,EAAE,CAAC,CAAC,SAAS,OAAO,CAAC,YAAY,EAC/B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,IAAI;IAUP,GAAG,CAAC,CAAC,SAAS,OAAO,CAAC,YAAY,EAChC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,IAAI;IAKP,OAAO,CAAC,IAAI;IAsCZ,KAAK,IAAI,IAAI;IAgBb,YAAY,IAAI,IAAI;IAMpB,UAAU,IAAI,IAAI;IAiDlB,sBAAsB;yBAIR,OAAO,CAAC,UAAU,QACpB,MAAM,YACF,OAAO,CAAC,cAAc;;;IAQtC,MAAM,CAAC,IAAI,SAAI,EAAE,QAAQ,SAAc,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;IAsNrE,KAAK,IAAI,IAAI;IAYb,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC,eAAe;IAwChE,MAAM,CACV,MAAM,EAAE,OAAO,CAAC,UAAU,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,EAChC,SAAS,CAAC,EAAE,gBAAgB,GAC3B,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;IA2c5B;;;;OAIG;YACW,UAAU;CAmCzB"}