@metamask-previews/json-rpc-engine 10.5.0-preview-8bfa290fb → 11.0.0-preview-0a30e47

package/CHANGELOG.md

@@ -7,10 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [11.0.0]
+
 ### Changed
 
+- **BREAKING:** Drop CommonJS support ([#9536](https://github.com/MetaMask/core/pull/9536))
+  - This package is now ESM-only, but can still be used in CommonJS projects via `require(esm)` in modern Node.js versions (22+), or dynamic imports in older Node.js versions.
+- **BREAKING:** Bump minimum Node.js version to 22 ([#9976](https://github.com/MetaMask/core/pull/9976))
+- **BREAKING:** Bump TypeScript target to ES2022 ([#10019](https://github.com/MetaMask/core/pull/10019))
+  - This package now ships ES2022 code, requiring a compatible modern environment or bundler configuration to consume.
 - Bump `@metamask/utils` from `^11.9.0` to `^11.12.0` ([#9074](https://github.com/MetaMask/core/pull/9074), [#10076](https://github.com/MetaMask/core/pull/10076))
-- Bump `@metamask/messenger` from `^1.2.0` to `^2.0.0` ([#9392](https://github.com/MetaMask/core/pull/9392))
+- Bump `@metamask/messenger` from `^1.2.0` to `^3.0.0` ([#9392](https://github.com/MetaMask/core/pull/9392), [#10160](https://github.com/MetaMask/core/pull/10160))
 
 ## [10.5.0]
 
@@ -315,7 +322,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     This change may affect consumers that depend on the eager execution of middleware _during_ request processing, _outside of_ middleware functions and request handlers.
     - In general, it is a bad practice to work with state that depends on middleware execution, while the middleware are executing.
 
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/json-rpc-engine@10.5.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/json-rpc-engine@11.0.0...HEAD
+[11.0.0]: https://github.com/MetaMask/core/compare/@metamask/json-rpc-engine@10.5.0...@metamask/json-rpc-engine@11.0.0
 [10.5.0]: https://github.com/MetaMask/core/compare/@metamask/json-rpc-engine@10.4.0...@metamask/json-rpc-engine@10.5.0
 [10.4.0]: https://github.com/MetaMask/core/compare/@metamask/json-rpc-engine@10.3.0...@metamask/json-rpc-engine@10.4.0
 [10.3.0]: https://github.com/MetaMask/core/compare/@metamask/json-rpc-engine@10.2.4...@metamask/json-rpc-engine@10.3.0

package/dist/{JsonRpcEngine.d.mts → JsonRpcEngine.d.ts}

@@ -1,5 +1,5 @@
-import SafeEventEmitter from "@metamask/safe-event-emitter";
-import type { JsonRpcError as SerializedJsonRpcError, JsonRpcRequest, JsonRpcResponse, JsonRpcNotification, Json, JsonRpcParams, PendingJsonRpcResponse } from "@metamask/utils";
+import SafeEventEmitter from '@metamask/safe-event-emitter';
+import type { JsonRpcError as SerializedJsonRpcError, JsonRpcRequest, JsonRpcResponse, JsonRpcNotification, Json, JsonRpcParams, PendingJsonRpcResponse } from '@metamask/utils';
 export type JsonRpcEngineCallbackError = Error | SerializedJsonRpcError | null;
 /**
  * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.
@@ -129,4 +129,4 @@ export declare class JsonRpcEngine extends SafeEventEmitter {
     private _promiseHandle;
 }
 export {};
-//# sourceMappingURL=JsonRpcEngine.d.mts.map
+//# sourceMappingURL=JsonRpcEngine.d.ts.map

package/dist/JsonRpcEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonRpcEngine.d.ts","sourceRoot":"","sources":["../src/JsonRpcEngine.ts"],"names":[],"mappings":"AACA,OAAO,gBAAgB,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EACV,YAAY,IAAI,sBAAsB,EACtC,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,IAAI,EACJ,aAAa,EACb,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AASzB,MAAM,MAAM,0BAA0B,GAAG,KAAK,GAAG,sBAAsB,GAAG,IAAI,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACvC,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,KAC5B,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,qBAAqB,CAAC,EAAE,0BAA0B,KAC/C,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAC3B,MAAM,SAAS,aAAa,EAC5B,MAAM,SAAS,IAAI,IACjB;IACF,CACE,GAAG,EAAE,cAAc,CAAC,MAAM,CAAC,EAC3B,GAAG,EAAE,sBAAsB,CAAC,MAAM,CAAC,EACnC,IAAI,EAAE,yBAAyB,EAC/B,GAAG,EAAE,wBAAwB,GAC5B,IAAI,CAAC;IACR,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC,CAAC;AAKF;;GAEG;AACH,MAAM,MAAM,0BAA0B,CAAC,MAAM,SAAS,aAAa,IAAI,CACrE,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,KACtC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,KAAK,iBAAiB,GAAG;IACvB;;;;;;;;OAQG;IACH,mBAAmB,CAAC,EAAE,0BAA0B,CAAC,aAAa,CAAC,CAAC;CACjE,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,gBAAgB;;IAYjD;;;;;;;;;;OAUG;IACH,YAAY,EAAE,mBAAmB,EAAE,GAAE,iBAAsB,EAI1D;IAWD;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAgBd;IAED;;;;OAIG;IACH,IAAI,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EACpD,UAAU,EAAE,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5C,IAAI,CAGN;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EACtD,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,EAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,IAAI,GACpE,IAAI,CAAC;IAER;;;;;OAKG;IACH,MAAM,CAAC,MAAM,SAAS,aAAa,EACjC,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,EACzC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,KAAK,IAAI,GACjD,IAAI,CAAC;IAER;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EACtD,QAAQ,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,EAAE,EAClE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,GACvE,IAAI,CAAC;IAER;;;;;OAKG;IACH,MAAM,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EACtD,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAEpC;;;;OAIG;IACH,MAAM,CAAC,MAAM,SAAS,aAAa,EACjC,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EACtD,QAAQ,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,EAAE,GACjE,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAoCtC;;;;;OAKG;IACH,YAAY,IAAI,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,CA2BrD;IA2ED;;;;;OAKG;YAIW,cAAc;CAkS7B"}

package/dist/JsonRpcEngine.js

@@ -0,0 +1,386 @@
+var _a;
+import { errorCodes, JsonRpcError, serializeError } from '@metamask/rpc-errors';
+import SafeEventEmitter from '@metamask/safe-event-emitter';
+import { hasProperty, isJsonRpcNotification, isJsonRpcRequest, } from '@metamask/utils';
+import { stringify } from './v2/utils.js';
+const DESTROYED_ERROR_MESSAGE = 'This engine is destroyed and can no longer be used.';
+/**
+ * A JSON-RPC request and response processor.
+ *
+ * Give it a stack of middleware, pass it requests, and get back responses.
+ *
+ * @deprecated Use `JsonRpcEngineV2` instead.
+ */
+export class JsonRpcEngine extends SafeEventEmitter {
+    /**
+     * Indicating whether this engine is destroyed or not.
+     */
+    #isDestroyed = false;
+    #middleware;
+    #notificationHandler;
+    /**
+     * Constructs a {@link JsonRpcEngine} instance.
+     *
+     * @param options - Options bag.
+     * @param options.notificationHandler - A function for handling JSON-RPC
+     * notifications. A JSON-RPC notification is defined as a JSON-RPC request
+     * without an `id` property. If this option is _not_ provided, notifications
+     * will be treated the same as requests. If this option _is_ provided,
+     * notifications will be passed to the handler function without touching
+     * the engine's middleware stack. This function should not throw or reject.
+     */
+    constructor({ notificationHandler } = {}) {
+        super();
+        this.#middleware = [];
+        this.#notificationHandler = notificationHandler;
+    }
+    /**
+     * Throws an error if this engine is destroyed.
+     */
+    #assertIsNotDestroyed() {
+        if (this.#isDestroyed) {
+            throw new Error(DESTROYED_ERROR_MESSAGE);
+        }
+    }
+    /**
+     * Calls the `destroy()` function of any middleware with that property, clears
+     * the middleware array, and marks this engine as destroyed. A destroyed
+     * engine cannot be used.
+     */
+    destroy() {
+        this.#middleware.forEach((middleware) => {
+            if (
+            // `in` walks the prototype chain, which is probably the desired
+            // behavior here.
+            'destroy' in middleware &&
+                typeof middleware.destroy === 'function') {
+                // eslint-disable-next-line @typescript-eslint/no-floating-promises
+                middleware.destroy();
+            }
+        });
+        this.#middleware = [];
+        this.#isDestroyed = true;
+    }
+    /**
+     * Add a middleware function to the engine's middleware stack.
+     *
+     * @param middleware - The middleware function to add.
+     */
+    push(middleware) {
+        this.#assertIsNotDestroyed();
+        this.#middleware.push(middleware);
+    }
+    handle(req, callback) {
+        this.#assertIsNotDestroyed();
+        if (callback && typeof callback !== 'function') {
+            throw new Error('"callback" must be a function if provided.');
+        }
+        if (Array.isArray(req)) {
+            if (callback) {
+                return this.#handleBatch(req, 
+                // This assertion is safe because of the runtime checks validating that `req` is an array and `callback` is defined.
+                // There is only one overload signature that satisfies both conditions, and its `callback` type is the one that's being asserted.
+                callback);
+            }
+            return this.#handleBatch(req);
+        }
+        if (callback) {
+            return this.#handle(req, callback);
+        }
+        return this._promiseHandle(req);
+    }
+    /**
+     * Returns this engine as a middleware function that can be pushed to other
+     * engines.
+     *
+     * @returns This engine as a middleware function.
+     */
+    asMiddleware() {
+        this.#assertIsNotDestroyed();
+        // eslint-disable-next-line @typescript-eslint/no-misused-promises
+        return async (req, res, next, end) => {
+            try {
+                const [middlewareError, isComplete, returnHandlers] = await _a.#runAllMiddleware(req, res, this.#middleware);
+                if (isComplete) {
+                    await _a.#runReturnHandlers(returnHandlers);
+                    return end(middlewareError);
+                }
+                // eslint-disable-next-line @typescript-eslint/no-misused-promises
+                return next(async (handlerCallback) => {
+                    try {
+                        await _a.#runReturnHandlers(returnHandlers);
+                    }
+                    catch (error) {
+                        return handlerCallback(error);
+                    }
+                    return handlerCallback();
+                });
+            }
+            catch (error) {
+                return end(error);
+            }
+        };
+    }
+    /**
+     * Handles a batch of JSON-RPC requests, either in `async` or callback
+     * fashion.
+     *
+     * @param requests - The request objects to process.
+     * @param callback - The completion callback.
+     * @returns The array of responses, or nothing if a callback was specified.
+     */
+    async #handleBatch(requests, callback) {
+        // The order here is important
+        try {
+            // If the batch is an empty array, the response array must contain a single object
+            if (requests.length === 0) {
+                const response = [
+                    {
+                        id: null,
+                        jsonrpc: '2.0',
+                        error: new JsonRpcError(errorCodes.rpc.invalidRequest, 'Request batch must contain plain objects. Received an empty array'),
+                    },
+                ];
+                if (callback) {
+                    return callback(null, response);
+                }
+                return response;
+            }
+            // 2. Wait for all requests to finish, or throw on some kind of fatal
+            // error
+            const responses = (await Promise.all(
+            // 1. Begin executing each request in the order received
+            requests.map(this._promiseHandle.bind(this)))).filter(
+            // Filter out any notification responses.
+            (response) => response !== undefined);
+            // 3. Return batch response
+            if (callback) {
+                return callback(null, responses);
+            }
+            return responses;
+        }
+        catch (error) {
+            if (callback) {
+                return callback(error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * A promise-wrapped _handle.
+     *
+     * @param request - The JSON-RPC request.
+     * @returns The JSON-RPC response.
+     */
+    // This function is used in tests, so we cannot easily change it to use the
+    // hash syntax.
+    // eslint-disable-next-line no-restricted-syntax
+    async _promiseHandle(request) {
+        return new Promise((resolve, reject) => {
+            this.#handle(request, (error, res) => {
+                // For notifications, the response will be `undefined`, and any caught
+                // errors are unexpected and should be surfaced to the caller.
+                if (error && res === undefined) {
+                    // We are not going to change this behavior.
+                    // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
+                    reject(error);
+                }
+                else {
+                    // Excepting notifications, there will always be a response, and it will
+                    // always have any error that is caught and propagated.
+                    resolve(res);
+                }
+            }).catch(reject);
+        });
+    }
+    /**
+     * Ensures that the request / notification object is valid, processes it, and
+     * passes any error and response object to the given callback.
+     *
+     * Does not reject.
+     *
+     * @param callerReq - The request object from the caller.
+     * @param callback - The callback function.
+     * @returns Nothing.
+     */
+    async #handle(callerReq, callback) {
+        if (!callerReq ||
+            Array.isArray(callerReq) ||
+            typeof callerReq !== 'object') {
+            const error = new JsonRpcError(errorCodes.rpc.invalidRequest, `Requests must be plain objects. Received: ${typeof callerReq}`, { request: callerReq });
+            return callback(error, { id: null, jsonrpc: '2.0', error });
+        }
+        if (typeof callerReq.method !== 'string') {
+            const error = new JsonRpcError(errorCodes.rpc.invalidRequest, `Must specify a string method. Received: ${typeof callerReq.method}`, { request: callerReq });
+            if (this.#notificationHandler && !isJsonRpcRequest(callerReq)) {
+                // Do not reply to notifications, even if they are malformed.
+                return callback(null);
+            }
+            return callback(error, {
+                // Typecast: This could be a notification, but we want to access the
+                // `id` even if it doesn't exist.
+                id: callerReq.id ?? null,
+                jsonrpc: '2.0',
+                error,
+            });
+        }
+        else if (this.#notificationHandler &&
+            isJsonRpcNotification(callerReq) &&
+            !isJsonRpcRequest(callerReq)) {
+            try {
+                await this.#notificationHandler(callerReq);
+            }
+            catch (error) {
+                return callback(error);
+            }
+            return callback(null);
+        }
+        let error = null;
+        // Handle requests.
+        // Typecast: Permit missing id's for backwards compatibility.
+        const req = { ...callerReq };
+        const res = {
+            id: req.id,
+            jsonrpc: req.jsonrpc,
+        };
+        try {
+            await _a.#processRequest(req, res, this.#middleware);
+        }
+        catch (_error) {
+            // A request handler error, a re-thrown middleware error, or something
+            // unexpected.
+            error = _error;
+        }
+        if (error) {
+            // Ensure no result is present on an errored response
+            delete res.result;
+            res.error ??= serializeError(error);
+        }
+        return callback(error, res);
+    }
+    /**
+     * For the given request and response, runs all middleware and their return
+     * handlers, if any, and ensures that internal request processing semantics
+     * are satisfied.
+     *
+     * @param req - The request object.
+     * @param res - The response object.
+     * @param middlewares - The stack of middleware functions.
+     */
+    static async #processRequest(req, res, middlewares) {
+        const [error, isComplete, returnHandlers] = await _a.#runAllMiddleware(req, res, middlewares);
+        // Throw if "end" was not called, or if the response has neither a result
+        // nor an error.
+        _a.#checkForCompletion(req, res, isComplete);
+        // The return handlers should run even if an error was encountered during
+        // middleware processing.
+        await _a.#runReturnHandlers(returnHandlers);
+        // Now we re-throw the middleware processing error, if any, to catch it
+        // further up the call chain.
+        if (error) {
+            // eslint-disable-next-line @typescript-eslint/only-throw-error
+            throw error;
+        }
+    }
+    /**
+     * Serially executes the given stack of middleware.
+     *
+     * @param req - The request object.
+     * @param res - The response object.
+     * @param middlewares - The stack of middleware functions to execute.
+     * @returns An array of any error encountered during middleware execution,
+     * a boolean indicating whether the request was completed, and an array of
+     * middleware-defined return handlers.
+     */
+    static async #runAllMiddleware(req, res, middlewares) {
+        const returnHandlers = [];
+        let error = null;
+        let isComplete = false;
+        // Go down stack of middleware, call and collect optional returnHandlers
+        for (const middleware of middlewares) {
+            [error, isComplete] = await _a.#runMiddleware(req, res, middleware, returnHandlers);
+            if (isComplete) {
+                break;
+            }
+        }
+        return [error, isComplete, returnHandlers.reverse()];
+    }
+    /**
+     * Runs an individual middleware function.
+     *
+     * @param request - The request object.
+     * @param response - The response object.
+     * @param middleware - The middleware function to execute.
+     * @param returnHandlers - The return handlers array for the current request.
+     * @returns An array of any error encountered during middleware execution,
+     * and a boolean indicating whether the request should end.
+     */
+    static async #runMiddleware(request, response, middleware, returnHandlers) {
+        return new Promise((resolve) => {
+            const end = (error) => {
+                const parsedError = error ?? response.error;
+                if (parsedError) {
+                    response.error = serializeError(parsedError);
+                }
+                // True indicates that the request should end
+                resolve([parsedError, true]);
+            };
+            const next = (returnHandler) => {
+                if (response.error) {
+                    end(response.error);
+                }
+                else {
+                    if (returnHandler) {
+                        if (typeof returnHandler !== 'function') {
+                            end(new JsonRpcError(errorCodes.rpc.internal, `JsonRpcEngine: "next" return handlers must be functions. ` +
+                                `Received "${typeof returnHandler}" for request:\n${stringify(request)}`, { request }));
+                        }
+                        returnHandlers.push(returnHandler);
+                    }
+                    // False indicates that the request should not end
+                    resolve([null, false]);
+                }
+            };
+            try {
+                middleware(request, response, next, end);
+            }
+            catch (error) {
+                end(error);
+            }
+        });
+    }
+    /**
+     * Serially executes array of return handlers. The request and response are
+     * assumed to be in their scope.
+     *
+     * @param handlers - The return handlers to execute.
+     */
+    static async #runReturnHandlers(handlers) {
+        for (const handler of handlers) {
+            await new Promise((resolve, reject) => {
+                // We are not going to change this behavior.
+                // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
+                handler((error) => (error ? reject(error) : resolve()));
+            });
+        }
+    }
+    /**
+     * Throws an error if the response has neither a result nor an error, or if
+     * the "isComplete" flag is falsy.
+     *
+     * @param request - The request object.
+     * @param response - The response object.
+     * @param isComplete - Boolean from {@link JsonRpcEngine.#runAllMiddleware}
+     * indicating whether a middleware ended the request.
+     */
+    static #checkForCompletion(request, response, isComplete) {
+        if (!hasProperty(response, 'result') && !hasProperty(response, 'error')) {
+            throw new JsonRpcError(errorCodes.rpc.internal, `JsonRpcEngine: Response has no error or result for request:\n${stringify(request)}`, { request });
+        }
+        if (!isComplete) {
+            throw new JsonRpcError(errorCodes.rpc.internal, `JsonRpcEngine: Nothing ended request:\n${stringify(request)}`, { request });
+        }
+    }
+}
+_a = JsonRpcEngine;
+//# sourceMappingURL=JsonRpcEngine.js.map

package/dist/JsonRpcEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonRpcEngine.js","sourceRoot":"","sources":["../src/JsonRpcEngine.ts"],"names":[],"mappings":"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","sourcesContent":["import { errorCodes, JsonRpcError, serializeError } from '@metamask/rpc-errors';\nimport SafeEventEmitter from '@metamask/safe-event-emitter';\nimport type {\n  JsonRpcError as SerializedJsonRpcError,\n  JsonRpcRequest,\n  JsonRpcResponse,\n  JsonRpcNotification,\n  Json,\n  JsonRpcParams,\n  PendingJsonRpcResponse,\n} from '@metamask/utils';\nimport {\n  hasProperty,\n  isJsonRpcNotification,\n  isJsonRpcRequest,\n} from '@metamask/utils';\n\nimport { stringify } from './v2/utils.js';\n\nexport type JsonRpcEngineCallbackError = Error | SerializedJsonRpcError | null;\n\n/**\n * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.\n */\nexport type JsonRpcEngineReturnHandler = (\n  done: (error?: unknown) => void,\n) => void;\n\n/**\n * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.\n */\nexport type JsonRpcEngineNextCallback = (\n  returnHandlerCallback?: JsonRpcEngineReturnHandler,\n) => void;\n\n/**\n * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.\n */\nexport type JsonRpcEngineEndCallback = (error?: unknown) => void;\n\n/**\n * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.\n */\nexport type JsonRpcMiddleware<\n  Params extends JsonRpcParams,\n  Result extends Json,\n> = {\n  (\n    req: JsonRpcRequest<Params>,\n    res: PendingJsonRpcResponse<Result>,\n    next: JsonRpcEngineNextCallback,\n    end: JsonRpcEngineEndCallback,\n  ): void;\n  destroy?: () => void | Promise<void>;\n};\n\nconst DESTROYED_ERROR_MESSAGE =\n  'This engine is destroyed and can no longer be used.';\n\n/**\n * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.\n */\nexport type JsonRpcNotificationHandler<Params extends JsonRpcParams> = (\n  notification: JsonRpcNotification<Params>,\n) => void | Promise<void>;\n\ntype JsonRpcEngineArgs = {\n  /**\n   * A function for handling JSON-RPC notifications. A JSON-RPC notification is\n   * defined as a JSON-RPC request without an `id` property. If this option is\n   * _not_ provided, notifications will be treated the same as requests. If this\n   * option _is_ provided, notifications will be passed to the handler\n   * function without touching the engine's middleware stack.\n   *\n   * This function should not throw or reject.\n   */\n  notificationHandler?: JsonRpcNotificationHandler<JsonRpcParams>;\n};\n\n/**\n * A JSON-RPC request and response processor.\n *\n * Give it a stack of middleware, pass it requests, and get back responses.\n *\n * @deprecated Use `JsonRpcEngineV2` instead.\n */\nexport class JsonRpcEngine extends SafeEventEmitter {\n  /**\n   * Indicating whether this engine is destroyed or not.\n   */\n  #isDestroyed = false;\n\n  #middleware: JsonRpcMiddleware<JsonRpcParams, Json>[];\n\n  readonly #notificationHandler?:\n    | JsonRpcNotificationHandler<JsonRpcParams>\n    | undefined;\n\n  /**\n   * Constructs a {@link JsonRpcEngine} instance.\n   *\n   * @param options - Options bag.\n   * @param options.notificationHandler - A function for handling JSON-RPC\n   * notifications. A JSON-RPC notification is defined as a JSON-RPC request\n   * without an `id` property. If this option is _not_ provided, notifications\n   * will be treated the same as requests. If this option _is_ provided,\n   * notifications will be passed to the handler function without touching\n   * the engine's middleware stack. This function should not throw or reject.\n   */\n  constructor({ notificationHandler }: JsonRpcEngineArgs = {}) {\n    super();\n    this.#middleware = [];\n    this.#notificationHandler = notificationHandler;\n  }\n\n  /**\n   * Throws an error if this engine is destroyed.\n   */\n  #assertIsNotDestroyed(): void {\n    if (this.#isDestroyed) {\n      throw new Error(DESTROYED_ERROR_MESSAGE);\n    }\n  }\n\n  /**\n   * Calls the `destroy()` function of any middleware with that property, clears\n   * the middleware array, and marks this engine as destroyed. A destroyed\n   * engine cannot be used.\n   */\n  destroy(): void {\n    this.#middleware.forEach(\n      (middleware: JsonRpcMiddleware<JsonRpcParams, Json>) => {\n        if (\n          // `in` walks the prototype chain, which is probably the desired\n          // behavior here.\n          'destroy' in middleware &&\n          typeof middleware.destroy === 'function'\n        ) {\n          // eslint-disable-next-line @typescript-eslint/no-floating-promises\n          middleware.destroy();\n        }\n      },\n    );\n    this.#middleware = [];\n    this.#isDestroyed = true;\n  }\n\n  /**\n   * Add a middleware function to the engine's middleware stack.\n   *\n   * @param middleware - The middleware function to add.\n   */\n  push<Params extends JsonRpcParams, Result extends Json>(\n    middleware: JsonRpcMiddleware<Params, Result>,\n  ): void {\n    this.#assertIsNotDestroyed();\n    this.#middleware.push(middleware as JsonRpcMiddleware<JsonRpcParams, Json>);\n  }\n\n  /**\n   * Handle a JSON-RPC request, and return a response.\n   *\n   * @param request - The request to handle.\n   * @param callback - An error-first callback that will receive the response.\n   */\n  handle<Params extends JsonRpcParams, Result extends Json>(\n    request: JsonRpcRequest<Params>,\n    callback: (error: unknown, response: JsonRpcResponse<Result>) => void,\n  ): void;\n\n  /**\n   * Handle a JSON-RPC notification.\n   *\n   * @param notification - The notification to handle.\n   * @param callback - An error-first callback that will receive a `void` response.\n   */\n  handle<Params extends JsonRpcParams>(\n    notification: JsonRpcNotification<Params>,\n    callback: (error: unknown, response: void) => void,\n  ): void;\n\n  /**\n   * Handle an array of JSON-RPC requests and/or notifications, and return an\n   * array of responses to any included requests.\n   *\n   * @param request - The requests to handle.\n   * @param callback - An error-first callback that will receive the array of\n   * responses.\n   */\n  handle<Params extends JsonRpcParams, Result extends Json>(\n    requests: (JsonRpcRequest<Params> | JsonRpcNotification<Params>)[],\n    callback: (error: unknown, responses: JsonRpcResponse<Result>[]) => void,\n  ): void;\n\n  /**\n   * Handle a JSON-RPC request, and return a response.\n   *\n   * @param request - The JSON-RPC request to handle.\n   * @returns The JSON-RPC response.\n   */\n  handle<Params extends JsonRpcParams, Result extends Json>(\n    request: JsonRpcRequest<Params>,\n  ): Promise<JsonRpcResponse<Result>>;\n\n  /**\n   * Handle a JSON-RPC notification.\n   *\n   * @param notification - The notification to handle.\n   */\n  handle<Params extends JsonRpcParams>(\n    notification: JsonRpcNotification<Params>,\n  ): Promise<void>;\n\n  /**\n   * Handle an array of JSON-RPC requests and/or notifications, and return an\n   * array of responses to any included requests.\n   *\n   * @param request - The JSON-RPC requests to handle.\n   * @returns An array of JSON-RPC responses.\n   */\n  handle<Params extends JsonRpcParams, Result extends Json>(\n    requests: (JsonRpcRequest<Params> | JsonRpcNotification<Params>)[],\n  ): Promise<JsonRpcResponse<Result>[]>;\n\n  handle(\n    req:\n      | (JsonRpcRequest | JsonRpcNotification)[]\n      | JsonRpcRequest\n      | JsonRpcNotification,\n    callback?: (error: unknown, response: never) => void,\n  ): Promise<JsonRpcResponse[]> | Promise<JsonRpcResponse | void> {\n    this.#assertIsNotDestroyed();\n\n    if (callback && typeof callback !== 'function') {\n      throw new Error('\"callback\" must be a function if provided.');\n    }\n\n    if (Array.isArray(req)) {\n      if (callback) {\n        return this.#handleBatch(\n          req,\n          // This assertion is safe because of the runtime checks validating that `req` is an array and `callback` is defined.\n          // There is only one overload signature that satisfies both conditions, and its `callback` type is the one that's being asserted.\n          callback as (error: unknown, responses?: JsonRpcResponse[]) => void,\n        );\n      }\n      return this.#handleBatch(req);\n    }\n\n    if (callback) {\n      return this.#handle(\n        req,\n        callback as (error: unknown, response?: JsonRpcResponse) => void,\n      );\n    }\n    return this._promiseHandle(req);\n  }\n\n  /**\n   * Returns this engine as a middleware function that can be pushed to other\n   * engines.\n   *\n   * @returns This engine as a middleware function.\n   */\n  asMiddleware(): JsonRpcMiddleware<JsonRpcParams, Json> {\n    this.#assertIsNotDestroyed();\n\n    // eslint-disable-next-line @typescript-eslint/no-misused-promises\n    return async (req, res, next, end) => {\n      try {\n        const [middlewareError, isComplete, returnHandlers] =\n          await JsonRpcEngine.#runAllMiddleware(req, res, this.#middleware);\n\n        if (isComplete) {\n          await JsonRpcEngine.#runReturnHandlers(returnHandlers);\n          return end(middlewareError);\n        }\n\n        // eslint-disable-next-line @typescript-eslint/no-misused-promises\n        return next(async (handlerCallback) => {\n          try {\n            await JsonRpcEngine.#runReturnHandlers(returnHandlers);\n          } catch (error) {\n            return handlerCallback(error);\n          }\n          return handlerCallback();\n        });\n      } catch (error) {\n        return end(error);\n      }\n    };\n  }\n\n  /**\n   * Like _handle, but for batch requests.\n   */\n  #handleBatch(\n    reqs: (JsonRpcRequest | JsonRpcNotification)[],\n  ): Promise<JsonRpcResponse[]>;\n\n  /**\n   * Like _handle, but for batch requests.\n   */\n  #handleBatch(\n    reqs: (JsonRpcRequest | JsonRpcNotification)[],\n    callback: (error: unknown, responses?: JsonRpcResponse[]) => void,\n  ): Promise<void>;\n\n  /**\n   * Handles a batch of JSON-RPC requests, either in `async` or callback\n   * fashion.\n   *\n   * @param requests - The request objects to process.\n   * @param callback - The completion callback.\n   * @returns The array of responses, or nothing if a callback was specified.\n   */\n  async #handleBatch(\n    requests: (JsonRpcRequest | JsonRpcNotification)[],\n    callback?: (error: unknown, responses?: JsonRpcResponse[]) => void,\n  ): Promise<JsonRpcResponse[] | void> {\n    // The order here is important\n    try {\n      // If the batch is an empty array, the response array must contain a single object\n      if (requests.length === 0) {\n        const response: JsonRpcResponse[] = [\n          {\n            id: null,\n            jsonrpc: '2.0',\n            error: new JsonRpcError(\n              errorCodes.rpc.invalidRequest,\n              'Request batch must contain plain objects. Received an empty array',\n            ),\n          },\n        ];\n        if (callback) {\n          return callback(null, response);\n        }\n        return response;\n      }\n\n      // 2. Wait for all requests to finish, or throw on some kind of fatal\n      // error\n      const responses = (\n        await Promise.all(\n          // 1. Begin executing each request in the order received\n          requests.map(this._promiseHandle.bind(this)),\n        )\n      ).filter(\n        // Filter out any notification responses.\n        (response): response is JsonRpcResponse => response !== undefined,\n      );\n\n      // 3. Return batch response\n      if (callback) {\n        return callback(null, responses);\n      }\n      return responses;\n    } catch (error) {\n      if (callback) {\n        return callback(error);\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * A promise-wrapped _handle.\n   *\n   * @param request - The JSON-RPC request.\n   * @returns The JSON-RPC response.\n   */\n  // This function is used in tests, so we cannot easily change it to use the\n  // hash syntax.\n  // eslint-disable-next-line no-restricted-syntax\n  private async _promiseHandle(\n    request: JsonRpcRequest | JsonRpcNotification,\n  ): Promise<JsonRpcResponse | void> {\n    return new Promise((resolve, reject) => {\n      this.#handle(request, (error, res) => {\n        // For notifications, the response will be `undefined`, and any caught\n        // errors are unexpected and should be surfaced to the caller.\n        if (error && res === undefined) {\n          // We are not going to change this behavior.\n          // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors\n          reject(error);\n        } else {\n          // Excepting notifications, there will always be a response, and it will\n          // always have any error that is caught and propagated.\n          resolve(res);\n        }\n      }).catch(reject);\n    });\n  }\n\n  /**\n   * Ensures that the request / notification object is valid, processes it, and\n   * passes any error and response object to the given callback.\n   *\n   * Does not reject.\n   *\n   * @param callerReq - The request object from the caller.\n   * @param callback - The callback function.\n   * @returns Nothing.\n   */\n  async #handle(\n    callerReq: JsonRpcRequest | JsonRpcNotification,\n    callback: (error: unknown, response?: JsonRpcResponse) => void,\n  ): Promise<void> {\n    if (\n      !callerReq ||\n      Array.isArray(callerReq) ||\n      typeof callerReq !== 'object'\n    ) {\n      const error = new JsonRpcError(\n        errorCodes.rpc.invalidRequest,\n        `Requests must be plain objects. Received: ${typeof callerReq}`,\n        { request: callerReq },\n      );\n      return callback(error, { id: null, jsonrpc: '2.0', error });\n    }\n\n    if (typeof callerReq.method !== 'string') {\n      const error = new JsonRpcError(\n        errorCodes.rpc.invalidRequest,\n        `Must specify a string method. Received: ${typeof callerReq.method}`,\n        { request: callerReq },\n      );\n\n      if (this.#notificationHandler && !isJsonRpcRequest(callerReq)) {\n        // Do not reply to notifications, even if they are malformed.\n        return callback(null);\n      }\n\n      return callback(error, {\n        // Typecast: This could be a notification, but we want to access the\n        // `id` even if it doesn't exist.\n        id: (callerReq as JsonRpcRequest).id ?? null,\n        jsonrpc: '2.0',\n        error,\n      });\n    } else if (\n      this.#notificationHandler &&\n      isJsonRpcNotification(callerReq) &&\n      !isJsonRpcRequest(callerReq)\n    ) {\n      try {\n        await this.#notificationHandler(callerReq);\n      } catch (error) {\n        return callback(error);\n      }\n      return callback(null);\n    }\n    let error = null;\n\n    // Handle requests.\n    // Typecast: Permit missing id's for backwards compatibility.\n    const req = { ...(callerReq as JsonRpcRequest) };\n    const res: PendingJsonRpcResponse = {\n      id: req.id,\n      jsonrpc: req.jsonrpc,\n    };\n\n    try {\n      await JsonRpcEngine.#processRequest(req, res, this.#middleware);\n    } catch (_error) {\n      // A request handler error, a re-thrown middleware error, or something\n      // unexpected.\n      error = _error;\n    }\n\n    if (error) {\n      // Ensure no result is present on an errored response\n      delete res.result;\n      res.error ??= serializeError(error);\n    }\n\n    return callback(error, res as JsonRpcResponse);\n  }\n\n  /**\n   * For the given request and response, runs all middleware and their return\n   * handlers, if any, and ensures that internal request processing semantics\n   * are satisfied.\n   *\n   * @param req - The request object.\n   * @param res - The response object.\n   * @param middlewares - The stack of middleware functions.\n   */\n  static async #processRequest(\n    req: JsonRpcRequest,\n    res: PendingJsonRpcResponse,\n    middlewares: JsonRpcMiddleware<JsonRpcParams, Json>[],\n  ): Promise<void> {\n    const [error, isComplete, returnHandlers] =\n      await JsonRpcEngine.#runAllMiddleware(req, res, middlewares);\n\n    // Throw if \"end\" was not called, or if the response has neither a result\n    // nor an error.\n    JsonRpcEngine.#checkForCompletion(req, res, isComplete);\n\n    // The return handlers should run even if an error was encountered during\n    // middleware processing.\n    await JsonRpcEngine.#runReturnHandlers(returnHandlers);\n\n    // Now we re-throw the middleware processing error, if any, to catch it\n    // further up the call chain.\n    if (error) {\n      // eslint-disable-next-line @typescript-eslint/only-throw-error\n      throw error;\n    }\n  }\n\n  /**\n   * Serially executes the given stack of middleware.\n   *\n   * @param req - The request object.\n   * @param res - The response object.\n   * @param middlewares - The stack of middleware functions to execute.\n   * @returns An array of any error encountered during middleware execution,\n   * a boolean indicating whether the request was completed, and an array of\n   * middleware-defined return handlers.\n   */\n  static async #runAllMiddleware(\n    req: JsonRpcRequest,\n    res: PendingJsonRpcResponse,\n    middlewares: JsonRpcMiddleware<JsonRpcParams, Json>[],\n  ): Promise<\n    [\n      unknown, // error\n      boolean, // isComplete\n      JsonRpcEngineReturnHandler[],\n    ]\n  > {\n    const returnHandlers: JsonRpcEngineReturnHandler[] = [];\n    let error = null;\n    let isComplete = false;\n\n    // Go down stack of middleware, call and collect optional returnHandlers\n    for (const middleware of middlewares) {\n      [error, isComplete] = await JsonRpcEngine.#runMiddleware(\n        req,\n        res,\n        middleware,\n        returnHandlers,\n      );\n\n      if (isComplete) {\n        break;\n      }\n    }\n    return [error, isComplete, returnHandlers.reverse()];\n  }\n\n  /**\n   * Runs an individual middleware function.\n   *\n   * @param request - The request object.\n   * @param response - The response object.\n   * @param middleware - The middleware function to execute.\n   * @param returnHandlers - The return handlers array for the current request.\n   * @returns An array of any error encountered during middleware execution,\n   * and a boolean indicating whether the request should end.\n   */\n  static async #runMiddleware(\n    request: JsonRpcRequest,\n    response: PendingJsonRpcResponse,\n    middleware: JsonRpcMiddleware<JsonRpcParams, Json>,\n    returnHandlers: JsonRpcEngineReturnHandler[],\n  ): Promise<[unknown, boolean]> {\n    return new Promise((resolve) => {\n      const end: JsonRpcEngineEndCallback = (error) => {\n        const parsedError = error ?? response.error;\n        if (parsedError) {\n          response.error = serializeError(parsedError);\n        }\n        // True indicates that the request should end\n        resolve([parsedError, true]);\n      };\n\n      const next: JsonRpcEngineNextCallback = (\n        returnHandler?: JsonRpcEngineReturnHandler,\n      ) => {\n        if (response.error) {\n          end(response.error);\n        } else {\n          if (returnHandler) {\n            if (typeof returnHandler !== 'function') {\n              end(\n                new JsonRpcError(\n                  errorCodes.rpc.internal,\n                  `JsonRpcEngine: \"next\" return handlers must be functions. ` +\n                    `Received \"${typeof returnHandler}\" for request:\\n${stringify(\n                      request,\n                    )}`,\n                  { request },\n                ),\n              );\n            }\n            returnHandlers.push(returnHandler);\n          }\n\n          // False indicates that the request should not end\n          resolve([null, false]);\n        }\n      };\n\n      try {\n        middleware(request, response, next, end);\n      } catch (error) {\n        end(error);\n      }\n    });\n  }\n\n  /**\n   * Serially executes array of return handlers. The request and response are\n   * assumed to be in their scope.\n   *\n   * @param handlers - The return handlers to execute.\n   */\n  static async #runReturnHandlers(\n    handlers: JsonRpcEngineReturnHandler[],\n  ): Promise<void> {\n    for (const handler of handlers) {\n      await new Promise<void>((resolve, reject) => {\n        // We are not going to change this behavior.\n        // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors\n        handler((error) => (error ? reject(error) : resolve()));\n      });\n    }\n  }\n\n  /**\n   * Throws an error if the response has neither a result nor an error, or if\n   * the \"isComplete\" flag is falsy.\n   *\n   * @param request - The request object.\n   * @param response - The response object.\n   * @param isComplete - Boolean from {@link JsonRpcEngine.#runAllMiddleware}\n   * indicating whether a middleware ended the request.\n   */\n  static #checkForCompletion(\n    request: JsonRpcRequest,\n    response: PendingJsonRpcResponse,\n    isComplete: boolean,\n  ): void {\n    if (!hasProperty(response, 'result') && !hasProperty(response, 'error')) {\n      throw new JsonRpcError(\n        errorCodes.rpc.internal,\n        `JsonRpcEngine: Response has no error or result for request:\\n${stringify(\n          request,\n        )}`,\n        { request },\n      );\n    }\n\n    if (!isComplete) {\n      throw new JsonRpcError(\n        errorCodes.rpc.internal,\n        `JsonRpcEngine: Nothing ended request:\\n${stringify(request)}`,\n        { request },\n      );\n    }\n  }\n}\n"]}

package/dist/{asV2Middleware.d.cts → asV2Middleware.d.ts}

@@ -1,8 +1,8 @@
-import type { JsonRpcParams, JsonRpcRequest } from "@metamask/utils";
-import type { JsonRpcEngine } from "./JsonRpcEngine.cjs";
-import type { JsonRpcMiddleware as LegacyMiddleware } from "./JsonRpcEngine.cjs";
-import type { ContextConstraint, MiddlewareContext } from "./v2/index.cjs";
-import type { JsonRpcMiddleware, ResultConstraint } from "./v2/JsonRpcEngineV2.cjs";
+import type { JsonRpcParams, JsonRpcRequest } from '@metamask/utils';
+import type { JsonRpcEngine } from './JsonRpcEngine.js';
+import type { JsonRpcMiddleware as LegacyMiddleware } from './JsonRpcEngine.js';
+import type { ContextConstraint, MiddlewareContext } from './v2/index.js';
+import type { JsonRpcMiddleware, ResultConstraint } from './v2/JsonRpcEngineV2.js';
 /**
  * Convert a legacy {@link JsonRpcEngine} into a {@link JsonRpcEngineV2} middleware.
  *
@@ -17,4 +17,4 @@ export declare function asV2Middleware<Params extends JsonRpcParams, Request ext
  * @returns The {@link JsonRpcEngineV2} middleware.
  */
 export declare function asV2Middleware<Params extends JsonRpcParams = JsonRpcParams, Request extends JsonRpcRequest<Params> = JsonRpcRequest<Params>, Result extends ResultConstraint<Request> = ResultConstraint<Request>, Context extends ContextConstraint = MiddlewareContext>(...middleware: LegacyMiddleware<Params, Result>[]): JsonRpcMiddleware<Request, Result, Context>;
-//# sourceMappingURL=asV2Middleware.d.cts.map
+//# sourceMappingURL=asV2Middleware.d.ts.map

package/dist/asV2Middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asV2Middleware.d.ts","sourceRoot":"","sources":["../src/asV2Middleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,aAAa,EACb,cAAc,EAEf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EACV,aAAa,EAGd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAShF,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,KAAK,EAIV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAEjC;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,SAAS,aAAa,EAC5B,OAAO,SAAS,cAAc,CAAC,MAAM,CAAC,EACtC,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAErD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,SAAS,aAAa,GAAG,aAAa,EAC5C,OAAO,SAAS,cAAc,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,EAC/D,MAAM,SAAS,gBAAgB,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,EACpE,OAAO,SAAS,iBAAiB,GAAG,iBAAiB,EAErD,GAAG,UAAU,EAAE,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAChD,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/{asV2Middleware.mjs → asV2Middleware.js}

@@ -1,7 +1,7 @@
-import { serializeError } from "@metamask/rpc-errors";
-import { hasProperty } from "@metamask/utils";
-import { mergeMiddleware } from "./mergeMiddleware.mjs";
-import { deepClone, fromLegacyRequest, propagateToContext, propagateToRequest, deserializeError } from "./v2/compatibility-utils.mjs";
+import { serializeError } from '@metamask/rpc-errors';
+import { hasProperty } from '@metamask/utils';
+import { mergeMiddleware } from './mergeMiddleware.js';
+import { deepClone, fromLegacyRequest, propagateToContext, propagateToRequest, deserializeError, } from './v2/compatibility-utils.js';
 /**
  * The asV2Middleware implementation.
  *
@@ -50,4 +50,4 @@ export function asV2Middleware(engineOrMiddleware, ...rest) {
         return next(fromLegacyRequest(req));
     };
 }
-//# sourceMappingURL=asV2Middleware.mjs.map
+//# sourceMappingURL=asV2Middleware.js.map

package/dist/asV2Middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asV2Middleware.js","sourceRoot":"","sources":["../src/asV2Middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAe9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAoCrC;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAI5B,kBAAyE,EACzE,GAAG,IAA6C;IAEhD,MAAM,gBAAgB,GACpB,OAAO,kBAAkB,KAAK,UAAU;QACtC,CAAC,CAAC,wFAAwF;YACxF,6BAA6B;YAC7B,eAAe,CAAC,CAAC,kBAAkB,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC,kBAAkB,CAAC,YAAY,EAAE,CAAC;IAExC,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAA2B,CAAC;QACzD,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEjC,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAkB,CAAC,OAAO,EAAE,EAAE;YAC9D,gEAAgE;YAChE,cAAc;YACd,MAAM,GAAG,GAAG;gBACV,OAAO,EAAE,KAAc;gBACvB,EAAE,EAAE,GAAG,CAAC,EAAE;aACQ,CAAC;YAErB,MAAM,GAAG,GAA6B,CAAC,KAAK,EAAE,EAAE;gBAC9C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACvB,GAAsB,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;gBACxD,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,CAAC;YACf,CAAC,CAAC;YAEF,uEAAuE;YACvE,kEAAkE;YAClE,aAAa;YACb,MAAM,UAAU,GAAG,CAAC,CAAC,QAAkC,EAAE,EAAE,CACzD,QAAQ,CAAC,GAAG,CAAC,CAA8B,CAAC;YAE9C,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QACH,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEjC,4FAA4F;QAC5F,+FAA+F;QAC/F,oGAAoG;QACpG,IAAI,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACrD,MAAM,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC3C,OAAO,QAAQ,CAAC,MAAmC,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAc,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { serializeError } from '@metamask/rpc-errors';\nimport { hasProperty } from '@metamask/utils';\nimport type {\n  Json,\n  JsonRpcFailure,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from '@metamask/utils';\n\nimport type {\n  JsonRpcEngine,\n  JsonRpcEngineEndCallback,\n  JsonRpcEngineNextCallback,\n} from './JsonRpcEngine.js';\nimport type { JsonRpcMiddleware as LegacyMiddleware } from './JsonRpcEngine.js';\nimport { mergeMiddleware } from './mergeMiddleware.js';\nimport {\n  deepClone,\n  fromLegacyRequest,\n  propagateToContext,\n  propagateToRequest,\n  deserializeError,\n} from './v2/compatibility-utils.js';\nimport type { ContextConstraint, MiddlewareContext } from './v2/index.js';\nimport type {\n  // Used in docs.\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  JsonRpcEngineV2,\n  JsonRpcMiddleware,\n  ResultConstraint,\n} from './v2/JsonRpcEngineV2.js';\n\n/**\n * Convert a legacy {@link JsonRpcEngine} into a {@link JsonRpcEngineV2} middleware.\n *\n * @param engine - The legacy engine to convert.\n * @returns The {@link JsonRpcEngineV2} middleware.\n */\nexport function asV2Middleware<\n  Params extends JsonRpcParams,\n  Request extends JsonRpcRequest<Params>,\n>(engine: JsonRpcEngine): JsonRpcMiddleware<Request>;\n\n/**\n * Convert one or more legacy middleware into a {@link JsonRpcEngineV2} middleware.\n *\n * @param middleware - The legacy middleware to convert.\n * @returns The {@link JsonRpcEngineV2} middleware.\n */\nexport function asV2Middleware<\n  Params extends JsonRpcParams = JsonRpcParams,\n  Request extends JsonRpcRequest<Params> = JsonRpcRequest<Params>,\n  Result extends ResultConstraint<Request> = ResultConstraint<Request>,\n  Context extends ContextConstraint = MiddlewareContext,\n>(\n  ...middleware: LegacyMiddleware<Params, Result>[]\n): JsonRpcMiddleware<Request, Result, Context>;\n\n/**\n * The asV2Middleware implementation.\n *\n * @param engineOrMiddleware - A legacy engine or legacy middleware.\n * @param rest - Any additional legacy middleware when the first argument is a middleware.\n * @returns The {@link JsonRpcEngineV2} middleware.\n */\nexport function asV2Middleware<\n  Params extends JsonRpcParams,\n  Request extends JsonRpcRequest<Params>,\n>(\n  engineOrMiddleware: JsonRpcEngine | LegacyMiddleware<JsonRpcParams, Json>,\n  ...rest: LegacyMiddleware<JsonRpcParams, Json>[]\n): JsonRpcMiddleware<Request> {\n  const legacyMiddleware =\n    typeof engineOrMiddleware === 'function'\n      ? // mergeMiddleware uses .asMiddleware() internally, which is necessary for our purposes.\n        // See comment on this below.\n        mergeMiddleware([engineOrMiddleware, ...rest])\n      : engineOrMiddleware.asMiddleware();\n\n  return async ({ request, context, next }) => {\n    const req = deepClone(request) as JsonRpcRequest<Params>;\n    propagateToRequest(req, context);\n\n    const response = await new Promise<JsonRpcResponse>((resolve) => {\n      // The result or error property will be set by the legacy engine\n      // middleware.\n      const res = {\n        jsonrpc: '2.0' as const,\n        id: req.id,\n      } as JsonRpcResponse;\n\n      const end: JsonRpcEngineEndCallback = (error) => {\n        if (error !== undefined) {\n          (res as JsonRpcFailure).error = serializeError(error);\n        }\n        resolve(res);\n      };\n\n      // We know from the implementation of JsonRpcEngine.asMiddleware() that\n      // legacyNext will always be passed a callback, so cb can never be\n      // undefined.\n      const legacyNext = ((callback: JsonRpcEngineEndCallback) =>\n        callback(end)) as JsonRpcEngineNextCallback;\n\n      legacyMiddleware(req, res, legacyNext, end);\n    });\n    propagateToContext(req, context);\n\n    // Mimic the behavior of JsonRpcEngine.#handle(), which only treats truthy errors as errors.\n    // Legacy middleware may violate the invariant that response objects have either a result or an\n    // error property. In practice, we may see response objects with results and `{ error: undefined }`.\n    if (hasProperty(response, 'error') && response.error) {\n      throw deserializeError(response.error);\n    } else if (hasProperty(response, 'result')) {\n      return response.result as ResultConstraint<Request>;\n    }\n    return next(fromLegacyRequest(req as Request));\n  };\n}\n"]}

package/dist/{createAsyncMiddleware.d.mts → createAsyncMiddleware.d.ts}

@@ -1,5 +1,5 @@
-import type { Json, JsonRpcParams, JsonRpcRequest, PendingJsonRpcResponse } from "@metamask/utils";
-import type { JsonRpcMiddleware } from "./JsonRpcEngine.mjs";
+import type { Json, JsonRpcParams, JsonRpcRequest, PendingJsonRpcResponse } from '@metamask/utils';
+import type { JsonRpcMiddleware } from './JsonRpcEngine.js';
 export type AsyncJsonRpcEngineNextCallback = () => Promise<void>;
 export type AsyncJsonrpcMiddleware<Params extends JsonRpcParams, Result extends Json> = (request: JsonRpcRequest<Params>, response: PendingJsonRpcResponse<Result>, next: AsyncJsonRpcEngineNextCallback) => Promise<void>;
 /**
@@ -25,4 +25,4 @@ export type AsyncJsonrpcMiddleware<Params extends JsonRpcParams, Result extends
  * by JsonRpcEngine.
  */
 export declare function createAsyncMiddleware<Params extends JsonRpcParams, Result extends Json>(asyncMiddleware: AsyncJsonrpcMiddleware<Params, Result>): JsonRpcMiddleware<Params, Result>;
-//# sourceMappingURL=createAsyncMiddleware.d.mts.map
+//# sourceMappingURL=createAsyncMiddleware.d.ts.map

package/dist/createAsyncMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAsyncMiddleware.d.ts","sourceRoot":"","sources":["../src/createAsyncMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,8BAA8B,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjE,MAAM,MAAM,sBAAsB,CAChC,MAAM,SAAS,aAAa,EAC5B,MAAM,SAAS,IAAI,IACjB,CACF,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,EAC/B,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,EACxC,IAAI,EAAE,8BAA8B,KACjC,OAAO,CAAC,IAAI,CAAC,CAAC;AAInB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,SAAS,aAAa,EAC5B,MAAM,SAAS,IAAI,EAEnB,eAAe,EAAE,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,GACtD,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CA6CnC"}

package/dist/{createAsyncMiddleware.mjs → createAsyncMiddleware.js}

@@ -64,4 +64,4 @@ export function createAsyncMiddleware(asyncMiddleware) {
         }
     };
 }
-//# sourceMappingURL=createAsyncMiddleware.mjs.map
+//# sourceMappingURL=createAsyncMiddleware.js.map

package/dist/createAsyncMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAsyncMiddleware.js","sourceRoot":"","sources":["../src/createAsyncMiddleware.ts"],"names":[],"mappings":"AAyBA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,qBAAqB,CAInC,eAAuD;IAEvD,kEAAkE;IAClE,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC5C,+CAA+C;QAC/C,qDAAqD;QACrD,kBAAkB;QAClB,IAAI,kBAA8B,CAAC;QACnC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAChD,kBAAkB,GAAG,OAAO,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,IAAI,qBAAqB,GAAY,IAAI,CAAC;QAC1C,IAAI,aAAa,GAAG,KAAK,CAAC;QAE1B,0DAA0D;QAC1D,MAAM,SAAS,GAAG,KAAK,IAAmB,EAAE;YAC1C,aAAa,GAAG,IAAI,CAAC;YAErB,uEAAuE;YACvE,yDAAyD;YACzD,IAAI,CAAC,CAAC,yBAAyB,EAAE,EAAE;gBACjC,4DAA4D;gBAC5D,qBAAqB,GAAG,yBAAyB,CAAC;gBAClD,kBAAkB,EAAE,CAAC;YACvB,CAAC,CAAC,CAAC;YACH,OAAO,WAAW,CAAC;QACrB,CAAC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;YAEpD,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,WAAW,CAAC,CAAC,kDAAkD;gBACpE,qBAA+C,CAAC,IAAI,CAAC,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,CAAC;YACZ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,qBAAqB,EAAE,CAAC;gBACzB,qBAA+C,CAAC,KAAK,CAAC,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,KAAK,CAAC,CAAC;YACb,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  PendingJsonRpcResponse,\n} from '@metamask/utils';\n\nimport type {\n  JsonRpcEngineReturnHandler,\n  JsonRpcMiddleware,\n} from './JsonRpcEngine.js';\n\nexport type AsyncJsonRpcEngineNextCallback = () => Promise<void>;\n\nexport type AsyncJsonrpcMiddleware<\n  Params extends JsonRpcParams,\n  Result extends Json,\n> = (\n  request: JsonRpcRequest<Params>,\n  response: PendingJsonRpcResponse<Result>,\n  next: AsyncJsonRpcEngineNextCallback,\n) => Promise<void>;\n\ntype ReturnHandlerCallback = Parameters<JsonRpcEngineReturnHandler>[0];\n\n/**\n * JsonRpcEngine only accepts callback-based middleware directly.\n * createAsyncMiddleware exists to enable consumers to pass in async middleware\n * functions.\n *\n * Async middleware have no \"end\" function. Instead, they \"end\" if they return\n * without calling \"next\". Rather than passing in explicit return handlers,\n * async middleware can simply await \"next\", and perform operations on the\n * response object when execution resumes.\n *\n * To accomplish this, createAsyncMiddleware passes the async middleware a\n * wrapped \"next\" function. That function calls the internal JsonRpcEngine\n * \"next\" function with a return handler that resolves a promise when called.\n *\n * The return handler will always be called. Its resolution of the promise\n * enables the control flow described above.\n *\n * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.\n * @param asyncMiddleware - The asynchronous middleware function to wrap.\n * @returns The wrapped asynchronous middleware function, ready to be consumed\n * by JsonRpcEngine.\n */\nexport function createAsyncMiddleware<\n  Params extends JsonRpcParams,\n  Result extends Json,\n>(\n  asyncMiddleware: AsyncJsonrpcMiddleware<Params, Result>,\n): JsonRpcMiddleware<Params, Result> {\n  // eslint-disable-next-line @typescript-eslint/no-misused-promises\n  return async (request, response, next, end) => {\n    // nextPromise is the key to the implementation\n    // it is resolved by the return handler passed to the\n    // \"next\" function\n    let resolveNextPromise: () => void;\n    const nextPromise = new Promise<void>((resolve) => {\n      resolveNextPromise = resolve;\n    });\n\n    let returnHandlerCallback: unknown = null;\n    let nextWasCalled = false;\n\n    // This will be called by the consumer's async middleware.\n    const asyncNext = async (): Promise<void> => {\n      nextWasCalled = true;\n\n      // We pass a return handler to next(). When it is called by the engine,\n      // the consumer's async middleware will resume executing.\n      next((runReturnHandlersCallback) => {\n        // This callback comes from JsonRpcEngine._runReturnHandlers\n        returnHandlerCallback = runReturnHandlersCallback;\n        resolveNextPromise();\n      });\n      return nextPromise;\n    };\n\n    try {\n      await asyncMiddleware(request, response, asyncNext);\n\n      if (nextWasCalled) {\n        await nextPromise; // we must wait until the return handler is called\n        (returnHandlerCallback as ReturnHandlerCallback)(null);\n      } else {\n        end(null);\n      }\n    } catch (error) {\n      if (returnHandlerCallback) {\n        (returnHandlerCallback as ReturnHandlerCallback)(error);\n      } else {\n        end(error);\n      }\n    }\n  };\n}\n"]}

package/dist/{createMethodMiddleware.d.mts → createMethodMiddleware.d.ts}

@@ -1,8 +1,8 @@
-import type { ActionConstraint } from "@metamask/messenger";
-import type { Messenger } from "@metamask/messenger";
-import type { Json, JsonRpcParams, JsonRpcRequest, PendingJsonRpcResponse } from "@metamask/utils";
-import type { JsonRpcEngineEndCallback, JsonRpcEngineNextCallback, JsonRpcMiddleware } from "./JsonRpcEngine.mjs";
-import { UnionToIntersection } from "./v2/utils.mjs";
+import type { ActionConstraint } from '@metamask/messenger';
+import type { Messenger } from '@metamask/messenger';
+import type { Json, JsonRpcParams, JsonRpcRequest, PendingJsonRpcResponse } from '@metamask/utils';
+import type { JsonRpcEngineEndCallback, JsonRpcEngineNextCallback, JsonRpcMiddleware } from './JsonRpcEngine.js';
+import { UnionToIntersection } from './v2/utils.js';
 type HandlerActions<Handler> = Handler extends {
     implementation: (...args: infer Args) => unknown;
 } ? Args extends [
@@ -83,4 +83,4 @@ export type CreateMethodMiddlewareOptions<Handlers extends Record<string, AnyMet
  */
 export declare function createMethodMiddleware<Handlers extends Record<string, AnyMethodHandler>>(options: CreateMethodMiddlewareOptions<Handlers>): JsonRpcMiddleware<JsonRpcParams, Json>;
 export {};
-//# sourceMappingURL=createMethodMiddleware.d.mts.map
+//# sourceMappingURL=createMethodMiddleware.d.ts.map

package/dist/createMethodMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMethodMiddleware.d.ts","sourceRoot":"","sources":["../src/createMethodMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIL,mBAAmB,EACpB,MAAM,eAAe,CAAC;AAEvB,KAAK,cAAc,CAAC,OAAO,IAAI,OAAO,SAAS;IAC7C,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC;CAClD,GACG,IAAI,SAAS;IACX,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM,gBAAgB;CACvB,GACC,gBAAgB,SAAS,SAAS,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GACvD,OAAO,GACP,KAAK,GACP,KAAK,GACP,KAAK,CAAC;AAEV,KAAK,YAAY,CAAC,OAAO,IAAI,OAAO,SAAS;IAC3C,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC;CAClD,GACG,IAAI,SAAS;IACX,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM,QAAQ;IACd,GAAG,OAAO,EAAE;CACb,GACC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,QAAQ,GACR,KAAK,GACP,KAAK,GACP,KAAK,CAAC;AAEV;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,CACrC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,EAC7C,gBAAgB,SAAS,gBAAgB,GAAG,KAAK,EACjD,MAAM,SAAS,aAAa,GAAG,aAAa,EAC5C,MAAM,SAAS,IAAI,GAAG,IAAI,EAC1B,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACrE,CACF,GAAG,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,aAAa,EAC3C,GAAG,EAAE,sBAAsB,CAAC,MAAM,CAAC,EACnC,IAAI,EAAE,yBAAyB,EAC/B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,gBAAgB,CAAC,KAC3C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B;;;;GAIG;AACH,MAAM,MAAM,aAAa,CACvB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,EAC7C,gBAAgB,SAAS,gBAAgB,GAAG,KAAK,EACjD,MAAM,SAAS,aAAa,GAAG,aAAa,EAC5C,MAAM,SAAS,IAAI,GAAG,IAAI,EAC1B,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACrE;IACF,cAAc,EAAE,2BAA2B,CACzC,KAAK,EACL,gBAAgB,EAChB,MAAM,EACN,MAAM,EACN,aAAa,CACd,CAAC;CACH,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,GACxB;IAAE,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GACzB;IAAE,SAAS,EAAE;SAAG,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI;KAAE,CAAA;CAAE,CAAC,GAChD,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,GAC/B;IAAE,WAAW,CAAC,EAAE,SAAS,CAAA;CAAE,GAC3B;IAAE,WAAW,EAAE,SAAS,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAA;CAAE,CAAC,CAAC;AAE5D,KAAK,gBAAgB,GAAG;IACtB,cAAc,CACZ,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,yBAAyB,EAC/B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC,CAAC;AAEF,KAAK,iCAAiC,CACpC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAC/C;IACF,QAAQ,EAAE,QAAQ,CAAC;IAKnB,KAAK,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAC3D,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GACrB,mBAAmB,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChE;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;CAC7D,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,CACvC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAC/C,iCAAiC,CAAC,QAAQ,CAAC,GAC7C,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACvD;IACE,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,GACD;IACE,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC;CACxE,CAAC,CAAC;AAQT;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAEjD,OAAO,EAAE,6BAA6B,CAAC,QAAQ,CAAC,GAC/C,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,CAsDxC"}