@aztec/foundation 0.1.0-alpha10

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

@@ -0,0 +1,62 @@
+import { sleep } from '../../sleep/index.js';
+/**
+ * Contrived example for JSON RPC tests.
+ */
+export class TestNote {
+    constructor(data) {
+        this.data = 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 {
+    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.
+     */
+    getNote(index) {
+        return this.notes[index];
+    }
+    /**
+     * 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;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVzdF9zdGF0ZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9qc29uLXJwYy9maXh0dXJlcy90ZXN0X3N0YXRlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUU3Qzs7R0FFRztBQUNILE1BQU0sT0FBTyxRQUFRO0lBQ25CLFlBQW9CLElBQVk7UUFBWixTQUFJLEdBQUosSUFBSSxDQUFRO0lBQUcsQ0FBQztJQUNwQzs7O09BR0c7SUFDSCxRQUFRO1FBQ04sT0FBTyxJQUFJLENBQUMsSUFBSSxDQUFDO0lBQ25CLENBQUM7SUFDRDs7OztPQUlHO0lBQ0gsTUFBTSxDQUFDLFVBQVUsQ0FBQyxJQUFZO1FBQzVCLE9BQU8sSUFBSSxRQUFRLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDNUIsQ0FBQztDQUNGO0FBRUQ7Ozs7R0FJRztBQUNILE1BQU0sT0FBTyxTQUFTO0lBQ3BCLFlBQW9CLEtBQWlCO1FBQWpCLFVBQUssR0FBTCxLQUFLLENBQVk7SUFBRyxDQUFDO0lBQ3pDOzs7Ozs7O09BT0c7SUFDSCxPQUFPLENBQUMsS0FBYTtRQUNuQixPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsS0FBSyxDQUFDLENBQUM7SUFDM0IsQ0FBQztJQUNEOzs7Ozs7OztPQVFHO0lBQ0gsS0FBSyxDQUFDLFFBQVEsQ0FBQyxLQUFpQjtRQUM5QixLQUFLLE1BQU0sSUFBSSxJQUFJLEtBQUssRUFBRTtZQUN4QixJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztTQUN2QjtRQUNELE1BQU0sS0FBSyxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsQ0FBQztRQUMxQixPQUFPLElBQUksQ0FBQyxLQUFLLENBQUM7SUFDcEIsQ0FBQztDQUNGIn0=

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

@@ -0,0 +1,4 @@
+export { ClassConverterInput, JsonEncodedClass, ClassConverter } from './class_converter.js';
+export { JsonRpcServer, JsonProxy } from './server/index.js';
+export { createJsonRpcClient, JsonStringify } from './client/index.js';
+//# sourceMappingURL=index.d.ts.map

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,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dest/json-rpc/index.js

@@ -0,0 +1,4 @@
+export { ClassConverter } from './class_converter.js';
+export { JsonRpcServer, JsonProxy } from './server/index.js';
+export { createJsonRpcClient, JsonStringify } from './client/index.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvanNvbi1ycGMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUF5QyxjQUFjLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUM3RixPQUFPLEVBQUUsYUFBYSxFQUFFLFNBQVMsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQzdELE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxhQUFhLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQyJ9

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=js_utils.d.ts.map

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":"AAEA;;;;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"}

package/dest/json-rpc/js_utils.js

@@ -0,0 +1,18 @@
+// Make sure this property was not inherited
+/**
+ * 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);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoianNfdXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvanNvbi1ycGMvanNfdXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsNENBQTRDO0FBRTVDOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsTUFBTSxjQUFjLEdBQUcsQ0FBQyxHQUFRLEVBQUUsWUFBb0IsRUFBRSxFQUFFLENBQy9ELE1BQU0sQ0FBQyxTQUFTLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUUsWUFBWSxDQUFDLENBQUM7QUFFMUQ7Ozs7R0FJRztBQUNILE1BQU0sVUFBVSxNQUFNLENBQUMsQ0FBTSxFQUFFLEdBQVc7SUFDeEMsSUFBSSxDQUFDLENBQUMsRUFBRTtRQUNOLE1BQU0sSUFBSSxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUM7S0FDdEI7QUFDSCxDQUFDIn0=

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

@@ -0,0 +1,3 @@
+export { JsonRpcServer } from './json_rpc_server.js';
+export { JsonProxy } from './json_proxy.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/json-rpc/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,3 @@
+export { JsonRpcServer } from './json_rpc_server.js';
+export { JsonProxy } from './json_proxy.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvanNvbi1ycGMvc2VydmVyL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUNyRCxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0saUJBQWlCLENBQUMifQ==

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

@@ -0,0 +1,18 @@
+import { ClassConverter, ClassConverterInput } from '../class_converter.js';
+/**
+ * Handles conversion of objects over the write.
+ * Delegates to a ClassConverter object.
+ */
+export declare class JsonProxy {
+    private handler;
+    classConverter: ClassConverter;
+    constructor(handler: object, stringClassMap: ClassConverterInput, objectClassMap: ClassConverterInput);
+    /**
+     * Call an RPC method.
+     * @param methodName - The RPC method.
+     * @param jsonParams - The RPG parameters.
+     * @returns The remote result.
+     */
+    call(methodName: string, jsonParams?: any[]): Promise<any>;
+}
+//# sourceMappingURL=json_proxy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json_proxy.d.ts","sourceRoot":"","sources":["../../../src/json-rpc/server/json_proxy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAM5E;;;GAGG;AACH,qBAAa,SAAS;IAER,OAAO,CAAC,OAAO;IAD3B,cAAc,EAAE,cAAc,CAAC;gBACX,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,mBAAmB;IAG7G;;;;;OAKG;IACU,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,GAAG,EAAO;CAa7D"}

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

@@ -0,0 +1,35 @@
+import { createDebugLogger } from '../../log/index.js';
+import { ClassConverter } from '../class_converter.js';
+import { convertFromJsonObj, convertToJsonObj } from '../convert.js';
+import { assert, hasOwnProperty } from '../js_utils.js';
+const debug = createDebugLogger('json-rpc:json_proxy');
+/**
+ * Handles conversion of objects over the write.
+ * Delegates to a ClassConverter object.
+ */
+export class JsonProxy {
+    constructor(handler, stringClassMap, objectClassMap) {
+        this.handler = handler;
+        this.classConverter = new ClassConverter(stringClassMap, objectClassMap);
+    }
+    /**
+     * Call an RPC method.
+     * @param methodName - The RPC method.
+     * @param jsonParams - The RPG parameters.
+     * @returns The remote result.
+     */
+    async call(methodName, jsonParams = []) {
+        // Get access to our class members
+        const proto = Object.getPrototypeOf(this.handler);
+        assert(hasOwnProperty(proto, methodName), 'JsonProxy: Method not found!');
+        assert(Array.isArray(jsonParams), 'JsonProxy: Params not an array!');
+        // convert the params from json representation to classes
+        const convertedParams = jsonParams.map(param => convertFromJsonObj(this.classConverter, param));
+        debug('JsonProxy:call', methodName, '<-', convertedParams);
+        const rawRet = await this.handler[methodName](...convertedParams);
+        const ret = convertToJsonObj(this.classConverter, rawRet);
+        debug('JsonProxy:call', methodName, '->', ret);
+        return ret;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoianNvbl9wcm94eS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9qc29uLXJwYy9zZXJ2ZXIvanNvbl9wcm94eS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUN2RCxPQUFPLEVBQUUsY0FBYyxFQUF1QixNQUFNLHVCQUF1QixDQUFDO0FBQzVFLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUNyRSxPQUFPLEVBQUUsTUFBTSxFQUFFLGNBQWMsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBRXhELE1BQU0sS0FBSyxHQUFHLGlCQUFpQixDQUFDLHFCQUFxQixDQUFDLENBQUM7QUFFdkQ7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLFNBQVM7SUFFcEIsWUFBb0IsT0FBZSxFQUFFLGNBQW1DLEVBQUUsY0FBbUM7UUFBekYsWUFBTyxHQUFQLE9BQU8sQ0FBUTtRQUNqQyxJQUFJLENBQUMsY0FBYyxHQUFHLElBQUksY0FBYyxDQUFDLGNBQWMsRUFBRSxjQUFjLENBQUMsQ0FBQztJQUMzRSxDQUFDO0lBQ0Q7Ozs7O09BS0c7SUFDSSxLQUFLLENBQUMsSUFBSSxDQUFDLFVBQWtCLEVBQUUsYUFBb0IsRUFBRTtRQUMxRCxrQ0FBa0M7UUFDbEMsTUFBTSxLQUFLLEdBQUcsTUFBTSxDQUFDLGNBQWMsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDbEQsTUFBTSxDQUFDLGNBQWMsQ0FBQyxLQUFLLEVBQUUsVUFBVSxDQUFDLEVBQUUsOEJBQThCLENBQUMsQ0FBQztRQUMxRSxNQUFNLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxVQUFVLENBQUMsRUFBRSxpQ0FBaUMsQ0FBQyxDQUFDO1FBQ3JFLHlEQUF5RDtRQUN6RCxNQUFNLGVBQWUsR0FBRyxVQUFVLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUMsa0JBQWtCLENBQUMsSUFBSSxDQUFDLGNBQWMsRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFDO1FBQ2hHLEtBQUssQ0FBQyxnQkFBZ0IsRUFBRSxVQUFVLEVBQUUsSUFBSSxFQUFFLGVBQWUsQ0FBQyxDQUFDO1FBQzNELE1BQU0sTUFBTSxHQUFHLE1BQU8sSUFBSSxDQUFDLE9BQWUsQ0FBQyxVQUFVLENBQUMsQ0FBQyxHQUFHLGVBQWUsQ0FBQyxDQUFDO1FBQzNFLE1BQU0sR0FBRyxHQUFHLGdCQUFnQixDQUFDLElBQUksQ0FBQyxjQUFjLEVBQUUsTUFBTSxDQUFDLENBQUM7UUFDMUQsS0FBSyxDQUFDLGdCQUFnQixFQUFFLFVBQVUsRUFBRSxJQUFJLEVBQUUsR0FBRyxDQUFDLENBQUM7UUFDL0MsT0FBTyxHQUFHLENBQUM7SUFDYixDQUFDO0NBQ0YifQ==

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

@@ -0,0 +1,34 @@
+import Koa from 'koa';
+import { ClassConverterInput } from '../class_converter.js';
+import { JsonProxy } from './json_proxy.js';
+/**
+ * JsonRpcServer.
+ * Minimal, dev-friendly mechanism to create a server from an object.
+ */
+export declare class JsonRpcServer {
+    private handler;
+    private createApi;
+    private disallowedMethods;
+    private log;
+    proxy: JsonProxy;
+    constructor(handler: object, stringClassMap: ClassConverterInput, objectClassMap: ClassConverterInput, createApi: boolean, disallowedMethods?: string[], log?: import("../../log/console.js").Logger);
+    /**
+     * Get an express app object.
+     * @param prefix - Our server prefix.
+     * @returns The app object.
+     */
+    getApp(prefix?: string): Koa<Koa.DefaultState, Koa.DefaultContext>;
+    /**
+     * Get a router object wrapping our RPC class.
+     * @param prefix - The server prefix.
+     * @returns The router object.
+     */
+    private getRouter;
+    /**
+     * Start this server with koa.
+     * @param port - Port number.
+     * @param prefix - Prefix string.
+     */
+    start(port: number, prefix?: string): void;
+}
+//# sourceMappingURL=json_rpc_server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json_rpc_server.d.ts","sourceRoot":"","sources":["../../../src/json-rpc/server/json_rpc_server.ts"],"names":[],"mappings":"AAIA,OAAO,GAAG,MAAM,KAAK,CAAC;AAItB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C;;;GAGG;AACH,qBAAa,aAAa;IAGtB,OAAO,CAAC,OAAO;IAGf,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,GAAG;IAPb,KAAK,EAAE,SAAS,CAAC;gBAEP,OAAO,EAAE,MAAM,EACvB,cAAc,EAAE,mBAAmB,EACnC,cAAc,EAAE,mBAAmB,EAC3B,SAAS,EAAE,OAAO,EAClB,iBAAiB,GAAE,MAAM,EAAO,EAChC,GAAG,wCAAmD;IAKhE;;;;OAIG;IACI,MAAM,CAAC,MAAM,SAAK;IAyBzB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAkDjB;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAK;CAIvC"}

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

@@ -0,0 +1,109 @@
+import http from 'http';
+import Router from 'koa-router';
+import cors from '@koa/cors';
+import compress from 'koa-compress';
+import Koa from 'koa';
+import bodyParser from 'koa-bodyparser';
+import { createLogger } from '../../log/index.js';
+import { JsonProxy } from './json_proxy.js';
+import { JsonStringify } from '../convert.js';
+/**
+ * JsonRpcServer.
+ * Minimal, dev-friendly mechanism to create a server from an object.
+ */
+export class JsonRpcServer {
+    constructor(handler, stringClassMap, objectClassMap, createApi, disallowedMethods = [], log = createLogger('aztec:foundation:json-rpc:server')) {
+        this.handler = handler;
+        this.createApi = createApi;
+        this.disallowedMethods = disallowedMethods;
+        this.log = log;
+        this.proxy = new JsonProxy(handler, stringClassMap, objectClassMap);
+    }
+    /**
+     * Get an express app object.
+     * @param prefix - Our server prefix.
+     * @returns The app object.
+     */
+    getApp(prefix = '') {
+        const router = this.getRouter(prefix);
+        const exceptionHandler = async (ctx, next) => {
+            try {
+                await next();
+            }
+            catch (err) {
+                this.log(err);
+                ctx.status = 400;
+                ctx.body = { error: err.message };
+            }
+        };
+        const app = new Koa();
+        app.on('error', error => {
+            this.log(`KOA app-level error. ${JsonStringify({ error })}`);
+        });
+        app.use(compress({ br: false }));
+        app.use(bodyParser());
+        app.use(cors());
+        app.use(exceptionHandler);
+        app.use(router.routes());
+        app.use(router.allowedMethods());
+        return app;
+    }
+    /**
+     * Get a router object wrapping our RPC class.
+     * @param prefix - The server prefix.
+     * @returns The router object.
+     */
+    getRouter(prefix) {
+        const router = new Router({ prefix });
+        const proto = Object.getPrototypeOf(this.handler);
+        // Find all our endpoints from the handler methods
+        if (this.createApi) {
+            // "API mode" where an endpoint is created for each method
+            for (const method of Object.getOwnPropertyNames(proto)) {
+                // Ignore if not a function or function is not allowed
+                if (method === 'constructor' ||
+                    typeof proto[method] !== 'function' ||
+                    this.disallowedMethods.includes(method)) {
+                    continue;
+                }
+                router.post(`/${method}`, async (ctx) => {
+                    const { params = [], jsonrpc, id } = ctx.request.body;
+                    const result = await this.proxy.call(method, params);
+                    ctx.body = { jsonrpc, id, result: JsonStringify(result) };
+                    ctx.status = 200;
+                });
+            }
+        }
+        else {
+            // "JSON RPC mode" where a single endpoint is used and the method is given in the request body
+            router.post('/', async (ctx) => {
+                const { params = [], jsonrpc, id, method } = ctx.request.body;
+                // Ignore if not a function
+                if (method === 'constructor' ||
+                    typeof proto[method] !== 'function' ||
+                    this.disallowedMethods.includes(method)) {
+                    ctx.status = 400;
+                    ctx.body = { error: `Invalid method name: ${method}` };
+                }
+                const result = await this.proxy.call(method, params);
+                ctx.body = {
+                    jsonrpc,
+                    id,
+                    result: JsonStringify(result),
+                };
+                ctx.status = 200;
+            });
+        }
+        return router;
+    }
+    /**
+     * Start this server with koa.
+     * @param port - Port number.
+     * @param prefix - Prefix string.
+     */
+    start(port, prefix = '') {
+        const httpServer = http.createServer(this.getApp(prefix).callback());
+        httpServer.listen(port);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoianNvbl9ycGNfc2VydmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2pzb24tcnBjL3NlcnZlci9qc29uX3JwY19zZXJ2ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxJQUFJLE1BQU0sTUFBTSxDQUFDO0FBQ3hCLE9BQU8sTUFBTSxNQUFNLFlBQVksQ0FBQztBQUNoQyxPQUFPLElBQUksTUFBTSxXQUFXLENBQUM7QUFDN0IsT0FBTyxRQUFRLE1BQU0sY0FBYyxDQUFDO0FBQ3BDLE9BQU8sR0FBRyxNQUFNLEtBQUssQ0FBQztBQUN0QixPQUFPLFVBQVUsTUFBTSxnQkFBZ0IsQ0FBQztBQUV4QyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFFbEQsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQzVDLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFFOUM7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLGFBQWE7SUFFeEIsWUFDVSxPQUFlLEVBQ3ZCLGNBQW1DLEVBQ25DLGNBQW1DLEVBQzNCLFNBQWtCLEVBQ2xCLG9CQUE4QixFQUFFLEVBQ2hDLE1BQU0sWUFBWSxDQUFDLGtDQUFrQyxDQUFDO1FBTHRELFlBQU8sR0FBUCxPQUFPLENBQVE7UUFHZixjQUFTLEdBQVQsU0FBUyxDQUFTO1FBQ2xCLHNCQUFpQixHQUFqQixpQkFBaUIsQ0FBZTtRQUNoQyxRQUFHLEdBQUgsR0FBRyxDQUFtRDtRQUU5RCxJQUFJLENBQUMsS0FBSyxHQUFHLElBQUksU0FBUyxDQUFDLE9BQU8sRUFBRSxjQUFjLEVBQUUsY0FBYyxDQUFDLENBQUM7SUFDdEUsQ0FBQztJQUVEOzs7O09BSUc7SUFDSSxNQUFNLENBQUMsTUFBTSxHQUFHLEVBQUU7UUFDdkIsTUFBTSxNQUFNLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxNQUFNLENBQUMsQ0FBQztRQUN0QyxNQUFNLGdC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

package/dest/json-rpc/server/json_rpc_server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json_rpc_server.test.d.ts.map

package/dest/json-rpc/server/json_rpc_server.test.d.ts.map

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

package/dest/json-rpc/server/json_rpc_server.test.js

@@ -0,0 +1,22 @@
+import request from 'supertest';
+import { TestState, TestNote } from '../fixtures/test_state.js';
+import { JsonRpcServer } from './json_rpc_server.js';
+test('test an RPC function with a primitive parameter', async () => {
+    const server = new JsonRpcServer(new TestState([new TestNote('a'), new TestNote('b')]), { TestNote }, {}, true);
+    const response = await request(server.getApp().callback())
+        .post('/getNote')
+        .send({ params: [0] });
+    expect(response.status).toBe(200);
+    expect(response.text).toBe(JSON.stringify({ result: JSON.stringify({ type: 'TestNote', data: 'a' }) }));
+});
+test('test an RPC function with an array of classes', async () => {
+    const server = new JsonRpcServer(new TestState([]), { TestNote }, {}, true);
+    const response = await request(server.getApp().callback())
+        .post('/addNotes')
+        .send({
+        params: [[{ data: 'a' }, { data: 'b' }, { data: 'c' }]],
+    });
+    expect(response.status).toBe(200);
+    expect(response.text).toBe(JSON.stringify({ result: JSON.stringify([{ data: 'a' }, { data: 'b' }, { data: 'c' }]) }));
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoianNvbl9ycGNfc2VydmVyLnRlc3QuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvanNvbi1ycGMvc2VydmVyL2pzb25fcnBjX3NlcnZlci50ZXN0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sT0FBTyxNQUFNLFdBQVcsQ0FBQztBQUNoQyxPQUFPLEVBQUUsU0FBUyxFQUFFLFFBQVEsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQ2hFLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUVyRCxJQUFJLENBQUMsaURBQWlELEVBQUUsS0FBSyxJQUFJLEVBQUU7SUFDakUsTUFBTSxNQUFNLEdBQUcsSUFBSSxhQUFhLENBQUMsSUFBSSxTQUFTLENBQUMsQ0FBQyxJQUFJLFFBQVEsQ0FBQyxHQUFHLENBQUMsRUFBRSxJQUFJLFFBQVEsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxRQUFRLEVBQUUsRUFBRSxFQUFFLEVBQUUsSUFBSSxDQUFDLENBQUM7SUFDaEgsTUFBTSxRQUFRLEdBQUcsTUFBTSxPQUFPLENBQUMsTUFBTSxDQUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsRUFBRSxDQUFDO1NBQ3ZELElBQUksQ0FBQyxVQUFVLENBQUM7U0FDaEIsSUFBSSxDQUFDLEVBQUUsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDO0lBQ3pCLE1BQU0sQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQ2xDLE1BQU0sQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsRUFBRSxNQUFNLEVBQUUsSUFBSSxDQUFDLFNBQVMsQ0FBQyxFQUFFLElBQUksRUFBRSxVQUFVLEVBQUUsSUFBSSxFQUFFLEdBQUcsRUFBRSxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUM7QUFDMUcsQ0FBQyxDQUFDLENBQUM7QUFFSCxJQUFJLENBQUMsK0NBQStDLEVBQUUsS0FBSyxJQUFJLEVBQUU7SUFDL0QsTUFBTSxNQUFNLEdBQUcsSUFBSSxhQUFhLENBQUMsSUFBSSxTQUFTLENBQUMsRUFBRSxDQUFDLEVBQUUsRUFBRSxRQUFRLEVBQUUsRUFBRSxFQUFFLEVBQUUsSUFBSSxDQUFDLENBQUM7SUFDNUUsTUFBTSxRQUFRLEdBQUcsTUFBTSxPQUFPLENBQUMsTUFBTSxDQUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsRUFBRSxDQUFDO1NBQ3ZELElBQUksQ0FBQyxXQUFXLENBQUM7U0FDakIsSUFBSSxDQUFDO1FBQ0osTUFBTSxFQUFFLENBQUMsQ0FBQyxFQUFFLElBQUksRUFBRSxHQUFHLEVBQUUsRUFBRSxFQUFFLElBQUksRUFBRSxHQUFHLEVBQUUsRUFBRSxFQUFFLElBQUksRUFBRSxHQUFHLEVBQUUsQ0FBQyxDQUFDO0tBQ3hELENBQUMsQ0FBQztJQUNMLE1BQU0sQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQ2xDLE1BQU0sQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsRUFBRSxNQUFNLEVBQUUsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDLEVBQUUsSUFBSSxFQUFFLEdBQUcsRUFBRSxFQUFFLEVBQUUsSUFBSSxFQUFFLEdBQUcsRUFBRSxFQUFFLEVBQUUsSUFBSSxFQUFFLEdBQUcsRUFBRSxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQztBQUN4SCxDQUFDLENBQUMsQ0FBQyJ9

package/dest/log/console.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Logger is a utility type that represents a logging function that accepts any number of arguments.
+ * It is used to provide customizable logging functionality, allowing developers to easily log messages
+ * with optional prefixes and custom formatting or output destinations.
+ */
+export type Logger = (...args: any[]) => void;
+/**
+ * Creates a Logger function with an optional prefix for log messages.
+ * If a prefix is provided, the created logger will prepend it to each log message.
+ * If no prefix is provided, the default console.log will be returned.
+ *
+ * @param prefix - The optional string to prepend to each log message.
+ * @returns A Logger function that accepts any number of arguments and logs them with the specified prefix.
+ */
+export declare function createLogger(prefix?: string): Logger;
+//# sourceMappingURL=console.d.ts.map

package/dest/log/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/log/console.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAuB9C;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAMpD"}

package/dest/log/console.js

@@ -0,0 +1,39 @@
+/* eslint-disable no-console */
+/**
+ * ConsoleLogger is a utility class that provides customizable console logging functionality.
+ * It allows setting a custom prefix for log messages and an optional custom logger function,
+ * which can be useful for controlling the format of the output or redirecting logs to a different destination.
+ */
+class ConsoleLogger {
+    constructor(prefix, logger = console.log) {
+        this.prefix = prefix;
+        this.logger = logger;
+    }
+    /**
+     * Log messages with the specified prefix using the provided logger.
+     * By default, it uses 'console.log' as the logger but can be overridden
+     * during ConsoleLogger instantiation. This method allows for easy
+     * organization and readability of log messages in the console.
+     *
+     * @param args - The data to be logged, any number of arguments can be passed to this function.
+     */
+    log(...args) {
+        this.logger(`${this.prefix}:`, ...args);
+    }
+}
+/**
+ * Creates a Logger function with an optional prefix for log messages.
+ * If a prefix is provided, the created logger will prepend it to each log message.
+ * If no prefix is provided, the default console.log will be returned.
+ *
+ * @param prefix - The optional string to prepend to each log message.
+ * @returns A Logger function that accepts any number of arguments and logs them with the specified prefix.
+ */
+export function createLogger(prefix) {
+    if (prefix) {
+        const logger = new ConsoleLogger(prefix, console.log);
+        return (...args) => logger.log(...args);
+    }
+    return console.log;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc29sZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sb2cvY29uc29sZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwrQkFBK0I7QUFTL0I7Ozs7R0FJRztBQUNILE1BQU0sYUFBYTtJQUNqQixZQUFvQixNQUFjLEVBQVUsU0FBbUMsT0FBTyxDQUFDLEdBQUc7UUFBdEUsV0FBTSxHQUFOLE1BQU0sQ0FBUTtRQUFVLFdBQU0sR0FBTixNQUFNLENBQXdDO0lBQUcsQ0FBQztJQUU5Rjs7Ozs7OztPQU9HO0lBQ0ksR0FBRyxDQUFDLEdBQUcsSUFBVztRQUN2QixJQUFJLENBQUMsTUFBTSxDQUFDLEdBQUcsSUFBSSxDQUFDLE1BQU0sR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDLENBQUM7SUFDMUMsQ0FBQztDQUNGO0FBRUQ7Ozs7Ozs7R0FPRztBQUNILE1BQU0sVUFBVSxZQUFZLENBQUMsTUFBZTtJQUMxQyxJQUFJLE1BQU0sRUFBRTtRQUNWLE1BQU0sTUFBTSxHQUFHLElBQUksYUFBYSxDQUFDLE1BQU0sRUFBRSxPQUFPLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDdEQsT0FBTyxDQUFDLEdBQUcsSUFBVyxFQUFFLEVBQUUsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLEdBQUcsSUFBSSxDQUFDLENBQUM7S0FDaEQ7SUFDRCxPQUFPLE9BQU8sQ0FBQyxHQUFHLENBQUM7QUFDckIsQ0FBQyJ9

package/dest/log/debug.d.ts

@@ -0,0 +1,46 @@
+/**
+ * A debug logger.
+ */
+export type DebugLogger = (...args: any[]) => void;
+/**
+ * Return a logger, meant to be silent by default and verbose during debugging.
+ * @param name - The module name of the logger.
+ * @returns A callable log function.
+ */
+export declare function createDebugLogger(name: string): DebugLogger;
+/**
+ * Set a function to be called before each log message is handled by the debug logger.
+ * The hook function will receive the logger namespace and any arguments passed to the logger.
+ * This can be useful for adding additional context, filtering logs, or performing side-effects
+ * based on logged messages.
+ *
+ * @param fn - The function to be called before each log message.
+ */
+export declare function setPreDebugLogHook(fn: (...args: any[]) => void): void;
+/**
+ * Set a callback function to be executed after each log is written by the debug logger.
+ * This allows additional behavior or side effects to occur after a log has been written,
+ * such as sending logs to external services, formatting output, or triggering events.
+ *
+ * @param fn - The callback function to be executed after each log. It receives the same arguments as the original log function call.
+ */
+export declare function setPostDebugLogHook(fn: (...args: any[]) => void): void;
+/**
+ * Enable logs for the specified namespace(s) or wildcard pattern(s).
+ * This function activates the logging functionality for the given
+ * namespace(s) or pattern(s), allowing developers to selectively display
+ * debug logs that match the provided string(s).
+ *
+ * @param str - The namespace(s) or wildcard pattern(s) for which logs should be enabled.
+ */
+export declare function enableLogs(str: string): void;
+/**
+ * Check if the logging is enabled for a given namespace.
+ * The input 'str' represents the namespace for which the log status is being checked.
+ * Returns true if the logging is enabled, otherwise false.
+ *
+ * @param str - The namespace string used to determine if logging is enabled.
+ * @returns A boolean indicating whether logging is enabled for the given namespace.
+ */
+export declare function isLogEnabled(str: string): boolean;
+//# sourceMappingURL=debug.d.ts.map

package/dest/log/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/log/debug.ts"],"names":[],"mappings":"AAyBA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAG3D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,QAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,QAE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,QAErC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,WAEvC"}

package/dest/log/debug.js

@@ -0,0 +1,75 @@
+import debug from 'debug';
+let preLogHook;
+let postLogHook;
+/**
+ * Process and handle the logging of messages through custom hooks and the given logger.
+ * This function checks if the logger's namespace is enabled, executes any preLogHook functions, logs the message using the provided logger, and then executes any postLogHook functions.
+ *
+ * @param logger - The debug logger instance to be used for logging.
+ * @param args - The arguments to be passed to the logger and any hook functions.
+ */
+function theFunctionThroughWhichAllLogsPass(logger, ...args) {
+    if (!debug.enabled(logger.namespace)) {
+        return;
+    }
+    if (preLogHook) {
+        preLogHook(logger.namespace, ...args);
+    }
+    logger(...args);
+    if (postLogHook) {
+        postLogHook(logger.namespace, ...args);
+    }
+}
+/**
+ * Return a logger, meant to be silent by default and verbose during debugging.
+ * @param name - The module name of the logger.
+ * @returns A callable log function.
+ */
+export function createDebugLogger(name) {
+    const logger = debug(name);
+    return (...args) => theFunctionThroughWhichAllLogsPass(logger, ...args);
+}
+/**
+ * Set a function to be called before each log message is handled by the debug logger.
+ * The hook function will receive the logger namespace and any arguments passed to the logger.
+ * This can be useful for adding additional context, filtering logs, or performing side-effects
+ * based on logged messages.
+ *
+ * @param fn - The function to be called before each log message.
+ */
+export function setPreDebugLogHook(fn) {
+    preLogHook = fn;
+}
+/**
+ * Set a callback function to be executed after each log is written by the debug logger.
+ * This allows additional behavior or side effects to occur after a log has been written,
+ * such as sending logs to external services, formatting output, or triggering events.
+ *
+ * @param fn - The callback function to be executed after each log. It receives the same arguments as the original log function call.
+ */
+export function setPostDebugLogHook(fn) {
+    postLogHook = fn;
+}
+/**
+ * Enable logs for the specified namespace(s) or wildcard pattern(s).
+ * This function activates the logging functionality for the given
+ * namespace(s) or pattern(s), allowing developers to selectively display
+ * debug logs that match the provided string(s).
+ *
+ * @param str - The namespace(s) or wildcard pattern(s) for which logs should be enabled.
+ */
+export function enableLogs(str) {
+    debug.enable(str);
+}
+/**
+ * Check if the logging is enabled for a given namespace.
+ * The input 'str' represents the namespace for which the log status is being checked.
+ * Returns true if the logging is enabled, otherwise false.
+ *
+ * @param str - The namespace string used to determine if logging is enabled.
+ * @returns A boolean indicating whether logging is enabled for the given namespace.
+ */
+export function isLogEnabled(str) {
+    return debug.enabled(str);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVidWcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9nL2RlYnVnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxNQUFNLE9BQU8sQ0FBQztBQUUxQixJQUFJLFVBQWtELENBQUM7QUFDdkQsSUFBSSxXQUFtRCxDQUFDO0FBRXhEOzs7Ozs7R0FNRztBQUNILFNBQVMsa0NBQWtDLENBQUMsTUFBVyxFQUFFLEdBQUcsSUFBVztJQUNyRSxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsU0FBUyxDQUFDLEVBQUU7UUFDcEMsT0FBTztLQUNSO0lBQ0QsSUFBSSxVQUFVLEVBQUU7UUFDZCxVQUFVLENBQUMsTUFBTSxDQUFDLFNBQVMsRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0tBQ3ZDO0lBQ0QsTUFBTSxDQUFDLEdBQUcsSUFBSSxDQUFDLENBQUM7SUFDaEIsSUFBSSxXQUFXLEVBQUU7UUFDZixXQUFXLENBQUMsTUFBTSxDQUFDLFNBQVMsRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0tBQ3hDO0FBQ0gsQ0FBQztBQU9EOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUsaUJBQWlCLENBQUMsSUFBWTtJQUM1QyxNQUFNLE1BQU0sR0FBRyxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDM0IsT0FBTyxDQUFDLEdBQUcsSUFBVyxFQUFFLEVBQUUsQ0FBQyxrQ0FBa0MsQ0FBQyxNQUFNLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQztBQUNqRixDQUFDO0FBRUQ7Ozs7Ozs7R0FPRztBQUNILE1BQU0sVUFBVSxrQkFBa0IsQ0FBQyxFQUE0QjtJQUM3RCxVQUFVLEdBQUcsRUFBRSxDQUFDO0FBQ2xCLENBQUM7QUFFRDs7Ozs7O0dBTUc7QUFDSCxNQUFNLFVBQVUsbUJBQW1CLENBQUMsRUFBNEI7SUFDOUQsV0FBVyxHQUFHLEVBQUUsQ0FBQztBQUNuQixDQUFDO0FBRUQ7Ozs7Ozs7R0FPRztBQUNILE1BQU0sVUFBVSxVQUFVLENBQUMsR0FBVztJQUNwQyxLQUFLLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDO0FBQ3BCLENBQUM7QUFFRDs7Ozs7OztHQU9HO0FBQ0gsTUFBTSxVQUFVLFlBQVksQ0FBQyxHQUFXO0lBQ3RDLE9BQU8sS0FBSyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsQ0FBQztBQUM1QixDQUFDIn0=

package/dest/log/index.d.ts

@@ -0,0 +1,4 @@
+export * from './console.js';
+export * from './debug.js';
+export * from './log_history.js';
+//# sourceMappingURL=index.d.ts.map

package/dest/log/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/log/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC"}

package/dest/log/index.js

@@ -0,0 +1,4 @@
+export * from './console.js';
+export * from './debug.js';
+export * from './log_history.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9nL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMsa0JBQWtCLENBQUMifQ==

package/dest/log/log_history.d.ts

@@ -0,0 +1,31 @@
+/**
+ * LogHistory is a utility class that provides the ability to store and manage debug logs.
+ * It can be enabled to record logs along with their timestamps, retrieve a specified number
+ * of recent logs, or clear stored logs based on a given count. This can be useful for debugging
+ * purposes, monitoring application activities, and maintaining log history.
+ */
+export declare class LogHistory {
+    private logs;
+    /**
+     * Enables the logging of debug messages with timestamps.
+     * Hooks into the pre-debug log and stores each log entry along with its timestamp in the logs array.
+     */
+    enable(): void;
+    /**
+     * Retrieves a specified number of logs from the end of the log history or all logs if no argument is provided.
+     * The logs are ordered chronologically, with the oldest logs at the beginning of the array.
+     *
+     * @param last - Optional number representing the amount of recent logs to return. Defaults to 0, which returns all logs.
+     * @returns An array of log arrays, each containing a timestamp and log arguments.
+     */
+    getLogs(last?: number): any[][];
+    /**
+     * Clear a specified number of logs from the beginning of the logs array.
+     * If no count is provided, it will clear all logs.
+     *
+     * @param count - The number of logs to be removed (default: total logs length).
+     */
+    clear(count?: number): void;
+}
+export declare const logHistory: LogHistory;
+//# sourceMappingURL=log_history.d.ts.map

package/dest/log/log_history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log_history.d.ts","sourceRoot":"","sources":["../../src/log/log_history.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAe;IAE3B;;;OAGG;IACI,MAAM;IAMb;;;;;;OAMG;IACI,OAAO,CAAC,IAAI,SAAI;IAIvB;;;;;OAKG;IACI,KAAK,CAAC,KAAK,SAAmB;CAGtC;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC"}