@aztec-labs/foundation 6.0.0-nightly.20260829

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

@@ -0,0 +1,112 @@
+import { promisify } from 'node:util';
+import { gunzip as gunzipCb, gzip as gzipCb } from 'node:zlib';
+import { Agent } from 'undici';
+import { createLogger } from '../../log/pino-logger.js';
+import { NoRetryError } from '../../retry/index.js';
+import { jsonStringify } from '../convert.js';
+const gzip = promisify(gzipCb);
+const gunzip = promisify(gunzipCb);
+const log = createLogger('json-rpc:json_rpc_client:undici');
+/** Minimum request size in bytes to trigger compression. */ const COMPRESSION_THRESHOLD = 1024;
+export { Agent };
+/**
+ * Creates an Undici JSON-RPC transport.
+ * @param client - Dispatcher used to make requests.
+ * @param cookieJar - Optional application-owned cookie storage. Cookies are ignored when omitted.
+ * @returns A JSON-RPC fetch implementation.
+ */ export function makeUndiciFetch(client = new Agent(), cookieJar) {
+    return async (host, body, extraHeaders = {}, noRetry = false)=>{
+        log.trace(`JsonRpcClient.fetch: ${host}`, {
+            host,
+            body
+        });
+        const requestUrl = new URL(host);
+        requestUrl.hash = '';
+        let resp;
+        try {
+            const headers = new Headers();
+            for (const [name, value] of Object.entries(extraHeaders)){
+                headers.append(name, value);
+            }
+            const cookie = await cookieJar?.getCookieString(requestUrl.href);
+            if (cookie) {
+                headers.append('cookie', cookie);
+            }
+            const jsonBody = Buffer.from(jsonStringify(body));
+            const shouldCompress = jsonBody.length >= COMPRESSION_THRESHOLD;
+            headers.set('content-type', 'application/json');
+            if (shouldCompress) {
+                headers.set('content-encoding', 'gzip');
+            }
+            headers.set('accept-encoding', 'gzip');
+            const requestHeaders = [];
+            headers.forEach((value, name)=>requestHeaders.push(name, value));
+            resp = await client.request({
+                method: 'POST',
+                origin: requestUrl.origin,
+                path: `${requestUrl.pathname}${requestUrl.search}`,
+                body: shouldCompress ? await gzip(jsonBody) : jsonBody,
+                headers: requestHeaders
+            });
+        } catch (err) {
+            const errorMessage = `Error fetching from host ${host}: ${String(err)}`;
+            throw new Error(errorMessage);
+        }
+        let responseJson;
+        const responseOk = resp.statusCode >= 200 && resp.statusCode <= 299;
+        const contentEncoding = resp.headers['content-encoding'];
+        let responseText;
+        try {
+            if (contentEncoding === 'gzip') {
+                const jsonBuffer = await gunzip(await resp.body.arrayBuffer());
+                responseText = jsonBuffer.toString('utf-8');
+            } else {
+                responseText = await resp.body.text();
+            }
+        } catch (err) {
+            if (!responseOk) {
+                throw new Error('HTTP ' + resp.statusCode);
+            }
+            throw new Error(`Failed to read response body. encoding: ${contentEncoding}, error: ${String(err)}`);
+        }
+        if (cookieJar) {
+            const setCookieHeaders = resp.headers['set-cookie'];
+            const cookies = typeof setCookieHeaders === 'string' ? [
+                setCookieHeaders
+            ] : setCookieHeaders ?? [];
+            for (const cookie of cookies){
+                await cookieJar.setCookie(cookie, requestUrl.href);
+            }
+        }
+        try {
+            responseJson = JSON.parse(responseText);
+        } catch  {
+            if (!responseOk) {
+                throw new Error('HTTP ' + resp.statusCode);
+            }
+            throw new Error(`Failed to parse body as JSON. encoding: ${contentEncoding}, body: ${responseText}`);
+        }
+        if (!responseOk) {
+            const errorMessage = `Error ${resp.statusCode} response from server ${host}: ${responseJson}`;
+            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,20 @@
+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>): 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: unknown, 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=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udmVydC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2pzb24tcnBjL2NvbnZlcnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFFbEQ7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IsbUJBQW1CLENBQUMsQ0FBQyxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUUsTUFBTSxFQUFFLE1BQU0sQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBRXpFO0FBRUQ7Ozs7R0FJRztBQUNILHdCQUFnQixhQUFhLENBQUMsR0FBRyxFQUFFLE9BQU8sRUFBRSxRQUFRLENBQUMsRUFBRSxPQUFPLEdBQUcsTUFBTSxDQW9CdEU7QUFFRDs7O0dBR0c7QUFDSCx3QkFBZ0IsZ0JBQWdCLENBQUMsR0FBRyxFQUFFLEdBQUcsRUFBRSxRQUFRLENBQUMsRUFBRSxPQUFPLEdBQUcsTUFBTSxHQUFHLFNBQVMsQ0FNakYifQ==

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,CAAC,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAoBtE;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,40 @@
+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.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  {
+        return undefined;
+    }
+}

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

@@ -0,0 +1,4 @@
+export declare class BadRequestError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvanNvbi1ycGMvZXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLHFCQUFhLGVBQWdCLFNBQVEsS0FBSztJQUN4QyxZQUFZLE9BQU8sRUFBRSxNQUFNLEVBRzFCO0NBQ0YifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/json-rpc/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF"}

package/dest/json-rpc/errors.js

@@ -0,0 +1,6 @@
+export class BadRequestError extends Error {
+    constructor(message){
+        super(message);
+        this.name = 'BadRequestError';
+    }
+}

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

@@ -0,0 +1,13 @@
+/**
+ * Test class for testing string converter.
+ */
+export declare class ToStringClass {
+    /** A value */ readonly x: string;
+    /** Another value */ readonly y: string;
+    constructor(
+    /** A value */ x: string, 
+    /** Another value */ y: string);
+    toString(): string;
+    static fromString(value: string): ToStringClass;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3NfYS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2pzb24tcnBjL2ZpeHR1cmVzL2NsYXNzX2EudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUc7QUFDSCxxQkFBYSxhQUFhO0lBRXRCLGNBQWMsVUFBaUIsQ0FBQyxFQUFFLE1BQU07SUFDeEMsb0JBQW9CLFVBQWlCLENBQUMsRUFBRSxNQUFNO0lBRmhEO0lBQ0UsY0FBYyxDQUFpQixDQUFDLEVBQUUsTUFBTTtJQUN4QyxvQkFBb0IsQ0FBaUIsQ0FBQyxFQUFFLE1BQU0sRUFDNUM7SUFFSixRQUFRLElBQUksTUFBTSxDQUVqQjtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsS0FBSyxFQUFFLE1BQU0saUJBRzlCO0NBQ0YifQ==

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;IAEtB,cAAc,UAAiB,CAAC,EAAE,MAAM;IACxC,oBAAoB,UAAiB,CAAC,EAAE,MAAM;IAFhD;IACE,cAAc,CAAiB,CAAC,EAAE,MAAM;IACxC,oBAAoB,CAAiB,CAAC,EAAE,MAAM,EAC5C;IAEJ,QAAQ,IAAI,MAAM,CAEjB;IAED,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,iBAG9B;CACF"}

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,13 @@
+/**
+ * Test class for testing string converter.
+ */
+export declare class ToStringClass {
+    /** A value */ readonly x: string;
+    /** Another value */ readonly y: string;
+    constructor(
+    /** A value */ x: string, 
+    /** Another value */ y: string);
+    toString(): string;
+    static fromString(value: string): ToStringClass;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3NfYi5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2pzb24tcnBjL2ZpeHR1cmVzL2NsYXNzX2IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUc7QUFDSCxxQkFBYSxhQUFhO0lBRXRCLGNBQWMsVUFBaUIsQ0FBQyxFQUFFLE1BQU07SUFDeEMsb0JBQW9CLFVBQWlCLENBQUMsRUFBRSxNQUFNO0lBRmhEO0lBQ0UsY0FBYyxDQUFpQixDQUFDLEVBQUUsTUFBTTtJQUN4QyxvQkFBb0IsQ0FBaUIsQ0FBQyxFQUFFLE1BQU0sRUFDNUM7SUFFSixRQUFRLElBQUksTUFBTSxDQUVqQjtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsS0FBSyxFQUFFLE1BQU0saUJBRzlCO0NBQ0YifQ==

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;IAEtB,cAAc,UAAiB,CAAC,EAAE,MAAM;IACxC,oBAAoB,UAAiB,CAAC,EAAE,MAAM;IAFhD;IACE,cAAc,CAAiB,CAAC,EAAE,MAAM;IACxC,oBAAoB,CAAiB,CAAC,EAAE,MAAM,EAC5C;IAEJ,QAAQ,IAAI,MAAM,CAEjB;IAED,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,iBAG9B;CACF"}

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,85 @@
+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.ZodPipe<z.ZodObject<{
+        data: z.ZodString;
+    }, z.core.$strip>, z.ZodTransform<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=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVzdF9zdGF0ZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2pzb24tcnBjL2ZpeHR1cmVzL3Rlc3Rfc3RhdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEVBQUUsS0FBSyxZQUFZLEVBQXFCLE1BQU0sd0JBQXdCLENBQUM7QUFHOUU7O0dBRUc7QUFDSCxxQkFBYSxRQUFRO0lBQ1AsT0FBTyxDQUFDLElBQUk7SUFBeEIsWUFBb0IsSUFBSSxFQUFFLE1BQU0sRUFBSTtJQUVwQyxNQUFNLEtBQUssTUFBTTs7OztRQUVoQjtJQUVELE1BQU07O01BRUw7SUFFRDs7O09BR0c7SUFDSCxRQUFRLElBQUksTUFBTSxDQUVqQjtJQUNEOzs7O09BSUc7SUFDSCxNQUFNLENBQUMsVUFBVSxDQUFDLElBQUksRUFBRSxNQUFNLEdBQUcsUUFBUSxDQUV4QztDQUNGO0FBRUQsTUFBTSxXQUFXLFlBQVk7SUFDM0IsT0FBTyxFQUFFLENBQUMsS0FBSyxFQUFFLE1BQU0sS0FBSyxPQUFPLENBQUMsUUFBUSxHQUFHLFNBQVMsQ0FBQyxDQUFDO0lBQzFELFFBQVEsRUFBRSxDQUFDLEtBQUssQ0FBQyxFQUFFLE1BQU0sS0FBSyxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FBQztJQUNsRCxTQUFTLEVBQUUsQ0FBQyxLQUFLLEVBQUUsTUFBTSxHQUFHLFNBQVMsS0FBSyxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FBQztJQUM5RCxTQUFTLEVBQUUsQ0FBQyxLQUFLLENBQUMsRUFBRSxNQUFNLEtBQUssT0FBTyxDQUFDLFFBQVEsRUFBRSxDQUFDLENBQUM7SUFDbkQsS0FBSyxFQUFFLE1BQU0sT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQzNCLFFBQVEsRUFBRSxDQUFDLEtBQUssRUFBRSxRQUFRLEVBQUUsS0FBSyxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FBQztJQUNyRCxJQUFJLEVBQUUsTUFBTSxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDMUIsS0FBSyxFQUFFLE1BQU0sT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQzdCLFNBQVMsRUFBRSxNQUFNLE9BQU8sQ0FBQztRQUFFLE1BQU0sRUFBRSxNQUFNLENBQUM7UUFBQyxLQUFLLEVBQUUsTUFBTSxDQUFBO0tBQUUsQ0FBQyxDQUFDO0lBQzVELFFBQVEsSUFBSSxPQUFPLENBQUMsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLFNBQVMsRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUFDO0NBQzNEO0FBRUQ7Ozs7R0FJRztBQUNILHFCQUFhLFNBQVUsWUFBVyxZQUFZO0lBQ3pCLEtBQUssRUFBRSxRQUFRLEVBQUU7SUFBcEMsWUFBbUIsS0FBSyxFQUFFLFFBQVEsRUFBRSxFQUFJO0lBQ3hDOzs7Ozs7O09BT0c7SUFDRyxPQUFPLENBQUMsS0FBSyxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsUUFBUSxDQUFDLENBRzlDO0lBRUQsSUFBSSxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FFcEI7SUFFSyxLQUFLLElBQUksT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUc3QjtJQUVLLFFBQVEsQ0FBQyxLQUFLLENBQUMsRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLFFBQVEsRUFBRSxDQUFDLENBR2xEO0lBRUssU0FBUyxDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsU0FBUyxHQUFHLE9BQU8sQ0FBQyxRQUFRLEVBQUUsQ0FBQyxDQUc5RDtJQUVLLFNBQVMsQ0FBQyxLQUFLLFNBQUksR0FBRyxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FHOUM7SUFFSyxLQUFLLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQUczQjtJQUVEOzs7Ozs7OztPQVFHO0lBQ0csUUFBUSxDQUFDLEtBQUssRUFBRSxRQUFRLEVBQUUsR0FBRyxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FNckQ7SUFFSyxVQUFVLGtCQUdmO0lBRUssU0FBUyxJQUFJLE9BQU8sQ0FBQztRQUFFLE1BQU0sRUFBRSxNQUFNLENBQUM7UUFBQyxLQUFLLEVBQUUsTUFBTSxDQUFBO0tBQUUsQ0FBQyxDQUc1RDtJQUVLLFFBQVEsSUFBSSxPQUFPLENBQUMsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLFNBQVMsRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUc5RDtDQUNGO0FBRUQsZUFBTyxNQUFNLGVBQWUsRUFBRSxZQUFZLENBQUMsWUFBWSxDQVd0RCxDQUFDIn0=

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;IAAxB,YAAoB,IAAI,EAAE,MAAM,EAAI;IAEpC,MAAM,KAAK,MAAM;;;;QAEhB;IAED,MAAM;;MAEL;IAED;;;OAGG;IACH,QAAQ,IAAI,MAAM,CAEjB;IACD;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAExC;CACF;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;IAApC,YAAmB,KAAK,EAAE,QAAQ,EAAE,EAAI;IACxC;;;;;;;OAOG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAG9C;IAED,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpB;IAEK,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAG7B;IAEK,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAGlD;IAEK,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAG9D;IAEK,SAAS,CAAC,KAAK,SAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAG9C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAED;;;;;;;;OAQG;IACG,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAMrD;IAEK,UAAU,kBAGf;IAEK,SAAS,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAG5D;IAEK,QAAQ,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,CAAC,CAG9D;CACF;AAED,eAAO,MAAM,eAAe,EAAE,YAAY,CAAC,YAAY,CAWtD,CAAC"}

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

@@ -0,0 +1,171 @@
+import { z } from 'zod';
+import { optional, schemas } from '../../schemas/index.js';
+import { sleep } from '../../sleep/index.js';
+/**
+ * Contrived example for JSON RPC tests.
+ */ export class TestNote {
+    data;
+    constructor(data){
+        this.data = data;
+    }
+    static get schema() {
+        return z.object({
+            data: z.string()
+        }).transform(({ data })=>new TestNote(data));
+    }
+    toJSON() {
+        return {
+            data: this.data
+        };
+    }
+    /**
+   * Create a string representation of this class.
+   * @returns The string representation.
+   */ toString() {
+        return this.data;
+    }
+    /**
+   * Creates a string representation of this class.
+   * @param data - The data.
+   * @returns The string representation.
+   */ static fromString(data) {
+        return new TestNote(data);
+    }
+}
+/**
+ * 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 class TestState {
+    notes;
+    constructor(notes){
+        this.notes = notes;
+    }
+    /**
+   * 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.
+   */ async getNote(index) {
+        await sleep(0.1);
+        return this.notes[index];
+    }
+    fail() {
+        throw new Error('Test state failed');
+    }
+    async count() {
+        await sleep(0.1);
+        return this.notes.length;
+    }
+    async getNotes(limit) {
+        await sleep(0.1);
+        return limit ? this.notes.slice(0, limit) : this.notes;
+    }
+    async getNotes2(limit) {
+        await sleep(0.1);
+        return limit ? this.notes.slice(0, Number(limit)) : this.notes;
+    }
+    async getNotes3(limit = 1) {
+        await sleep(0.1);
+        return limit ? this.notes.slice(0, Number(limit)) : this.notes;
+    }
+    async clear() {
+        await sleep(0.1);
+        this.notes = [];
+    }
+    /**
+   * 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.
+   */ async addNotes(notes) {
+        for (const note of notes){
+            this.notes.push(note);
+        }
+        await sleep(notes.length);
+        return this.notes;
+    }
+    async forceClear() {
+        await sleep(0.1);
+        this.notes = [];
+    }
+    async getStatus() {
+        await sleep(0.1);
+        return {
+            status: 'ok',
+            count: BigInt(this.notes.length)
+        };
+    }
+    async getTuple() {
+        await sleep(0.1);
+        return [
+            'a',
+            undefined,
+            1
+        ];
+    }
+}
+export const TestStateSchema = {
+    getNote: z.function({
+        input: z.tuple([
+            z.number()
+        ]),
+        output: TestNote.schema.optional()
+    }),
+    getNotes: z.function({
+        input: z.tuple([
+            optional(schemas.Integer)
+        ]),
+        output: z.array(TestNote.schema)
+    }),
+    getNotes2: z.function({
+        input: z.tuple([
+            optional(schemas.BigInt)
+        ]),
+        output: z.array(TestNote.schema)
+    }),
+    getNotes3: z.function({
+        input: z.tuple([
+            optional(schemas.Integer)
+        ]),
+        output: z.array(TestNote.schema)
+    }),
+    clear: z.function({
+        input: z.tuple([]),
+        output: z.void()
+    }),
+    addNotes: z.function({
+        input: z.tuple([
+            z.array(TestNote.schema)
+        ]),
+        output: z.array(TestNote.schema)
+    }),
+    fail: z.function({
+        input: z.tuple([]),
+        output: z.void()
+    }),
+    count: z.function({
+        input: z.tuple([]),
+        output: z.number()
+    }),
+    getStatus: z.function({
+        input: z.tuple([]),
+        output: z.object({
+            status: z.string(),
+            count: schemas.BigInt
+        })
+    }),
+    getTuple: z.function({
+        input: z.tuple([]),
+        output: z.tuple([
+            z.string(),
+            optional(z.string()),
+            z.number()
+        ])
+    })
+};

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

@@ -0,0 +1,3 @@
+export { jsonStringify, jsonParseWithSchema, tryJsonStringify } from './convert.js';
+export { BadRequestError } from './errors.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9qc29uLXJwYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsYUFBYSxFQUFFLG1CQUFtQixFQUFFLGdCQUFnQixFQUFFLE1BQU0sY0FBYyxDQUFDO0FBQ3BGLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSxhQUFhLENBQUMifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/json-rpc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dest/json-rpc/index.js

@@ -0,0 +1,2 @@
+export { jsonStringify, jsonParseWithSchema, tryJsonStringify } from './convert.js';
+export { BadRequestError } from './errors.js';

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

@@ -0,0 +1,13 @@
+/**
+ * Does this own the property?
+ * @param obj - An object.
+ * @param method - A property name.
+ */
+export declare const hasOwnProperty: (obj: any, propertyName: string) => boolean;
+/**
+ * Helper function to assert a condition is truthy
+ * @param x - A boolean condition to assert.
+ * @param err - Error message to throw if x isn't met.
+ */
+export declare function assert(x: any, err: string): asserts x;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoianNfdXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9qc29uLXJwYy9qc191dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFHQTs7OztHQUlHO0FBQ0gsZUFBTyxNQUFNLGNBQWMsNkNBQzhCLENBQUM7QUFFMUQ7Ozs7R0FJRztBQUNILHdCQUFnQixNQUFNLENBQUMsQ0FBQyxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBSXJEIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"js_utils.d.ts","sourceRoot":"","sources":["../../src/json-rpc/js_utils.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,cAAc,6CAC8B,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAIrD"}

package/dest/json-rpc/js_utils.js

@@ -0,0 +1,16 @@
+// Make sure this property was not inherited
+// TODO(palla): Delete this file
+/**
+ * Does this own the property?
+ * @param obj - An object.
+ * @param method - A property name.
+ */ export const hasOwnProperty = (obj, propertyName)=>Object.prototype.hasOwnProperty.call(obj, propertyName);
+/**
+ * Helper function to assert a condition is truthy
+ * @param x - A boolean condition to assert.
+ * @param err - Error message to throw if x isn't met.
+ */ export function assert(x, err) {
+    if (!x) {
+        throw new Error(err);
+    }
+}

package/dest/json-rpc/server/api_key_auth.d.ts

@@ -0,0 +1,19 @@
+import type Koa from 'koa';
+/**
+ * Computes the SHA-256 hash of a string and returns it as a Buffer.
+ * @param input - The input string to hash.
+ * @returns The SHA-256 hash as a Buffer.
+ */
+export declare function sha256Hash(input: string): Buffer;
+/**
+ * Creates a Koa middleware that enforces API key authentication on all requests
+ * except the health check endpoint (GET /status).
+ *
+ * The API key can be provided via the `x-api-key` header or the `Authorization: Bearer <key>` header.
+ * Comparison is done by hashing the provided key with SHA-256 and comparing against the stored hash.
+ *
+ * @param apiKeyHash - The SHA-256 hash of the expected API key as a Buffer.
+ * @returns A Koa middleware that rejects requests without a valid API key.
+ */
+export declare function getApiKeyAuthMiddleware(apiKeyHash: Buffer): (ctx: Koa.Context, next: () => Promise<void>) => Promise<void>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBpX2tleV9hdXRoLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvanNvbi1ycGMvc2VydmVyL2FwaV9rZXlfYXV0aC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEtBQUssR0FBRyxNQUFNLEtBQUssQ0FBQztBQU8zQjs7OztHQUlHO0FBQ0gsd0JBQWdCLFVBQVUsQ0FBQyxLQUFLLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FFaEQ7QUFFRDs7Ozs7Ozs7O0dBU0c7QUFDSCx3QkFBZ0IsdUJBQXVCLENBQ3JDLFVBQVUsRUFBRSxNQUFNLEdBQ2pCLENBQUMsR0FBRyxFQUFFLEdBQUcsQ0FBQyxPQUFPLEVBQUUsSUFBSSxFQUFFLE1BQU0sT0FBTyxDQUFDLElBQUksQ0FBQyxLQUFLLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FpQ2hFIn0=

package/dest/json-rpc/server/api_key_auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_key_auth.d.ts","sourceRoot":"","sources":["../../../src/json-rpc/server/api_key_auth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAO3B;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,GACjB,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAiChE"}