@metamask-previews/json-rpc-engine 10.2.4-preview-45a82ea8e → 10.2.4-preview-8daaa5a40
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +1 -5
- package/dist/index.cjs +1 -3
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +0 -2
- package/dist/index.d.cts.map +1 -1
- package/dist/index.d.mts +0 -2
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +0 -1
- package/dist/index.mjs.map +1 -1
- package/dist/v2/createMethodMiddleware.cjs +31 -8
- package/dist/v2/createMethodMiddleware.cjs.map +1 -1
- package/dist/v2/createMethodMiddleware.d.cts +15 -12
- package/dist/v2/createMethodMiddleware.d.cts.map +1 -1
- package/dist/v2/createMethodMiddleware.d.mts +15 -12
- package/dist/v2/createMethodMiddleware.d.mts.map +1 -1
- package/dist/v2/createMethodMiddleware.mjs +28 -6
- package/dist/v2/createMethodMiddleware.mjs.map +1 -1
- package/dist/v2/index.cjs +2 -2
- package/dist/v2/index.cjs.map +1 -1
- package/dist/v2/index.d.cts +2 -2
- package/dist/v2/index.d.cts.map +1 -1
- package/dist/v2/index.d.mts +2 -2
- package/dist/v2/index.d.mts.map +1 -1
- package/dist/v2/index.mjs +2 -2
- package/dist/v2/index.mjs.map +1 -1
- package/dist/v2/utils.cjs +1 -76
- package/dist/v2/utils.cjs.map +1 -1
- package/dist/v2/utils.d.cts +0 -40
- package/dist/v2/utils.d.cts.map +1 -1
- package/dist/v2/utils.d.mts +0 -40
- package/dist/v2/utils.d.mts.map +1 -1
- package/dist/v2/utils.mjs +0 -72
- package/dist/v2/utils.mjs.map +1 -1
- package/package.json +1 -1
- package/dist/createMethodMiddleware.cjs +0 -56
- package/dist/createMethodMiddleware.cjs.map +0 -1
- package/dist/createMethodMiddleware.d.cts +0 -79
- package/dist/createMethodMiddleware.d.cts.map +0 -1
- package/dist/createMethodMiddleware.d.mts +0 -79
- package/dist/createMethodMiddleware.d.mts.map +0 -1
- package/dist/createMethodMiddleware.mjs +0 -52
- package/dist/createMethodMiddleware.mjs.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -10,12 +10,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
10
10
|
### Added
|
|
11
11
|
|
|
12
12
|
- Add `createOriginMiddleware` utility to `v2` ([#8522](https://github.com/MetaMask/core/pull/8522))
|
|
13
|
-
- Add `createMethodMiddleware` utility to `v2` ([#8506](https://github.com/MetaMask/core/pull/8506)
|
|
13
|
+
- Add `createMethodMiddleware` utility to `v2` ([#8506](https://github.com/MetaMask/core/pull/8506))
|
|
14
14
|
- This utility allows JSON-RPC method implementations to use both the hooks pattern and the messenger.
|
|
15
|
-
- Add legacy `createMethodMiddleware` ([#8583](https://github.com/MetaMask/core/pull/8583))
|
|
16
|
-
- Consolidates bespoke `makeMethodMiddlewareMaker` implementations from the MetaMask extension and mobile clients.
|
|
17
|
-
- Handlers may now declare `actionNames` and receive a delegated messenger as the sixth argument to `implementation`, mirroring the v2 `createMethodMiddleware`.
|
|
18
|
-
- Deprecated in favor of the v2 `createMethodMiddleware`.
|
|
19
15
|
|
|
20
16
|
## [10.2.4]
|
|
21
17
|
|
package/dist/index.cjs
CHANGED
|
@@ -1,12 +1,10 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.mergeMiddleware = exports.JsonRpcEngine = exports.createIdRemapMiddleware = exports.getUniqueId = exports.createScaffoldMiddleware = exports.
|
|
3
|
+
exports.mergeMiddleware = exports.JsonRpcEngine = exports.createIdRemapMiddleware = exports.getUniqueId = exports.createScaffoldMiddleware = exports.createAsyncMiddleware = exports.asV2Middleware = void 0;
|
|
4
4
|
var asV2Middleware_1 = require("./asV2Middleware.cjs");
|
|
5
5
|
Object.defineProperty(exports, "asV2Middleware", { enumerable: true, get: function () { return asV2Middleware_1.asV2Middleware; } });
|
|
6
6
|
var createAsyncMiddleware_1 = require("./createAsyncMiddleware.cjs");
|
|
7
7
|
Object.defineProperty(exports, "createAsyncMiddleware", { enumerable: true, get: function () { return createAsyncMiddleware_1.createAsyncMiddleware; } });
|
|
8
|
-
var createMethodMiddleware_1 = require("./createMethodMiddleware.cjs");
|
|
9
|
-
Object.defineProperty(exports, "createMethodMiddleware", { enumerable: true, get: function () { return createMethodMiddleware_1.createMethodMiddleware; } });
|
|
10
8
|
var createScaffoldMiddleware_1 = require("./createScaffoldMiddleware.cjs");
|
|
11
9
|
Object.defineProperty(exports, "createScaffoldMiddleware", { enumerable: true, get: function () { return createScaffoldMiddleware_1.createScaffoldMiddleware; } });
|
|
12
10
|
var getUniqueId_1 = require("./getUniqueId.cjs");
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAKvB,qEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;
|
|
1
|
+
{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAKvB,qEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,2EAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,iDAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,6DAA8D;AAArD,4HAAA,uBAAuB,OAAA;AAShC,qDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,yDAAoD;AAA3C,kHAAA,eAAe,OAAA","sourcesContent":["export { asV2Middleware } from './asV2Middleware';\nexport type {\n AsyncJsonRpcEngineNextCallback,\n AsyncJsonrpcMiddleware,\n} from './createAsyncMiddleware';\nexport { createAsyncMiddleware } from './createAsyncMiddleware';\nexport { createScaffoldMiddleware } from './createScaffoldMiddleware';\nexport { getUniqueId } from './getUniqueId';\nexport { createIdRemapMiddleware } from './idRemapMiddleware';\nexport type {\n JsonRpcEngineCallbackError,\n JsonRpcEngineReturnHandler,\n JsonRpcEngineNextCallback,\n JsonRpcEngineEndCallback,\n JsonRpcMiddleware,\n JsonRpcNotificationHandler,\n} from './JsonRpcEngine';\nexport { JsonRpcEngine } from './JsonRpcEngine';\nexport { mergeMiddleware } from './mergeMiddleware';\n"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
export { asV2Middleware } from "./asV2Middleware.cjs";
|
|
2
2
|
export type { AsyncJsonRpcEngineNextCallback, AsyncJsonrpcMiddleware, } from "./createAsyncMiddleware.cjs";
|
|
3
3
|
export { createAsyncMiddleware } from "./createAsyncMiddleware.cjs";
|
|
4
|
-
export type { CreateMethodMiddlewareOptions, MethodHandler, MethodHandlerImplementation, } from "./createMethodMiddleware.cjs";
|
|
5
|
-
export { createMethodMiddleware } from "./createMethodMiddleware.cjs";
|
|
6
4
|
export { createScaffoldMiddleware } from "./createScaffoldMiddleware.cjs";
|
|
7
5
|
export { getUniqueId } from "./getUniqueId.cjs";
|
|
8
6
|
export { createIdRemapMiddleware } from "./idRemapMiddleware.cjs";
|
package/dist/index.d.cts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAClD,YAAY,EACV,8BAA8B,EAC9B,sBAAsB,GACvB,oCAAgC;AACjC,OAAO,EAAE,qBAAqB,EAAE,oCAAgC;AAChE,
|
|
1
|
+
{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAClD,YAAY,EACV,8BAA8B,EAC9B,sBAAsB,GACvB,oCAAgC;AACjC,OAAO,EAAE,qBAAqB,EAAE,oCAAgC;AAChE,OAAO,EAAE,wBAAwB,EAAE,uCAAmC;AACtE,OAAO,EAAE,WAAW,EAAE,0BAAsB;AAC5C,OAAO,EAAE,uBAAuB,EAAE,gCAA4B;AAC9D,YAAY,EACV,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,0BAA0B,GAC3B,4BAAwB;AACzB,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAChD,OAAO,EAAE,eAAe,EAAE,8BAA0B"}
|
package/dist/index.d.mts
CHANGED
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
export { asV2Middleware } from "./asV2Middleware.mjs";
|
|
2
2
|
export type { AsyncJsonRpcEngineNextCallback, AsyncJsonrpcMiddleware, } from "./createAsyncMiddleware.mjs";
|
|
3
3
|
export { createAsyncMiddleware } from "./createAsyncMiddleware.mjs";
|
|
4
|
-
export type { CreateMethodMiddlewareOptions, MethodHandler, MethodHandlerImplementation, } from "./createMethodMiddleware.mjs";
|
|
5
|
-
export { createMethodMiddleware } from "./createMethodMiddleware.mjs";
|
|
6
4
|
export { createScaffoldMiddleware } from "./createScaffoldMiddleware.mjs";
|
|
7
5
|
export { getUniqueId } from "./getUniqueId.mjs";
|
|
8
6
|
export { createIdRemapMiddleware } from "./idRemapMiddleware.mjs";
|
package/dist/index.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAClD,YAAY,EACV,8BAA8B,EAC9B,sBAAsB,GACvB,oCAAgC;AACjC,OAAO,EAAE,qBAAqB,EAAE,oCAAgC;AAChE,
|
|
1
|
+
{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAClD,YAAY,EACV,8BAA8B,EAC9B,sBAAsB,GACvB,oCAAgC;AACjC,OAAO,EAAE,qBAAqB,EAAE,oCAAgC;AAChE,OAAO,EAAE,wBAAwB,EAAE,uCAAmC;AACtE,OAAO,EAAE,WAAW,EAAE,0BAAsB;AAC5C,OAAO,EAAE,uBAAuB,EAAE,gCAA4B;AAC9D,YAAY,EACV,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,0BAA0B,GAC3B,4BAAwB;AACzB,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAChD,OAAO,EAAE,eAAe,EAAE,8BAA0B"}
|
package/dist/index.mjs
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
export { asV2Middleware } from "./asV2Middleware.mjs";
|
|
2
2
|
export { createAsyncMiddleware } from "./createAsyncMiddleware.mjs";
|
|
3
|
-
export { createMethodMiddleware } from "./createMethodMiddleware.mjs";
|
|
4
3
|
export { createScaffoldMiddleware } from "./createScaffoldMiddleware.mjs";
|
|
5
4
|
export { getUniqueId } from "./getUniqueId.mjs";
|
|
6
5
|
export { createIdRemapMiddleware } from "./idRemapMiddleware.mjs";
|
package/dist/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAKlD,OAAO,EAAE,qBAAqB,EAAE,oCAAgC;
|
|
1
|
+
{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAKlD,OAAO,EAAE,qBAAqB,EAAE,oCAAgC;AAChE,OAAO,EAAE,wBAAwB,EAAE,uCAAmC;AACtE,OAAO,EAAE,WAAW,EAAE,0BAAsB;AAC5C,OAAO,EAAE,uBAAuB,EAAE,gCAA4B;AAS9D,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAChD,OAAO,EAAE,eAAe,EAAE,8BAA0B","sourcesContent":["export { asV2Middleware } from './asV2Middleware';\nexport type {\n AsyncJsonRpcEngineNextCallback,\n AsyncJsonrpcMiddleware,\n} from './createAsyncMiddleware';\nexport { createAsyncMiddleware } from './createAsyncMiddleware';\nexport { createScaffoldMiddleware } from './createScaffoldMiddleware';\nexport { getUniqueId } from './getUniqueId';\nexport { createIdRemapMiddleware } from './idRemapMiddleware';\nexport type {\n JsonRpcEngineCallbackError,\n JsonRpcEngineReturnHandler,\n JsonRpcEngineNextCallback,\n JsonRpcEngineEndCallback,\n JsonRpcMiddleware,\n JsonRpcNotificationHandler,\n} from './JsonRpcEngine';\nexport { JsonRpcEngine } from './JsonRpcEngine';\nexport { mergeMiddleware } from './mergeMiddleware';\n"]}
|
|
@@ -1,8 +1,7 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.createMethodMiddleware = void 0;
|
|
3
|
+
exports.selectHooks = exports.createMethodMiddleware = void 0;
|
|
4
4
|
const messenger_1 = require("@metamask/messenger");
|
|
5
|
-
const utils_1 = require("./utils.cjs");
|
|
6
5
|
/**
|
|
7
6
|
* Create a JSON-RPC middleware that handles the passed JSON-RPC method handlers using the messenger and hooks.
|
|
8
7
|
*
|
|
@@ -15,14 +14,15 @@ const utils_1 = require("./utils.cjs");
|
|
|
15
14
|
function createMethodMiddleware(options) {
|
|
16
15
|
const { messenger: rootMessenger } = options;
|
|
17
16
|
const allHooks = options.hooks;
|
|
18
|
-
const expectedHookNames = new Set(Object.values(options.handlers).flatMap((handler) => handler.hookNames ? Object.getOwnPropertyNames(handler.hookNames) : []));
|
|
19
|
-
(0, utils_1.assertExpectedHooks)(allHooks, expectedHookNames);
|
|
20
17
|
const handlers = Object.entries(options.handlers).reduce((accumulator, [handlerName, handler]) => {
|
|
21
|
-
const handlerHooks =
|
|
22
|
-
const handlerMessenger =
|
|
18
|
+
const handlerHooks = selectHooks(allHooks, handler.hookNames) ?? {};
|
|
19
|
+
const handlerMessenger = new messenger_1.Messenger({
|
|
23
20
|
namespace: handlerName,
|
|
24
|
-
|
|
25
|
-
|
|
21
|
+
parent: rootMessenger,
|
|
22
|
+
});
|
|
23
|
+
rootMessenger.delegate({
|
|
24
|
+
actions: (handler.actionNames ?? []),
|
|
25
|
+
messenger: handlerMessenger,
|
|
26
26
|
});
|
|
27
27
|
accumulator[handlerName] = {
|
|
28
28
|
implementation: handler.implementation,
|
|
@@ -41,4 +41,27 @@ function createMethodMiddleware(options) {
|
|
|
41
41
|
};
|
|
42
42
|
}
|
|
43
43
|
exports.createMethodMiddleware = createMethodMiddleware;
|
|
44
|
+
/**
|
|
45
|
+
* Returns the subset of the specified `hooks` that are included in the
|
|
46
|
+
* `hookNames` object. This is a Principle of Least Authority (POLA) measure
|
|
47
|
+
* to ensure that each RPC method implementation only has access to the
|
|
48
|
+
* API "hooks" it needs to do its job.
|
|
49
|
+
*
|
|
50
|
+
* @param hooks - The hooks to select from.
|
|
51
|
+
* @param hookNames - The names of the hooks to select.
|
|
52
|
+
* @returns The selected hooks.
|
|
53
|
+
* @template Hooks - The hooks to select from.
|
|
54
|
+
* @template HookName - The names of the hooks to select.
|
|
55
|
+
*/
|
|
56
|
+
function selectHooks(hooks, hookNames) {
|
|
57
|
+
if (hookNames) {
|
|
58
|
+
return Object.keys(hookNames).reduce((hookSubset, _hookName) => {
|
|
59
|
+
const hookName = _hookName;
|
|
60
|
+
hookSubset[hookName] = hooks[hookName];
|
|
61
|
+
return hookSubset;
|
|
62
|
+
}, {});
|
|
63
|
+
}
|
|
64
|
+
return undefined;
|
|
65
|
+
}
|
|
66
|
+
exports.selectHooks = selectHooks;
|
|
44
67
|
//# sourceMappingURL=createMethodMiddleware.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"createMethodMiddleware.cjs","sourceRoot":"","sources":["../../src/v2/createMethodMiddleware.ts"],"names":[],"mappings":";;;AAAA,mDAAkE;
|
|
1
|
+
{"version":3,"file":"createMethodMiddleware.cjs","sourceRoot":"","sources":["../../src/v2/createMethodMiddleware.ts"],"names":[],"mappings":";;;AAAA,mDAAkE;AA8ElE;;;;;;;;GAQG;AACH,SAAgB,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,qBAAS,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;AAhDD,wDAgDC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,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;AAlBD,kCAkBC","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"]}
|
|
@@ -12,9 +12,6 @@ type HandlerHooks<Handler> = Handler extends {
|
|
|
12
12
|
} ? Options extends {
|
|
13
13
|
hooks: infer Hooks;
|
|
14
14
|
} ? Hooks : never : never;
|
|
15
|
-
/**
|
|
16
|
-
* A `JsonRpcEngineV2` method middleware handler.
|
|
17
|
-
*/
|
|
18
15
|
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> = {
|
|
19
16
|
implementation: (options: {
|
|
20
17
|
request: Readonly<JsonRpcRequest<Parameters>>;
|
|
@@ -45,18 +42,11 @@ type AnyMethodHandler = {
|
|
|
45
42
|
hookNames?: Record<string, true>;
|
|
46
43
|
actionNames?: readonly string[];
|
|
47
44
|
};
|
|
48
|
-
type
|
|
45
|
+
export type CreateMethodMiddlewareOptions<Handlers extends Record<string, AnyMethodHandler>> = {
|
|
49
46
|
handlers: Handlers;
|
|
47
|
+
messenger: Messenger<string, HandlerActions<Handlers[keyof Handlers]>>;
|
|
50
48
|
hooks: UnionToIntersection<HandlerHooks<Handlers[keyof Handlers]>>;
|
|
51
49
|
};
|
|
52
|
-
/**
|
|
53
|
-
* Options for {@link createMethodMiddleware}.
|
|
54
|
-
*/
|
|
55
|
-
export type CreateMethodMiddlewareOptions<Handlers extends Record<string, AnyMethodHandler>> = CreateMethodMiddlewareBaseOptions<Handlers> & ([HandlerActions<Handlers[keyof Handlers]>] extends [never] ? {
|
|
56
|
-
messenger?: undefined;
|
|
57
|
-
} : {
|
|
58
|
-
messenger: Messenger<string, HandlerActions<Handlers[keyof Handlers]>>;
|
|
59
|
-
});
|
|
60
50
|
/**
|
|
61
51
|
* Create a JSON-RPC middleware that handles the passed JSON-RPC method handlers using the messenger and hooks.
|
|
62
52
|
*
|
|
@@ -67,5 +57,18 @@ export type CreateMethodMiddlewareOptions<Handlers extends Record<string, AnyMet
|
|
|
67
57
|
* @returns A JsonRpcEngineV2 middleware.
|
|
68
58
|
*/
|
|
69
59
|
export declare function createMethodMiddleware<Handlers extends Record<string, AnyMethodHandler>, Context extends ContextConstraint>(options: CreateMethodMiddlewareOptions<Handlers>): JsonRpcMiddleware<JsonRpcRequest, Json, Context>;
|
|
60
|
+
/**
|
|
61
|
+
* Returns the subset of the specified `hooks` that are included in the
|
|
62
|
+
* `hookNames` object. This is a Principle of Least Authority (POLA) measure
|
|
63
|
+
* to ensure that each RPC method implementation only has access to the
|
|
64
|
+
* API "hooks" it needs to do its job.
|
|
65
|
+
*
|
|
66
|
+
* @param hooks - The hooks to select from.
|
|
67
|
+
* @param hookNames - The names of the hooks to select.
|
|
68
|
+
* @returns The selected hooks.
|
|
69
|
+
* @template Hooks - The hooks to select from.
|
|
70
|
+
* @template HookName - The names of the hooks to select.
|
|
71
|
+
*/
|
|
72
|
+
export declare function selectHooks<Hooks extends Record<string, unknown>, HookName extends keyof Hooks>(hooks: Hooks, hookNames?: Record<HookName, true>): Pick<Hooks, HookName> | undefined;
|
|
70
73
|
export {};
|
|
71
74
|
//# sourceMappingURL=createMethodMiddleware.d.cts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"createMethodMiddleware.d.cts","sourceRoot":"","sources":["../../src/v2/createMethodMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,4BAA4B;AAElE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,8BAA0B;AAC5D,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AACxD,OAAO,
|
|
1
|
+
{"version":3,"file":"createMethodMiddleware.d.cts","sourceRoot":"","sources":["../../src/v2/createMethodMiddleware.ts"],"names":[],"mappings":"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"}
|
|
@@ -12,9 +12,6 @@ type HandlerHooks<Handler> = Handler extends {
|
|
|
12
12
|
} ? Options extends {
|
|
13
13
|
hooks: infer Hooks;
|
|
14
14
|
} ? Hooks : never : never;
|
|
15
|
-
/**
|
|
16
|
-
* A `JsonRpcEngineV2` method middleware handler.
|
|
17
|
-
*/
|
|
18
15
|
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> = {
|
|
19
16
|
implementation: (options: {
|
|
20
17
|
request: Readonly<JsonRpcRequest<Parameters>>;
|
|
@@ -45,18 +42,11 @@ type AnyMethodHandler = {
|
|
|
45
42
|
hookNames?: Record<string, true>;
|
|
46
43
|
actionNames?: readonly string[];
|
|
47
44
|
};
|
|
48
|
-
type
|
|
45
|
+
export type CreateMethodMiddlewareOptions<Handlers extends Record<string, AnyMethodHandler>> = {
|
|
49
46
|
handlers: Handlers;
|
|
47
|
+
messenger: Messenger<string, HandlerActions<Handlers[keyof Handlers]>>;
|
|
50
48
|
hooks: UnionToIntersection<HandlerHooks<Handlers[keyof Handlers]>>;
|
|
51
49
|
};
|
|
52
|
-
/**
|
|
53
|
-
* Options for {@link createMethodMiddleware}.
|
|
54
|
-
*/
|
|
55
|
-
export type CreateMethodMiddlewareOptions<Handlers extends Record<string, AnyMethodHandler>> = CreateMethodMiddlewareBaseOptions<Handlers> & ([HandlerActions<Handlers[keyof Handlers]>] extends [never] ? {
|
|
56
|
-
messenger?: undefined;
|
|
57
|
-
} : {
|
|
58
|
-
messenger: Messenger<string, HandlerActions<Handlers[keyof Handlers]>>;
|
|
59
|
-
});
|
|
60
50
|
/**
|
|
61
51
|
* Create a JSON-RPC middleware that handles the passed JSON-RPC method handlers using the messenger and hooks.
|
|
62
52
|
*
|
|
@@ -67,5 +57,18 @@ export type CreateMethodMiddlewareOptions<Handlers extends Record<string, AnyMet
|
|
|
67
57
|
* @returns A JsonRpcEngineV2 middleware.
|
|
68
58
|
*/
|
|
69
59
|
export declare function createMethodMiddleware<Handlers extends Record<string, AnyMethodHandler>, Context extends ContextConstraint>(options: CreateMethodMiddlewareOptions<Handlers>): JsonRpcMiddleware<JsonRpcRequest, Json, Context>;
|
|
60
|
+
/**
|
|
61
|
+
* Returns the subset of the specified `hooks` that are included in the
|
|
62
|
+
* `hookNames` object. This is a Principle of Least Authority (POLA) measure
|
|
63
|
+
* to ensure that each RPC method implementation only has access to the
|
|
64
|
+
* API "hooks" it needs to do its job.
|
|
65
|
+
*
|
|
66
|
+
* @param hooks - The hooks to select from.
|
|
67
|
+
* @param hookNames - The names of the hooks to select.
|
|
68
|
+
* @returns The selected hooks.
|
|
69
|
+
* @template Hooks - The hooks to select from.
|
|
70
|
+
* @template HookName - The names of the hooks to select.
|
|
71
|
+
*/
|
|
72
|
+
export declare function selectHooks<Hooks extends Record<string, unknown>, HookName extends keyof Hooks>(hooks: Hooks, hookNames?: Record<HookName, true>): Pick<Hooks, HookName> | undefined;
|
|
70
73
|
export {};
|
|
71
74
|
//# sourceMappingURL=createMethodMiddleware.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"createMethodMiddleware.d.mts","sourceRoot":"","sources":["../../src/v2/createMethodMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,4BAA4B;AAElE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,8BAA0B;AAC5D,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AACxD,OAAO,
|
|
1
|
+
{"version":3,"file":"createMethodMiddleware.d.mts","sourceRoot":"","sources":["../../src/v2/createMethodMiddleware.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
import { Messenger } from "@metamask/messenger";
|
|
2
|
-
import { assertExpectedHooks, createHandlerMessenger, selectHooks } from "./utils.mjs";
|
|
3
2
|
/**
|
|
4
3
|
* Create a JSON-RPC middleware that handles the passed JSON-RPC method handlers using the messenger and hooks.
|
|
5
4
|
*
|
|
@@ -12,14 +11,15 @@ import { assertExpectedHooks, createHandlerMessenger, selectHooks } from "./util
|
|
|
12
11
|
export function createMethodMiddleware(options) {
|
|
13
12
|
const { messenger: rootMessenger } = options;
|
|
14
13
|
const allHooks = options.hooks;
|
|
15
|
-
const expectedHookNames = new Set(Object.values(options.handlers).flatMap((handler) => handler.hookNames ? Object.getOwnPropertyNames(handler.hookNames) : []));
|
|
16
|
-
assertExpectedHooks(allHooks, expectedHookNames);
|
|
17
14
|
const handlers = Object.entries(options.handlers).reduce((accumulator, [handlerName, handler]) => {
|
|
18
15
|
const handlerHooks = selectHooks(allHooks, handler.hookNames) ?? {};
|
|
19
|
-
const handlerMessenger =
|
|
16
|
+
const handlerMessenger = new Messenger({
|
|
20
17
|
namespace: handlerName,
|
|
21
|
-
|
|
22
|
-
|
|
18
|
+
parent: rootMessenger,
|
|
19
|
+
});
|
|
20
|
+
rootMessenger.delegate({
|
|
21
|
+
actions: (handler.actionNames ?? []),
|
|
22
|
+
messenger: handlerMessenger,
|
|
23
23
|
});
|
|
24
24
|
accumulator[handlerName] = {
|
|
25
25
|
implementation: handler.implementation,
|
|
@@ -37,4 +37,26 @@ export function createMethodMiddleware(options) {
|
|
|
37
37
|
return implementation({ request, context, next, hooks, messenger });
|
|
38
38
|
};
|
|
39
39
|
}
|
|
40
|
+
/**
|
|
41
|
+
* Returns the subset of the specified `hooks` that are included in the
|
|
42
|
+
* `hookNames` object. This is a Principle of Least Authority (POLA) measure
|
|
43
|
+
* to ensure that each RPC method implementation only has access to the
|
|
44
|
+
* API "hooks" it needs to do its job.
|
|
45
|
+
*
|
|
46
|
+
* @param hooks - The hooks to select from.
|
|
47
|
+
* @param hookNames - The names of the hooks to select.
|
|
48
|
+
* @returns The selected hooks.
|
|
49
|
+
* @template Hooks - The hooks to select from.
|
|
50
|
+
* @template HookName - The names of the hooks to select.
|
|
51
|
+
*/
|
|
52
|
+
export function selectHooks(hooks, hookNames) {
|
|
53
|
+
if (hookNames) {
|
|
54
|
+
return Object.keys(hookNames).reduce((hookSubset, _hookName) => {
|
|
55
|
+
const hookName = _hookName;
|
|
56
|
+
hookSubset[hookName] = hooks[hookName];
|
|
57
|
+
return hookSubset;
|
|
58
|
+
}, {});
|
|
59
|
+
}
|
|
60
|
+
return undefined;
|
|
61
|
+
}
|
|
40
62
|
//# sourceMappingURL=createMethodMiddleware.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"createMethodMiddleware.mjs","sourceRoot":"","sources":["../../src/v2/createMethodMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,SAAS,EAAE,4BAA4B;
|
|
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"]}
|
package/dist/v2/index.cjs
CHANGED
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.
|
|
3
|
+
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;
|
|
4
4
|
var asLegacyMiddleware_1 = require("./asLegacyMiddleware.cjs");
|
|
5
5
|
Object.defineProperty(exports, "asLegacyMiddleware", { enumerable: true, get: function () { return asLegacyMiddleware_1.asLegacyMiddleware; } });
|
|
6
6
|
var getUniqueId_1 = require("../getUniqueId.cjs");
|
|
7
7
|
Object.defineProperty(exports, "getUniqueId", { enumerable: true, get: function () { return getUniqueId_1.getUniqueId; } });
|
|
8
8
|
var createMethodMiddleware_1 = require("./createMethodMiddleware.cjs");
|
|
9
|
+
Object.defineProperty(exports, "selectHooks", { enumerable: true, get: function () { return createMethodMiddleware_1.selectHooks; } });
|
|
9
10
|
Object.defineProperty(exports, "createMethodMiddleware", { enumerable: true, get: function () { return createMethodMiddleware_1.createMethodMiddleware; } });
|
|
10
11
|
var createOriginMiddleware_1 = require("./createOriginMiddleware.cjs");
|
|
11
12
|
Object.defineProperty(exports, "createOriginMiddleware", { enumerable: true, get: function () { return createOriginMiddleware_1.createOriginMiddleware; } });
|
|
@@ -21,5 +22,4 @@ var utils_1 = require("./utils.cjs");
|
|
|
21
22
|
Object.defineProperty(exports, "isNotification", { enumerable: true, get: function () { return utils_1.isNotification; } });
|
|
22
23
|
Object.defineProperty(exports, "isRequest", { enumerable: true, get: function () { return utils_1.isRequest; } });
|
|
23
24
|
Object.defineProperty(exports, "JsonRpcEngineError", { enumerable: true, get: function () { return utils_1.JsonRpcEngineError; } });
|
|
24
|
-
Object.defineProperty(exports, "selectHooks", { enumerable: true, get: function () { return utils_1.selectHooks; } });
|
|
25
25
|
//# sourceMappingURL=index.cjs.map
|
package/dist/v2/index.cjs.map
CHANGED
|
@@ -1 +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,
|
|
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"]}
|
package/dist/v2/index.d.cts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
export { asLegacyMiddleware } from "./asLegacyMiddleware.cjs";
|
|
2
2
|
export { getUniqueId } from "../getUniqueId.cjs";
|
|
3
|
-
export { createMethodMiddleware } from "./createMethodMiddleware.cjs";
|
|
3
|
+
export { selectHooks, createMethodMiddleware } from "./createMethodMiddleware.cjs";
|
|
4
4
|
export type { MethodHandler } from "./createMethodMiddleware.cjs";
|
|
5
5
|
export { createOriginMiddleware } from "./createOriginMiddleware.cjs";
|
|
6
6
|
export { createScaffoldMiddleware } from "./createScaffoldMiddleware.cjs";
|
|
@@ -9,6 +9,6 @@ export type { JsonRpcMiddleware, HandleOptions, MergedContextOf, MiddlewareParam
|
|
|
9
9
|
export { JsonRpcServer } from "./JsonRpcServer.cjs";
|
|
10
10
|
export { MiddlewareContext } from "./MiddlewareContext.cjs";
|
|
11
11
|
export type { EmptyContext, ContextConstraint } from "./MiddlewareContext.cjs";
|
|
12
|
-
export { isNotification, isRequest, JsonRpcEngineError
|
|
12
|
+
export { isNotification, isRequest, JsonRpcEngineError } from "./utils.cjs";
|
|
13
13
|
export type { Json, JsonRpcCall, JsonRpcNotification, JsonRpcParams, JsonRpcRequest, } from "./utils.cjs";
|
|
14
14
|
//# sourceMappingURL=index.d.cts.map
|
package/dist/v2/index.d.cts.map
CHANGED
|
@@ -1 +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,sBAAsB,EAAE,qCAAiC;
|
|
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"}
|
package/dist/v2/index.d.mts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
export { asLegacyMiddleware } from "./asLegacyMiddleware.mjs";
|
|
2
2
|
export { getUniqueId } from "../getUniqueId.mjs";
|
|
3
|
-
export { createMethodMiddleware } from "./createMethodMiddleware.mjs";
|
|
3
|
+
export { selectHooks, createMethodMiddleware } from "./createMethodMiddleware.mjs";
|
|
4
4
|
export type { MethodHandler } from "./createMethodMiddleware.mjs";
|
|
5
5
|
export { createOriginMiddleware } from "./createOriginMiddleware.mjs";
|
|
6
6
|
export { createScaffoldMiddleware } from "./createScaffoldMiddleware.mjs";
|
|
@@ -9,6 +9,6 @@ export type { JsonRpcMiddleware, HandleOptions, MergedContextOf, MiddlewareParam
|
|
|
9
9
|
export { JsonRpcServer } from "./JsonRpcServer.mjs";
|
|
10
10
|
export { MiddlewareContext } from "./MiddlewareContext.mjs";
|
|
11
11
|
export type { EmptyContext, ContextConstraint } from "./MiddlewareContext.mjs";
|
|
12
|
-
export { isNotification, isRequest, JsonRpcEngineError
|
|
12
|
+
export { isNotification, isRequest, JsonRpcEngineError } from "./utils.mjs";
|
|
13
13
|
export type { Json, JsonRpcCall, JsonRpcNotification, JsonRpcParams, JsonRpcRequest, } from "./utils.mjs";
|
|
14
14
|
//# sourceMappingURL=index.d.mts.map
|
package/dist/v2/index.d.mts.map
CHANGED
|
@@ -1 +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,sBAAsB,EAAE,qCAAiC;
|
|
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"}
|
package/dist/v2/index.mjs
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
export { asLegacyMiddleware } from "./asLegacyMiddleware.mjs";
|
|
2
2
|
export { getUniqueId } from "../getUniqueId.mjs";
|
|
3
|
-
export { createMethodMiddleware } from "./createMethodMiddleware.mjs";
|
|
3
|
+
export { selectHooks, createMethodMiddleware } from "./createMethodMiddleware.mjs";
|
|
4
4
|
export { createOriginMiddleware } from "./createOriginMiddleware.mjs";
|
|
5
5
|
export { createScaffoldMiddleware } from "./createScaffoldMiddleware.mjs";
|
|
6
6
|
export { JsonRpcEngineV2 } from "./JsonRpcEngineV2.mjs";
|
|
7
7
|
export { JsonRpcServer } from "./JsonRpcServer.mjs";
|
|
8
8
|
export { MiddlewareContext } from "./MiddlewareContext.mjs";
|
|
9
|
-
export { isNotification, isRequest, JsonRpcEngineError
|
|
9
|
+
export { isNotification, isRequest, JsonRpcEngineError } from "./utils.mjs";
|
|
10
10
|
//# sourceMappingURL=index.mjs.map
|
package/dist/v2/index.mjs.map
CHANGED
|
@@ -1 +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,sBAAsB,EAAE,qCAAiC;
|
|
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"]}
|
package/dist/v2/utils.cjs
CHANGED
|
@@ -1,8 +1,7 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
var _a;
|
|
3
3
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
4
|
-
exports.
|
|
5
|
-
const messenger_1 = require("@metamask/messenger");
|
|
4
|
+
exports.JsonRpcEngineError = exports.isInstance = exports.stringify = exports.isNotification = exports.isRequest = void 0;
|
|
6
5
|
const utils_1 = require("@metamask/utils");
|
|
7
6
|
const isRequest = (message) => (0, utils_1.hasProperty)(message, 'id');
|
|
8
7
|
exports.isRequest = isRequest;
|
|
@@ -50,78 +49,4 @@ class JsonRpcEngineError extends Error {
|
|
|
50
49
|
}
|
|
51
50
|
exports.JsonRpcEngineError = JsonRpcEngineError;
|
|
52
51
|
_a = JsonRpcEngineErrorSymbol;
|
|
53
|
-
// Method middleware utils
|
|
54
|
-
/**
|
|
55
|
-
* Returns the subset of the specified `hooks` that are included in the
|
|
56
|
-
* `hookNames` object. This is a Principle of Least Authority (POLA) measure
|
|
57
|
-
* to ensure that each RPC method implementation only has access to the
|
|
58
|
-
* API "hooks" it needs to do its job.
|
|
59
|
-
*
|
|
60
|
-
* @param hooks - The hooks to select from.
|
|
61
|
-
* @param hookNames - The names of the hooks to select.
|
|
62
|
-
* @returns The selected hooks, or `undefined` if `hookNames` is not provided.
|
|
63
|
-
* @template Hooks - The hooks to select from.
|
|
64
|
-
* @template HookName - The names of the hooks to select.
|
|
65
|
-
*/
|
|
66
|
-
function selectHooks(hooks, hookNames) {
|
|
67
|
-
if (hookNames) {
|
|
68
|
-
return Object.keys(hookNames).reduce((subset, name) => {
|
|
69
|
-
const hookName = name;
|
|
70
|
-
subset[hookName] = hooks[hookName];
|
|
71
|
-
return subset;
|
|
72
|
-
}, {});
|
|
73
|
-
}
|
|
74
|
-
return undefined;
|
|
75
|
-
}
|
|
76
|
-
exports.selectHooks = selectHooks;
|
|
77
|
-
/**
|
|
78
|
-
* Asserts that `hooks` contains exactly the hook names in `expectedHookNames`.
|
|
79
|
-
* Throws on any missing hooks, then on any extraneous hooks.
|
|
80
|
-
*
|
|
81
|
-
* @param hooks - The hooks object to validate.
|
|
82
|
-
* @param expectedHookNames - The expected hook names.
|
|
83
|
-
*/
|
|
84
|
-
function assertExpectedHooks(hooks, expectedHookNames) {
|
|
85
|
-
const missingHookNames = [];
|
|
86
|
-
expectedHookNames.forEach((hookName) => {
|
|
87
|
-
if (!(0, utils_1.hasProperty)(hooks, hookName)) {
|
|
88
|
-
missingHookNames.push(hookName);
|
|
89
|
-
}
|
|
90
|
-
});
|
|
91
|
-
if (missingHookNames.length > 0) {
|
|
92
|
-
throw new Error(`Missing expected hooks:\n\n${missingHookNames.join('\n')}\n`);
|
|
93
|
-
}
|
|
94
|
-
const extraneousHookNames = Object.getOwnPropertyNames(hooks).filter((hookName) => !expectedHookNames.has(hookName));
|
|
95
|
-
if (extraneousHookNames.length > 0) {
|
|
96
|
-
throw new Error(`Received unexpected hooks:\n\n${extraneousHookNames.join('\n')}\n`);
|
|
97
|
-
}
|
|
98
|
-
}
|
|
99
|
-
exports.assertExpectedHooks = assertExpectedHooks;
|
|
100
|
-
/**
|
|
101
|
-
* Creates a per-handler messenger namespaced to `namespace`, and delegates the
|
|
102
|
-
* specified `actionNames` from `rootMessenger` to it. This lets each handler
|
|
103
|
-
* call only the actions it declared, per POLA.
|
|
104
|
-
*
|
|
105
|
-
* @param options - The options.
|
|
106
|
-
* @param options.namespace - The namespace for the handler messenger.
|
|
107
|
-
* @param options.actionNames - Actions to delegate from the root messenger.
|
|
108
|
-
* @param options.rootMessenger - The root messenger to delegate from. Required
|
|
109
|
-
* when `actionNames` are provided.
|
|
110
|
-
* @returns The per-handler messenger.
|
|
111
|
-
*/
|
|
112
|
-
function createHandlerMessenger({ namespace, actionNames, rootMessenger, }) {
|
|
113
|
-
if (!actionNames) {
|
|
114
|
-
return undefined;
|
|
115
|
-
}
|
|
116
|
-
if (!rootMessenger) {
|
|
117
|
-
throw new Error('A messenger is required when a handler declares actionNames.');
|
|
118
|
-
}
|
|
119
|
-
const handlerMessenger = new messenger_1.Messenger({ namespace, parent: rootMessenger });
|
|
120
|
-
rootMessenger.delegate({
|
|
121
|
-
actions: actionNames,
|
|
122
|
-
messenger: handlerMessenger,
|
|
123
|
-
});
|
|
124
|
-
return handlerMessenger;
|
|
125
|
-
}
|
|
126
|
-
exports.createHandlerMessenger = createHandlerMessenger;
|
|
127
52
|
//# sourceMappingURL=utils.cjs.map
|