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

package/dist/v2/asLegacyMiddleware.mjs

@@ -0,0 +1,35 @@
+import { deepClone, fromLegacyRequest, makeContext, propagateToRequest } from "./compatibility-utils.mjs";
+import { createAsyncMiddleware } from "../index.mjs";
+/**
+ * Convert a {@link JsonRpcEngineV2} into a legacy middleware.
+ *
+ * @param engine - The engine to convert.
+ * @returns The legacy middleware.
+ */
+export function asLegacyMiddleware(engine) {
+    const middleware = engine.asMiddleware();
+    return createAsyncMiddleware(async (req, res, next) => {
+        const request = fromLegacyRequest(req);
+        const context = makeContext(req);
+        let modifiedRequest;
+        const result = await middleware({
+            request,
+            context,
+            next: (finalRequest) => {
+                modifiedRequest = finalRequest;
+                return Promise.resolve(undefined);
+            },
+        });
+        if (modifiedRequest !== undefined && modifiedRequest !== request) {
+            Object.assign(req, deepClone(modifiedRequest));
+        }
+        propagateToRequest(req, context);
+        if (result !== undefined) {
+            // Unclear why the `as unknown` is needed here, but the cast is safe.
+            res.result = deepClone(result);
+            return undefined;
+        }
+        return next();
+    });
+}
+//# sourceMappingURL=asLegacyMiddleware.mjs.map

package/dist/v2/asLegacyMiddleware.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"asLegacyMiddleware.mjs","sourceRoot":"","sources":["../../src/v2/asLegacyMiddleware.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EACnB,kCAA8B;AAE/B,OAAO,EAAE,qBAAqB,EAAE,qBAAW;AAG3C;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAIhC,MAAgC;IAEhC,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;IACzC,OAAO,qBAAqB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACpD,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAc,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,eAAoC,CAAC;QAEzC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;YAC9B,OAAO;YACP,OAAO;YACP,IAAI,EAAE,CAAC,YAAY,EAAE,EAAE;gBACrB,eAAe,GAAG,YAAY,CAAC;gBAC/B,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACpC,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,KAAK,OAAO,EAAE;YAChE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;SAChD;QACD,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEjC,IAAI,MAAM,KAAK,SAAS,EAAE;YACxB,qEAAqE;YACrE,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAyC,CAAC;YACvE,OAAO,SAAS,CAAC;SAClB;QACD,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { JsonRpcParams, JsonRpcRequest } from '@metamask/utils';\n\nimport {\n  deepClone,\n  fromLegacyRequest,\n  makeContext,\n  propagateToRequest,\n} from './compatibility-utils';\nimport type { JsonRpcEngineV2, ResultConstraint } from './JsonRpcEngineV2';\nimport { createAsyncMiddleware } from '..';\nimport type { JsonRpcMiddleware as LegacyMiddleware } from '..';\n\n/**\n * Convert a {@link JsonRpcEngineV2} into a legacy middleware.\n *\n * @param engine - The engine to convert.\n * @returns The legacy middleware.\n */\nexport function asLegacyMiddleware<\n  Params extends JsonRpcParams,\n  Request extends JsonRpcRequest<Params>,\n>(\n  engine: JsonRpcEngineV2<Request>,\n): LegacyMiddleware<Params, ResultConstraint<Request>> {\n  const middleware = engine.asMiddleware();\n  return createAsyncMiddleware(async (req, res, next) => {\n    const request = fromLegacyRequest(req as Request);\n    const context = makeContext(req);\n    let modifiedRequest: Request | undefined;\n\n    const result = await middleware({\n      request,\n      context,\n      next: (finalRequest) => {\n        modifiedRequest = finalRequest;\n        return Promise.resolve(undefined);\n      },\n    });\n\n    if (modifiedRequest !== undefined && modifiedRequest !== request) {\n      Object.assign(req, deepClone(modifiedRequest));\n    }\n    propagateToRequest(req, context);\n\n    if (result !== undefined) {\n      // Unclear why the `as unknown` is needed here, but the cast is safe.\n      res.result = deepClone(result) as unknown as ResultConstraint<Request>;\n      return undefined;\n    }\n    return next();\n  });\n}\n"]}

package/dist/v2/compatibility-utils.cjs

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unserializeError = exports.propagateToRequest = exports.propagateToContext = exports.makeContext = exports.fromLegacyRequest = exports.requestProps = exports.deepClone = void 0;
+const rpc_errors_1 = require("@metamask/rpc-errors");
+const utils_1 = require("@metamask/utils");
+// ATTN: We must NOT use 'klona/full' here because it freezes properties on the clone.
+const klona_1 = require("klona");
+const MiddlewareContext_1 = require("./MiddlewareContext.cjs");
+const utils_2 = require("./utils.cjs");
+// Legacy engine compatibility utils
+/**
+ * Create a deep clone of a value as follows:
+ * - Assumes acyclical objects
+ * - Does not copy property descriptors (i.e. uses mutable defaults)
+ * - Ignores non-enumerable properties
+ * - Ignores getters and setters
+ *
+ * @throws If the value is an object with a circular reference.
+ * @param value - The value to clone.
+ * @returns The cloned value.
+ */
+const deepClone = (value) => (0, klona_1.klona)(value);
+exports.deepClone = deepClone;
+/**
+ * Standard JSON-RPC request properties.
+ */
+exports.requestProps = ['jsonrpc', 'method', 'params', 'id'];
+/**
+ * Make a JSON-RPC request from a legacy request. Clones the params to avoid
+ * freezing them, which could cause errors in an involved legacy engine.
+ *
+ * @param req - The legacy request to make a request from.
+ * @returns The JSON-RPC request.
+ */
+function fromLegacyRequest(req) {
+    const request = {
+        jsonrpc: '2.0',
+        method: req.method,
+    };
+    request.id = req.id;
+    if ((0, utils_1.hasProperty)(req, 'params') && req.params !== undefined) {
+        request.params = (0, exports.deepClone)(req.params);
+    }
+    return request;
+}
+exports.fromLegacyRequest = fromLegacyRequest;
+/**
+ * Make a middleware context from a legacy request by copying over all non-JSON-RPC
+ * properties from the request to the context object.
+ *
+ * @param req - The legacy request to make a context from.
+ * @returns The middleware context.
+ */
+function makeContext(req) {
+    const context = new MiddlewareContext_1.MiddlewareContext();
+    propagateToContext(req, context);
+    return context;
+}
+exports.makeContext = makeContext;
+/**
+ * Copies non-JSON-RPC string properties from the request to the context.
+ *
+ * For compatibility with our problematic practice of appending non-standard
+ * fields to requests for inter-middleware communication in the legacy engine.
+ *
+ * **ATTN:** Only string properties that do not already exist in the context
+ * are copied.
+ *
+ * @param req - The request to propagate the context from.
+ * @param context - The context to propagate to.
+ */
+function propagateToContext(req, context) {
+    Object.keys(req)
+        .filter((key) => typeof key === 'string' &&
+        !exports.requestProps.includes(key) &&
+        !context.has(key))
+        .forEach((key) => {
+        context.set(key, req[key]);
+    });
+}
+exports.propagateToContext = propagateToContext;
+/**
+ * Copies non-JSON-RPC string properties from the context to the request.
+ *
+ * For compatibility with our problematic practice of appending non-standard
+ * fields to requests for inter-middleware communication in the legacy engine.
+ *
+ * **ATTN:** Only string properties are copied.
+ *
+ * @param req - The request to propagate the context to.
+ * @param context - The context to propagate from.
+ */
+function propagateToRequest(req, context) {
+    Array.from(context.keys())
+        .filter(((key) => typeof key === 'string' && !exports.requestProps.includes(key)))
+        .forEach((key) => {
+        req[key] = context.get(key);
+    });
+}
+exports.propagateToRequest = propagateToRequest;
+/**
+ * Unserialize an error from a thrown value. Creates a {@link JsonRpcError} if
+ * the thrown value is an object with a `code` property. Otherwise, creates a
+ * plain {@link Error}.
+ *
+ * @param thrown - The thrown value to unserialize.
+ * @returns The unserialized error.
+ */
+function unserializeError(thrown) {
+    // @ts-expect-error - New, but preferred if available.
+    // See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/isError
+    if (typeof Error.isError === 'function' && Error.isError(thrown)) {
+        return thrown;
+    }
+    // Unlike Error.isError, instanceof does not work for Errors from other realms.
+    if (thrown instanceof Error) {
+        return thrown;
+    }
+    if (typeof thrown === 'string') {
+        return new Error(thrown);
+    }
+    if (!(0, utils_1.isObject)(thrown)) {
+        return new Error(`Unknown error: ${(0, utils_2.stringify)(thrown)}`);
+    }
+    const code = typeof thrown.code === 'number' && Number.isInteger(thrown.code)
+        ? thrown.code
+        : undefined;
+    let message = 'Unknown error';
+    if (typeof thrown.message === 'string') {
+        message = thrown.message;
+    }
+    else if (typeof code === 'number') {
+        message = (0, rpc_errors_1.getMessageFromCode)(code, message);
+    }
+    const { stack, cause, data } = thrown;
+    const error = code === undefined
+        ? // Jest complains if we use the `@ts-expect-error` directive here.
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore - Our error type is outdated.
+            new Error(message, { cause })
+        : new rpc_errors_1.JsonRpcError(code, message, {
+            ...((0, utils_1.isObject)(data) ? data : undefined),
+            cause,
+        });
+    if (typeof stack === 'string') {
+        error.stack = stack;
+    }
+    return error;
+}
+exports.unserializeError = unserializeError;
+//# sourceMappingURL=compatibility-utils.cjs.map

package/dist/v2/compatibility-utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility-utils.cjs","sourceRoot":"","sources":["../../src/v2/compatibility-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { getMessageFromCode, JsonRpcError } from '@metamask/rpc-errors';\nimport type { Json } from '@metamask/utils';\nimport { hasProperty, isObject } from '@metamask/utils';\n// ATTN: We must NOT use 'klona/full' here because it freezes properties on the clone.\nimport { klona } from 'klona';\n\nimport { MiddlewareContext } from './MiddlewareContext';\nimport { stringify, type JsonRpcRequest } from './utils';\n\n// Legacy engine compatibility utils\n\n/**\n * Create a deep clone of a value as follows:\n * - Assumes acyclical objects\n * - Does not copy property descriptors (i.e. uses mutable defaults)\n * - Ignores non-enumerable properties\n * - Ignores getters and setters\n *\n * @throws If the value is an object with a circular reference.\n * @param value - The value to clone.\n * @returns The cloned value.\n */\nexport const deepClone = <T>(value: T): DeepCloned<T> =>\n  klona(value) as DeepCloned<T>;\n\n// Matching the default implementation of klona, this type:\n// - Removes readonly modifiers\n// - Excludes non-enumerable / symbol properties\ntype DeepCloned<T> = T extends readonly (infer U)[]\n  ? DeepCloned<U>[]\n  : T extends object\n    ? { -readonly [K in keyof T & (string | number)]: DeepCloned<T[K]> }\n    : T;\n\n/**\n * Standard JSON-RPC request properties.\n */\nexport const requestProps = ['jsonrpc', 'method', 'params', 'id'];\n\n/**\n * Make a JSON-RPC request from a legacy request. Clones the params to avoid\n * freezing them, which could cause errors in an involved legacy engine.\n *\n * @param req - The legacy request to make a request from.\n * @returns The JSON-RPC request.\n */\nexport function fromLegacyRequest<Request extends JsonRpcRequest>(\n  req: Request,\n): Request {\n  const request = {\n    jsonrpc: '2.0' as const,\n    method: req.method,\n  } as Partial<Request>;\n  request.id = req.id;\n  if (hasProperty(req, 'params') && req.params !== undefined) {\n    request.params = deepClone(req.params);\n  }\n  return request as Request;\n}\n\n/**\n * Make a middleware context from a legacy request by copying over all non-JSON-RPC\n * properties from the request to the context object.\n *\n * @param req - The legacy request to make a context from.\n * @returns The middleware context.\n */\nexport function makeContext<Request extends Record<string | symbol, unknown>>(\n  req: Request,\n): MiddlewareContext {\n  const context = new MiddlewareContext();\n  propagateToContext(req, context);\n  return context;\n}\n\n/**\n * Copies non-JSON-RPC string properties from the request to the context.\n *\n * For compatibility with our problematic practice of appending non-standard\n * fields to requests for inter-middleware communication in the legacy engine.\n *\n * **ATTN:** Only string properties that do not already exist in the context\n * are copied.\n *\n * @param req - The request to propagate the context from.\n * @param context - The context to propagate to.\n */\nexport function propagateToContext(\n  req: Record<string, unknown>,\n  context: MiddlewareContext<Record<string, unknown>>,\n) {\n  Object.keys(req)\n    .filter(\n      (key) =>\n        typeof key === 'string' &&\n        !requestProps.includes(key) &&\n        !context.has(key),\n    )\n    .forEach((key) => {\n      context.set(key, req[key]);\n    });\n}\n\n/**\n * Copies non-JSON-RPC string properties from the context to the request.\n *\n * For compatibility with our problematic practice of appending non-standard\n * fields to requests for inter-middleware communication in the legacy engine.\n *\n * **ATTN:** Only string properties are copied.\n *\n * @param req - The request to propagate the context to.\n * @param context - The context to propagate from.\n */\nexport function propagateToRequest(\n  req: Record<string, unknown>,\n  context: MiddlewareContext,\n) {\n  Array.from(context.keys())\n    .filter(\n      ((key) => typeof key === 'string' && !requestProps.includes(key)) as (\n        value: unknown,\n      ) => value is string,\n    )\n    .forEach((key) => {\n      req[key] = context.get(key);\n    });\n}\n\n/**\n * Unserialize an error from a thrown value. Creates a {@link JsonRpcError} if\n * the thrown value is an object with a `code` property. Otherwise, creates a\n * plain {@link Error}.\n *\n * @param thrown - The thrown value to unserialize.\n * @returns The unserialized error.\n */\nexport function unserializeError(thrown: unknown): Error | JsonRpcError<Json> {\n  // @ts-expect-error - New, but preferred if available.\n  // See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/isError\n  if (typeof Error.isError === 'function' && Error.isError(thrown)) {\n    return thrown as Error;\n  }\n  // Unlike Error.isError, instanceof does not work for Errors from other realms.\n  if (thrown instanceof Error) {\n    return thrown;\n  }\n  if (typeof thrown === 'string') {\n    return new Error(thrown);\n  }\n  if (!isObject(thrown)) {\n    return new Error(`Unknown error: ${stringify(thrown)}`);\n  }\n\n  const code =\n    typeof thrown.code === 'number' && Number.isInteger(thrown.code)\n      ? thrown.code\n      : undefined;\n\n  let message = 'Unknown error';\n  if (typeof thrown.message === 'string') {\n    message = thrown.message;\n  } else if (typeof code === 'number') {\n    message = getMessageFromCode(code, message);\n  }\n\n  const { stack, cause, data } = thrown;\n\n  const error =\n    code === undefined\n      ? // Jest complains if we use the `@ts-expect-error` directive here.\n        // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n        // @ts-ignore - Our error type is outdated.\n        new Error(message, { cause })\n      : new JsonRpcError(code, message, {\n          ...(isObject(data) ? data : undefined),\n          cause,\n        });\n\n  if (typeof stack === 'string') {\n    error.stack = stack;\n  }\n\n  return error;\n}\n"]}

package/dist/v2/compatibility-utils.d.cts

@@ -0,0 +1,75 @@
+import { JsonRpcError } from "@metamask/rpc-errors";
+import type { Json } from "@metamask/utils";
+import { MiddlewareContext } from "./MiddlewareContext.cjs";
+import { type JsonRpcRequest } from "./utils.cjs";
+/**
+ * Create a deep clone of a value as follows:
+ * - Assumes acyclical objects
+ * - Does not copy property descriptors (i.e. uses mutable defaults)
+ * - Ignores non-enumerable properties
+ * - Ignores getters and setters
+ *
+ * @throws If the value is an object with a circular reference.
+ * @param value - The value to clone.
+ * @returns The cloned value.
+ */
+export declare const deepClone: <T>(value: T) => DeepCloned<T>;
+type DeepCloned<T> = T extends readonly (infer U)[] ? DeepCloned<U>[] : T extends object ? {
+    -readonly [K in keyof T & (string | number)]: DeepCloned<T[K]>;
+} : T;
+/**
+ * Standard JSON-RPC request properties.
+ */
+export declare const requestProps: string[];
+/**
+ * Make a JSON-RPC request from a legacy request. Clones the params to avoid
+ * freezing them, which could cause errors in an involved legacy engine.
+ *
+ * @param req - The legacy request to make a request from.
+ * @returns The JSON-RPC request.
+ */
+export declare function fromLegacyRequest<Request extends JsonRpcRequest>(req: Request): Request;
+/**
+ * Make a middleware context from a legacy request by copying over all non-JSON-RPC
+ * properties from the request to the context object.
+ *
+ * @param req - The legacy request to make a context from.
+ * @returns The middleware context.
+ */
+export declare function makeContext<Request extends Record<string | symbol, unknown>>(req: Request): MiddlewareContext;
+/**
+ * Copies non-JSON-RPC string properties from the request to the context.
+ *
+ * For compatibility with our problematic practice of appending non-standard
+ * fields to requests for inter-middleware communication in the legacy engine.
+ *
+ * **ATTN:** Only string properties that do not already exist in the context
+ * are copied.
+ *
+ * @param req - The request to propagate the context from.
+ * @param context - The context to propagate to.
+ */
+export declare function propagateToContext(req: Record<string, unknown>, context: MiddlewareContext<Record<string, unknown>>): void;
+/**
+ * Copies non-JSON-RPC string properties from the context to the request.
+ *
+ * For compatibility with our problematic practice of appending non-standard
+ * fields to requests for inter-middleware communication in the legacy engine.
+ *
+ * **ATTN:** Only string properties are copied.
+ *
+ * @param req - The request to propagate the context to.
+ * @param context - The context to propagate from.
+ */
+export declare function propagateToRequest(req: Record<string, unknown>, context: MiddlewareContext): void;
+/**
+ * Unserialize an error from a thrown value. Creates a {@link JsonRpcError} if
+ * the thrown value is an object with a `code` property. Otherwise, creates a
+ * plain {@link Error}.
+ *
+ * @param thrown - The thrown value to unserialize.
+ * @returns The unserialized error.
+ */
+export declare function unserializeError(thrown: unknown): Error | JsonRpcError<Json>;
+export {};
+//# sourceMappingURL=compatibility-utils.d.cts.map

package/dist/v2/compatibility-utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility-utils.d.cts","sourceRoot":"","sources":["../../src/v2/compatibility-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAE,6BAA6B;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAK5C,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AACxD,OAAO,EAAa,KAAK,cAAc,EAAE,oBAAgB;AAIzD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,gCACS,CAAC;AAKhC,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC/C,UAAU,CAAC,CAAC,CAAC,EAAE,GACf,CAAC,SAAS,MAAM,GACd;IAAE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAClE,CAAC,CAAC;AAER;;GAEG;AACH,eAAO,MAAM,YAAY,UAAwC,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAS,cAAc,EAC9D,GAAG,EAAE,OAAO,GACX,OAAO,CAUT;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAC1E,GAAG,EAAE,OAAO,GACX,iBAAiB,CAInB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,QAYpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,iBAAiB,QAW3B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CA+C5E"}

package/dist/v2/compatibility-utils.d.mts

@@ -0,0 +1,75 @@
+import { JsonRpcError } from "@metamask/rpc-errors";
+import type { Json } from "@metamask/utils";
+import { MiddlewareContext } from "./MiddlewareContext.mjs";
+import { type JsonRpcRequest } from "./utils.mjs";
+/**
+ * Create a deep clone of a value as follows:
+ * - Assumes acyclical objects
+ * - Does not copy property descriptors (i.e. uses mutable defaults)
+ * - Ignores non-enumerable properties
+ * - Ignores getters and setters
+ *
+ * @throws If the value is an object with a circular reference.
+ * @param value - The value to clone.
+ * @returns The cloned value.
+ */
+export declare const deepClone: <T>(value: T) => DeepCloned<T>;
+type DeepCloned<T> = T extends readonly (infer U)[] ? DeepCloned<U>[] : T extends object ? {
+    -readonly [K in keyof T & (string | number)]: DeepCloned<T[K]>;
+} : T;
+/**
+ * Standard JSON-RPC request properties.
+ */
+export declare const requestProps: string[];
+/**
+ * Make a JSON-RPC request from a legacy request. Clones the params to avoid
+ * freezing them, which could cause errors in an involved legacy engine.
+ *
+ * @param req - The legacy request to make a request from.
+ * @returns The JSON-RPC request.
+ */
+export declare function fromLegacyRequest<Request extends JsonRpcRequest>(req: Request): Request;
+/**
+ * Make a middleware context from a legacy request by copying over all non-JSON-RPC
+ * properties from the request to the context object.
+ *
+ * @param req - The legacy request to make a context from.
+ * @returns The middleware context.
+ */
+export declare function makeContext<Request extends Record<string | symbol, unknown>>(req: Request): MiddlewareContext;
+/**
+ * Copies non-JSON-RPC string properties from the request to the context.
+ *
+ * For compatibility with our problematic practice of appending non-standard
+ * fields to requests for inter-middleware communication in the legacy engine.
+ *
+ * **ATTN:** Only string properties that do not already exist in the context
+ * are copied.
+ *
+ * @param req - The request to propagate the context from.
+ * @param context - The context to propagate to.
+ */
+export declare function propagateToContext(req: Record<string, unknown>, context: MiddlewareContext<Record<string, unknown>>): void;
+/**
+ * Copies non-JSON-RPC string properties from the context to the request.
+ *
+ * For compatibility with our problematic practice of appending non-standard
+ * fields to requests for inter-middleware communication in the legacy engine.
+ *
+ * **ATTN:** Only string properties are copied.
+ *
+ * @param req - The request to propagate the context to.
+ * @param context - The context to propagate from.
+ */
+export declare function propagateToRequest(req: Record<string, unknown>, context: MiddlewareContext): void;
+/**
+ * Unserialize an error from a thrown value. Creates a {@link JsonRpcError} if
+ * the thrown value is an object with a `code` property. Otherwise, creates a
+ * plain {@link Error}.
+ *
+ * @param thrown - The thrown value to unserialize.
+ * @returns The unserialized error.
+ */
+export declare function unserializeError(thrown: unknown): Error | JsonRpcError<Json>;
+export {};
+//# sourceMappingURL=compatibility-utils.d.mts.map

package/dist/v2/compatibility-utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility-utils.d.mts","sourceRoot":"","sources":["../../src/v2/compatibility-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAE,6BAA6B;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAK5C,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AACxD,OAAO,EAAa,KAAK,cAAc,EAAE,oBAAgB;AAIzD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,gCACS,CAAC;AAKhC,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC/C,UAAU,CAAC,CAAC,CAAC,EAAE,GACf,CAAC,SAAS,MAAM,GACd;IAAE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAClE,CAAC,CAAC;AAER;;GAEG;AACH,eAAO,MAAM,YAAY,UAAwC,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAS,cAAc,EAC9D,GAAG,EAAE,OAAO,GACX,OAAO,CAUT;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAC1E,GAAG,EAAE,OAAO,GACX,iBAAiB,CAInB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,QAYpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,iBAAiB,QAW3B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CA+C5E"}

package/dist/v2/compatibility-utils.mjs

@@ -0,0 +1,142 @@
+import { getMessageFromCode, JsonRpcError } from "@metamask/rpc-errors";
+import { hasProperty, isObject } from "@metamask/utils";
+// ATTN: We must NOT use 'klona/full' here because it freezes properties on the clone.
+import { klona } from "klona";
+import { MiddlewareContext } from "./MiddlewareContext.mjs";
+import { stringify } from "./utils.mjs";
+// Legacy engine compatibility utils
+/**
+ * Create a deep clone of a value as follows:
+ * - Assumes acyclical objects
+ * - Does not copy property descriptors (i.e. uses mutable defaults)
+ * - Ignores non-enumerable properties
+ * - Ignores getters and setters
+ *
+ * @throws If the value is an object with a circular reference.
+ * @param value - The value to clone.
+ * @returns The cloned value.
+ */
+export const deepClone = (value) => klona(value);
+/**
+ * Standard JSON-RPC request properties.
+ */
+export const requestProps = ['jsonrpc', 'method', 'params', 'id'];
+/**
+ * Make a JSON-RPC request from a legacy request. Clones the params to avoid
+ * freezing them, which could cause errors in an involved legacy engine.
+ *
+ * @param req - The legacy request to make a request from.
+ * @returns The JSON-RPC request.
+ */
+export function fromLegacyRequest(req) {
+    const request = {
+        jsonrpc: '2.0',
+        method: req.method,
+    };
+    request.id = req.id;
+    if (hasProperty(req, 'params') && req.params !== undefined) {
+        request.params = deepClone(req.params);
+    }
+    return request;
+}
+/**
+ * Make a middleware context from a legacy request by copying over all non-JSON-RPC
+ * properties from the request to the context object.
+ *
+ * @param req - The legacy request to make a context from.
+ * @returns The middleware context.
+ */
+export function makeContext(req) {
+    const context = new MiddlewareContext();
+    propagateToContext(req, context);
+    return context;
+}
+/**
+ * Copies non-JSON-RPC string properties from the request to the context.
+ *
+ * For compatibility with our problematic practice of appending non-standard
+ * fields to requests for inter-middleware communication in the legacy engine.
+ *
+ * **ATTN:** Only string properties that do not already exist in the context
+ * are copied.
+ *
+ * @param req - The request to propagate the context from.
+ * @param context - The context to propagate to.
+ */
+export function propagateToContext(req, context) {
+    Object.keys(req)
+        .filter((key) => typeof key === 'string' &&
+        !requestProps.includes(key) &&
+        !context.has(key))
+        .forEach((key) => {
+        context.set(key, req[key]);
+    });
+}
+/**
+ * Copies non-JSON-RPC string properties from the context to the request.
+ *
+ * For compatibility with our problematic practice of appending non-standard
+ * fields to requests for inter-middleware communication in the legacy engine.
+ *
+ * **ATTN:** Only string properties are copied.
+ *
+ * @param req - The request to propagate the context to.
+ * @param context - The context to propagate from.
+ */
+export function propagateToRequest(req, context) {
+    Array.from(context.keys())
+        .filter(((key) => typeof key === 'string' && !requestProps.includes(key)))
+        .forEach((key) => {
+        req[key] = context.get(key);
+    });
+}
+/**
+ * Unserialize an error from a thrown value. Creates a {@link JsonRpcError} if
+ * the thrown value is an object with a `code` property. Otherwise, creates a
+ * plain {@link Error}.
+ *
+ * @param thrown - The thrown value to unserialize.
+ * @returns The unserialized error.
+ */
+export function unserializeError(thrown) {
+    // @ts-expect-error - New, but preferred if available.
+    // See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/isError
+    if (typeof Error.isError === 'function' && Error.isError(thrown)) {
+        return thrown;
+    }
+    // Unlike Error.isError, instanceof does not work for Errors from other realms.
+    if (thrown instanceof Error) {
+        return thrown;
+    }
+    if (typeof thrown === 'string') {
+        return new Error(thrown);
+    }
+    if (!isObject(thrown)) {
+        return new Error(`Unknown error: ${stringify(thrown)}`);
+    }
+    const code = typeof thrown.code === 'number' && Number.isInteger(thrown.code)
+        ? thrown.code
+        : undefined;
+    let message = 'Unknown error';
+    if (typeof thrown.message === 'string') {
+        message = thrown.message;
+    }
+    else if (typeof code === 'number') {
+        message = getMessageFromCode(code, message);
+    }
+    const { stack, cause, data } = thrown;
+    const error = code === undefined
+        ? // Jest complains if we use the `@ts-expect-error` directive here.
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore - Our error type is outdated.
+            new Error(message, { cause })
+        : new JsonRpcError(code, message, {
+            ...(isObject(data) ? data : undefined),
+            cause,
+        });
+    if (typeof stack === 'string') {
+        error.stack = stack;
+    }
+    return error;
+}
+//# sourceMappingURL=compatibility-utils.mjs.map

package/dist/v2/compatibility-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility-utils.mjs","sourceRoot":"","sources":["../../src/v2/compatibility-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { getMessageFromCode, JsonRpcError } from '@metamask/rpc-errors';\nimport type { Json } from '@metamask/utils';\nimport { hasProperty, isObject } from '@metamask/utils';\n// ATTN: We must NOT use 'klona/full' here because it freezes properties on the clone.\nimport { klona } from 'klona';\n\nimport { MiddlewareContext } from './MiddlewareContext';\nimport { stringify, type JsonRpcRequest } from './utils';\n\n// Legacy engine compatibility utils\n\n/**\n * Create a deep clone of a value as follows:\n * - Assumes acyclical objects\n * - Does not copy property descriptors (i.e. uses mutable defaults)\n * - Ignores non-enumerable properties\n * - Ignores getters and setters\n *\n * @throws If the value is an object with a circular reference.\n * @param value - The value to clone.\n * @returns The cloned value.\n */\nexport const deepClone = <T>(value: T): DeepCloned<T> =>\n  klona(value) as DeepCloned<T>;\n\n// Matching the default implementation of klona, this type:\n// - Removes readonly modifiers\n// - Excludes non-enumerable / symbol properties\ntype DeepCloned<T> = T extends readonly (infer U)[]\n  ? DeepCloned<U>[]\n  : T extends object\n    ? { -readonly [K in keyof T & (string | number)]: DeepCloned<T[K]> }\n    : T;\n\n/**\n * Standard JSON-RPC request properties.\n */\nexport const requestProps = ['jsonrpc', 'method', 'params', 'id'];\n\n/**\n * Make a JSON-RPC request from a legacy request. Clones the params to avoid\n * freezing them, which could cause errors in an involved legacy engine.\n *\n * @param req - The legacy request to make a request from.\n * @returns The JSON-RPC request.\n */\nexport function fromLegacyRequest<Request extends JsonRpcRequest>(\n  req: Request,\n): Request {\n  const request = {\n    jsonrpc: '2.0' as const,\n    method: req.method,\n  } as Partial<Request>;\n  request.id = req.id;\n  if (hasProperty(req, 'params') && req.params !== undefined) {\n    request.params = deepClone(req.params);\n  }\n  return request as Request;\n}\n\n/**\n * Make a middleware context from a legacy request by copying over all non-JSON-RPC\n * properties from the request to the context object.\n *\n * @param req - The legacy request to make a context from.\n * @returns The middleware context.\n */\nexport function makeContext<Request extends Record<string | symbol, unknown>>(\n  req: Request,\n): MiddlewareContext {\n  const context = new MiddlewareContext();\n  propagateToContext(req, context);\n  return context;\n}\n\n/**\n * Copies non-JSON-RPC string properties from the request to the context.\n *\n * For compatibility with our problematic practice of appending non-standard\n * fields to requests for inter-middleware communication in the legacy engine.\n *\n * **ATTN:** Only string properties that do not already exist in the context\n * are copied.\n *\n * @param req - The request to propagate the context from.\n * @param context - The context to propagate to.\n */\nexport function propagateToContext(\n  req: Record<string, unknown>,\n  context: MiddlewareContext<Record<string, unknown>>,\n) {\n  Object.keys(req)\n    .filter(\n      (key) =>\n        typeof key === 'string' &&\n        !requestProps.includes(key) &&\n        !context.has(key),\n    )\n    .forEach((key) => {\n      context.set(key, req[key]);\n    });\n}\n\n/**\n * Copies non-JSON-RPC string properties from the context to the request.\n *\n * For compatibility with our problematic practice of appending non-standard\n * fields to requests for inter-middleware communication in the legacy engine.\n *\n * **ATTN:** Only string properties are copied.\n *\n * @param req - The request to propagate the context to.\n * @param context - The context to propagate from.\n */\nexport function propagateToRequest(\n  req: Record<string, unknown>,\n  context: MiddlewareContext,\n) {\n  Array.from(context.keys())\n    .filter(\n      ((key) => typeof key === 'string' && !requestProps.includes(key)) as (\n        value: unknown,\n      ) => value is string,\n    )\n    .forEach((key) => {\n      req[key] = context.get(key);\n    });\n}\n\n/**\n * Unserialize an error from a thrown value. Creates a {@link JsonRpcError} if\n * the thrown value is an object with a `code` property. Otherwise, creates a\n * plain {@link Error}.\n *\n * @param thrown - The thrown value to unserialize.\n * @returns The unserialized error.\n */\nexport function unserializeError(thrown: unknown): Error | JsonRpcError<Json> {\n  // @ts-expect-error - New, but preferred if available.\n  // See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/isError\n  if (typeof Error.isError === 'function' && Error.isError(thrown)) {\n    return thrown as Error;\n  }\n  // Unlike Error.isError, instanceof does not work for Errors from other realms.\n  if (thrown instanceof Error) {\n    return thrown;\n  }\n  if (typeof thrown === 'string') {\n    return new Error(thrown);\n  }\n  if (!isObject(thrown)) {\n    return new Error(`Unknown error: ${stringify(thrown)}`);\n  }\n\n  const code =\n    typeof thrown.code === 'number' && Number.isInteger(thrown.code)\n      ? thrown.code\n      : undefined;\n\n  let message = 'Unknown error';\n  if (typeof thrown.message === 'string') {\n    message = thrown.message;\n  } else if (typeof code === 'number') {\n    message = getMessageFromCode(code, message);\n  }\n\n  const { stack, cause, data } = thrown;\n\n  const error =\n    code === undefined\n      ? // Jest complains if we use the `@ts-expect-error` directive here.\n        // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n        // @ts-ignore - Our error type is outdated.\n        new Error(message, { cause })\n      : new JsonRpcError(code, message, {\n          ...(isObject(data) ? data : undefined),\n          cause,\n        });\n\n  if (typeof stack === 'string') {\n    error.stack = stack;\n  }\n\n  return error;\n}\n"]}

package/dist/v2/index.cjs

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonRpcEngineError = exports.isRequest = exports.isNotification = exports.JsonRpcServer = exports.getUniqueId = exports.asLegacyMiddleware = void 0;
+var asLegacyMiddleware_1 = require("./asLegacyMiddleware.cjs");
+Object.defineProperty(exports, "asLegacyMiddleware", { enumerable: true, get: function () { return asLegacyMiddleware_1.asLegacyMiddleware; } });
+var getUniqueId_1 = require("../getUniqueId.cjs");
+Object.defineProperty(exports, "getUniqueId", { enumerable: true, get: function () { return getUniqueId_1.getUniqueId; } });
+__exportStar(require("./JsonRpcEngineV2.cjs"), exports);
+var JsonRpcServer_1 = require("./JsonRpcServer.cjs");
+Object.defineProperty(exports, "JsonRpcServer", { enumerable: true, get: function () { return JsonRpcServer_1.JsonRpcServer; } });
+var utils_1 = require("./utils.cjs");
+Object.defineProperty(exports, "isNotification", { enumerable: true, get: function () { return utils_1.isNotification; } });
+Object.defineProperty(exports, "isRequest", { enumerable: true, get: function () { return utils_1.isRequest; } });
+Object.defineProperty(exports, "JsonRpcEngineError", { enumerable: true, get: function () { return utils_1.JsonRpcEngineError; } });
+//# sourceMappingURL=index.cjs.map

package/dist/v2/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/v2/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,+DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,kDAA6C;AAApC,0GAAA,WAAW,OAAA;AACpB,wDAAkC;AAClC,qDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,qCAAwE;AAA/D,uGAAA,cAAc,OAAA;AAAE,kGAAA,SAAS,OAAA;AAAE,2GAAA,kBAAkB,OAAA","sourcesContent":["export { asLegacyMiddleware } from './asLegacyMiddleware';\nexport { getUniqueId } from '../getUniqueId';\nexport * from './JsonRpcEngineV2';\nexport { JsonRpcServer } from './JsonRpcServer';\nexport type { MiddlewareContext, EmptyContext } from './MiddlewareContext';\nexport { isNotification, isRequest, JsonRpcEngineError } from './utils';\nexport type {\n  Json,\n  JsonRpcCall,\n  JsonRpcNotification,\n  JsonRpcParams,\n  JsonRpcRequest,\n} from './utils';\n"]}

package/dist/v2/index.d.cts

@@ -0,0 +1,8 @@
+export { asLegacyMiddleware } from "./asLegacyMiddleware.cjs";
+export { getUniqueId } from "../getUniqueId.cjs";
+export * from "./JsonRpcEngineV2.cjs";
+export { JsonRpcServer } from "./JsonRpcServer.cjs";
+export type { MiddlewareContext, EmptyContext } from "./MiddlewareContext.cjs";
+export { isNotification, isRequest, JsonRpcEngineError } from "./utils.cjs";
+export type { Json, JsonRpcCall, JsonRpcNotification, JsonRpcParams, JsonRpcRequest, } from "./utils.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/v2/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/v2/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iCAA6B;AAC1D,OAAO,EAAE,WAAW,EAAE,2BAAuB;AAC7C,sCAAkC;AAClC,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAChD,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,gCAA4B;AAC3E,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,kBAAkB,EAAE,oBAAgB;AACxE,YAAY,EACV,IAAI,EACJ,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,GACf,oBAAgB"}

package/dist/v2/index.d.mts

@@ -0,0 +1,8 @@
+export { asLegacyMiddleware } from "./asLegacyMiddleware.mjs";
+export { getUniqueId } from "../getUniqueId.mjs";
+export * from "./JsonRpcEngineV2.mjs";
+export { JsonRpcServer } from "./JsonRpcServer.mjs";
+export type { MiddlewareContext, EmptyContext } from "./MiddlewareContext.mjs";
+export { isNotification, isRequest, JsonRpcEngineError } from "./utils.mjs";
+export type { Json, JsonRpcCall, JsonRpcNotification, JsonRpcParams, JsonRpcRequest, } from "./utils.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/v2/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/v2/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iCAA6B;AAC1D,OAAO,EAAE,WAAW,EAAE,2BAAuB;AAC7C,sCAAkC;AAClC,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAChD,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,gCAA4B;AAC3E,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,kBAAkB,EAAE,oBAAgB;AACxE,YAAY,EACV,IAAI,EACJ,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,GACf,oBAAgB"}

package/dist/v2/index.mjs

@@ -0,0 +1,6 @@
+export { asLegacyMiddleware } from "./asLegacyMiddleware.mjs";
+export { getUniqueId } from "../getUniqueId.mjs";
+export * from "./JsonRpcEngineV2.mjs";
+export { JsonRpcServer } from "./JsonRpcServer.mjs";
+export { isNotification, isRequest, JsonRpcEngineError } from "./utils.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/v2/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/v2/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iCAA6B;AAC1D,OAAO,EAAE,WAAW,EAAE,2BAAuB;AAC7C,sCAAkC;AAClC,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAEhD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,kBAAkB,EAAE,oBAAgB","sourcesContent":["export { asLegacyMiddleware } from './asLegacyMiddleware';\nexport { getUniqueId } from '../getUniqueId';\nexport * from './JsonRpcEngineV2';\nexport { JsonRpcServer } from './JsonRpcServer';\nexport type { MiddlewareContext, EmptyContext } from './MiddlewareContext';\nexport { isNotification, isRequest, JsonRpcEngineError } from './utils';\nexport type {\n  Json,\n  JsonRpcCall,\n  JsonRpcNotification,\n  JsonRpcParams,\n  JsonRpcRequest,\n} from './utils';\n"]}