@schmock/core 2.3.0 → 2.4.0

package/dist/constants.d.ts

@@ -1,9 +1,46 @@
 import type { HttpMethod } from "./types.js";
 export declare const ROUTE_NOT_FOUND_CODE: "ROUTE_NOT_FOUND";
+interface ResponseLike {
+    status: number;
+    body: unknown;
+}
+export declare function markRouteNotFound<T extends ResponseLike>(response: T): T;
+export declare function markResponseException<T extends ResponseLike>(response: T, error: Error): T;
+export declare function getResponseException(response: ResponseLike): Error | undefined;
 export declare const HTTP_METHODS: readonly HttpMethod[];
 export declare function isHttpMethod(method: string): method is HttpMethod;
 export declare function toHttpMethod(method: string): HttpMethod;
 export declare function normalizePath(path: string): string;
+/**
+ * Put a path into the single canonical (percent-encoded) transport form.
+ *
+ * A path reaches core either as `url.pathname` (already encoded by the URL
+ * parser) or as whatever string a `handle()` caller typed, so route paths and
+ * request paths must be encoded the same way before they can be compared.
+ * Encoding is idempotent: an existing valid `%XX` triplet is normalized to
+ * uppercase rather than re-encoded, so applying this at route-parse time and
+ * again at request time is safe.
+ *
+ * This deliberately never throws and never resolves `.`/`..` — an unreachable
+ * spelling is preferable to silently rewriting the caller's path.
+ */
+export declare function canonicalizePath(path: string): string;
+/**
+ * Decode a single captured path parameter.
+ *
+ * Decoding happens AFTER segmentation, so an encoded separator (`%2F`) stays
+ * inside one parameter and reaches the generator as "/" — the same as Express.
+ * A malformed sequence (`%ZZ`) is handed back untouched rather than throwing.
+ */
+export declare function decodePathSegment(segment: string): string;
+/**
+ * Build a route key from a method and a path.
+ *
+ * `Schmock.RouteKey` requires a leading slash, so a path without one is
+ * normalized rather than rejected — callers feed spec paths and pathnames that
+ * are already absolute, and silently producing an unreachable route key would
+ * be worse than adding the slash.
+ */
 export declare function toRouteKey(method: HttpMethod, path: string): Schmock.RouteKey;
 /**
  * Check if a Schmock response is a route-not-found response.
@@ -23,4 +60,5 @@ export declare function isRouteNotFound(response: {
  * status() helper or return an object response when the data could collide.
  */
 export declare function isStatusTuple(value: unknown): value is [number, unknown] | [number, unknown, Record<string, string>];
+export {};
 //# 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;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;;;;;;;;GAQG;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,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AA+BD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAGxE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,YAAY,EAC1D,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,KAAK,GACX,CAAC,CAGH;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,GACrB,KAAK,GAAG,SAAS,CAGnB;AAED,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;AAwBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA+BrD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAK7E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAWV;AAED;;;;;;;;GAQG;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

@@ -1,4 +1,37 @@
 export const ROUTE_NOT_FOUND_CODE = "ROUTE_NOT_FOUND";
+const RESPONSE_ORIGIN = Symbol.for("@schmock/core.response-origin");
+function setResponseOrigin(response, origin) {
+    Object.defineProperty(response, RESPONSE_ORIGIN, {
+        configurable: true,
+        value: origin,
+    });
+}
+function getResponseOrigin(response) {
+    const origin = Reflect.get(response, RESPONSE_ORIGIN);
+    if (typeof origin !== "object" || origin === null || !("kind" in origin)) {
+        return undefined;
+    }
+    if (origin.kind === "route-not-found")
+        return { kind: "route-not-found" };
+    if (origin.kind === "exception" &&
+        "error" in origin &&
+        origin.error instanceof Error) {
+        return { kind: "exception", error: origin.error };
+    }
+    return undefined;
+}
+export function markRouteNotFound(response) {
+    setResponseOrigin(response, { kind: "route-not-found" });
+    return response;
+}
+export function markResponseException(response, error) {
+    setResponseOrigin(response, { kind: "exception", error });
+    return response;
+}
+export function getResponseException(response) {
+    const origin = getResponseOrigin(response);
+    return origin?.kind === "exception" ? origin.error : undefined;
+}
 export const HTTP_METHODS = [
     "GET",
     "POST",
@@ -21,15 +54,103 @@ export function toHttpMethod(method) {
 export function normalizePath(path) {
     return path.endsWith("/") && path !== "/" ? path.slice(0, -1) : path;
 }
+/**
+ * ASCII characters the URL parser percent-encodes inside a path even though
+ * they are printable. `?` and `#` are delimiters there rather than encoded, but
+ * encoding them here is what makes a route containing one reachable at all.
+ */
+const PATH_ENCODED_ASCII = new Set([
+    " ",
+    '"',
+    "#",
+    "<",
+    ">",
+    "?",
+    "^",
+    "`",
+    "{",
+    "}",
+]);
+const PERCENT_TRIPLET = /^%[0-9A-Fa-f]{2}$/;
+/** UTF-8 for U+FFFD, the URL parser's substitute for a lone surrogate. */
+const ENCODED_REPLACEMENT_CHARACTER = "%EF%BF%BD";
+/**
+ * Put a path into the single canonical (percent-encoded) transport form.
+ *
+ * A path reaches core either as `url.pathname` (already encoded by the URL
+ * parser) or as whatever string a `handle()` caller typed, so route paths and
+ * request paths must be encoded the same way before they can be compared.
+ * Encoding is idempotent: an existing valid `%XX` triplet is normalized to
+ * uppercase rather than re-encoded, so applying this at route-parse time and
+ * again at request time is safe.
+ *
+ * This deliberately never throws and never resolves `.`/`..` — an unreachable
+ * spelling is preferable to silently rewriting the caller's path.
+ */
+export function canonicalizePath(path) {
+    let result = "";
+    for (let index = 0; index < path.length;) {
+        if (path[index] === "%" &&
+            PERCENT_TRIPLET.test(path.slice(index, index + 3))) {
+            result += path.slice(index, index + 3).toUpperCase();
+            index += 3;
+            continue;
+        }
+        const codePoint = path.codePointAt(index) ?? 0;
+        const character = String.fromCodePoint(codePoint);
+        index += character.length;
+        if (codePoint <= 0x1f ||
+            codePoint > 0x7e ||
+            PATH_ENCODED_ASCII.has(character)) {
+            try {
+                result += encodeURIComponent(character);
+            }
+            catch {
+                result += ENCODED_REPLACEMENT_CHARACTER;
+            }
+        }
+        else {
+            result += character;
+        }
+    }
+    return result;
+}
+/**
+ * Decode a single captured path parameter.
+ *
+ * Decoding happens AFTER segmentation, so an encoded separator (`%2F`) stays
+ * inside one parameter and reaches the generator as "/" — the same as Express.
+ * A malformed sequence (`%ZZ`) is handed back untouched rather than throwing.
+ */
+export function decodePathSegment(segment) {
+    try {
+        return decodeURIComponent(segment);
+    }
+    catch {
+        return segment;
+    }
+}
+/**
+ * Build a route key from a method and a path.
+ *
+ * `Schmock.RouteKey` requires a leading slash, so a path without one is
+ * normalized rather than rejected — callers feed spec paths and pathnames that
+ * are already absolute, and silently producing an unreachable route key would
+ * be worse than adding the slash.
+ */
 export function toRouteKey(method, path) {
-    const key = `${method} ${path}`;
-    return key;
+    // Built from the slash rather than concatenated onto it, so the template
+    // literal proves the leading slash `RouteKey` requires without an assertion.
+    const relativePath = path.startsWith("/") ? path.slice(1) : path;
+    return `${method} /${relativePath}`;
 }
 /**
  * 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) {
+    if (getResponseOrigin(response)?.kind === "route-not-found")
+        return true;
     const { status, body } = response;
     return (status === 404 &&
         body !== null &&

package/dist/errors.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Describe a thrown value.
+ *
+ * Non-Error throws keep whatever they carry — a bare string, a primitive or the
+ * JSON of a plain object — because "Unknown error" is useless while debugging a
+ * mock. Only `null`/`undefined` (which carry nothing) and values that cannot be
+ * stringified safely fall back to "Unknown error"; a throwing `toString`, a
+ * throwing getter or a circular reference must never turn the error path into a
+ * second exception. Long stringifications are truncated so 500 bodies and debug
+ * logs stay bounded.
+ */
 export declare function errorMessage(error: unknown): string;
 /**
  * Base error class for all Schmock errors
@@ -20,10 +31,10 @@ export declare class RouteParseError extends SchmockError {
     constructor(routeKey: string, reason: string);
 }
 /**
- * Error thrown when response generation fails
+ * Error thrown when a response cannot be represented safely by transports
  */
-export declare class ResponseGenerationError extends SchmockError {
-    constructor(route: string, error: Error);
+export declare class InvalidResponseError extends SchmockError {
+    constructor(reason: string, context?: Record<string, unknown>);
 }
 /**
  * Error thrown when a plugin fails

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -1,5 +1,37 @@
+/** Longest stringification of a non-Error throw kept in a message. */
+const MAX_THROWN_VALUE_LENGTH = 200;
+function truncateThrownValue(text) {
+    return text.length > MAX_THROWN_VALUE_LENGTH
+        ? `${text.slice(0, MAX_THROWN_VALUE_LENGTH)}…`
+        : text;
+}
+/**
+ * Describe a thrown value.
+ *
+ * Non-Error throws keep whatever they carry — a bare string, a primitive or the
+ * JSON of a plain object — because "Unknown error" is useless while debugging a
+ * mock. Only `null`/`undefined` (which carry nothing) and values that cannot be
+ * stringified safely fall back to "Unknown error"; a throwing `toString`, a
+ * throwing getter or a circular reference must never turn the error path into a
+ * second exception. Long stringifications are truncated so 500 bodies and debug
+ * logs stay bounded.
+ */
 export function errorMessage(error) {
-    return error instanceof Error ? error.message : "Unknown error";
+    if (error instanceof Error)
+        return error.message;
+    if (error === null || error === undefined)
+        return "Unknown error";
+    if (typeof error === "string")
+        return truncateThrownValue(error);
+    try {
+        const text = typeof error === "object" ? JSON.stringify(error) : String(error);
+        if (typeof text !== "string" || text.length === 0)
+            return "Unknown error";
+        return truncateThrownValue(text);
+    }
+    catch {
+        return "Unknown error";
+    }
 }
 /**
  * Base error class for all Schmock errors
@@ -39,12 +71,15 @@ export class RouteParseError extends SchmockError {
     }
 }
 /**
- * Error thrown when response generation fails
+ * Error thrown when a response cannot be represented safely by transports
  */
-export class ResponseGenerationError extends SchmockError {
-    constructor(route, error) {
-        super(`Failed to generate response for route ${route}: ${error.message}`, "RESPONSE_GENERATION_ERROR", { route, originalError: error });
-        this.name = "ResponseGenerationError";
+export class InvalidResponseError extends SchmockError {
+    constructor(reason, context = {}) {
+        super(`Invalid response: ${reason}`, "INVALID_RESPONSE", {
+            ...context,
+            reason,
+        });
+        this.name = "InvalidResponseError";
     }
 }
 /**

package/dist/helpers.d.ts

@@ -5,5 +5,14 @@ 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];
+/**
+ * Slice `items` into a page envelope.
+ *
+ * `page` and `pageSize` are normalized to positive integers (falling back to
+ * page 1 and a page size of 10) so a fractional, negative, NaN or infinite
+ * option can never produce a nonsensical slice or a negative `totalPages`. The
+ * returned envelope always echoes the NORMALIZED values, so it is internally
+ * consistent with `data`.
+ */
 export declare function paginate<T>(items: T[], options?: Schmock.PaginateOptions): Schmock.PaginatedResponse<T>;
 //# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -1 +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"}
+{"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;AAWD;;;;;;;;GAQG;AACH,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

@@ -25,9 +25,25 @@ export function created(body) {
 export function noContent() {
     return [204, null];
 }
+/** Default page size used when `pageSize` is absent or not a positive integer. */
+const DEFAULT_PAGE_SIZE = 10;
+function positiveInteger(value, fallback) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 1
+        ? value
+        : fallback;
+}
+/**
+ * Slice `items` into a page envelope.
+ *
+ * `page` and `pageSize` are normalized to positive integers (falling back to
+ * page 1 and a page size of 10) so a fractional, negative, NaN or infinite
+ * option can never produce a nonsensical slice or a negative `totalPages`. The
+ * returned envelope always echoes the NORMALIZED values, so it is internally
+ * consistent with `data`.
+ */
 export function paginate(items, options = {}) {
-    const page = options.page || 1;
-    const pageSize = options.pageSize || 10;
+    const page = positiveInteger(options.page, 1);
+    const pageSize = positiveInteger(options.pageSize, DEFAULT_PAGE_SIZE);
     const total = items.length;
     const totalPages = Math.ceil(total / pageSize);
     const start = (page - 1) * pageSize;

package/dist/http-helpers.d.ts

@@ -1,15 +1,27 @@
-import type { ServerResponse } from "node:http";
 interface RequestWithHeaders {
     readonly headers: {
         readonly [header: string]: string | string[] | undefined;
     };
 }
 interface BodyReadable {
+    on(event: "aborted", listener: () => void): this;
+    on(event: "close", listener: () => void): this;
     on(event: "error", listener: (error: Error) => void): this;
-    on(event: "data", listener: (chunk: Buffer) => void): this;
+    on(event: "data", listener: (chunk: Uint8Array) => void): this;
     on(event: "end", listener: () => void): this;
     destroy(error?: Error): this;
 }
+interface ResponseWritable {
+    writeHead(status: number, headers: Record<string, string>): this;
+    end(body?: string | Uint8Array): this;
+}
+export type HttpIngressErrorCode = "MALFORMED_JSON" | "PAYLOAD_TOO_LARGE";
+/** An HTTP client error raised while collecting an incoming request body. */
+export declare class HttpIngressError extends Error {
+    readonly status: 400 | 413;
+    readonly code: HttpIngressErrorCode;
+    constructor(status: 400 | 413, code: HttpIngressErrorCode, message: string);
+}
 /**
  * Convert Node.js IncomingMessage headers to a flat Record<string, string>.
  * Drops array-valued headers (keeps only string values).
@@ -21,17 +33,40 @@ export declare function parseNodeHeaders(req: RequestWithHeaders): Record<string
 export declare function parseNodeQuery(url: URL): Record<string, string>;
 /**
  * Collect and parse the request body from a Node.js IncomingMessage.
- * Returns parsed JSON if content-type includes "json", otherwise the raw string.
+ * Returns parsed JSON for application/json and +json media types, otherwise the
+ * raw string.
  * Returns undefined for empty bodies.
  * @param req - Node.js IncomingMessage
  * @param headers - Parsed request headers
  * @param maxBodySize - Maximum body size in bytes (default: 10 MB)
  */
 export declare function collectBody(req: BodyReadable, headers: Record<string, string>, maxBodySize?: number): Promise<unknown>;
+interface RejectedRequestReadable {
+    resume(): unknown;
+    on(event: "data", listener: (chunk: Uint8Array) => void): unknown;
+    off(event: "data", listener: (chunk: Uint8Array) => void): unknown;
+    once(event: "end" | "close", listener: () => void): unknown;
+}
+interface RejectedResponseWritable extends ResponseWritable {
+    readonly writableEnded: boolean;
+    write(chunk: string | Uint8Array): unknown;
+    once(event: "close", listener: () => void): unknown;
+}
 /**
  * Write a Schmock Response to a Node.js ServerResponse.
  * Serializes non-string bodies as JSON and sets content-type when missing.
  */
-export declare function writeSchmockResponse(res: ServerResponse, response: Schmock.Response, extraHeaders?: Record<string, string>): void;
+export declare function writeSchmockResponse(res: ResponseWritable, response: Schmock.Response, extraHeaders?: Record<string, string>): void;
+/**
+ * Write a rejection (e.g. 413) while the client may still be uploading.
+ *
+ * Ending the response immediately makes Node tear the socket down while
+ * request bytes are in flight; the resulting TCP reset discards the
+ * already-written error from the client's receive buffer, so the client
+ * observes ECONNRESET instead of the response. Instead the response body is
+ * flushed right away and the end is deferred — a lingering close — until the
+ * request finishes, goes idle, or exhausts the grace cap.
+ */
+export declare function writeRejectedSchmockResponse(req: RejectedRequestReadable, res: RejectedResponseWritable, response: Schmock.Response, extraHeaders?: Record<string, string>): void;
 export {};
 //# sourceMappingURL=http-helpers.d.ts.map

package/dist/http-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-helpers.d.ts","sourceRoot":"","sources":["../src/http-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;KAC1D,CAAC;CACH;AAED,UAAU,YAAY;IACpB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3D,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3D,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,kBAAkB,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM/D;AAKD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,WAAW,SAAwB,GAClC,OAAO,CAAC,OAAO,CAAC,CAqClB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,IAAI,CA2CN"}
+{"version":3,"file":"http-helpers.d.ts","sourceRoot":"","sources":["../src/http-helpers.ts"],"names":[],"mappings":"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"}