@metamask-previews/json-rpc-engine 9.0.2-preview-367cb1da → 9.0.2-preview-cf09c0a

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.
Files changed (108) hide show
  1. package/dist/JsonRpcEngine.cjs +355 -0
  2. package/dist/JsonRpcEngine.cjs.map +1 -0
  3. package/dist/{types/JsonRpcEngine.d.ts → JsonRpcEngine.d.cts} +3 -3
  4. package/dist/JsonRpcEngine.d.cts.map +1 -0
  5. package/dist/JsonRpcEngine.d.mts +114 -0
  6. package/dist/JsonRpcEngine.d.mts.map +1 -0
  7. package/dist/JsonRpcEngine.mjs +346 -6
  8. package/dist/JsonRpcEngine.mjs.map +1 -1
  9. package/dist/createAsyncMiddleware.cjs +70 -0
  10. package/dist/createAsyncMiddleware.cjs.map +1 -0
  11. package/dist/{types/createAsyncMiddleware.d.ts → createAsyncMiddleware.d.cts} +3 -3
  12. package/dist/createAsyncMiddleware.d.cts.map +1 -0
  13. package/dist/createAsyncMiddleware.d.mts +27 -0
  14. package/dist/createAsyncMiddleware.d.mts.map +1 -0
  15. package/dist/createAsyncMiddleware.mjs +65 -7
  16. package/dist/createAsyncMiddleware.mjs.map +1 -1
  17. package/dist/createScaffoldMiddleware.cjs +30 -0
  18. package/dist/createScaffoldMiddleware.cjs.map +1 -0
  19. package/dist/{types/createScaffoldMiddleware.d.ts → createScaffoldMiddleware.d.cts} +3 -3
  20. package/dist/createScaffoldMiddleware.d.cts.map +1 -0
  21. package/dist/createScaffoldMiddleware.d.mts +17 -0
  22. package/dist/createScaffoldMiddleware.d.mts.map +1 -0
  23. package/dist/createScaffoldMiddleware.mjs +25 -7
  24. package/dist/createScaffoldMiddleware.mjs.map +1 -1
  25. package/dist/getUniqueId.cjs +20 -0
  26. package/dist/getUniqueId.cjs.map +1 -0
  27. package/dist/{types/getUniqueId.d.ts → getUniqueId.d.cts} +1 -1
  28. package/dist/getUniqueId.d.cts.map +1 -0
  29. package/dist/getUniqueId.d.mts +9 -0
  30. package/dist/getUniqueId.d.mts.map +1 -0
  31. package/dist/getUniqueId.mjs +15 -7
  32. package/dist/getUniqueId.mjs.map +1 -1
  33. package/dist/idRemapMiddleware.cjs +28 -0
  34. package/dist/idRemapMiddleware.cjs.map +1 -0
  35. package/dist/{types/idRemapMiddleware.d.ts → idRemapMiddleware.d.cts} +3 -3
  36. package/dist/idRemapMiddleware.d.cts.map +1 -0
  37. package/dist/idRemapMiddleware.d.mts +13 -0
  38. package/dist/idRemapMiddleware.d.mts.map +1 -0
  39. package/dist/idRemapMiddleware.mjs +23 -8
  40. package/dist/idRemapMiddleware.mjs.map +1 -1
  41. package/dist/index.cjs +16 -0
  42. package/dist/index.cjs.map +1 -0
  43. package/dist/index.d.cts +9 -0
  44. package/dist/index.d.cts.map +1 -0
  45. package/dist/index.d.mts +9 -0
  46. package/dist/index.d.mts.map +1 -0
  47. package/dist/index.mjs +6 -27
  48. package/dist/index.mjs.map +1 -1
  49. package/dist/mergeMiddleware.cjs +17 -0
  50. package/dist/mergeMiddleware.cjs.map +1 -0
  51. package/dist/{types/mergeMiddleware.d.ts → mergeMiddleware.d.cts} +3 -3
  52. package/dist/mergeMiddleware.d.cts.map +1 -0
  53. package/dist/mergeMiddleware.d.mts +10 -0
  54. package/dist/mergeMiddleware.d.mts.map +1 -0
  55. package/dist/mergeMiddleware.mjs +12 -8
  56. package/dist/mergeMiddleware.mjs.map +1 -1
  57. package/package.json +12 -7
  58. package/dist/JsonRpcEngine.js +0 -8
  59. package/dist/JsonRpcEngine.js.map +0 -1
  60. package/dist/chunk-2LXAFMJD.js +0 -416
  61. package/dist/chunk-2LXAFMJD.js.map +0 -1
  62. package/dist/chunk-3AC2MIND.js +0 -19
  63. package/dist/chunk-3AC2MIND.js.map +0 -1
  64. package/dist/chunk-5HCYV4FV.mjs +0 -416
  65. package/dist/chunk-5HCYV4FV.mjs.map +0 -1
  66. package/dist/chunk-6XXPTZV6.mjs +0 -12
  67. package/dist/chunk-6XXPTZV6.mjs.map +0 -1
  68. package/dist/chunk-KFRJCTOQ.mjs +0 -15
  69. package/dist/chunk-KFRJCTOQ.mjs.map +0 -1
  70. package/dist/chunk-KNT3O2VO.mjs +0 -39
  71. package/dist/chunk-KNT3O2VO.mjs.map +0 -1
  72. package/dist/chunk-KZ5RA76F.mjs +0 -19
  73. package/dist/chunk-KZ5RA76F.mjs.map +0 -1
  74. package/dist/chunk-PBQXMZM5.js +0 -23
  75. package/dist/chunk-PBQXMZM5.js.map +0 -1
  76. package/dist/chunk-R7LKI5H5.mjs +0 -23
  77. package/dist/chunk-R7LKI5H5.mjs.map +0 -1
  78. package/dist/chunk-VK4MHWJV.js +0 -15
  79. package/dist/chunk-VK4MHWJV.js.map +0 -1
  80. package/dist/chunk-XDGWQHNY.js +0 -12
  81. package/dist/chunk-XDGWQHNY.js.map +0 -1
  82. package/dist/chunk-XUI43LEZ.mjs +0 -30
  83. package/dist/chunk-XUI43LEZ.mjs.map +0 -1
  84. package/dist/chunk-Z4BLTVTB.js +0 -30
  85. package/dist/chunk-Z4BLTVTB.js.map +0 -1
  86. package/dist/chunk-ZYXL5TCS.js +0 -39
  87. package/dist/chunk-ZYXL5TCS.js.map +0 -1
  88. package/dist/createAsyncMiddleware.js +0 -8
  89. package/dist/createAsyncMiddleware.js.map +0 -1
  90. package/dist/createScaffoldMiddleware.js +0 -8
  91. package/dist/createScaffoldMiddleware.js.map +0 -1
  92. package/dist/getUniqueId.js +0 -8
  93. package/dist/getUniqueId.js.map +0 -1
  94. package/dist/idRemapMiddleware.js +0 -9
  95. package/dist/idRemapMiddleware.js.map +0 -1
  96. package/dist/index.js +0 -28
  97. package/dist/index.js.map +0 -1
  98. package/dist/mergeMiddleware.js +0 -9
  99. package/dist/mergeMiddleware.js.map +0 -1
  100. package/dist/tsconfig.build.tsbuildinfo +0 -1
  101. package/dist/types/JsonRpcEngine.d.ts.map +0 -1
  102. package/dist/types/createAsyncMiddleware.d.ts.map +0 -1
  103. package/dist/types/createScaffoldMiddleware.d.ts.map +0 -1
  104. package/dist/types/getUniqueId.d.ts.map +0 -1
  105. package/dist/types/idRemapMiddleware.d.ts.map +0 -1
  106. package/dist/types/index.d.ts +0 -9
  107. package/dist/types/index.d.ts.map +0 -1
  108. package/dist/types/mergeMiddleware.d.ts.map +0 -1
@@ -0,0 +1,355 @@
1
+ "use strict";
2
+ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
3
+ if (kind === "m") throw new TypeError("Private method is not writable");
4
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
5
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
6
+ return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
7
+ };
8
+ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
9
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
10
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
11
+ return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
12
+ };
13
+ var __importDefault = (this && this.__importDefault) || function (mod) {
14
+ return (mod && mod.__esModule) ? mod : { "default": mod };
15
+ };
16
+ var _JsonRpcEngine_instances, _a, _JsonRpcEngine_isDestroyed, _JsonRpcEngine_middleware, _JsonRpcEngine_notificationHandler, _JsonRpcEngine_assertIsNotDestroyed, _JsonRpcEngine_handleBatch, _JsonRpcEngine_handle, _JsonRpcEngine_processRequest, _JsonRpcEngine_runAllMiddleware, _JsonRpcEngine_runMiddleware, _JsonRpcEngine_runReturnHandlers, _JsonRpcEngine_checkForCompletion;
17
+ Object.defineProperty(exports, "__esModule", { value: true });
18
+ exports.JsonRpcEngine = void 0;
19
+ const rpc_errors_1 = require("@metamask/rpc-errors");
20
+ const safe_event_emitter_1 = __importDefault(require("@metamask/safe-event-emitter"));
21
+ const utils_1 = require("@metamask/utils");
22
+ const DESTROYED_ERROR_MESSAGE = 'This engine is destroyed and can no longer be used.';
23
+ /**
24
+ * A JSON-RPC request and response processor.
25
+ * Give it a stack of middleware, pass it requests, and get back responses.
26
+ */
27
+ class JsonRpcEngine extends safe_event_emitter_1.default {
28
+ /**
29
+ * Constructs a {@link JsonRpcEngine} instance.
30
+ *
31
+ * @param options - Options bag.
32
+ * @param options.notificationHandler - A function for handling JSON-RPC
33
+ * notifications. A JSON-RPC notification is defined as a JSON-RPC request
34
+ * without an `id` property. If this option is _not_ provided, notifications
35
+ * will be treated the same as requests. If this option _is_ provided,
36
+ * notifications will be passed to the handler function without touching
37
+ * the engine's middleware stack. This function should not throw or reject.
38
+ */
39
+ constructor({ notificationHandler } = {}) {
40
+ super();
41
+ _JsonRpcEngine_instances.add(this);
42
+ /**
43
+ * Indicating whether this engine is destroyed or not.
44
+ */
45
+ _JsonRpcEngine_isDestroyed.set(this, false);
46
+ _JsonRpcEngine_middleware.set(this, void 0);
47
+ _JsonRpcEngine_notificationHandler.set(this, void 0);
48
+ __classPrivateFieldSet(this, _JsonRpcEngine_middleware, [], "f");
49
+ __classPrivateFieldSet(this, _JsonRpcEngine_notificationHandler, notificationHandler, "f");
50
+ }
51
+ /**
52
+ * Calls the `destroy()` function of any middleware with that property, clears
53
+ * the middleware array, and marks this engine as destroyed. A destroyed
54
+ * engine cannot be used.
55
+ */
56
+ destroy() {
57
+ __classPrivateFieldGet(this, _JsonRpcEngine_middleware, "f").forEach((middleware) => {
58
+ if (
59
+ // `in` walks the prototype chain, which is probably the desired
60
+ // behavior here.
61
+ 'destroy' in middleware &&
62
+ typeof middleware.destroy === 'function') {
63
+ // eslint-disable-next-line @typescript-eslint/no-floating-promises
64
+ middleware.destroy();
65
+ }
66
+ });
67
+ __classPrivateFieldSet(this, _JsonRpcEngine_middleware, [], "f");
68
+ __classPrivateFieldSet(this, _JsonRpcEngine_isDestroyed, true, "f");
69
+ }
70
+ /**
71
+ * Add a middleware function to the engine's middleware stack.
72
+ *
73
+ * @param middleware - The middleware function to add.
74
+ */
75
+ push(middleware) {
76
+ __classPrivateFieldGet(this, _JsonRpcEngine_instances, "m", _JsonRpcEngine_assertIsNotDestroyed).call(this);
77
+ __classPrivateFieldGet(this, _JsonRpcEngine_middleware, "f").push(middleware);
78
+ }
79
+ handle(req, callback) {
80
+ __classPrivateFieldGet(this, _JsonRpcEngine_instances, "m", _JsonRpcEngine_assertIsNotDestroyed).call(this);
81
+ if (callback && typeof callback !== 'function') {
82
+ throw new Error('"callback" must be a function if provided.');
83
+ }
84
+ if (Array.isArray(req)) {
85
+ if (callback) {
86
+ return __classPrivateFieldGet(this, _JsonRpcEngine_instances, "m", _JsonRpcEngine_handleBatch).call(this, req,
87
+ // This assertion is safe because of the runtime checks validating that `req` is an array and `callback` is defined.
88
+ // There is only one overload signature that satisfies both conditions, and its `callback` type is the one that's being asserted.
89
+ callback);
90
+ }
91
+ return __classPrivateFieldGet(this, _JsonRpcEngine_instances, "m", _JsonRpcEngine_handleBatch).call(this, req);
92
+ }
93
+ if (callback) {
94
+ return __classPrivateFieldGet(this, _JsonRpcEngine_instances, "m", _JsonRpcEngine_handle).call(this, req, callback);
95
+ }
96
+ return this._promiseHandle(req);
97
+ }
98
+ /**
99
+ * Returns this engine as a middleware function that can be pushed to other
100
+ * engines.
101
+ *
102
+ * @returns This engine as a middleware function.
103
+ */
104
+ asMiddleware() {
105
+ __classPrivateFieldGet(this, _JsonRpcEngine_instances, "m", _JsonRpcEngine_assertIsNotDestroyed).call(this);
106
+ // eslint-disable-next-line @typescript-eslint/no-misused-promises
107
+ return async (req, res, next, end) => {
108
+ try {
109
+ const [middlewareError, isComplete, returnHandlers] = await __classPrivateFieldGet(_a, _a, "m", _JsonRpcEngine_runAllMiddleware).call(_a, req, res, __classPrivateFieldGet(this, _JsonRpcEngine_middleware, "f"));
110
+ if (isComplete) {
111
+ await __classPrivateFieldGet(_a, _a, "m", _JsonRpcEngine_runReturnHandlers).call(_a, returnHandlers);
112
+ return end(middlewareError);
113
+ }
114
+ // eslint-disable-next-line @typescript-eslint/no-misused-promises
115
+ return next(async (handlerCallback) => {
116
+ try {
117
+ await __classPrivateFieldGet(_a, _a, "m", _JsonRpcEngine_runReturnHandlers).call(_a, returnHandlers);
118
+ }
119
+ catch (error) {
120
+ return handlerCallback(error);
121
+ }
122
+ return handlerCallback();
123
+ });
124
+ }
125
+ catch (error) {
126
+ return end(error);
127
+ }
128
+ };
129
+ }
130
+ /**
131
+ * A promise-wrapped _handle.
132
+ *
133
+ * @param request - The JSON-RPC request.
134
+ * @returns The JSON-RPC response.
135
+ */
136
+ // This function is used in tests, so we cannot easily change it to use the
137
+ // hash syntax.
138
+ // eslint-disable-next-line no-restricted-syntax
139
+ async _promiseHandle(request) {
140
+ return new Promise((resolve, reject) => {
141
+ __classPrivateFieldGet(this, _JsonRpcEngine_instances, "m", _JsonRpcEngine_handle).call(this, request, (error, res) => {
142
+ // For notifications, the response will be `undefined`, and any caught
143
+ // errors are unexpected and should be surfaced to the caller.
144
+ if (error && res === undefined) {
145
+ reject(error);
146
+ }
147
+ else {
148
+ // Excepting notifications, there will always be a response, and it will
149
+ // always have any error that is caught and propagated.
150
+ resolve(res);
151
+ }
152
+ }).catch(reject);
153
+ });
154
+ }
155
+ }
156
+ exports.JsonRpcEngine = JsonRpcEngine;
157
+ _a = JsonRpcEngine, _JsonRpcEngine_isDestroyed = new WeakMap(), _JsonRpcEngine_middleware = new WeakMap(), _JsonRpcEngine_notificationHandler = new WeakMap(), _JsonRpcEngine_instances = new WeakSet(), _JsonRpcEngine_assertIsNotDestroyed = function _JsonRpcEngine_assertIsNotDestroyed() {
158
+ if (__classPrivateFieldGet(this, _JsonRpcEngine_isDestroyed, "f")) {
159
+ throw new Error(DESTROYED_ERROR_MESSAGE);
160
+ }
161
+ }, _JsonRpcEngine_handleBatch =
162
+ /**
163
+ * Handles a batch of JSON-RPC requests, either in `async` or callback
164
+ * fashion.
165
+ *
166
+ * @param requests - The request objects to process.
167
+ * @param callback - The completion callback.
168
+ * @returns The array of responses, or nothing if a callback was specified.
169
+ */
170
+ async function _JsonRpcEngine_handleBatch(requests, callback) {
171
+ // The order here is important
172
+ try {
173
+ // If the batch is an empty array, the response array must contain a single object
174
+ if (requests.length === 0) {
175
+ const response = [
176
+ {
177
+ id: null,
178
+ jsonrpc: '2.0',
179
+ error: new rpc_errors_1.JsonRpcError(rpc_errors_1.errorCodes.rpc.invalidRequest, 'Request batch must contain plain objects. Received an empty array'),
180
+ },
181
+ ];
182
+ if (callback) {
183
+ return callback(null, response);
184
+ }
185
+ return response;
186
+ }
187
+ // 2. Wait for all requests to finish, or throw on some kind of fatal
188
+ // error
189
+ const responses = (await Promise.all(
190
+ // 1. Begin executing each request in the order received
191
+ requests.map(this._promiseHandle.bind(this)))).filter(
192
+ // Filter out any notification responses.
193
+ (response) => response !== undefined);
194
+ // 3. Return batch response
195
+ if (callback) {
196
+ return callback(null, responses);
197
+ }
198
+ return responses;
199
+ }
200
+ catch (error) {
201
+ if (callback) {
202
+ return callback(error);
203
+ }
204
+ throw error;
205
+ }
206
+ }, _JsonRpcEngine_handle =
207
+ /**
208
+ * Ensures that the request / notification object is valid, processes it, and
209
+ * passes any error and response object to the given callback.
210
+ *
211
+ * Does not reject.
212
+ *
213
+ * @param callerReq - The request object from the caller.
214
+ * @param callback - The callback function.
215
+ * @returns Nothing.
216
+ */
217
+ async function _JsonRpcEngine_handle(callerReq, callback) {
218
+ if (!callerReq ||
219
+ Array.isArray(callerReq) ||
220
+ typeof callerReq !== 'object') {
221
+ const error = new rpc_errors_1.JsonRpcError(rpc_errors_1.errorCodes.rpc.invalidRequest, `Requests must be plain objects. Received: ${typeof callerReq}`, { request: callerReq });
222
+ return callback(error, { id: null, jsonrpc: '2.0', error });
223
+ }
224
+ if (typeof callerReq.method !== 'string') {
225
+ const error = new rpc_errors_1.JsonRpcError(rpc_errors_1.errorCodes.rpc.invalidRequest, `Must specify a string method. Received: ${typeof callerReq.method}`, { request: callerReq });
226
+ if (__classPrivateFieldGet(this, _JsonRpcEngine_notificationHandler, "f") && !(0, utils_1.isJsonRpcRequest)(callerReq)) {
227
+ // Do not reply to notifications, even if they are malformed.
228
+ return callback(null);
229
+ }
230
+ return callback(error, {
231
+ // Typecast: This could be a notification, but we want to access the
232
+ // `id` even if it doesn't exist.
233
+ id: callerReq.id ?? null,
234
+ jsonrpc: '2.0',
235
+ error,
236
+ });
237
+ }
238
+ else if (__classPrivateFieldGet(this, _JsonRpcEngine_notificationHandler, "f") &&
239
+ (0, utils_1.isJsonRpcNotification)(callerReq) &&
240
+ !(0, utils_1.isJsonRpcRequest)(callerReq)) {
241
+ try {
242
+ await __classPrivateFieldGet(this, _JsonRpcEngine_notificationHandler, "f").call(this, callerReq);
243
+ }
244
+ catch (error) {
245
+ return callback(error);
246
+ }
247
+ return callback(null);
248
+ }
249
+ let error = null;
250
+ // Handle requests.
251
+ // Typecast: Permit missing id's for backwards compatibility.
252
+ const req = { ...callerReq };
253
+ const res = {
254
+ id: req.id,
255
+ jsonrpc: req.jsonrpc,
256
+ };
257
+ try {
258
+ await __classPrivateFieldGet(_a, _a, "m", _JsonRpcEngine_processRequest).call(_a, req, res, __classPrivateFieldGet(this, _JsonRpcEngine_middleware, "f"));
259
+ }
260
+ catch (_error) {
261
+ // A request handler error, a re-thrown middleware error, or something
262
+ // unexpected.
263
+ error = _error;
264
+ }
265
+ if (error) {
266
+ // Ensure no result is present on an errored response
267
+ delete res.result;
268
+ if (!res.error) {
269
+ res.error = (0, rpc_errors_1.serializeError)(error);
270
+ }
271
+ }
272
+ return callback(error, res);
273
+ }, _JsonRpcEngine_processRequest = async function _JsonRpcEngine_processRequest(req, res, middlewares) {
274
+ const [error, isComplete, returnHandlers] = await __classPrivateFieldGet(_a, _a, "m", _JsonRpcEngine_runAllMiddleware).call(_a, req, res, middlewares);
275
+ // Throw if "end" was not called, or if the response has neither a result
276
+ // nor an error.
277
+ __classPrivateFieldGet(_a, _a, "m", _JsonRpcEngine_checkForCompletion).call(_a, req, res, isComplete);
278
+ // The return handlers should run even if an error was encountered during
279
+ // middleware processing.
280
+ await __classPrivateFieldGet(_a, _a, "m", _JsonRpcEngine_runReturnHandlers).call(_a, returnHandlers);
281
+ // Now we re-throw the middleware processing error, if any, to catch it
282
+ // further up the call chain.
283
+ if (error) {
284
+ // eslint-disable-next-line @typescript-eslint/no-throw-literal
285
+ throw error;
286
+ }
287
+ }, _JsonRpcEngine_runAllMiddleware = async function _JsonRpcEngine_runAllMiddleware(req, res, middlewares) {
288
+ const returnHandlers = [];
289
+ let error = null;
290
+ let isComplete = false;
291
+ // Go down stack of middleware, call and collect optional returnHandlers
292
+ for (const middleware of middlewares) {
293
+ [error, isComplete] = await __classPrivateFieldGet(_a, _a, "m", _JsonRpcEngine_runMiddleware).call(_a, req, res, middleware, returnHandlers);
294
+ if (isComplete) {
295
+ break;
296
+ }
297
+ }
298
+ return [error, isComplete, returnHandlers.reverse()];
299
+ }, _JsonRpcEngine_runMiddleware = async function _JsonRpcEngine_runMiddleware(request, response, middleware, returnHandlers) {
300
+ return new Promise((resolve) => {
301
+ const end = (error) => {
302
+ const parsedError = error || response.error;
303
+ if (parsedError) {
304
+ response.error = (0, rpc_errors_1.serializeError)(parsedError);
305
+ }
306
+ // True indicates that the request should end
307
+ resolve([parsedError, true]);
308
+ };
309
+ const next = (returnHandler) => {
310
+ if (response.error) {
311
+ end(response.error);
312
+ }
313
+ else {
314
+ if (returnHandler) {
315
+ if (typeof returnHandler !== 'function') {
316
+ end(new rpc_errors_1.JsonRpcError(rpc_errors_1.errorCodes.rpc.internal, `JsonRpcEngine: "next" return handlers must be functions. ` +
317
+ `Received "${typeof returnHandler}" for request:\n${jsonify(request)}`, { request }));
318
+ }
319
+ returnHandlers.push(returnHandler);
320
+ }
321
+ // False indicates that the request should not end
322
+ resolve([null, false]);
323
+ }
324
+ };
325
+ try {
326
+ middleware(request, response, next, end);
327
+ }
328
+ catch (error) {
329
+ end(error);
330
+ }
331
+ });
332
+ }, _JsonRpcEngine_runReturnHandlers = async function _JsonRpcEngine_runReturnHandlers(handlers) {
333
+ for (const handler of handlers) {
334
+ await new Promise((resolve, reject) => {
335
+ handler((error) => (error ? reject(error) : resolve()));
336
+ });
337
+ }
338
+ }, _JsonRpcEngine_checkForCompletion = function _JsonRpcEngine_checkForCompletion(request, response, isComplete) {
339
+ if (!(0, utils_1.hasProperty)(response, 'result') && !(0, utils_1.hasProperty)(response, 'error')) {
340
+ throw new rpc_errors_1.JsonRpcError(rpc_errors_1.errorCodes.rpc.internal, `JsonRpcEngine: Response has no error or result for request:\n${jsonify(request)}`, { request });
341
+ }
342
+ if (!isComplete) {
343
+ throw new rpc_errors_1.JsonRpcError(rpc_errors_1.errorCodes.rpc.internal, `JsonRpcEngine: Nothing ended request:\n${jsonify(request)}`, { request });
344
+ }
345
+ };
346
+ /**
347
+ * JSON-stringifies a request object.
348
+ *
349
+ * @param request - The request object to JSON-stringify.
350
+ * @returns The JSON-stringified request object.
351
+ */
352
+ function jsonify(request) {
353
+ return JSON.stringify(request, null, 2);
354
+ }
355
+ //# sourceMappingURL=JsonRpcEngine.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"JsonRpcEngine.cjs","sourceRoot":"","sources":["../src/JsonRpcEngine.ts"],"names":[],"mappings":"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","sourcesContent":["import { errorCodes, JsonRpcError, serializeError } from '@metamask/rpc-errors';\nimport SafeEventEmitter from '@metamask/safe-event-emitter';\nimport type {\n JsonRpcError as SerializedJsonRpcError,\n JsonRpcRequest,\n JsonRpcResponse,\n JsonRpcNotification,\n Json,\n JsonRpcParams,\n PendingJsonRpcResponse,\n} from '@metamask/utils';\nimport {\n hasProperty,\n isJsonRpcNotification,\n isJsonRpcRequest,\n} from '@metamask/utils';\n\nexport type JsonRpcEngineCallbackError = Error | SerializedJsonRpcError | null;\n\nexport type JsonRpcEngineReturnHandler = (\n done: (error?: unknown) => void,\n) => void;\n\nexport type JsonRpcEngineNextCallback = (\n returnHandlerCallback?: JsonRpcEngineReturnHandler,\n) => void;\n\nexport type JsonRpcEngineEndCallback = (error?: unknown) => void;\n\nexport type JsonRpcMiddleware<\n Params extends JsonRpcParams,\n Result extends Json,\n> = {\n (\n req: JsonRpcRequest<Params>,\n res: PendingJsonRpcResponse<Result>,\n next: JsonRpcEngineNextCallback,\n end: JsonRpcEngineEndCallback,\n ): void;\n destroy?: () => void | Promise<void>;\n};\n\nconst DESTROYED_ERROR_MESSAGE =\n 'This engine is destroyed and can no longer be used.';\n\nexport type JsonRpcNotificationHandler<Params extends JsonRpcParams> = (\n notification: JsonRpcNotification<Params>,\n) => void | Promise<void>;\n\ntype JsonRpcEngineArgs = {\n /**\n * A function for handling JSON-RPC notifications. A JSON-RPC notification is\n * defined as a JSON-RPC request without an `id` property. If this option is\n * _not_ provided, notifications will be treated the same as requests. If this\n * option _is_ provided, notifications will be passed to the handler\n * function without touching the engine's middleware stack.\n *\n * This function should not throw or reject.\n */\n notificationHandler?: JsonRpcNotificationHandler<JsonRpcParams>;\n};\n\n/**\n * A JSON-RPC request and response processor.\n * Give it a stack of middleware, pass it requests, and get back responses.\n */\nexport class JsonRpcEngine extends SafeEventEmitter {\n /**\n * Indicating whether this engine is destroyed or not.\n */\n #isDestroyed = false;\n\n #middleware: JsonRpcMiddleware<JsonRpcParams, Json>[];\n\n readonly #notificationHandler?:\n | JsonRpcNotificationHandler<JsonRpcParams>\n | undefined;\n\n /**\n * Constructs a {@link JsonRpcEngine} instance.\n *\n * @param options - Options bag.\n * @param options.notificationHandler - A function for handling JSON-RPC\n * notifications. A JSON-RPC notification is defined as a JSON-RPC request\n * without an `id` property. If this option is _not_ provided, notifications\n * will be treated the same as requests. If this option _is_ provided,\n * notifications will be passed to the handler function without touching\n * the engine's middleware stack. This function should not throw or reject.\n */\n constructor({ notificationHandler }: JsonRpcEngineArgs = {}) {\n super();\n this.#middleware = [];\n this.#notificationHandler = notificationHandler;\n }\n\n /**\n * Throws an error if this engine is destroyed.\n */\n #assertIsNotDestroyed() {\n if (this.#isDestroyed) {\n throw new Error(DESTROYED_ERROR_MESSAGE);\n }\n }\n\n /**\n * Calls the `destroy()` function of any middleware with that property, clears\n * the middleware array, and marks this engine as destroyed. A destroyed\n * engine cannot be used.\n */\n destroy(): void {\n this.#middleware.forEach(\n (middleware: JsonRpcMiddleware<JsonRpcParams, Json>) => {\n if (\n // `in` walks the prototype chain, which is probably the desired\n // behavior here.\n 'destroy' in middleware &&\n typeof middleware.destroy === 'function'\n ) {\n // eslint-disable-next-line @typescript-eslint/no-floating-promises\n middleware.destroy();\n }\n },\n );\n this.#middleware = [];\n this.#isDestroyed = true;\n }\n\n /**\n * Add a middleware function to the engine's middleware stack.\n *\n * @param middleware - The middleware function to add.\n */\n push<Params extends JsonRpcParams, Result extends Json>(\n middleware: JsonRpcMiddleware<Params, Result>,\n ): void {\n this.#assertIsNotDestroyed();\n this.#middleware.push(middleware as JsonRpcMiddleware<JsonRpcParams, Json>);\n }\n\n /**\n * Handle a JSON-RPC request, and return a response.\n *\n * @param request - The request to handle.\n * @param callback - An error-first callback that will receive the response.\n */\n handle<Params extends JsonRpcParams, Result extends Json>(\n request: JsonRpcRequest<Params>,\n callback: (error: unknown, response: JsonRpcResponse<Result>) => void,\n ): void;\n\n /**\n * Handle a JSON-RPC notification.\n *\n * @param notification - The notification to handle.\n * @param callback - An error-first callback that will receive a `void` response.\n */\n handle<Params extends JsonRpcParams>(\n notification: JsonRpcNotification<Params>,\n callback: (error: unknown, response: void) => void,\n ): void;\n\n /**\n * Handle an array of JSON-RPC requests and/or notifications, and return an\n * array of responses to any included requests.\n *\n * @param request - The requests to handle.\n * @param callback - An error-first callback that will receive the array of\n * responses.\n */\n handle<Params extends JsonRpcParams, Result extends Json>(\n requests: (JsonRpcRequest<Params> | JsonRpcNotification<Params>)[],\n callback: (error: unknown, responses: JsonRpcResponse<Result>[]) => void,\n ): void;\n\n /**\n * Handle a JSON-RPC request, and return a response.\n *\n * @param request - The JSON-RPC request to handle.\n * @returns The JSON-RPC response.\n */\n handle<Params extends JsonRpcParams, Result extends Json>(\n request: JsonRpcRequest<Params>,\n ): Promise<JsonRpcResponse<Result>>;\n\n /**\n * Handle a JSON-RPC notification.\n *\n * @param notification - The notification to handle.\n */\n handle<Params extends JsonRpcParams>(\n notification: JsonRpcNotification<Params>,\n ): Promise<void>;\n\n /**\n * Handle an array of JSON-RPC requests and/or notifications, and return an\n * array of responses to any included requests.\n *\n * @param request - The JSON-RPC requests to handle.\n * @returns An array of JSON-RPC responses.\n */\n handle<Params extends JsonRpcParams, Result extends Json>(\n requests: (JsonRpcRequest<Params> | JsonRpcNotification<Params>)[],\n ): Promise<JsonRpcResponse<Result>[]>;\n\n handle(\n req:\n | (JsonRpcRequest | JsonRpcNotification)[]\n | JsonRpcRequest\n | JsonRpcNotification,\n callback?: (error: unknown, response: never) => void,\n ) {\n this.#assertIsNotDestroyed();\n\n if (callback && typeof callback !== 'function') {\n throw new Error('\"callback\" must be a function if provided.');\n }\n\n if (Array.isArray(req)) {\n if (callback) {\n return this.#handleBatch(\n req,\n // This assertion is safe because of the runtime checks validating that `req` is an array and `callback` is defined.\n // There is only one overload signature that satisfies both conditions, and its `callback` type is the one that's being asserted.\n callback as (\n error: unknown,\n responses?: JsonRpcResponse<Json>[],\n ) => void,\n );\n }\n return this.#handleBatch(req);\n }\n\n if (callback) {\n return this.#handle(\n req,\n callback as (error: unknown, response?: JsonRpcResponse<Json>) => void,\n );\n }\n return this._promiseHandle(req);\n }\n\n /**\n * Returns this engine as a middleware function that can be pushed to other\n * engines.\n *\n * @returns This engine as a middleware function.\n */\n asMiddleware(): JsonRpcMiddleware<JsonRpcParams, Json> {\n this.#assertIsNotDestroyed();\n\n // eslint-disable-next-line @typescript-eslint/no-misused-promises\n return async (req, res, next, end) => {\n try {\n const [middlewareError, isComplete, returnHandlers] =\n await JsonRpcEngine.#runAllMiddleware(req, res, this.#middleware);\n\n if (isComplete) {\n await JsonRpcEngine.#runReturnHandlers(returnHandlers);\n return end(middlewareError);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-misused-promises\n return next(async (handlerCallback) => {\n try {\n await JsonRpcEngine.#runReturnHandlers(returnHandlers);\n } catch (error) {\n return handlerCallback(error);\n }\n return handlerCallback();\n });\n } catch (error) {\n return end(error);\n }\n };\n }\n\n /**\n * Like _handle, but for batch requests.\n */\n #handleBatch(\n reqs: (JsonRpcRequest | JsonRpcNotification)[],\n ): Promise<JsonRpcResponse<Json>[]>;\n\n /**\n * Like _handle, but for batch requests.\n */\n #handleBatch(\n reqs: (JsonRpcRequest | JsonRpcNotification)[],\n callback: (error: unknown, responses?: JsonRpcResponse<Json>[]) => void,\n ): Promise<void>;\n\n /**\n * Handles a batch of JSON-RPC requests, either in `async` or callback\n * fashion.\n *\n * @param requests - The request objects to process.\n * @param callback - The completion callback.\n * @returns The array of responses, or nothing if a callback was specified.\n */\n async #handleBatch(\n requests: (JsonRpcRequest | JsonRpcNotification)[],\n callback?: (error: unknown, responses?: JsonRpcResponse<Json>[]) => void,\n ): Promise<JsonRpcResponse<Json>[] | void> {\n // The order here is important\n try {\n // If the batch is an empty array, the response array must contain a single object\n if (requests.length === 0) {\n const response: JsonRpcResponse<Json>[] = [\n {\n id: null,\n jsonrpc: '2.0',\n error: new JsonRpcError(\n errorCodes.rpc.invalidRequest,\n 'Request batch must contain plain objects. Received an empty array',\n ),\n },\n ];\n if (callback) {\n return callback(null, response);\n }\n return response;\n }\n\n // 2. Wait for all requests to finish, or throw on some kind of fatal\n // error\n const responses = (\n await Promise.all(\n // 1. Begin executing each request in the order received\n requests.map(this._promiseHandle.bind(this)),\n )\n ).filter(\n // Filter out any notification responses.\n (response): response is JsonRpcResponse<Json> => response !== undefined,\n );\n\n // 3. Return batch response\n if (callback) {\n return callback(null, responses);\n }\n return responses;\n } catch (error) {\n if (callback) {\n return callback(error);\n }\n\n throw error;\n }\n }\n\n /**\n * A promise-wrapped _handle.\n *\n * @param request - The JSON-RPC request.\n * @returns The JSON-RPC response.\n */\n // This function is used in tests, so we cannot easily change it to use the\n // hash syntax.\n // eslint-disable-next-line no-restricted-syntax\n private async _promiseHandle(\n request: JsonRpcRequest | JsonRpcNotification,\n ): Promise<JsonRpcResponse<Json> | void> {\n return new Promise((resolve, reject) => {\n this.#handle(request, (error, res) => {\n // For notifications, the response will be `undefined`, and any caught\n // errors are unexpected and should be surfaced to the caller.\n if (error && res === undefined) {\n reject(error);\n } else {\n // Excepting notifications, there will always be a response, and it will\n // always have any error that is caught and propagated.\n resolve(res);\n }\n }).catch(reject);\n });\n }\n\n /**\n * Ensures that the request / notification object is valid, processes it, and\n * passes any error and response object to the given callback.\n *\n * Does not reject.\n *\n * @param callerReq - The request object from the caller.\n * @param callback - The callback function.\n * @returns Nothing.\n */\n async #handle(\n callerReq: JsonRpcRequest | JsonRpcNotification,\n callback: (error: unknown, response?: JsonRpcResponse<Json>) => void,\n ): Promise<void> {\n if (\n !callerReq ||\n Array.isArray(callerReq) ||\n typeof callerReq !== 'object'\n ) {\n const error = new JsonRpcError(\n errorCodes.rpc.invalidRequest,\n `Requests must be plain objects. Received: ${typeof callerReq}`,\n { request: callerReq },\n );\n return callback(error, { id: null, jsonrpc: '2.0', error });\n }\n\n if (typeof callerReq.method !== 'string') {\n const error = new JsonRpcError(\n errorCodes.rpc.invalidRequest,\n `Must specify a string method. Received: ${typeof callerReq.method}`,\n { request: callerReq },\n );\n\n if (this.#notificationHandler && !isJsonRpcRequest(callerReq)) {\n // Do not reply to notifications, even if they are malformed.\n return callback(null);\n }\n\n return callback(error, {\n // Typecast: This could be a notification, but we want to access the\n // `id` even if it doesn't exist.\n id: (callerReq as JsonRpcRequest).id ?? null,\n jsonrpc: '2.0',\n error,\n });\n } else if (\n this.#notificationHandler &&\n isJsonRpcNotification(callerReq) &&\n !isJsonRpcRequest(callerReq)\n ) {\n try {\n await this.#notificationHandler(callerReq);\n } catch (error) {\n return callback(error);\n }\n return callback(null);\n }\n let error = null;\n\n // Handle requests.\n // Typecast: Permit missing id's for backwards compatibility.\n const req = { ...(callerReq as JsonRpcRequest) };\n const res: PendingJsonRpcResponse<Json> = {\n id: req.id,\n jsonrpc: req.jsonrpc,\n };\n\n try {\n await JsonRpcEngine.#processRequest(req, res, this.#middleware);\n } catch (_error) {\n // A request handler error, a re-thrown middleware error, or something\n // unexpected.\n error = _error;\n }\n\n if (error) {\n // Ensure no result is present on an errored response\n delete res.result;\n if (!res.error) {\n res.error = serializeError(error);\n }\n }\n\n return callback(error, res as JsonRpcResponse<Json>);\n }\n\n /**\n * For the given request and response, runs all middleware and their return\n * handlers, if any, and ensures that internal request processing semantics\n * are satisfied.\n *\n * @param req - The request object.\n * @param res - The response object.\n * @param middlewares - The stack of middleware functions.\n */\n static async #processRequest(\n req: JsonRpcRequest,\n res: PendingJsonRpcResponse<Json>,\n middlewares: JsonRpcMiddleware<JsonRpcParams, Json>[],\n ): Promise<void> {\n const [error, isComplete, returnHandlers] =\n await JsonRpcEngine.#runAllMiddleware(req, res, middlewares);\n\n // Throw if \"end\" was not called, or if the response has neither a result\n // nor an error.\n JsonRpcEngine.#checkForCompletion(req, res, isComplete);\n\n // The return handlers should run even if an error was encountered during\n // middleware processing.\n await JsonRpcEngine.#runReturnHandlers(returnHandlers);\n\n // Now we re-throw the middleware processing error, if any, to catch it\n // further up the call chain.\n if (error) {\n // eslint-disable-next-line @typescript-eslint/no-throw-literal\n throw error;\n }\n }\n\n /**\n * Serially executes the given stack of middleware.\n *\n * @param req - The request object.\n * @param res - The response object.\n * @param middlewares - The stack of middleware functions to execute.\n * @returns An array of any error encountered during middleware execution,\n * a boolean indicating whether the request was completed, and an array of\n * middleware-defined return handlers.\n */\n static async #runAllMiddleware(\n req: JsonRpcRequest,\n res: PendingJsonRpcResponse<Json>,\n middlewares: JsonRpcMiddleware<JsonRpcParams, Json>[],\n ): Promise<\n [\n unknown, // error\n boolean, // isComplete\n JsonRpcEngineReturnHandler[],\n ]\n > {\n const returnHandlers: JsonRpcEngineReturnHandler[] = [];\n let error = null;\n let isComplete = false;\n\n // Go down stack of middleware, call and collect optional returnHandlers\n for (const middleware of middlewares) {\n [error, isComplete] = await JsonRpcEngine.#runMiddleware(\n req,\n res,\n middleware,\n returnHandlers,\n );\n\n if (isComplete) {\n break;\n }\n }\n return [error, isComplete, returnHandlers.reverse()];\n }\n\n /**\n * Runs an individual middleware function.\n *\n * @param request - The request object.\n * @param response - The response object.\n * @param middleware - The middleware function to execute.\n * @param returnHandlers - The return handlers array for the current request.\n * @returns An array of any error encountered during middleware exection,\n * and a boolean indicating whether the request should end.\n */\n static async #runMiddleware(\n request: JsonRpcRequest,\n response: PendingJsonRpcResponse<Json>,\n middleware: JsonRpcMiddleware<JsonRpcParams, Json>,\n returnHandlers: JsonRpcEngineReturnHandler[],\n ): Promise<[unknown, boolean]> {\n return new Promise((resolve) => {\n const end: JsonRpcEngineEndCallback = (error) => {\n const parsedError = error || response.error;\n if (parsedError) {\n response.error = serializeError(parsedError);\n }\n // True indicates that the request should end\n resolve([parsedError, true]);\n };\n\n const next: JsonRpcEngineNextCallback = (\n returnHandler?: JsonRpcEngineReturnHandler,\n ) => {\n if (response.error) {\n end(response.error);\n } else {\n if (returnHandler) {\n if (typeof returnHandler !== 'function') {\n end(\n new JsonRpcError(\n errorCodes.rpc.internal,\n `JsonRpcEngine: \"next\" return handlers must be functions. ` +\n `Received \"${typeof returnHandler}\" for request:\\n${jsonify(\n request,\n )}`,\n { request },\n ),\n );\n }\n returnHandlers.push(returnHandler);\n }\n\n // False indicates that the request should not end\n resolve([null, false]);\n }\n };\n\n try {\n middleware(request, response, next, end);\n } catch (error) {\n end(error);\n }\n });\n }\n\n /**\n * Serially executes array of return handlers. The request and response are\n * assumed to be in their scope.\n *\n * @param handlers - The return handlers to execute.\n */\n static async #runReturnHandlers(\n handlers: JsonRpcEngineReturnHandler[],\n ): Promise<void> {\n for (const handler of handlers) {\n await new Promise<void>((resolve, reject) => {\n handler((error) => (error ? reject(error) : resolve()));\n });\n }\n }\n\n /**\n * Throws an error if the response has neither a result nor an error, or if\n * the \"isComplete\" flag is falsy.\n *\n * @param request - The request object.\n * @param response - The response object.\n * @param isComplete - Boolean from {@link JsonRpcEngine.#runAllMiddleware}\n * indicating whether a middleware ended the request.\n */\n static #checkForCompletion(\n request: JsonRpcRequest,\n response: PendingJsonRpcResponse<Json>,\n isComplete: boolean,\n ): void {\n if (!hasProperty(response, 'result') && !hasProperty(response, 'error')) {\n throw new JsonRpcError(\n errorCodes.rpc.internal,\n `JsonRpcEngine: Response has no error or result for request:\\n${jsonify(\n request,\n )}`,\n { request },\n );\n }\n\n if (!isComplete) {\n throw new JsonRpcError(\n errorCodes.rpc.internal,\n `JsonRpcEngine: Nothing ended request:\\n${jsonify(request)}`,\n { request },\n );\n }\n }\n}\n\n/**\n * JSON-stringifies a request object.\n *\n * @param request - The request object to JSON-stringify.\n * @returns The JSON-stringified request object.\n */\nfunction jsonify(request: JsonRpcRequest): string {\n return JSON.stringify(request, null, 2);\n}\n"]}
@@ -1,5 +1,5 @@
1
- import SafeEventEmitter from '@metamask/safe-event-emitter';
2
- import type { JsonRpcError as SerializedJsonRpcError, JsonRpcRequest, JsonRpcResponse, JsonRpcNotification, Json, JsonRpcParams, PendingJsonRpcResponse } from '@metamask/utils';
1
+ import SafeEventEmitter from "@metamask/safe-event-emitter";
2
+ import type { JsonRpcError as SerializedJsonRpcError, JsonRpcRequest, JsonRpcResponse, JsonRpcNotification, Json, JsonRpcParams, PendingJsonRpcResponse } from "@metamask/utils";
3
3
  export type JsonRpcEngineCallbackError = Error | SerializedJsonRpcError | null;
4
4
  export type JsonRpcEngineReturnHandler = (done: (error?: unknown) => void) => void;
5
5
  export type JsonRpcEngineNextCallback = (returnHandlerCallback?: JsonRpcEngineReturnHandler) => void;
@@ -111,4 +111,4 @@ export declare class JsonRpcEngine extends SafeEventEmitter {
111
111
  private _promiseHandle;
112
112
  }
113
113
  export {};
114
- //# sourceMappingURL=JsonRpcEngine.d.ts.map
114
+ //# sourceMappingURL=JsonRpcEngine.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"JsonRpcEngine.d.cts","sourceRoot":"","sources":["../src/JsonRpcEngine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,114 @@
1
+ import SafeEventEmitter from "@metamask/safe-event-emitter";
2
+ import type { JsonRpcError as SerializedJsonRpcError, JsonRpcRequest, JsonRpcResponse, JsonRpcNotification, Json, JsonRpcParams, PendingJsonRpcResponse } from "@metamask/utils";
3
+ export type JsonRpcEngineCallbackError = Error | SerializedJsonRpcError | null;
4
+ export type JsonRpcEngineReturnHandler = (done: (error?: unknown) => void) => void;
5
+ export type JsonRpcEngineNextCallback = (returnHandlerCallback?: JsonRpcEngineReturnHandler) => void;
6
+ export type JsonRpcEngineEndCallback = (error?: unknown) => void;
7
+ export type JsonRpcMiddleware<Params extends JsonRpcParams, Result extends Json> = {
8
+ (req: JsonRpcRequest<Params>, res: PendingJsonRpcResponse<Result>, next: JsonRpcEngineNextCallback, end: JsonRpcEngineEndCallback): void;
9
+ destroy?: () => void | Promise<void>;
10
+ };
11
+ export type JsonRpcNotificationHandler<Params extends JsonRpcParams> = (notification: JsonRpcNotification<Params>) => void | Promise<void>;
12
+ type JsonRpcEngineArgs = {
13
+ /**
14
+ * A function for handling JSON-RPC notifications. A JSON-RPC notification is
15
+ * defined as a JSON-RPC request without an `id` property. If this option is
16
+ * _not_ provided, notifications will be treated the same as requests. If this
17
+ * option _is_ provided, notifications will be passed to the handler
18
+ * function without touching the engine's middleware stack.
19
+ *
20
+ * This function should not throw or reject.
21
+ */
22
+ notificationHandler?: JsonRpcNotificationHandler<JsonRpcParams>;
23
+ };
24
+ /**
25
+ * A JSON-RPC request and response processor.
26
+ * Give it a stack of middleware, pass it requests, and get back responses.
27
+ */
28
+ export declare class JsonRpcEngine extends SafeEventEmitter {
29
+ #private;
30
+ /**
31
+ * Constructs a {@link JsonRpcEngine} instance.
32
+ *
33
+ * @param options - Options bag.
34
+ * @param options.notificationHandler - A function for handling JSON-RPC
35
+ * notifications. A JSON-RPC notification is defined as a JSON-RPC request
36
+ * without an `id` property. If this option is _not_ provided, notifications
37
+ * will be treated the same as requests. If this option _is_ provided,
38
+ * notifications will be passed to the handler function without touching
39
+ * the engine's middleware stack. This function should not throw or reject.
40
+ */
41
+ constructor({ notificationHandler }?: JsonRpcEngineArgs);
42
+ /**
43
+ * Calls the `destroy()` function of any middleware with that property, clears
44
+ * the middleware array, and marks this engine as destroyed. A destroyed
45
+ * engine cannot be used.
46
+ */
47
+ destroy(): void;
48
+ /**
49
+ * Add a middleware function to the engine's middleware stack.
50
+ *
51
+ * @param middleware - The middleware function to add.
52
+ */
53
+ push<Params extends JsonRpcParams, Result extends Json>(middleware: JsonRpcMiddleware<Params, Result>): void;
54
+ /**
55
+ * Handle a JSON-RPC request, and return a response.
56
+ *
57
+ * @param request - The request to handle.
58
+ * @param callback - An error-first callback that will receive the response.
59
+ */
60
+ handle<Params extends JsonRpcParams, Result extends Json>(request: JsonRpcRequest<Params>, callback: (error: unknown, response: JsonRpcResponse<Result>) => void): void;
61
+ /**
62
+ * Handle a JSON-RPC notification.
63
+ *
64
+ * @param notification - The notification to handle.
65
+ * @param callback - An error-first callback that will receive a `void` response.
66
+ */
67
+ handle<Params extends JsonRpcParams>(notification: JsonRpcNotification<Params>, callback: (error: unknown, response: void) => void): void;
68
+ /**
69
+ * Handle an array of JSON-RPC requests and/or notifications, and return an
70
+ * array of responses to any included requests.
71
+ *
72
+ * @param request - The requests to handle.
73
+ * @param callback - An error-first callback that will receive the array of
74
+ * responses.
75
+ */
76
+ handle<Params extends JsonRpcParams, Result extends Json>(requests: (JsonRpcRequest<Params> | JsonRpcNotification<Params>)[], callback: (error: unknown, responses: JsonRpcResponse<Result>[]) => void): void;
77
+ /**
78
+ * Handle a JSON-RPC request, and return a response.
79
+ *
80
+ * @param request - The JSON-RPC request to handle.
81
+ * @returns The JSON-RPC response.
82
+ */
83
+ handle<Params extends JsonRpcParams, Result extends Json>(request: JsonRpcRequest<Params>): Promise<JsonRpcResponse<Result>>;
84
+ /**
85
+ * Handle a JSON-RPC notification.
86
+ *
87
+ * @param notification - The notification to handle.
88
+ */
89
+ handle<Params extends JsonRpcParams>(notification: JsonRpcNotification<Params>): Promise<void>;
90
+ /**
91
+ * Handle an array of JSON-RPC requests and/or notifications, and return an
92
+ * array of responses to any included requests.
93
+ *
94
+ * @param request - The JSON-RPC requests to handle.
95
+ * @returns An array of JSON-RPC responses.
96
+ */
97
+ handle<Params extends JsonRpcParams, Result extends Json>(requests: (JsonRpcRequest<Params> | JsonRpcNotification<Params>)[]): Promise<JsonRpcResponse<Result>[]>;
98
+ /**
99
+ * Returns this engine as a middleware function that can be pushed to other
100
+ * engines.
101
+ *
102
+ * @returns This engine as a middleware function.
103
+ */
104
+ asMiddleware(): JsonRpcMiddleware<JsonRpcParams, Json>;
105
+ /**
106
+ * A promise-wrapped _handle.
107
+ *
108
+ * @param request - The JSON-RPC request.
109
+ * @returns The JSON-RPC response.
110
+ */
111
+ private _promiseHandle;
112
+ }
113
+ export {};
114
+ //# sourceMappingURL=JsonRpcEngine.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"JsonRpcEngine.d.mts","sourceRoot":"","sources":["../src/JsonRpcEngine.ts"],"names":[],"mappings":"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"}