@metamask-previews/json-rpc-engine 10.1.1-preview-63ea58af → 10.1.1-preview-0458fe94

package/dist/JsonRpcEngine.cjs

@@ -19,10 +19,14 @@ exports.JsonRpcEngine = void 0;
 const rpc_errors_1 = require("@metamask/rpc-errors");
 const safe_event_emitter_1 = __importDefault(require("@metamask/safe-event-emitter"));
 const utils_1 = require("@metamask/utils");
+const utils_2 = require("./v2/utils.cjs");
 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.
  */
 class JsonRpcEngine extends safe_event_emitter_1.default {
     /**
@@ -135,13 +139,14 @@ class JsonRpcEngine extends safe_event_emitter_1.default {
      */
     // 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) => {
             __classPrivateFieldGet(this, _JsonRpcEngine_instances, "m", _JsonRpcEngine_handle).call(this, 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 {
@@ -314,7 +319,7 @@ async function _JsonRpcEngine_handle(callerReq, callback) {
                 if (returnHandler) {
                     if (typeof returnHandler !== 'function') {
                         end(new rpc_errors_1.JsonRpcError(rpc_errors_1.errorCodes.rpc.internal, `JsonRpcEngine: "next" return handlers must be functions. ` +
-                            `Received "${typeof returnHandler}" for request:\n${jsonify(request)}`, { request }));
+                            `Received "${typeof returnHandler}" for request:\n${(0, utils_2.stringify)(request)}`, { request }));
                     }
                     returnHandlers.push(returnHandler);
                 }
@@ -332,24 +337,17 @@ async function _JsonRpcEngine_handle(callerReq, callback) {
 }, _JsonRpcEngine_runReturnHandlers = async function _JsonRpcEngine_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()));
         });
     }
 }, _JsonRpcEngine_checkForCompletion = function _JsonRpcEngine_checkForCompletion(request, response, isComplete) {
     if (!(0, utils_1.hasProperty)(response, 'result') && !(0, utils_1.hasProperty)(response, 'error')) {
-        throw new rpc_errors_1.JsonRpcError(rpc_errors_1.errorCodes.rpc.internal, `JsonRpcEngine: Response has no error or result for request:\n${jsonify(request)}`, { request });
+        throw new rpc_errors_1.JsonRpcError(rpc_errors_1.errorCodes.rpc.internal, `JsonRpcEngine: Response has no error or result for request:\n${(0, utils_2.stringify)(request)}`, { request });
     }
     if (!isComplete) {
-        throw new rpc_errors_1.JsonRpcError(rpc_errors_1.errorCodes.rpc.internal, `JsonRpcEngine: Nothing ended request:\n${jsonify(request)}`, { request });
+        throw new rpc_errors_1.JsonRpcError(rpc_errors_1.errorCodes.rpc.internal, `JsonRpcEngine: Nothing ended request:\n${(0, utils_2.stringify)(request)}`, { request });
     }
 };
-/**
- * JSON-stringifies a request object.
- *
- * @param request - The request object to JSON-stringify.
- * @returns The JSON-stringified request object.
- */
-function jsonify(request) {
-    return JSON.stringify(request, null, 2);
-}
 //# sourceMappingURL=JsonRpcEngine.cjs.map

package/dist/JsonRpcEngine.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"JsonRpcEngine.cjs","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\nexport type JsonRpcEngineCallbackError = Error | SerializedJsonRpcError | null;\n\nexport type JsonRpcEngineReturnHandler = (\n  done: (error?: unknown) => void,\n) => void;\n\nexport type JsonRpcEngineNextCallback = (\n  returnHandlerCallback?: JsonRpcEngineReturnHandler,\n) => void;\n\nexport type JsonRpcEngineEndCallback = (error?: unknown) => void;\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\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 * Give it a stack of middleware, pass it requests, and get back responses.\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() {\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  ) {\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          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      if (!res.error) {\n        res.error = serializeError(error);\n      }\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${jsonify(\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        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${jsonify(\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${jsonify(request)}`,\n        { request },\n      );\n    }\n  }\n}\n\n/**\n * JSON-stringifies a request object.\n *\n * @param request - The request object to JSON-stringify.\n * @returns The JSON-stringified request object.\n */\nfunction jsonify(request: JsonRpcRequest): string {\n  return JSON.stringify(request, null, 2);\n}\n"]}
+{"version":3,"file":"JsonRpcEngine.cjs","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';\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() {\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  ) {\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\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      if (!res.error) {\n        res.error = serializeError(error);\n      }\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/JsonRpcEngine.d.cts

@@ -1,13 +1,28 @@
 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.
+ */
 export type JsonRpcEngineReturnHandler = (done: (error?: unknown) => void) => void;
+/**
+ * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.
+ */
 export type JsonRpcEngineNextCallback = (returnHandlerCallback?: JsonRpcEngineReturnHandler) => void;
+/**
+ * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.
+ */
 export type JsonRpcEngineEndCallback = (error?: unknown) => void;
+/**
+ * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.
+ */
 export type JsonRpcMiddleware<Params extends JsonRpcParams, Result extends Json> = {
     (req: JsonRpcRequest<Params>, res: PendingJsonRpcResponse<Result>, next: JsonRpcEngineNextCallback, end: JsonRpcEngineEndCallback): void;
     destroy?: () => void | Promise<void>;
 };
+/**
+ * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.
+ */
 export type JsonRpcNotificationHandler<Params extends JsonRpcParams> = (notification: JsonRpcNotification<Params>) => void | Promise<void>;
 type JsonRpcEngineArgs = {
     /**
@@ -23,7 +38,10 @@ type JsonRpcEngineArgs = {
 };
 /**
  * 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 declare class JsonRpcEngine extends SafeEventEmitter {
     #private;

package/dist/JsonRpcEngine.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"JsonRpcEngine.d.cts","sourceRoot":"","sources":["../src/JsonRpcEngine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"JsonRpcEngine.d.cts","sourceRoot":"","sources":["../src/JsonRpcEngine.ts"],"names":[],"mappings":"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"}

package/dist/JsonRpcEngine.d.mts

@@ -1,13 +1,28 @@
 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.
+ */
 export type JsonRpcEngineReturnHandler = (done: (error?: unknown) => void) => void;
+/**
+ * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.
+ */
 export type JsonRpcEngineNextCallback = (returnHandlerCallback?: JsonRpcEngineReturnHandler) => void;
+/**
+ * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.
+ */
 export type JsonRpcEngineEndCallback = (error?: unknown) => void;
+/**
+ * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.
+ */
 export type JsonRpcMiddleware<Params extends JsonRpcParams, Result extends Json> = {
     (req: JsonRpcRequest<Params>, res: PendingJsonRpcResponse<Result>, next: JsonRpcEngineNextCallback, end: JsonRpcEngineEndCallback): void;
     destroy?: () => void | Promise<void>;
 };
+/**
+ * @deprecated Use `JsonRpcEngineV2` and its corresponding types instead.
+ */
 export type JsonRpcNotificationHandler<Params extends JsonRpcParams> = (notification: JsonRpcNotification<Params>) => void | Promise<void>;
 type JsonRpcEngineArgs = {
     /**
@@ -23,7 +38,10 @@ type JsonRpcEngineArgs = {
 };
 /**
  * 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 declare class JsonRpcEngine extends SafeEventEmitter {
     #private;

package/dist/JsonRpcEngine.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"JsonRpcEngine.d.mts","sourceRoot":"","sources":["../src/JsonRpcEngine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"JsonRpcEngine.d.mts","sourceRoot":"","sources":["../src/JsonRpcEngine.ts"],"names":[],"mappings":"AACA,OAAO,gBAAgB,qCAAqC;AAC5D,OAAO,KAAK,EACV,YAAY,IAAI,sBAAsB,EACtC,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,IAAI,EACJ,aAAa,EACb,sBAAsB,EACvB,wBAAwB;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;gBACS,EAAE,mBAAmB,EAAE,GAAE,iBAAsB;IAe3D;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAkBf;;;;OAIG;IACH,IAAI,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EACpD,UAAU,EAAE,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5C,IAAI;IAKP;;;;;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;IAEP;;;;;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;IAEP;;;;;;;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;IAEP;;;;;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;IAEnC;;;;OAIG;IACH,MAAM,CAAC,MAAM,SAAS,aAAa,EACjC,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC;IAEhB;;;;;;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;IAoCrC;;;;;OAKG;IACH,YAAY,IAAI,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC;IAsGtD;;;;;OAKG;YAIW,cAAc;CAoS7B"}

package/dist/JsonRpcEngine.mjs

@@ -13,10 +13,14 @@ var _JsonRpcEngine_instances, _a, _JsonRpcEngine_isDestroyed, _JsonRpcEngine_mid
 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.mjs";
 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 {
     /**
@@ -129,13 +133,14 @@ export class JsonRpcEngine extends SafeEventEmitter {
      */
     // 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) => {
             __classPrivateFieldGet(this, _JsonRpcEngine_instances, "m", _JsonRpcEngine_handle).call(this, 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 {
@@ -307,7 +312,7 @@ async function _JsonRpcEngine_handle(callerReq, callback) {
                 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${jsonify(request)}`, { request }));
+                            `Received "${typeof returnHandler}" for request:\n${stringify(request)}`, { request }));
                     }
                     returnHandlers.push(returnHandler);
                 }
@@ -325,24 +330,17 @@ async function _JsonRpcEngine_handle(callerReq, callback) {
 }, _JsonRpcEngine_runReturnHandlers = async function _JsonRpcEngine_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()));
         });
     }
 }, _JsonRpcEngine_checkForCompletion = function _JsonRpcEngine_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${jsonify(request)}`, { request });
+        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${jsonify(request)}`, { request });
+        throw new JsonRpcError(errorCodes.rpc.internal, `JsonRpcEngine: Nothing ended request:\n${stringify(request)}`, { request });
     }
 };
-/**
- * JSON-stringifies a request object.
- *
- * @param request - The request object to JSON-stringify.
- * @returns The JSON-stringified request object.
- */
-function jsonify(request) {
-    return JSON.stringify(request, null, 2);
-}
 //# sourceMappingURL=JsonRpcEngine.mjs.map

package/dist/JsonRpcEngine.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"JsonRpcEngine.mjs","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\nexport type JsonRpcEngineCallbackError = Error | SerializedJsonRpcError | null;\n\nexport type JsonRpcEngineReturnHandler = (\n  done: (error?: unknown) => void,\n) => void;\n\nexport type JsonRpcEngineNextCallback = (\n  returnHandlerCallback?: JsonRpcEngineReturnHandler,\n) => void;\n\nexport type JsonRpcEngineEndCallback = (error?: unknown) => void;\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\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 * Give it a stack of middleware, pass it requests, and get back responses.\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() {\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  ) {\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          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      if (!res.error) {\n        res.error = serializeError(error);\n      }\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${jsonify(\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        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${jsonify(\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${jsonify(request)}`,\n        { request },\n      );\n    }\n  }\n}\n\n/**\n * JSON-stringifies a request object.\n *\n * @param request - The request object to JSON-stringify.\n * @returns The JSON-stringified request object.\n */\nfunction jsonify(request: JsonRpcRequest): string {\n  return JSON.stringify(request, null, 2);\n}\n"]}
+{"version":3,"file":"JsonRpcEngine.mjs","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';\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() {\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  ) {\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\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      if (!res.error) {\n        res.error = serializeError(error);\n      }\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.cjs

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asV2Middleware = void 0;
+const rpc_errors_1 = require("@metamask/rpc-errors");
+const utils_1 = require("@metamask/utils");
+const compatibility_utils_1 = require("./v2/compatibility-utils.cjs");
+/**
+ * Convert a legacy {@link JsonRpcEngine} into a {@link JsonRpcEngineV2} middleware.
+ *
+ * @param engine - The legacy engine to convert.
+ * @returns The {@link JsonRpcEngineV2} middleware.
+ */
+function asV2Middleware(engine) {
+    const middleware = engine.asMiddleware();
+    return async ({ request, context, next }) => {
+        const req = (0, compatibility_utils_1.deepClone)(request);
+        (0, compatibility_utils_1.propagateToRequest)(req, context);
+        const response = await new Promise((resolve) => {
+            // The result or error property will be set by the legacy engine
+            // middleware.
+            const res = {
+                jsonrpc: '2.0',
+                id: req.id,
+            };
+            const end = (error) => {
+                if (error !== undefined) {
+                    res.error = (0, rpc_errors_1.serializeError)(error);
+                }
+                resolve(res);
+            };
+            // We know from the implementation of JsonRpcEngine.asMiddleware() that
+            // legacyNext will always be passed a callback, so cb can never be
+            // undefined.
+            const legacyNext = ((cb) => cb(end));
+            middleware(req, res, legacyNext, end);
+        });
+        (0, compatibility_utils_1.propagateToContext)(req, context);
+        if ((0, utils_1.hasProperty)(response, 'error')) {
+            throw (0, compatibility_utils_1.unserializeError)(response.error);
+        }
+        else if ((0, utils_1.hasProperty)(response, 'result')) {
+            return response.result;
+        }
+        return next((0, compatibility_utils_1.fromLegacyRequest)(req));
+    };
+}
+exports.asV2Middleware = asV2Middleware;
+//# sourceMappingURL=asV2Middleware.cjs.map

package/dist/asV2Middleware.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"asV2Middleware.cjs","sourceRoot":"","sources":["../src/asV2Middleware.ts"],"names":[],"mappings":";;;AAAA,qDAAsD;AAEtD,2CAIyB;AAOzB,sEAMkC;AASlC;;;;;GAKG;AACH,SAAgB,cAAc,CAG5B,MAAqB;IACrB,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;IACzC,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAG,IAAA,+BAAS,EAAC,OAAO,CAA2B,CAAC;QACzD,IAAA,wCAAkB,EAAC,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;oBACtB,GAAsB,CAAC,KAAK,GAAG,IAAA,2BAAc,EAAC,KAAK,CAAC,CAAC;iBACvD;gBACD,OAAO,CAAC,GAAG,CAAC,CAAC;YACf,CAAC,CAAC;YAEF,uEAAuE;YACvE,kEAAkE;YAClE,aAAa;YACb,MAAM,UAAU,GAAG,CAAC,CAAC,EAA4B,EAAE,EAAE,CACnD,EAAE,CAAC,GAAG,CAAC,CAA8B,CAAC;YAExC,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,IAAA,wCAAkB,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEjC,IAAI,IAAA,mBAAW,EAAC,QAAQ,EAAE,OAAO,CAAC,EAAE;YAClC,MAAM,IAAA,sCAAgB,EAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SACxC;aAAM,IAAI,IAAA,mBAAW,EAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE;YAC1C,OAAO,QAAQ,CAAC,MAAmC,CAAC;SACrD;QACD,OAAO,IAAI,CAAC,IAAA,uCAAiB,EAAC,GAAc,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC;AACJ,CAAC;AAzCD,wCAyCC","sourcesContent":["import { serializeError } from '@metamask/rpc-errors';\nimport type { JsonRpcFailure, JsonRpcResponse } from '@metamask/utils';\nimport {\n  hasProperty,\n  type JsonRpcParams,\n  type JsonRpcRequest,\n} from '@metamask/utils';\n\nimport type {\n  JsonRpcEngine,\n  JsonRpcEngineEndCallback,\n  JsonRpcEngineNextCallback,\n} from './JsonRpcEngine';\nimport {\n  deepClone,\n  fromLegacyRequest,\n  propagateToContext,\n  propagateToRequest,\n  unserializeError,\n} from './v2/compatibility-utils';\nimport type {\n  // JsonRpcEngineV2 is used in docs.\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  JsonRpcEngineV2,\n  JsonRpcMiddleware,\n  ResultConstraint,\n} from './v2/JsonRpcEngineV2';\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  const middleware = engine.asMiddleware();\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 = ((cb: JsonRpcEngineEndCallback) =>\n        cb(end)) as JsonRpcEngineNextCallback;\n\n      middleware(req, res, legacyNext, end);\n    });\n    propagateToContext(req, context);\n\n    if (hasProperty(response, 'error')) {\n      throw unserializeError(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/asV2Middleware.d.cts

@@ -0,0 +1,11 @@
+import { type JsonRpcParams, type JsonRpcRequest } from "@metamask/utils";
+import type { JsonRpcEngine } from "./JsonRpcEngine.cjs";
+import type { JsonRpcMiddleware } from "./v2/JsonRpcEngineV2.cjs";
+/**
+ * Convert a legacy {@link JsonRpcEngine} into a {@link JsonRpcEngineV2} middleware.
+ *
+ * @param engine - The legacy engine to convert.
+ * @returns The {@link JsonRpcEngineV2} middleware.
+ */
+export declare function asV2Middleware<Params extends JsonRpcParams, Request extends JsonRpcRequest<Params>>(engine: JsonRpcEngine): JsonRpcMiddleware<Request>;
+//# sourceMappingURL=asV2Middleware.d.cts.map

package/dist/asV2Middleware.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asV2Middleware.d.cts","sourceRoot":"","sources":["../src/asV2Middleware.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,wBAAwB;AAEzB,OAAO,KAAK,EACV,aAAa,EAGd,4BAAwB;AAQzB,OAAO,KAAK,EAIV,iBAAiB,EAElB,iCAA6B;AAE9B;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,SAAS,aAAa,EAC5B,OAAO,SAAS,cAAc,CAAC,MAAM,CAAC,EACtC,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAsCnD"}