@metamask-previews/json-rpc-engine 10.2.4-preview-427372d → 10.2.4-preview-45a82ea8e

package/dist/v2/createMethodMiddleware.d.mts

@@ -12,6 +12,9 @@ type HandlerHooks<Handler> = Handler extends {
 } ? Options extends {
     hooks: infer Hooks;
 } ? Hooks : never : never;
+/**
+ * A `JsonRpcEngineV2` method middleware handler.
+ */
 export type MethodHandler<Hooks extends Record<string, unknown> = never, MessengerActions extends ActionConstraint = never, Parameters extends JsonRpcParams = JsonRpcParams, Result extends Json = Json, Context extends ContextConstraint = ContextConstraint> = {
     implementation: (options: {
         request: Readonly<JsonRpcRequest<Parameters>>;
@@ -42,11 +45,18 @@ type AnyMethodHandler = {
     hookNames?: Record<string, true>;
     actionNames?: readonly string[];
 };
-export type CreateMethodMiddlewareOptions<Handlers extends Record<string, AnyMethodHandler>> = {
+type CreateMethodMiddlewareBaseOptions<Handlers extends Record<string, AnyMethodHandler>> = {
     handlers: Handlers;
-    messenger: Messenger<string, HandlerActions<Handlers[keyof Handlers]>>;
     hooks: UnionToIntersection<HandlerHooks<Handlers[keyof Handlers]>>;
 };
+/**
+ * Options for {@link createMethodMiddleware}.
+ */
+export type CreateMethodMiddlewareOptions<Handlers extends Record<string, AnyMethodHandler>> = CreateMethodMiddlewareBaseOptions<Handlers> & ([HandlerActions<Handlers[keyof Handlers]>] extends [never] ? {
+    messenger?: undefined;
+} : {
+    messenger: Messenger<string, HandlerActions<Handlers[keyof Handlers]>>;
+});
 /**
  * Create a JSON-RPC middleware that handles the passed JSON-RPC method handlers using the messenger and hooks.
  *
@@ -57,18 +67,5 @@ export type CreateMethodMiddlewareOptions<Handlers extends Record<string, AnyMet
  * @returns A JsonRpcEngineV2 middleware.
  */
 export declare function createMethodMiddleware<Handlers extends Record<string, AnyMethodHandler>, Context extends ContextConstraint>(options: CreateMethodMiddlewareOptions<Handlers>): JsonRpcMiddleware<JsonRpcRequest, Json, Context>;
-/**
- * Returns the subset of the specified `hooks` that are included in the
- * `hookNames` object. This is a Principle of Least Authority (POLA) measure
- * to ensure that each RPC method implementation only has access to the
- * API "hooks" it needs to do its job.
- *
- * @param hooks - The hooks to select from.
- * @param hookNames - The names of the hooks to select.
- * @returns The selected hooks.
- * @template Hooks - The hooks to select from.
- * @template HookName - The names of the hooks to select.
- */
-export declare function selectHooks<Hooks extends Record<string, unknown>, HookName extends keyof Hooks>(hooks: Hooks, hookNames?: Record<HookName, true>): Pick<Hooks, HookName> | undefined;
 export {};
 //# sourceMappingURL=createMethodMiddleware.d.mts.map

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

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

package/dist/v2/createMethodMiddleware.mjs

@@ -1,4 +1,5 @@
 import { Messenger } from "@metamask/messenger";
+import { assertExpectedHooks, createHandlerMessenger, selectHooks } from "./utils.mjs";
 /**
  * Create a JSON-RPC middleware that handles the passed JSON-RPC method handlers using the messenger and hooks.
  *
@@ -11,15 +12,14 @@ import { Messenger } from "@metamask/messenger";
 export function createMethodMiddleware(options) {
     const { messenger: rootMessenger } = options;
     const allHooks = options.hooks;
+    const expectedHookNames = new Set(Object.values(options.handlers).flatMap((handler) => handler.hookNames ? Object.getOwnPropertyNames(handler.hookNames) : []));
+    assertExpectedHooks(allHooks, expectedHookNames);
     const handlers = Object.entries(options.handlers).reduce((accumulator, [handlerName, handler]) => {
         const handlerHooks = selectHooks(allHooks, handler.hookNames) ?? {};
-        const handlerMessenger = new Messenger({
+        const handlerMessenger = createHandlerMessenger({
             namespace: handlerName,
-            parent: rootMessenger,
-        });
-        rootMessenger.delegate({
-            actions: (handler.actionNames ?? []),
-            messenger: handlerMessenger,
+            actionNames: handler.actionNames,
+            rootMessenger,
         });
         accumulator[handlerName] = {
             implementation: handler.implementation,
@@ -37,26 +37,4 @@ export function createMethodMiddleware(options) {
         return implementation({ request, context, next, hooks, messenger });
     };
 }
-/**
- * Returns the subset of the specified `hooks` that are included in the
- * `hookNames` object. This is a Principle of Least Authority (POLA) measure
- * to ensure that each RPC method implementation only has access to the
- * API "hooks" it needs to do its job.
- *
- * @param hooks - The hooks to select from.
- * @param hookNames - The names of the hooks to select.
- * @returns The selected hooks.
- * @template Hooks - The hooks to select from.
- * @template HookName - The names of the hooks to select.
- */
-export function selectHooks(hooks, hookNames) {
-    if (hookNames) {
-        return Object.keys(hookNames).reduce((hookSubset, _hookName) => {
-            const hookName = _hookName;
-            hookSubset[hookName] = hooks[hookName];
-            return hookSubset;
-        }, {});
-    }
-    return undefined;
-}
 //# sourceMappingURL=createMethodMiddleware.mjs.map

package/dist/v2/createMethodMiddleware.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createMethodMiddleware.mjs","sourceRoot":"","sources":["../../src/v2/createMethodMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,SAAS,EAAE,4BAA4B;AA8ElE;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAIpC,OAAgD;IAEhD,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAgC,CAAC;IAE1D,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAEtD,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE;QACxC,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACpE,MAAM,gBAAgB,GAAG,IAAI,SAAS,CAKpC;YACA,SAAS,EAAE,WAAW;YACtB,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;QAEH,aAAa,CAAC,QAAQ,CAAC;YACrB,OAAO,EAAE,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAExB;YACX,SAAS,EAAE,gBAAgB;SAC5B,CAAC,CAAC;QAEH,WAAW,CAAC,WAAW,CAAC,GAAG;YACzB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,KAAK,EAAE,YAAY;YACnB,SAAS,EAAE,gBAAgB;SAC5B,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;QACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAED,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAErD,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAIzB,KAAY,EACZ,SAAkC;IAElC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAClC,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE;YACxB,MAAM,QAAQ,GAAG,SAAqB,CAAC;YACvC,UAAU,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;YACvC,OAAO,UAAU,CAAC;QACpB,CAAC,EACD,EAAE,CACsB,CAAC;IAC7B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import { ActionConstraint, Messenger } from '@metamask/messenger';\n\nimport { JsonRpcMiddleware, Next } from './JsonRpcEngineV2';\nimport { ContextConstraint } from './MiddlewareContext';\nimport {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  UnionToIntersection,\n} from './utils';\n\n// The helpers below seem excessive, but they are required for inference of hooks/actions.\ntype HandlerActions<Handler> = Handler extends {\n  implementation: (options: infer Options) => unknown;\n}\n  ? Options extends { messenger: Messenger<string, infer Actions> }\n    ? Actions\n    : never\n  : never;\n\ntype HandlerHooks<Handler> = Handler extends {\n  implementation: (options: infer Options) => unknown;\n}\n  ? Options extends { hooks: infer Hooks }\n    ? Hooks\n    : never\n  : never;\n\nexport type MethodHandler<\n  Hooks extends Record<string, unknown> = never,\n  MessengerActions extends ActionConstraint = never,\n  Parameters extends JsonRpcParams = JsonRpcParams,\n  Result extends Json = Json,\n  Context extends ContextConstraint = ContextConstraint,\n> = {\n  implementation: (options: {\n    request: Readonly<JsonRpcRequest<Parameters>>;\n    context: Context;\n    next: Next<JsonRpcRequest>;\n    messenger: Messenger<string, MessengerActions>;\n    hooks: Hooks;\n  }) => Promise<Result> | Result;\n} & ([Hooks] extends [never]\n  ? { hookNames?: undefined }\n  : { hookNames: { [Key in keyof Hooks]: true } }) &\n  ([MessengerActions] extends [never]\n    ? { actionNames?: undefined }\n    : { actionNames: MessengerActions['type'][] });\n\ntype AnyMethodHandler = {\n  implementation(\n    this: void,\n    options: {\n      request: Readonly<JsonRpcRequest>;\n      context: ContextConstraint;\n      next: Next<JsonRpcRequest>;\n      messenger: unknown;\n      hooks: unknown;\n    },\n  ): Promise<Json> | Json;\n  hookNames?: Record<string, true>;\n  actionNames?: readonly string[];\n};\n\nexport type CreateMethodMiddlewareOptions<\n  Handlers extends Record<string, AnyMethodHandler>,\n> = {\n  handlers: Handlers;\n  messenger: Messenger<string, HandlerActions<Handlers[keyof Handlers]>>;\n  hooks: UnionToIntersection<HandlerHooks<Handlers[keyof Handlers]>>;\n};\n\ntype ResolvedHandler = {\n  implementation: AnyMethodHandler['implementation'];\n  hooks: Record<string, unknown>;\n  messenger: Messenger<string, ActionConstraint>;\n};\n\n/**\n * Create a JSON-RPC middleware that handles the passed JSON-RPC method handlers using the messenger and hooks.\n *\n * @param options The options.\n * @param options.handlers - The JSON-RPC method handler implementations.\n * @param options.messenger - The messenger to be used by the handlers.\n * @param options.hooks - The hooks to be used by the handlers.\n * @returns A JsonRpcEngineV2 middleware.\n */\nexport function createMethodMiddleware<\n  Handlers extends Record<string, AnyMethodHandler>,\n  Context extends ContextConstraint,\n>(\n  options: CreateMethodMiddlewareOptions<Handlers>,\n): JsonRpcMiddleware<JsonRpcRequest, Json, Context> {\n  const { messenger: rootMessenger } = options;\n  const allHooks = options.hooks as Record<string, unknown>;\n\n  const handlers = Object.entries(options.handlers).reduce<\n    Record<string, ResolvedHandler>\n  >((accumulator, [handlerName, handler]) => {\n    const handlerHooks = selectHooks(allHooks, handler.hookNames) ?? {};\n    const handlerMessenger = new Messenger<\n      string,\n      HandlerActions<Handlers[keyof Handlers]>,\n      never,\n      typeof rootMessenger\n    >({\n      namespace: handlerName,\n      parent: rootMessenger,\n    });\n\n    rootMessenger.delegate({\n      actions: (handler.actionNames ?? []) as HandlerActions<\n        Handlers[keyof Handlers]\n      >['type'][],\n      messenger: handlerMessenger,\n    });\n\n    accumulator[handlerName] = {\n      implementation: handler.implementation,\n      hooks: handlerHooks,\n      messenger: handlerMessenger,\n    };\n    return accumulator;\n  }, {});\n\n  return ({ request, context, next }) => {\n    const handler = handlers[request.method];\n    if (handler === undefined) {\n      return next();\n    }\n\n    const { implementation, hooks, messenger } = handler;\n\n    return implementation({ request, context, next, hooks, messenger });\n  };\n}\n\n/**\n * Returns the subset of the specified `hooks` that are included in the\n * `hookNames` object. This is a Principle of Least Authority (POLA) measure\n * to ensure that each RPC method implementation only has access to the\n * API \"hooks\" it needs to do its job.\n *\n * @param hooks - The hooks to select from.\n * @param hookNames - The names of the hooks to select.\n * @returns The selected hooks.\n * @template Hooks - The hooks to select from.\n * @template HookName - The names of the hooks to select.\n */\nexport function selectHooks<\n  Hooks extends Record<string, unknown>,\n  HookName extends keyof Hooks,\n>(\n  hooks: Hooks,\n  hookNames?: Record<HookName, true>,\n): Pick<Hooks, HookName> | undefined {\n  if (hookNames) {\n    return Object.keys(hookNames).reduce<Partial<Pick<Hooks, HookName>>>(\n      (hookSubset, _hookName) => {\n        const hookName = _hookName as HookName;\n        hookSubset[hookName] = hooks[hookName];\n        return hookSubset;\n      },\n      {},\n    ) as Pick<Hooks, HookName>;\n  }\n  return undefined;\n}\n"]}
+{"version":3,"file":"createMethodMiddleware.mjs","sourceRoot":"","sources":["../../src/v2/createMethodMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,SAAS,EAAE,4BAA4B;AAIlE,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EAKZ,oBAAgB;AAoFjB;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAIpC,OAAgD;IAEhD,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAgC,CAAC;IAE1D,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAC/B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAClD,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CACvE,CACF,CAAC;IACF,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAEtD,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE;QACxC,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACpE,MAAM,gBAAgB,GAAG,sBAAsB,CAE7C;YACA,SAAS,EAAE,WAAW;YACtB,WAAW,EAAE,OAAO,CAAC,WAER;YACb,aAAa;SACd,CAAC,CAAC;QAEH,WAAW,CAAC,WAAW,CAAC,GAAG;YACzB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,KAAK,EAAE,YAAY;YACnB,SAAS,EAAE,gBAAgB;SAC5B,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;QACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAED,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAErD,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { ActionConstraint, Messenger } from '@metamask/messenger';\n\nimport { JsonRpcMiddleware, Next } from './JsonRpcEngineV2';\nimport { ContextConstraint } from './MiddlewareContext';\nimport {\n  assertExpectedHooks,\n  createHandlerMessenger,\n  selectHooks,\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  UnionToIntersection,\n} from './utils';\n\ntype HandlerActions<Handler> = Handler extends {\n  implementation: (options: infer Options) => unknown;\n}\n  ? Options extends { messenger: Messenger<string, infer Actions> }\n    ? Actions\n    : never\n  : never;\n\ntype HandlerHooks<Handler> = Handler extends {\n  implementation: (options: infer Options) => unknown;\n}\n  ? Options extends { hooks: infer Hooks }\n    ? Hooks\n    : never\n  : never;\n\n/**\n * A `JsonRpcEngineV2` method middleware handler.\n */\nexport type MethodHandler<\n  Hooks extends Record<string, unknown> = never,\n  MessengerActions extends ActionConstraint = never,\n  Parameters extends JsonRpcParams = JsonRpcParams,\n  Result extends Json = Json,\n  Context extends ContextConstraint = ContextConstraint,\n> = {\n  implementation: (options: {\n    request: Readonly<JsonRpcRequest<Parameters>>;\n    context: Context;\n    next: Next<JsonRpcRequest>;\n    messenger: Messenger<string, MessengerActions>;\n    hooks: Hooks;\n  }) => Promise<Result> | Result;\n} & ([Hooks] extends [never]\n  ? { hookNames?: undefined }\n  : { hookNames: { [Key in keyof Hooks]: true } }) &\n  ([MessengerActions] extends [never]\n    ? { actionNames?: undefined }\n    : { actionNames: MessengerActions['type'][] });\n\ntype AnyMethodHandler = {\n  implementation(\n    this: void,\n    options: {\n      request: Readonly<JsonRpcRequest>;\n      context: ContextConstraint;\n      next: Next<JsonRpcRequest>;\n      messenger: unknown;\n      hooks: unknown;\n    },\n  ): Promise<Json> | Json;\n  hookNames?: Record<string, true>;\n  actionNames?: readonly string[];\n};\n\ntype CreateMethodMiddlewareBaseOptions<\n  Handlers extends Record<string, AnyMethodHandler>,\n> = {\n  handlers: Handlers;\n  hooks: UnionToIntersection<HandlerHooks<Handlers[keyof Handlers]>>;\n};\n\n/**\n * Options for {@link createMethodMiddleware}.\n */\nexport type CreateMethodMiddlewareOptions<\n  Handlers extends Record<string, AnyMethodHandler>,\n> = CreateMethodMiddlewareBaseOptions<Handlers> &\n  ([HandlerActions<Handlers[keyof Handlers]>] extends [never]\n    ? {\n        messenger?: undefined;\n      }\n    : {\n        messenger: Messenger<string, HandlerActions<Handlers[keyof Handlers]>>;\n      });\n\ntype ResolvedHandler = {\n  implementation: AnyMethodHandler['implementation'];\n  hooks: Record<string, unknown>;\n  messenger?: Messenger<string, ActionConstraint> | undefined;\n};\n\n/**\n * Create a JSON-RPC middleware that handles the passed JSON-RPC method handlers using the messenger and hooks.\n *\n * @param options The options.\n * @param options.handlers - The JSON-RPC method handler implementations.\n * @param options.messenger - The messenger to be used by the handlers.\n * @param options.hooks - The hooks to be used by the handlers.\n * @returns A JsonRpcEngineV2 middleware.\n */\nexport function createMethodMiddleware<\n  Handlers extends Record<string, AnyMethodHandler>,\n  Context extends ContextConstraint,\n>(\n  options: CreateMethodMiddlewareOptions<Handlers>,\n): JsonRpcMiddleware<JsonRpcRequest, Json, Context> {\n  const { messenger: rootMessenger } = options;\n  const allHooks = options.hooks as Record<string, unknown>;\n\n  const expectedHookNames = new Set(\n    Object.values(options.handlers).flatMap((handler) =>\n      handler.hookNames ? Object.getOwnPropertyNames(handler.hookNames) : [],\n    ),\n  );\n  assertExpectedHooks(allHooks, expectedHookNames);\n\n  const handlers = Object.entries(options.handlers).reduce<\n    Record<string, ResolvedHandler>\n  >((accumulator, [handlerName, handler]) => {\n    const handlerHooks = selectHooks(allHooks, handler.hookNames) ?? {};\n    const handlerMessenger = createHandlerMessenger<\n      HandlerActions<Handlers[keyof Handlers]>\n    >({\n      namespace: handlerName,\n      actionNames: handler.actionNames as\n        | readonly HandlerActions<Handlers[keyof Handlers]>['type'][]\n        | undefined,\n      rootMessenger,\n    });\n\n    accumulator[handlerName] = {\n      implementation: handler.implementation,\n      hooks: handlerHooks,\n      messenger: handlerMessenger,\n    };\n    return accumulator;\n  }, {});\n\n  return ({ request, context, next }) => {\n    const handler = handlers[request.method];\n    if (handler === undefined) {\n      return next();\n    }\n\n    const { implementation, hooks, messenger } = handler;\n\n    return implementation({ request, context, next, hooks, messenger });\n  };\n}\n"]}

package/dist/v2/index.cjs

@@ -1,12 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JsonRpcEngineError = exports.isRequest = exports.isNotification = exports.MiddlewareContext = exports.JsonRpcServer = exports.JsonRpcEngineV2 = exports.createScaffoldMiddleware = exports.createOriginMiddleware = exports.createMethodMiddleware = exports.selectHooks = exports.getUniqueId = exports.asLegacyMiddleware = void 0;
+exports.selectHooks = exports.JsonRpcEngineError = exports.isRequest = exports.isNotification = exports.MiddlewareContext = exports.JsonRpcServer = exports.JsonRpcEngineV2 = exports.createScaffoldMiddleware = exports.createOriginMiddleware = exports.createMethodMiddleware = 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; } });
 var createMethodMiddleware_1 = require("./createMethodMiddleware.cjs");
-Object.defineProperty(exports, "selectHooks", { enumerable: true, get: function () { return createMethodMiddleware_1.selectHooks; } });
 Object.defineProperty(exports, "createMethodMiddleware", { enumerable: true, get: function () { return createMethodMiddleware_1.createMethodMiddleware; } });
 var createOriginMiddleware_1 = require("./createOriginMiddleware.cjs");
 Object.defineProperty(exports, "createOriginMiddleware", { enumerable: true, get: function () { return createOriginMiddleware_1.createOriginMiddleware; } });
@@ -22,4 +21,5 @@ 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; } });
+Object.defineProperty(exports, "selectHooks", { enumerable: true, get: function () { return utils_1.selectHooks; } });
 //# sourceMappingURL=index.cjs.map

package/dist/v2/index.cjs.map

@@ -1 +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,uEAA+E;AAAtE,qHAAA,WAAW,OAAA;AAAE,gIAAA,sBAAsB,OAAA;AAE5C,uEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,2EAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,yDAAoD;AAA3C,kHAAA,eAAe,OAAA;AAWxB,qDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,6DAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAE1B,qCAAwE;AAA/D,uGAAA,cAAc,OAAA;AAAE,kGAAA,SAAS,OAAA;AAAE,2GAAA,kBAAkB,OAAA","sourcesContent":["export { asLegacyMiddleware } from './asLegacyMiddleware';\nexport { getUniqueId } from '../getUniqueId';\nexport { selectHooks, createMethodMiddleware } from './createMethodMiddleware';\nexport type { MethodHandler } from './createMethodMiddleware';\nexport { createOriginMiddleware } from './createOriginMiddleware';\nexport { createScaffoldMiddleware } from './createScaffoldMiddleware';\nexport { JsonRpcEngineV2 } from './JsonRpcEngineV2';\nexport type {\n  JsonRpcMiddleware,\n  HandleOptions,\n  MergedContextOf,\n  MiddlewareParams,\n  MiddlewareConstraint,\n  Next,\n  RequestOf,\n  ResultConstraint,\n} from './JsonRpcEngineV2';\nexport { JsonRpcServer } from './JsonRpcServer';\nexport { MiddlewareContext } from './MiddlewareContext';\nexport type { EmptyContext, ContextConstraint } from './MiddlewareContext';\nexport { isNotification, isRequest, JsonRpcEngineError } from './utils';\nexport type {\n  Json,\n  JsonRpcCall,\n  JsonRpcNotification,\n  JsonRpcParams,\n  JsonRpcRequest,\n} from './utils';\n"]}
+{"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,uEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAE/B,uEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,2EAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,yDAAoD;AAA3C,kHAAA,eAAe,OAAA;AAWxB,qDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,6DAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAE1B,qCAKiB;AAJf,uGAAA,cAAc,OAAA;AACd,kGAAA,SAAS,OAAA;AACT,2GAAA,kBAAkB,OAAA;AAClB,oGAAA,WAAW,OAAA","sourcesContent":["export { asLegacyMiddleware } from './asLegacyMiddleware';\nexport { getUniqueId } from '../getUniqueId';\nexport { createMethodMiddleware } from './createMethodMiddleware';\nexport type { MethodHandler } from './createMethodMiddleware';\nexport { createOriginMiddleware } from './createOriginMiddleware';\nexport { createScaffoldMiddleware } from './createScaffoldMiddleware';\nexport { JsonRpcEngineV2 } from './JsonRpcEngineV2';\nexport type {\n  JsonRpcMiddleware,\n  HandleOptions,\n  MergedContextOf,\n  MiddlewareParams,\n  MiddlewareConstraint,\n  Next,\n  RequestOf,\n  ResultConstraint,\n} from './JsonRpcEngineV2';\nexport { JsonRpcServer } from './JsonRpcServer';\nexport { MiddlewareContext } from './MiddlewareContext';\nexport type { EmptyContext, ContextConstraint } from './MiddlewareContext';\nexport {\n  isNotification,\n  isRequest,\n  JsonRpcEngineError,\n  selectHooks,\n} from './utils';\nexport type {\n  Json,\n  JsonRpcCall,\n  JsonRpcNotification,\n  JsonRpcParams,\n  JsonRpcRequest,\n} from './utils';\n"]}

package/dist/v2/index.d.cts

@@ -1,6 +1,6 @@
 export { asLegacyMiddleware } from "./asLegacyMiddleware.cjs";
 export { getUniqueId } from "../getUniqueId.cjs";
-export { selectHooks, createMethodMiddleware } from "./createMethodMiddleware.cjs";
+export { createMethodMiddleware } from "./createMethodMiddleware.cjs";
 export type { MethodHandler } from "./createMethodMiddleware.cjs";
 export { createOriginMiddleware } from "./createOriginMiddleware.cjs";
 export { createScaffoldMiddleware } from "./createScaffoldMiddleware.cjs";
@@ -9,6 +9,6 @@ export type { JsonRpcMiddleware, HandleOptions, MergedContextOf, MiddlewareParam
 export { JsonRpcServer } from "./JsonRpcServer.cjs";
 export { MiddlewareContext } from "./MiddlewareContext.cjs";
 export type { EmptyContext, ContextConstraint } from "./MiddlewareContext.cjs";
-export { isNotification, isRequest, JsonRpcEngineError } from "./utils.cjs";
+export { isNotification, isRequest, JsonRpcEngineError, selectHooks, } 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

@@ -1 +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,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,qCAAiC;AAC/E,YAAY,EAAE,aAAa,EAAE,qCAAiC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,qCAAiC;AAClE,OAAO,EAAE,wBAAwB,EAAE,uCAAmC;AACtE,OAAO,EAAE,eAAe,EAAE,8BAA0B;AACpD,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,IAAI,EACJ,SAAS,EACT,gBAAgB,GACjB,8BAA0B;AAC3B,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAChD,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AACxD,YAAY,EAAE,YAAY,EAAE,iBAAiB,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"}
+{"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,OAAO,EAAE,sBAAsB,EAAE,qCAAiC;AAClE,YAAY,EAAE,aAAa,EAAE,qCAAiC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,qCAAiC;AAClE,OAAO,EAAE,wBAAwB,EAAE,uCAAmC;AACtE,OAAO,EAAE,eAAe,EAAE,8BAA0B;AACpD,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,IAAI,EACJ,SAAS,EACT,gBAAgB,GACjB,8BAA0B;AAC3B,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAChD,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AACxD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,gCAA4B;AAC3E,OAAO,EACL,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,WAAW,GACZ,oBAAgB;AACjB,YAAY,EACV,IAAI,EACJ,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,GACf,oBAAgB"}

package/dist/v2/index.d.mts

@@ -1,6 +1,6 @@
 export { asLegacyMiddleware } from "./asLegacyMiddleware.mjs";
 export { getUniqueId } from "../getUniqueId.mjs";
-export { selectHooks, createMethodMiddleware } from "./createMethodMiddleware.mjs";
+export { createMethodMiddleware } from "./createMethodMiddleware.mjs";
 export type { MethodHandler } from "./createMethodMiddleware.mjs";
 export { createOriginMiddleware } from "./createOriginMiddleware.mjs";
 export { createScaffoldMiddleware } from "./createScaffoldMiddleware.mjs";
@@ -9,6 +9,6 @@ export type { JsonRpcMiddleware, HandleOptions, MergedContextOf, MiddlewareParam
 export { JsonRpcServer } from "./JsonRpcServer.mjs";
 export { MiddlewareContext } from "./MiddlewareContext.mjs";
 export type { EmptyContext, ContextConstraint } from "./MiddlewareContext.mjs";
-export { isNotification, isRequest, JsonRpcEngineError } from "./utils.mjs";
+export { isNotification, isRequest, JsonRpcEngineError, selectHooks, } 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

@@ -1 +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,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,qCAAiC;AAC/E,YAAY,EAAE,aAAa,EAAE,qCAAiC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,qCAAiC;AAClE,OAAO,EAAE,wBAAwB,EAAE,uCAAmC;AACtE,OAAO,EAAE,eAAe,EAAE,8BAA0B;AACpD,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,IAAI,EACJ,SAAS,EACT,gBAAgB,GACjB,8BAA0B;AAC3B,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAChD,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AACxD,YAAY,EAAE,YAAY,EAAE,iBAAiB,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"}
+{"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,OAAO,EAAE,sBAAsB,EAAE,qCAAiC;AAClE,YAAY,EAAE,aAAa,EAAE,qCAAiC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,qCAAiC;AAClE,OAAO,EAAE,wBAAwB,EAAE,uCAAmC;AACtE,OAAO,EAAE,eAAe,EAAE,8BAA0B;AACpD,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,IAAI,EACJ,SAAS,EACT,gBAAgB,GACjB,8BAA0B;AAC3B,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAChD,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AACxD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,gCAA4B;AAC3E,OAAO,EACL,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,WAAW,GACZ,oBAAgB;AACjB,YAAY,EACV,IAAI,EACJ,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,GACf,oBAAgB"}

package/dist/v2/index.mjs

@@ -1,10 +1,10 @@
 export { asLegacyMiddleware } from "./asLegacyMiddleware.mjs";
 export { getUniqueId } from "../getUniqueId.mjs";
-export { selectHooks, createMethodMiddleware } from "./createMethodMiddleware.mjs";
+export { createMethodMiddleware } from "./createMethodMiddleware.mjs";
 export { createOriginMiddleware } from "./createOriginMiddleware.mjs";
 export { createScaffoldMiddleware } from "./createScaffoldMiddleware.mjs";
 export { JsonRpcEngineV2 } from "./JsonRpcEngineV2.mjs";
 export { JsonRpcServer } from "./JsonRpcServer.mjs";
 export { MiddlewareContext } from "./MiddlewareContext.mjs";
-export { isNotification, isRequest, JsonRpcEngineError } from "./utils.mjs";
+export { isNotification, isRequest, JsonRpcEngineError, selectHooks } from "./utils.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/v2/index.mjs.map

@@ -1 +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,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,qCAAiC;AAE/E,OAAO,EAAE,sBAAsB,EAAE,qCAAiC;AAClE,OAAO,EAAE,wBAAwB,EAAE,uCAAmC;AACtE,OAAO,EAAE,eAAe,EAAE,8BAA0B;AAWpD,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAChD,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AAExD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,kBAAkB,EAAE,oBAAgB","sourcesContent":["export { asLegacyMiddleware } from './asLegacyMiddleware';\nexport { getUniqueId } from '../getUniqueId';\nexport { selectHooks, createMethodMiddleware } from './createMethodMiddleware';\nexport type { MethodHandler } from './createMethodMiddleware';\nexport { createOriginMiddleware } from './createOriginMiddleware';\nexport { createScaffoldMiddleware } from './createScaffoldMiddleware';\nexport { JsonRpcEngineV2 } from './JsonRpcEngineV2';\nexport type {\n  JsonRpcMiddleware,\n  HandleOptions,\n  MergedContextOf,\n  MiddlewareParams,\n  MiddlewareConstraint,\n  Next,\n  RequestOf,\n  ResultConstraint,\n} from './JsonRpcEngineV2';\nexport { JsonRpcServer } from './JsonRpcServer';\nexport { MiddlewareContext } from './MiddlewareContext';\nexport type { EmptyContext, ContextConstraint } from './MiddlewareContext';\nexport { isNotification, isRequest, JsonRpcEngineError } from './utils';\nexport type {\n  Json,\n  JsonRpcCall,\n  JsonRpcNotification,\n  JsonRpcParams,\n  JsonRpcRequest,\n} from './utils';\n"]}
+{"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,OAAO,EAAE,sBAAsB,EAAE,qCAAiC;AAElE,OAAO,EAAE,sBAAsB,EAAE,qCAAiC;AAClE,OAAO,EAAE,wBAAwB,EAAE,uCAAmC;AACtE,OAAO,EAAE,eAAe,EAAE,8BAA0B;AAWpD,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAChD,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AAExD,OAAO,EACL,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,WAAW,EACZ,oBAAgB","sourcesContent":["export { asLegacyMiddleware } from './asLegacyMiddleware';\nexport { getUniqueId } from '../getUniqueId';\nexport { createMethodMiddleware } from './createMethodMiddleware';\nexport type { MethodHandler } from './createMethodMiddleware';\nexport { createOriginMiddleware } from './createOriginMiddleware';\nexport { createScaffoldMiddleware } from './createScaffoldMiddleware';\nexport { JsonRpcEngineV2 } from './JsonRpcEngineV2';\nexport type {\n  JsonRpcMiddleware,\n  HandleOptions,\n  MergedContextOf,\n  MiddlewareParams,\n  MiddlewareConstraint,\n  Next,\n  RequestOf,\n  ResultConstraint,\n} from './JsonRpcEngineV2';\nexport { JsonRpcServer } from './JsonRpcServer';\nexport { MiddlewareContext } from './MiddlewareContext';\nexport type { EmptyContext, ContextConstraint } from './MiddlewareContext';\nexport {\n  isNotification,\n  isRequest,\n  JsonRpcEngineError,\n  selectHooks,\n} from './utils';\nexport type {\n  Json,\n  JsonRpcCall,\n  JsonRpcNotification,\n  JsonRpcParams,\n  JsonRpcRequest,\n} from './utils';\n"]}

package/dist/v2/utils.cjs

@@ -1,7 +1,8 @@
 "use strict";
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JsonRpcEngineError = exports.isInstance = exports.stringify = exports.isNotification = exports.isRequest = void 0;
+exports.createHandlerMessenger = exports.assertExpectedHooks = exports.selectHooks = exports.JsonRpcEngineError = exports.isInstance = exports.stringify = exports.isNotification = exports.isRequest = void 0;
+const messenger_1 = require("@metamask/messenger");
 const utils_1 = require("@metamask/utils");
 const isRequest = (message) => (0, utils_1.hasProperty)(message, 'id');
 exports.isRequest = isRequest;
@@ -49,4 +50,78 @@ class JsonRpcEngineError extends Error {
 }
 exports.JsonRpcEngineError = JsonRpcEngineError;
 _a = JsonRpcEngineErrorSymbol;
+// Method middleware utils
+/**
+ * Returns the subset of the specified `hooks` that are included in the
+ * `hookNames` object. This is a Principle of Least Authority (POLA) measure
+ * to ensure that each RPC method implementation only has access to the
+ * API "hooks" it needs to do its job.
+ *
+ * @param hooks - The hooks to select from.
+ * @param hookNames - The names of the hooks to select.
+ * @returns The selected hooks, or `undefined` if `hookNames` is not provided.
+ * @template Hooks - The hooks to select from.
+ * @template HookName - The names of the hooks to select.
+ */
+function selectHooks(hooks, hookNames) {
+    if (hookNames) {
+        return Object.keys(hookNames).reduce((subset, name) => {
+            const hookName = name;
+            subset[hookName] = hooks[hookName];
+            return subset;
+        }, {});
+    }
+    return undefined;
+}
+exports.selectHooks = selectHooks;
+/**
+ * Asserts that `hooks` contains exactly the hook names in `expectedHookNames`.
+ * Throws on any missing hooks, then on any extraneous hooks.
+ *
+ * @param hooks - The hooks object to validate.
+ * @param expectedHookNames - The expected hook names.
+ */
+function assertExpectedHooks(hooks, expectedHookNames) {
+    const missingHookNames = [];
+    expectedHookNames.forEach((hookName) => {
+        if (!(0, utils_1.hasProperty)(hooks, hookName)) {
+            missingHookNames.push(hookName);
+        }
+    });
+    if (missingHookNames.length > 0) {
+        throw new Error(`Missing expected hooks:\n\n${missingHookNames.join('\n')}\n`);
+    }
+    const extraneousHookNames = Object.getOwnPropertyNames(hooks).filter((hookName) => !expectedHookNames.has(hookName));
+    if (extraneousHookNames.length > 0) {
+        throw new Error(`Received unexpected hooks:\n\n${extraneousHookNames.join('\n')}\n`);
+    }
+}
+exports.assertExpectedHooks = assertExpectedHooks;
+/**
+ * Creates a per-handler messenger namespaced to `namespace`, and delegates the
+ * specified `actionNames` from `rootMessenger` to it. This lets each handler
+ * call only the actions it declared, per POLA.
+ *
+ * @param options - The options.
+ * @param options.namespace - The namespace for the handler messenger.
+ * @param options.actionNames - Actions to delegate from the root messenger.
+ * @param options.rootMessenger - The root messenger to delegate from. Required
+ * when `actionNames` are provided.
+ * @returns The per-handler messenger.
+ */
+function createHandlerMessenger({ namespace, actionNames, rootMessenger, }) {
+    if (!actionNames) {
+        return undefined;
+    }
+    if (!rootMessenger) {
+        throw new Error('A messenger is required when a handler declares actionNames.');
+    }
+    const handlerMessenger = new messenger_1.Messenger({ namespace, parent: rootMessenger });
+    rootMessenger.delegate({
+        actions: actionNames,
+        messenger: handlerMessenger,
+    });
+    return handlerMessenger;
+}
+exports.createHandlerMessenger = createHandlerMessenger;
 //# sourceMappingURL=utils.cjs.map

package/dist/v2/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../../src/v2/utils.ts"],"names":[],"mappings":";;;;AAAA,2CAAwD;AAkBjD,MAAM,SAAS,GAAG,CACvB,OAA4D,EACzB,EAAE,CAAC,IAAA,mBAAW,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAFtD,QAAA,SAAS,aAE6C;AAE5D,MAAM,cAAc,GAAG,CAC5B,OAA4B,EACY,EAAE,CAAC,CAAC,IAAA,iBAAS,EAAC,OAAO,CAAC,CAAC;AAFpD,QAAA,cAAc,kBAEsC;AAgBjE;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,KAAc;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC;AAFD,8BAEC;AAED;;;;;;GAMG;AACI,MAAM,UAAU,GAAG,CACxB,KAAc,EACd,MAAc,EACoB,EAAE,CACpC,IAAA,gBAAQ,EAAC,KAAK,CAAC,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;AAJlD,QAAA,UAAU,cAIwC;AAE/D,MAAM,wBAAwB,GAAG,MAAM,CAAC,GAAG,CACzC,oCAAoC,CACrC,CAAC;AAEF,MAAa,kBAAmB,SAAQ,KAAK;IAM3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QANjB,4EAA4E;QAC5E,0BAA0B;QAC1B,gDAAgD;QAC/B,QAA0B,GAAG,IAAI,CAAC;QAIjD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,KAAc;QAC9B,OAAO,IAAA,kBAAU,EAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;IACrD,CAAC;CACF;AArBD,gDAqBC;KAjBmB,wBAAwB","sourcesContent":["import { hasProperty, isObject } from '@metamask/utils';\nimport type {\n  JsonRpcNotification,\n  JsonRpcParams,\n  JsonRpcRequest,\n} from '@metamask/utils';\n\nexport type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcNotification,\n} from '@metamask/utils';\n\nexport type JsonRpcCall<Params extends JsonRpcParams = JsonRpcParams> =\n  | JsonRpcNotification<Params>\n  | JsonRpcRequest<Params>;\n\nexport const isRequest = <Params extends JsonRpcParams>(\n  message: JsonRpcCall<Params> | Readonly<JsonRpcCall<Params>>,\n): message is JsonRpcRequest<Params> => hasProperty(message, 'id');\n\nexport const isNotification = <Params extends JsonRpcParams>(\n  message: JsonRpcCall<Params>,\n): message is JsonRpcNotification<Params> => !isRequest(message);\n\n/**\n * An unholy incantation that converts a union of object types into an\n * intersection of object types.\n *\n * @example\n * type A = { a: string } | { b: number };\n * type B = UnionToIntersection<A>; // { a: string } & { b: number }\n */\nexport type UnionToIntersection<Union> = (\n  Union extends never ? never : (k: Union) => void\n) extends (k: infer Args) => void\n  ? Args\n  : never;\n\n/**\n * JSON-stringifies a value.\n *\n * @param value - The value to stringify.\n * @returns The stringified value.\n */\nexport function stringify(value: unknown): string {\n  return JSON.stringify(value, null, 2);\n}\n\n/**\n * The implementation of static `isInstance` methods for classes that have them.\n *\n * @param value - The value to check.\n * @param symbol - The symbol property to check for.\n * @returns Whether the value has `{ [symbol]: true }` in its prototype chain.\n */\nexport const isInstance = (\n  value: unknown,\n  symbol: symbol,\n): value is { [key: symbol]: true } =>\n  isObject(value) && symbol in value && value[symbol] === true;\n\nconst JsonRpcEngineErrorSymbol = Symbol.for(\n  'json-rpc-engine#JsonRpcEngineError',\n);\n\nexport class JsonRpcEngineError extends Error {\n  // This is a computed property name, and it doesn't seem possible to make it\n  // hash private using `#`.\n  // eslint-disable-next-line no-restricted-syntax\n  private readonly [JsonRpcEngineErrorSymbol] = true;\n\n  constructor(message: string) {\n    super(message);\n    this.name = 'JsonRpcEngineError';\n  }\n\n  /**\n   * Check if a value is a {@link JsonRpcEngineError} instance.\n   * Works across different package versions in the same realm.\n   *\n   * @param value - The value to check.\n   * @returns Whether the value is a {@link JsonRpcEngineError} instance.\n   */\n  static isInstance(value: unknown): value is JsonRpcEngineError {\n    return isInstance(value, JsonRpcEngineErrorSymbol);\n  }\n}\n"]}
+{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../../src/v2/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ActionConstraint } from '@metamask/messenger';\nimport { Messenger } from '@metamask/messenger';\nimport { hasProperty, isObject } from '@metamask/utils';\nimport type {\n  JsonRpcNotification,\n  JsonRpcParams,\n  JsonRpcRequest,\n} from '@metamask/utils';\n\nexport type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcNotification,\n} from '@metamask/utils';\n\nexport type JsonRpcCall<Params extends JsonRpcParams = JsonRpcParams> =\n  | JsonRpcNotification<Params>\n  | JsonRpcRequest<Params>;\n\nexport const isRequest = <Params extends JsonRpcParams>(\n  message: JsonRpcCall<Params> | Readonly<JsonRpcCall<Params>>,\n): message is JsonRpcRequest<Params> => hasProperty(message, 'id');\n\nexport const isNotification = <Params extends JsonRpcParams>(\n  message: JsonRpcCall<Params>,\n): message is JsonRpcNotification<Params> => !isRequest(message);\n\n/**\n * An unholy incantation that converts a union of object types into an\n * intersection of object types.\n *\n * @example\n * type A = { a: string } | { b: number };\n * type B = UnionToIntersection<A>; // { a: string } & { b: number }\n */\nexport type UnionToIntersection<Union> = (\n  Union extends never ? never : (k: Union) => void\n) extends (k: infer Args) => void\n  ? Args\n  : never;\n\n/**\n * JSON-stringifies a value.\n *\n * @param value - The value to stringify.\n * @returns The stringified value.\n */\nexport function stringify(value: unknown): string {\n  return JSON.stringify(value, null, 2);\n}\n\n/**\n * The implementation of static `isInstance` methods for classes that have them.\n *\n * @param value - The value to check.\n * @param symbol - The symbol property to check for.\n * @returns Whether the value has `{ [symbol]: true }` in its prototype chain.\n */\nexport const isInstance = (\n  value: unknown,\n  symbol: symbol,\n): value is { [key: symbol]: true } =>\n  isObject(value) && symbol in value && value[symbol] === true;\n\nconst JsonRpcEngineErrorSymbol = Symbol.for(\n  'json-rpc-engine#JsonRpcEngineError',\n);\n\nexport class JsonRpcEngineError extends Error {\n  // This is a computed property name, and it doesn't seem possible to make it\n  // hash private using `#`.\n  // eslint-disable-next-line no-restricted-syntax\n  private readonly [JsonRpcEngineErrorSymbol] = true;\n\n  constructor(message: string) {\n    super(message);\n    this.name = 'JsonRpcEngineError';\n  }\n\n  /**\n   * Check if a value is a {@link JsonRpcEngineError} instance.\n   * Works across different package versions in the same realm.\n   *\n   * @param value - The value to check.\n   * @returns Whether the value is a {@link JsonRpcEngineError} instance.\n   */\n  static isInstance(value: unknown): value is JsonRpcEngineError {\n    return isInstance(value, JsonRpcEngineErrorSymbol);\n  }\n}\n\n// Method middleware utils\n\n/**\n * Returns the subset of the specified `hooks` that are included in the\n * `hookNames` object. This is a Principle of Least Authority (POLA) measure\n * to ensure that each RPC method implementation only has access to the\n * API \"hooks\" it needs to do its job.\n *\n * @param hooks - The hooks to select from.\n * @param hookNames - The names of the hooks to select.\n * @returns The selected hooks, or `undefined` if `hookNames` is not provided.\n * @template Hooks - The hooks to select from.\n * @template HookName - The names of the hooks to select.\n */\nexport function selectHooks<Hooks, HookName extends keyof Hooks>(\n  hooks: Hooks,\n  hookNames?: Record<HookName, true>,\n): Pick<Hooks, HookName> | undefined {\n  if (hookNames) {\n    return Object.keys(hookNames).reduce<Partial<Pick<Hooks, HookName>>>(\n      (subset, name) => {\n        const hookName = name as HookName;\n        subset[hookName] = hooks[hookName];\n        return subset;\n      },\n      {},\n    ) as Pick<Hooks, HookName>;\n  }\n  return undefined;\n}\n\n/**\n * Asserts that `hooks` contains exactly the hook names in `expectedHookNames`.\n * Throws on any missing hooks, then on any extraneous hooks.\n *\n * @param hooks - The hooks object to validate.\n * @param expectedHookNames - The expected hook names.\n */\nexport function assertExpectedHooks(\n  hooks: Record<string, unknown>,\n  expectedHookNames: Set<string>,\n): void {\n  const missingHookNames: string[] = [];\n  expectedHookNames.forEach((hookName) => {\n    if (!hasProperty(hooks, hookName)) {\n      missingHookNames.push(hookName);\n    }\n  });\n  if (missingHookNames.length > 0) {\n    throw new Error(\n      `Missing expected hooks:\\n\\n${missingHookNames.join('\\n')}\\n`,\n    );\n  }\n\n  const extraneousHookNames = Object.getOwnPropertyNames(hooks).filter(\n    (hookName) => !expectedHookNames.has(hookName),\n  );\n  if (extraneousHookNames.length > 0) {\n    throw new Error(\n      `Received unexpected hooks:\\n\\n${extraneousHookNames.join('\\n')}\\n`,\n    );\n  }\n}\n\n/**\n * Creates a per-handler messenger namespaced to `namespace`, and delegates the\n * specified `actionNames` from `rootMessenger` to it. This lets each handler\n * call only the actions it declared, per POLA.\n *\n * @param options - The options.\n * @param options.namespace - The namespace for the handler messenger.\n * @param options.actionNames - Actions to delegate from the root messenger.\n * @param options.rootMessenger - The root messenger to delegate from. Required\n * when `actionNames` are provided.\n * @returns The per-handler messenger.\n */\nexport function createHandlerMessenger<Actions extends ActionConstraint>({\n  namespace,\n  actionNames,\n  rootMessenger,\n}: {\n  namespace: string;\n  actionNames: readonly Actions['type'][] | undefined;\n  rootMessenger?: Messenger<string, Actions> | undefined;\n}): Messenger<string, Actions> | undefined {\n  if (!actionNames) {\n    return undefined;\n  }\n\n  if (!rootMessenger) {\n    throw new Error(\n      'A messenger is required when a handler declares actionNames.',\n    );\n  }\n\n  const handlerMessenger = new Messenger<\n    string,\n    Actions,\n    never,\n    typeof rootMessenger\n  >({ namespace, parent: rootMessenger });\n\n  rootMessenger.delegate({\n    actions: actionNames as Actions['type'][],\n    messenger: handlerMessenger,\n  });\n\n  return handlerMessenger;\n}\n"]}

package/dist/v2/utils.d.cts

@@ -1,3 +1,5 @@
+import type { ActionConstraint } from "@metamask/messenger";
+import { Messenger } from "@metamask/messenger";
 import type { JsonRpcNotification, JsonRpcParams, JsonRpcRequest } from "@metamask/utils";
 export type { Json, JsonRpcParams, JsonRpcRequest, JsonRpcNotification, } from "@metamask/utils";
 export type JsonRpcCall<Params extends JsonRpcParams = JsonRpcParams> = JsonRpcNotification<Params> | JsonRpcRequest<Params>;
@@ -42,4 +44,42 @@ export declare class JsonRpcEngineError extends Error {
      */
     static isInstance(value: unknown): value is JsonRpcEngineError;
 }
+/**
+ * Returns the subset of the specified `hooks` that are included in the
+ * `hookNames` object. This is a Principle of Least Authority (POLA) measure
+ * to ensure that each RPC method implementation only has access to the
+ * API "hooks" it needs to do its job.
+ *
+ * @param hooks - The hooks to select from.
+ * @param hookNames - The names of the hooks to select.
+ * @returns The selected hooks, or `undefined` if `hookNames` is not provided.
+ * @template Hooks - The hooks to select from.
+ * @template HookName - The names of the hooks to select.
+ */
+export declare function selectHooks<Hooks, HookName extends keyof Hooks>(hooks: Hooks, hookNames?: Record<HookName, true>): Pick<Hooks, HookName> | undefined;
+/**
+ * Asserts that `hooks` contains exactly the hook names in `expectedHookNames`.
+ * Throws on any missing hooks, then on any extraneous hooks.
+ *
+ * @param hooks - The hooks object to validate.
+ * @param expectedHookNames - The expected hook names.
+ */
+export declare function assertExpectedHooks(hooks: Record<string, unknown>, expectedHookNames: Set<string>): void;
+/**
+ * Creates a per-handler messenger namespaced to `namespace`, and delegates the
+ * specified `actionNames` from `rootMessenger` to it. This lets each handler
+ * call only the actions it declared, per POLA.
+ *
+ * @param options - The options.
+ * @param options.namespace - The namespace for the handler messenger.
+ * @param options.actionNames - Actions to delegate from the root messenger.
+ * @param options.rootMessenger - The root messenger to delegate from. Required
+ * when `actionNames` are provided.
+ * @returns The per-handler messenger.
+ */
+export declare function createHandlerMessenger<Actions extends ActionConstraint>({ namespace, actionNames, rootMessenger, }: {
+    namespace: string;
+    actionNames: readonly Actions['type'][] | undefined;
+    rootMessenger?: Messenger<string, Actions> | undefined;
+}): Messenger<string, Actions> | undefined;
 //# sourceMappingURL=utils.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../../src/v2/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,cAAc,EACf,wBAAwB;AAEzB,YAAY,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,wBAAwB;AAEzB,MAAM,MAAM,WAAW,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa,IAChE,mBAAmB,CAAC,MAAM,CAAC,GAC3B,cAAc,CAAC,MAAM,CAAC,CAAC;AAE3B,eAAO,MAAM,SAAS,mIAE4C,CAAC;AAEnE,eAAO,MAAM,cAAc,wGAEqC,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,CAAC,KAAK,IAAI,CACvC,KAAK,SAAS,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CACjD,SAAS,CAAC,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI,GAC7B,IAAI,GACJ,KAAK,CAAC;AAEV;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,UACd,OAAO,UACN,MAAM;;CAE8C,CAAC;AAE/D,QAAA,MAAM,wBAAwB,eAE7B,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,KAAK;IAI3C,OAAO,CAAC,QAAQ,CAAC,CAAC,wBAAwB,CAAC,CAAQ;gBAEvC,OAAO,EAAE,MAAM;IAK3B;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB;CAG/D"}
+{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../../src/v2/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,4BAA4B;AAC5D,OAAO,EAAE,SAAS,EAAE,4BAA4B;AAEhD,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,cAAc,EACf,wBAAwB;AAEzB,YAAY,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,wBAAwB;AAEzB,MAAM,MAAM,WAAW,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa,IAChE,mBAAmB,CAAC,MAAM,CAAC,GAC3B,cAAc,CAAC,MAAM,CAAC,CAAC;AAE3B,eAAO,MAAM,SAAS,mIAE4C,CAAC;AAEnE,eAAO,MAAM,cAAc,wGAEqC,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,CAAC,KAAK,IAAI,CACvC,KAAK,SAAS,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CACjD,SAAS,CAAC,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI,GAC7B,IAAI,GACJ,KAAK,CAAC;AAEV;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,UACd,OAAO,UACN,MAAM;;CAE8C,CAAC;AAE/D,QAAA,MAAM,wBAAwB,eAE7B,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,KAAK;IAI3C,OAAO,CAAC,QAAQ,CAAC,CAAC,wBAAwB,CAAC,CAAQ;gBAEvC,OAAO,EAAE,MAAM;IAK3B;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB;CAG/D;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,SAAS,MAAM,KAAK,EAC7D,KAAK,EAAE,KAAK,EACZ,SAAS,CAAC,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,GACjC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,SAAS,CAYnC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC7B,IAAI,CAqBN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,SAAS,gBAAgB,EAAE,EACvE,SAAS,EACT,WAAW,EACX,aAAa,GACd,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,CAAC;IACpD,aAAa,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACxD,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAwBzC"}

package/dist/v2/utils.d.mts

@@ -1,3 +1,5 @@
+import type { ActionConstraint } from "@metamask/messenger";
+import { Messenger } from "@metamask/messenger";
 import type { JsonRpcNotification, JsonRpcParams, JsonRpcRequest } from "@metamask/utils";
 export type { Json, JsonRpcParams, JsonRpcRequest, JsonRpcNotification, } from "@metamask/utils";
 export type JsonRpcCall<Params extends JsonRpcParams = JsonRpcParams> = JsonRpcNotification<Params> | JsonRpcRequest<Params>;
@@ -42,4 +44,42 @@ export declare class JsonRpcEngineError extends Error {
      */
     static isInstance(value: unknown): value is JsonRpcEngineError;
 }
+/**
+ * Returns the subset of the specified `hooks` that are included in the
+ * `hookNames` object. This is a Principle of Least Authority (POLA) measure
+ * to ensure that each RPC method implementation only has access to the
+ * API "hooks" it needs to do its job.
+ *
+ * @param hooks - The hooks to select from.
+ * @param hookNames - The names of the hooks to select.
+ * @returns The selected hooks, or `undefined` if `hookNames` is not provided.
+ * @template Hooks - The hooks to select from.
+ * @template HookName - The names of the hooks to select.
+ */
+export declare function selectHooks<Hooks, HookName extends keyof Hooks>(hooks: Hooks, hookNames?: Record<HookName, true>): Pick<Hooks, HookName> | undefined;
+/**
+ * Asserts that `hooks` contains exactly the hook names in `expectedHookNames`.
+ * Throws on any missing hooks, then on any extraneous hooks.
+ *
+ * @param hooks - The hooks object to validate.
+ * @param expectedHookNames - The expected hook names.
+ */
+export declare function assertExpectedHooks(hooks: Record<string, unknown>, expectedHookNames: Set<string>): void;
+/**
+ * Creates a per-handler messenger namespaced to `namespace`, and delegates the
+ * specified `actionNames` from `rootMessenger` to it. This lets each handler
+ * call only the actions it declared, per POLA.
+ *
+ * @param options - The options.
+ * @param options.namespace - The namespace for the handler messenger.
+ * @param options.actionNames - Actions to delegate from the root messenger.
+ * @param options.rootMessenger - The root messenger to delegate from. Required
+ * when `actionNames` are provided.
+ * @returns The per-handler messenger.
+ */
+export declare function createHandlerMessenger<Actions extends ActionConstraint>({ namespace, actionNames, rootMessenger, }: {
+    namespace: string;
+    actionNames: readonly Actions['type'][] | undefined;
+    rootMessenger?: Messenger<string, Actions> | undefined;
+}): Messenger<string, Actions> | undefined;
 //# sourceMappingURL=utils.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../src/v2/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,cAAc,EACf,wBAAwB;AAEzB,YAAY,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,wBAAwB;AAEzB,MAAM,MAAM,WAAW,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa,IAChE,mBAAmB,CAAC,MAAM,CAAC,GAC3B,cAAc,CAAC,MAAM,CAAC,CAAC;AAE3B,eAAO,MAAM,SAAS,mIAE4C,CAAC;AAEnE,eAAO,MAAM,cAAc,wGAEqC,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,CAAC,KAAK,IAAI,CACvC,KAAK,SAAS,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CACjD,SAAS,CAAC,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI,GAC7B,IAAI,GACJ,KAAK,CAAC;AAEV;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,UACd,OAAO,UACN,MAAM;;CAE8C,CAAC;AAE/D,QAAA,MAAM,wBAAwB,eAE7B,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,KAAK;IAI3C,OAAO,CAAC,QAAQ,CAAC,CAAC,wBAAwB,CAAC,CAAQ;gBAEvC,OAAO,EAAE,MAAM;IAK3B;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB;CAG/D"}
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../src/v2/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,4BAA4B;AAC5D,OAAO,EAAE,SAAS,EAAE,4BAA4B;AAEhD,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,cAAc,EACf,wBAAwB;AAEzB,YAAY,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,wBAAwB;AAEzB,MAAM,MAAM,WAAW,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa,IAChE,mBAAmB,CAAC,MAAM,CAAC,GAC3B,cAAc,CAAC,MAAM,CAAC,CAAC;AAE3B,eAAO,MAAM,SAAS,mIAE4C,CAAC;AAEnE,eAAO,MAAM,cAAc,wGAEqC,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,CAAC,KAAK,IAAI,CACvC,KAAK,SAAS,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CACjD,SAAS,CAAC,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI,GAC7B,IAAI,GACJ,KAAK,CAAC;AAEV;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,UACd,OAAO,UACN,MAAM;;CAE8C,CAAC;AAE/D,QAAA,MAAM,wBAAwB,eAE7B,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,KAAK;IAI3C,OAAO,CAAC,QAAQ,CAAC,CAAC,wBAAwB,CAAC,CAAQ;gBAEvC,OAAO,EAAE,MAAM;IAK3B;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB;CAG/D;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,SAAS,MAAM,KAAK,EAC7D,KAAK,EAAE,KAAK,EACZ,SAAS,CAAC,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,GACjC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,SAAS,CAYnC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC7B,IAAI,CAqBN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,SAAS,gBAAgB,EAAE,EACvE,SAAS,EACT,WAAW,EACX,aAAa,GACd,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,CAAC;IACpD,aAAa,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACxD,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAwBzC"}

package/dist/v2/utils.mjs

@@ -1,4 +1,5 @@
 var _a;
+import { Messenger } from "@metamask/messenger";
 import { hasProperty, isObject } from "@metamask/utils";
 export const isRequest = (message) => hasProperty(message, 'id');
 export const isNotification = (message) => !isRequest(message);
@@ -41,4 +42,75 @@ export class JsonRpcEngineError extends Error {
     }
 }
 _a = JsonRpcEngineErrorSymbol;
+// Method middleware utils
+/**
+ * Returns the subset of the specified `hooks` that are included in the
+ * `hookNames` object. This is a Principle of Least Authority (POLA) measure
+ * to ensure that each RPC method implementation only has access to the
+ * API "hooks" it needs to do its job.
+ *
+ * @param hooks - The hooks to select from.
+ * @param hookNames - The names of the hooks to select.
+ * @returns The selected hooks, or `undefined` if `hookNames` is not provided.
+ * @template Hooks - The hooks to select from.
+ * @template HookName - The names of the hooks to select.
+ */
+export function selectHooks(hooks, hookNames) {
+    if (hookNames) {
+        return Object.keys(hookNames).reduce((subset, name) => {
+            const hookName = name;
+            subset[hookName] = hooks[hookName];
+            return subset;
+        }, {});
+    }
+    return undefined;
+}
+/**
+ * Asserts that `hooks` contains exactly the hook names in `expectedHookNames`.
+ * Throws on any missing hooks, then on any extraneous hooks.
+ *
+ * @param hooks - The hooks object to validate.
+ * @param expectedHookNames - The expected hook names.
+ */
+export function assertExpectedHooks(hooks, expectedHookNames) {
+    const missingHookNames = [];
+    expectedHookNames.forEach((hookName) => {
+        if (!hasProperty(hooks, hookName)) {
+            missingHookNames.push(hookName);
+        }
+    });
+    if (missingHookNames.length > 0) {
+        throw new Error(`Missing expected hooks:\n\n${missingHookNames.join('\n')}\n`);
+    }
+    const extraneousHookNames = Object.getOwnPropertyNames(hooks).filter((hookName) => !expectedHookNames.has(hookName));
+    if (extraneousHookNames.length > 0) {
+        throw new Error(`Received unexpected hooks:\n\n${extraneousHookNames.join('\n')}\n`);
+    }
+}
+/**
+ * Creates a per-handler messenger namespaced to `namespace`, and delegates the
+ * specified `actionNames` from `rootMessenger` to it. This lets each handler
+ * call only the actions it declared, per POLA.
+ *
+ * @param options - The options.
+ * @param options.namespace - The namespace for the handler messenger.
+ * @param options.actionNames - Actions to delegate from the root messenger.
+ * @param options.rootMessenger - The root messenger to delegate from. Required
+ * when `actionNames` are provided.
+ * @returns The per-handler messenger.
+ */
+export function createHandlerMessenger({ namespace, actionNames, rootMessenger, }) {
+    if (!actionNames) {
+        return undefined;
+    }
+    if (!rootMessenger) {
+        throw new Error('A messenger is required when a handler declares actionNames.');
+    }
+    const handlerMessenger = new Messenger({ namespace, parent: rootMessenger });
+    rootMessenger.delegate({
+        actions: actionNames,
+        messenger: handlerMessenger,
+    });
+    return handlerMessenger;
+}
 //# sourceMappingURL=utils.mjs.map

package/dist/v2/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../../src/v2/utils.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,wBAAwB;AAkBxD,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,OAA4D,EACzB,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,OAA4B,EACY,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAgBjE;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,KAAc,EACd,MAAc,EACoB,EAAE,CACpC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;AAE/D,MAAM,wBAAwB,GAAG,MAAM,CAAC,GAAG,CACzC,oCAAoC,CACrC,CAAC;AAEF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAM3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QANjB,4EAA4E;QAC5E,0BAA0B;QAC1B,gDAAgD;QAC/B,QAA0B,GAAG,IAAI,CAAC;QAIjD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,KAAc;QAC9B,OAAO,UAAU,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;IACrD,CAAC;CACF;KAjBmB,wBAAwB","sourcesContent":["import { hasProperty, isObject } from '@metamask/utils';\nimport type {\n  JsonRpcNotification,\n  JsonRpcParams,\n  JsonRpcRequest,\n} from '@metamask/utils';\n\nexport type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcNotification,\n} from '@metamask/utils';\n\nexport type JsonRpcCall<Params extends JsonRpcParams = JsonRpcParams> =\n  | JsonRpcNotification<Params>\n  | JsonRpcRequest<Params>;\n\nexport const isRequest = <Params extends JsonRpcParams>(\n  message: JsonRpcCall<Params> | Readonly<JsonRpcCall<Params>>,\n): message is JsonRpcRequest<Params> => hasProperty(message, 'id');\n\nexport const isNotification = <Params extends JsonRpcParams>(\n  message: JsonRpcCall<Params>,\n): message is JsonRpcNotification<Params> => !isRequest(message);\n\n/**\n * An unholy incantation that converts a union of object types into an\n * intersection of object types.\n *\n * @example\n * type A = { a: string } | { b: number };\n * type B = UnionToIntersection<A>; // { a: string } & { b: number }\n */\nexport type UnionToIntersection<Union> = (\n  Union extends never ? never : (k: Union) => void\n) extends (k: infer Args) => void\n  ? Args\n  : never;\n\n/**\n * JSON-stringifies a value.\n *\n * @param value - The value to stringify.\n * @returns The stringified value.\n */\nexport function stringify(value: unknown): string {\n  return JSON.stringify(value, null, 2);\n}\n\n/**\n * The implementation of static `isInstance` methods for classes that have them.\n *\n * @param value - The value to check.\n * @param symbol - The symbol property to check for.\n * @returns Whether the value has `{ [symbol]: true }` in its prototype chain.\n */\nexport const isInstance = (\n  value: unknown,\n  symbol: symbol,\n): value is { [key: symbol]: true } =>\n  isObject(value) && symbol in value && value[symbol] === true;\n\nconst JsonRpcEngineErrorSymbol = Symbol.for(\n  'json-rpc-engine#JsonRpcEngineError',\n);\n\nexport class JsonRpcEngineError extends Error {\n  // This is a computed property name, and it doesn't seem possible to make it\n  // hash private using `#`.\n  // eslint-disable-next-line no-restricted-syntax\n  private readonly [JsonRpcEngineErrorSymbol] = true;\n\n  constructor(message: string) {\n    super(message);\n    this.name = 'JsonRpcEngineError';\n  }\n\n  /**\n   * Check if a value is a {@link JsonRpcEngineError} instance.\n   * Works across different package versions in the same realm.\n   *\n   * @param value - The value to check.\n   * @returns Whether the value is a {@link JsonRpcEngineError} instance.\n   */\n  static isInstance(value: unknown): value is JsonRpcEngineError {\n    return isInstance(value, JsonRpcEngineErrorSymbol);\n  }\n}\n"]}
+{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../../src/v2/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ActionConstraint } from '@metamask/messenger';\nimport { Messenger } from '@metamask/messenger';\nimport { hasProperty, isObject } from '@metamask/utils';\nimport type {\n  JsonRpcNotification,\n  JsonRpcParams,\n  JsonRpcRequest,\n} from '@metamask/utils';\n\nexport type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcNotification,\n} from '@metamask/utils';\n\nexport type JsonRpcCall<Params extends JsonRpcParams = JsonRpcParams> =\n  | JsonRpcNotification<Params>\n  | JsonRpcRequest<Params>;\n\nexport const isRequest = <Params extends JsonRpcParams>(\n  message: JsonRpcCall<Params> | Readonly<JsonRpcCall<Params>>,\n): message is JsonRpcRequest<Params> => hasProperty(message, 'id');\n\nexport const isNotification = <Params extends JsonRpcParams>(\n  message: JsonRpcCall<Params>,\n): message is JsonRpcNotification<Params> => !isRequest(message);\n\n/**\n * An unholy incantation that converts a union of object types into an\n * intersection of object types.\n *\n * @example\n * type A = { a: string } | { b: number };\n * type B = UnionToIntersection<A>; // { a: string } & { b: number }\n */\nexport type UnionToIntersection<Union> = (\n  Union extends never ? never : (k: Union) => void\n) extends (k: infer Args) => void\n  ? Args\n  : never;\n\n/**\n * JSON-stringifies a value.\n *\n * @param value - The value to stringify.\n * @returns The stringified value.\n */\nexport function stringify(value: unknown): string {\n  return JSON.stringify(value, null, 2);\n}\n\n/**\n * The implementation of static `isInstance` methods for classes that have them.\n *\n * @param value - The value to check.\n * @param symbol - The symbol property to check for.\n * @returns Whether the value has `{ [symbol]: true }` in its prototype chain.\n */\nexport const isInstance = (\n  value: unknown,\n  symbol: symbol,\n): value is { [key: symbol]: true } =>\n  isObject(value) && symbol in value && value[symbol] === true;\n\nconst JsonRpcEngineErrorSymbol = Symbol.for(\n  'json-rpc-engine#JsonRpcEngineError',\n);\n\nexport class JsonRpcEngineError extends Error {\n  // This is a computed property name, and it doesn't seem possible to make it\n  // hash private using `#`.\n  // eslint-disable-next-line no-restricted-syntax\n  private readonly [JsonRpcEngineErrorSymbol] = true;\n\n  constructor(message: string) {\n    super(message);\n    this.name = 'JsonRpcEngineError';\n  }\n\n  /**\n   * Check if a value is a {@link JsonRpcEngineError} instance.\n   * Works across different package versions in the same realm.\n   *\n   * @param value - The value to check.\n   * @returns Whether the value is a {@link JsonRpcEngineError} instance.\n   */\n  static isInstance(value: unknown): value is JsonRpcEngineError {\n    return isInstance(value, JsonRpcEngineErrorSymbol);\n  }\n}\n\n// Method middleware utils\n\n/**\n * Returns the subset of the specified `hooks` that are included in the\n * `hookNames` object. This is a Principle of Least Authority (POLA) measure\n * to ensure that each RPC method implementation only has access to the\n * API \"hooks\" it needs to do its job.\n *\n * @param hooks - The hooks to select from.\n * @param hookNames - The names of the hooks to select.\n * @returns The selected hooks, or `undefined` if `hookNames` is not provided.\n * @template Hooks - The hooks to select from.\n * @template HookName - The names of the hooks to select.\n */\nexport function selectHooks<Hooks, HookName extends keyof Hooks>(\n  hooks: Hooks,\n  hookNames?: Record<HookName, true>,\n): Pick<Hooks, HookName> | undefined {\n  if (hookNames) {\n    return Object.keys(hookNames).reduce<Partial<Pick<Hooks, HookName>>>(\n      (subset, name) => {\n        const hookName = name as HookName;\n        subset[hookName] = hooks[hookName];\n        return subset;\n      },\n      {},\n    ) as Pick<Hooks, HookName>;\n  }\n  return undefined;\n}\n\n/**\n * Asserts that `hooks` contains exactly the hook names in `expectedHookNames`.\n * Throws on any missing hooks, then on any extraneous hooks.\n *\n * @param hooks - The hooks object to validate.\n * @param expectedHookNames - The expected hook names.\n */\nexport function assertExpectedHooks(\n  hooks: Record<string, unknown>,\n  expectedHookNames: Set<string>,\n): void {\n  const missingHookNames: string[] = [];\n  expectedHookNames.forEach((hookName) => {\n    if (!hasProperty(hooks, hookName)) {\n      missingHookNames.push(hookName);\n    }\n  });\n  if (missingHookNames.length > 0) {\n    throw new Error(\n      `Missing expected hooks:\\n\\n${missingHookNames.join('\\n')}\\n`,\n    );\n  }\n\n  const extraneousHookNames = Object.getOwnPropertyNames(hooks).filter(\n    (hookName) => !expectedHookNames.has(hookName),\n  );\n  if (extraneousHookNames.length > 0) {\n    throw new Error(\n      `Received unexpected hooks:\\n\\n${extraneousHookNames.join('\\n')}\\n`,\n    );\n  }\n}\n\n/**\n * Creates a per-handler messenger namespaced to `namespace`, and delegates the\n * specified `actionNames` from `rootMessenger` to it. This lets each handler\n * call only the actions it declared, per POLA.\n *\n * @param options - The options.\n * @param options.namespace - The namespace for the handler messenger.\n * @param options.actionNames - Actions to delegate from the root messenger.\n * @param options.rootMessenger - The root messenger to delegate from. Required\n * when `actionNames` are provided.\n * @returns The per-handler messenger.\n */\nexport function createHandlerMessenger<Actions extends ActionConstraint>({\n  namespace,\n  actionNames,\n  rootMessenger,\n}: {\n  namespace: string;\n  actionNames: readonly Actions['type'][] | undefined;\n  rootMessenger?: Messenger<string, Actions> | undefined;\n}): Messenger<string, Actions> | undefined {\n  if (!actionNames) {\n    return undefined;\n  }\n\n  if (!rootMessenger) {\n    throw new Error(\n      'A messenger is required when a handler declares actionNames.',\n    );\n  }\n\n  const handlerMessenger = new Messenger<\n    string,\n    Actions,\n    never,\n    typeof rootMessenger\n  >({ namespace, parent: rootMessenger });\n\n  rootMessenger.delegate({\n    actions: actionNames as Actions['type'][],\n    messenger: handlerMessenger,\n  });\n\n  return handlerMessenger;\n}\n"]}