@prismicio/simulator 0.1.0

package/dist/channel/ChannelEmitter.cjs

@@ -0,0 +1,146 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const types = require("./types.cjs");
+const errors = require("./errors.cjs");
+const ChannelNetwork = require("./ChannelNetwork.cjs");
+const messages = require("./messages.cjs");
+const channelEmitterDefaultOptions = {
+  connectTimeout: 2e4,
+  requestIDPrefix: "emitter-"
+};
+class ChannelEmitter extends ChannelNetwork.ChannelNetwork {
+  constructor(target, requestHandlers, options) {
+    super(requestHandlers, { ...channelEmitterDefaultOptions, ...options });
+    __publicField(this, "_target");
+    __publicField(this, "_channel", null);
+    __publicField(this, "_receiverReady", "");
+    __publicField(this, "_receiverReadyCallback", null);
+    __publicField(this, "_connected", false);
+    this._target = target;
+    window.addEventListener("message", (event) => {
+      this._onPublicMessage(event);
+    });
+  }
+  get channel() {
+    if (!this._channel) {
+      throw new errors.ChannelNotSetError();
+    }
+    return this._channel;
+  }
+  set channel(channel) {
+    this._channel = channel;
+    if (this._channel) {
+      this.port = this._channel.port1;
+    } else {
+      this.port = null;
+    }
+  }
+  get connected() {
+    return this._connected;
+  }
+  /**
+   * Initiates connection to receiver
+   *
+   * @param receiverOptions - Options to configure the receiver with
+   * @param newOrigin - Indicates to the emitter that we're connecting to a new
+   *   origin
+   *
+   * @returns Success connect message
+   */
+  connect(receiverOptions = {}, newOrigin = false) {
+    this.disconnect();
+    if (newOrigin) {
+      this._receiverReady = "";
+    }
+    return new Promise((resolve, reject) => {
+      this._target.addEventListener("load", () => {
+        if (!this._target.contentWindow) {
+          return reject(new Error("Target window is not available"));
+        }
+        const receiverReadyTimeout = setTimeout(() => {
+          reject(new errors.ConnectionTimeoutError());
+        }, this.options.connectTimeout);
+        const receiverReadyCallback = async () => {
+          clearTimeout(receiverReadyTimeout);
+          this.channel = new MessageChannel();
+          const request = this.createRequestMessage(types.InternalEmitterRequestType.Connect, receiverOptions);
+          const response = await this.postRequest(request, (request2) => {
+            this._target.contentWindow.postMessage(request2, "*", [
+              this.channel.port2
+            ]);
+          });
+          this.postResponse(messages.createSuccessResponseMessage(this._receiverReady, void 0), (response2) => {
+            this._target.contentWindow.postMessage(response2, "*");
+          });
+          this._connected = true;
+          resolve(response);
+        };
+        if (this._receiverReady) {
+          receiverReadyCallback();
+        } else {
+          this._receiverReadyCallback = receiverReadyCallback;
+        }
+      }, { once: true });
+    });
+  }
+  /**
+   * Destroys current connection to receiver if any
+   */
+  disconnect() {
+    this._connected = false;
+    this.channel = null;
+  }
+  /**
+   * Handles public messages
+   */
+  async _onPublicMessage(event) {
+    if (event.source !== this._target.contentWindow) {
+      return;
+    }
+    try {
+      const message = messages.validateMessage(event.data);
+      if (messages.isRequestMessage(message)) {
+        if (this.options.debug) {
+          console.debug(event.data);
+        }
+        switch (message.type) {
+          case types.InternalReceiverRequestType.Ready:
+            this._receiverReady = message.requestID;
+            if (this._receiverReadyCallback) {
+              const receiverReadyCallbackPromise = this._receiverReadyCallback();
+              this._receiverReadyCallback = null;
+              await receiverReadyCallbackPromise;
+            }
+            break;
+          default:
+            this.postResponse(messages.createErrorResponseMessage(message.requestID, void 0), (response) => {
+              event.source.postMessage(response, event.origin);
+            });
+            break;
+        }
+      } else {
+      }
+    } catch (error) {
+      if (error instanceof TypeError)
+        ;
+      else {
+        throw error;
+      }
+    }
+  }
+  postFormattedRequest(type, data, options = {}) {
+    if (!this._connected) {
+      throw new errors.NotReadyError("Emitter is not connected, use `ChannelEmitter.connect()` first");
+    }
+    return this.postRequest(this.createRequestMessage(type, data), void 0, options);
+  }
+}
+exports.ChannelEmitter = ChannelEmitter;
+exports.channelEmitterDefaultOptions = channelEmitterDefaultOptions;
+//# sourceMappingURL=ChannelEmitter.cjs.map

package/dist/channel/ChannelEmitter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelEmitter.cjs","sources":["../../../src/channel/ChannelEmitter.ts"],"sourcesContent":["import {\n\tExtractSuccessResponseMessage,\n\tInternalEmitterRequestType,\n\tInternalEmitterTransactions,\n\tInternalReceiverRequestType,\n\tSuccessResponseMessage,\n\tTransactionsHandlers,\n\tUnknownRequestMessage,\n\tUnknownResponseMessage,\n\tUnknownTransaction,\n} from \"./types\";\n\nimport {\n\tChannelNotSetError,\n\tConnectionTimeoutError,\n\tNotReadyError,\n} from \"./errors\";\n\nimport {\n\tChannelNetwork,\n\tChannelNetworkOptions,\n\tPostRequestOptions,\n} from \"./ChannelNetwork\";\nimport { AllChannelReceiverOptions } from \"./ChannelReceiver\";\nimport {\n\tcreateErrorResponseMessage,\n\tcreateSuccessResponseMessage,\n\tisRequestMessage,\n\tvalidateMessage,\n} from \"./messages\";\n\nexport type ChannelEmitterOptions = {\n\tconnectTimeout: number;\n};\n\nexport const channelEmitterDefaultOptions: ChannelEmitterOptions &\n\tPartial<ChannelNetworkOptions> = {\n\tconnectTimeout: 20000,\n\trequestIDPrefix: \"emitter-\",\n};\n\nexport type AllChannelEmitterOptions = ChannelEmitterOptions &\n\tChannelNetworkOptions;\n\nexport abstract class ChannelEmitter<\n\tTReceiverTransactions extends Record<string, UnknownTransaction> = Record<\n\t\tstring,\n\t\tnever\n\t>,\n\tTOptions extends Record<string, unknown> = Record<string, unknown>,\n\tTReceiverOptions extends Record<string, unknown> = Record<string, unknown>,\n> extends ChannelNetwork<\n\tTReceiverTransactions,\n\tChannelEmitterOptions & TOptions\n> {\n\tprivate _target: HTMLIFrameElement;\n\tprivate _channel: MessageChannel | null = null;\n\tprotected get channel(): MessageChannel {\n\t\tif (!this._channel) {\n\t\t\tthrow new ChannelNotSetError();\n\t\t}\n\n\t\treturn this._channel;\n\t}\n\tprotected set channel(channel: MessageChannel | null) {\n\t\tthis._channel = channel;\n\n\t\t// Update port automatically\n\t\tif (this._channel) {\n\t\t\tthis.port = this._channel.port1;\n\t\t} else {\n\t\t\tthis.port = null;\n\t\t}\n\t}\n\tprivate _receiverReady = \"\";\n\tprivate _receiverReadyCallback: (() => Promise<void>) | null = null;\n\tprivate _connected = false;\n\tpublic get connected(): boolean {\n\t\treturn this._connected;\n\t}\n\n\tconstructor(\n\t\ttarget: HTMLIFrameElement,\n\t\trequestHandlers: TransactionsHandlers<TReceiverTransactions>,\n\t\toptions: Partial<AllChannelEmitterOptions> & TOptions,\n\t) {\n\t\tsuper(requestHandlers, { ...channelEmitterDefaultOptions, ...options });\n\n\t\tthis._target = target;\n\n\t\twindow.addEventListener(\"message\", (event) => {\n\t\t\tthis._onPublicMessage(event);\n\t\t});\n\t}\n\n\t/**\n\t * Initiates connection to receiver\n\t *\n\t * @param receiverOptions - Options to configure the receiver with\n\t * @param newOrigin - Indicates to the emitter that we're connecting to a new\n\t *   origin\n\t *\n\t * @returns Success connect message\n\t */\n\tconnect(\n\t\treceiverOptions: InternalEmitterTransactions<\n\t\t\tAllChannelReceiverOptions & TReceiverOptions\n\t\t>[\"connect\"][\"request\"][\"data\"] = {},\n\t\tnewOrigin = false,\n\t): Promise<SuccessResponseMessage> {\n\t\t// Disconnect first\n\t\tthis.disconnect();\n\t\t// If changing origin we'll need to wait for receiver to be ready again\n\t\tif (newOrigin) {\n\t\t\tthis._receiverReady = \"\";\n\t\t}\n\n\t\t// Handshake promise\n\t\treturn new Promise<SuccessResponseMessage>((resolve, reject) => {\n\t\t\t// Wait for target to be loaded\n\t\t\tthis._target.addEventListener(\n\t\t\t\t\"load\",\n\t\t\t\t() => {\n\t\t\t\t\t// Throw if target doesn't allow access to content window\n\t\t\t\t\tif (!this._target.contentWindow) {\n\t\t\t\t\t\treturn reject(new Error(\"Target window is not available\"));\n\t\t\t\t\t}\n\n\t\t\t\t\tconst receiverReadyTimeout = setTimeout(() => {\n\t\t\t\t\t\treject(new ConnectionTimeoutError());\n\t\t\t\t\t}, this.options.connectTimeout);\n\n\t\t\t\t\t// Connect to target once ready\n\t\t\t\t\tconst receiverReadyCallback = async (): Promise<void> => {\n\t\t\t\t\t\t// Clear receiver ready timeout\n\t\t\t\t\t\tclearTimeout(receiverReadyTimeout);\n\n\t\t\t\t\t\t// Create new message channel (set up port automatically)\n\t\t\t\t\t\t// This is done here to prevent transferable objects neutering\n\t\t\t\t\t\t// when calling `connect()` multiple times\n\t\t\t\t\t\tthis.channel = new MessageChannel();\n\n\t\t\t\t\t\t// Conclude handshake by sending message channel port to target\n\t\t\t\t\t\tconst request = this.createRequestMessage(\n\t\t\t\t\t\t\tInternalEmitterRequestType.Connect,\n\t\t\t\t\t\t\treceiverOptions,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tconst response = await this.postRequest<\n\t\t\t\t\t\t\tInternalEmitterTransactions<\n\t\t\t\t\t\t\t\tAllChannelReceiverOptions & TReceiverOptions\n\t\t\t\t\t\t\t>[\"connect\"][\"request\"],\n\t\t\t\t\t\t\tInternalEmitterTransactions<\n\t\t\t\t\t\t\t\tAllChannelReceiverOptions & TReceiverOptions\n\t\t\t\t\t\t\t>[\"connect\"][\"response\"]\n\t\t\t\t\t\t>(request, (request) => {\n\t\t\t\t\t\t\t// Target content window is checked in previous statement\n\t\t\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n\t\t\t\t\t\t\tthis._target.contentWindow!.postMessage(request, \"*\", [\n\t\t\t\t\t\t\t\tthis.channel.port2,\n\t\t\t\t\t\t\t]);\n\t\t\t\t\t\t});\n\n\t\t\t\t\t\t// Finish by aknowledging ready\n\t\t\t\t\t\tthis.postResponse(\n\t\t\t\t\t\t\tcreateSuccessResponseMessage(this._receiverReady, undefined),\n\t\t\t\t\t\t\t(response) => {\n\t\t\t\t\t\t\t\t// Target content window is checked in previous statement\n\t\t\t\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n\t\t\t\t\t\t\t\tthis._target.contentWindow!.postMessage(response, \"*\");\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t);\n\n\t\t\t\t\t\t// If post request succeed, we're connected\n\t\t\t\t\t\tthis._connected = true;\n\n\t\t\t\t\t\tresolve(response);\n\t\t\t\t\t};\n\n\t\t\t\t\tif (this._receiverReady) {\n\t\t\t\t\t\t// If receiver is already ready, send port immediately\n\t\t\t\t\t\treceiverReadyCallback();\n\t\t\t\t\t} else {\n\t\t\t\t\t\t// Else wait for receiver to be ready\n\t\t\t\t\t\tthis._receiverReadyCallback = receiverReadyCallback;\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\t{ once: true },\n\t\t\t);\n\t\t});\n\t}\n\n\t/**\n\t * Destroys current connection to receiver if any\n\t */\n\tdisconnect(): void {\n\t\tthis._connected = false;\n\t\tthis.channel = null;\n\t}\n\n\t/**\n\t * Handles public messages\n\t */\n\tprivate async _onPublicMessage(event: MessageEvent<unknown>): Promise<void> {\n\t\t// Return is event is not from target\n\t\tif (event.source !== this._target.contentWindow) {\n\t\t\treturn;\n\t\t}\n\n\t\ttry {\n\t\t\tconst message = validateMessage(event.data);\n\n\t\t\tif (isRequestMessage(message)) {\n\t\t\t\tif (this.options.debug) {\n\t\t\t\t\t// eslint-disable-next-line no-console\n\t\t\t\t\tconsole.debug(event.data);\n\t\t\t\t}\n\n\t\t\t\tswitch (message.type) {\n\t\t\t\t\tcase InternalReceiverRequestType.Ready:\n\t\t\t\t\t\tthis._receiverReady = message.requestID;\n\n\t\t\t\t\t\t// If emitter is waiting for receiver to be ready\n\t\t\t\t\t\tif (this._receiverReadyCallback) {\n\t\t\t\t\t\t\t// We don't await the promise directly as we need to clear the callback first\n\t\t\t\t\t\t\tconst receiverReadyCallbackPromise =\n\t\t\t\t\t\t\t\tthis._receiverReadyCallback();\n\n\t\t\t\t\t\t\tthis._receiverReadyCallback = null;\n\n\t\t\t\t\t\t\tawait receiverReadyCallbackPromise;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\n\t\t\t\t\tdefault:\n\t\t\t\t\t\tthis.postResponse(\n\t\t\t\t\t\t\tcreateErrorResponseMessage(message.requestID, undefined),\n\t\t\t\t\t\t\t(response) => {\n\t\t\t\t\t\t\t\t(event.source as WindowProxy).postMessage(\n\t\t\t\t\t\t\t\t\tresponse,\n\t\t\t\t\t\t\t\t\tevent.origin,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t);\n\t\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\t// No response messages are expected on public channel\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tif (error instanceof TypeError) {\n\t\t\t\t// Ignore unknown messages\n\t\t\t} else {\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t}\n\n\tprotected postFormattedRequest<\n\t\tTRequest extends UnknownRequestMessage,\n\t\tTResponse extends UnknownResponseMessage,\n\t>(\n\t\ttype: TRequest[\"type\"],\n\t\tdata?: TRequest[\"data\"],\n\t\toptions: PostRequestOptions = {},\n\t): Promise<ExtractSuccessResponseMessage<TResponse>> {\n\t\tif (!this._connected) {\n\t\t\tthrow new NotReadyError(\n\t\t\t\t\"Emitter is not connected, use `ChannelEmitter.connect()` first\",\n\t\t\t);\n\t\t}\n\n\t\treturn this.postRequest(\n\t\t\tthis.createRequestMessage(type, data),\n\t\t\tundefined,\n\t\t\toptions,\n\t\t);\n\t}\n}\n"],"names":["ChannelNetwork","ChannelNotSetError","ConnectionTimeoutError","InternalEmitterRequestType","request","createSuccessResponseMessage","response","validateMessage","isRequestMessage","InternalReceiverRequestType","createErrorResponseMessage","NotReadyError"],"mappings":"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"}

package/dist/channel/ChannelEmitter.d.ts

@@ -0,0 +1,38 @@
+import { ExtractSuccessResponseMessage, InternalEmitterTransactions, SuccessResponseMessage, TransactionsHandlers, UnknownRequestMessage, UnknownResponseMessage, UnknownTransaction } from "./types";
+import { ChannelNetwork, ChannelNetworkOptions, PostRequestOptions } from "./ChannelNetwork";
+import { AllChannelReceiverOptions } from "./ChannelReceiver";
+export type ChannelEmitterOptions = {
+    connectTimeout: number;
+};
+export declare const channelEmitterDefaultOptions: ChannelEmitterOptions & Partial<ChannelNetworkOptions>;
+export type AllChannelEmitterOptions = ChannelEmitterOptions & ChannelNetworkOptions;
+export declare abstract class ChannelEmitter<TReceiverTransactions extends Record<string, UnknownTransaction> = Record<string, never>, TOptions extends Record<string, unknown> = Record<string, unknown>, TReceiverOptions extends Record<string, unknown> = Record<string, unknown>> extends ChannelNetwork<TReceiverTransactions, ChannelEmitterOptions & TOptions> {
+    private _target;
+    private _channel;
+    protected get channel(): MessageChannel;
+    protected set channel(channel: MessageChannel | null);
+    private _receiverReady;
+    private _receiverReadyCallback;
+    private _connected;
+    get connected(): boolean;
+    constructor(target: HTMLIFrameElement, requestHandlers: TransactionsHandlers<TReceiverTransactions>, options: Partial<AllChannelEmitterOptions> & TOptions);
+    /**
+     * Initiates connection to receiver
+     *
+     * @param receiverOptions - Options to configure the receiver with
+     * @param newOrigin - Indicates to the emitter that we're connecting to a new
+     *   origin
+     *
+     * @returns Success connect message
+     */
+    connect(receiverOptions?: InternalEmitterTransactions<AllChannelReceiverOptions & TReceiverOptions>["connect"]["request"]["data"], newOrigin?: boolean): Promise<SuccessResponseMessage>;
+    /**
+     * Destroys current connection to receiver if any
+     */
+    disconnect(): void;
+    /**
+     * Handles public messages
+     */
+    private _onPublicMessage;
+    protected postFormattedRequest<TRequest extends UnknownRequestMessage, TResponse extends UnknownResponseMessage>(type: TRequest["type"], data?: TRequest["data"], options?: PostRequestOptions): Promise<ExtractSuccessResponseMessage<TResponse>>;
+}

package/dist/channel/ChannelEmitter.js

@@ -0,0 +1,146 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+import { InternalReceiverRequestType, InternalEmitterRequestType } from "./types.js";
+import { ChannelNotSetError, ConnectionTimeoutError, NotReadyError } from "./errors.js";
+import { ChannelNetwork } from "./ChannelNetwork.js";
+import { validateMessage, isRequestMessage, createErrorResponseMessage, createSuccessResponseMessage } from "./messages.js";
+const channelEmitterDefaultOptions = {
+  connectTimeout: 2e4,
+  requestIDPrefix: "emitter-"
+};
+class ChannelEmitter extends ChannelNetwork {
+  constructor(target, requestHandlers, options) {
+    super(requestHandlers, { ...channelEmitterDefaultOptions, ...options });
+    __publicField(this, "_target");
+    __publicField(this, "_channel", null);
+    __publicField(this, "_receiverReady", "");
+    __publicField(this, "_receiverReadyCallback", null);
+    __publicField(this, "_connected", false);
+    this._target = target;
+    window.addEventListener("message", (event) => {
+      this._onPublicMessage(event);
+    });
+  }
+  get channel() {
+    if (!this._channel) {
+      throw new ChannelNotSetError();
+    }
+    return this._channel;
+  }
+  set channel(channel) {
+    this._channel = channel;
+    if (this._channel) {
+      this.port = this._channel.port1;
+    } else {
+      this.port = null;
+    }
+  }
+  get connected() {
+    return this._connected;
+  }
+  /**
+   * Initiates connection to receiver
+   *
+   * @param receiverOptions - Options to configure the receiver with
+   * @param newOrigin - Indicates to the emitter that we're connecting to a new
+   *   origin
+   *
+   * @returns Success connect message
+   */
+  connect(receiverOptions = {}, newOrigin = false) {
+    this.disconnect();
+    if (newOrigin) {
+      this._receiverReady = "";
+    }
+    return new Promise((resolve, reject) => {
+      this._target.addEventListener("load", () => {
+        if (!this._target.contentWindow) {
+          return reject(new Error("Target window is not available"));
+        }
+        const receiverReadyTimeout = setTimeout(() => {
+          reject(new ConnectionTimeoutError());
+        }, this.options.connectTimeout);
+        const receiverReadyCallback = async () => {
+          clearTimeout(receiverReadyTimeout);
+          this.channel = new MessageChannel();
+          const request = this.createRequestMessage(InternalEmitterRequestType.Connect, receiverOptions);
+          const response = await this.postRequest(request, (request2) => {
+            this._target.contentWindow.postMessage(request2, "*", [
+              this.channel.port2
+            ]);
+          });
+          this.postResponse(createSuccessResponseMessage(this._receiverReady, void 0), (response2) => {
+            this._target.contentWindow.postMessage(response2, "*");
+          });
+          this._connected = true;
+          resolve(response);
+        };
+        if (this._receiverReady) {
+          receiverReadyCallback();
+        } else {
+          this._receiverReadyCallback = receiverReadyCallback;
+        }
+      }, { once: true });
+    });
+  }
+  /**
+   * Destroys current connection to receiver if any
+   */
+  disconnect() {
+    this._connected = false;
+    this.channel = null;
+  }
+  /**
+   * Handles public messages
+   */
+  async _onPublicMessage(event) {
+    if (event.source !== this._target.contentWindow) {
+      return;
+    }
+    try {
+      const message = validateMessage(event.data);
+      if (isRequestMessage(message)) {
+        if (this.options.debug) {
+          console.debug(event.data);
+        }
+        switch (message.type) {
+          case InternalReceiverRequestType.Ready:
+            this._receiverReady = message.requestID;
+            if (this._receiverReadyCallback) {
+              const receiverReadyCallbackPromise = this._receiverReadyCallback();
+              this._receiverReadyCallback = null;
+              await receiverReadyCallbackPromise;
+            }
+            break;
+          default:
+            this.postResponse(createErrorResponseMessage(message.requestID, void 0), (response) => {
+              event.source.postMessage(response, event.origin);
+            });
+            break;
+        }
+      } else {
+      }
+    } catch (error) {
+      if (error instanceof TypeError)
+        ;
+      else {
+        throw error;
+      }
+    }
+  }
+  postFormattedRequest(type, data, options = {}) {
+    if (!this._connected) {
+      throw new NotReadyError("Emitter is not connected, use `ChannelEmitter.connect()` first");
+    }
+    return this.postRequest(this.createRequestMessage(type, data), void 0, options);
+  }
+}
+export {
+  ChannelEmitter,
+  channelEmitterDefaultOptions
+};
+//# sourceMappingURL=ChannelEmitter.js.map

package/dist/channel/ChannelEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelEmitter.js","sources":["../../../src/channel/ChannelEmitter.ts"],"sourcesContent":["import {\n\tExtractSuccessResponseMessage,\n\tInternalEmitterRequestType,\n\tInternalEmitterTransactions,\n\tInternalReceiverRequestType,\n\tSuccessResponseMessage,\n\tTransactionsHandlers,\n\tUnknownRequestMessage,\n\tUnknownResponseMessage,\n\tUnknownTransaction,\n} from \"./types\";\n\nimport {\n\tChannelNotSetError,\n\tConnectionTimeoutError,\n\tNotReadyError,\n} from \"./errors\";\n\nimport {\n\tChannelNetwork,\n\tChannelNetworkOptions,\n\tPostRequestOptions,\n} from \"./ChannelNetwork\";\nimport { AllChannelReceiverOptions } from \"./ChannelReceiver\";\nimport {\n\tcreateErrorResponseMessage,\n\tcreateSuccessResponseMessage,\n\tisRequestMessage,\n\tvalidateMessage,\n} from \"./messages\";\n\nexport type ChannelEmitterOptions = {\n\tconnectTimeout: number;\n};\n\nexport const channelEmitterDefaultOptions: ChannelEmitterOptions &\n\tPartial<ChannelNetworkOptions> = {\n\tconnectTimeout: 20000,\n\trequestIDPrefix: \"emitter-\",\n};\n\nexport type AllChannelEmitterOptions = ChannelEmitterOptions &\n\tChannelNetworkOptions;\n\nexport abstract class ChannelEmitter<\n\tTReceiverTransactions extends Record<string, UnknownTransaction> = Record<\n\t\tstring,\n\t\tnever\n\t>,\n\tTOptions extends Record<string, unknown> = Record<string, unknown>,\n\tTReceiverOptions extends Record<string, unknown> = Record<string, unknown>,\n> extends ChannelNetwork<\n\tTReceiverTransactions,\n\tChannelEmitterOptions & TOptions\n> {\n\tprivate _target: HTMLIFrameElement;\n\tprivate _channel: MessageChannel | null = null;\n\tprotected get channel(): MessageChannel {\n\t\tif (!this._channel) {\n\t\t\tthrow new ChannelNotSetError();\n\t\t}\n\n\t\treturn this._channel;\n\t}\n\tprotected set channel(channel: MessageChannel | null) {\n\t\tthis._channel = channel;\n\n\t\t// Update port automatically\n\t\tif (this._channel) {\n\t\t\tthis.port = this._channel.port1;\n\t\t} else {\n\t\t\tthis.port = null;\n\t\t}\n\t}\n\tprivate _receiverReady = \"\";\n\tprivate _receiverReadyCallback: (() => Promise<void>) | null = null;\n\tprivate _connected = false;\n\tpublic get connected(): boolean {\n\t\treturn this._connected;\n\t}\n\n\tconstructor(\n\t\ttarget: HTMLIFrameElement,\n\t\trequestHandlers: TransactionsHandlers<TReceiverTransactions>,\n\t\toptions: Partial<AllChannelEmitterOptions> & TOptions,\n\t) {\n\t\tsuper(requestHandlers, { ...channelEmitterDefaultOptions, ...options });\n\n\t\tthis._target = target;\n\n\t\twindow.addEventListener(\"message\", (event) => {\n\t\t\tthis._onPublicMessage(event);\n\t\t});\n\t}\n\n\t/**\n\t * Initiates connection to receiver\n\t *\n\t * @param receiverOptions - Options to configure the receiver with\n\t * @param newOrigin - Indicates to the emitter that we're connecting to a new\n\t *   origin\n\t *\n\t * @returns Success connect message\n\t */\n\tconnect(\n\t\treceiverOptions: InternalEmitterTransactions<\n\t\t\tAllChannelReceiverOptions & TReceiverOptions\n\t\t>[\"connect\"][\"request\"][\"data\"] = {},\n\t\tnewOrigin = false,\n\t): Promise<SuccessResponseMessage> {\n\t\t// Disconnect first\n\t\tthis.disconnect();\n\t\t// If changing origin we'll need to wait for receiver to be ready again\n\t\tif (newOrigin) {\n\t\t\tthis._receiverReady = \"\";\n\t\t}\n\n\t\t// Handshake promise\n\t\treturn new Promise<SuccessResponseMessage>((resolve, reject) => {\n\t\t\t// Wait for target to be loaded\n\t\t\tthis._target.addEventListener(\n\t\t\t\t\"load\",\n\t\t\t\t() => {\n\t\t\t\t\t// Throw if target doesn't allow access to content window\n\t\t\t\t\tif (!this._target.contentWindow) {\n\t\t\t\t\t\treturn reject(new Error(\"Target window is not available\"));\n\t\t\t\t\t}\n\n\t\t\t\t\tconst receiverReadyTimeout = setTimeout(() => {\n\t\t\t\t\t\treject(new ConnectionTimeoutError());\n\t\t\t\t\t}, this.options.connectTimeout);\n\n\t\t\t\t\t// Connect to target once ready\n\t\t\t\t\tconst receiverReadyCallback = async (): Promise<void> => {\n\t\t\t\t\t\t// Clear receiver ready timeout\n\t\t\t\t\t\tclearTimeout(receiverReadyTimeout);\n\n\t\t\t\t\t\t// Create new message channel (set up port automatically)\n\t\t\t\t\t\t// This is done here to prevent transferable objects neutering\n\t\t\t\t\t\t// when calling `connect()` multiple times\n\t\t\t\t\t\tthis.channel = new MessageChannel();\n\n\t\t\t\t\t\t// Conclude handshake by sending message channel port to target\n\t\t\t\t\t\tconst request = this.createRequestMessage(\n\t\t\t\t\t\t\tInternalEmitterRequestType.Connect,\n\t\t\t\t\t\t\treceiverOptions,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tconst response = await this.postRequest<\n\t\t\t\t\t\t\tInternalEmitterTransactions<\n\t\t\t\t\t\t\t\tAllChannelReceiverOptions & TReceiverOptions\n\t\t\t\t\t\t\t>[\"connect\"][\"request\"],\n\t\t\t\t\t\t\tInternalEmitterTransactions<\n\t\t\t\t\t\t\t\tAllChannelReceiverOptions & TReceiverOptions\n\t\t\t\t\t\t\t>[\"connect\"][\"response\"]\n\t\t\t\t\t\t>(request, (request) => {\n\t\t\t\t\t\t\t// Target content window is checked in previous statement\n\t\t\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n\t\t\t\t\t\t\tthis._target.contentWindow!.postMessage(request, \"*\", [\n\t\t\t\t\t\t\t\tthis.channel.port2,\n\t\t\t\t\t\t\t]);\n\t\t\t\t\t\t});\n\n\t\t\t\t\t\t// Finish by aknowledging ready\n\t\t\t\t\t\tthis.postResponse(\n\t\t\t\t\t\t\tcreateSuccessResponseMessage(this._receiverReady, undefined),\n\t\t\t\t\t\t\t(response) => {\n\t\t\t\t\t\t\t\t// Target content window is checked in previous statement\n\t\t\t\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n\t\t\t\t\t\t\t\tthis._target.contentWindow!.postMessage(response, \"*\");\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t);\n\n\t\t\t\t\t\t// If post request succeed, we're connected\n\t\t\t\t\t\tthis._connected = true;\n\n\t\t\t\t\t\tresolve(response);\n\t\t\t\t\t};\n\n\t\t\t\t\tif (this._receiverReady) {\n\t\t\t\t\t\t// If receiver is already ready, send port immediately\n\t\t\t\t\t\treceiverReadyCallback();\n\t\t\t\t\t} else {\n\t\t\t\t\t\t// Else wait for receiver to be ready\n\t\t\t\t\t\tthis._receiverReadyCallback = receiverReadyCallback;\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\t{ once: true },\n\t\t\t);\n\t\t});\n\t}\n\n\t/**\n\t * Destroys current connection to receiver if any\n\t */\n\tdisconnect(): void {\n\t\tthis._connected = false;\n\t\tthis.channel = null;\n\t}\n\n\t/**\n\t * Handles public messages\n\t */\n\tprivate async _onPublicMessage(event: MessageEvent<unknown>): Promise<void> {\n\t\t// Return is event is not from target\n\t\tif (event.source !== this._target.contentWindow) {\n\t\t\treturn;\n\t\t}\n\n\t\ttry {\n\t\t\tconst message = validateMessage(event.data);\n\n\t\t\tif (isRequestMessage(message)) {\n\t\t\t\tif (this.options.debug) {\n\t\t\t\t\t// eslint-disable-next-line no-console\n\t\t\t\t\tconsole.debug(event.data);\n\t\t\t\t}\n\n\t\t\t\tswitch (message.type) {\n\t\t\t\t\tcase InternalReceiverRequestType.Ready:\n\t\t\t\t\t\tthis._receiverReady = message.requestID;\n\n\t\t\t\t\t\t// If emitter is waiting for receiver to be ready\n\t\t\t\t\t\tif (this._receiverReadyCallback) {\n\t\t\t\t\t\t\t// We don't await the promise directly as we need to clear the callback first\n\t\t\t\t\t\t\tconst receiverReadyCallbackPromise =\n\t\t\t\t\t\t\t\tthis._receiverReadyCallback();\n\n\t\t\t\t\t\t\tthis._receiverReadyCallback = null;\n\n\t\t\t\t\t\t\tawait receiverReadyCallbackPromise;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\n\t\t\t\t\tdefault:\n\t\t\t\t\t\tthis.postResponse(\n\t\t\t\t\t\t\tcreateErrorResponseMessage(message.requestID, undefined),\n\t\t\t\t\t\t\t(response) => {\n\t\t\t\t\t\t\t\t(event.source as WindowProxy).postMessage(\n\t\t\t\t\t\t\t\t\tresponse,\n\t\t\t\t\t\t\t\t\tevent.origin,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t);\n\t\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\t// No response messages are expected on public channel\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tif (error instanceof TypeError) {\n\t\t\t\t// Ignore unknown messages\n\t\t\t} else {\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t}\n\n\tprotected postFormattedRequest<\n\t\tTRequest extends UnknownRequestMessage,\n\t\tTResponse extends UnknownResponseMessage,\n\t>(\n\t\ttype: TRequest[\"type\"],\n\t\tdata?: TRequest[\"data\"],\n\t\toptions: PostRequestOptions = {},\n\t): Promise<ExtractSuccessResponseMessage<TResponse>> {\n\t\tif (!this._connected) {\n\t\t\tthrow new NotReadyError(\n\t\t\t\t\"Emitter is not connected, use `ChannelEmitter.connect()` first\",\n\t\t\t);\n\t\t}\n\n\t\treturn this.postRequest(\n\t\t\tthis.createRequestMessage(type, data),\n\t\t\tundefined,\n\t\t\toptions,\n\t\t);\n\t}\n}\n"],"names":["request","response"],"mappings":";;;;;;;;;;AAmCO,MAAM,+BACqB;AAAA,EACjC,gBAAgB;AAAA,EAChB,iBAAiB;;AAMZ,MAAgB,uBAOZ,eAGT;AAAA,EA2BA,YACC,QACA,iBACA,SAAqD;AAErD,UAAM,iBAAiB,EAAE,GAAG,8BAA8B,GAAG,QAAS,CAAA;AA/B/D;AACA,oCAAkC;AAkBlC,0CAAiB;AACjB,kDAAuD;AACvD,sCAAa;AAYpB,SAAK,UAAU;AAER,WAAA,iBAAiB,WAAW,CAAC,UAAS;AAC5C,WAAK,iBAAiB,KAAK;AAAA,IAAA,CAC3B;AAAA,EACF;AAAA,EApCA,IAAc,UAAO;AAChB,QAAA,CAAC,KAAK,UAAU;AACnB,YAAM,IAAI,mBAAkB;AAAA,IAC5B;AAED,WAAO,KAAK;AAAA,EACb;AAAA,EACA,IAAc,QAAQ,SAA8B;AACnD,SAAK,WAAW;AAGhB,QAAI,KAAK,UAAU;AACb,WAAA,OAAO,KAAK,SAAS;AAAA,IAAA,OACpB;AACN,WAAK,OAAO;AAAA,IACZ;AAAA,EACF;AAAA,EAIA,IAAW,YAAS;AACnB,WAAO,KAAK;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,QACC,kBAEkC,IAClC,YAAY,OAAK;AAGjB,SAAK,WAAU;AAEf,QAAI,WAAW;AACd,WAAK,iBAAiB;AAAA,IACtB;AAGD,WAAO,IAAI,QAAgC,CAAC,SAAS,WAAU;AAEzD,WAAA,QAAQ,iBACZ,QACA,MAAK;AAEA,YAAA,CAAC,KAAK,QAAQ,eAAe;AAChC,iBAAO,OAAO,IAAI,MAAM,gCAAgC,CAAC;AAAA,QACzD;AAEK,cAAA,uBAAuB,WAAW,MAAK;AACrC,iBAAA,IAAI,wBAAwB;AAAA,QAAA,GACjC,KAAK,QAAQ,cAAc;AAG9B,cAAM,wBAAwB,YAA0B;AAEvD,uBAAa,oBAAoB;AAK5B,eAAA,UAAU,IAAI;AAGnB,gBAAM,UAAU,KAAK,qBACpB,2BAA2B,SAC3B,eAAe;AAEhB,gBAAM,WAAW,MAAM,KAAK,YAO1B,SAAS,CAACA,aAAW;AAGtB,iBAAK,QAAQ,cAAe,YAAYA,UAAS,KAAK;AAAA,cACrD,KAAK,QAAQ;AAAA,YAAA,CACb;AAAA,UAAA,CACD;AAGD,eAAK,aACJ,6BAA6B,KAAK,gBAAgB,MAAS,GAC3D,CAACC,cAAY;AAGZ,iBAAK,QAAQ,cAAe,YAAYA,WAAU,GAAG;AAAA,UAAA,CACrD;AAIF,eAAK,aAAa;AAElB,kBAAQ,QAAQ;AAAA,QAAA;AAGjB,YAAI,KAAK,gBAAgB;;eAGlB;AAEN,eAAK,yBAAyB;AAAA,QAC9B;AAAA,MAAA,GAEF,EAAE,MAAM,KAAA,CAAM;AAAA,IAAA,CAEf;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,aAAU;AACT,SAAK,aAAa;AAClB,SAAK,UAAU;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKQ,MAAM,iBAAiB,OAA4B;AAE1D,QAAI,MAAM,WAAW,KAAK,QAAQ,eAAe;AAChD;AAAA,IACA;AAEG,QAAA;AACG,YAAA,UAAU,gBAAgB,MAAM,IAAI;AAEtC,UAAA,iBAAiB,OAAO,GAAG;AAC1B,YAAA,KAAK,QAAQ,OAAO;AAEf,kBAAA,MAAM,MAAM,IAAI;AAAA,QACxB;AAED,gBAAQ,QAAQ,MAAM;AAAA,UACrB,KAAK,4BAA4B;AAChC,iBAAK,iBAAiB,QAAQ;AAG9B,gBAAI,KAAK,wBAAwB;AAE1B,oBAAA,+BACL,KAAK;AAEN,mBAAK,yBAAyB;AAExB,oBAAA;AAAA,YACN;AACD;AAAA,UAED;AACC,iBAAK,aACJ,2BAA2B,QAAQ,WAAW,MAAS,GACvD,CAAC,aAAY;AACX,oBAAM,OAAuB,YAC7B,UACA,MAAM,MAAM;AAAA,YAAA,CAEb;AAEF;AAAA,QACD;AAAA,MAAA,OACK;AAAA,MAEN;AAAA,aACO;AACR,UAAI,iBAAiB;AAAW;AAAA,WAEzB;AACA,cAAA;AAAA,MACN;AAAA,IACD;AAAA,EACF;AAAA,EAEU,qBAIT,MACA,MACA,UAA8B,CAAA,GAAE;AAE5B,QAAA,CAAC,KAAK,YAAY;AACf,YAAA,IAAI,cACT,gEAAgE;AAAA,IAEjE;AAEM,WAAA,KAAK,YACX,KAAK,qBAAqB,MAAM,IAAI,GACpC,QACA,OAAO;AAAA,EAET;AACA;"}

package/dist/channel/ChannelNetwork.cjs

@@ -0,0 +1,112 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const errors = require("./errors.cjs");
+const messages = require("./messages.cjs");
+const channelNetworkDefaultOptions = {
+  debug: false,
+  maximumRequestConcurrency: 20,
+  defaultTimeout: 5e3,
+  requestIDPrefix: "channel-"
+};
+class ChannelNetwork {
+  constructor(requestHandlers, options) {
+    __publicField(this, "requestHandlers");
+    __publicField(this, "options");
+    __publicField(this, "_port", null);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    __publicField(this, "_pendingRequests", /* @__PURE__ */ new Map());
+    this.requestHandlers = requestHandlers;
+    this.options = { ...channelNetworkDefaultOptions, ...options };
+  }
+  get port() {
+    if (!this._port) {
+      throw new errors.PortNotSetError();
+    }
+    return this._port;
+  }
+  set port(port) {
+    if (this._port) {
+      this._port.onmessage = null;
+    }
+    this._port = port;
+    if (this._port) {
+      this._port.onmessage = this.onMessage.bind(this);
+    }
+  }
+  createRequestMessage(type, data) {
+    return messages.createRequestMessage(type, data, this.options.requestIDPrefix);
+  }
+  async onMessage(event) {
+    if (this.options.debug) {
+      console.debug(event.data);
+    }
+    try {
+      const message = messages.validateMessage(event.data);
+      if (messages.isRequestMessage(message)) {
+        if (!this.requestHandlers[message.type]) {
+          this.postResponse(messages.createErrorResponseMessage(message.requestID, void 0, 501));
+        } else {
+          try {
+            const response = await this.requestHandlers[message.type](message, {
+              success: messages.createSuccessResponseMessage.bind(this, message.requestID),
+              error: messages.createErrorResponseMessage.bind(this, message.requestID)
+            });
+            this.postResponse(response);
+          } catch (error) {
+            this.postResponse(messages.createErrorResponseMessage(message.requestID, error, 500));
+          }
+        }
+      } else {
+        if (!this._pendingRequests.has(message.requestID)) {
+          console.error(`Unknown request ID received in response: ${JSON.stringify(message)}`);
+        } else {
+          this._pendingRequests.get(message.requestID)(message);
+          this._pendingRequests.delete(message.requestID);
+        }
+      }
+    } catch (error) {
+      if (error instanceof TypeError) {
+        console.warn(error.message);
+      } else {
+        throw error;
+      }
+    }
+  }
+  postRequest(request, postMessage = (request2) => this.port.postMessage(request2), options = {}) {
+    if (this.options.debug) {
+      console.debug(request);
+    }
+    if (this._pendingRequests.size >= this.options.maximumRequestConcurrency) {
+      throw new errors.TooManyConcurrentRequestsError(request);
+    }
+    return new Promise((resolve, reject) => {
+      const requestTimeout = setTimeout(() => {
+        if (this._pendingRequests.has(request.requestID)) {
+          this._pendingRequests.delete(request.requestID);
+        }
+        reject(new errors.RequestTimeoutError(request));
+      }, options.timeout || this.options.defaultTimeout);
+      this._pendingRequests.set(request.requestID, (response) => {
+        clearTimeout(requestTimeout);
+        messages.isSuccessResponseMessage(response) ? resolve(response) : reject(new errors.ResponseError(response));
+      });
+      postMessage(request);
+    });
+  }
+  postResponse(response, postMessage = (response2) => this.port.postMessage(response2)) {
+    if (this.options.debug) {
+      console.debug(response);
+    }
+    postMessage(response);
+    return response;
+  }
+}
+exports.ChannelNetwork = ChannelNetwork;
+exports.channelNetworkDefaultOptions = channelNetworkDefaultOptions;
+//# sourceMappingURL=ChannelNetwork.cjs.map

package/dist/channel/ChannelNetwork.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelNetwork.cjs","sources":["../../../src/channel/ChannelNetwork.ts"],"sourcesContent":["import {\n\tExtractErrorResponseMessage,\n\tExtractSuccessResponseMessage,\n\tRequestMessage,\n\tTransactionsHandlers,\n\tUnknownRequestMessage,\n\tUnknownResponseMessage,\n\tUnknownTransaction,\n} from \"./types\";\n\nimport {\n\tPortNotSetError,\n\tRequestTimeoutError,\n\tResponseError,\n\tTooManyConcurrentRequestsError,\n} from \"./errors\";\n\nimport {\n\tcreateErrorResponseMessage,\n\tcreateRequestMessage,\n\tcreateSuccessResponseMessage,\n\tisRequestMessage,\n\tisSuccessResponseMessage,\n\tvalidateMessage,\n} from \"./messages\";\n\nexport type PostRequestOptions = {\n\ttimeout?: number;\n};\n\nexport type ChannelNetworkOptions = {\n\tdebug: boolean;\n\tmaximumRequestConcurrency: number;\n\tdefaultTimeout: number;\n\trequestIDPrefix: string;\n};\n\nexport const channelNetworkDefaultOptions: ChannelNetworkOptions = {\n\tdebug: false,\n\tmaximumRequestConcurrency: 20,\n\tdefaultTimeout: 5000,\n\trequestIDPrefix: \"channel-\",\n};\n\nexport abstract class ChannelNetwork<\n\tTPartnerTransactions extends Record<string, UnknownTransaction> = Record<\n\t\tstring,\n\t\tnever\n\t>,\n\tTOptions extends Record<string, unknown> = Record<string, unknown>,\n> {\n\tpublic requestHandlers: TransactionsHandlers<TPartnerTransactions>;\n\tpublic options: ChannelNetworkOptions & TOptions;\n\n\tprivate _port: MessagePort | null = null;\n\tprotected get port(): MessagePort {\n\t\tif (!this._port) {\n\t\t\tthrow new PortNotSetError();\n\t\t}\n\n\t\treturn this._port;\n\t}\n\tprotected set port(port: MessagePort | null) {\n\t\t// Destroy old port\n\t\tif (this._port) {\n\t\t\tthis._port.onmessage = null;\n\t\t}\n\n\t\tthis._port = port;\n\t\tif (this._port) {\n\t\t\tthis._port.onmessage = this.onMessage.bind(this);\n\t\t}\n\t}\n\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tprivate _pendingRequests: Map<string, (response: any) => void> = new Map();\n\n\tconstructor(\n\t\trequestHandlers: TransactionsHandlers<TPartnerTransactions>,\n\t\toptions: Partial<ChannelNetworkOptions> & TOptions,\n\t) {\n\t\tthis.requestHandlers = requestHandlers;\n\t\tthis.options = { ...channelNetworkDefaultOptions, ...options };\n\t}\n\n\tpublic createRequestMessage<TType extends string = string, TData = undefined>(\n\t\ttype: TType,\n\t\tdata: TData,\n\t): RequestMessage<TType, TData> {\n\t\treturn createRequestMessage(type, data, this.options.requestIDPrefix);\n\t}\n\n\tprotected async onMessage(event: MessageEvent<unknown>): Promise<void> {\n\t\tif (this.options.debug) {\n\t\t\t// eslint-disable-next-line no-console\n\t\t\tconsole.debug(event.data);\n\t\t}\n\n\t\ttry {\n\t\t\tconst message = validateMessage(event.data);\n\n\t\t\tif (isRequestMessage(message)) {\n\t\t\t\tif (!this.requestHandlers[message.type]) {\n\t\t\t\t\tthis.postResponse(\n\t\t\t\t\t\tcreateErrorResponseMessage(message.requestID, undefined, 501),\n\t\t\t\t\t);\n\t\t\t\t} else {\n\t\t\t\t\ttry {\n\t\t\t\t\t\t// TODO: Figure out why type cannot be inferred on its own anymore\n\t\t\t\t\t\tconst response = await this.requestHandlers[message.type](message, {\n\t\t\t\t\t\t\tsuccess: createSuccessResponseMessage.bind(\n\t\t\t\t\t\t\t\tthis,\n\t\t\t\t\t\t\t\tmessage.requestID,\n\t\t\t\t\t\t\t) as Parameters<\n\t\t\t\t\t\t\t\t(typeof this.requestHandlers)[string]\n\t\t\t\t\t\t\t>[1][\"success\"],\n\t\t\t\t\t\t\terror: createErrorResponseMessage.bind(\n\t\t\t\t\t\t\t\tthis,\n\t\t\t\t\t\t\t\tmessage.requestID,\n\t\t\t\t\t\t\t) as Parameters<\n\t\t\t\t\t\t\t\t(typeof this.requestHandlers)[string]\n\t\t\t\t\t\t\t>[1][\"error\"],\n\t\t\t\t\t\t});\n\n\t\t\t\t\t\tthis.postResponse(response);\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tthis.postResponse(\n\t\t\t\t\t\t\tcreateErrorResponseMessage(message.requestID, error, 500),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tif (!this._pendingRequests.has(message.requestID)) {\n\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t`Unknown request ID received in response: ${JSON.stringify(\n\t\t\t\t\t\t\tmessage,\n\t\t\t\t\t\t)}`,\n\t\t\t\t\t);\n\t\t\t\t} else {\n\t\t\t\t\t// Pending requests are checked in previous statement\n\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n\t\t\t\t\tthis._pendingRequests.get(message.requestID)!(message);\n\t\t\t\t\tthis._pendingRequests.delete(message.requestID);\n\t\t\t\t}\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tif (error instanceof TypeError) {\n\t\t\t\tconsole.warn(error.message);\n\t\t\t} else {\n\t\t\t\t// Should not be possible, but who knows :shrug:\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t}\n\n\tprotected postRequest<\n\t\tTRequest extends UnknownRequestMessage,\n\t\tTResponse extends UnknownResponseMessage,\n\t>(\n\t\trequest: TRequest,\n\t\tpostMessage = (request: TRequest): void => this.port.postMessage(request),\n\t\toptions: PostRequestOptions = {},\n\t): Promise<ExtractSuccessResponseMessage<TResponse>> {\n\t\tif (this.options.debug) {\n\t\t\t// eslint-disable-next-line no-console\n\t\t\tconsole.debug(request);\n\t\t}\n\n\t\tif (this._pendingRequests.size >= this.options.maximumRequestConcurrency) {\n\t\t\tthrow new TooManyConcurrentRequestsError(request);\n\t\t}\n\n\t\treturn new Promise<ExtractSuccessResponseMessage<TResponse>>(\n\t\t\t(resolve, reject) => {\n\t\t\t\tconst requestTimeout = setTimeout(() => {\n\t\t\t\t\tif (this._pendingRequests.has(request.requestID)) {\n\t\t\t\t\t\tthis._pendingRequests.delete(request.requestID);\n\t\t\t\t\t}\n\t\t\t\t\treject(new RequestTimeoutError(request));\n\t\t\t\t}, options.timeout || this.options.defaultTimeout);\n\n\t\t\t\tthis._pendingRequests.set(\n\t\t\t\t\trequest.requestID,\n\t\t\t\t\t(response: TResponse): void => {\n\t\t\t\t\t\tclearTimeout(requestTimeout);\n\n\t\t\t\t\t\tisSuccessResponseMessage(response)\n\t\t\t\t\t\t\t? resolve(response as ExtractSuccessResponseMessage<TResponse>)\n\t\t\t\t\t\t\t: reject(\n\t\t\t\t\t\t\t\t\tnew ResponseError(\n\t\t\t\t\t\t\t\t\t\tresponse as ExtractErrorResponseMessage<TResponse>,\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t  );\n\t\t\t\t\t},\n\t\t\t\t);\n\n\t\t\t\tpostMessage(request);\n\t\t\t},\n\t\t);\n\t}\n\n\tprotected postResponse<TResponse extends UnknownResponseMessage>(\n\t\tresponse: TResponse,\n\t\tpostMessage = (response: TResponse): void =>\n\t\t\tthis.port.postMessage(response),\n\t): TResponse {\n\t\tif (this.options.debug) {\n\t\t\t// eslint-disable-next-line no-console\n\t\t\tconsole.debug(response);\n\t\t}\n\n\t\tpostMessage(response);\n\n\t\treturn response;\n\t}\n}\n"],"names":["PortNotSetError","createRequestMessage","validateMessage","isRequestMessage","createErrorResponseMessage","createSuccessResponseMessage","request","TooManyConcurrentRequestsError","RequestTimeoutError","isSuccessResponseMessage","ResponseError","response"],"mappings":"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"}

package/dist/channel/ChannelNetwork.d.ts

@@ -0,0 +1,24 @@
+import { ExtractSuccessResponseMessage, RequestMessage, TransactionsHandlers, UnknownRequestMessage, UnknownResponseMessage, UnknownTransaction } from "./types";
+export type PostRequestOptions = {
+    timeout?: number;
+};
+export type ChannelNetworkOptions = {
+    debug: boolean;
+    maximumRequestConcurrency: number;
+    defaultTimeout: number;
+    requestIDPrefix: string;
+};
+export declare const channelNetworkDefaultOptions: ChannelNetworkOptions;
+export declare abstract class ChannelNetwork<TPartnerTransactions extends Record<string, UnknownTransaction> = Record<string, never>, TOptions extends Record<string, unknown> = Record<string, unknown>> {
+    requestHandlers: TransactionsHandlers<TPartnerTransactions>;
+    options: ChannelNetworkOptions & TOptions;
+    private _port;
+    protected get port(): MessagePort;
+    protected set port(port: MessagePort | null);
+    private _pendingRequests;
+    constructor(requestHandlers: TransactionsHandlers<TPartnerTransactions>, options: Partial<ChannelNetworkOptions> & TOptions);
+    createRequestMessage<TType extends string = string, TData = undefined>(type: TType, data: TData): RequestMessage<TType, TData>;
+    protected onMessage(event: MessageEvent<unknown>): Promise<void>;
+    protected postRequest<TRequest extends UnknownRequestMessage, TResponse extends UnknownResponseMessage>(request: TRequest, postMessage?: (request: TRequest) => void, options?: PostRequestOptions): Promise<ExtractSuccessResponseMessage<TResponse>>;
+    protected postResponse<TResponse extends UnknownResponseMessage>(response: TResponse, postMessage?: (response: TResponse) => void): TResponse;
+}

package/dist/channel/ChannelNetwork.js

@@ -0,0 +1,112 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+import { PortNotSetError, TooManyConcurrentRequestsError, RequestTimeoutError, ResponseError } from "./errors.js";
+import { createRequestMessage, validateMessage, isRequestMessage, createErrorResponseMessage, createSuccessResponseMessage, isSuccessResponseMessage } from "./messages.js";
+const channelNetworkDefaultOptions = {
+  debug: false,
+  maximumRequestConcurrency: 20,
+  defaultTimeout: 5e3,
+  requestIDPrefix: "channel-"
+};
+class ChannelNetwork {
+  constructor(requestHandlers, options) {
+    __publicField(this, "requestHandlers");
+    __publicField(this, "options");
+    __publicField(this, "_port", null);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    __publicField(this, "_pendingRequests", /* @__PURE__ */ new Map());
+    this.requestHandlers = requestHandlers;
+    this.options = { ...channelNetworkDefaultOptions, ...options };
+  }
+  get port() {
+    if (!this._port) {
+      throw new PortNotSetError();
+    }
+    return this._port;
+  }
+  set port(port) {
+    if (this._port) {
+      this._port.onmessage = null;
+    }
+    this._port = port;
+    if (this._port) {
+      this._port.onmessage = this.onMessage.bind(this);
+    }
+  }
+  createRequestMessage(type, data) {
+    return createRequestMessage(type, data, this.options.requestIDPrefix);
+  }
+  async onMessage(event) {
+    if (this.options.debug) {
+      console.debug(event.data);
+    }
+    try {
+      const message = validateMessage(event.data);
+      if (isRequestMessage(message)) {
+        if (!this.requestHandlers[message.type]) {
+          this.postResponse(createErrorResponseMessage(message.requestID, void 0, 501));
+        } else {
+          try {
+            const response = await this.requestHandlers[message.type](message, {
+              success: createSuccessResponseMessage.bind(this, message.requestID),
+              error: createErrorResponseMessage.bind(this, message.requestID)
+            });
+            this.postResponse(response);
+          } catch (error) {
+            this.postResponse(createErrorResponseMessage(message.requestID, error, 500));
+          }
+        }
+      } else {
+        if (!this._pendingRequests.has(message.requestID)) {
+          console.error(`Unknown request ID received in response: ${JSON.stringify(message)}`);
+        } else {
+          this._pendingRequests.get(message.requestID)(message);
+          this._pendingRequests.delete(message.requestID);
+        }
+      }
+    } catch (error) {
+      if (error instanceof TypeError) {
+        console.warn(error.message);
+      } else {
+        throw error;
+      }
+    }
+  }
+  postRequest(request, postMessage = (request2) => this.port.postMessage(request2), options = {}) {
+    if (this.options.debug) {
+      console.debug(request);
+    }
+    if (this._pendingRequests.size >= this.options.maximumRequestConcurrency) {
+      throw new TooManyConcurrentRequestsError(request);
+    }
+    return new Promise((resolve, reject) => {
+      const requestTimeout = setTimeout(() => {
+        if (this._pendingRequests.has(request.requestID)) {
+          this._pendingRequests.delete(request.requestID);
+        }
+        reject(new RequestTimeoutError(request));
+      }, options.timeout || this.options.defaultTimeout);
+      this._pendingRequests.set(request.requestID, (response) => {
+        clearTimeout(requestTimeout);
+        isSuccessResponseMessage(response) ? resolve(response) : reject(new ResponseError(response));
+      });
+      postMessage(request);
+    });
+  }
+  postResponse(response, postMessage = (response2) => this.port.postMessage(response2)) {
+    if (this.options.debug) {
+      console.debug(response);
+    }
+    postMessage(response);
+    return response;
+  }
+}
+export {
+  ChannelNetwork,
+  channelNetworkDefaultOptions
+};
+//# sourceMappingURL=ChannelNetwork.js.map