@aztec/foundation 0.0.0-test.0 → 0.0.1-commit.001888fc

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

@@ -1,20 +1,141 @@
 import { format } from 'util';
 import { createLogger } from '../../log/pino-logger.js';
+import { promiseWithResolvers } from '../../promise/utils.js';
 import { schemaHasMethod } from '../../schemas/api.js';
+import { jsonStringify } from '../convert.js';
 import { defaultFetch } from './fetch.js';
+// batch window of 0 would capture all requests in the current sync iteration of the event loop
+// and send them all at once in a single batch
+// minimal latency
+const DEFAULT_BATCH_WINDOW_MS = 0;
+// the maximum size of a batched request
+const DEFAULT_MAX_BATCH_SIZE = 100;
+// 10 mb
+const DEFAULT_MAX_REQUESTY_BODY_SIZE = 10 * 1024 * 1024;
+// expose helpful information on the RPC clients such that we can recognize them later
+const SEND_BATCH = Symbol('JsonRpcClient.sendBatch');
+const CLIENT_ID = Symbol('JsonRpcClient.clientId');
+let nextClientId = 1;
+// keep a reference to clients so that we can force send a batch
+const clients = new Map();
 /**
  * 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;
+    const { namespaceMethods = false, batchWindowMS = DEFAULT_BATCH_WINDOW_MS, maxBatchSize = DEFAULT_MAX_BATCH_SIZE, maxRequestBodySize = DEFAULT_MAX_REQUESTY_BODY_SIZE } = config;
     let id = 0;
+    let sendBatchTimeoutHandle;
+    const queue = [];
+    const sendBatch = async ()=>{
+        if (sendBatchTimeoutHandle !== undefined) {
+            clearTimeout(sendBatchTimeoutHandle);
+            sendBatchTimeoutHandle = undefined;
+        }
+        const rpcCalls = [];
+        let bodySize = 0;
+        while(queue.length > 0 && rpcCalls.length < maxBatchSize && bodySize < maxRequestBodySize){
+            const item = queue[0];
+            if (!item) {
+                break;
+            }
+            const tmpBodySize = bodySize + item.encodedLength;
+            if (tmpBodySize >= maxRequestBodySize) {
+                break;
+            }
+            bodySize = tmpBodySize;
+            queue.shift();
+            rpcCalls.push(item);
+        }
+        // no-op
+        if (rpcCalls.length === 0) {
+            return;
+        }
+        // schedule another call if there are more items to send
+        if (queue.length > 0) {
+            // eslint-disable-next-line @typescript-eslint/no-misused-promises
+            sendBatchTimeoutHandle = setTimeout(sendBatch, batchWindowMS);
+        }
+        log.debug(`Executing JSON-RPC batch of size: ${rpcCalls.length} body size: ${bodySize} bytes`, {
+            methods: rpcCalls.map(({ request })=>request.method)
+        });
+        try {
+            const { response, headers } = await fetch(host, rpcCalls.map(({ request })=>request), config.extraHeaders);
+            if (config.onResponse) {
+                await config.onResponse({
+                    response,
+                    headers
+                });
+            }
+            if (!Array.isArray(response) || response.length !== rpcCalls.length) {
+                log.warn(`Invalid response received from JSON-RPC server. Expected array of responses of length ${rpcCalls.length}`, {
+                    response
+                });
+                for(let i = 0; i < rpcCalls.length; i++){
+                    const { request, deferred } = rpcCalls[i];
+                    deferred.resolve({
+                        id: request.id,
+                        jsonrpc: '2.0',
+                        error: {
+                            code: -32000,
+                            data: response,
+                            message: response.message ?? 'Failed request'
+                        }
+                    });
+                }
+            } else {
+                for(let i = 0; i < response.length; i++){
+                    const resp = response[i];
+                    const { request, deferred } = rpcCalls[i];
+                    if (resp.id !== request.id) {
+                        log.warn(`Invalid response received at index ${i} from JSON-RPC server: id mismatch`, {
+                            requestMethod: request.method,
+                            requestId: request.id,
+                            responseId: resp.id
+                        });
+                        deferred.resolve({
+                            id: request.id,
+                            jsonrpc: '2.0',
+                            error: {
+                                code: -32001,
+                                data: resp,
+                                message: 'RPC id mismatch'
+                            }
+                        });
+                    } else {
+                        deferred.resolve(resp);
+                    }
+                }
+            }
+        } catch (err) {
+            // Re-throw ComponentsVersionsError immediately without converting to JSON-RPC error
+            // This ensures version mismatch errors are surfaced to the user instead of being hidden
+            if (err && typeof err === 'object' && 'name' in err && err.name === 'ComponentsVersionsError') {
+                // Reject all pending requests with the version error
+                for(let i = 0; i < rpcCalls.length; i++){
+                    rpcCalls[i].deferred.reject(err);
+                }
+                return; // Return early, the promises are already rejected
+            }
+            log.warn(`Failed to fetch from the remote server`, err);
+            for(let i = 0; i < rpcCalls.length; i++){
+                const { request, deferred } = rpcCalls[i];
+                deferred.resolve({
+                    id: request.id,
+                    jsonrpc: '2.0',
+                    error: {
+                        code: -32000,
+                        data: err,
+                        message: err.message ?? 'Failed request'
+                    }
+                });
+            }
+        }
+    };
     const request = async (methodName, params)=>{
         if (!schemaHasMethod(schema, methodName)) {
             throw new Error(`Unspecified method ${methodName} in client schema`);
@@ -26,18 +147,28 @@ import { defaultFetch } from './fetch.js';
             method,
             params
         };
+        const deferred = promiseWithResolvers();
+        const encodedLength = jsonStringify(body).length;
+        if (encodedLength >= maxRequestBodySize) {
+            throw new Error(`Request body too large: ${encodedLength}`);
+        }
+        queue.push({
+            request: body,
+            deferred,
+            encodedLength
+        });
+        if (sendBatchTimeoutHandle === undefined) {
+            // eslint-disable-next-line @typescript-eslint/no-misused-promises
+            sendBatchTimeoutHandle = setTimeout(sendBatch, batchWindowMS);
+        }
         log.debug(format(`request`, method, params));
-        const { response, headers } = await fetch(host, method, body, useApiEndpoints);
+        const response = await deferred.promise;
         log.debug(format(`result`, method, response));
-        if (config.onResponse) {
-            await config.onResponse({
-                response,
-                headers
+        if ('error' in response) {
+            throw new Error(response.error.message, {
+                cause: response.error
             });
         }
-        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,
@@ -49,9 +180,38 @@ import { defaultFetch } from './fetch.js';
         }
         return schema[methodName].returnType().parseAsync(response.result);
     };
-    const proxy = {};
+    const clientId = nextClientId++;
+    const proxy = {
+        [CLIENT_ID]: clientId,
+        [SEND_BATCH]: sendBatch
+    };
     for (const method of Object.keys(schema)){
-        proxy[method] = (...params)=>request(method, params);
+        // attach the clientId to the promise so that if we want to trigger a batch immediately, we can do that
+        proxy[method] = (...params)=>Object.assign(request(method, params), {
+                [CLIENT_ID]: clientId
+            });
     }
+    clients.set(clientId, new WeakRef(proxy));
     return proxy;
 }
+/**
+ * Triggers a batch to be sent immediately
+ */ export async function batch(values) {
+    const clientIdsSeen = new Set();
+    await Promise.allSettled(values.map((val)=>{
+        if (typeof val === 'object' && val && Object.hasOwn(val, CLIENT_ID)) {
+            const clientId = val[CLIENT_ID];
+            if (typeof clientId === 'number') {
+                if (clientIdsSeen.has(clientId)) {
+                    return;
+                }
+                clientIdsSeen.add(clientId);
+                const client = clients.get(clientId)?.deref();
+                if (client) {
+                    return client[SEND_BATCH]();
+                }
+            }
+        }
+    }));
+    return Promise.all(values);
+}

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

@@ -2,4 +2,4 @@ import { Agent } from 'undici';
 import type { JsonRpcFetch } from './fetch.js';
 export { Agent };
 export declare function makeUndiciFetch(client?: Agent): JsonRpcFetch;
-//# sourceMappingURL=undici.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidW5kaWNpLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvanNvbi1ycGMvY2xpZW50L3VuZGljaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFFQSxPQUFPLEVBQUUsS0FBSyxFQUFtQixNQUFNLFFBQVEsQ0FBQztBQUtoRCxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFVL0MsT0FBTyxFQUFFLEtBQUssRUFBRSxDQUFDO0FBRWpCLHdCQUFnQixlQUFlLENBQUMsTUFBTSxRQUFjLEdBQUcsWUFBWSxDQWtFbEUifQ==

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

@@ -1 +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"}
+{"version":3,"file":"undici.d.ts","sourceRoot":"","sources":["../../../src/json-rpc/client/undici.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAmB,MAAM,QAAQ,CAAC;AAKhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAU/C,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB,wBAAgB,eAAe,CAAC,MAAM,QAAc,GAAG,YAAY,CAkElE"}

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

@@ -1,44 +1,60 @@
+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 };
 export function makeUndiciFetch(client = new Agent()) {
-    return async (host, rpcMethod, body, useApiEndpoints, extraHeaders = {}, noRetry = false)=>{
-        log.trace(`JsonRpcClient.fetch: ${host} ${rpcMethod}`, {
+    return async (host, body, extraHeaders = {}, noRetry = false)=>{
+        log.trace(`JsonRpcClient.fetch: ${host}`, {
             host,
-            rpcMethod,
             body
         });
         let resp;
         try {
+            const jsonBody = Buffer.from(jsonStringify(body));
+            const shouldCompress = jsonBody.length >= COMPRESSION_THRESHOLD;
             resp = await client.request({
                 method: 'POST',
                 origin: new URL(host),
-                path: useApiEndpoints ? rpcMethod : '/',
-                body: jsonStringify(body),
+                path: '/',
+                body: shouldCompress ? await gzip(jsonBody) : jsonBody,
                 headers: {
                     ...extraHeaders,
-                    'content-type': 'application/json'
+                    'content-type': 'application/json',
+                    ...shouldCompress && {
+                        'content-encoding': 'gzip'
+                    },
+                    'accept-encoding': 'gzip'
                 }
             });
         } catch (err) {
-            const errorMessage = `Error fetching from host ${host} with method ${rpcMethod}: ${String(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'];
         try {
-            responseJson = await resp.body.json();
-        } catch (err) {
+            if (contentEncoding === 'gzip') {
+                const jsonBuffer = await gunzip(await resp.body.arrayBuffer());
+                responseJson = JSON.parse(jsonBuffer.toString('utf-8'));
+            } else {
+                responseJson = await resp.body.json();
+            }
+        } catch  {
             if (!responseOk) {
                 throw new Error('HTTP ' + resp.statusCode);
             }
-            throw new Error(`Failed to parse body as JSON: ${await resp.body.text()}`);
+            throw new Error(`Failed to parse body as JSON. encoding: ${contentEncoding}, body: ${await resp.body.text()}`);
         }
         if (!responseOk) {
-            const errorMessage = `Error ${resp.statusCode} response from server ${host} on ${rpcMethod}: ${responseJson.error.message}`;
+            const errorMessage = `Error ${resp.statusCode} response from server ${host}: ${responseJson}`;
             if (noRetry || resp.statusCode >= 400 && resp.statusCode < 500) {
                 throw new NoRetryError(errorMessage);
             } else {

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

@@ -5,23 +5,16 @@ import type { ZodFor } from '../schemas/types.js';
  * @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;
+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: object, prettify?: boolean): 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=convert.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udmVydC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2pzb24tcnBjL2NvbnZlcnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFFbEQ7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IsbUJBQW1CLENBQUMsQ0FBQyxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUUsTUFBTSxFQUFFLE1BQU0sQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBRXpFO0FBRUQ7Ozs7R0FJRztBQUNILHdCQUFnQixhQUFhLENBQUMsR0FBRyxFQUFFLE9BQU8sRUFBRSxRQUFRLENBQUMsRUFBRSxPQUFPLEdBQUcsTUFBTSxDQW9CdEU7QUFFRDs7O0dBR0c7QUFDSCx3QkFBZ0IsZ0JBQWdCLENBQUMsR0FBRyxFQUFFLEdBQUcsRUFBRSxRQUFRLENBQUMsRUFBRSxPQUFPLEdBQUcsTUFBTSxHQUFHLFNBQVMsQ0FNakYifQ==

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

@@ -1 +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"}
+{"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

@@ -5,14 +5,6 @@ import { Buffer } from 'buffer';
  * @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));
 }
 /**
@@ -42,7 +34,7 @@ import { Buffer } from 'buffer';
  */ export function tryJsonStringify(obj, prettify) {
     try {
         return jsonStringify(obj, prettify);
-    } catch (e) {
+    } 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

@@ -2,10 +2,12 @@
  * 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);
+    /** 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=class_a.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3NfYS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2pzb24tcnBjL2ZpeHR1cmVzL2NsYXNzX2EudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUc7QUFDSCxxQkFBYSxhQUFhO0lBRXRCLGNBQWMsVUFBaUIsQ0FBQyxFQUFFLE1BQU07SUFDeEMsb0JBQW9CLFVBQWlCLENBQUMsRUFBRSxNQUFNO0lBRmhEO0lBQ0UsY0FBYyxDQUFpQixDQUFDLEVBQUUsTUFBTTtJQUN4QyxvQkFBb0IsQ0FBaUIsQ0FBQyxFQUFFLE1BQU0sRUFDNUM7SUFFSixRQUFRLElBQUksTUFBTSxDQUVqQjtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsS0FBSyxFQUFFLE1BQU0saUJBRzlCO0NBQ0YifQ==

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

@@ -1 +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"}
+{"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_b.d.ts

@@ -2,10 +2,12 @@
  * 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);
+    /** 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=class_b.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3NfYi5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2pzb24tcnBjL2ZpeHR1cmVzL2NsYXNzX2IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUc7QUFDSCxxQkFBYSxhQUFhO0lBRXRCLGNBQWMsVUFBaUIsQ0FBQyxFQUFFLE1BQU07SUFDeEMsb0JBQW9CLFVBQWlCLENBQUMsRUFBRSxNQUFNO0lBRmhEO0lBQ0UsY0FBYyxDQUFpQixDQUFDLEVBQUUsTUFBTTtJQUN4QyxvQkFBb0IsQ0FBaUIsQ0FBQyxFQUFFLE1BQU0sRUFDNUM7SUFFSixRQUFRLElBQUksTUFBTSxDQUVqQjtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsS0FBSyxFQUFFLE1BQU0saUJBRzlCO0NBQ0YifQ==

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

@@ -1 +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"}
+{"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/test_state.d.ts

@@ -86,4 +86,4 @@ export declare class TestState implements TestStateApi {
     getTuple(): Promise<[string, string | undefined, number]>;
 }
 export declare const TestStateSchema: ApiSchemaFor<TestStateApi>;
-//# sourceMappingURL=test_state.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVzdF9zdGF0ZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2pzb24tcnBjL2ZpeHR1cmVzL3Rlc3Rfc3RhdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEVBQUUsS0FBSyxZQUFZLEVBQXFCLE1BQU0sd0JBQXdCLENBQUM7QUFHOUU7O0dBRUc7QUFDSCxxQkFBYSxRQUFRO0lBQ1AsT0FBTyxDQUFDLElBQUk7SUFBeEIsWUFBb0IsSUFBSSxFQUFFLE1BQU0sRUFBSTtJQUVwQyxNQUFNLEtBQUssTUFBTTs7Ozs7Ozs7T0FFaEI7SUFFRCxNQUFNOztNQUVMO0lBRUQ7OztPQUdHO0lBQ0gsUUFBUSxJQUFJLE1BQU0sQ0FFakI7SUFDRDs7OztPQUlHO0lBQ0gsTUFBTSxDQUFDLFVBQVUsQ0FBQyxJQUFJLEVBQUUsTUFBTSxHQUFHLFFBQVEsQ0FFeEM7Q0FDRjtBQUVELE1BQU0sV0FBVyxZQUFZO0lBQzNCLE9BQU8sRUFBRSxDQUFDLEtBQUssRUFBRSxNQUFNLEtBQUssT0FBTyxDQUFDLFFBQVEsR0FBRyxTQUFTLENBQUMsQ0FBQztJQUMxRCxRQUFRLEVBQUUsQ0FBQyxLQUFLLENBQUMsRUFBRSxNQUFNLEtBQUssT0FBTyxDQUFDLFFBQVEsRUFBRSxDQUFDLENBQUM7SUFDbEQsU0FBUyxFQUFFLENBQUMsS0FBSyxFQUFFLE1BQU0sR0FBRyxTQUFTLEtBQUssT0FBTyxDQUFDLFFBQVEsRUFBRSxDQUFDLENBQUM7SUFDOUQsU0FBUyxFQUFFLENBQUMsS0FBSyxDQUFDLEVBQUUsTUFBTSxLQUFLLE9BQU8sQ0FBQyxRQUFRLEVBQUUsQ0FBQyxDQUFDO0lBQ25ELEtBQUssRUFBRSxNQUFNLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUMzQixRQUFRLEVBQUUsQ0FBQyxLQUFLLEVBQUUsUUFBUSxFQUFFLEtBQUssT0FBTyxDQUFDLFFBQVEsRUFBRSxDQUFDLENBQUM7SUFDckQsSUFBSSxFQUFFLE1BQU0sT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQzFCLEtBQUssRUFBRSxNQUFNLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUM3QixTQUFTLEVBQUUsTUFBTSxPQUFPLENBQUM7UUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFDO1FBQUMsS0FBSyxFQUFFLE1BQU0sQ0FBQTtLQUFFLENBQUMsQ0FBQztJQUM1RCxRQUFRLElBQUksT0FBTyxDQUFDLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxTQUFTLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQztDQUMzRDtBQUVEOzs7O0dBSUc7QUFDSCxxQkFBYSxTQUFVLFlBQVcsWUFBWTtJQUN6QixLQUFLLEVBQUUsUUFBUSxFQUFFO0lBQXBDLFlBQW1CLEtBQUssRUFBRSxRQUFRLEVBQUUsRUFBSTtJQUN4Qzs7Ozs7OztPQU9HO0lBQ0csT0FBTyxDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQUc5QztJQUVELElBQUksSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLENBRXBCO0lBRUssS0FBSyxJQUFJLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FHN0I7SUFFSyxRQUFRLENBQUMsS0FBSyxDQUFDLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxRQUFRLEVBQUUsQ0FBQyxDQUdsRDtJQUVLLFNBQVMsQ0FBQyxLQUFLLEVBQUUsTUFBTSxHQUFHLFNBQVMsR0FBRyxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FHOUQ7SUFFSyxTQUFTLENBQUMsS0FBSyxTQUFJLEdBQUcsT0FBTyxDQUFDLFFBQVEsRUFBRSxDQUFDLENBRzlDO0lBRUssS0FBSyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FHM0I7SUFFRDs7Ozs7Ozs7T0FRRztJQUNHLFFBQVEsQ0FBQyxLQUFLLEVBQUUsUUFBUSxFQUFFLEdBQUcsT0FBTyxDQUFDLFFBQVEsRUFBRSxDQUFDLENBTXJEO0lBRUssVUFBVSxrQkFHZjtJQUVLLFNBQVMsSUFBSSxPQUFPLENBQUM7UUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFDO1FBQUMsS0FBSyxFQUFFLE1BQU0sQ0FBQTtLQUFFLENBQUMsQ0FHNUQ7SUFFSyxRQUFRLElBQUksT0FBTyxDQUFDLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxTQUFTLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FHOUQ7Q0FDRjtBQUVELGVBQU8sTUFBTSxlQUFlLEVBQUUsWUFBWSxDQUFDLFlBQVksQ0FXdEQsQ0FBQyJ9

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

@@ -1 +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"}
+{"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;;;;;;;;OAEhB;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/index.d.ts

@@ -1,2 +1,3 @@
-export { jsonStringify, jsonParseWithSchema, jsonParseWithSchemaSync, tryJsonStringify } from './convert.js';
-//# sourceMappingURL=index.d.ts.map
+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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/json-rpc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}
+{"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

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

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

@@ -10,4 +10,4 @@ export declare const hasOwnProperty: (obj: any, propertyName: string) => boolean
  * @param err - Error message to throw if x isn't met.
  */
 export declare function assert(x: any, err: string): asserts x;
-//# sourceMappingURL=js_utils.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoianNfdXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9qc29uLXJwYy9qc191dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFHQTs7OztHQUlHO0FBQ0gsZUFBTyxNQUFNLGNBQWMsNkNBQzhCLENBQUM7QUFFMUQ7Ozs7R0FJRztBQUNILHdCQUFnQixNQUFNLENBQUMsQ0FBQyxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBSXJEIn0=

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

@@ -1 +1 @@
-{"version":3,"file":"js_utils.d.ts","sourceRoot":"","sources":["../../src/json-rpc/js_utils.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAS,GAAG,gBAAgB,MAAM,YACJ,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAIrD"}
+{"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/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"}

package/dest/json-rpc/server/api_key_auth.js

@@ -0,0 +1,57 @@
+import { timingSafeEqual } from 'crypto';
+import { sha256 } from '../../crypto/sha256/index.js';
+import { createLogger } from '../../log/index.js';
+const log = createLogger('json-rpc:api-key-auth');
+/**
+ * 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 function sha256Hash(input) {
+    return sha256(Buffer.from(input));
+}
+/**
+ * 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 function getApiKeyAuthMiddleware(apiKeyHash) {
+    return async (ctx, next)=>{
+        // Allow health check through without auth
+        if (ctx.path === '/status' && ctx.method === 'GET') {
+            return next();
+        }
+        const providedKey = ctx.get('x-api-key') || ctx.get('authorization')?.replace(/^Bearer\s+/i, '');
+        if (!providedKey) {
+            log.warn(`Rejected admin RPC request from ${ctx.ip}: missing API key`);
+            ctx.status = 401;
+            ctx.body = {
+                jsonrpc: '2.0',
+                id: null,
+                error: {
+                    code: -32000,
+                    message: 'Unauthorized: invalid or missing API key'
+                }
+            };
+            return;
+        }
+        const providedHashBuf = sha256Hash(providedKey);
+        if (!timingSafeEqual(apiKeyHash, providedHashBuf)) {
+            log.warn(`Rejected admin RPC request from ${ctx.ip}: invalid API key`);
+            ctx.status = 401;
+            ctx.body = {
+                jsonrpc: '2.0',
+                id: null,
+                error: {
+                    code: -32000,
+                    message: 'Unauthorized: invalid or missing API key'
+                }
+            };
+            return;
+        }
+        await next();
+    };
+}

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

@@ -1,2 +1,3 @@
+export * from './api_key_auth.js';
 export * from './safe_json_rpc_server.js';
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9qc29uLXJwYy9zZXJ2ZXIvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxtQkFBbUIsQ0FBQztBQUNsQyxjQUFjLDJCQUEyQixDQUFDIn0=

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

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

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

@@ -1 +1,2 @@
+export * from './api_key_auth.js';
 export * from './safe_json_rpc_server.js';