@aztec/foundation 0.0.0-test.0

package/dest/iterable/sort.js

@@ -0,0 +1,15 @@
+import { all } from './all.js';
+import { isAsyncIterable } from './isAsyncIt.js';
+function sort(source, sorter) {
+    if (isAsyncIterable(source)) {
+        return async function*() {
+            const arr = await all(source);
+            yield* arr.sort(sorter);
+        }();
+    }
+    return function*() {
+        const arr = all(source);
+        yield* arr.sort(sorter);
+    }();
+}
+export { sort };

package/dest/iterable/take.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Stop iteration after n items have been received.
+ * @param source - An iterable to take n items from.
+ * @param limit - The number of items to take from the iterable.
+ * @returns A generator, limited to n items.
+ */
+declare function take<T>(source: Iterable<T>, limit: number): Generator<T, void, undefined>;
+declare function take<T>(source: Iterable<T> | AsyncIterable<T>, limit: number): AsyncGenerator<T, void, undefined>;
+export { take };
+//# sourceMappingURL=take.d.ts.map

package/dest/iterable/take.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"take.d.ts","sourceRoot":"","sources":["../../src/iterable/take.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,iBAAS,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AACpF,iBAAS,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AA4C5G,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dest/iterable/take.js

@@ -0,0 +1,32 @@
+import { isAsyncIterable } from './isAsyncIt.js';
+function take(source, limit) {
+    if (isAsyncIterable(source)) {
+        return async function*() {
+            let items = 0;
+            if (limit < 1) {
+                return;
+            }
+            for await (const entry of source){
+                yield entry;
+                items++;
+                if (items === limit) {
+                    return;
+                }
+            }
+        }();
+    }
+    return function*() {
+        let items = 0;
+        if (limit < 1) {
+            return;
+        }
+        for (const entry of source){
+            yield entry;
+            items++;
+            if (items === limit) {
+                return;
+            }
+        }
+    }();
+}
+export { take };

package/dest/iterable/toArray.d.ts

@@ -0,0 +1,2 @@
+export declare function toArray<T>(iterator: Iterable<T> | AsyncIterableIterator<T> | AsyncIterable<T> | IterableIterator<T>): Promise<T[]>;
+//# sourceMappingURL=toArray.d.ts.map

package/dest/iterable/toArray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toArray.d.ts","sourceRoot":"","sources":["../../src/iterable/toArray.ts"],"names":[],"mappings":"AAAA,wBAAsB,OAAO,CAAC,CAAC,EAC7B,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,GACxF,OAAO,CAAC,CAAC,EAAE,CAAC,CAMd"}

package/dest/iterable/toArray.js

@@ -0,0 +1,7 @@
+export async function toArray(iterator) {
+    const arr = [];
+    for await (const i of iterator){
+        arr.push(i);
+    }
+    return arr;
+}

package/dest/jest/setup.js

@@ -0,0 +1,7 @@
+import { overwriteLoggingStream, pinoPrettyOpts } from '@aztec/foundation/log';
+import pretty from 'pino-pretty';
+// Overwrite logging stream with pino-pretty. We define this as a separate
+// file so we don't mess up with dependencies in non-testing environments,
+// since pino-pretty messes up with browser bundles.
+// See also https://www.npmjs.com/package/pino-pretty?activeTab=readme#user-content-usage-with-jest
+overwriteLoggingStream(pretty(pinoPrettyOpts));

package/dest/json-rpc/client/fetch.d.ts

@@ -0,0 +1,32 @@
+import { type Logger } from '../../log/index.js';
+export type JsonRpcFetch = (host: string, rpcMethod: string, body: any, useApiEndpoints: boolean, extraHeaders?: Record<string, string>, noRetry?: boolean) => Promise<{
+    response: any;
+    headers: {
+        get: (header: string) => string | null | undefined;
+    };
+}>;
+/**
+ * A normal fetch function that does not retry.
+ * Alternatives are a fetch function with retries, or a mocked fetch.
+ * @param host - The host URL.
+ * @param method - The RPC method name.
+ * @param body - The RPC payload.
+ * @param noRetry - Whether to throw a `NoRetryError` in case the response is a 5xx error and the body contains an error
+ *                  message (see `retry` function for more details).
+ * @returns The parsed JSON response, or throws an error.
+ */
+export declare function defaultFetch(host: string, rpcMethod: string, body: any, useApiEndpoints: boolean, extraHeaders?: Record<string, string>, noRetry?: boolean): Promise<{
+    response: any;
+    headers: {
+        get: (header: string) => string | null | undefined;
+    };
+}>;
+/**
+ * Makes a fetch function that retries based on the given attempts.
+ * @param retries - Sequence of intervals (in seconds) to retry.
+ * @param noRetry - Whether to stop retries on server errors.
+ * @param log - Optional logger for logging attempts.
+ * @returns A fetch function.
+ */
+export declare function makeFetch(retries: number[], defaultNoRetry: boolean, log?: Logger): typeof defaultFetch;
+//# sourceMappingURL=fetch.d.ts.map

package/dest/json-rpc/client/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/json-rpc/client/fetch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,oBAAoB,CAAC;AAM/D,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,GAAG,EACT,eAAe,EAAE,OAAO,EACxB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACrC,OAAO,CAAC,EAAE,OAAO,KACd,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE;QAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;KAAE,CAAA;CAAE,CAAC,CAAC;AAEjG;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,GAAG,EACT,eAAe,EAAE,OAAO,EACxB,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACzC,OAAO,UAAQ,GACd,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE;QAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;KAAE,CAAA;CAAE,CAAC,CA0C7F;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,YAAY,CAiBvG"}

package/dest/json-rpc/client/fetch.js

@@ -0,0 +1,77 @@
+import { format, inspect } from 'util';
+import { createLogger } from '../../log/index.js';
+import { NoRetryError, makeBackoff, retry } from '../../retry/index.js';
+import { jsonStringify } from '../convert.js';
+const log = createLogger('json-rpc:json_rpc_client');
+/**
+ * A normal fetch function that does not retry.
+ * Alternatives are a fetch function with retries, or a mocked fetch.
+ * @param host - The host URL.
+ * @param method - The RPC method name.
+ * @param body - The RPC payload.
+ * @param noRetry - Whether to throw a `NoRetryError` in case the response is a 5xx error and the body contains an error
+ *                  message (see `retry` function for more details).
+ * @returns The parsed JSON response, or throws an error.
+ */ export async function defaultFetch(host, rpcMethod, body, useApiEndpoints, extraHeaders = {}, noRetry = false) {
+    log.debug(format(`JsonRpcClient.fetch`, host, rpcMethod, '->', body));
+    let resp;
+    try {
+        if (useApiEndpoints) {
+            resp = await fetch(`${host}/${rpcMethod}`, {
+                method: 'POST',
+                body: jsonStringify(body),
+                headers: {
+                    'content-type': 'application/json',
+                    ...extraHeaders
+                }
+            });
+        } else {
+            resp = await fetch(host, {
+                method: 'POST',
+                body: jsonStringify({
+                    ...body,
+                    method: rpcMethod
+                }),
+                headers: {
+                    'content-type': 'application/json',
+                    ...extraHeaders
+                }
+            });
+        }
+    } catch (err) {
+        const errorMessage = `Error fetching from host ${host} with method ${rpcMethod}: ${inspect(err)}`;
+        throw new Error(errorMessage);
+    }
+    let responseJson;
+    try {
+        responseJson = await resp.json();
+    } catch (err) {
+        if (!resp.ok) {
+            throw new Error(resp.statusText);
+        }
+        throw new Error(`Failed to parse body as JSON: ${resp.text()}`);
+    }
+    if (!resp.ok) {
+        const errorMessage = `Error ${resp.status} from server ${host} on ${rpcMethod}: ${responseJson.error.message}`;
+        if (noRetry || resp.status >= 400 && resp.status < 500) {
+            throw new NoRetryError(errorMessage);
+        } else {
+            throw new Error(errorMessage);
+        }
+    }
+    return {
+        response: responseJson,
+        headers: resp.headers
+    };
+}
+/**
+ * Makes a fetch function that retries based on the given attempts.
+ * @param retries - Sequence of intervals (in seconds) to retry.
+ * @param noRetry - Whether to stop retries on server errors.
+ * @param log - Optional logger for logging attempts.
+ * @returns A fetch function.
+ */ export function makeFetch(retries, defaultNoRetry, log) {
+    return async (host, rpcMethod, body, useApiEndpoints, extraHeaders = {}, noRetry)=>{
+        return await retry(()=>defaultFetch(host, rpcMethod, body, useApiEndpoints, extraHeaders, noRetry ?? defaultNoRetry), `JsonRpcClient request ${rpcMethod} to ${host}`, makeBackoff(retries), log, false);
+    };
+}

package/dest/json-rpc/client/index.d.ts

@@ -0,0 +1,3 @@
+export * from './safe_json_rpc_client.js';
+export * from './fetch.js';
+//# sourceMappingURL=index.d.ts.map

package/dest/json-rpc/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/json-rpc/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC"}

package/dest/json-rpc/client/index.js

@@ -0,0 +1,2 @@
+export * from './safe_json_rpc_client.js';
+export * from './fetch.js';

package/dest/json-rpc/client/safe_json_rpc_client.d.ts

@@ -0,0 +1,26 @@
+import { type Logger } from '../../log/pino-logger.js';
+import { type ApiSchemaFor } from '../../schemas/api.js';
+import { type JsonRpcFetch } from './fetch.js';
+export type SafeJsonRpcClientOptions = {
+    useApiEndpoints?: boolean;
+    namespaceMethods?: string | false;
+    fetch?: JsonRpcFetch;
+    log?: Logger;
+    onResponse?: (res: {
+        response: any;
+        headers: {
+            get: (header: string) => string | null | undefined;
+        };
+    }) => Promise<void>;
+};
+/**
+ * Creates a Proxy object that delegates over RPC and validates outputs against a given schema.
+ * The server is expected to be a JsonRpcServer.
+ * @param host - The host URL.
+ * @param schema - The api schema to validate returned data against.
+ * @param useApiEndpoints - Whether to use the API endpoints or the default RPC endpoint.
+ * @param namespaceMethods - String value (or false/empty) to namespace all methods sent to the server. e.g. 'getInfo' -\> 'pxe_getInfo'
+ * @param fetch - The fetch implementation to use.
+ */
+export declare function createSafeJsonRpcClient<T extends object>(host: string, schema: ApiSchemaFor<T>, config?: SafeJsonRpcClientOptions): T;
+//# sourceMappingURL=safe_json_rpc_client.d.ts.map

package/dest/json-rpc/client/safe_json_rpc_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe_json_rpc_client.d.ts","sourceRoot":"","sources":["../../../src/json-rpc/client/safe_json_rpc_client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAkB,KAAK,YAAY,EAAmB,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,YAAY,CAAC;AAE7D,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAClC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE;QACjB,QAAQ,EAAE,GAAG,CAAC;QACd,OAAO,EAAE;YAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;SAAE,CAAC;KACjE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EACtD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,MAAM,GAAE,wBAA6B,GACpC,CAAC,CAoCH"}

package/dest/json-rpc/client/safe_json_rpc_client.js

@@ -0,0 +1,57 @@
+import { format } from 'util';
+import { createLogger } from '../../log/pino-logger.js';
+import { schemaHasMethod } from '../../schemas/api.js';
+import { defaultFetch } from './fetch.js';
+/**
+ * Creates a Proxy object that delegates over RPC and validates outputs against a given schema.
+ * The server is expected to be a JsonRpcServer.
+ * @param host - The host URL.
+ * @param schema - The api schema to validate returned data against.
+ * @param useApiEndpoints - Whether to use the API endpoints or the default RPC endpoint.
+ * @param namespaceMethods - String value (or false/empty) to namespace all methods sent to the server. e.g. 'getInfo' -\> 'pxe_getInfo'
+ * @param fetch - The fetch implementation to use.
+ */ export function createSafeJsonRpcClient(host, schema, config = {}) {
+    const fetch = config.fetch ?? defaultFetch;
+    const log = config.log ?? createLogger('json-rpc:client');
+    const { useApiEndpoints = false, namespaceMethods = false } = config;
+    let id = 0;
+    const request = async (methodName, params)=>{
+        if (!schemaHasMethod(schema, methodName)) {
+            throw new Error(`Unspecified method ${methodName} in client schema`);
+        }
+        const method = namespaceMethods ? `${namespaceMethods}_${methodName}` : methodName;
+        const body = {
+            jsonrpc: '2.0',
+            id: id++,
+            method,
+            params
+        };
+        log.debug(format(`request`, method, params));
+        const { response, headers } = await fetch(host, method, body, useApiEndpoints);
+        log.debug(format(`result`, method, response));
+        if (config.onResponse) {
+            await config.onResponse({
+                response,
+                headers
+            });
+        }
+        if (response.error) {
+            throw response.error;
+        }
+        // TODO(palla/schemas): Find a better way to handle null responses (JSON.stringify(null) is string "null").
+        if ([
+            null,
+            undefined,
+            'null',
+            'undefined'
+        ].includes(response.result)) {
+            return;
+        }
+        return schema[methodName].returnType().parseAsync(response.result);
+    };
+    const proxy = {};
+    for (const method of Object.keys(schema)){
+        proxy[method] = (...params)=>request(method, params);
+    }
+    return proxy;
+}

package/dest/json-rpc/client/undici.d.ts

@@ -0,0 +1,5 @@
+import { Agent } from 'undici';
+import type { JsonRpcFetch } from './fetch.js';
+export { Agent };
+export declare function makeUndiciFetch(client?: Agent): JsonRpcFetch;
+//# sourceMappingURL=undici.d.ts.map

package/dest/json-rpc/client/undici.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undici.d.ts","sourceRoot":"","sources":["../../../src/json-rpc/client/undici.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAmB,MAAM,QAAQ,CAAC;AAKhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB,wBAAgB,eAAe,CAAC,MAAM,QAAc,GAAG,YAAY,CA+DlE"}

package/dest/json-rpc/client/undici.js

@@ -0,0 +1,63 @@
+import { Agent } from 'undici';
+import { createLogger } from '../../log/pino-logger.js';
+import { NoRetryError } from '../../retry/index.js';
+import { jsonStringify } from '../convert.js';
+const log = createLogger('json-rpc:json_rpc_client:undici');
+export { Agent };
+export function makeUndiciFetch(client = new Agent()) {
+    return async (host, rpcMethod, body, useApiEndpoints, extraHeaders = {}, noRetry = false)=>{
+        log.trace(`JsonRpcClient.fetch: ${host} ${rpcMethod}`, {
+            host,
+            rpcMethod,
+            body
+        });
+        let resp;
+        try {
+            resp = await client.request({
+                method: 'POST',
+                origin: new URL(host),
+                path: useApiEndpoints ? rpcMethod : '/',
+                body: jsonStringify(body),
+                headers: {
+                    ...extraHeaders,
+                    'content-type': 'application/json'
+                }
+            });
+        } catch (err) {
+            const errorMessage = `Error fetching from host ${host} with method ${rpcMethod}: ${String(err)}`;
+            throw new Error(errorMessage);
+        }
+        let responseJson;
+        const responseOk = resp.statusCode >= 200 && resp.statusCode <= 299;
+        try {
+            responseJson = await resp.body.json();
+        } catch (err) {
+            if (!responseOk) {
+                throw new Error('HTTP ' + resp.statusCode);
+            }
+            throw new Error(`Failed to parse body as JSON: ${await resp.body.text()}`);
+        }
+        if (!responseOk) {
+            const errorMessage = `Error ${resp.statusCode} response from server ${host} on ${rpcMethod}: ${responseJson.error.message}`;
+            if (noRetry || resp.statusCode >= 400 && resp.statusCode < 500) {
+                throw new NoRetryError(errorMessage);
+            } else {
+                throw new Error(errorMessage);
+            }
+        }
+        const headers = new Headers();
+        for (const [key, value] of Object.entries(resp.headers)){
+            if (typeof value === 'string') {
+                headers.append(key, value);
+            } else if (Array.isArray(value)) {
+                for (const v of value){
+                    headers.append(key, v);
+                }
+            }
+        }
+        return {
+            response: responseJson,
+            headers
+        };
+    };
+}

package/dest/json-rpc/convert.d.ts

@@ -0,0 +1,27 @@
+import type { ZodFor } from '../schemas/types.js';
+/**
+ * Parses a json string and then feeds it to a zod schema.
+ * @param json - JSON string.
+ * @param schema - Zod schema.
+ * @returns Result of parsing json with schema.
+ */
+export declare function jsonParseWithSchema<T>(json: string, schema: ZodFor<T>): Promise<T>;
+/**
+ * Parses a json string and then feeds it to a zod schema.
+ * @param json - JSON string.
+ * @param schema - Zod schema.
+ * @returns Result of parsing json with schema.
+ */
+export declare function jsonParseWithSchemaSync<T>(json: string, schema: ZodFor<T>): T;
+/**
+ * JSON.stringify helper that stringifies bigints, buffers, maps, and sets.
+ * @param obj - The object to be stringified.
+ * @returns The resulting string.
+ */
+export declare function jsonStringify(obj: object, prettify?: boolean): string;
+/**
+ * Calls jsonStringify but swallows errors.
+ * Use for logging, when you don't want to potentially introduce another thing that throws.
+ */
+export declare function tryJsonStringify(obj: any, prettify?: boolean): string | undefined;
+//# sourceMappingURL=convert.d.ts.map

package/dest/json-rpc/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/json-rpc/convert.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAElF;AACD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAoBrE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMjF"}

package/dest/json-rpc/convert.js

@@ -0,0 +1,48 @@
+import { Buffer } from 'buffer';
+/**
+ * Parses a json string and then feeds it to a zod schema.
+ * @param json - JSON string.
+ * @param schema - Zod schema.
+ * @returns Result of parsing json with schema.
+ */ export function jsonParseWithSchema(json, schema) {
+    return schema.parseAsync(JSON.parse(json));
+}
+/**
+ * Parses a json string and then feeds it to a zod schema.
+ * @param json - JSON string.
+ * @param schema - Zod schema.
+ * @returns Result of parsing json with schema.
+ */ export function jsonParseWithSchemaSync(json, schema) {
+    return schema.parse(JSON.parse(json));
+}
+/**
+ * JSON.stringify helper that stringifies bigints, buffers, maps, and sets.
+ * @param obj - The object to be stringified.
+ * @returns The resulting string.
+ */ export function jsonStringify(obj, prettify) {
+    return JSON.stringify(obj, (_key, value)=>{
+        if (typeof value === 'bigint') {
+            return value.toString();
+        } else if (typeof value === 'object' && value && value.type === 'Buffer' && Array.isArray(value.data)) {
+            return Buffer.from(value.data).toString('base64');
+        } else if (typeof value === 'object' && value && Buffer.isBuffer(value)) {
+            return value.toString('base64');
+        } else if (typeof value === 'object' && value instanceof Map) {
+            return Array.from(value.entries());
+        } else if (typeof value === 'object' && value instanceof Set) {
+            return Array.from(value.values());
+        } else {
+            return value;
+        }
+    }, prettify ? 2 : 0);
+}
+/**
+ * Calls jsonStringify but swallows errors.
+ * Use for logging, when you don't want to potentially introduce another thing that throws.
+ */ export function tryJsonStringify(obj, prettify) {
+    try {
+        return jsonStringify(obj, prettify);
+    } catch (e) {
+        return undefined;
+    }
+}

package/dest/json-rpc/fixtures/class_a.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Test class for testing string converter.
+ */
+export declare class ToStringClass {
+    readonly x: string;
+    readonly y: string;
+    constructor(/** A value */ x: string, /** Another value */ y: string);
+    toString(): string;
+    static fromString(value: string): ToStringClass;
+}
+//# sourceMappingURL=class_a.d.ts.map

package/dest/json-rpc/fixtures/class_a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class_a.d.ts","sourceRoot":"","sources":["../../../src/json-rpc/fixtures/class_a.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAa;aACmB,CAAC,EAAE,MAAM;aAAuC,CAAC,EAAE,MAAM;gBAAxF,cAAc,CAAiB,CAAC,EAAE,MAAM,EAAE,oBAAoB,CAAiB,CAAC,EAAE,MAAM;IAEpG,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM;CAIhC"}

package/dest/json-rpc/fixtures/class_a.js

@@ -0,0 +1,20 @@
+/**
+ * Test class for testing string converter.
+ */ export class ToStringClass {
+    x;
+    y;
+    constructor(/** A value */ x, /** Another value */ y){
+        this.x = x;
+        this.y = y;
+    }
+    toString() {
+        return [
+            this.x,
+            this.y
+        ].join('-');
+    }
+    static fromString(value) {
+        const [x, y] = value.split('-');
+        return new ToStringClass(x, y);
+    }
+}

package/dest/json-rpc/fixtures/class_b.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Test class for testing string converter.
+ */
+export declare class ToStringClass {
+    readonly x: string;
+    readonly y: string;
+    constructor(/** A value */ x: string, /** Another value */ y: string);
+    toString(): string;
+    static fromString(value: string): ToStringClass;
+}
+//# sourceMappingURL=class_b.d.ts.map

package/dest/json-rpc/fixtures/class_b.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class_b.d.ts","sourceRoot":"","sources":["../../../src/json-rpc/fixtures/class_b.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAa;aACmB,CAAC,EAAE,MAAM;aAAuC,CAAC,EAAE,MAAM;gBAAxF,cAAc,CAAiB,CAAC,EAAE,MAAM,EAAE,oBAAoB,CAAiB,CAAC,EAAE,MAAM;IAEpG,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM;CAIhC"}

package/dest/json-rpc/fixtures/class_b.js

@@ -0,0 +1,20 @@
+/**
+ * Test class for testing string converter.
+ */ export class ToStringClass {
+    x;
+    y;
+    constructor(/** A value */ x, /** Another value */ y){
+        this.x = x;
+        this.y = y;
+    }
+    toString() {
+        return [
+            this.x,
+            this.y
+        ].join('-');
+    }
+    static fromString(value) {
+        const [x, y] = value.split('-');
+        return new ToStringClass(x, y);
+    }
+}

package/dest/json-rpc/fixtures/test_state.d.ts

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { type ApiSchemaFor } from '../../schemas/index.js';
+/**
+ * Contrived example for JSON RPC tests.
+ */
+export declare class TestNote {
+    private data;
+    constructor(data: string);
+    static get schema(): z.ZodEffects<z.ZodObject<{
+        data: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        data: string;
+    }, {
+        data: string;
+    }>, TestNote, {
+        data: string;
+    }>;
+    toJSON(): {
+        data: string;
+    };
+    /**
+     * Create a string representation of this class.
+     * @returns The string representation.
+     */
+    toString(): string;
+    /**
+     * Creates a string representation of this class.
+     * @param data - The data.
+     * @returns The string representation.
+     */
+    static fromString(data: string): TestNote;
+}
+export interface TestStateApi {
+    getNote: (index: number) => Promise<TestNote | undefined>;
+    getNotes: (limit?: number) => Promise<TestNote[]>;
+    getNotes2: (limit: bigint | undefined) => Promise<TestNote[]>;
+    getNotes3: (limit?: number) => Promise<TestNote[]>;
+    clear: () => Promise<void>;
+    addNotes: (notes: TestNote[]) => Promise<TestNote[]>;
+    fail: () => Promise<void>;
+    count: () => Promise<number>;
+    getStatus: () => Promise<{
+        status: string;
+        count: bigint;
+    }>;
+    getTuple(): Promise<[string, string | undefined, number]>;
+}
+/**
+ * Represents a simple state management for TestNote instances.
+ * Provides functionality to get a note by index and add notes asynchronously.
+ * Primarily used for testing JSON RPC-related functionalities.
+ */
+export declare class TestState implements TestStateApi {
+    notes: TestNote[];
+    constructor(notes: TestNote[]);
+    /**
+     * Retrieve the TestNote instance at the specified index from the notes array.
+     * This method allows getting a desired TestNote from the collection of notes
+     * maintained by the TestState instance using the provided index value.
+     *
+     * @param index - The index of the TestNote to be retrieved from the notes array.
+     * @returns The TestNote instance corresponding to the given index.
+     */
+    getNote(index: number): Promise<TestNote>;
+    fail(): Promise<void>;
+    count(): Promise<number>;
+    getNotes(limit?: number): Promise<TestNote[]>;
+    getNotes2(limit: bigint | undefined): Promise<TestNote[]>;
+    getNotes3(limit?: number): Promise<TestNote[]>;
+    clear(): Promise<void>;
+    /**
+     * Add an array of TestNote instances to the current TestState's notes.
+     * This function simulates asynchronous behavior by waiting for a duration
+     * equal to the number of notes being added. It then returns the updated
+     * list of TestNote instances in the TestState.
+     *
+     * @param notes - An array of TestNote instances to be added.
+     * @returns A Promise that resolves to an array of TestNote instances, including the newly added notes.
+     */
+    addNotes(notes: TestNote[]): Promise<TestNote[]>;
+    forceClear(): Promise<void>;
+    getStatus(): Promise<{
+        status: string;
+        count: bigint;
+    }>;
+    getTuple(): Promise<[string, string | undefined, number]>;
+}
+export declare const TestStateSchema: ApiSchemaFor<TestStateApi>;
+//# sourceMappingURL=test_state.d.ts.map

package/dest/json-rpc/fixtures/test_state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_state.d.ts","sourceRoot":"","sources":["../../../src/json-rpc/fixtures/test_state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,wBAAwB,CAAC;AAG9E;;GAEG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEhC,MAAM,KAAK,MAAM;;;;;;;;OAEhB;IAED,MAAM;;;IAIN;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAGlB;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;CAG1C;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IAC1D,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClD,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrD,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,QAAQ,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3D;AAED;;;;GAIG;AACH,qBAAa,SAAU,YAAW,YAAY;IACzB,KAAK,EAAE,QAAQ,EAAE;gBAAjB,KAAK,EAAE,QAAQ,EAAE;IACpC;;;;;;;OAOG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAK/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIf,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAKxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK7C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKzD,SAAS,CAAC,KAAK,SAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;;;;;;OAQG;IACG,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAQhD,UAAU;IAKV,SAAS,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAKvD,QAAQ,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,CAAC;CAIhE;AAED,eAAO,MAAM,eAAe,EAAE,YAAY,CAAC,YAAY,CAWtD,CAAC"}