@metamask/snaps-controllers 0.24.0

package/dist/services/browser.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Subset of exports meant for browser environments, omits Node.js services
+__exportStar(require("./AbstractExecutionService"), exports);
+__exportStar(require("./ExecutionService"), exports);
+__exportStar(require("./iframe"), exports);
+//# sourceMappingURL=browser.js.map

package/dist/services/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/services/browser.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2EAA2E;AAC3E,6DAA2C;AAC3C,qDAAmC;AACnC,2CAAyB","sourcesContent":["// Subset of exports meant for browser environments, omits Node.js services\nexport * from './AbstractExecutionService';\nexport * from './ExecutionService';\nexport * from './iframe';\n"]}

package/dist/services/iframe/IframeExecutionService.d.ts

@@ -0,0 +1,25 @@
+import { BasePostMessageStream } from '@metamask/post-message-stream';
+import { Job, AbstractExecutionService, ExecutionServiceArgs } from '../AbstractExecutionService';
+declare type IframeExecutionEnvironmentServiceArgs = {
+    iframeUrl: URL;
+} & ExecutionServiceArgs;
+export declare class IframeExecutionService extends AbstractExecutionService<Window> {
+    iframeUrl: URL;
+    constructor({ iframeUrl, messenger, setupSnapProvider, }: IframeExecutionEnvironmentServiceArgs);
+    protected terminateJob(jobWrapper: Job<Window>): void;
+    protected initEnvStream(jobId: string): Promise<{
+        worker: Window;
+        stream: BasePostMessageStream;
+    }>;
+    /**
+     * Creates the iframe to be used as the execution environment. This may run
+     * forever if the iframe never loads, but the promise should be wrapped in
+     * an initialization timeout in the SnapController.
+     *
+     * @param uri - The iframe URI.
+     * @param jobId - The job id.
+     * @returns A promise that resolves to the contentWindow of the iframe.
+     */
+    private createWindow;
+}
+export {};

package/dist/services/iframe/IframeExecutionService.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IframeExecutionService = void 0;
+const post_message_stream_1 = require("@metamask/post-message-stream");
+const AbstractExecutionService_1 = require("../AbstractExecutionService");
+class IframeExecutionService extends AbstractExecutionService_1.AbstractExecutionService {
+    constructor({ iframeUrl, messenger, setupSnapProvider, }) {
+        super({
+            messenger,
+            setupSnapProvider,
+        });
+        this.iframeUrl = iframeUrl;
+    }
+    terminateJob(jobWrapper) {
+        var _a;
+        (_a = document.getElementById(jobWrapper.id)) === null || _a === void 0 ? void 0 : _a.remove();
+    }
+    async initEnvStream(jobId) {
+        const iframeWindow = await this.createWindow(this.iframeUrl.toString(), jobId);
+        const stream = new post_message_stream_1.WindowPostMessageStream({
+            name: 'parent',
+            target: 'child',
+            targetWindow: iframeWindow,
+            targetOrigin: '*',
+        });
+        return { worker: iframeWindow, stream };
+    }
+    /**
+     * Creates the iframe to be used as the execution environment. This may run
+     * forever if the iframe never loads, but the promise should be wrapped in
+     * an initialization timeout in the SnapController.
+     *
+     * @param uri - The iframe URI.
+     * @param jobId - The job id.
+     * @returns A promise that resolves to the contentWindow of the iframe.
+     */
+    createWindow(uri, jobId) {
+        return new Promise((resolve, reject) => {
+            const iframe = document.createElement('iframe');
+            // The order of operations appears to matter for everything except this
+            // attribute. We may as well set it here.
+            iframe.setAttribute('id', jobId);
+            // In the past, we've had problems that appear to be symptomatic of the
+            // iframe firing the `load` event before its scripts are actually loaded,
+            // which has prevented snaps from executing properly. Therefore, we set
+            // the `src` attribute and append the iframe to the DOM before attaching
+            // the `load` listener.
+            //
+            // `load` should only fire when "all dependent resources" have been
+            // loaded, which includes scripts.
+            //
+            // MDN article for `load` event: https://developer.mozilla.org/en-US/docs/Web/API/Window/load_event
+            // Re: `load` firing twice: https://stackoverflow.com/questions/10781880/dynamically-created-iframe-triggers-onload-event-twice/15880489#15880489
+            iframe.setAttribute('src', uri);
+            document.body.appendChild(iframe);
+            iframe.addEventListener('load', () => {
+                if (iframe.contentWindow) {
+                    resolve(iframe.contentWindow);
+                }
+                else {
+                    // We don't know of a case when this would happen, but better to fail
+                    // fast if it does.
+                    reject(new Error(`iframe.contentWindow not present on load for job "${jobId}".`));
+                }
+            });
+            // We need to set the sandbox attribute after appending the iframe to the
+            // DOM, otherwise errors in the iframe will not be propagated via `error`
+            // and `unhandledrejection` events, and we cannot catch and handle them.
+            // We wish we knew why this was the case.
+            //
+            // We set this property after adding the `load` listener because it
+            // appears to work dependably. ¯\_(ツ)_/¯
+            //
+            // We apply this property as a principle of least authority (POLA)
+            // measure.
+            // Ref: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe#attr-sandbox
+            iframe.setAttribute('sandbox', 'allow-scripts');
+        });
+    }
+}
+exports.IframeExecutionService = IframeExecutionService;
+//# sourceMappingURL=IframeExecutionService.js.map

package/dist/services/iframe/IframeExecutionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IframeExecutionService.js","sourceRoot":"","sources":["../../../src/services/iframe/IframeExecutionService.ts"],"names":[],"mappings":";;;AAAA,uEAGuC;AACvC,0EAIqC;AAMrC,MAAa,sBAAuB,SAAQ,mDAAgC;IAG1E,YAAY,EACV,SAAS,EACT,SAAS,EACT,iBAAiB,GACqB;QACtC,KAAK,CAAC;YACJ,SAAS;YACT,iBAAiB;SAClB,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAES,YAAY,CAAC,UAAuB;;QAC5C,MAAA,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC,0CAAE,MAAM,EAAE,CAAC;IACnD,CAAC;IAES,KAAK,CAAC,aAAa,CAAC,KAAa;QAIzC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,YAAY,CAC1C,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,EACzB,KAAK,CACN,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,6CAAuB,CAAC;YACzC,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,OAAO;YACf,YAAY,EAAE,YAAY;YAC1B,YAAY,EAAE,GAAG;SAClB,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACK,YAAY,CAAC,GAAW,EAAE,KAAa;QAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAChD,uEAAuE;YACvE,yCAAyC;YACzC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAEjC,uEAAuE;YACvE,yEAAyE;YACzE,uEAAuE;YACvE,wEAAwE;YACxE,uBAAuB;YACvB,EAAE;YACF,mEAAmE;YACnE,kCAAkC;YAClC,EAAE;YACF,mGAAmG;YACnG,iJAAiJ;YACjJ,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAElC,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;gBACnC,IAAI,MAAM,CAAC,aAAa,EAAE;oBACxB,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;iBAC/B;qBAAM;oBACL,qEAAqE;oBACrE,mBAAmB;oBACnB,MAAM,CACJ,IAAI,KAAK,CACP,qDAAqD,KAAK,IAAI,CAC/D,CACF,CAAC;iBACH;YACH,CAAC,CAAC,CAAC;YAEH,yEAAyE;YACzE,yEAAyE;YACzE,wEAAwE;YACxE,yCAAyC;YACzC,EAAE;YACF,mEAAmE;YACnE,wCAAwC;YACxC,EAAE;YACF,kEAAkE;YAClE,WAAW;YACX,qFAAqF;YACrF,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA/FD,wDA+FC","sourcesContent":["import {\n  WindowPostMessageStream,\n  BasePostMessageStream,\n} from '@metamask/post-message-stream';\nimport {\n  Job,\n  AbstractExecutionService,\n  ExecutionServiceArgs,\n} from '../AbstractExecutionService';\n\ntype IframeExecutionEnvironmentServiceArgs = {\n  iframeUrl: URL;\n} & ExecutionServiceArgs;\n\nexport class IframeExecutionService extends AbstractExecutionService<Window> {\n  public iframeUrl: URL;\n\n  constructor({\n    iframeUrl,\n    messenger,\n    setupSnapProvider,\n  }: IframeExecutionEnvironmentServiceArgs) {\n    super({\n      messenger,\n      setupSnapProvider,\n    });\n    this.iframeUrl = iframeUrl;\n  }\n\n  protected terminateJob(jobWrapper: Job<Window>): void {\n    document.getElementById(jobWrapper.id)?.remove();\n  }\n\n  protected async initEnvStream(jobId: string): Promise<{\n    worker: Window;\n    stream: BasePostMessageStream;\n  }> {\n    const iframeWindow = await this.createWindow(\n      this.iframeUrl.toString(),\n      jobId,\n    );\n    const stream = new WindowPostMessageStream({\n      name: 'parent',\n      target: 'child',\n      targetWindow: iframeWindow,\n      targetOrigin: '*',\n    });\n\n    return { worker: iframeWindow, stream };\n  }\n\n  /**\n   * Creates the iframe to be used as the execution environment. This may run\n   * forever if the iframe never loads, but the promise should be wrapped in\n   * an initialization timeout in the SnapController.\n   *\n   * @param uri - The iframe URI.\n   * @param jobId - The job id.\n   * @returns A promise that resolves to the contentWindow of the iframe.\n   */\n  private createWindow(uri: string, jobId: string): Promise<Window> {\n    return new Promise((resolve, reject) => {\n      const iframe = document.createElement('iframe');\n      // The order of operations appears to matter for everything except this\n      // attribute. We may as well set it here.\n      iframe.setAttribute('id', jobId);\n\n      // In the past, we've had problems that appear to be symptomatic of the\n      // iframe firing the `load` event before its scripts are actually loaded,\n      // which has prevented snaps from executing properly. Therefore, we set\n      // the `src` attribute and append the iframe to the DOM before attaching\n      // the `load` listener.\n      //\n      // `load` should only fire when \"all dependent resources\" have been\n      // loaded, which includes scripts.\n      //\n      // MDN article for `load` event: https://developer.mozilla.org/en-US/docs/Web/API/Window/load_event\n      // Re: `load` firing twice: https://stackoverflow.com/questions/10781880/dynamically-created-iframe-triggers-onload-event-twice/15880489#15880489\n      iframe.setAttribute('src', uri);\n      document.body.appendChild(iframe);\n\n      iframe.addEventListener('load', () => {\n        if (iframe.contentWindow) {\n          resolve(iframe.contentWindow);\n        } else {\n          // We don't know of a case when this would happen, but better to fail\n          // fast if it does.\n          reject(\n            new Error(\n              `iframe.contentWindow not present on load for job \"${jobId}\".`,\n            ),\n          );\n        }\n      });\n\n      // We need to set the sandbox attribute after appending the iframe to the\n      // DOM, otherwise errors in the iframe will not be propagated via `error`\n      // and `unhandledrejection` events, and we cannot catch and handle them.\n      // We wish we knew why this was the case.\n      //\n      // We set this property after adding the `load` listener because it\n      // appears to work dependably. ¯\\_(ツ)_/¯\n      //\n      // We apply this property as a principle of least authority (POLA)\n      // measure.\n      // Ref: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe#attr-sandbox\n      iframe.setAttribute('sandbox', 'allow-scripts');\n    });\n  }\n}\n"]}

package/dist/services/iframe/index.d.ts

@@ -0,0 +1 @@
+export * from './IframeExecutionService';

package/dist/services/iframe/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./IframeExecutionService"), exports);
+//# sourceMappingURL=index.js.map

package/dist/services/iframe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/iframe/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC","sourcesContent":["export * from './IframeExecutionService';\n"]}

package/dist/services/iframe/test/fixJSDOMPostMessageEventSource.d.ts

@@ -0,0 +1,3 @@
+import { IframeExecutionService } from '../IframeExecutionService';
+declare const fixJSDOMPostMessageEventSource: (iframeExecutionService: IframeExecutionService) => () => void;
+export default fixJSDOMPostMessageEventSource;

package/dist/services/iframe/test/fixJSDOMPostMessageEventSource.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Fix for JSDOM not setting `event.origin` or `event.source`: https://github.com/jsdom/jsdom/issues/2745
+const fixJSDOMPostMessageEventSource = (iframeExecutionService) => {
+    const oldCreateWindow = iframeExecutionService.createWindow;
+    iframeExecutionService.createWindow = async (uri, envId, timeout) => {
+        const result = await oldCreateWindow(uri, envId, timeout);
+        const scriptElement = result.document.createElement('script');
+        if (!scriptElement) {
+            return result;
+        }
+        // fix the inside window
+        scriptElement.textContent = `
+    window.addEventListener('message', (postMessageEvent) => {
+      if (postMessageEvent.source === null && !postMessageEvent.origin) {
+        let source;
+        let postMessageEventOrigin;
+        if (postMessageEvent.data.target === 'child') {
+          source = window.parent;
+          postMessageEventOrigin = '*';
+        } else if (postMessageEvent.data.target === 'parent') {
+          source = window;
+          postMessageEventOrigin = window.location.origin;
+        }
+        if (postMessageEvent.data.target) {
+          postMessageEvent.stopImmediatePropagation();
+          const args = Object.assign({
+            ...postMessageEvent,
+            data: postMessageEvent.data,
+            source,
+            origin: postMessageEventOrigin,
+          });
+          const postMessageEventWithOrigin = new MessageEvent(
+            'message',
+            args,
+          );
+          window.dispatchEvent(postMessageEventWithOrigin);
+        }
+      }
+    });
+  `;
+        result.document.body.appendChild(scriptElement);
+        return result;
+    };
+    const listener = (event) => {
+        if (event.source === null && !event.origin) {
+            let source;
+            let origin;
+            if (event.data.target === 'child') {
+                source = window;
+                origin = window.location.origin;
+            }
+            else if (event.data.target === 'parent') {
+                // @ts-expect-error Accessing private property
+                const { worker } = iframeExecutionService.jobs.values().next().value;
+                source = worker;
+                origin = iframeExecutionService.iframeUrl.toString();
+            }
+            if (event.data.target) {
+                event.stopImmediatePropagation();
+                const args = Object.assign(Object.assign(Object.assign({}, event), { data: event.data, source,
+                    origin }));
+                const eventWithOrigin = new MessageEvent('message', args);
+                window.dispatchEvent(eventWithOrigin);
+            }
+        }
+    };
+    window.addEventListener('message', listener);
+    return () => {
+        window.removeEventListener('message', listener);
+    };
+};
+exports.default = fixJSDOMPostMessageEventSource;
+//# sourceMappingURL=fixJSDOMPostMessageEventSource.js.map

package/dist/services/iframe/test/fixJSDOMPostMessageEventSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixJSDOMPostMessageEventSource.js","sourceRoot":"","sources":["../../../../src/services/iframe/test/fixJSDOMPostMessageEventSource.ts"],"names":[],"mappings":";;AAEA,yGAAyG;AACzG,MAAM,8BAA8B,GAAG,CACrC,sBAA8C,EAC9C,EAAE;IACF,MAAM,eAAe,GAAI,sBAA8B,CAAC,YAAY,CAAC;IACpE,sBAA8B,CAAC,YAAY,GAAG,KAAK,EAClD,GAAW,EACX,KAAa,EACb,OAAe,EACf,EAAE;QACF,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAE1D,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAE9D,IAAI,CAAC,aAAa,EAAE;YAClB,OAAO,MAAM,CAAC;SACf;QAED,wBAAwB;QACxB,aAAa,CAAC,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4B7B,CAAC;QACA,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAEhD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,KAAmB,EAAE,EAAE;QACvC,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAC1C,IAAI,MAAM,CAAC;YACX,IAAI,MAAM,CAAC;YACX,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE;gBACjC,MAAM,GAAG,MAAM,CAAC;gBAChB,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;aACjC;iBAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE;gBACzC,8CAA8C;gBAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,sBAAsB,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;gBACrE,MAAM,GAAG,MAAM,CAAC;gBAChB,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;aACtD;YAED,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE;gBACrB,KAAK,CAAC,wBAAwB,EAAE,CAAC;gBACjC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,iCACrB,KAAK,KACR,IAAI,EAAE,KAAK,CAAC,IAAI,EAChB,MAAM;oBACN,MAAM,IACN,CAAC;gBACH,MAAM,eAAe,GAAiB,IAAI,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBACxE,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;aACvC;SACF;IACH,CAAC,CAAC;IAEF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAE7C,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,8BAA8B,CAAC","sourcesContent":["import { IframeExecutionService } from '../IframeExecutionService';\n\n// Fix for JSDOM not setting `event.origin` or `event.source`: https://github.com/jsdom/jsdom/issues/2745\nconst fixJSDOMPostMessageEventSource = (\n  iframeExecutionService: IframeExecutionService,\n) => {\n  const oldCreateWindow = (iframeExecutionService as any).createWindow;\n  (iframeExecutionService as any).createWindow = async (\n    uri: string,\n    envId: string,\n    timeout: number,\n  ) => {\n    const result = await oldCreateWindow(uri, envId, timeout);\n\n    const scriptElement = result.document.createElement('script');\n\n    if (!scriptElement) {\n      return result;\n    }\n\n    // fix the inside window\n    scriptElement.textContent = `\n    window.addEventListener('message', (postMessageEvent) => {\n      if (postMessageEvent.source === null && !postMessageEvent.origin) {\n        let source;\n        let postMessageEventOrigin;\n        if (postMessageEvent.data.target === 'child') {\n          source = window.parent;\n          postMessageEventOrigin = '*';\n        } else if (postMessageEvent.data.target === 'parent') {\n          source = window;\n          postMessageEventOrigin = window.location.origin;\n        }\n        if (postMessageEvent.data.target) {\n          postMessageEvent.stopImmediatePropagation();\n          const args = Object.assign({\n            ...postMessageEvent,\n            data: postMessageEvent.data,\n            source,\n            origin: postMessageEventOrigin,\n          });\n          const postMessageEventWithOrigin = new MessageEvent(\n            'message',\n            args,\n          );\n          window.dispatchEvent(postMessageEventWithOrigin);\n        }\n      }\n    });\n  `;\n    result.document.body.appendChild(scriptElement);\n\n    return result;\n  };\n\n  const listener = (event: MessageEvent) => {\n    if (event.source === null && !event.origin) {\n      let source;\n      let origin;\n      if (event.data.target === 'child') {\n        source = window;\n        origin = window.location.origin;\n      } else if (event.data.target === 'parent') {\n        // @ts-expect-error Accessing private property\n        const { worker } = iframeExecutionService.jobs.values().next().value;\n        source = worker;\n        origin = iframeExecutionService.iframeUrl.toString();\n      }\n\n      if (event.data.target) {\n        event.stopImmediatePropagation();\n        const args = Object.assign({\n          ...event,\n          data: event.data,\n          source,\n          origin,\n        });\n        const eventWithOrigin: MessageEvent = new MessageEvent('message', args);\n        window.dispatchEvent(eventWithOrigin);\n      }\n    }\n  };\n\n  window.addEventListener('message', listener);\n\n  return () => {\n    window.removeEventListener('message', listener);\n  };\n};\n\nexport default fixJSDOMPostMessageEventSource;\n"]}

package/dist/services/iframe/test/server.d.ts

@@ -0,0 +1,11 @@
+export declare const PORT = 6364;
+/**
+ * Starts a local server that serves the iframe execution environment.
+ *
+ * @param port - The port to start the server on.
+ */
+export declare function start(port?: number): Promise<void>;
+/**
+ * Stops the local server.
+ */
+export declare function stop(): Promise<void>;

package/dist/services/iframe/test/server.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stop = exports.start = exports.PORT = void 0;
+const http_1 = __importDefault(require("http"));
+const path_1 = __importDefault(require("path"));
+const serve_handler_1 = __importDefault(require("serve-handler"));
+exports.PORT = 6364;
+let server;
+/**
+ * Starts a local server that serves the iframe execution environment.
+ *
+ * @param port - The port to start the server on.
+ */
+async function start(port = exports.PORT) {
+    return new Promise((resolve, reject) => {
+        if (!Number.isSafeInteger(port) || port < 0) {
+            reject(new Error(`Invalid port: "${port}"`));
+        }
+        const bundlePath = require.resolve('@metamask/snaps-execution-environments/__test__/iframe-test/bundle.js');
+        const publicPath = path_1.default.resolve(bundlePath, '../');
+        server = http_1.default.createServer(async (req, res) => {
+            await (0, serve_handler_1.default)(req, res, {
+                public: publicPath,
+                headers: [
+                    {
+                        source: '**/*',
+                        headers: [
+                            {
+                                key: 'Cache-Control',
+                                value: 'no-cache',
+                            },
+                        ],
+                    },
+                ],
+            });
+        });
+        server.listen({ port }, () => {
+            console.log(`Server listening on: http://localhost:${port}`);
+            resolve();
+        });
+        server.on('error', (error) => {
+            console.error('Server error', error);
+            reject(error);
+        });
+        server.on('close', () => {
+            console.log('Server closed');
+            reject(new Error('Server closed'));
+        });
+    });
+}
+exports.start = start;
+/**
+ * Stops the local server.
+ */
+async function stop() {
+    await new Promise((resolve, reject) => {
+        server.close((err) => {
+            if (err) {
+                reject(err);
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+exports.stop = stop;
+//# sourceMappingURL=server.js.map

package/dist/services/iframe/test/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../src/services/iframe/test/server.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,gDAAwB;AACxB,kEAAyC;AAE5B,QAAA,IAAI,GAAG,IAAI,CAAC;AAEzB,IAAI,MAAmB,CAAC;AACxB;;;;GAIG;AACI,KAAK,UAAU,KAAK,CAAC,IAAI,GAAG,YAAI;IACrC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE;YAC3C,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,IAAI,GAAG,CAAC,CAAC,CAAC;SAC9C;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAChC,uEAAuE,CACxE,CAAC;QACF,MAAM,UAAU,GAAG,cAAI,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAEnD,MAAM,GAAG,cAAI,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YAC5C,MAAM,IAAA,uBAAY,EAAC,GAAG,EAAE,GAAG,EAAE;gBAC3B,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE;oBACP;wBACE,MAAM,EAAE,MAAM;wBACd,OAAO,EAAE;4BACP;gCACE,GAAG,EAAE,eAAe;gCACpB,KAAK,EAAE,UAAU;6BAClB;yBACF;qBACF;iBACF;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE;YAC3B,OAAO,CAAC,GAAG,CAAC,yCAAyC,IAAI,EAAE,CAAC,CAAC;YAC7D,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3B,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AA3CD,sBA2CC;AAED;;GAEG;AACI,KAAK,UAAU,IAAI;IACxB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,IAAI,GAAG,EAAE;gBACP,MAAM,CAAC,GAAG,CAAC,CAAC;aACb;iBAAM;gBACL,OAAO,EAAE,CAAC;aACX;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAVD,oBAUC","sourcesContent":["import http from 'http';\nimport path from 'path';\nimport serveHandler from 'serve-handler';\n\nexport const PORT = 6364;\n\nlet server: http.Server;\n/**\n * Starts a local server that serves the iframe execution environment.\n *\n * @param port - The port to start the server on.\n */\nexport async function start(port = PORT) {\n  return new Promise<void>((resolve, reject) => {\n    if (!Number.isSafeInteger(port) || port < 0) {\n      reject(new Error(`Invalid port: \"${port}\"`));\n    }\n\n    const bundlePath = require.resolve(\n      '@metamask/snaps-execution-environments/__test__/iframe-test/bundle.js',\n    );\n    const publicPath = path.resolve(bundlePath, '../');\n\n    server = http.createServer(async (req, res) => {\n      await serveHandler(req, res, {\n        public: publicPath,\n        headers: [\n          {\n            source: '**/*',\n            headers: [\n              {\n                key: 'Cache-Control',\n                value: 'no-cache',\n              },\n            ],\n          },\n        ],\n      });\n    });\n\n    server.listen({ port }, () => {\n      console.log(`Server listening on: http://localhost:${port}`);\n      resolve();\n    });\n\n    server.on('error', (error) => {\n      console.error('Server error', error);\n      reject(error);\n    });\n\n    server.on('close', () => {\n      console.log('Server closed');\n      reject(new Error('Server closed'));\n    });\n  });\n}\n\n/**\n * Stops the local server.\n */\nexport async function stop() {\n  await new Promise<void>((resolve, reject) => {\n    server.close((err) => {\n      if (err) {\n        reject(err);\n      } else {\n        resolve();\n      }\n    });\n  });\n}\n"]}

package/dist/services/index.d.ts

@@ -0,0 +1,4 @@
+export * from './AbstractExecutionService';
+export * from './ExecutionService';
+export * from './iframe';
+export * from './node';

package/dist/services/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./AbstractExecutionService"), exports);
+__exportStar(require("./ExecutionService"), exports);
+__exportStar(require("./iframe"), exports);
+__exportStar(require("./node"), exports);
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,qDAAmC;AACnC,2CAAyB;AACzB,yCAAuB","sourcesContent":["export * from './AbstractExecutionService';\nexport * from './ExecutionService';\nexport * from './iframe';\nexport * from './node';\n"]}

package/dist/services/node/NodeProcessExecutionService.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="node" />
+import { ChildProcess } from 'child_process';
+import { BasePostMessageStream } from '@metamask/post-message-stream';
+import { AbstractExecutionService, Job } from '..';
+export declare class NodeProcessExecutionService extends AbstractExecutionService<ChildProcess> {
+    protected initEnvStream(): Promise<{
+        worker: ChildProcess;
+        stream: BasePostMessageStream;
+    }>;
+    protected terminateJob(jobWrapper: Job<ChildProcess>): void;
+}

package/dist/services/node/NodeProcessExecutionService.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeProcessExecutionService = void 0;
+const child_process_1 = require("child_process");
+const post_message_stream_1 = require("@metamask/post-message-stream");
+const __1 = require("..");
+class NodeProcessExecutionService extends __1.AbstractExecutionService {
+    async initEnvStream() {
+        const worker = (0, child_process_1.fork)(require.resolve('@metamask/snaps-execution-environments/dist/webpack/node-process/bundle.js'));
+        const stream = new post_message_stream_1.ProcessParentMessageStream({ process: worker });
+        return { worker, stream };
+    }
+    terminateJob(jobWrapper) {
+        jobWrapper.worker.kill();
+    }
+}
+exports.NodeProcessExecutionService = NodeProcessExecutionService;
+//# sourceMappingURL=NodeProcessExecutionService.js.map

package/dist/services/node/NodeProcessExecutionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeProcessExecutionService.js","sourceRoot":"","sources":["../../../src/services/node/NodeProcessExecutionService.ts"],"names":[],"mappings":";;;AAAA,iDAAmD;AACnD,uEAGuC;AACvC,0BAAmD;AAEnD,MAAa,2BAA4B,SAAQ,4BAAsC;IAC3E,KAAK,CAAC,aAAa;QAI3B,MAAM,MAAM,GAAG,IAAA,oBAAI,EACjB,OAAO,CAAC,OAAO,CACb,4EAA4E,CAC7E,CACF,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,gDAA0B,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IAES,YAAY,CAAC,UAA6B;QAClD,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF;AAjBD,kEAiBC","sourcesContent":["import { ChildProcess, fork } from 'child_process';\nimport {\n  ProcessParentMessageStream,\n  BasePostMessageStream,\n} from '@metamask/post-message-stream';\nimport { AbstractExecutionService, Job } from '..';\n\nexport class NodeProcessExecutionService extends AbstractExecutionService<ChildProcess> {\n  protected async initEnvStream(): Promise<{\n    worker: ChildProcess;\n    stream: BasePostMessageStream;\n  }> {\n    const worker = fork(\n      require.resolve(\n        '@metamask/snaps-execution-environments/dist/webpack/node-process/bundle.js',\n      ),\n    );\n    const stream = new ProcessParentMessageStream({ process: worker });\n    return { worker, stream };\n  }\n\n  protected terminateJob(jobWrapper: Job<ChildProcess>): void {\n    jobWrapper.worker.kill();\n  }\n}\n"]}

package/dist/services/node/NodeThreadExecutionService.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="node" />
+import { Worker } from 'worker_threads';
+import { BasePostMessageStream } from '@metamask/post-message-stream';
+import { AbstractExecutionService, Job } from '..';
+export declare class NodeThreadExecutionService extends AbstractExecutionService<Worker> {
+    protected initEnvStream(): Promise<{
+        worker: Worker;
+        stream: BasePostMessageStream;
+    }>;
+    protected terminateJob(jobWrapper: Job<Worker>): void;
+}

package/dist/services/node/NodeThreadExecutionService.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeThreadExecutionService = void 0;
+const worker_threads_1 = require("worker_threads");
+const post_message_stream_1 = require("@metamask/post-message-stream");
+const __1 = require("..");
+class NodeThreadExecutionService extends __1.AbstractExecutionService {
+    async initEnvStream() {
+        const worker = new worker_threads_1.Worker(require.resolve('@metamask/snaps-execution-environments/dist/webpack/node-thread/bundle.js'));
+        const stream = new post_message_stream_1.ThreadParentMessageStream({ thread: worker });
+        return { worker, stream };
+    }
+    terminateJob(jobWrapper) {
+        jobWrapper.worker.terminate();
+    }
+}
+exports.NodeThreadExecutionService = NodeThreadExecutionService;
+//# sourceMappingURL=NodeThreadExecutionService.js.map

package/dist/services/node/NodeThreadExecutionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeThreadExecutionService.js","sourceRoot":"","sources":["../../../src/services/node/NodeThreadExecutionService.ts"],"names":[],"mappings":";;;AAAA,mDAAwC;AACxC,uEAGuC;AACvC,0BAAmD;AAEnD,MAAa,0BAA2B,SAAQ,4BAAgC;IACpE,KAAK,CAAC,aAAa;QAI3B,MAAM,MAAM,GAAG,IAAI,uBAAM,CACvB,OAAO,CAAC,OAAO,CACb,2EAA2E,CAC5E,CACF,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,+CAAyB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACjE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IAES,YAAY,CAAC,UAAuB;QAC5C,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC;CACF;AAjBD,gEAiBC","sourcesContent":["import { Worker } from 'worker_threads';\nimport {\n  ThreadParentMessageStream,\n  BasePostMessageStream,\n} from '@metamask/post-message-stream';\nimport { AbstractExecutionService, Job } from '..';\n\nexport class NodeThreadExecutionService extends AbstractExecutionService<Worker> {\n  protected async initEnvStream(): Promise<{\n    worker: Worker;\n    stream: BasePostMessageStream;\n  }> {\n    const worker = new Worker(\n      require.resolve(\n        '@metamask/snaps-execution-environments/dist/webpack/node-thread/bundle.js',\n      ),\n    );\n    const stream = new ThreadParentMessageStream({ thread: worker });\n    return { worker, stream };\n  }\n\n  protected terminateJob(jobWrapper: Job<Worker>): void {\n    jobWrapper.worker.terminate();\n  }\n}\n"]}

package/dist/services/node/index.d.ts

@@ -0,0 +1,2 @@
+export * from './NodeProcessExecutionService';
+export * from './NodeThreadExecutionService';

package/dist/services/node/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./NodeProcessExecutionService"), exports);
+__exportStar(require("./NodeThreadExecutionService"), exports);
+//# sourceMappingURL=index.js.map

package/dist/services/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/node/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,+DAA6C","sourcesContent":["export * from './NodeProcessExecutionService';\nexport * from './NodeThreadExecutionService';\n"]}

package/dist/snaps/RequestQueue.d.ts

@@ -0,0 +1,24 @@
+export declare class RequestQueue {
+    readonly maxQueueSize: number;
+    private readonly queueSizes;
+    constructor(maxQueueSize: number);
+    /**
+     * Increments the queue count for a particular origin.
+     *
+     * @param origin - A string identifying the origin.
+     */
+    increment(origin: string): void;
+    /**
+     * Decrements the queue count for a particular origin.
+     *
+     * @param origin - A string identifying the origin.
+     */
+    decrement(origin: string): void;
+    /**
+     * Gets the queue count for a particular origin.
+     *
+     * @param origin - A string identifying the origin.
+     * @returns The queue count for the origin.
+     */
+    get(origin: string): number;
+}

package/dist/snaps/RequestQueue.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestQueue = void 0;
+class RequestQueue {
+    constructor(maxQueueSize) {
+        this.maxQueueSize = maxQueueSize;
+        this.queueSizes = new Map();
+    }
+    /**
+     * Increments the queue count for a particular origin.
+     *
+     * @param origin - A string identifying the origin.
+     */
+    increment(origin) {
+        var _a;
+        const currentCount = (_a = this.queueSizes.get(origin)) !== null && _a !== void 0 ? _a : 0;
+        if (currentCount >= this.maxQueueSize) {
+            throw new Error('Maximum number of requests reached. Try again later.');
+        }
+        this.queueSizes.set(origin, currentCount + 1);
+    }
+    /**
+     * Decrements the queue count for a particular origin.
+     *
+     * @param origin - A string identifying the origin.
+     */
+    decrement(origin) {
+        var _a;
+        const currentCount = (_a = this.queueSizes.get(origin)) !== null && _a !== void 0 ? _a : 0;
+        if (currentCount === 0) {
+            throw new Error(`Cannot decrement, ${origin} does not have any outstanding requests.`);
+        }
+        this.queueSizes.set(origin, currentCount - 1);
+    }
+    /**
+     * Gets the queue count for a particular origin.
+     *
+     * @param origin - A string identifying the origin.
+     * @returns The queue count for the origin.
+     */
+    get(origin) {
+        var _a;
+        return (_a = this.queueSizes.get(origin)) !== null && _a !== void 0 ? _a : 0;
+    }
+}
+exports.RequestQueue = RequestQueue;
+//# sourceMappingURL=RequestQueue.js.map

package/dist/snaps/RequestQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestQueue.js","sourceRoot":"","sources":["../../src/snaps/RequestQueue.ts"],"names":[],"mappings":";;;AAAA,MAAa,YAAY;IAKvB,YAAY,YAAoB;QAC9B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACI,SAAS,CAAC,MAAc;;QAC7B,MAAM,YAAY,GAAG,MAAA,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,mCAAI,CAAC,CAAC;QACtD,IAAI,YAAY,IAAI,IAAI,CAAC,YAAY,EAAE;YACrC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;SACzE;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACI,SAAS,CAAC,MAAc;;QAC7B,MAAM,YAAY,GAAG,MAAA,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,mCAAI,CAAC,CAAC;QACtD,IAAI,YAAY,KAAK,CAAC,EAAE;YACtB,MAAM,IAAI,KAAK,CACb,qBAAqB,MAAM,0CAA0C,CACtE,CAAC;SACH;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,MAAc;;QACvB,OAAO,MAAA,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,mCAAI,CAAC,CAAC;IAC1C,CAAC;CACF;AA/CD,oCA+CC","sourcesContent":["export class RequestQueue {\n  public readonly maxQueueSize: number;\n\n  private readonly queueSizes: Map<string, number>;\n\n  constructor(maxQueueSize: number) {\n    this.maxQueueSize = maxQueueSize;\n    this.queueSizes = new Map<string, number>();\n  }\n\n  /**\n   * Increments the queue count for a particular origin.\n   *\n   * @param origin - A string identifying the origin.\n   */\n  public increment(origin: string) {\n    const currentCount = this.queueSizes.get(origin) ?? 0;\n    if (currentCount >= this.maxQueueSize) {\n      throw new Error('Maximum number of requests reached. Try again later.');\n    }\n    this.queueSizes.set(origin, currentCount + 1);\n  }\n\n  /**\n   * Decrements the queue count for a particular origin.\n   *\n   * @param origin - A string identifying the origin.\n   */\n  public decrement(origin: string) {\n    const currentCount = this.queueSizes.get(origin) ?? 0;\n    if (currentCount === 0) {\n      throw new Error(\n        `Cannot decrement, ${origin} does not have any outstanding requests.`,\n      );\n    }\n    this.queueSizes.set(origin, currentCount - 1);\n  }\n\n  /**\n   * Gets the queue count for a particular origin.\n   *\n   * @param origin - A string identifying the origin.\n   * @returns The queue count for the origin.\n   */\n  public get(origin: string): number {\n    return this.queueSizes.get(origin) ?? 0;\n  }\n}\n"]}