adnbn 0.6.0 → 0.7.0

package/dist/message/error.js

@@ -0,0 +1,55 @@
+const build = (name, message, stack) => {
+  return stack ? { name, message, stack } : { name, message };
+};
+const stringify = (error) => {
+  try {
+    return JSON.stringify(error);
+  } catch {
+    return String(error);
+  }
+};
+const constructorFor = (name) => {
+  switch (name) {
+    case "EvalError":
+      return EvalError;
+    case "RangeError":
+      return RangeError;
+    case "ReferenceError":
+      return ReferenceError;
+    case "SyntaxError":
+      return SyntaxError;
+    case "TypeError":
+      return TypeError;
+    case "URIError":
+      return URIError;
+    default:
+      return Error;
+  }
+};
+const serializeError = (error) => {
+  if (error instanceof Error) {
+    return build(error.name, error.message, error.stack);
+  }
+  if (typeof error === "object" && error !== null) {
+    const record = error;
+    const name = typeof record.name === "string" ? record.name : "Error";
+    const message = typeof record.message === "string" ? record.message : stringify(error);
+    const stack = typeof record.stack === "string" ? record.stack : void 0;
+    return build(name, message, stack);
+  }
+  return build("Error", String(error));
+};
+const restoreError = (error) => {
+  const ErrorConstructor = constructorFor((error == null ? void 0 : error.name) ?? "Error");
+  const restored = new ErrorConstructor((error == null ? void 0 : error.message) ?? "Request failed.");
+  restored.name = (error == null ? void 0 : error.name) || "Error";
+  if (error == null ? void 0 : error.stack) {
+    restored.stack = error.stack;
+  }
+  return restored;
+};
+export {
+  restoreError,
+  serializeError
+};
+//# sourceMappingURL=error.js.map

package/dist/message/error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/message/error.ts"],"sourcesContent":["import {MessageError} from \"@typing/message\";\n\nconst build = (name: string, message: string, stack?: string): MessageError => {\n    return stack ? {name, message, stack} : {name, message};\n};\n\nconst stringify = (error: object): string => {\n    try {\n        return JSON.stringify(error);\n    } catch {\n        return String(error);\n    }\n};\n\nconst constructorFor = (name: string): new (message?: string) => Error => {\n    switch (name) {\n        case \"EvalError\":\n            return EvalError;\n        case \"RangeError\":\n            return RangeError;\n        case \"ReferenceError\":\n            return ReferenceError;\n        case \"SyntaxError\":\n            return SyntaxError;\n        case \"TypeError\":\n            return TypeError;\n        case \"URIError\":\n            return URIError;\n        default:\n            return Error;\n    }\n};\n\n/**\n * Convert any thrown value into a transferable {@link MessageError} envelope. Handles real\n * `Error` instances, error-like objects, and primitives (JSON-stringifying objects when no\n * `message` is present). The standard serialize step for every cross-context transport.\n */\nexport const serializeError = (error: unknown): MessageError => {\n    if (error instanceof Error) {\n        return build(error.name, error.message, error.stack);\n    }\n\n    if (typeof error === \"object\" && error !== null) {\n        const record = error as Record<string, unknown>;\n        const name = typeof record.name === \"string\" ? record.name : \"Error\";\n        const message = typeof record.message === \"string\" ? record.message : stringify(error);\n        const stack = typeof record.stack === \"string\" ? record.stack : undefined;\n\n        return build(name, message, stack);\n    }\n\n    return build(\"Error\", String(error));\n};\n\n/**\n * Reconstruct an `Error` from a {@link MessageError} envelope, mapping the serialized `name`\n * back to its native constructor (so `instanceof TypeError` survives the boundary).\n */\nexport const restoreError = (error?: MessageError): Error => {\n    const ErrorConstructor = constructorFor(error?.name ?? \"Error\");\n    const restored = new ErrorConstructor(error?.message ?? \"Request failed.\");\n\n    restored.name = error?.name || \"Error\";\n\n    if (error?.stack) {\n        restored.stack = error.stack;\n    }\n\n    return restored;\n};\n"],"mappings":"AAEA,MAAM,QAAQ,CAAC,MAAc,SAAiB,UAAiC;AAC3E,SAAO,QAAQ,EAAC,MAAM,SAAS,MAAK,IAAI,EAAC,MAAM,QAAO;AAC1D;AAEA,MAAM,YAAY,CAAC,UAA0B;AACzC,MAAI;AACA,WAAO,KAAK,UAAU,KAAK;AAAA,EAC/B,QAAQ;AACJ,WAAO,OAAO,KAAK;AAAA,EACvB;AACJ;AAEA,MAAM,iBAAiB,CAAC,SAAkD;AACtE,UAAQ,MAAM;AAAA,IACV,KAAK;AACD,aAAO;AAAA,IACX,KAAK;AACD,aAAO;AAAA,IACX,KAAK;AACD,aAAO;AAAA,IACX,KAAK;AACD,aAAO;AAAA,IACX,KAAK;AACD,aAAO;AAAA,IACX,KAAK;AACD,aAAO;AAAA,IACX;AACI,aAAO;AAAA,EACf;AACJ;AAOO,MAAM,iBAAiB,CAAC,UAAiC;AAC5D,MAAI,iBAAiB,OAAO;AACxB,WAAO,MAAM,MAAM,MAAM,MAAM,SAAS,MAAM,KAAK;AAAA,EACvD;AAEA,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC7C,UAAM,SAAS;AACf,UAAM,OAAO,OAAO,OAAO,SAAS,WAAW,OAAO,OAAO;AAC7D,UAAM,UAAU,OAAO,OAAO,YAAY,WAAW,OAAO,UAAU,UAAU,KAAK;AACrF,UAAM,QAAQ,OAAO,OAAO,UAAU,WAAW,OAAO,QAAQ;AAEhE,WAAO,MAAM,MAAM,SAAS,KAAK;AAAA,EACrC;AAEA,SAAO,MAAM,SAAS,OAAO,KAAK,CAAC;AACvC;AAMO,MAAM,eAAe,CAAC,UAAgC;AACzD,QAAM,mBAAmB,gBAAe,+BAAO,SAAQ,OAAO;AAC9D,QAAM,WAAW,IAAI,kBAAiB,+BAAO,YAAW,iBAAiB;AAEzE,WAAS,QAAO,+BAAO,SAAQ;AAE/B,MAAI,+BAAO,OAAO;AACd,aAAS,QAAQ,MAAM;AAAA,EAC3B;AAEA,SAAO;AACX;","names":[]}

package/dist/message/providers/Message.d.ts

@@ -6,5 +6,10 @@ export default class Message<T extends MessageDictionary> extends AbstractMessag
     static getInstance<T extends MessageDictionary>(): Message<MessageDictionary>;
     protected get manager(): MessageManager<T>;
     send<K extends MessageType<T>>(type: K, data: MessageData<T, K>, options?: MessageSendOptions): Promise<MessageResponse<T, K>>;
+    private dispatch;
+    private unwrap;
+    private isMessageResult;
+    private isSerializedError;
+    private isRecord;
     watch<K extends MessageType<T>>(arg1: K | MessageMapHandler<T> | MessageGeneralHandler<T, K>, arg2?: MessageTargetHandler<T, K>): () => void;
 }

package/dist/message/providers/Message.js

@@ -1,5 +1,9 @@
 import { sendMessage, sendTabMessage } from "@addon-core/browser";
+import { restoreError } from "../error.js";
 import { isBrowser } from "./../../main/env.js";
+import {
+  MessageResultEnvelopeProperty
+} from "./../../types/message.js";
 import { Browser } from "./../../types/browser.js";
 import AbstractMessage from "./AbstractMessage.js";
 import MessageManager from "../MessageManager.js";
@@ -12,19 +16,47 @@ class Message extends AbstractMessage {
   get manager() {
     return MessageManager.getInstance();
   }
-  send(type, data, options) {
+  async send(type, data, options) {
     const message = this.buildMessage(type, data);
-    if (options) {
-      if (typeof options === "number") {
-        return sendTabMessage(options, message);
-      }
-      const { tabId, ...other } = options;
-      if (isBrowser(Browser.Firefox)) {
-        delete other.documentId;
-      }
-      return sendTabMessage(tabId, message, other);
-    }
-    return sendMessage(message);
+    const response = await this.dispatch(message, options);
+    return this.unwrap(response);
+  }
+  dispatch(message, options) {
+    if (options === void 0) {
+      return sendMessage(message);
+    }
+    if (typeof options === "number") {
+      return sendTabMessage(options, message);
+    }
+    const { tabId, ...other } = options;
+    if (isBrowser(Browser.Firefox)) {
+      delete other.documentId;
+    }
+    return sendTabMessage(tabId, message, other);
+  }
+  unwrap(response) {
+    if (!this.isMessageResult(response)) {
+      return response;
+    }
+    if (response.ok) {
+      return response.payload;
+    }
+    throw restoreError(response.error);
+  }
+  isMessageResult(response) {
+    if (!this.isRecord(response) || response[MessageResultEnvelopeProperty] !== true || typeof response.ok !== "boolean") {
+      return false;
+    }
+    if (response.ok) {
+      return "payload" in response;
+    }
+    return this.isSerializedError(response.error);
+  }
+  isSerializedError(error) {
+    return this.isRecord(error) && typeof error.name === "string" && typeof error.message === "string" && (error.stack === void 0 || typeof error.stack === "string");
+  }
+  isRecord(value) {
+    return typeof value === "object" && value !== null;
   }
   watch(arg1, arg2) {
     let handler;

package/dist/message/providers/Message.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/message/providers/Message.ts"],"sourcesContent":["import {sendMessage, sendTabMessage} from \"@addon-core/browser\";\n\nimport {isBrowser} from \"@main/env\";\n\nimport {\n    MessageData,\n    MessageDictionary,\n    MessageGeneralHandler,\n    MessageHandler,\n    MessageMapHandler,\n    MessageResponse,\n    MessageSendOptions,\n    MessageTargetHandler,\n    MessageType,\n} from \"@typing/message\";\nimport {Browser} from \"@typing/browser\";\n\nimport AbstractMessage from \"./AbstractMessage\";\nimport MessageManager from \"../MessageManager\";\n\nimport {GeneralHandler, MapHandler, SingleHandler} from \"../handlers\";\n\nexport default class Message<T extends MessageDictionary> extends AbstractMessage<T, MessageSendOptions> {\n    private static instance: Message<MessageDictionary> | null = null;\n\n    public static getInstance<T extends MessageDictionary>() {\n        return (this.instance ??= new Message<T>());\n    }\n\n    protected get manager(): MessageManager<T> {\n        return MessageManager.getInstance<T>();\n    }\n\n    public send<K extends MessageType<T>>(\n        type: K,\n        data: MessageData<T, K>,\n        options?: MessageSendOptions\n    ): Promise<MessageResponse<T, K>> {\n        const message = this.buildMessage(type, data);\n\n        if (options) {\n            if (typeof options === \"number\") {\n                return sendTabMessage(options, message);\n            }\n\n            const {tabId, ...other} = options;\n\n            if (isBrowser(Browser.Firefox)) {\n                delete other.documentId;\n            }\n\n            return sendTabMessage(tabId, message, other);\n        }\n\n        return sendMessage(message);\n    }\n\n    public watch<K extends MessageType<T>>(\n        arg1: K | MessageMapHandler<T> | MessageGeneralHandler<T, K>,\n        arg2?: MessageTargetHandler<T, K>\n    ): () => void {\n        let handler: MessageHandler<T>;\n\n        if (typeof arg1 === \"function\") {\n            handler = new GeneralHandler<T, K>(arg1);\n        } else if (typeof arg1 === \"object\" && arg2 === undefined) {\n            handler = new MapHandler<T>(arg1);\n        } else if (typeof arg1 === \"string\" && arg2) {\n            handler = new SingleHandler<T>(arg1, arg2);\n        } else {\n            throw new Error(\"Invalid arguments passed to watch()\");\n        }\n\n        this.manager.add(handler);\n\n        return () => this.manager.remove(handler);\n    }\n}\n"],"mappings":"AAAA,SAAQ,aAAa,sBAAqB;AAE1C,SAAQ,iBAAgB;AAaxB,SAAQ,eAAc;AAEtB,OAAO,qBAAqB;AAC5B,OAAO,oBAAoB;AAE3B,SAAQ,gBAAgB,YAAY,qBAAoB;AAExD,MAAO,gBAA2D,gBAAuC;AAAA,EACrG,OAAe,WAA8C;AAAA,EAE7D,OAAc,cAA2C;AACrD,WAAQ,KAAK,aAAL,KAAK,WAAa,IAAI,QAAW;AAAA,EAC7C;AAAA,EAEA,IAAc,UAA6B;AACvC,WAAO,eAAe,YAAe;AAAA,EACzC;AAAA,EAEO,KACH,MACA,MACA,SAC8B;AAC9B,UAAM,UAAU,KAAK,aAAa,MAAM,IAAI;AAE5C,QAAI,SAAS;AACT,UAAI,OAAO,YAAY,UAAU;AAC7B,eAAO,eAAe,SAAS,OAAO;AAAA,MAC1C;AAEA,YAAM,EAAC,OAAO,GAAG,MAAK,IAAI;AAE1B,UAAI,UAAU,QAAQ,OAAO,GAAG;AAC5B,eAAO,MAAM;AAAA,MACjB;AAEA,aAAO,eAAe,OAAO,SAAS,KAAK;AAAA,IAC/C;AAEA,WAAO,YAAY,OAAO;AAAA,EAC9B;AAAA,EAEO,MACH,MACA,MACU;AACV,QAAI;AAEJ,QAAI,OAAO,SAAS,YAAY;AAC5B,gBAAU,IAAI,eAAqB,IAAI;AAAA,IAC3C,WAAW,OAAO,SAAS,YAAY,SAAS,QAAW;AACvD,gBAAU,IAAI,WAAc,IAAI;AAAA,IACpC,WAAW,OAAO,SAAS,YAAY,MAAM;AACzC,gBAAU,IAAI,cAAiB,MAAM,IAAI;AAAA,IAC7C,OAAO;AACH,YAAM,IAAI,MAAM,qCAAqC;AAAA,IACzD;AAEA,SAAK,QAAQ,IAAI,OAAO;AAExB,WAAO,MAAM,KAAK,QAAQ,OAAO,OAAO;AAAA,EAC5C;AACJ;","names":[]}
+{"version":3,"sources":["../../../src/message/providers/Message.ts"],"sourcesContent":["import {sendMessage, sendTabMessage} from \"@addon-core/browser\";\n\nimport {restoreError} from \"../error\";\n\nimport {isBrowser} from \"@main/env\";\n\nimport {\n    MessageBody,\n    MessageData,\n    MessageDictionary,\n    MessageError,\n    MessageGeneralHandler,\n    MessageHandler,\n    MessageMapHandler,\n    MessageResult,\n    MessageResultEnvelopeProperty,\n    MessageResponse,\n    MessageSendOptions,\n    MessageTargetHandler,\n    MessageType,\n} from \"@typing/message\";\nimport {Browser} from \"@typing/browser\";\n\nimport AbstractMessage from \"./AbstractMessage\";\nimport MessageManager from \"../MessageManager\";\n\nimport {GeneralHandler, MapHandler, SingleHandler} from \"../handlers\";\n\nexport default class Message<T extends MessageDictionary> extends AbstractMessage<T, MessageSendOptions> {\n    private static instance: Message<MessageDictionary> | null = null;\n\n    public static getInstance<T extends MessageDictionary>() {\n        return (this.instance ??= new Message<T>());\n    }\n\n    protected get manager(): MessageManager<T> {\n        return MessageManager.getInstance<T>();\n    }\n\n    public async send<K extends MessageType<T>>(\n        type: K,\n        data: MessageData<T, K>,\n        options?: MessageSendOptions\n    ): Promise<MessageResponse<T, K>> {\n        const message = this.buildMessage(type, data);\n        const response = await this.dispatch(message, options);\n\n        return this.unwrap(response);\n    }\n\n    private dispatch<K extends MessageType<T>>(\n        message: MessageBody<T, K>,\n        options?: MessageSendOptions\n    ): Promise<MessageResult<MessageResponse<T, K>> | MessageResponse<T, K> | undefined> {\n        if (options === undefined) {\n            return sendMessage(message);\n        }\n\n        if (typeof options === \"number\") {\n            return sendTabMessage(options, message);\n        }\n\n        const {tabId, ...other} = options;\n\n        if (isBrowser(Browser.Firefox)) {\n            delete other.documentId;\n        }\n\n        return sendTabMessage(tabId, message, other);\n    }\n\n    private unwrap<K extends MessageType<T>>(\n        response: MessageResult<MessageResponse<T, K>> | MessageResponse<T, K> | undefined\n    ): MessageResponse<T, K> {\n        if (!this.isMessageResult(response)) {\n            return response as MessageResponse<T, K>;\n        }\n\n        if (response.ok) {\n            return response.payload;\n        }\n\n        throw restoreError(response.error);\n    }\n\n    private isMessageResult(response: unknown): response is MessageResult {\n        if (\n            !this.isRecord(response) ||\n            response[MessageResultEnvelopeProperty] !== true ||\n            typeof response.ok !== \"boolean\"\n        ) {\n            return false;\n        }\n\n        if (response.ok) {\n            return \"payload\" in response;\n        }\n\n        return this.isSerializedError(response.error);\n    }\n\n    private isSerializedError(error: unknown): error is MessageError {\n        return (\n            this.isRecord(error) &&\n            typeof error.name === \"string\" &&\n            typeof error.message === \"string\" &&\n            (error.stack === undefined || typeof error.stack === \"string\")\n        );\n    }\n\n    private isRecord(value: unknown): value is Record<string, unknown> {\n        return typeof value === \"object\" && value !== null;\n    }\n\n    public watch<K extends MessageType<T>>(\n        arg1: K | MessageMapHandler<T> | MessageGeneralHandler<T, K>,\n        arg2?: MessageTargetHandler<T, K>\n    ): () => void {\n        let handler: MessageHandler<T>;\n\n        if (typeof arg1 === \"function\") {\n            handler = new GeneralHandler<T, K>(arg1);\n        } else if (typeof arg1 === \"object\" && arg2 === undefined) {\n            handler = new MapHandler<T>(arg1);\n        } else if (typeof arg1 === \"string\" && arg2) {\n            handler = new SingleHandler<T>(arg1, arg2);\n        } else {\n            throw new Error(\"Invalid arguments passed to watch()\");\n        }\n\n        this.manager.add(handler);\n\n        return () => this.manager.remove(handler);\n    }\n}\n"],"mappings":"AAAA,SAAQ,aAAa,sBAAqB;AAE1C,SAAQ,oBAAmB;AAE3B,SAAQ,iBAAgB;AAExB;AAAA,EASI;AAAA,OAKG;AACP,SAAQ,eAAc;AAEtB,OAAO,qBAAqB;AAC5B,OAAO,oBAAoB;AAE3B,SAAQ,gBAAgB,YAAY,qBAAoB;AAExD,MAAO,gBAA2D,gBAAuC;AAAA,EACrG,OAAe,WAA8C;AAAA,EAE7D,OAAc,cAA2C;AACrD,WAAQ,KAAK,aAAL,KAAK,WAAa,IAAI,QAAW;AAAA,EAC7C;AAAA,EAEA,IAAc,UAA6B;AACvC,WAAO,eAAe,YAAe;AAAA,EACzC;AAAA,EAEA,MAAa,KACT,MACA,MACA,SAC8B;AAC9B,UAAM,UAAU,KAAK,aAAa,MAAM,IAAI;AAC5C,UAAM,WAAW,MAAM,KAAK,SAAS,SAAS,OAAO;AAErD,WAAO,KAAK,OAAO,QAAQ;AAAA,EAC/B;AAAA,EAEQ,SACJ,SACA,SACiF;AACjF,QAAI,YAAY,QAAW;AACvB,aAAO,YAAY,OAAO;AAAA,IAC9B;AAEA,QAAI,OAAO,YAAY,UAAU;AAC7B,aAAO,eAAe,SAAS,OAAO;AAAA,IAC1C;AAEA,UAAM,EAAC,OAAO,GAAG,MAAK,IAAI;AAE1B,QAAI,UAAU,QAAQ,OAAO,GAAG;AAC5B,aAAO,MAAM;AAAA,IACjB;AAEA,WAAO,eAAe,OAAO,SAAS,KAAK;AAAA,EAC/C;AAAA,EAEQ,OACJ,UACqB;AACrB,QAAI,CAAC,KAAK,gBAAgB,QAAQ,GAAG;AACjC,aAAO;AAAA,IACX;AAEA,QAAI,SAAS,IAAI;AACb,aAAO,SAAS;AAAA,IACpB;AAEA,UAAM,aAAa,SAAS,KAAK;AAAA,EACrC;AAAA,EAEQ,gBAAgB,UAA8C;AAClE,QACI,CAAC,KAAK,SAAS,QAAQ,KACvB,SAAS,6BAA6B,MAAM,QAC5C,OAAO,SAAS,OAAO,WACzB;AACE,aAAO;AAAA,IACX;AAEA,QAAI,SAAS,IAAI;AACb,aAAO,aAAa;AAAA,IACxB;AAEA,WAAO,KAAK,kBAAkB,SAAS,KAAK;AAAA,EAChD;AAAA,EAEQ,kBAAkB,OAAuC;AAC7D,WACI,KAAK,SAAS,KAAK,KACnB,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,YAAY,aACxB,MAAM,UAAU,UAAa,OAAO,MAAM,UAAU;AAAA,EAE7D;AAAA,EAEQ,SAAS,OAAkD;AAC/D,WAAO,OAAO,UAAU,YAAY,UAAU;AAAA,EAClD;AAAA,EAEO,MACH,MACA,MACU;AACV,QAAI;AAEJ,QAAI,OAAO,SAAS,YAAY;AAC5B,gBAAU,IAAI,eAAqB,IAAI;AAAA,IAC3C,WAAW,OAAO,SAAS,YAAY,SAAS,QAAW;AACvD,gBAAU,IAAI,WAAc,IAAI;AAAA,IACpC,WAAW,OAAO,SAAS,YAAY,MAAM;AACzC,gBAAU,IAAI,cAAiB,MAAM,IAAI;AAAA,IAC7C,OAAO;AACH,YAAM,IAAI,MAAM,qCAAqC;AAAA,IACzD;AAEA,SAAK,QAAQ,IAAI,OAAO;AAExB,WAAO,MAAM,KAAK,QAAQ,OAAO,OAAO;AAAA,EAC5C;AACJ;","names":[]}

package/dist/offscreen/OffscreenBridge.d.ts

@@ -4,13 +4,11 @@ export default class OffscreenBridge {
     protected readonly key: string;
     protected readonly message: Message<import("../message/index.js").MessageDictionary>;
     protected readonly readyTimeout = 10000;
-    private readonly framesReady;
+    private readonly frames;
     private static instance?;
     static getInstance(): OffscreenBridge;
     static createOffscreen(parameters: CreateParameters): Promise<void>;
     create(parameters: CreateParameters): Promise<any>;
     protected apply({ url }: CreateParameters): Promise<void>;
-    private createFrame;
-    private getFrame;
 }
 export {};

package/dist/offscreen/OffscreenBridge.js

@@ -1,11 +1,12 @@
 import { isBackground } from "@addon-core/browser";
 import { Message } from "./../message/providers/index.js";
+import { ReadyFrame } from "./../frame/index.js";
 import { OffscreenBridgeReadyMessageType } from "./../types/offscreen.js";
 class OffscreenBridge {
   key = "offscreen-background";
   message = new Message();
   readyTimeout = 1e4;
-  framesReady = /* @__PURE__ */ new Map();
+  frames = new ReadyFrame();
   static instance;
   static getInstance() {
     return OffscreenBridge.instance ?? (OffscreenBridge.instance = new OffscreenBridge());
@@ -20,64 +21,19 @@ class OffscreenBridge {
     }
     await this.message.send(this.key, parameters);
   }
-  apply({ url }) {
-    const ready = this.framesReady.get(url);
-    if (ready) {
-      return ready;
-    }
-    const existing = this.getFrame(url);
-    if ((existing == null ? void 0 : existing.dataset.ready) === "true") {
-      return Promise.resolve();
-    }
-    const creation = this.createFrame(url, existing).finally(() => {
-      this.framesReady.delete(url);
-    });
-    this.framesReady.set(url, creation);
-    return creation;
-  }
-  createFrame(url, existing) {
-    return new Promise((resolve, reject) => {
-      const iframe = existing ?? document.createElement("iframe");
-      const cleanup = () => {
-        clearTimeout(timeout);
-        window.removeEventListener("message", listener);
-        iframe.onerror = null;
-      };
-      const listener = (event) => {
+  async apply({ url }) {
+    await this.frames.make({
+      key: url,
+      url,
+      readyTimeout: this.readyTimeout,
+      isReady: (event, frame) => {
         var _a;
-        if (event.source !== iframe.contentWindow) {
-          return;
-        }
-        if (event.origin !== location.origin) {
-          return;
-        }
-        if (((_a = event.data) == null ? void 0 : _a.type) !== OffscreenBridgeReadyMessageType) {
-          return;
-        }
-        iframe.dataset.ready = "true";
-        cleanup();
-        resolve();
-      };
-      const timeout = setTimeout(() => {
-        cleanup();
-        iframe.remove();
-        reject(new Error(`Offscreen iframe "${url}" was not ready in time.`));
-      }, this.readyTimeout);
-      iframe.onerror = () => {
-        cleanup();
-        iframe.remove();
-        reject(new Error(`Offscreen iframe failed to load: ${url}`));
-      };
-      window.addEventListener("message", listener);
-      if (!existing) {
-        iframe.src = url;
-        document.body.appendChild(iframe);
-      }
+        return event.source === frame.contentWindow && event.origin === location.origin && ((_a = event.data) == null ? void 0 : _a.type) === OffscreenBridgeReadyMessageType;
+      },
+      readyTimeoutMessage: () => `Offscreen iframe "${url}" was not ready in time.`,
+      loadErrorMessage: () => `Offscreen iframe failed to load: ${url}`
     });
   }
-  getFrame(url) {
-    return Array.from(document.querySelectorAll("iframe")).find((iframe) => iframe.getAttribute("src") === url);
-  }
 }
 export {
   OffscreenBridge as default

package/dist/offscreen/OffscreenBridge.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/offscreen/OffscreenBridge.ts"],"sourcesContent":["import {isBackground} from \"@addon-core/browser\";\n\nimport {Message} from \"@message/providers\";\n\nimport {OffscreenBridgeReadyMessageType} from \"@typing/offscreen\";\n\ntype CreateParameters = chrome.offscreen.CreateParameters;\n\nexport default class OffscreenBridge {\n    protected readonly key: string = \"offscreen-background\";\n\n    protected readonly message = new Message();\n\n    protected readonly readyTimeout = 10000;\n\n    private readonly framesReady: Map<string, Promise<void>> = new Map();\n\n    private static instance?: OffscreenBridge;\n\n    public static getInstance(): OffscreenBridge {\n        return (OffscreenBridge.instance ??= new OffscreenBridge());\n    }\n\n    public static async createOffscreen(parameters: CreateParameters): Promise<void> {\n        return OffscreenBridge.getInstance().create(parameters);\n    }\n\n    public async create(parameters: CreateParameters): Promise<any> {\n        if (isBackground()) {\n            await this.apply(parameters);\n\n            return;\n        }\n\n        await this.message.send(this.key, parameters);\n    }\n\n    protected apply({url}: CreateParameters): Promise<void> {\n        const ready = this.framesReady.get(url);\n\n        if (ready) {\n            return ready;\n        }\n\n        const existing = this.getFrame(url);\n\n        if (existing?.dataset.ready === \"true\") {\n            return Promise.resolve();\n        }\n\n        const creation = this.createFrame(url, existing).finally(() => {\n            this.framesReady.delete(url);\n        });\n\n        this.framesReady.set(url, creation);\n\n        return creation;\n    }\n\n    private createFrame(url: string, existing?: HTMLIFrameElement): Promise<void> {\n        return new Promise<void>((resolve, reject) => {\n            const iframe = existing ?? document.createElement(\"iframe\");\n\n            const cleanup = () => {\n                clearTimeout(timeout);\n                window.removeEventListener(\"message\", listener);\n                iframe.onerror = null;\n            };\n\n            const listener = (event: MessageEvent) => {\n                if (event.source !== iframe.contentWindow) {\n                    return;\n                }\n\n                if (event.origin !== location.origin) {\n                    return;\n                }\n\n                if (event.data?.type !== OffscreenBridgeReadyMessageType) {\n                    return;\n                }\n\n                iframe.dataset.ready = \"true\";\n\n                cleanup();\n                resolve();\n            };\n\n            const timeout = setTimeout(() => {\n                cleanup();\n                iframe.remove();\n\n                reject(new Error(`Offscreen iframe \"${url}\" was not ready in time.`));\n            }, this.readyTimeout);\n\n            iframe.onerror = () => {\n                cleanup();\n                iframe.remove();\n                reject(new Error(`Offscreen iframe failed to load: ${url}`));\n            };\n\n            window.addEventListener(\"message\", listener);\n\n            if (!existing) {\n                iframe.src = url;\n                document.body.appendChild(iframe);\n            }\n        });\n    }\n\n    private getFrame(url: string): HTMLIFrameElement | undefined {\n        return Array.from(document.querySelectorAll(\"iframe\")).find(iframe => iframe.getAttribute(\"src\") === url);\n    }\n}\n"],"mappings":"AAAA,SAAQ,oBAAmB;AAE3B,SAAQ,eAAc;AAEtB,SAAQ,uCAAsC;AAI9C,MAAO,gBAA8B;AAAA,EACd,MAAc;AAAA,EAEd,UAAU,IAAI,QAAQ;AAAA,EAEtB,eAAe;AAAA,EAEjB,cAA0C,oBAAI,IAAI;AAAA,EAEnE,OAAe;AAAA,EAEf,OAAc,cAA+B;AACzC,WAAQ,gBAAgB,aAAhB,gBAAgB,WAAa,IAAI,gBAAgB;AAAA,EAC7D;AAAA,EAEA,aAAoB,gBAAgB,YAA6C;AAC7E,WAAO,gBAAgB,YAAY,EAAE,OAAO,UAAU;AAAA,EAC1D;AAAA,EAEA,MAAa,OAAO,YAA4C;AAC5D,QAAI,aAAa,GAAG;AAChB,YAAM,KAAK,MAAM,UAAU;AAE3B;AAAA,IACJ;AAEA,UAAM,KAAK,QAAQ,KAAK,KAAK,KAAK,UAAU;AAAA,EAChD;AAAA,EAEU,MAAM,EAAC,IAAG,GAAoC;AACpD,UAAM,QAAQ,KAAK,YAAY,IAAI,GAAG;AAEtC,QAAI,OAAO;AACP,aAAO;AAAA,IACX;AAEA,UAAM,WAAW,KAAK,SAAS,GAAG;AAElC,SAAI,qCAAU,QAAQ,WAAU,QAAQ;AACpC,aAAO,QAAQ,QAAQ;AAAA,IAC3B;AAEA,UAAM,WAAW,KAAK,YAAY,KAAK,QAAQ,EAAE,QAAQ,MAAM;AAC3D,WAAK,YAAY,OAAO,GAAG;AAAA,IAC/B,CAAC;AAED,SAAK,YAAY,IAAI,KAAK,QAAQ;AAElC,WAAO;AAAA,EACX;AAAA,EAEQ,YAAY,KAAa,UAA6C;AAC1E,WAAO,IAAI,QAAc,CAAC,SAAS,WAAW;AAC1C,YAAM,SAAS,YAAY,SAAS,cAAc,QAAQ;AAE1D,YAAM,UAAU,MAAM;AAClB,qBAAa,OAAO;AACpB,eAAO,oBAAoB,WAAW,QAAQ;AAC9C,eAAO,UAAU;AAAA,MACrB;AAEA,YAAM,WAAW,CAAC,UAAwB;AArEtD;AAsEgB,YAAI,MAAM,WAAW,OAAO,eAAe;AACvC;AAAA,QACJ;AAEA,YAAI,MAAM,WAAW,SAAS,QAAQ;AAClC;AAAA,QACJ;AAEA,cAAI,WAAM,SAAN,mBAAY,UAAS,iCAAiC;AACtD;AAAA,QACJ;AAEA,eAAO,QAAQ,QAAQ;AAEvB,gBAAQ;AACR,gBAAQ;AAAA,MACZ;AAEA,YAAM,UAAU,WAAW,MAAM;AAC7B,gBAAQ;AACR,eAAO,OAAO;AAEd,eAAO,IAAI,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAAA,MACxE,GAAG,KAAK,YAAY;AAEpB,aAAO,UAAU,MAAM;AACnB,gBAAQ;AACR,eAAO,OAAO;AACd,eAAO,IAAI,MAAM,oCAAoC,GAAG,EAAE,CAAC;AAAA,MAC/D;AAEA,aAAO,iBAAiB,WAAW,QAAQ;AAE3C,UAAI,CAAC,UAAU;AACX,eAAO,MAAM;AACb,iBAAS,KAAK,YAAY,MAAM;AAAA,MACpC;AAAA,IACJ,CAAC;AAAA,EACL;AAAA,EAEQ,SAAS,KAA4C;AACzD,WAAO,MAAM,KAAK,SAAS,iBAAiB,QAAQ,CAAC,EAAE,KAAK,YAAU,OAAO,aAAa,KAAK,MAAM,GAAG;AAAA,EAC5G;AACJ;","names":[]}
+{"version":3,"sources":["../../src/offscreen/OffscreenBridge.ts"],"sourcesContent":["import {isBackground} from \"@addon-core/browser\";\n\nimport {Message} from \"@message/providers\";\nimport {ReadyFrame} from \"@frame/index\";\n\nimport {OffscreenBridgeReadyMessageType} from \"@typing/offscreen\";\n\ntype CreateParameters = chrome.offscreen.CreateParameters;\n\nexport default class OffscreenBridge {\n    protected readonly key: string = \"offscreen-background\";\n\n    protected readonly message = new Message();\n\n    protected readonly readyTimeout = 10000;\n\n    private readonly frames = new ReadyFrame();\n\n    private static instance?: OffscreenBridge;\n\n    public static getInstance(): OffscreenBridge {\n        return (OffscreenBridge.instance ??= new OffscreenBridge());\n    }\n\n    public static async createOffscreen(parameters: CreateParameters): Promise<void> {\n        return OffscreenBridge.getInstance().create(parameters);\n    }\n\n    public async create(parameters: CreateParameters): Promise<any> {\n        if (isBackground()) {\n            await this.apply(parameters);\n\n            return;\n        }\n\n        await this.message.send(this.key, parameters);\n    }\n\n    protected async apply({url}: CreateParameters): Promise<void> {\n        await this.frames.make({\n            key: url,\n            url,\n            readyTimeout: this.readyTimeout,\n            isReady: (event, frame) =>\n                event.source === frame.contentWindow &&\n                event.origin === location.origin &&\n                event.data?.type === OffscreenBridgeReadyMessageType,\n            readyTimeoutMessage: () => `Offscreen iframe \"${url}\" was not ready in time.`,\n            loadErrorMessage: () => `Offscreen iframe failed to load: ${url}`,\n        });\n    }\n}\n"],"mappings":"AAAA,SAAQ,oBAAmB;AAE3B,SAAQ,eAAc;AACtB,SAAQ,kBAAiB;AAEzB,SAAQ,uCAAsC;AAI9C,MAAO,gBAA8B;AAAA,EACd,MAAc;AAAA,EAEd,UAAU,IAAI,QAAQ;AAAA,EAEtB,eAAe;AAAA,EAEjB,SAAS,IAAI,WAAW;AAAA,EAEzC,OAAe;AAAA,EAEf,OAAc,cAA+B;AACzC,WAAQ,gBAAgB,aAAhB,gBAAgB,WAAa,IAAI,gBAAgB;AAAA,EAC7D;AAAA,EAEA,aAAoB,gBAAgB,YAA6C;AAC7E,WAAO,gBAAgB,YAAY,EAAE,OAAO,UAAU;AAAA,EAC1D;AAAA,EAEA,MAAa,OAAO,YAA4C;AAC5D,QAAI,aAAa,GAAG;AAChB,YAAM,KAAK,MAAM,UAAU;AAE3B;AAAA,IACJ;AAEA,UAAM,KAAK,QAAQ,KAAK,KAAK,KAAK,UAAU;AAAA,EAChD;AAAA,EAEA,MAAgB,MAAM,EAAC,IAAG,GAAoC;AAC1D,UAAM,KAAK,OAAO,KAAK;AAAA,MACnB,KAAK;AAAA,MACL;AAAA,MACA,cAAc,KAAK;AAAA,MACnB,SAAS,CAAC,OAAO,UAAO;AA3CpC;AA4CgB,qBAAM,WAAW,MAAM,iBACvB,MAAM,WAAW,SAAS,YAC1B,WAAM,SAAN,mBAAY,UAAS;AAAA;AAAA,MACzB,qBAAqB,MAAM,qBAAqB,GAAG;AAAA,MACnD,kBAAkB,MAAM,oCAAoC,GAAG;AAAA,IACnE,CAAC;AAAA,EACL;AACJ;","names":[]}

package/dist/offscreen/index.d.ts

@@ -1,5 +1,10 @@
 import { ProxyOffscreen, RegisterOffscreen } from "./providers/index.js";
 import OffscreenBackground from "./OffscreenBackground.js";
-import { TransportDictionary, TransportName, TransportProxyTarget as OffscreenProxyTarget, TransportTarget as OffscreenTarget } from "../types/transport.js";
-export { type OffscreenTarget, type OffscreenProxyTarget, ProxyOffscreen, RegisterOffscreen, OffscreenBackground };
-export declare const getOffscreen: <N extends TransportName>(name: N) => TransportDictionary[N];
+import type { TransportProxyTarget, TransportTarget } from "../transport/index.js";
+export { ProxyOffscreen, RegisterOffscreen, OffscreenBackground };
+export interface OffscreenRegistry {
+}
+export type OffscreenName = Extract<keyof OffscreenRegistry, string>;
+export type OffscreenTarget<N extends keyof OffscreenRegistry> = TransportTarget<OffscreenRegistry, N>;
+export type OffscreenProxyTarget<N extends keyof OffscreenRegistry> = TransportProxyTarget<OffscreenRegistry, N>;
+export declare const getOffscreen: <N extends OffscreenName>(name: N) => OffscreenTarget<N>;

package/dist/offscreen/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/offscreen/index.ts"],"sourcesContent":["import {Offscreen, ProxyOffscreen, RegisterOffscreen} from \"./providers\";\nimport OffscreenBackground from \"./OffscreenBackground\";\n\nimport {\n    TransportDictionary,\n    TransportName,\n    TransportProxyTarget as OffscreenProxyTarget,\n    TransportTarget as OffscreenTarget,\n} from \"@typing/transport\";\n\nexport {type OffscreenTarget, type OffscreenProxyTarget, ProxyOffscreen, RegisterOffscreen, OffscreenBackground};\n\nexport const getOffscreen = <N extends TransportName>(name: N): TransportDictionary[N] => {\n    return new Offscreen<N>(name).get();\n};\n"],"mappings":"AAAA,SAAQ,WAAW,gBAAgB,yBAAwB;AAC3D,OAAO,yBAAyB;AAWzB,MAAM,eAAe,CAA0B,SAAoC;AACtF,SAAO,IAAI,UAAa,IAAI,EAAE,IAAI;AACtC;","names":[]}
+{"version":3,"sources":["../../src/offscreen/index.ts"],"sourcesContent":["import {Offscreen, ProxyOffscreen, RegisterOffscreen} from \"./providers\";\nimport OffscreenBackground from \"./OffscreenBackground\";\n\nimport type {TransportProxyTarget, TransportTarget} from \"@transport/index\";\n\nexport {ProxyOffscreen, RegisterOffscreen, OffscreenBackground};\n\nexport interface OffscreenRegistry {}\n\nexport type OffscreenName = Extract<keyof OffscreenRegistry, string>;\n\nexport type OffscreenTarget<N extends keyof OffscreenRegistry> = TransportTarget<OffscreenRegistry, N>;\n\nexport type OffscreenProxyTarget<N extends keyof OffscreenRegistry> = TransportProxyTarget<OffscreenRegistry, N>;\n\nexport const getOffscreen = <N extends OffscreenName>(name: N): OffscreenTarget<N> => {\n    return new Offscreen<N>(name).get();\n};\n"],"mappings":"AAAA,SAAQ,WAAW,gBAAgB,yBAAwB;AAC3D,OAAO,yBAAyB;AAczB,MAAM,eAAe,CAA0B,SAAgC;AAClF,SAAO,IAAI,UAAa,IAAI,EAAE,IAAI;AACtC;","names":[]}

package/dist/relay/index.d.ts

@@ -1,4 +1,9 @@
 import { ProxyRelay, RegisterRelay, type ProxyRelayParams } from "./providers/index.js";
-import type { TransportDictionary, TransportName, TransportProxyTarget as RelayProxyTarget, TransportTarget as RelayTarget } from "../types/transport.js";
-export { type RelayTarget, type RelayProxyTarget, type ProxyRelayParams, ProxyRelay, RegisterRelay };
-export declare const getRelay: <N extends TransportName>(name: N) => TransportDictionary[N];
+import type { TransportProxyTarget, TransportTarget } from "../transport/index.js";
+export { type ProxyRelayParams, ProxyRelay, RegisterRelay };
+export interface RelayRegistry {
+}
+export type RelayName = Extract<keyof RelayRegistry, string>;
+export type RelayTarget<N extends keyof RelayRegistry> = TransportTarget<RelayRegistry, N>;
+export type RelayProxyTarget<N extends keyof RelayRegistry> = TransportProxyTarget<RelayRegistry, N>;
+export declare const getRelay: <N extends RelayName>(name: N) => RelayTarget<N>;

package/dist/relay/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/relay/index.ts"],"sourcesContent":["import {ProxyRelay, RegisterRelay, Relay, type ProxyRelayParams} from \"./providers\";\n\nimport type {\n    TransportDictionary,\n    TransportName,\n    TransportProxyTarget as RelayProxyTarget,\n    TransportTarget as RelayTarget,\n} from \"@typing/transport\";\n\nexport {type RelayTarget, type RelayProxyTarget, type ProxyRelayParams, ProxyRelay, RegisterRelay};\n\nexport const getRelay = <N extends TransportName>(name: N): TransportDictionary[N] => {\n    return new Relay<N>(name).get();\n};\n"],"mappings":"AAAA,SAAQ,YAAY,eAAe,aAAmC;AAW/D,MAAM,WAAW,CAA0B,SAAoC;AAClF,SAAO,IAAI,MAAS,IAAI,EAAE,IAAI;AAClC;","names":[]}
+{"version":3,"sources":["../../src/relay/index.ts"],"sourcesContent":["import {ProxyRelay, RegisterRelay, Relay, type ProxyRelayParams} from \"./providers\";\n\nimport type {TransportProxyTarget, TransportTarget} from \"@transport/index\";\n\nexport {type ProxyRelayParams, ProxyRelay, RegisterRelay};\n\nexport interface RelayRegistry {}\n\nexport type RelayName = Extract<keyof RelayRegistry, string>;\n\nexport type RelayTarget<N extends keyof RelayRegistry> = TransportTarget<RelayRegistry, N>;\n\nexport type RelayProxyTarget<N extends keyof RelayRegistry> = TransportProxyTarget<RelayRegistry, N>;\n\nexport const getRelay = <N extends RelayName>(name: N): RelayTarget<N> => {\n    return new Relay<N>(name).get();\n};\n"],"mappings":"AAAA,SAAQ,YAAY,eAAe,aAAmC;AAc/D,MAAM,WAAW,CAAsB,SAA4B;AACtE,SAAO,IAAI,MAAS,IAAI,EAAE,IAAI;AAClC;","names":[]}

package/dist/sandbox/SandboxFrame.d.ts

@@ -0,0 +1,6 @@
+import { SandboxParameters } from "../types/sandbox.js";
+export default class SandboxFrame {
+    private readonly frames;
+    make(name: string, parameters: SandboxParameters): Promise<HTMLIFrameElement>;
+    remove(name: string): void;
+}

package/dist/sandbox/SandboxFrame.js

@@ -0,0 +1,31 @@
+import { sandboxChannel } from "./utils.js";
+import { ReadyFrame } from "./../frame/index.js";
+import { SandboxReadyMessageType } from "./../types/sandbox.js";
+class SandboxFrame {
+  frames = new ReadyFrame();
+  make(name, parameters) {
+    const { url, readyTimeout } = parameters;
+    const channel = sandboxChannel(name);
+    return this.frames.make({
+      key: name,
+      url,
+      readyTimeout,
+      isReady: (event, frame) => {
+        if (event.source !== frame.contentWindow) {
+          return false;
+        }
+        const data = event.data;
+        return (data == null ? void 0 : data.type) === SandboxReadyMessageType && data.channel === channel && data.name === name;
+      },
+      readyTimeoutMessage: (loaded, timeout) => loaded ? `Sandbox "${name}" loaded but never signaled ready within ${timeout}ms. Ensure the sandbox entry runs and the manifest sandbox CSP allows its script.` : `Sandbox "${name}" did not load "${url}" within ${timeout}ms. Ensure the page is listed in the manifest sandbox pages and is not blocked by CSP.`,
+      loadErrorMessage: () => `Sandbox "${name}" failed to load: ${url}`
+    });
+  }
+  remove(name) {
+    this.frames.remove(name);
+  }
+}
+export {
+  SandboxFrame as default
+};
+//# sourceMappingURL=SandboxFrame.js.map

package/dist/sandbox/SandboxFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sandbox/SandboxFrame.ts"],"sourcesContent":["import {sandboxChannel} from \"./utils\";\n\nimport {ReadyFrame} from \"@frame/index\";\n\nimport {SandboxParameters, SandboxReadyMessage, SandboxReadyMessageType} from \"@typing/sandbox\";\n\nexport default class SandboxFrame {\n    private readonly frames = new ReadyFrame();\n\n    public make(name: string, parameters: SandboxParameters): Promise<HTMLIFrameElement> {\n        const {url, readyTimeout} = parameters;\n        const channel = sandboxChannel(name);\n\n        return this.frames.make({\n            key: name,\n            url,\n            readyTimeout,\n            isReady: (event, frame) => {\n                if (event.source !== frame.contentWindow) {\n                    return false;\n                }\n\n                const data = event.data as Partial<SandboxReadyMessage>;\n\n                return data?.type === SandboxReadyMessageType && data.channel === channel && data.name === name;\n            },\n            readyTimeoutMessage: (loaded, timeout) =>\n                loaded\n                    ? `Sandbox \"${name}\" loaded but never signaled ready within ${timeout}ms. Ensure the sandbox entry runs and the manifest sandbox CSP allows its script.`\n                    : `Sandbox \"${name}\" did not load \"${url}\" within ${timeout}ms. Ensure the page is listed in the manifest sandbox pages and is not blocked by CSP.`,\n            loadErrorMessage: () => `Sandbox \"${name}\" failed to load: ${url}`,\n        });\n    }\n\n    public remove(name: string): void {\n        this.frames.remove(name);\n    }\n}\n"],"mappings":"AAAA,SAAQ,sBAAqB;AAE7B,SAAQ,kBAAiB;AAEzB,SAAgD,+BAA8B;AAE9E,MAAO,aAA2B;AAAA,EACb,SAAS,IAAI,WAAW;AAAA,EAElC,KAAK,MAAc,YAA2D;AACjF,UAAM,EAAC,KAAK,aAAY,IAAI;AAC5B,UAAM,UAAU,eAAe,IAAI;AAEnC,WAAO,KAAK,OAAO,KAAK;AAAA,MACpB,KAAK;AAAA,MACL;AAAA,MACA;AAAA,MACA,SAAS,CAAC,OAAO,UAAU;AACvB,YAAI,MAAM,WAAW,MAAM,eAAe;AACtC,iBAAO;AAAA,QACX;AAEA,cAAM,OAAO,MAAM;AAEnB,gBAAO,6BAAM,UAAS,2BAA2B,KAAK,YAAY,WAAW,KAAK,SAAS;AAAA,MAC/F;AAAA,MACA,qBAAqB,CAAC,QAAQ,YAC1B,SACM,YAAY,IAAI,4CAA4C,OAAO,sFACnE,YAAY,IAAI,mBAAmB,GAAG,YAAY,OAAO;AAAA,MACnE,kBAAkB,MAAM,YAAY,IAAI,qBAAqB,GAAG;AAAA,IACpE,CAAC;AAAA,EACL;AAAA,EAEO,OAAO,MAAoB;AAC9B,SAAK,OAAO,OAAO,IAAI;AAAA,EAC3B;AACJ;","names":[]}

package/dist/sandbox/SandboxManager.d.ts

@@ -0,0 +1,5 @@
+import TransportManager from "../transport/TransportManager.js";
+import type { TransportManager as TransportManagerContract } from "../types/transport.js";
+export default class SandboxManager extends TransportManager {
+    static getInstance(): TransportManagerContract;
+}

package/dist/sandbox/SandboxManager.js

@@ -0,0 +1,12 @@
+import TransportManager from "./../transport/TransportManager.js";
+import { SandboxGlobalKey } from "./../types/sandbox.js";
+class SandboxManager extends TransportManager {
+  static getInstance() {
+    var _a;
+    return globalThis[_a = SandboxGlobalKey] ?? (globalThis[_a] = new SandboxManager());
+  }
+}
+export {
+  SandboxManager as default
+};
+//# sourceMappingURL=SandboxManager.js.map

package/dist/sandbox/SandboxManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sandbox/SandboxManager.ts"],"sourcesContent":["import TransportManager from \"@transport/TransportManager\";\n\nimport {SandboxGlobalKey} from \"@typing/sandbox\";\n\nimport type {TransportManager as TransportManagerContract} from \"@typing/transport\";\n\nexport default class SandboxManager extends TransportManager {\n    public static getInstance(): TransportManagerContract {\n        return (globalThis[SandboxGlobalKey] ??= new SandboxManager());\n    }\n}\n"],"mappings":"AAAA,OAAO,sBAAsB;AAE7B,SAAQ,wBAAuB;AAI/B,MAAO,uBAAqC,iBAAiB;AAAA,EACzD,OAAc,cAAwC;AAP1D;AAQQ,WAAQ,gBAAW,sBAAX,iBAAiC,IAAI,eAAe;AAAA,EAChE;AACJ;","names":[]}

package/dist/sandbox/SandboxMessage.d.ts

@@ -0,0 +1,30 @@
+import { SandboxParameters, SandboxPort } from "../types/sandbox.js";
+import type { MessageSender } from "../types/message.js";
+import type { TransportMessage, TransportMessageData } from "../types/transport.js";
+/**
+ * The standard transport channel (`send`/`watch`) for the sandbox layer, implemented over
+ * `window.postMessage` instead of the chrome.runtime `Message` provider. All request/response
+ * correlation (requestId, pending map, timeouts, error serialize/restore) lives here, behind
+ * the standard interface; the raw wire sits below in a `SandboxPort`.
+ */
+export default class SandboxMessage implements TransportMessage {
+    private readonly name;
+    private readonly port;
+    private readonly parameters;
+    private static readonly hosts;
+    private readonly channel;
+    private readonly pending;
+    private listenUnsubscribe?;
+    private watchUnsubscribe?;
+    constructor(name: string, port: SandboxPort, parameters?: Partial<SandboxParameters>);
+    /**
+     * Host-side channel, cached per name. One cached instance means one peer listener per
+     * sandbox no matter how many times `getSandbox()` is called — this is the leak fix.
+     */
+    static for(name: string, parameters: SandboxParameters): SandboxMessage;
+    send(data: TransportMessageData): Promise<any>;
+    watch(handler: (data: TransportMessageData, sender: MessageSender) => any): () => void;
+    dispose(): void;
+    private listen;
+    private respond;
+}

package/dist/sandbox/SandboxMessage.js

@@ -0,0 +1,127 @@
+import { nanoid } from "nanoid";
+import { sandboxChannel } from "./utils.js";
+import { SandboxHost } from "./ports/index.js";
+import { restoreError, serializeError } from "./../message/error.js";
+import {
+  SandboxRequestMessageType,
+  SandboxResponseMessageType
+} from "./../types/sandbox.js";
+const DefaultRequestTimeout = 3e4;
+class SandboxMessage {
+  constructor(name, port, parameters = {}) {
+    this.name = name;
+    this.port = port;
+    this.parameters = parameters;
+    this.channel = sandboxChannel(name);
+  }
+  name;
+  port;
+  parameters;
+  static hosts = /* @__PURE__ */ new Map();
+  channel;
+  pending = /* @__PURE__ */ new Map();
+  listenUnsubscribe;
+  watchUnsubscribe;
+  /**
+   * Host-side channel, cached per name. One cached instance means one peer listener per
+   * sandbox no matter how many times `getSandbox()` is called — this is the leak fix.
+   */
+  static for(name, parameters) {
+    let message = this.hosts.get(name);
+    if (!message) {
+      message = new SandboxMessage(name, new SandboxHost(name, parameters), parameters);
+      this.hosts.set(name, message);
+    }
+    return message;
+  }
+  async send(data) {
+    await this.port.connect();
+    this.listen();
+    const requestId = nanoid();
+    const request = {
+      type: SandboxRequestMessageType,
+      channel: this.channel,
+      name: this.name,
+      requestId,
+      path: data.path,
+      args: data.args
+    };
+    const requestTimeout = this.parameters.requestTimeout ?? DefaultRequestTimeout;
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        this.pending.delete(requestId);
+        if (this.parameters.removeOnRequestTimeout && this.pending.size === 0) {
+          this.dispose();
+        }
+        reject(new Error(`Sandbox "${this.name}" request "${requestId}" timed out.`));
+      }, requestTimeout);
+      this.pending.set(requestId, { resolve, reject, timeout });
+      this.port.post(request);
+    });
+  }
+  watch(handler) {
+    if (this.watchUnsubscribe) {
+      return this.watchUnsubscribe;
+    }
+    const unsubscribe = this.port.subscribe(async (message, sender) => {
+      if (message.type !== SandboxRequestMessageType) {
+        return;
+      }
+      try {
+        const payload = await handler({ path: message.path, args: message.args ?? [] }, sender);
+        this.respond({ requestId: message.requestId, ok: true, payload });
+      } catch (error) {
+        this.respond({ requestId: message.requestId, ok: false, error: serializeError(error) });
+      }
+    });
+    this.watchUnsubscribe = unsubscribe;
+    return unsubscribe;
+  }
+  dispose() {
+    var _a, _b;
+    for (const pending of this.pending.values()) {
+      clearTimeout(pending.timeout);
+      pending.reject(new Error(`Sandbox "${this.name}" was disposed.`));
+    }
+    this.pending.clear();
+    (_a = this.listenUnsubscribe) == null ? void 0 : _a.call(this);
+    this.listenUnsubscribe = void 0;
+    (_b = this.watchUnsubscribe) == null ? void 0 : _b.call(this);
+    this.watchUnsubscribe = void 0;
+    this.port.dispose();
+    SandboxMessage.hosts.delete(this.name);
+  }
+  listen() {
+    if (this.listenUnsubscribe) {
+      return;
+    }
+    this.listenUnsubscribe = this.port.subscribe((message) => {
+      if (message.type !== SandboxResponseMessageType) {
+        return;
+      }
+      const pending = this.pending.get(message.requestId);
+      if (!pending) {
+        return;
+      }
+      clearTimeout(pending.timeout);
+      this.pending.delete(message.requestId);
+      if (message.ok) {
+        pending.resolve(message.payload);
+      } else {
+        pending.reject(restoreError(message.error));
+      }
+    });
+  }
+  respond(response) {
+    this.port.post({
+      type: SandboxResponseMessageType,
+      channel: this.channel,
+      name: this.name,
+      ...response
+    });
+  }
+}
+export {
+  SandboxMessage as default
+};
+//# sourceMappingURL=SandboxMessage.js.map

package/dist/sandbox/SandboxMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sandbox/SandboxMessage.ts"],"sourcesContent":["import {nanoid} from \"nanoid\";\n\nimport {sandboxChannel} from \"./utils\";\nimport {SandboxHost} from \"./ports\";\n\nimport {restoreError, serializeError} from \"@message/error\";\nimport {\n    SandboxParameters,\n    SandboxPort,\n    SandboxRequestMessage,\n    SandboxRequestMessageType,\n    SandboxResponseMessage,\n    SandboxResponseMessageType,\n} from \"@typing/sandbox\";\nimport type {MessageSender} from \"@typing/message\";\nimport type {TransportMessage, TransportMessageData} from \"@typing/transport\";\n\ntype Pending = {\n    resolve: (value: any) => void;\n    reject: (reason?: any) => void;\n    timeout: ReturnType<typeof setTimeout>;\n};\n\nconst DefaultRequestTimeout = 30000;\n\n/**\n * The standard transport channel (`send`/`watch`) for the sandbox layer, implemented over\n * `window.postMessage` instead of the chrome.runtime `Message` provider. All request/response\n * correlation (requestId, pending map, timeouts, error serialize/restore) lives here, behind\n * the standard interface; the raw wire sits below in a `SandboxPort`.\n */\nexport default class SandboxMessage implements TransportMessage {\n    private static readonly hosts: Map<string, SandboxMessage> = new Map();\n\n    private readonly channel: string;\n\n    private readonly pending: Map<string, Pending> = new Map();\n\n    private listenUnsubscribe?: () => void;\n\n    private watchUnsubscribe?: () => void;\n\n    constructor(\n        private readonly name: string,\n        private readonly port: SandboxPort,\n        private readonly parameters: Partial<SandboxParameters> = {}\n    ) {\n        this.channel = sandboxChannel(name);\n    }\n\n    /**\n     * Host-side channel, cached per name. One cached instance means one peer listener per\n     * sandbox no matter how many times `getSandbox()` is called — this is the leak fix.\n     */\n    public static for(name: string, parameters: SandboxParameters): SandboxMessage {\n        let message = this.hosts.get(name);\n\n        if (!message) {\n            message = new SandboxMessage(name, new SandboxHost(name, parameters), parameters);\n\n            this.hosts.set(name, message);\n        }\n\n        return message;\n    }\n\n    public async send(data: TransportMessageData): Promise<any> {\n        await this.port.connect();\n\n        this.listen();\n\n        const requestId = nanoid();\n        const request: SandboxRequestMessage = {\n            type: SandboxRequestMessageType,\n            channel: this.channel,\n            name: this.name,\n            requestId,\n            path: data.path,\n            args: data.args,\n        };\n\n        const requestTimeout = this.parameters.requestTimeout ?? DefaultRequestTimeout;\n\n        return new Promise((resolve, reject) => {\n            const timeout = setTimeout(() => {\n                this.pending.delete(requestId);\n\n                if (this.parameters.removeOnRequestTimeout && this.pending.size === 0) {\n                    this.dispose();\n                }\n\n                reject(new Error(`Sandbox \"${this.name}\" request \"${requestId}\" timed out.`));\n            }, requestTimeout);\n\n            this.pending.set(requestId, {resolve, reject, timeout});\n\n            this.port.post(request);\n        });\n    }\n\n    public watch(handler: (data: TransportMessageData, sender: MessageSender) => any): () => void {\n        if (this.watchUnsubscribe) {\n            return this.watchUnsubscribe;\n        }\n\n        const unsubscribe = this.port.subscribe(async (message, sender) => {\n            if (message.type !== SandboxRequestMessageType) {\n                return;\n            }\n\n            try {\n                const payload = await handler({path: message.path, args: message.args ?? []}, sender);\n\n                this.respond({requestId: message.requestId, ok: true, payload});\n            } catch (error) {\n                this.respond({requestId: message.requestId, ok: false, error: serializeError(error)});\n            }\n        });\n\n        this.watchUnsubscribe = unsubscribe;\n\n        return unsubscribe;\n    }\n\n    public dispose(): void {\n        for (const pending of this.pending.values()) {\n            clearTimeout(pending.timeout);\n            pending.reject(new Error(`Sandbox \"${this.name}\" was disposed.`));\n        }\n\n        this.pending.clear();\n\n        this.listenUnsubscribe?.();\n        this.listenUnsubscribe = undefined;\n\n        this.watchUnsubscribe?.();\n        this.watchUnsubscribe = undefined;\n\n        this.port.dispose();\n\n        SandboxMessage.hosts.delete(this.name);\n    }\n\n    private listen(): void {\n        if (this.listenUnsubscribe) {\n            return;\n        }\n\n        this.listenUnsubscribe = this.port.subscribe(message => {\n            if (message.type !== SandboxResponseMessageType) {\n                return;\n            }\n\n            const pending = this.pending.get(message.requestId);\n\n            if (!pending) {\n                return;\n            }\n\n            clearTimeout(pending.timeout);\n            this.pending.delete(message.requestId);\n\n            if (message.ok) {\n                pending.resolve(message.payload);\n            } else {\n                pending.reject(restoreError(message.error));\n            }\n        });\n    }\n\n    private respond(response: Omit<SandboxResponseMessage, \"type\" | \"channel\" | \"name\">): void {\n        this.port.post({\n            type: SandboxResponseMessageType,\n            channel: this.channel,\n            name: this.name,\n            ...response,\n        });\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/sandbox/index.d.ts

@@ -0,0 +1,7 @@
+import { ProxySandbox, RegisterSandbox } from "./providers/index.js";
+import type { DeepAsyncProxy } from "../types/helpers.js";
+export { ProxySandbox, RegisterSandbox };
+export interface SandboxRegistry {
+}
+export type SandboxName = Extract<keyof SandboxRegistry, string>;
+export type SandboxProxyTarget<N extends keyof SandboxRegistry> = DeepAsyncProxy<SandboxRegistry[N]>;

package/dist/sandbox/index.js

@@ -0,0 +1,6 @@
+import { ProxySandbox, RegisterSandbox } from "./providers/index.js";
+export {
+  ProxySandbox,
+  RegisterSandbox
+};
+//# sourceMappingURL=index.js.map

package/dist/sandbox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sandbox/index.ts"],"sourcesContent":["import {ProxySandbox, RegisterSandbox} from \"./providers\";\n\nimport type {DeepAsyncProxy} from \"@typing/helpers\";\n\nexport {ProxySandbox, RegisterSandbox};\n\nexport interface SandboxRegistry {}\n\nexport type SandboxName = Extract<keyof SandboxRegistry, string>;\n\nexport type SandboxProxyTarget<N extends keyof SandboxRegistry> = DeepAsyncProxy<SandboxRegistry[N]>;\n"],"mappings":"AAAA,SAAQ,cAAc,uBAAsB;","names":[]}