@foundatiofx/fetchclient 1.0.1 → 1.1.1

package/types/src/mocks/MockResponseBuilder.d.ts

@@ -0,0 +1,60 @@
+import type { MockDefinition } from "./types.js";
+/**
+ * Fluent builder for configuring mock responses.
+ * @template T The type of the registry (for chaining)
+ */
+export declare class MockResponseBuilder<T> {
+    #private;
+    constructor(mock: MockDefinition, registry: T);
+    /**
+     * Sets the response status, data, and optional headers.
+     * @param status - HTTP status code
+     * @param data - Response data (will be JSON stringified)
+     * @param headers - Optional response headers
+     * @returns The registry for chaining
+     */
+    reply(status: number, data?: unknown, headers?: Record<string, string>): T;
+    /**
+     * Sets a one-time response that is removed after the first match.
+     * @param status - HTTP status code
+     * @param data - Response data (will be JSON stringified)
+     * @param headers - Optional response headers
+     * @returns The registry for chaining
+     */
+    replyOnce(status: number, data?: unknown, headers?: Record<string, string>): T;
+    /**
+     * Simulates a network error by throwing a TypeError.
+     * @param message - Error message (default: "Network error")
+     * @returns The registry for chaining
+     */
+    networkError(message?: string): T;
+    /**
+     * Simulates a timeout by throwing a TimeoutError.
+     * @returns The registry for chaining
+     */
+    timeout(): T;
+    /**
+     * Passes the request through to the real fetch implementation.
+     * @returns The registry for chaining
+     */
+    passthrough(): T;
+    /**
+     * Adds header matching requirements for this mock.
+     * @param headers - Headers that must be present and match
+     * @returns This builder for further configuration
+     */
+    withHeaders(headers: Record<string, string>): this;
+    /**
+     * Adds body matching requirements for this mock.
+     * @param body - Exact body to match, or a predicate function
+     * @returns This builder for further configuration
+     */
+    withBody(body: unknown | ((body: unknown) => boolean)): this;
+    /**
+     * Adds a delay before returning the response.
+     * @param ms - Delay in milliseconds
+     * @returns This builder for further configuration
+     */
+    delay(ms: number): this;
+}
+//# sourceMappingURL=MockResponseBuilder.d.ts.map

package/types/src/mocks/MockResponseBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockResponseBuilder.d.ts","sourceRoot":"","sources":["../../../src/src/mocks/MockResponseBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,qBAAa,mBAAmB,CAAC,CAAC;;gBAIpB,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;IAK7C;;;;;;OAMG;IACH,KAAK,CACH,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,CAAC;IAOJ;;;;;;OAMG;IACH,SAAS,CACP,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,CAAC;IAKJ;;;;OAIG;IACH,YAAY,CAAC,OAAO,SAAkB,GAAG,CAAC;IAK1C;;;OAGG;IACH,OAAO,IAAI,CAAC;IAKZ;;;OAGG;IACH,WAAW,IAAI,CAAC;IAKhB;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAKlD;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,IAAI;IAK5D;;;;OAIG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAIxB"}

package/types/src/mocks/mod.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Mock utilities for testing FetchClient.
+ *
+ * @example
+ * ```typescript
+ * import { FetchClientProvider } from "@foundatiofx/fetchclient";
+ * import { MockRegistry } from "@foundatiofx/fetchclient/mocks";
+ *
+ * const mocks = new MockRegistry();
+ * mocks.onGet('/api/users').reply(200, [{ id: 1 }]);
+ *
+ * const provider = new FetchClientProvider();
+ * mocks.install(provider);
+ *
+ * const client = provider.getFetchClient();
+ * const response = await client.getJSON('/api/users');
+ *
+ * mocks.restore();
+ * ```
+ *
+ * @module
+ */
+export { MockRegistry } from "./MockRegistry.js";
+export { MockResponseBuilder } from "./MockResponseBuilder.js";
+export type { MockDefinition, MockHistory } from "./types.js";
+//# sourceMappingURL=mod.d.ts.map

package/types/src/mocks/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/mocks/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/types/src/mocks/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Definition of a mock response configuration.
+ */
+export interface MockDefinition {
+    /** HTTP method to match, or null for any method */
+    method: string | null;
+    /** URL pattern to match (string or RegExp) */
+    url: string | RegExp;
+    /** HTTP status code to return */
+    status: number;
+    /** Response data (will be JSON stringified) */
+    data?: unknown;
+    /** Response headers */
+    headers?: Record<string, string>;
+    /** If true, mock is removed after first match */
+    once: boolean;
+    /** If true, request passes through to real fetch */
+    passthrough: boolean;
+    /** If set, throws TypeError with this message */
+    networkError?: string;
+    /** If true, throws TimeoutError */
+    timeout: boolean;
+    /** Delay in milliseconds before returning response */
+    delay?: number;
+    /** Headers that must match for this mock to apply */
+    headerMatchers?: Record<string, string>;
+    /** Body matcher - exact match or predicate function */
+    bodyMatcher?: unknown | ((body: unknown) => boolean);
+}
+/**
+ * Recorded request history organized by HTTP method.
+ */
+export interface MockHistory {
+    /** GET requests */
+    readonly get: Request[];
+    /** POST requests */
+    readonly post: Request[];
+    /** PUT requests */
+    readonly put: Request[];
+    /** PATCH requests */
+    readonly patch: Request[];
+    /** DELETE requests */
+    readonly delete: Request[];
+    /** All requests in order */
+    readonly all: Request[];
+}
+//# sourceMappingURL=types.d.ts.map

package/types/src/mocks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/mocks/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iDAAiD;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,oDAAoD;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;IACxB,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IACzB,mBAAmB;IACnB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;IACxB,qBAAqB;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;CACzB"}

package/types/src/tests/Caching.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Caching.test.d.ts","sourceRoot":"","sources":["../../../src/src/tests/Caching.test.ts"],"names":[],"mappings":""}

package/types/src/tests/CircuitBreaker.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircuitBreaker.test.d.ts","sourceRoot":"","sources":["../../../src/src/tests/CircuitBreaker.test.ts"],"names":[],"mappings":""}

package/types/src/tests/ErrorHandling.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorHandling.test.d.ts","sourceRoot":"","sources":["../../../src/src/tests/ErrorHandling.test.ts"],"names":[],"mappings":""}

package/types/src/tests/HttpMethods.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpMethods.test.d.ts","sourceRoot":"","sources":["../../../src/src/tests/HttpMethods.test.ts"],"names":[],"mappings":""}

package/types/src/tests/Integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Integration.test.d.ts","sourceRoot":"","sources":["../../../src/src/tests/Integration.test.ts"],"names":[],"mappings":""}

package/types/src/tests/JsonParsing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonParsing.test.d.ts","sourceRoot":"","sources":["../../../src/src/tests/JsonParsing.test.ts"],"names":[],"mappings":""}

package/types/src/tests/Middleware.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Middleware.test.d.ts","sourceRoot":"","sources":["../../../src/src/tests/Middleware.test.ts"],"names":[],"mappings":""}

package/types/src/tests/MockRegistry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockRegistry.test.d.ts","sourceRoot":"","sources":["../../../src/src/tests/MockRegistry.test.ts"],"names":[],"mappings":""}

package/types/src/tests/Provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.test.d.ts","sourceRoot":"","sources":["../../../src/src/tests/Provider.test.ts"],"names":[],"mappings":""}

package/types/src/tests/RateLimit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimit.test.d.ts","sourceRoot":"","sources":["../../../src/src/tests/RateLimit.test.ts"],"names":[],"mappings":""}

package/types/src/tests/TimeoutAbort.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeoutAbort.test.d.ts","sourceRoot":"","sources":["../../../src/src/tests/TimeoutAbort.test.ts"],"names":[],"mappings":""}

package/types/src/tests/UrlBuilding.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrlBuilding.test.d.ts","sourceRoot":"","sources":["../../../src/src/tests/UrlBuilding.test.ts"],"names":[],"mappings":""}

package/types/deps/jsr.io/@std/assert/1.0.14/almost_equals.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"almost_equals.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/assert/1.0.14/almost_equals.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,QAmBb"}

package/types/deps/jsr.io/@std/assert/1.0.14/array_includes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"array_includes.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/assert/1.0.14/array_includes.ts"],"names":[],"mappings":"AAMA,0FAA0F;AAC1F,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,GAAG,CAAC,EAAE,MAAM,QAwBb"}

package/types/deps/jsr.io/@std/assert/1.0.14/assert.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/assert/1.0.14/assert.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAI5D"}

package/types/deps/jsr.io/@std/assert/1.0.14/equal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"equal.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/assert/1.0.14/equal.ts"],"names":[],"mappings":"AA2FA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAuGrD"}

package/types/deps/jsr.io/@std/internal/1.0.10/build_message.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build_message.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/internal/1.0.10/build_message.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ;AAClB;;;GAGG;AACH,UAAU,UAAQ,GACjB,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CASvB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CASrD;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAC7C,OAAO,GAAE,mBAAwB,GAChC,MAAM,EAAE,CAsBV"}

package/types/deps/jsr.io/@std/internal/1.0.10/diff_str.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"diff_str.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/internal/1.0.10/diff_str.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAY/C;AAKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,MAAM,EAAE,CAiBnE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,EACxB,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,GAC3B,UAAU,CAAC,MAAM,CAAC,EAAE,CAetB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,CAkDlE"}

package/types/deps/jsr.io/@std/internal/1.0.10/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/internal/1.0.10/types.ts"],"names":[],"mappings":"AAGA,kDAAkD;AAClD,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,4BAA4B;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,6BAA6B;IAC7B,KAAK,EAAE,CAAC,CAAC;IACT,+BAA+B;IAC/B,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;CAC3B"}

package/types/src/FetchClient.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FetchClient.test.d.ts","sourceRoot":"","sources":["../../src/src/FetchClient.test.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,CAAC,EAAmB,MAAM,KAAK,CAAC;AAMzC,eAAO,MAAM,UAAU;;;;;;iBAMrB,CAAC"}

package/types/src/RateLimit.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RateLimit.test.d.ts","sourceRoot":"","sources":["../../src/src/RateLimit.test.ts"],"names":[],"mappings":""}