adnbn 0.6.0 → 0.7.0

package/dist/cli/virtual/sandbox.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/virtual/virtual.d.ts

@@ -67,6 +67,17 @@ declare module "virtual:relay-entrypoint" {
     export = module;
 }
 
+declare module "virtual:sandbox-entrypoint" {
+    type SandboxDefinition = import("../../types/sandbox.js").SandboxDefinition<any>;
+
+    interface ModuleType extends SandboxDefinition {
+        default: SandboxDefinition | SandboxDefinition["init"] | undefined;
+    }
+
+    const module: ModuleType;
+    export = module;
+}
+
 declare module "virtual:relay-framework" {
     type RelayUnresolvedDefinition = import("../../types/relay.js").RelayUnresolvedDefinition<any>;
 
@@ -119,6 +130,8 @@ declare module "adnbn" {
         import("../../types/offscreen.js").OffscreenUnresolvedDefinition<T>;
     export type RelayUnresolvedDefinition<T extends import("../../types/transport.js").TransportType> =
         import("../../types/relay.js").RelayUnresolvedDefinition<T>;
+    export type SandboxUnresolvedDefinition<T extends import("../../types/transport.js").TransportType> =
+        import("../../types/sandbox.js").SandboxUnresolvedDefinition<T>;
 }
 
 declare module "adnbn/transport" {
@@ -206,6 +219,20 @@ declare module "adnbn/entry/relay" {
     }
 }
 
+declare module "adnbn/entry/sandbox" {
+    import type {SandboxDefinition, SandboxUnresolvedDefinition} from "../../types/sandbox.js";
+    import type {TransportType} from "../../types/transport.js";
+    import type {ViewBuilder} from "../../types/view.js";
+
+    export class Builder {
+        constructor(options: SandboxDefinition<TransportType> | SandboxUnresolvedDefinition<TransportType>);
+
+        view(builder: ViewBuilder): this;
+
+        build(): Promise<void>;
+    }
+}
+
 declare module "adnbn/offscreen" {
     export class OffscreenBackground {
         build(): void | Promise<void>;

package/dist/entry/sandbox/Builder.d.ts

@@ -0,0 +1,15 @@
+import TransportBuilder from "./TransportBuilder.js";
+import Builder from "../core/Builder.js";
+import { SandboxUnresolvedDefinition } from "../../types/sandbox.js";
+import { TransportType } from "../../types/transport.js";
+import { ViewBuilder } from "../../types/view.js";
+export default class<T extends TransportType = TransportType> extends Builder {
+    protected readonly _transport: TransportBuilder<T>;
+    protected _view?: ViewBuilder;
+    private readonly name;
+    constructor(definition: SandboxUnresolvedDefinition<T>);
+    view(view: ViewBuilder): this;
+    build(): Promise<void>;
+    destroy(): Promise<void>;
+    private ready;
+}

package/dist/entry/sandbox/Builder.js

@@ -0,0 +1,51 @@
+import TransportBuilder from "./TransportBuilder.js";
+import Builder from "../core/Builder.js";
+import { sandboxChannel } from "./../../sandbox/utils.js";
+import {
+  SandboxGlobalAccess,
+  SandboxReadyMessageType
+} from "./../../types/sandbox.js";
+class Builder_default extends Builder {
+  _transport;
+  _view;
+  name;
+  constructor(definition) {
+    super();
+    this.name = definition.name;
+    this._transport = new TransportBuilder(definition);
+  }
+  view(view) {
+    this._view = view;
+    return this;
+  }
+  async build() {
+    var _a;
+    await this.destroy();
+    globalThis[SandboxGlobalAccess] = true;
+    await this._transport.build();
+    await ((_a = this._view) == null ? void 0 : _a.build());
+    this.ready();
+  }
+  async destroy() {
+    var _a;
+    await this._transport.destroy();
+    await ((_a = this._view) == null ? void 0 : _a.destroy());
+  }
+  ready() {
+    if (window.parent === window) {
+      return;
+    }
+    window.parent.postMessage(
+      {
+        type: SandboxReadyMessageType,
+        channel: sandboxChannel(this.name),
+        name: this.name
+      },
+      "*"
+    );
+  }
+}
+export {
+  Builder_default as default
+};
+//# sourceMappingURL=Builder.js.map

package/dist/entry/sandbox/Builder.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/entry/sandbox/Builder.ts"],"sourcesContent":["import TransportBuilder from \"./TransportBuilder\";\n\nimport Builder from \"../core/Builder\";\n\nimport {sandboxChannel} from \"@sandbox/utils\";\n\nimport {\n    SandboxGlobalAccess,\n    SandboxReadyMessage,\n    SandboxReadyMessageType,\n    SandboxUnresolvedDefinition,\n} from \"@typing/sandbox\";\nimport {TransportType} from \"@typing/transport\";\nimport {ViewBuilder} from \"@typing/view\";\n\nexport default class<T extends TransportType = TransportType> extends Builder {\n    protected readonly _transport: TransportBuilder<T>;\n\n    protected _view?: ViewBuilder;\n\n    private readonly name: string;\n\n    constructor(definition: SandboxUnresolvedDefinition<T>) {\n        super();\n\n        this.name = definition.name!;\n        this._transport = new TransportBuilder(definition);\n    }\n\n    public view(view: ViewBuilder): this {\n        this._view = view;\n\n        return this;\n    }\n\n    public async build(): Promise<void> {\n        await this.destroy();\n\n        globalThis[SandboxGlobalAccess] = true;\n\n        await this._transport.build();\n        await this._view?.build();\n\n        this.ready();\n    }\n\n    public async destroy(): Promise<void> {\n        await this._transport.destroy();\n        await this._view?.destroy();\n    }\n\n    private ready(): void {\n        if (window.parent === window) {\n            return;\n        }\n\n        window.parent.postMessage(\n            {\n                type: SandboxReadyMessageType,\n                channel: sandboxChannel(this.name),\n                name: this.name,\n            } satisfies SandboxReadyMessage,\n            \"*\"\n        );\n    }\n}\n"],"mappings":"AAAA,OAAO,sBAAsB;AAE7B,OAAO,aAAa;AAEpB,SAAQ,sBAAqB;AAE7B;AAAA,EACI;AAAA,EAEA;AAAA,OAEG;AAIP,MAAO,wBAA+D,QAAQ;AAAA,EACvD;AAAA,EAET;AAAA,EAEO;AAAA,EAEjB,YAAY,YAA4C;AACpD,UAAM;AAEN,SAAK,OAAO,WAAW;AACvB,SAAK,aAAa,IAAI,iBAAiB,UAAU;AAAA,EACrD;AAAA,EAEO,KAAK,MAAyB;AACjC,SAAK,QAAQ;AAEb,WAAO;AAAA,EACX;AAAA,EAEA,MAAa,QAAuB;AAnCxC;AAoCQ,UAAM,KAAK,QAAQ;AAEnB,eAAW,mBAAmB,IAAI;AAElC,UAAM,KAAK,WAAW,MAAM;AAC5B,YAAM,UAAK,UAAL,mBAAY;AAElB,SAAK,MAAM;AAAA,EACf;AAAA,EAEA,MAAa,UAAyB;AA9C1C;AA+CQ,UAAM,KAAK,WAAW,QAAQ;AAC9B,YAAM,UAAK,UAAL,mBAAY;AAAA,EACtB;AAAA,EAEQ,QAAc;AAClB,QAAI,OAAO,WAAW,QAAQ;AAC1B;AAAA,IACJ;AAEA,WAAO,OAAO;AAAA,MACV;AAAA,QACI,MAAM;AAAA,QACN,SAAS,eAAe,KAAK,IAAI;AAAA,QACjC,MAAM,KAAK;AAAA,MACf;AAAA,MACA;AAAA,IACJ;AAAA,EACJ;AACJ;","names":[]}

package/dist/entry/sandbox/TransportBuilder.d.ts

@@ -0,0 +1,8 @@
+import AbstractBuilder from "../transport/AbstractBuilder.js";
+import { RegisterSandbox } from "../../sandbox/providers/index.js";
+import type { SandboxOptions, SandboxUnresolvedDefinition } from "../../types/sandbox.js";
+import type { TransportName, TransportType } from "../../types/transport.js";
+export default class<T extends TransportType = TransportType> extends AbstractBuilder<SandboxOptions, T> {
+    constructor(definition: SandboxUnresolvedDefinition<T>);
+    protected transport(): RegisterSandbox<TransportName, T, [SandboxOptions]>;
+}

package/dist/entry/sandbox/TransportBuilder.js

@@ -0,0 +1,15 @@
+import AbstractBuilder from "./../../entry/transport/AbstractBuilder.js";
+import { RegisterSandbox } from "./../../sandbox/providers/index.js";
+class TransportBuilder_default extends AbstractBuilder {
+  constructor(definition) {
+    super(definition);
+  }
+  transport() {
+    const { name, init } = this.definition;
+    return new RegisterSandbox(name, init);
+  }
+}
+export {
+  TransportBuilder_default as default
+};
+//# sourceMappingURL=TransportBuilder.js.map

package/dist/entry/sandbox/TransportBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/entry/sandbox/TransportBuilder.ts"],"sourcesContent":["import AbstractBuilder from \"@entry/transport/AbstractBuilder\";\n\nimport {RegisterSandbox} from \"@sandbox/providers\";\n\nimport type {SandboxOptions, SandboxUnresolvedDefinition} from \"@typing/sandbox\";\nimport type {TransportName, TransportType} from \"@typing/transport\";\n\nexport default class<T extends TransportType = TransportType> extends AbstractBuilder<SandboxOptions, T> {\n    constructor(definition: SandboxUnresolvedDefinition<T>) {\n        super(definition);\n    }\n\n    protected transport(): RegisterSandbox<TransportName, T, [SandboxOptions]> {\n        const {name, init} = this.definition;\n\n        return new RegisterSandbox(name, init);\n    }\n}\n"],"mappings":"AAAA,OAAO,qBAAqB;AAE5B,SAAQ,uBAAsB;AAK9B,MAAO,iCAA+D,gBAAmC;AAAA,EACrG,YAAY,YAA4C;AACpD,UAAM,UAAU;AAAA,EACpB;AAAA,EAEU,YAAiE;AACvE,UAAM,EAAC,MAAM,KAAI,IAAI,KAAK;AAE1B,WAAO,IAAI,gBAAgB,MAAM,IAAI;AAAA,EACzC;AACJ;","names":[]}

package/dist/entry/sandbox/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Builder } from "./Builder.js";
+export { default as TransportBuilder } from "./TransportBuilder.js";

package/dist/entry/sandbox/index.js

@@ -0,0 +1,7 @@
+import { default as default2 } from "./Builder.js";
+import { default as default3 } from "./TransportBuilder.js";
+export {
+  default2 as Builder,
+  default3 as TransportBuilder
+};
+//# sourceMappingURL=index.js.map

package/dist/entry/sandbox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/entry/sandbox/index.ts"],"sourcesContent":["export {default as Builder} from \"./Builder\";\nexport {default as TransportBuilder} from \"./TransportBuilder\";\n"],"mappings":"AAAA,SAAmB,WAAXA,gBAAyB;AACjC,SAAmB,WAAXA,gBAAkC;","names":["default"]}

package/dist/frame/ReadyFrame.d.ts

@@ -0,0 +1,25 @@
+export interface ReadyFrameParams {
+    key: string;
+    url: string;
+    readyTimeout?: number;
+    isReady: (event: MessageEvent, frame: HTMLIFrameElement) => boolean;
+    readyTimeoutMessage?: (loaded: boolean, readyTimeout: number) => string;
+    loadErrorMessage?: () => string;
+}
+/**
+ * Creates and tracks a hidden iframe that announces readiness via `postMessage`, resolving once
+ * the injected `isReady` matcher accepts an inbound message — or rejecting on load error / ready
+ * timeout. Concurrent `make` calls for the same `key` share a single creation.
+ *
+ * The `isReady` matcher is the seam: each caller decides how to recognize and *trust* its own
+ * ready signal (a sandboxed frame has an opaque origin and matches by channel/name; a same-origin
+ * frame additionally matches by `event.origin`). Keeping that decision out here is what lets one
+ * deep module serve both the sandbox and the offscreen-fallback frames.
+ */
+export default class ReadyFrame {
+    private readonly frames;
+    private readonly pending;
+    make(params: ReadyFrameParams): Promise<HTMLIFrameElement>;
+    remove(key: string): void;
+    private create;
+}

package/dist/frame/ReadyFrame.js

@@ -0,0 +1,86 @@
+const DefaultReadyTimeout = 1e4;
+class ReadyFrame {
+  frames = /* @__PURE__ */ new Map();
+  pending = /* @__PURE__ */ new Map();
+  async make(params) {
+    if (typeof window === "undefined" || typeof document === "undefined" || !document.body) {
+      throw new Error("A frame can be created only from a page with DOM access.");
+    }
+    const entry = this.frames.get(params.key);
+    if ((entry == null ? void 0 : entry.ready) && entry.element.isConnected && entry.element.contentWindow) {
+      return entry.element;
+    }
+    const pending = this.pending.get(params.key);
+    if (pending) {
+      return pending;
+    }
+    const creation = this.create(params);
+    this.pending.set(params.key, creation);
+    try {
+      return await creation;
+    } finally {
+      this.pending.delete(params.key);
+    }
+  }
+  remove(key) {
+    var _a;
+    (_a = this.frames.get(key)) == null ? void 0 : _a.element.remove();
+    this.frames.delete(key);
+    this.pending.delete(key);
+  }
+  create(params) {
+    const { key, url, readyTimeout = DefaultReadyTimeout, isReady } = params;
+    return new Promise((resolve, reject) => {
+      var _a;
+      const existing = (_a = this.frames.get(key)) == null ? void 0 : _a.element;
+      const frame = (existing == null ? void 0 : existing.isConnected) ? existing : document.createElement("iframe");
+      let loaded = false;
+      const cleanup = () => {
+        clearTimeout(timeout);
+        window.removeEventListener("message", listener);
+        frame.onload = null;
+        frame.onerror = null;
+      };
+      const fail = (error) => {
+        cleanup();
+        frame.remove();
+        this.frames.delete(key);
+        reject(error);
+      };
+      const listener = (event) => {
+        if (!isReady(event, frame)) {
+          return;
+        }
+        this.frames.set(key, { element: frame, ready: true });
+        cleanup();
+        resolve(frame);
+      };
+      const timeout = setTimeout(() => {
+        var _a2;
+        fail(
+          new Error(
+            ((_a2 = params.readyTimeoutMessage) == null ? void 0 : _a2.call(params, loaded, readyTimeout)) ?? `Frame "${key}" was not ready within ${readyTimeout}ms.`
+          )
+        );
+      }, readyTimeout);
+      frame.onload = () => {
+        loaded = true;
+      };
+      frame.onerror = () => {
+        var _a2;
+        fail(new Error(((_a2 = params.loadErrorMessage) == null ? void 0 : _a2.call(params)) ?? `Frame "${key}" failed to load: ${url}`));
+      };
+      frame.hidden = true;
+      window.addEventListener("message", listener);
+      if (!frame.parentElement) {
+        frame.src = url;
+        document.body.appendChild(frame);
+      }
+      this.frames.set(key, { element: frame, ready: false });
+    });
+  }
+}
+export {
+  ReadyFrame as default
+};
+//# sourceMappingURL=ReadyFrame.js.map

package/dist/frame/ReadyFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/frame/ReadyFrame.ts"],"sourcesContent":["export interface ReadyFrameParams {\n    key: string;\n    url: string;\n    readyTimeout?: number;\n    isReady: (event: MessageEvent, frame: HTMLIFrameElement) => boolean;\n    readyTimeoutMessage?: (loaded: boolean, readyTimeout: number) => string;\n    loadErrorMessage?: () => string;\n}\n\nconst DefaultReadyTimeout = 10000;\n\n/**\n * Creates and tracks a hidden iframe that announces readiness via `postMessage`, resolving once\n * the injected `isReady` matcher accepts an inbound message — or rejecting on load error / ready\n * timeout. Concurrent `make` calls for the same `key` share a single creation.\n *\n * The `isReady` matcher is the seam: each caller decides how to recognize and *trust* its own\n * ready signal (a sandboxed frame has an opaque origin and matches by channel/name; a same-origin\n * frame additionally matches by `event.origin`). Keeping that decision out here is what lets one\n * deep module serve both the sandbox and the offscreen-fallback frames.\n */\nexport default class ReadyFrame {\n    private readonly frames: Map<string, {element: HTMLIFrameElement; ready: boolean}> = new Map();\n\n    private readonly pending: Map<string, Promise<HTMLIFrameElement>> = new Map();\n\n    public async make(params: ReadyFrameParams): Promise<HTMLIFrameElement> {\n        if (typeof window === \"undefined\" || typeof document === \"undefined\" || !document.body) {\n            throw new Error(\"A frame can be created only from a page with DOM access.\");\n        }\n\n        const entry = this.frames.get(params.key);\n\n        if (entry?.ready && entry.element.isConnected && entry.element.contentWindow) {\n            return entry.element;\n        }\n\n        const pending = this.pending.get(params.key);\n\n        if (pending) {\n            return pending;\n        }\n\n        const creation = this.create(params);\n\n        this.pending.set(params.key, creation);\n\n        try {\n            return await creation;\n        } finally {\n            this.pending.delete(params.key);\n        }\n    }\n\n    public remove(key: string): void {\n        this.frames.get(key)?.element.remove();\n        this.frames.delete(key);\n        this.pending.delete(key);\n    }\n\n    private create(params: ReadyFrameParams): Promise<HTMLIFrameElement> {\n        const {key, url, readyTimeout = DefaultReadyTimeout, isReady} = params;\n\n        return new Promise((resolve, reject) => {\n            const existing = this.frames.get(key)?.element;\n            const frame = existing?.isConnected ? existing : document.createElement(\"iframe\");\n\n            let loaded = false;\n\n            const cleanup = () => {\n                clearTimeout(timeout);\n                window.removeEventListener(\"message\", listener);\n                frame.onload = null;\n                frame.onerror = null;\n            };\n\n            const fail = (error: Error) => {\n                cleanup();\n                frame.remove();\n                this.frames.delete(key);\n                reject(error);\n            };\n\n            const listener = (event: MessageEvent) => {\n                if (!isReady(event, frame)) {\n                    return;\n                }\n\n                this.frames.set(key, {element: frame, ready: true});\n\n                cleanup();\n                resolve(frame);\n            };\n\n            const timeout = setTimeout(() => {\n                fail(\n                    new Error(\n                        params.readyTimeoutMessage?.(loaded, readyTimeout) ??\n                            `Frame \"${key}\" was not ready within ${readyTimeout}ms.`\n                    )\n                );\n            }, readyTimeout);\n\n            frame.onload = () => {\n                loaded = true;\n            };\n\n            frame.onerror = () => {\n                fail(new Error(params.loadErrorMessage?.() ?? `Frame \"${key}\" failed to load: ${url}`));\n            };\n\n            frame.hidden = true;\n\n            window.addEventListener(\"message\", listener);\n\n            if (!frame.parentElement) {\n                frame.src = url;\n                document.body.appendChild(frame);\n            }\n\n            this.frames.set(key, {element: frame, ready: false});\n        });\n    }\n}\n"],"mappings":"AASA,MAAM,sBAAsB;AAY5B,MAAO,WAAyB;AAAA,EACX,SAAoE,oBAAI,IAAI;AAAA,EAE5E,UAAmD,oBAAI,IAAI;AAAA,EAE5E,MAAa,KAAK,QAAsD;AACpE,QAAI,OAAO,WAAW,eAAe,OAAO,aAAa,eAAe,CAAC,SAAS,MAAM;AACpF,YAAM,IAAI,MAAM,0DAA0D;AAAA,IAC9E;AAEA,UAAM,QAAQ,KAAK,OAAO,IAAI,OAAO,GAAG;AAExC,SAAI,+BAAO,UAAS,MAAM,QAAQ,eAAe,MAAM,QAAQ,eAAe;AAC1E,aAAO,MAAM;AAAA,IACjB;AAEA,UAAM,UAAU,KAAK,QAAQ,IAAI,OAAO,GAAG;AAE3C,QAAI,SAAS;AACT,aAAO;AAAA,IACX;AAEA,UAAM,WAAW,KAAK,OAAO,MAAM;AAEnC,SAAK,QAAQ,IAAI,OAAO,KAAK,QAAQ;AAErC,QAAI;AACA,aAAO,MAAM;AAAA,IACjB,UAAE;AACE,WAAK,QAAQ,OAAO,OAAO,GAAG;AAAA,IAClC;AAAA,EACJ;AAAA,EAEO,OAAO,KAAmB;AAtDrC;AAuDQ,eAAK,OAAO,IAAI,GAAG,MAAnB,mBAAsB,QAAQ;AAC9B,SAAK,OAAO,OAAO,GAAG;AACtB,SAAK,QAAQ,OAAO,GAAG;AAAA,EAC3B;AAAA,EAEQ,OAAO,QAAsD;AACjE,UAAM,EAAC,KAAK,KAAK,eAAe,qBAAqB,QAAO,IAAI;AAEhE,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AA/DhD;AAgEY,YAAM,YAAW,UAAK,OAAO,IAAI,GAAG,MAAnB,mBAAsB;AACvC,YAAM,SAAQ,qCAAU,eAAc,WAAW,SAAS,cAAc,QAAQ;AAEhF,UAAI,SAAS;AAEb,YAAM,UAAU,MAAM;AAClB,qBAAa,OAAO;AACpB,eAAO,oBAAoB,WAAW,QAAQ;AAC9C,cAAM,SAAS;AACf,cAAM,UAAU;AAAA,MACpB;AAEA,YAAM,OAAO,CAAC,UAAiB;AAC3B,gBAAQ;AACR,cAAM,OAAO;AACb,aAAK,OAAO,OAAO,GAAG;AACtB,eAAO,KAAK;AAAA,MAChB;AAEA,YAAM,WAAW,CAAC,UAAwB;AACtC,YAAI,CAAC,QAAQ,OAAO,KAAK,GAAG;AACxB;AAAA,QACJ;AAEA,aAAK,OAAO,IAAI,KAAK,EAAC,SAAS,OAAO,OAAO,KAAI,CAAC;AAElD,gBAAQ;AACR,gBAAQ,KAAK;AAAA,MACjB;AAEA,YAAM,UAAU,WAAW,MAAM;AA9F7C,YAAAA;AA+FgB;AAAA,UACI,IAAI;AAAA,cACAA,MAAA,OAAO,wBAAP,gBAAAA,IAAA,aAA6B,QAAQ,kBACjC,UAAU,GAAG,0BAA0B,YAAY;AAAA,UAC3D;AAAA,QACJ;AAAA,MACJ,GAAG,YAAY;AAEf,YAAM,SAAS,MAAM;AACjB,iBAAS;AAAA,MACb;AAEA,YAAM,UAAU,MAAM;AA3GlC,YAAAA;AA4GgB,aAAK,IAAI,QAAMA,MAAA,OAAO,qBAAP,gBAAAA,IAAA,iBAA+B,UAAU,GAAG,qBAAqB,GAAG,EAAE,CAAC;AAAA,MAC1F;AAEA,YAAM,SAAS;AAEf,aAAO,iBAAiB,WAAW,QAAQ;AAE3C,UAAI,CAAC,MAAM,eAAe;AACtB,cAAM,MAAM;AACZ,iBAAS,KAAK,YAAY,KAAK;AAAA,MACnC;AAEA,WAAK,OAAO,IAAI,KAAK,EAAC,SAAS,OAAO,OAAO,MAAK,CAAC;AAAA,IACvD,CAAC;AAAA,EACL;AACJ;","names":["_a"]}

package/dist/frame/index.d.ts

@@ -0,0 +1,2 @@
+export { default as ReadyFrame } from "./ReadyFrame.js";
+export type { ReadyFrameParams } from "./ReadyFrame.js";

package/dist/frame/index.js

@@ -0,0 +1,5 @@
+import { default as default2 } from "./ReadyFrame.js";
+export {
+  default2 as ReadyFrame
+};
+//# sourceMappingURL=index.js.map

package/dist/frame/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/frame/index.ts"],"sourcesContent":["export {default as ReadyFrame} from \"./ReadyFrame\";\nexport type {ReadyFrameParams} from \"./ReadyFrame\";\n"],"mappings":"AAAA,SAAmB,WAAXA,gBAA4B;","names":["default"]}

package/dist/main/csp.d.ts

@@ -0,0 +1,2 @@
+export type { CspConfig, CspOptions, CspSources, CspSourceValue } from "../types/csp.js";
+export { CspSource } from "../types/csp.js";

package/dist/main/csp.js

@@ -0,0 +1,5 @@
+import { CspSource } from "./../types/csp.js";
+export {
+  CspSource
+};
+//# sourceMappingURL=csp.js.map

package/dist/main/csp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/main/csp.ts"],"sourcesContent":["export type {CspConfig, CspOptions, CspSources, CspSourceValue} from \"@typing/csp\";\nexport {CspSource} from \"@typing/csp\";\n"],"mappings":"AACA,SAAQ,iBAAgB;","names":[]}

package/dist/main/index.d.ts

@@ -4,6 +4,7 @@ export * from "./browser.js";
 export * from "./command.js";
 export * from "./config.js";
 export * from "./content.js";
+export * from "./csp.js";
 export * from "./env.js";
 export * from "./icon.js";
 export * from "./manifest.js";
@@ -12,6 +13,7 @@ export * from "./page.js";
 export * from "./plugin.js";
 export * from "./popup.js";
 export * from "./relay.js";
+export * from "./sandbox.js";
 export * from "./service.js";
 export * from "./sidebar.js";
 export * from "./view.js";

package/dist/main/index.js

@@ -4,6 +4,7 @@ export * from "./browser.js";
 export * from "./command.js";
 export * from "./config.js";
 export * from "./content.js";
+export * from "./csp.js";
 export * from "./env.js";
 export * from "./icon.js";
 export * from "./manifest.js";
@@ -12,6 +13,7 @@ export * from "./page.js";
 export * from "./plugin.js";
 export * from "./popup.js";
 export * from "./relay.js";
+export * from "./sandbox.js";
 export * from "./service.js";
 export * from "./sidebar.js";
 export * from "./view.js";

package/dist/main/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/main/index.ts"],"sourcesContent":["export * from \"./app\";\nexport * from \"./background\";\nexport * from \"./browser\";\nexport * from \"./command\";\nexport * from \"./config\";\nexport * from \"./content\";\nexport * from \"./env\";\nexport * from \"./icon\";\nexport * from \"./manifest\";\nexport * from \"./offscreen\";\nexport * from \"./page\";\nexport * from \"./plugin\";\nexport * from \"./popup\";\nexport * from \"./relay\";\nexport * from \"./service\";\nexport * from \"./sidebar\";\nexport * from \"./view\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../../src/main/index.ts"],"sourcesContent":["export * from \"./app\";\nexport * from \"./background\";\nexport * from \"./browser\";\nexport * from \"./command\";\nexport * from \"./config\";\nexport * from \"./content\";\nexport * from \"./csp\";\nexport * from \"./env\";\nexport * from \"./icon\";\nexport * from \"./manifest\";\nexport * from \"./offscreen\";\nexport * from \"./page\";\nexport * from \"./plugin\";\nexport * from \"./popup\";\nexport * from \"./relay\";\nexport * from \"./sandbox\";\nexport * from \"./service\";\nexport * from \"./sidebar\";\nexport * from \"./view\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/main/offscreen.d.ts

@@ -1,10 +1,10 @@
 import { type OffscreenDefinition, OffscreenReason, type OffscreenUnresolvedDefinition } from "../types/offscreen.js";
-import { TransportDictionary, TransportType } from "../types/transport.js";
-import { DeepAsyncProxy } from "../types/helpers.js";
+import type { OffscreenName, OffscreenProxyTarget } from "../offscreen/index.js";
+import type { TransportType } from "../types/transport.js";
 type OffscreenParameters = chrome.offscreen.CreateParameters;
 export { OffscreenReason, OffscreenDefinition, OffscreenUnresolvedDefinition };
 export type OffscreenAlias = string;
 export type OffscreenMap = Map<OffscreenAlias, OffscreenParameters>;
 export declare const defineOffscreen: <T extends TransportType>(options: OffscreenDefinition<T>) => OffscreenDefinition<T>;
 export declare const getOffscreens: () => OffscreenMap;
-export declare const getOffscreen: <N extends Extract<keyof TransportDictionary, string>>(name: N) => DeepAsyncProxy<TransportDictionary[N]>;
+export declare const getOffscreen: <N extends OffscreenName>(name: N) => OffscreenProxyTarget<N>;

package/dist/main/offscreen.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/main/offscreen.ts"],"sourcesContent":["import ProxyOffscreen from \"@offscreen/providers/ProxyOffscreen\";\n\nimport {type OffscreenDefinition, OffscreenReason, type OffscreenUnresolvedDefinition} from \"@typing/offscreen\";\nimport {TransportDictionary, TransportType} from \"@typing/transport\";\nimport {DeepAsyncProxy} from \"@typing/helpers\";\n\ntype OffscreenParameters = chrome.offscreen.CreateParameters;\n\nexport {OffscreenReason, OffscreenDefinition, OffscreenUnresolvedDefinition};\n\nexport type OffscreenAlias = string;\n\nexport type OffscreenMap = Map<OffscreenAlias, OffscreenParameters>;\n\nexport const defineOffscreen = <T extends TransportType>(options: OffscreenDefinition<T>): OffscreenDefinition<T> => {\n    return options;\n};\n\nexport const getOffscreens = (): OffscreenMap => {\n    const offscreens: OffscreenMap = new Map();\n\n    try {\n        // @ts-expect-error: __ADNBN_OFFSCREEN_PARAMETERS__ is a virtual variable generated by the bundler `src/cli/plugins/offscreen/index.ts`\n        Object.entries<OffscreenParameters>(__ADNBN_OFFSCREEN_PARAMETERS__).forEach(([key, value]) => {\n            offscreens.set(key, value);\n        });\n    } catch (e) {\n        console.error(\"Failed getting offscreens: \", e);\n    }\n\n    return offscreens;\n};\n\nexport const getOffscreen = <N extends Extract<keyof TransportDictionary, string>>(\n    name: N\n): DeepAsyncProxy<TransportDictionary[N]> => {\n    const parameters = getOffscreens().get(name);\n\n    if (!parameters) {\n        throw new Error(`Unable to get offscreen: ${name}`);\n    }\n\n    return new ProxyOffscreen(name, parameters).get();\n};\n"],"mappings":"AAAA,OAAO,oBAAoB;AAE3B,SAAkC,uBAA0D;AAYrF,MAAM,kBAAkB,CAA0B,YAA4D;AACjH,SAAO;AACX;AAEO,MAAM,gBAAgB,MAAoB;AAC7C,QAAM,aAA2B,oBAAI,IAAI;AAEzC,MAAI;AAEA,WAAO,QAA6B,8BAA8B,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC1F,iBAAW,IAAI,KAAK,KAAK;AAAA,IAC7B,CAAC;AAAA,EACL,SAAS,GAAG;AACR,YAAQ,MAAM,+BAA+B,CAAC;AAAA,EAClD;AAEA,SAAO;AACX;AAEO,MAAM,eAAe,CACxB,SACyC;AACzC,QAAM,aAAa,cAAc,EAAE,IAAI,IAAI;AAE3C,MAAI,CAAC,YAAY;AACb,UAAM,IAAI,MAAM,4BAA4B,IAAI,EAAE;AAAA,EACtD;AAEA,SAAO,IAAI,eAAe,MAAM,UAAU,EAAE,IAAI;AACpD;","names":[]}
+{"version":3,"sources":["../../src/main/offscreen.ts"],"sourcesContent":["import ProxyOffscreen from \"@offscreen/providers/ProxyOffscreen\";\n\nimport {type OffscreenDefinition, OffscreenReason, type OffscreenUnresolvedDefinition} from \"@typing/offscreen\";\nimport type {OffscreenName, OffscreenProxyTarget} from \"@offscreen/index\";\nimport type {TransportType} from \"@typing/transport\";\n\ntype OffscreenParameters = chrome.offscreen.CreateParameters;\n\nexport {OffscreenReason, OffscreenDefinition, OffscreenUnresolvedDefinition};\n\nexport type OffscreenAlias = string;\n\nexport type OffscreenMap = Map<OffscreenAlias, OffscreenParameters>;\n\nexport const defineOffscreen = <T extends TransportType>(options: OffscreenDefinition<T>): OffscreenDefinition<T> => {\n    return options;\n};\n\nexport const getOffscreens = (): OffscreenMap => {\n    const offscreens: OffscreenMap = new Map();\n\n    try {\n        // @ts-expect-error: __ADNBN_OFFSCREEN_PARAMETERS__ is a virtual variable generated by the bundler `src/cli/plugins/offscreen/index.ts`\n        Object.entries<OffscreenParameters>(__ADNBN_OFFSCREEN_PARAMETERS__).forEach(([key, value]) => {\n            offscreens.set(key, value);\n        });\n    } catch (e) {\n        console.error(\"Failed getting offscreens: \", e);\n    }\n\n    return offscreens;\n};\n\nexport const getOffscreen = <N extends OffscreenName>(name: N): OffscreenProxyTarget<N> => {\n    const parameters = getOffscreens().get(name);\n\n    if (!parameters) {\n        throw new Error(`Unable to get offscreen: ${name}`);\n    }\n\n    return new ProxyOffscreen(name, parameters).get();\n};\n"],"mappings":"AAAA,OAAO,oBAAoB;AAE3B,SAAkC,uBAA0D;AAYrF,MAAM,kBAAkB,CAA0B,YAA4D;AACjH,SAAO;AACX;AAEO,MAAM,gBAAgB,MAAoB;AAC7C,QAAM,aAA2B,oBAAI,IAAI;AAEzC,MAAI;AAEA,WAAO,QAA6B,8BAA8B,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC1F,iBAAW,IAAI,KAAK,KAAK;AAAA,IAC7B,CAAC;AAAA,EACL,SAAS,GAAG;AACR,YAAQ,MAAM,+BAA+B,CAAC;AAAA,EAClD;AAEA,SAAO;AACX;AAEO,MAAM,eAAe,CAA0B,SAAqC;AACvF,QAAM,aAAa,cAAc,EAAE,IAAI,IAAI;AAE3C,MAAI,CAAC,YAAY;AACb,UAAM,IAAI,MAAM,4BAA4B,IAAI,EAAE;AAAA,EACtD;AAEA,SAAO,IAAI,eAAe,MAAM,UAAU,EAAE,IAAI;AACpD;","names":[]}

package/dist/main/relay.d.ts

@@ -1,8 +1,8 @@
 import { type ProxyRelayParams } from "../relay/providers/index.js";
-import { DeepAsyncProxy } from "../types/helpers.js";
-import { TransportDictionary, TransportType } from "../types/transport.js";
+import type { RelayName, RelayProxyTarget } from "../relay/index.js";
+import type { TransportType } from "../types/transport.js";
 import { RelayDefinition, RelayMethod, RelayUnresolvedDefinition } from "../types/relay.js";
 export { RelayMethod };
 export type { RelayDefinition, RelayUnresolvedDefinition };
 export declare const defineRelay: <T extends TransportType>(options: RelayDefinition<T>) => RelayDefinition<T>;
-export declare const getRelay: <N extends Extract<keyof TransportDictionary, string>>(name: N, params: ProxyRelayParams) => DeepAsyncProxy<TransportDictionary[N]>;
+export declare const getRelay: <N extends RelayName>(name: N, params: ProxyRelayParams) => RelayProxyTarget<N>;

package/dist/main/relay.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/main/relay.ts"],"sourcesContent":["import RelayPermission from \"@relay/RelayPermission\";\nimport {ProxyRelay, type ProxyRelayParams} from \"@relay/providers\";\n\nimport {DeepAsyncProxy} from \"@typing/helpers\";\nimport {TransportDictionary, TransportType} from \"@typing/transport\";\nimport {RelayDefinition, RelayMethod, RelayOptions, RelayOptionsMap, RelayUnresolvedDefinition} from \"@typing/relay\";\n\nexport {RelayMethod};\nexport type {RelayDefinition, RelayUnresolvedDefinition};\n\nexport const defineRelay = <T extends TransportType>(options: RelayDefinition<T>): RelayDefinition<T> => {\n    return options;\n};\n\nconst getRelayOptionsMap = (): RelayOptionsMap => {\n    const relays: RelayOptionsMap = new Map();\n\n    try {\n        // @ts-expect-error: __ADNBN_RELAY_OPTIONS__ is a virtual variable generated by the bundler `src/cli/plugins/content/index.ts`\n        Object.entries<RelayOptions>(__ADNBN_RELAY_OPTIONS__).forEach(([key, value]) => relays.set(key, value));\n    } catch (e) {\n        console.error(\"Failed getting relays: \", e);\n    }\n\n    return relays;\n};\n\nexport const getRelay = <N extends Extract<keyof TransportDictionary, string>>(\n    name: N,\n    params: ProxyRelayParams\n): DeepAsyncProxy<TransportDictionary[N]> => {\n    const relays = getRelayOptionsMap();\n\n    RelayPermission.init(relays);\n\n    const options = relays.get(name);\n\n    if (!options) {\n        throw new Error(`Failed to get relay \"${name}\"`);\n    }\n\n    return new ProxyRelay(name, options, params).get();\n};\n"],"mappings":"AAAA,OAAO,qBAAqB;AAC5B,SAAQ,kBAAwC;AAIhD,SAAyB,mBAA4E;AAK9F,MAAM,cAAc,CAA0B,YAAoD;AACrG,SAAO;AACX;AAEA,MAAM,qBAAqB,MAAuB;AAC9C,QAAM,SAA0B,oBAAI,IAAI;AAExC,MAAI;AAEA,WAAO,QAAsB,uBAAuB,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM,OAAO,IAAI,KAAK,KAAK,CAAC;AAAA,EAC1G,SAAS,GAAG;AACR,YAAQ,MAAM,2BAA2B,CAAC;AAAA,EAC9C;AAEA,SAAO;AACX;AAEO,MAAM,WAAW,CACpB,MACA,WACyC;AACzC,QAAM,SAAS,mBAAmB;AAElC,kBAAgB,KAAK,MAAM;AAE3B,QAAM,UAAU,OAAO,IAAI,IAAI;AAE/B,MAAI,CAAC,SAAS;AACV,UAAM,IAAI,MAAM,wBAAwB,IAAI,GAAG;AAAA,EACnD;AAEA,SAAO,IAAI,WAAW,MAAM,SAAS,MAAM,EAAE,IAAI;AACrD;","names":[]}
+{"version":3,"sources":["../../src/main/relay.ts"],"sourcesContent":["import RelayPermission from \"@relay/RelayPermission\";\nimport {ProxyRelay, type ProxyRelayParams} from \"@relay/providers\";\n\nimport type {RelayName, RelayProxyTarget} from \"@relay/index\";\nimport type {TransportType} from \"@typing/transport\";\nimport {RelayDefinition, RelayMethod, RelayOptions, RelayOptionsMap, RelayUnresolvedDefinition} from \"@typing/relay\";\n\nexport {RelayMethod};\nexport type {RelayDefinition, RelayUnresolvedDefinition};\n\nexport const defineRelay = <T extends TransportType>(options: RelayDefinition<T>): RelayDefinition<T> => {\n    return options;\n};\n\nconst getRelayOptionsMap = (): RelayOptionsMap => {\n    const relays: RelayOptionsMap = new Map();\n\n    try {\n        // @ts-expect-error: __ADNBN_RELAY_OPTIONS__ is a virtual variable generated by the bundler `src/cli/plugins/content/index.ts`\n        Object.entries<RelayOptions>(__ADNBN_RELAY_OPTIONS__).forEach(([key, value]) => relays.set(key, value));\n    } catch (e) {\n        console.error(\"Failed getting relays: \", e);\n    }\n\n    return relays;\n};\n\nexport const getRelay = <N extends RelayName>(name: N, params: ProxyRelayParams): RelayProxyTarget<N> => {\n    const relays = getRelayOptionsMap();\n\n    RelayPermission.init(relays);\n\n    const options = relays.get(name);\n\n    if (!options) {\n        throw new Error(`Failed to get relay \"${name}\"`);\n    }\n\n    return new ProxyRelay(name, options, params).get();\n};\n"],"mappings":"AAAA,OAAO,qBAAqB;AAC5B,SAAQ,kBAAwC;AAIhD,SAAyB,mBAA4E;AAK9F,MAAM,cAAc,CAA0B,YAAoD;AACrG,SAAO;AACX;AAEA,MAAM,qBAAqB,MAAuB;AAC9C,QAAM,SAA0B,oBAAI,IAAI;AAExC,MAAI;AAEA,WAAO,QAAsB,uBAAuB,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM,OAAO,IAAI,KAAK,KAAK,CAAC;AAAA,EAC1G,SAAS,GAAG;AACR,YAAQ,MAAM,2BAA2B,CAAC;AAAA,EAC9C;AAEA,SAAO;AACX;AAEO,MAAM,WAAW,CAAsB,MAAS,WAAkD;AACrG,QAAM,SAAS,mBAAmB;AAElC,kBAAgB,KAAK,MAAM;AAE3B,QAAM,UAAU,OAAO,IAAI,IAAI;AAE/B,MAAI,CAAC,SAAS;AACV,UAAM,IAAI,MAAM,wBAAwB,IAAI,GAAG;AAAA,EACnD;AAEA,SAAO,IAAI,WAAW,MAAM,SAAS,MAAM,EAAE,IAAI;AACrD;","names":[]}

package/dist/main/sandbox.d.ts

@@ -0,0 +1,9 @@
+import { SandboxDefinition, SandboxParameters } from "../types/sandbox.js";
+import type { SandboxName, SandboxProxyTarget } from "../sandbox/index.js";
+import type { TransportType } from "../types/transport.js";
+export * from "../types/sandbox.js";
+export type SandboxAlias = string;
+export type SandboxMap = Map<SandboxAlias, SandboxParameters>;
+export declare const defineSandbox: <T extends TransportType>(options: SandboxDefinition<T>) => SandboxDefinition<T>;
+export declare const getSandboxes: () => SandboxMap;
+export declare const getSandbox: <N extends SandboxName>(name: N) => SandboxProxyTarget<N>;

package/dist/main/sandbox.js

@@ -0,0 +1,29 @@
+import { ProxySandbox } from "./../sandbox/providers/index.js";
+export * from "./../types/sandbox.js";
+const defineSandbox = (options) => {
+  return options;
+};
+const getSandboxes = () => {
+  const sandboxes = /* @__PURE__ */ new Map();
+  try {
+    Object.entries(__ADNBN_SANDBOX_PARAMETERS__).forEach(([key, value]) => {
+      sandboxes.set(key, value);
+    });
+  } catch (e) {
+    console.error("Failed getting sandboxes: ", e);
+  }
+  return sandboxes;
+};
+const getSandbox = (name) => {
+  const parameters = getSandboxes().get(name);
+  if (!parameters) {
+    throw new Error(`Unable to get sandbox: ${name}`);
+  }
+  return new ProxySandbox(name, parameters).get();
+};
+export {
+  defineSandbox,
+  getSandbox,
+  getSandboxes
+};
+//# sourceMappingURL=sandbox.js.map

package/dist/main/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/main/sandbox.ts"],"sourcesContent":["import {ProxySandbox} from \"@sandbox/providers\";\n\nimport {SandboxDefinition, SandboxParameters, SandboxUnresolvedDefinition} from \"@typing/sandbox\";\nimport type {SandboxName, SandboxProxyTarget} from \"@sandbox/index\";\nimport type {TransportType} from \"@typing/transport\";\n\nexport * from \"@typing/sandbox\";\n\nexport type SandboxAlias = string;\n\nexport type SandboxMap = Map<SandboxAlias, SandboxParameters>;\n\nexport const defineSandbox = <T extends TransportType>(options: SandboxDefinition<T>): SandboxDefinition<T> => {\n    return options;\n};\n\nexport const getSandboxes = (): SandboxMap => {\n    const sandboxes: SandboxMap = new Map();\n\n    try {\n        // @ts-expect-error: __ADNBN_SANDBOX_PARAMETERS__ is a virtual variable generated by the sandbox plugin.\n        Object.entries<SandboxParameters>(__ADNBN_SANDBOX_PARAMETERS__).forEach(([key, value]) => {\n            sandboxes.set(key, value);\n        });\n    } catch (e) {\n        console.error(\"Failed getting sandboxes: \", e);\n    }\n\n    return sandboxes;\n};\n\nexport const getSandbox = <N extends SandboxName>(name: N): SandboxProxyTarget<N> => {\n    const parameters = getSandboxes().get(name);\n\n    if (!parameters) {\n        throw new Error(`Unable to get sandbox: ${name}`);\n    }\n\n    return new ProxySandbox(name, parameters).get() as SandboxProxyTarget<N>;\n};\n"],"mappings":"AAAA,SAAQ,oBAAmB;AAM3B,cAAc;AAMP,MAAM,gBAAgB,CAA0B,YAAwD;AAC3G,SAAO;AACX;AAEO,MAAM,eAAe,MAAkB;AAC1C,QAAM,YAAwB,oBAAI,IAAI;AAEtC,MAAI;AAEA,WAAO,QAA2B,4BAA4B,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AACtF,gBAAU,IAAI,KAAK,KAAK;AAAA,IAC5B,CAAC;AAAA,EACL,SAAS,GAAG;AACR,YAAQ,MAAM,8BAA8B,CAAC;AAAA,EACjD;AAEA,SAAO;AACX;AAEO,MAAM,aAAa,CAAwB,SAAmC;AACjF,QAAM,aAAa,aAAa,EAAE,IAAI,IAAI;AAE1C,MAAI,CAAC,YAAY;AACb,UAAM,IAAI,MAAM,0BAA0B,IAAI,EAAE;AAAA,EACpD;AAEA,SAAO,IAAI,aAAa,MAAM,UAAU,EAAE,IAAI;AAClD;","names":[]}

package/dist/main/service.d.ts

@@ -1,6 +1,6 @@
-import { DeepAsyncProxy } from "../types/helpers.js";
-import { TransportDictionary, TransportType } from "../types/transport.js";
+import type { ServiceName, ServiceProxyTarget } from "../service/index.js";
+import type { TransportType } from "../types/transport.js";
 import { ServiceDefinition } from "../types/service.js";
 export type { ServiceDefinition };
 export declare const defineService: <T extends TransportType>(options: ServiceDefinition<T>) => ServiceDefinition<T>;
-export declare const getService: <N extends Extract<keyof TransportDictionary, string>>(name: N) => DeepAsyncProxy<TransportDictionary[N]>;
+export declare const getService: <N extends ServiceName>(name: N) => ServiceProxyTarget<N>;

package/dist/main/service.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/main/service.ts"],"sourcesContent":["import {ProxyService} from \"@service/providers\";\n\nimport {DeepAsyncProxy} from \"@typing/helpers\";\nimport {TransportDictionary, TransportType} from \"@typing/transport\";\nimport {ServiceDefinition} from \"@typing/service\";\n\nexport type {ServiceDefinition};\n\nexport const defineService = <T extends TransportType>(options: ServiceDefinition<T>): ServiceDefinition<T> => {\n    return options;\n};\n\nexport const getService = <N extends Extract<keyof TransportDictionary, string>>(\n    name: N\n): DeepAsyncProxy<TransportDictionary[N]> => {\n    return new ProxyService(name).get();\n};\n"],"mappings":"AAAA,SAAQ,oBAAmB;AAQpB,MAAM,gBAAgB,CAA0B,YAAwD;AAC3G,SAAO;AACX;AAEO,MAAM,aAAa,CACtB,SACyC;AACzC,SAAO,IAAI,aAAa,IAAI,EAAE,IAAI;AACtC;","names":[]}
+{"version":3,"sources":["../../src/main/service.ts"],"sourcesContent":["import {ProxyService} from \"@service/providers\";\n\nimport type {ServiceName, ServiceProxyTarget} from \"@service/index\";\nimport type {TransportType} from \"@typing/transport\";\nimport {ServiceDefinition} from \"@typing/service\";\n\nexport type {ServiceDefinition};\n\nexport const defineService = <T extends TransportType>(options: ServiceDefinition<T>): ServiceDefinition<T> => {\n    return options;\n};\n\nexport const getService = <N extends ServiceName>(name: N): ServiceProxyTarget<N> => {\n    return new ProxyService(name).get();\n};\n"],"mappings":"AAAA,SAAQ,oBAAmB;AAQpB,MAAM,gBAAgB,CAA0B,YAAwD;AAC3G,SAAO;AACX;AAEO,MAAM,aAAa,CAAwB,SAAmC;AACjF,SAAO,IAAI,aAAa,IAAI,EAAE,IAAI;AACtC;","names":[]}

package/dist/message/MessageManager.d.ts

@@ -9,4 +9,6 @@ export default class MessageManager<T extends MessageDictionary> {
     clear(): void;
     private updateListener;
     private listener;
+    private success;
+    private failure;
 }

package/dist/message/MessageManager.js

@@ -1,6 +1,8 @@
 import { onMessage } from "@addon-core/browser";
+import { serializeError } from "./error.js";
 import {
-  MessageGlobalKey
+  MessageGlobalKey,
+  MessageResultEnvelopeProperty
 } from "./../types/message.js";
 class MessageManager {
   handlers = /* @__PURE__ */ new Set();
@@ -44,19 +46,33 @@ class MessageManager {
           results.push(Promise.resolve(result));
         }
       } catch (err) {
-        console.error("Message handler error:", err);
+        results.push(Promise.reject(err));
       }
     }
     if (results.length > 1) {
-      throw new Error(
-        `Message type "${message.type}" has multiple handlers returning a response. Only one response is allowed.`
+      sendResponse(
+        this.failure(
+          new Error(
+            `Message type "${message.type}" has multiple handlers returning a response. Only one response is allowed.`
+          )
+        )
       );
+      return true;
     }
     if (results.length === 1) {
-      results[0].then(sendResponse);
+      results[0].then(
+        (result) => sendResponse(this.success(result)),
+        (error) => sendResponse(this.failure(error))
+      );
       return true;
     }
   }
+  success(payload) {
+    return { [MessageResultEnvelopeProperty]: true, ok: true, payload };
+  }
+  failure(error) {
+    return { [MessageResultEnvelopeProperty]: true, ok: false, error: serializeError(error) };
+  }
 }
 export {
   MessageManager as default

package/dist/message/MessageManager.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/message/MessageManager.ts"],"sourcesContent":["import {onMessage} from \"@addon-core/browser\";\n\nimport {\n    MessageBody,\n    MessageDictionary,\n    MessageGlobalKey,\n    MessageHandler,\n    MessageSender,\n    MessageType,\n} from \"@typing/message\";\n\nexport default class MessageManager<T extends MessageDictionary> {\n    private handlers: Set<MessageHandler<T>> = new Set();\n    private unsubscribe: (() => void) | null = null;\n\n    public static getInstance<T extends MessageDictionary>(): MessageManager<T> {\n        return (globalThis[MessageGlobalKey] ??= new MessageManager<T>());\n    }\n\n    constructor() {\n        this.listener = this.listener.bind(this);\n    }\n\n    public add(handler: MessageHandler<T>) {\n        this.handlers.add(handler);\n        this.updateListener();\n    }\n\n    public remove(handler: MessageHandler<T>) {\n        this.handlers.delete(handler);\n        this.updateListener();\n    }\n\n    public clear() {\n        this.handlers = new Set();\n        this.updateListener();\n    }\n\n    private updateListener() {\n        if (this.handlers.size > 0 && !this.unsubscribe) {\n            this.unsubscribe = onMessage(this.listener);\n        } else if (this.handlers.size === 0 && this.unsubscribe) {\n            this.unsubscribe();\n            this.unsubscribe = null;\n        }\n    }\n\n    private listener<K extends MessageType<T>>(\n        message: MessageBody<T, K>,\n        sender: MessageSender,\n        sendResponse: (response?: any) => void\n    ): boolean | void {\n        if (!message || typeof message !== \"object\" || !message.type) {\n            return;\n        }\n\n        const results: Promise<any>[] = [];\n\n        for (const handler of this.handlers) {\n            try {\n                const result = handler.run(message.type, message.data, sender);\n\n                if (result !== undefined) {\n                    results.push(Promise.resolve(result));\n                }\n            } catch (err) {\n                console.error(\"Message handler error:\", err);\n            }\n        }\n\n        if (results.length > 1) {\n            throw new Error(\n                `Message type \"${message.type}\" has multiple handlers returning a response. Only one response is allowed.`\n            );\n        }\n\n        if (results.length === 1) {\n            results[0].then(sendResponse);\n\n            return true;\n        }\n    }\n}\n"],"mappings":"AAAA,SAAQ,iBAAgB;AAExB;AAAA,EAGI;AAAA,OAIG;AAEP,MAAO,eAA0D;AAAA,EACrD,WAAmC,oBAAI,IAAI;AAAA,EAC3C,cAAmC;AAAA,EAE3C,OAAc,cAA8D;AAfhF;AAgBQ,WAAQ,gBAAW,sBAAX,iBAAiC,IAAI,eAAkB;AAAA,EACnE;AAAA,EAEA,cAAc;AACV,SAAK,WAAW,KAAK,SAAS,KAAK,IAAI;AAAA,EAC3C;AAAA,EAEO,IAAI,SAA4B;AACnC,SAAK,SAAS,IAAI,OAAO;AACzB,SAAK,eAAe;AAAA,EACxB;AAAA,EAEO,OAAO,SAA4B;AACtC,SAAK,SAAS,OAAO,OAAO;AAC5B,SAAK,eAAe;AAAA,EACxB;AAAA,EAEO,QAAQ;AACX,SAAK,WAAW,oBAAI,IAAI;AACxB,SAAK,eAAe;AAAA,EACxB;AAAA,EAEQ,iBAAiB;AACrB,QAAI,KAAK,SAAS,OAAO,KAAK,CAAC,KAAK,aAAa;AAC7C,WAAK,cAAc,UAAU,KAAK,QAAQ;AAAA,IAC9C,WAAW,KAAK,SAAS,SAAS,KAAK,KAAK,aAAa;AACrD,WAAK,YAAY;AACjB,WAAK,cAAc;AAAA,IACvB;AAAA,EACJ;AAAA,EAEQ,SACJ,SACA,QACA,cACc;AACd,QAAI,CAAC,WAAW,OAAO,YAAY,YAAY,CAAC,QAAQ,MAAM;AAC1D;AAAA,IACJ;AAEA,UAAM,UAA0B,CAAC;AAEjC,eAAW,WAAW,KAAK,UAAU;AACjC,UAAI;AACA,cAAM,SAAS,QAAQ,IAAI,QAAQ,MAAM,QAAQ,MAAM,MAAM;AAE7D,YAAI,WAAW,QAAW;AACtB,kBAAQ,KAAK,QAAQ,QAAQ,MAAM,CAAC;AAAA,QACxC;AAAA,MACJ,SAAS,KAAK;AACV,gBAAQ,MAAM,0BAA0B,GAAG;AAAA,MAC/C;AAAA,IACJ;AAEA,QAAI,QAAQ,SAAS,GAAG;AACpB,YAAM,IAAI;AAAA,QACN,iBAAiB,QAAQ,IAAI;AAAA,MACjC;AAAA,IACJ;AAEA,QAAI,QAAQ,WAAW,GAAG;AACtB,cAAQ,CAAC,EAAE,KAAK,YAAY;AAE5B,aAAO;AAAA,IACX;AAAA,EACJ;AACJ;","names":[]}
+{"version":3,"sources":["../../src/message/MessageManager.ts"],"sourcesContent":["import {onMessage} from \"@addon-core/browser\";\n\nimport {serializeError} from \"./error\";\n\nimport {\n    MessageBody,\n    MessageDictionary,\n    MessageGlobalKey,\n    MessageHandler,\n    MessageResult,\n    MessageResultEnvelopeProperty,\n    MessageSender,\n    MessageType,\n} from \"@typing/message\";\n\nexport default class MessageManager<T extends MessageDictionary> {\n    private handlers: Set<MessageHandler<T>> = new Set();\n    private unsubscribe: (() => void) | null = null;\n\n    public static getInstance<T extends MessageDictionary>(): MessageManager<T> {\n        return (globalThis[MessageGlobalKey] ??= new MessageManager<T>());\n    }\n\n    constructor() {\n        this.listener = this.listener.bind(this);\n    }\n\n    public add(handler: MessageHandler<T>) {\n        this.handlers.add(handler);\n        this.updateListener();\n    }\n\n    public remove(handler: MessageHandler<T>) {\n        this.handlers.delete(handler);\n        this.updateListener();\n    }\n\n    public clear() {\n        this.handlers = new Set();\n        this.updateListener();\n    }\n\n    private updateListener() {\n        if (this.handlers.size > 0 && !this.unsubscribe) {\n            this.unsubscribe = onMessage(this.listener);\n        } else if (this.handlers.size === 0 && this.unsubscribe) {\n            this.unsubscribe();\n            this.unsubscribe = null;\n        }\n    }\n\n    private listener<K extends MessageType<T>>(\n        message: MessageBody<T, K>,\n        sender: MessageSender,\n        sendResponse: (response?: MessageResult) => void\n    ): boolean | void {\n        if (!message || typeof message !== \"object\" || !message.type) {\n            return;\n        }\n\n        const results: Promise<any>[] = [];\n\n        for (const handler of this.handlers) {\n            try {\n                const result = handler.run(message.type, message.data, sender);\n\n                if (result !== undefined) {\n                    results.push(Promise.resolve(result));\n                }\n            } catch (err) {\n                results.push(Promise.reject(err));\n            }\n        }\n\n        if (results.length > 1) {\n            sendResponse(\n                this.failure(\n                    new Error(\n                        `Message type \"${message.type}\" has multiple handlers returning a response. Only one response is allowed.`\n                    )\n                )\n            );\n\n            return true;\n        }\n\n        if (results.length === 1) {\n            results[0].then(\n                result => sendResponse(this.success(result)),\n                error => sendResponse(this.failure(error))\n            );\n\n            return true;\n        }\n    }\n\n    private success<TData>(payload: TData): MessageResult<TData> {\n        return {[MessageResultEnvelopeProperty]: true, ok: true, payload};\n    }\n\n    private failure(error: unknown): MessageResult<never> {\n        return {[MessageResultEnvelopeProperty]: true, ok: false, error: serializeError(error)};\n    }\n}\n"],"mappings":"AAAA,SAAQ,iBAAgB;AAExB,SAAQ,sBAAqB;AAE7B;AAAA,EAGI;AAAA,EAGA;AAAA,OAGG;AAEP,MAAO,eAA0D;AAAA,EACrD,WAAmC,oBAAI,IAAI;AAAA,EAC3C,cAAmC;AAAA,EAE3C,OAAc,cAA8D;AAnBhF;AAoBQ,WAAQ,gBAAW,sBAAX,iBAAiC,IAAI,eAAkB;AAAA,EACnE;AAAA,EAEA,cAAc;AACV,SAAK,WAAW,KAAK,SAAS,KAAK,IAAI;AAAA,EAC3C;AAAA,EAEO,IAAI,SAA4B;AACnC,SAAK,SAAS,IAAI,OAAO;AACzB,SAAK,eAAe;AAAA,EACxB;AAAA,EAEO,OAAO,SAA4B;AACtC,SAAK,SAAS,OAAO,OAAO;AAC5B,SAAK,eAAe;AAAA,EACxB;AAAA,EAEO,QAAQ;AACX,SAAK,WAAW,oBAAI,IAAI;AACxB,SAAK,eAAe;AAAA,EACxB;AAAA,EAEQ,iBAAiB;AACrB,QAAI,KAAK,SAAS,OAAO,KAAK,CAAC,KAAK,aAAa;AAC7C,WAAK,cAAc,UAAU,KAAK,QAAQ;AAAA,IAC9C,WAAW,KAAK,SAAS,SAAS,KAAK,KAAK,aAAa;AACrD,WAAK,YAAY;AACjB,WAAK,cAAc;AAAA,IACvB;AAAA,EACJ;AAAA,EAEQ,SACJ,SACA,QACA,cACc;AACd,QAAI,CAAC,WAAW,OAAO,YAAY,YAAY,CAAC,QAAQ,MAAM;AAC1D;AAAA,IACJ;AAEA,UAAM,UAA0B,CAAC;AAEjC,eAAW,WAAW,KAAK,UAAU;AACjC,UAAI;AACA,cAAM,SAAS,QAAQ,IAAI,QAAQ,MAAM,QAAQ,MAAM,MAAM;AAE7D,YAAI,WAAW,QAAW;AACtB,kBAAQ,KAAK,QAAQ,QAAQ,MAAM,CAAC;AAAA,QACxC;AAAA,MACJ,SAAS,KAAK;AACV,gBAAQ,KAAK,QAAQ,OAAO,GAAG,CAAC;AAAA,MACpC;AAAA,IACJ;AAEA,QAAI,QAAQ,SAAS,GAAG;AACpB;AAAA,QACI,KAAK;AAAA,UACD,IAAI;AAAA,YACA,iBAAiB,QAAQ,IAAI;AAAA,UACjC;AAAA,QACJ;AAAA,MACJ;AAEA,aAAO;AAAA,IACX;AAEA,QAAI,QAAQ,WAAW,GAAG;AACtB,cAAQ,CAAC,EAAE;AAAA,QACP,YAAU,aAAa,KAAK,QAAQ,MAAM,CAAC;AAAA,QAC3C,WAAS,aAAa,KAAK,QAAQ,KAAK,CAAC;AAAA,MAC7C;AAEA,aAAO;AAAA,IACX;AAAA,EACJ;AAAA,EAEQ,QAAe,SAAsC;AACzD,WAAO,EAAC,CAAC,6BAA6B,GAAG,MAAM,IAAI,MAAM,QAAO;AAAA,EACpE;AAAA,EAEQ,QAAQ,OAAsC;AAClD,WAAO,EAAC,CAAC,6BAA6B,GAAG,MAAM,IAAI,OAAO,OAAO,eAAe,KAAK,EAAC;AAAA,EAC1F;AACJ;","names":[]}

package/dist/message/error.d.ts

@@ -0,0 +1,12 @@
+import { MessageError } from "../types/message.js";
+/**
+ * Convert any thrown value into a transferable {@link MessageError} envelope. Handles real
+ * `Error` instances, error-like objects, and primitives (JSON-stringifying objects when no
+ * `message` is present). The standard serialize step for every cross-context transport.
+ */
+export declare const serializeError: (error: unknown) => MessageError;
+/**
+ * Reconstruct an `Error` from a {@link MessageError} envelope, mapping the serialized `name`
+ * back to its native constructor (so `instanceof TypeError` survives the boundary).
+ */
+export declare const restoreError: (error?: MessageError) => Error;