@bigmi/core 0.7.1 → 0.8.0

package/dist/esm/transports/fallback.js

@@ -1,195 +1,163 @@
-import { RpcErrorCode } from '../errors/rpc.js';
-import { AllTransportsFailedError, TransportMethodNotSupportedError, } from '../errors/transport.js';
-import { InsufficientUTXOBalanceError } from '../errors/utxo.js';
-import { createTransport } from '../factories/createTransport.js';
-import { wait } from '../utils/wait.js';
-export function fallback(transports_, config = {}) {
-    const { key = 'fallback', name = 'Fallback', rank = false, shouldThrow: shouldThrow_ = shouldThrow, retryCount, retryDelay, } = config;
-    return (({ chain, pollingInterval = 4000, timeout, ...rest }) => {
-        let transports = transports_;
-        let onResponse = () => { };
-        const transport = createTransport({
-            key,
-            name,
-            async request({ method, params }) {
-                // Filter transports to only those that support the requested method
-                const supportedTransports = transports.reduce((supportedTransports, transport) => {
-                    const instance = transport({
-                        ...rest,
-                        chain,
-                        retryCount: 0,
-                        timeout,
-                    });
-                    const { include, exclude } = instance.config.methods || {};
-                    if (include) {
-                        if (include.includes(method)) {
-                            supportedTransports.push(instance);
-                        }
-                        return supportedTransports;
-                    }
-                    if (exclude) {
-                        if (!exclude.includes(method)) {
-                            supportedTransports.push(instance);
-                        }
-                        return supportedTransports;
-                    }
-                    supportedTransports.push(instance);
-                    return supportedTransports;
-                }, []);
-                if (!supportedTransports.length) {
-                    throw new TransportMethodNotSupportedError({ method });
-                }
-                const collectedErrors = [];
-                const fetch = async (i = 0) => {
-                    const transport = supportedTransports[i];
-                    try {
-                        const response = await transport.request({
-                            method,
-                            params,
-                        });
-                        onResponse({
-                            method,
-                            params: params,
-                            response,
-                            transport,
-                            status: 'success',
-                        });
-                        return response;
-                    }
-                    catch (err) {
-                        onResponse({
-                            error: err,
-                            method,
-                            params: params,
-                            transport,
-                            status: 'error',
-                        });
-                        if (shouldThrow_(err)) {
-                            throw err;
-                        }
-                        collectedErrors.push({
-                            transport: transport.config.name,
-                            error: err,
-                            attempt: i + 1,
-                        });
-                        // If we've reached the end of the fallbacks, throw all collected errors.
-                        if (i === supportedTransports.length - 1) {
-                            throw new AllTransportsFailedError({
-                                method,
-                                params,
-                                errors: collectedErrors,
-                                totalAttempts: i + 1,
-                            });
-                        }
-                        // Otherwise, try the next fallback.
-                        return fetch(i + 1);
-                    }
-                };
-                return fetch();
-            },
-            retryCount,
-            retryDelay,
-            type: 'fallback',
-        }, {
-            onResponse: (fn) => {
-                onResponse = fn;
-            },
-            transports: transports.map((fn) => fn({ chain, retryCount: 0 })),
-        });
-        if (rank) {
-            const rankOptions = (typeof rank === 'object' ? rank : {});
-            rankTransports({
-                chain,
-                interval: rankOptions.interval ?? pollingInterval,
-                onTransports: (transports_) => {
-                    transports = transports_;
-                },
-                ping: rankOptions.ping,
-                sampleCount: rankOptions.sampleCount,
-                timeout: rankOptions.timeout,
-                transports,
-                weights: rankOptions.weights,
-            });
-        }
-        return transport;
-    });
+import { wait } from "../utils/wait.js";
+import { RpcErrorCode } from "../errors/rpc.js";
+import { AllTransportsFailedError, TransportMethodNotSupportedError } from "../errors/transport.js";
+import { InsufficientUTXOBalanceError } from "../errors/utxo.js";
+import { createTransport } from "../factories/createTransport.js";
+//#region src/transports/fallback.ts
+function fallback(transports_, config = {}) {
+	const { key = "fallback", name = "Fallback", rank = false, shouldThrow: shouldThrow_ = shouldThrow, retryCount, retryDelay } = config;
+	return (({ chain, pollingInterval = 4e3, timeout, ...rest }) => {
+		let transports = transports_;
+		let onResponse = () => {};
+		const transport = createTransport({
+			key,
+			name,
+			async request({ method, params }) {
+				const supportedTransports = transports.reduce((supportedTransports, transport) => {
+					const instance = transport({
+						...rest,
+						chain,
+						retryCount: 0,
+						timeout
+					});
+					const { include, exclude } = instance.config.methods || {};
+					if (include) {
+						if (include.includes(method)) supportedTransports.push(instance);
+						return supportedTransports;
+					}
+					if (exclude) {
+						if (!exclude.includes(method)) supportedTransports.push(instance);
+						return supportedTransports;
+					}
+					supportedTransports.push(instance);
+					return supportedTransports;
+				}, []);
+				if (!supportedTransports.length) throw new TransportMethodNotSupportedError({ method });
+				const collectedErrors = [];
+				const fetch = async (i = 0) => {
+					const transport = supportedTransports[i];
+					try {
+						const response = await transport.request({
+							method,
+							params
+						});
+						onResponse({
+							method,
+							params,
+							response,
+							transport,
+							status: "success"
+						});
+						return response;
+					} catch (err) {
+						onResponse({
+							error: err,
+							method,
+							params,
+							transport,
+							status: "error"
+						});
+						if (shouldThrow_(err)) throw err;
+						collectedErrors.push({
+							transport: transport.config.name,
+							error: err,
+							attempt: i + 1
+						});
+						if (i === supportedTransports.length - 1) throw new AllTransportsFailedError({
+							method,
+							params,
+							errors: collectedErrors,
+							totalAttempts: i + 1
+						});
+						return fetch(i + 1);
+					}
+				};
+				return fetch();
+			},
+			retryCount,
+			retryDelay,
+			type: "fallback"
+		}, {
+			onResponse: (fn) => {
+				onResponse = fn;
+			},
+			transports: transports.map((fn) => fn({
+				chain,
+				retryCount: 0
+			}))
+		});
+		if (rank) {
+			const rankOptions = typeof rank === "object" ? rank : {};
+			rankTransports({
+				chain,
+				interval: rankOptions.interval ?? pollingInterval,
+				onTransports: (transports_) => {
+					transports = transports_;
+				},
+				ping: rankOptions.ping,
+				sampleCount: rankOptions.sampleCount,
+				timeout: rankOptions.timeout,
+				transports,
+				weights: rankOptions.weights
+			});
+		}
+		return transport;
+	});
 }
-export function shouldThrow(error) {
-    if (error instanceof InsufficientUTXOBalanceError) {
-        return true;
-    }
-    if ('code' in error && typeof error.code === 'number') {
-        if (error.code === RpcErrorCode.INTERNAL_ERROR ||
-            error.code === RpcErrorCode.USER_REJECTION ||
-            error.code === 5000 // CAIP UserRejectedRequestError
-        ) {
-            return true;
-        }
-    }
-    return false;
+function shouldThrow(error) {
+	if (error instanceof InsufficientUTXOBalanceError) return true;
+	if ("code" in error && typeof error.code === "number") {
+		if (error.code === RpcErrorCode.INTERNAL_ERROR || error.code === RpcErrorCode.USER_REJECTION || error.code === 5e3) return true;
+	}
+	return false;
 }
 /** @internal */
-export function rankTransports({ chain, interval = 4000, onTransports, ping, sampleCount = 10, timeout = 1000, transports, weights = {}, }) {
-    const { stability: stabilityWeight = 0.7, latency: latencyWeight = 0.3 } = weights;
-    const samples = [];
-    const rankTransports_ = async () => {
-        // 1. Take a sample from each Transport.
-        const sample = await Promise.all(transports.map(async (transport) => {
-            const transport_ = transport({ chain, retryCount: 0, timeout });
-            const start = Date.now();
-            let end;
-            let success;
-            try {
-                await (ping
-                    ? ping({ transport: transport_ })
-                    : transport_.request({
-                        method: 'net_listening',
-                        params: undefined,
-                    }));
-                success = 1;
-            }
-            catch {
-                success = 0;
-            }
-            finally {
-                end = Date.now();
-            }
-            const latency = end - start;
-            return { latency, success };
-        }));
-        // 2. Store the sample. If we have more than `sampleCount` samples, remove
-        // the oldest sample.
-        samples.push(sample);
-        if (samples.length > sampleCount) {
-            samples.shift();
-        }
-        // 3. Calculate the max latency from samples.
-        const maxLatency = Math.max(...samples.map((sample) => Math.max(...sample.map(({ latency }) => latency))));
-        // 4. Calculate the score for each Transport.
-        const scores = transports
-            .map((_, i) => {
-            const latencies = samples.map((sample) => sample[i].latency);
-            const meanLatency = latencies.reduce((acc, latency) => acc + latency, 0) /
-                latencies.length;
-            const latencyScore = 1 - meanLatency / maxLatency;
-            const successes = samples.map((sample) => sample[i].success);
-            const stabilityScore = successes.reduce((acc, success) => acc + success, 0) /
-                successes.length;
-            if (stabilityScore === 0) {
-                return [0, i];
-            }
-            return [
-                latencyWeight * latencyScore + stabilityWeight * stabilityScore,
-                i,
-            ];
-        })
-            .sort((a, b) => b[0] - a[0]);
-        // 5. Sort the Transports by score.
-        onTransports(scores.map(([, i]) => transports[i]));
-        // 6. Wait, and then rank again.
-        await wait(interval);
-        rankTransports_();
-    };
-    rankTransports_();
+function rankTransports({ chain, interval = 4e3, onTransports, ping, sampleCount = 10, timeout = 1e3, transports, weights = {} }) {
+	const { stability: stabilityWeight = .7, latency: latencyWeight = .3 } = weights;
+	const samples = [];
+	const rankTransports_ = async () => {
+		const sample = await Promise.all(transports.map(async (transport) => {
+			const transport_ = transport({
+				chain,
+				retryCount: 0,
+				timeout
+			});
+			const start = Date.now();
+			let end;
+			let success;
+			try {
+				await (ping ? ping({ transport: transport_ }) : transport_.request({
+					method: "net_listening",
+					params: void 0
+				}));
+				success = 1;
+			} catch {
+				success = 0;
+			} finally {
+				end = Date.now();
+			}
+			return {
+				latency: end - start,
+				success
+			};
+		}));
+		samples.push(sample);
+		if (samples.length > sampleCount) samples.shift();
+		const maxLatency = Math.max(...samples.map((sample) => Math.max(...sample.map(({ latency }) => latency))));
+		onTransports(transports.map((_, i) => {
+			const latencies = samples.map((sample) => sample[i].latency);
+			const latencyScore = 1 - latencies.reduce((acc, latency) => acc + latency, 0) / latencies.length / maxLatency;
+			const successes = samples.map((sample) => sample[i].success);
+			const stabilityScore = successes.reduce((acc, success) => acc + success, 0) / successes.length;
+			if (stabilityScore === 0) return [0, i];
+			return [latencyWeight * latencyScore + stabilityWeight * stabilityScore, i];
+		}).sort((a, b) => b[0] - a[0]).map(([, i]) => transports[i]));
+		await wait(interval);
+		rankTransports_();
+	};
+	rankTransports_();
 }
+//#endregion
+export { fallback, rankTransports, shouldThrow };
+
 //# sourceMappingURL=fallback.js.map

package/dist/esm/transports/fallback.js.map

@@ -1 +1 @@
-{"version":3,"file":"fallback.js","sourceRoot":"","sources":["../../../src/transports/fallback.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fallback.js","names":[],"sources":["../../../src/transports/fallback.ts"],"sourcesContent":["import { RpcErrorCode } from '../errors/rpc.js'\nimport {\n  AllTransportsFailedError,\n  TransportMethodNotSupportedError,\n} from '../errors/transport.js'\nimport type { ErrorType } from '../errors/utils.js'\nimport { InsufficientUTXOBalanceError } from '../errors/utxo.js'\nimport { createTransport } from '../factories/createTransport.js'\nimport type { Chain } from '../types/chain.js'\nimport type {\n  CreateTransportErrorType,\n  Transport,\n  TransportConfig,\n} from '../types/transport.js'\nimport { wait } from '../utils/wait.js'\n\n// TODO: Narrow `method` & `params` types.\nexport type OnResponseFn = (\n  args: {\n    method: string\n    params: unknown[]\n    transport: ReturnType<Transport>\n  } & (\n    | {\n        error?: undefined\n        response: unknown\n        status: 'success'\n      }\n    | {\n        error: Error\n        response?: undefined\n        status: 'error'\n      }\n  )\n) => void\n\ntype RankOptions = {\n  /**\n   * The polling interval (in ms) at which the ranker should ping the RPC URL.\n   * @default client.pollingInterval\n   */\n  interval?: number | undefined\n  /**\n   * Ping method to determine latency.\n   */\n  ping?: (parameters: {\n    transport: ReturnType<Transport>\n  }) => Promise<unknown> | undefined\n  /**\n   * The number of previous samples to perform ranking on.\n   * @default 10\n   */\n  sampleCount?: number | undefined\n  /**\n   * Timeout when sampling transports.\n   * @default 1_000\n   */\n  timeout?: number | undefined\n  /**\n   * Weights to apply to the scores. Weight values are proportional.\n   */\n  weights?:\n    | {\n        /**\n         * The weight to apply to the latency score.\n         * @default 0.3\n         */\n        latency?: number | undefined\n        /**\n         * The weight to apply to the stability score.\n         * @default 0.7\n         */\n        stability?: number | undefined\n      }\n    | undefined\n}\n\nexport type FallbackTransportConfig = {\n  /** The key of the Fallback transport. */\n  key?: TransportConfig['key'] | undefined\n  /** The name of the Fallback transport. */\n  name?: TransportConfig['name'] | undefined\n  /** Toggle to enable ranking, or rank options. */\n  rank?: boolean | RankOptions | undefined\n  /** The max number of times to retry. */\n  retryCount?: TransportConfig['retryCount'] | undefined\n  /** The base delay (in ms) between retries. */\n  retryDelay?: TransportConfig['retryDelay'] | undefined\n  /** Callback on whether an error should throw or try the next transport in the fallback. */\n  shouldThrow?: (error: Error) => boolean | undefined\n}\n\nexport type FallbackTransport<\n  transports extends readonly Transport[] = readonly Transport[],\n> = Transport<\n  'fallback',\n  {\n    onResponse: (fn: OnResponseFn) => void\n    transports: {\n      [key in keyof transports]: ReturnType<transports[key]>\n    }\n  }\n>\n\nexport type FallbackTransportErrorType = CreateTransportErrorType | ErrorType\n\nexport function fallback<const transports extends readonly Transport[]>(\n  transports_: transports,\n  config: FallbackTransportConfig = {}\n): FallbackTransport<transports> {\n  const {\n    key = 'fallback',\n    name = 'Fallback',\n    rank = false,\n    shouldThrow: shouldThrow_ = shouldThrow,\n    retryCount,\n    retryDelay,\n  } = config\n  return (({ chain, pollingInterval = 4_000, timeout, ...rest }) => {\n    let transports = transports_\n\n    let onResponse: OnResponseFn = () => {}\n\n    const transport = createTransport(\n      {\n        key,\n        name,\n        async request({ method, params }) {\n          // Filter transports to only those that support the requested method\n          const supportedTransports = transports.reduce<\n            ReturnType<Transport>[]\n          >((supportedTransports, transport) => {\n            const instance = transport({\n              ...rest,\n              chain,\n              retryCount: 0,\n              timeout,\n            })\n            const { include, exclude } = instance.config.methods || {}\n            if (include) {\n              if (include.includes(method)) {\n                supportedTransports.push(instance)\n              }\n              return supportedTransports\n            }\n            if (exclude) {\n              if (!exclude.includes(method)) {\n                supportedTransports.push(instance)\n              }\n              return supportedTransports\n            }\n            supportedTransports.push(instance)\n            return supportedTransports\n          }, [])\n\n          if (!supportedTransports.length) {\n            throw new TransportMethodNotSupportedError({ method })\n          }\n\n          const collectedErrors: Array<{\n            transport: string\n            error: Error\n            attempt: number\n          }> = []\n\n          const fetch = async (i = 0): Promise<any> => {\n            const transport = supportedTransports[i]\n            try {\n              const response = await transport.request({\n                method,\n                params,\n              })\n\n              onResponse({\n                method,\n                params: params as unknown[],\n                response,\n                transport,\n                status: 'success',\n              })\n\n              return response\n            } catch (err) {\n              onResponse({\n                error: err as Error,\n                method,\n                params: params as unknown[],\n                transport,\n                status: 'error',\n              })\n\n              if (shouldThrow_(err as Error)) {\n                throw err\n              }\n\n              collectedErrors.push({\n                transport: transport.config.name,\n                error: err as Error,\n                attempt: i + 1,\n              })\n\n              // If we've reached the end of the fallbacks, throw all collected errors.\n              if (i === supportedTransports.length - 1) {\n                throw new AllTransportsFailedError({\n                  method,\n                  params,\n                  errors: collectedErrors,\n                  totalAttempts: i + 1,\n                })\n              }\n\n              // Otherwise, try the next fallback.\n              return fetch(i + 1)\n            }\n          }\n          return fetch()\n        },\n        retryCount,\n        retryDelay,\n        type: 'fallback',\n      },\n      {\n        onResponse: (fn: OnResponseFn) => {\n          onResponse = fn\n        },\n        transports: transports.map((fn) => fn({ chain, retryCount: 0 })),\n      }\n    )\n\n    if (rank) {\n      const rankOptions = (typeof rank === 'object' ? rank : {}) as RankOptions\n      rankTransports({\n        chain,\n        interval: rankOptions.interval ?? pollingInterval,\n        onTransports: (transports_) => {\n          transports = transports_ as transports\n        },\n        ping: rankOptions.ping,\n        sampleCount: rankOptions.sampleCount,\n        timeout: rankOptions.timeout,\n        transports,\n        weights: rankOptions.weights,\n      })\n    }\n    return transport\n  }) as FallbackTransport<transports>\n}\n\nexport function shouldThrow(error: Error): boolean {\n  if (error instanceof InsufficientUTXOBalanceError) {\n    return true\n  }\n\n  if ('code' in error && typeof error.code === 'number') {\n    if (\n      error.code === RpcErrorCode.INTERNAL_ERROR ||\n      error.code === RpcErrorCode.USER_REJECTION ||\n      error.code === 5000 // CAIP UserRejectedRequestError\n    ) {\n      return true\n    }\n  }\n\n  return false\n}\n\n/** @internal */\nexport function rankTransports({\n  chain,\n  interval = 4_000,\n  onTransports,\n  ping,\n  sampleCount = 10,\n  timeout = 1_000,\n  transports,\n  weights = {},\n}: {\n  chain?: Chain | undefined\n  interval: RankOptions['interval']\n  onTransports: (transports: readonly Transport[]) => void\n  ping?: RankOptions['ping'] | undefined\n  sampleCount?: RankOptions['sampleCount'] | undefined\n  timeout?: RankOptions['timeout'] | undefined\n  transports: readonly Transport[]\n  weights?: RankOptions['weights'] | undefined\n}): void {\n  const { stability: stabilityWeight = 0.7, latency: latencyWeight = 0.3 } =\n    weights\n\n  type SampleData = { latency: number; success: number }\n  type Sample = SampleData[]\n  const samples: Sample[] = []\n\n  const rankTransports_ = async () => {\n    // 1. Take a sample from each Transport.\n    const sample: Sample = await Promise.all(\n      transports.map(async (transport) => {\n        const transport_ = transport({ chain, retryCount: 0, timeout })\n\n        const start = Date.now()\n        let end: number\n        let success: number\n        try {\n          await (ping\n            ? ping({ transport: transport_ })\n            : transport_.request({\n                method: 'net_listening',\n                params: undefined,\n              }))\n          success = 1\n        } catch {\n          success = 0\n        } finally {\n          end = Date.now()\n        }\n        const latency = end - start\n        return { latency, success }\n      })\n    )\n\n    // 2. Store the sample. If we have more than `sampleCount` samples, remove\n    // the oldest sample.\n    samples.push(sample)\n    if (samples.length > sampleCount) {\n      samples.shift()\n    }\n\n    // 3. Calculate the max latency from samples.\n    const maxLatency = Math.max(\n      ...samples.map((sample) =>\n        Math.max(...sample.map(({ latency }) => latency))\n      )\n    )\n\n    // 4. Calculate the score for each Transport.\n    const scores = transports\n      .map((_, i) => {\n        const latencies = samples.map((sample) => sample[i].latency)\n        const meanLatency =\n          latencies.reduce((acc, latency) => acc + latency, 0) /\n          latencies.length\n        const latencyScore = 1 - meanLatency / maxLatency\n\n        const successes = samples.map((sample) => sample[i].success)\n        const stabilityScore =\n          successes.reduce((acc, success) => acc + success, 0) /\n          successes.length\n\n        if (stabilityScore === 0) {\n          return [0, i]\n        }\n        return [\n          latencyWeight * latencyScore + stabilityWeight * stabilityScore,\n          i,\n        ]\n      })\n      .sort((a, b) => b[0] - a[0])\n\n    // 5. Sort the Transports by score.\n    onTransports(scores.map(([, i]) => transports[i]))\n\n    // 6. Wait, and then rank again.\n    await wait(interval)\n    rankTransports_()\n  }\n  rankTransports_()\n}\n"],"mappings":"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"}

package/dist/esm/transports/getHttpRpcClient.d.ts

@@ -1,38 +1,34 @@
-import type { RpcResponse } from '../types/rpc.js';
-import type { MaybePromise } from '../types/utils.js';
-export type RpcRequest = {
-    jsonrpc?: '2.0';
-    method: string;
-    params?: any;
-    id?: number;
+import { RpcResponse } from "../types/rpc.js";
+import { MaybePromise } from "../types/utils.js";
+
+//#region src/transports/getHttpRpcClient.d.ts
+type RpcRequest = {
+  jsonrpc?: "2.0";
+  method: string;
+  params?: any;
+  id?: number;
 };
-export type HttpRequestReturnType<body extends RpcRequest | RpcRequest[] = RpcRequest> = body extends RpcRequest[] ? RpcResponse[] : RpcResponse;
-export type HttpRpcClientOptions = {
-    /** Request configuration to pass to `fetch`. */
-    fetchOptions?: Omit<RequestInit, 'body'> | undefined;
-    /** A callback to handle the request. */
-    onRequest?: ((request: Request, init: RequestInit) => MaybePromise<void | undefined | (RequestInit & {
-        url?: string | undefined;
-    })>) | undefined;
-    /** A callback to handle the response. */
-    onResponse?: ((response: Response) => Promise<void> | void) | undefined;
-    /** The timeout (in ms) for the request. */
-    timeout?: number | undefined;
+type HttpRequestReturnType<body extends RpcRequest | RpcRequest[] = RpcRequest> = body extends RpcRequest[] ? RpcResponse[] : RpcResponse;
+type HttpRpcClientOptions = {
+  /** Request configuration to pass to `fetch`. */fetchOptions?: Omit<RequestInit, "body"> | undefined; /** A callback to handle the request. */
+  onRequest?: ((request: Request, init: RequestInit) => MaybePromise<void | undefined | (RequestInit & {
+    url?: string | undefined;
+  })>) | undefined; /** A callback to handle the response. */
+  onResponse?: ((response: Response) => Promise<void> | void) | undefined; /** The timeout (in ms) for the request. */
+  timeout?: number | undefined;
 };
-export type HttpRequestParameters<body extends RpcRequest | RpcRequest[] = RpcRequest> = {
-    url?: string;
-    /** The RPC request body. */
-    body?: body;
-    /** Request configuration to pass to `fetch`. */
-    fetchOptions?: HttpRpcClientOptions['fetchOptions'] | undefined;
-    /** A callback to handle the response. */
-    onRequest?: ((request: Request) => Promise<void> | void) | undefined;
-    /** A callback to handle the response. */
-    onResponse?: ((response: Response) => Promise<void> | void) | undefined;
-    /** The timeout (in ms) for the request. */
-    timeout?: HttpRpcClientOptions['timeout'] | undefined;
+type HttpRequestParameters<body extends RpcRequest | RpcRequest[] = RpcRequest> = {
+  url?: string; /** The RPC request body. */
+  body?: body; /** Request configuration to pass to `fetch`. */
+  fetchOptions?: HttpRpcClientOptions["fetchOptions"] | undefined; /** A callback to handle the response. */
+  onRequest?: ((request: Request) => Promise<void> | void) | undefined; /** A callback to handle the response. */
+  onResponse?: ((response: Response) => Promise<void> | void) | undefined; /** The timeout (in ms) for the request. */
+  timeout?: HttpRpcClientOptions["timeout"] | undefined;
 };
-export type HttpRpcClient = {
-    request<body extends RpcRequest | RpcRequest[]>(params: HttpRequestParameters<body>): Promise<HttpRequestReturnType<body>>;
+type HttpRpcClient = {
+  request<body extends RpcRequest | RpcRequest[]>(params: HttpRequestParameters<body>): Promise<HttpRequestReturnType<body>>;
 };
-export declare function getHttpRpcClient(url: string, options?: HttpRpcClientOptions): HttpRpcClient;
+declare function getHttpRpcClient(url: string, options?: HttpRpcClientOptions): HttpRpcClient;
+//#endregion
+export { HttpRequestParameters, HttpRequestReturnType, HttpRpcClient, HttpRpcClientOptions, RpcRequest, getHttpRpcClient };
+//# sourceMappingURL=getHttpRpcClient.d.ts.map

package/dist/esm/transports/getHttpRpcClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getHttpRpcClient.d.ts","names":[],"sources":["../../../src/transports/getHttpRpcClient.ts"],"mappings":";;;;KAOY,UAAA;EACV,OAAA;EACA,MAAA;EACA,MAAA;EACA,EAAA;AAAA;AAAA,KAGU,qBAAA,cACG,UAAA,GAAa,UAAA,KAAe,UAAA,IACvC,IAAA,SAAa,UAAA,KAAe,WAAA,KAAgB,WAAA;AAAA,KAEpC,oBAAA;kDAEV,YAAA,GAAe,IAAA,CAAK,WAAA;EAEpB,SAAA,KAEM,OAAA,EAAS,OAAA,EACT,IAAA,EAAM,WAAA,KACH,YAAA,qBACiB,WAAA;IAAgB,GAAA;EAAA;EAI1C,UAAA,KAAe,QAAA,EAAU,QAAA,KAAa,OAAA;EAEtC,OAAA;AAAA;AAAA,KAGU,qBAAA,cACG,UAAA,GAAa,UAAA,KAAe,UAAA;EAEzC,GAAA;EAEA,IAAA,GAAO,IAAA,EAzBuC;EA2B9C,YAAA,GAAe,oBAAA;EAEf,SAAA,KAAc,OAAA,EAAS,OAAA,KAAY,OAAA;EAEnC,UAAA,KAAe,QAAA,EAAU,QAAA,KAAa,OAAA;EAEtC,OAAA,GAAU,oBAAA;AAAA;AAAA,KAGA,aAAA;EACV,OAAA,cAAqB,UAAA,GAAa,UAAA,IAChC,MAAA,EAAQ,qBAAA,CAAsB,IAAA,IAC7B,OAAA,CAAQ,qBAAA,CAAsB,IAAA;AAAA;AAAA,iBAGnB,gBAAA,CACd,GAAA,UACA,OAAA,GAAS,oBAAA,GACR,aAAA"}