adnbn 0.6.1 → 0.7.0

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    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 this.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    private restoreError(error: MessageError): Error {\n        const ErrorConstructor = this.getErrorConstructor(error.name);\n        const restored = new ErrorConstructor(error.message);\n\n        restored.name = error.name || \"Error\";\n\n        if (error.stack) {\n            restored.stack = error.stack;\n        }\n\n        return restored;\n    }\n\n    private getErrorConstructor(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    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":"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","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/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":[]}

package/dist/sandbox/ports/SandboxHost.d.ts

@@ -0,0 +1,21 @@
+import type { SandboxEnvelope, SandboxParameters, SandboxPort } from "../../types/sandbox.js";
+import type { MessageSender } from "../../types/message.js";
+/**
+ * Host-side `SandboxPort`: runs in an extension page, owns the sandbox iframe.
+ * `connect` creates the iframe and awaits its ready handshake (via `SandboxFrame`);
+ * `post` targets the iframe's `contentWindow`; `subscribe` attaches a single `message`
+ * listener filtered to that frame.
+ */
+export default class SandboxHost implements SandboxPort {
+    private readonly name;
+    private readonly parameters;
+    private readonly frames;
+    private readonly channel;
+    private frame?;
+    private unsubscribe?;
+    constructor(name: string, parameters: SandboxParameters);
+    connect(): Promise<void>;
+    post(message: SandboxEnvelope): void;
+    subscribe(onMessage: (message: SandboxEnvelope, sender: MessageSender) => void): () => void;
+    dispose(): void;
+}

package/dist/sandbox/ports/SandboxHost.js

@@ -0,0 +1,58 @@
+import { sandboxChannel, sandboxSender } from "../utils.js";
+import SandboxFrame from "../SandboxFrame.js";
+class SandboxHost {
+  constructor(name, parameters) {
+    this.name = name;
+    this.parameters = parameters;
+    this.channel = sandboxChannel(name);
+  }
+  name;
+  parameters;
+  frames = new SandboxFrame();
+  channel;
+  frame;
+  unsubscribe;
+  async connect() {
+    this.frame = await this.frames.make(this.name, this.parameters);
+  }
+  post(message) {
+    var _a;
+    const target = (_a = this.frame) == null ? void 0 : _a.contentWindow;
+    if (!target) {
+      throw new Error(`Sandbox "${this.name}" is not available.`);
+    }
+    target.postMessage(message, "*");
+  }
+  subscribe(onMessage) {
+    if (this.unsubscribe) {
+      return this.unsubscribe;
+    }
+    const listener = (event) => {
+      var _a;
+      if (event.source !== ((_a = this.frame) == null ? void 0 : _a.contentWindow)) {
+        return;
+      }
+      const data = event.data;
+      if ((data == null ? void 0 : data.channel) !== this.channel || data.name !== this.name) {
+        return;
+      }
+      onMessage(data, sandboxSender());
+    };
+    window.addEventListener("message", listener);
+    this.unsubscribe = () => {
+      window.removeEventListener("message", listener);
+      this.unsubscribe = void 0;
+    };
+    return this.unsubscribe;
+  }
+  dispose() {
+    var _a;
+    (_a = this.unsubscribe) == null ? void 0 : _a.call(this);
+    this.frames.remove(this.name);
+    this.frame = void 0;
+  }
+}
+export {
+  SandboxHost as default
+};
+//# sourceMappingURL=SandboxHost.js.map

package/dist/sandbox/ports/SandboxHost.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/sandbox/ports/SandboxHost.ts"],"sourcesContent":["import {sandboxChannel, sandboxSender} from \"../utils\";\nimport SandboxFrame from \"../SandboxFrame\";\n\nimport type {SandboxEnvelope, SandboxParameters, SandboxPort} from \"@typing/sandbox\";\nimport type {MessageSender} from \"@typing/message\";\n\n/**\n * Host-side `SandboxPort`: runs in an extension page, owns the sandbox iframe.\n * `connect` creates the iframe and awaits its ready handshake (via `SandboxFrame`);\n * `post` targets the iframe's `contentWindow`; `subscribe` attaches a single `message`\n * listener filtered to that frame.\n */\nexport default class SandboxHost implements SandboxPort {\n    private readonly frames = new SandboxFrame();\n\n    private readonly channel: string;\n\n    private frame?: HTMLIFrameElement;\n\n    private unsubscribe?: () => void;\n\n    constructor(\n        private readonly name: string,\n        private readonly parameters: SandboxParameters\n    ) {\n        this.channel = sandboxChannel(name);\n    }\n\n    public async connect(): Promise<void> {\n        this.frame = await this.frames.make(this.name, this.parameters);\n    }\n\n    public post(message: SandboxEnvelope): void {\n        const target = this.frame?.contentWindow;\n\n        if (!target) {\n            throw new Error(`Sandbox \"${this.name}\" is not available.`);\n        }\n\n        // Sandboxed iframes have an opaque origin, so no concrete targetOrigin is possible.\n        // Inbound messages are trusted by channel + name + requestId, never by origin.\n        target.postMessage(message, \"*\");\n    }\n\n    public subscribe(onMessage: (message: SandboxEnvelope, sender: MessageSender) => void): () => void {\n        if (this.unsubscribe) {\n            return this.unsubscribe;\n        }\n\n        const listener = (event: MessageEvent) => {\n            if (event.source !== this.frame?.contentWindow) {\n                return;\n            }\n\n            const data = event.data as Partial<SandboxEnvelope>;\n\n            if (data?.channel !== this.channel || data.name !== this.name) {\n                return;\n            }\n\n            onMessage(data as SandboxEnvelope, sandboxSender());\n        };\n\n        window.addEventListener(\"message\", listener);\n\n        this.unsubscribe = () => {\n            window.removeEventListener(\"message\", listener);\n            this.unsubscribe = undefined;\n        };\n\n        return this.unsubscribe;\n    }\n\n    public dispose(): void {\n        this.unsubscribe?.();\n        this.frames.remove(this.name);\n        this.frame = undefined;\n    }\n}\n"],"mappings":"AAAA,SAAQ,gBAAgB,qBAAoB;AAC5C,OAAO,kBAAkB;AAWzB,MAAO,YAAiD;AAAA,EASpD,YACqB,MACA,YACnB;AAFmB;AACA;AAEjB,SAAK,UAAU,eAAe,IAAI;AAAA,EACtC;AAAA,EAJqB;AAAA,EACA;AAAA,EAVJ,SAAS,IAAI,aAAa;AAAA,EAE1B;AAAA,EAET;AAAA,EAEA;AAAA,EASR,MAAa,UAAyB;AAClC,SAAK,QAAQ,MAAM,KAAK,OAAO,KAAK,KAAK,MAAM,KAAK,UAAU;AAAA,EAClE;AAAA,EAEO,KAAK,SAAgC;AAhChD;AAiCQ,UAAM,UAAS,UAAK,UAAL,mBAAY;AAE3B,QAAI,CAAC,QAAQ;AACT,YAAM,IAAI,MAAM,YAAY,KAAK,IAAI,qBAAqB;AAAA,IAC9D;AAIA,WAAO,YAAY,SAAS,GAAG;AAAA,EACnC;AAAA,EAEO,UAAU,WAAkF;AAC/F,QAAI,KAAK,aAAa;AAClB,aAAO,KAAK;AAAA,IAChB;AAEA,UAAM,WAAW,CAAC,UAAwB;AAjDlD;AAkDY,UAAI,MAAM,aAAW,UAAK,UAAL,mBAAY,gBAAe;AAC5C;AAAA,MACJ;AAEA,YAAM,OAAO,MAAM;AAEnB,WAAI,6BAAM,aAAY,KAAK,WAAW,KAAK,SAAS,KAAK,MAAM;AAC3D;AAAA,MACJ;AAEA,gBAAU,MAAyB,cAAc,CAAC;AAAA,IACtD;AAEA,WAAO,iBAAiB,WAAW,QAAQ;AAE3C,SAAK,cAAc,MAAM;AACrB,aAAO,oBAAoB,WAAW,QAAQ;AAC9C,WAAK,cAAc;AAAA,IACvB;AAEA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEO,UAAgB;AAzE3B;AA0EQ,eAAK,gBAAL;AACA,SAAK,OAAO,OAAO,KAAK,IAAI;AAC5B,SAAK,QAAQ;AAAA,EACjB;AACJ;","names":[]}

package/dist/sandbox/ports/SandboxInner.d.ts

@@ -0,0 +1,17 @@
+import type { SandboxEnvelope, SandboxPort } from "../../types/sandbox.js";
+import type { MessageSender } from "../../types/message.js";
+/**
+ * Sandbox-side `SandboxPort`: runs inside the iframe. There is no frame to create, so
+ * `connect` resolves immediately (the ready handshake is posted by the sandbox builder);
+ * `post` targets `window.parent`; `subscribe` listens for messages from the parent.
+ */
+export default class SandboxInner implements SandboxPort {
+    private readonly name;
+    private readonly channel;
+    private unsubscribe?;
+    constructor(name: string);
+    connect(): Promise<void>;
+    post(message: SandboxEnvelope): void;
+    subscribe(onMessage: (message: SandboxEnvelope, sender: MessageSender) => void): () => void;
+    dispose(): void;
+}

package/dist/sandbox/ports/SandboxInner.js

@@ -0,0 +1,45 @@
+import { sandboxChannel, sandboxSender } from "../utils.js";
+class SandboxInner {
+  constructor(name) {
+    this.name = name;
+    this.channel = sandboxChannel(name);
+  }
+  name;
+  channel;
+  unsubscribe;
+  connect() {
+    return Promise.resolve();
+  }
+  post(message) {
+    window.parent.postMessage(message, "*");
+  }
+  subscribe(onMessage) {
+    if (this.unsubscribe) {
+      return this.unsubscribe;
+    }
+    const listener = (event) => {
+      if (event.source !== window.parent) {
+        return;
+      }
+      const data = event.data;
+      if ((data == null ? void 0 : data.channel) !== this.channel || data.name !== this.name) {
+        return;
+      }
+      onMessage(data, sandboxSender());
+    };
+    window.addEventListener("message", listener);
+    this.unsubscribe = () => {
+      window.removeEventListener("message", listener);
+      this.unsubscribe = void 0;
+    };
+    return this.unsubscribe;
+  }
+  dispose() {
+    var _a;
+    (_a = this.unsubscribe) == null ? void 0 : _a.call(this);
+  }
+}
+export {
+  SandboxInner as default
+};
+//# sourceMappingURL=SandboxInner.js.map

package/dist/sandbox/ports/SandboxInner.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/sandbox/ports/SandboxInner.ts"],"sourcesContent":["import {sandboxChannel, sandboxSender} from \"../utils\";\n\nimport type {SandboxEnvelope, SandboxPort} from \"@typing/sandbox\";\nimport type {MessageSender} from \"@typing/message\";\n\n/**\n * Sandbox-side `SandboxPort`: runs inside the iframe. There is no frame to create, so\n * `connect` resolves immediately (the ready handshake is posted by the sandbox builder);\n * `post` targets `window.parent`; `subscribe` listens for messages from the parent.\n */\nexport default class SandboxInner implements SandboxPort {\n    private readonly channel: string;\n\n    private unsubscribe?: () => void;\n\n    constructor(private readonly name: string) {\n        this.channel = sandboxChannel(name);\n    }\n\n    public connect(): Promise<void> {\n        return Promise.resolve();\n    }\n\n    public post(message: SandboxEnvelope): void {\n        // Opaque sandbox origin: no concrete targetOrigin is possible; the host trusts\n        // messages by channel + name + requestId, never by origin.\n        window.parent.postMessage(message, \"*\");\n    }\n\n    public subscribe(onMessage: (message: SandboxEnvelope, sender: MessageSender) => void): () => void {\n        if (this.unsubscribe) {\n            return this.unsubscribe;\n        }\n\n        const listener = (event: MessageEvent) => {\n            if (event.source !== window.parent) {\n                return;\n            }\n\n            const data = event.data as Partial<SandboxEnvelope>;\n\n            if (data?.channel !== this.channel || data.name !== this.name) {\n                return;\n            }\n\n            onMessage(data as SandboxEnvelope, sandboxSender());\n        };\n\n        window.addEventListener(\"message\", listener);\n\n        this.unsubscribe = () => {\n            window.removeEventListener(\"message\", listener);\n            this.unsubscribe = undefined;\n        };\n\n        return this.unsubscribe;\n    }\n\n    public dispose(): void {\n        this.unsubscribe?.();\n    }\n}\n"],"mappings":"AAAA,SAAQ,gBAAgB,qBAAoB;AAU5C,MAAO,aAAkD;AAAA,EAKrD,YAA6B,MAAc;AAAd;AACzB,SAAK,UAAU,eAAe,IAAI;AAAA,EACtC;AAAA,EAF6B;AAAA,EAJZ;AAAA,EAET;AAAA,EAMD,UAAyB;AAC5B,WAAO,QAAQ,QAAQ;AAAA,EAC3B;AAAA,EAEO,KAAK,SAAgC;AAGxC,WAAO,OAAO,YAAY,SAAS,GAAG;AAAA,EAC1C;AAAA,EAEO,UAAU,WAAkF;AAC/F,QAAI,KAAK,aAAa;AAClB,aAAO,KAAK;AAAA,IAChB;AAEA,UAAM,WAAW,CAAC,UAAwB;AACtC,UAAI,MAAM,WAAW,OAAO,QAAQ;AAChC;AAAA,MACJ;AAEA,YAAM,OAAO,MAAM;AAEnB,WAAI,6BAAM,aAAY,KAAK,WAAW,KAAK,SAAS,KAAK,MAAM;AAC3D;AAAA,MACJ;AAEA,gBAAU,MAAyB,cAAc,CAAC;AAAA,IACtD;AAEA,WAAO,iBAAiB,WAAW,QAAQ;AAE3C,SAAK,cAAc,MAAM;AACrB,aAAO,oBAAoB,WAAW,QAAQ;AAC9C,WAAK,cAAc;AAAA,IACvB;AAEA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEO,UAAgB;AA1D3B;AA2DQ,eAAK,gBAAL;AAAA,EACJ;AACJ;","names":[]}

package/dist/sandbox/ports/SandboxMemory.d.ts

@@ -0,0 +1,4 @@
+import type { SandboxPort } from "../../types/sandbox.js";
+export default class SandboxMemory {
+    static pair(): [SandboxPort, SandboxPort];
+}