adnbn 0.8.0 → 0.9.0

package/dist/relay/RelayPermission.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/relay/RelayPermission.ts"],"sourcesContent":["import {containsPermissions, onPermissionsAdded, onPermissionsRemoved, requestPermissions} from \"@addon-core/browser\";\n\nimport {RelayMethod, RelayOptionsMap} from \"@typing/relay\";\nimport {ContentScriptDeclarative} from \"@typing/content\";\n\ntype Permissions = chrome.permissions.Permissions;\n\nexport interface RelayPermissionValue {\n    allow: boolean;\n    permissions?: Permissions;\n}\n\nexport default class RelayPermission {\n    private static _instance?: RelayPermission;\n\n    private permissions = new Map<string, RelayPermissionValue>();\n\n    public static getInstance(): RelayPermission {\n        return (this._instance ??= new RelayPermission());\n    }\n\n    public static init(relays: RelayOptionsMap) {\n        if (this._instance || relays.size === 0) {\n            return;\n        }\n\n        const instance = RelayPermission.getInstance();\n\n        for (const [name, {declarative, method, matches}] of relays) {\n            if (declarative === false && method === RelayMethod.Scripting) {\n                console.warn(\n                    `Relay \"${name}\" has invalid configuration: \"scripting\" method cannot work with declarative = false.`\n                );\n            }\n\n            const allow: boolean =\n                declarative === true ||\n                declarative === ContentScriptDeclarative.Required ||\n                method === RelayMethod.Messaging;\n\n            const permissions: Permissions | undefined =\n                method === RelayMethod.Messaging\n                    ? undefined\n                    : {\n                          origins: !declarative || declarative === ContentScriptDeclarative.Optional ? matches : [],\n                          permissions: [\"scripting\"],\n                      };\n\n            instance.set(name, {allow, permissions});\n        }\n\n        const checkPermissions = async () => await instance.check();\n\n        onPermissionsAdded(checkPermissions);\n        onPermissionsRemoved(checkPermissions);\n\n        checkPermissions().catch(e => console.error(e));\n    }\n\n    public set(name: string, value: Partial<RelayPermissionValue>): this {\n        const relayPermissions = this.get(name) || {allow: false, permissions: {}};\n\n        this.permissions.set(name, {...relayPermissions, ...value});\n\n        return this;\n    }\n\n    public get(name: string): RelayPermissionValue | undefined {\n        return this.permissions.get(name);\n    }\n\n    public has(name: string): boolean {\n        return this.permissions.has(name);\n    }\n\n    public allow(name: string): boolean {\n        return this.get(name)?.allow ?? false;\n    }\n\n    public async contains(name: string): Promise<boolean> {\n        const relayPermissions = this.get(name);\n\n        if (!relayPermissions) {\n            throw new Error(`RelayPermission, relay \"${name}\" not found`);\n        }\n\n        if (!relayPermissions.permissions) {\n            return true;\n        }\n\n        const allow = await containsPermissions(relayPermissions.permissions);\n\n        this.set(name, {allow});\n\n        return allow;\n    }\n\n    public async request(name: string): Promise<boolean> {\n        const relayPermissions = this.get(name);\n\n        if (!relayPermissions) {\n            throw new Error(`RelayPermission, relay \"${name}\" not found`);\n        }\n\n        if (!relayPermissions.permissions) {\n            return true;\n        }\n\n        const allow = await requestPermissions(relayPermissions.permissions);\n\n        this.set(name, {allow});\n\n        return allow;\n    }\n\n    private async check(): Promise<void> {\n        await Promise.allSettled(Object.keys(this.permissions).map(name => this.contains(name)));\n    }\n}\n"],"mappings":"AAAA,SAAQ,qBAAqB,oBAAoB,sBAAsB,0BAAyB;AAEhG,SAAQ,mBAAmC;AAC3C,SAAQ,gCAA+B;AASvC,MAAO,gBAA8B;AAAA,EACjC,OAAe;AAAA,EAEP,cAAc,oBAAI,IAAkC;AAAA,EAE5D,OAAc,cAA+B;AACzC,WAAQ,KAAK,cAAL,KAAK,YAAc,IAAI,gBAAgB;AAAA,EACnD;AAAA,EAEA,OAAc,KAAK,QAAyB;AACxC,QAAI,KAAK,aAAa,OAAO,SAAS,GAAG;AACrC;AAAA,IACJ;AAEA,UAAM,WAAW,gBAAgB,YAAY;AAE7C,eAAW,CAAC,MAAM,EAAC,aAAa,QAAQ,QAAO,CAAC,KAAK,QAAQ;AACzD,UAAI,gBAAgB,SAAS,WAAW,YAAY,WAAW;AAC3D,gBAAQ;AAAA,UACJ,UAAU,IAAI;AAAA,QAClB;AAAA,MACJ;AAEA,YAAM,QACF,gBAAgB,QAChB,gBAAgB,yBAAyB,YACzC,WAAW,YAAY;AAE3B,YAAM,cACF,WAAW,YAAY,YACjB,SACA;AAAA,QACI,SAAS,CAAC,eAAe,gBAAgB,yBAAyB,WAAW,UAAU,CAAC;AAAA,QACxF,aAAa,CAAC,WAAW;AAAA,MAC7B;AAEV,eAAS,IAAI,MAAM,EAAC,OAAO,YAAW,CAAC;AAAA,IAC3C;AAEA,UAAM,mBAAmB,YAAY,MAAM,SAAS,MAAM;AAE1D,uBAAmB,gBAAgB;AACnC,yBAAqB,gBAAgB;AAErC,qBAAiB,EAAE,MAAM,OAAK,QAAQ,MAAM,CAAC,CAAC;AAAA,EAClD;AAAA,EAEO,IAAI,MAAc,OAA4C;AACjE,UAAM,mBAAmB,KAAK,IAAI,IAAI,KAAK,EAAC,OAAO,OAAO,aAAa,CAAC,EAAC;AAEzE,SAAK,YAAY,IAAI,MAAM,EAAC,GAAG,kBAAkB,GAAG,MAAK,CAAC;AAE1D,WAAO;AAAA,EACX;AAAA,EAEO,IAAI,MAAgD;AACvD,WAAO,KAAK,YAAY,IAAI,IAAI;AAAA,EACpC;AAAA,EAEO,IAAI,MAAuB;AAC9B,WAAO,KAAK,YAAY,IAAI,IAAI;AAAA,EACpC;AAAA,EAEO,MAAM,MAAuB;AA3ExC;AA4EQ,aAAO,UAAK,IAAI,IAAI,MAAb,mBAAgB,UAAS;AAAA,EACpC;AAAA,EAEA,MAAa,SAAS,MAAgC;AAClD,UAAM,mBAAmB,KAAK,IAAI,IAAI;AAEtC,QAAI,CAAC,kBAAkB;AACnB,YAAM,IAAI,MAAM,2BAA2B,IAAI,aAAa;AAAA,IAChE;AAEA,QAAI,CAAC,iBAAiB,aAAa;AAC/B,aAAO;AAAA,IACX;AAEA,UAAM,QAAQ,MAAM,oBAAoB,iBAAiB,WAAW;AAEpE,SAAK,IAAI,MAAM,EAAC,MAAK,CAAC;AAEtB,WAAO;AAAA,EACX;AAAA,EAEA,MAAa,QAAQ,MAAgC;AACjD,UAAM,mBAAmB,KAAK,IAAI,IAAI;AAEtC,QAAI,CAAC,kBAAkB;AACnB,YAAM,IAAI,MAAM,2BAA2B,IAAI,aAAa;AAAA,IAChE;AAEA,QAAI,CAAC,iBAAiB,aAAa;AAC/B,aAAO;AAAA,IACX;AAEA,UAAM,QAAQ,MAAM,mBAAmB,iBAAiB,WAAW;AAEnE,SAAK,IAAI,MAAM,EAAC,MAAK,CAAC;AAEtB,WAAO;AAAA,EACX;AAAA,EAEA,MAAc,QAAuB;AACjC,UAAM,QAAQ,WAAW,OAAO,KAAK,KAAK,WAAW,EAAE,IAAI,UAAQ,KAAK,SAAS,IAAI,CAAC,CAAC;AAAA,EAC3F;AACJ;","names":[]}
+{"version":3,"sources":["../../src/relay/RelayPermission.ts"],"sourcesContent":["import {containsPermissions, onPermissionsAdded, onPermissionsRemoved, requestPermissions} from \"@addon-core/browser\";\n\nimport {RelayMethod, RelayOptionsMap} from \"@typing/relay\";\nimport {ContentScriptDeclarative} from \"@typing/content\";\n\ntype Permissions = chrome.permissions.Permissions;\n\nexport interface RelayPermissionValue {\n    allow: boolean;\n    permissions?: Permissions;\n}\n\nexport const RelayPermissionGlobalKey = \"adnbnRelayPermission\";\n\nexport default class RelayPermission {\n    private permissions = new Map<string, RelayPermissionValue>();\n    private started = false;\n\n    private constructor(relays: RelayOptionsMap) {\n        this.configure(relays);\n    }\n\n    private configure(relays: RelayOptionsMap): void {\n        for (const [name, {declarative, method, matches}] of relays) {\n            if (declarative === false && method === RelayMethod.Scripting) {\n                console.warn(\n                    `Relay \"${name}\" has invalid configuration: \"scripting\" method cannot work with declarative = false.`\n                );\n            }\n\n            const allow: boolean =\n                declarative === true ||\n                declarative === ContentScriptDeclarative.Required ||\n                method === RelayMethod.Messaging;\n\n            const permissions: Permissions | undefined =\n                method === RelayMethod.Messaging\n                    ? undefined\n                    : {\n                          origins: !declarative || declarative === ContentScriptDeclarative.Optional ? matches : [],\n                          permissions: [\"scripting\"],\n                      };\n\n            this.set(name, {allow, permissions});\n        }\n    }\n\n    public static getInstance(relays: RelayOptionsMap): RelayPermission {\n        const current = globalThis[RelayPermissionGlobalKey] as RelayPermission | undefined;\n\n        if (current) {\n            return current;\n        }\n\n        const instance = new RelayPermission(relays);\n\n        globalThis[RelayPermissionGlobalKey] = instance;\n\n        return instance.start();\n    }\n\n    public start(): this {\n        if (this.started) {\n            return this;\n        }\n\n        this.started = true;\n\n        const checkPermissions = (): void => {\n            void this.check().catch(error => console.error(error));\n        };\n\n        onPermissionsAdded(checkPermissions);\n        onPermissionsRemoved(checkPermissions);\n        checkPermissions();\n\n        return this;\n    }\n\n    public set(name: string, value: Partial<RelayPermissionValue>): this {\n        const relayPermissions = this.get(name) || {allow: false, permissions: {}};\n\n        this.permissions.set(name, {...relayPermissions, ...value});\n\n        return this;\n    }\n\n    public get(name: string): RelayPermissionValue | undefined {\n        return this.permissions.get(name);\n    }\n\n    public has(name: string): boolean {\n        return this.permissions.has(name);\n    }\n\n    public allow(name: string): boolean {\n        return this.get(name)?.allow ?? false;\n    }\n\n    public async contains(name: string): Promise<boolean> {\n        const relayPermissions = this.get(name);\n\n        if (!relayPermissions) {\n            throw new Error(`RelayPermission, relay \"${name}\" not found`);\n        }\n\n        if (!relayPermissions.permissions) {\n            return true;\n        }\n\n        const allow = await containsPermissions(relayPermissions.permissions);\n\n        this.set(name, {allow});\n\n        return allow;\n    }\n\n    public async request(name: string): Promise<boolean> {\n        const relayPermissions = this.get(name);\n\n        if (!relayPermissions) {\n            throw new Error(`RelayPermission, relay \"${name}\" not found`);\n        }\n\n        if (!relayPermissions.permissions) {\n            return true;\n        }\n\n        const allow = await requestPermissions(relayPermissions.permissions);\n\n        this.set(name, {allow});\n\n        return allow;\n    }\n\n    private async check(): Promise<void> {\n        await Promise.allSettled([...this.permissions.keys()].map(name => this.contains(name)));\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/relay/adapters/RelayAdapter.d.ts

@@ -0,0 +1,8 @@
+import { type RelayBatchOptions, type RelayCallOptions } from "../../types/relay.js";
+export default abstract class RelayAdapter {
+    protected readonly name: string;
+    protected readonly target: RelayCallOptions;
+    protected constructor(name: string, target: RelayCallOptions);
+    protected isBatchTarget(target: RelayCallOptions): target is RelayBatchOptions;
+    abstract invoke(args: any[], path?: string): Promise<any>;
+}

package/dist/relay/adapters/RelayAdapter.js

@@ -0,0 +1,16 @@
+import { RelayAllFrames } from "./../../types/relay.js";
+class RelayAdapter {
+  constructor(name, target) {
+    this.name = name;
+    this.target = target;
+  }
+  name;
+  target;
+  isBatchTarget(target) {
+    return target.allFrames === true || target.allFrames === RelayAllFrames.Any || target.allFrames === RelayAllFrames.All || target.frameIds !== void 0 || target.documentIds !== void 0;
+  }
+}
+export {
+  RelayAdapter as default
+};
+//# sourceMappingURL=RelayAdapter.js.map

package/dist/relay/adapters/RelayAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/relay/adapters/RelayAdapter.ts"],"sourcesContent":["import {RelayAllFrames, type RelayBatchOptions, type RelayCallOptions} from \"@typing/relay\";\n\nexport default abstract class RelayAdapter {\n    protected constructor(\n        protected readonly name: string,\n        protected readonly target: RelayCallOptions\n    ) {}\n\n    protected isBatchTarget(target: RelayCallOptions): target is RelayBatchOptions {\n        return (\n            target.allFrames === true ||\n            target.allFrames === RelayAllFrames.Any ||\n            target.allFrames === RelayAllFrames.All ||\n            target.frameIds !== undefined ||\n            target.documentIds !== undefined\n        );\n    }\n\n    public abstract invoke(args: any[], path?: string): Promise<any>;\n}\n"],"mappings":"AAAA,SAAQ,sBAAoE;AAE5E,MAAO,aAAoC;AAAA,EAC7B,YACa,MACA,QACrB;AAFqB;AACA;AAAA,EACpB;AAAA,EAFoB;AAAA,EACA;AAAA,EAGb,cAAc,QAAuD;AAC3E,WACI,OAAO,cAAc,QACrB,OAAO,cAAc,eAAe,OACpC,OAAO,cAAc,eAAe,OACpC,OAAO,aAAa,UACpB,OAAO,gBAAgB;AAAA,EAE/B;AAGJ;","names":[]}

package/dist/relay/adapters/RelayMessagingAdapter.d.ts

@@ -0,0 +1,11 @@
+import { type RelayCallOptions } from "../../types/relay.js";
+import RelayAdapter from "./RelayAdapter.js";
+export default class RelayMessagingAdapter extends RelayAdapter {
+    private readonly discovery;
+    private readonly message;
+    constructor(name: string, target: RelayCallOptions);
+    invoke(args: any[], path?: string): Promise<any>;
+    private scalarTarget;
+    private batchTargets;
+    private messageOptions;
+}

package/dist/relay/adapters/RelayMessagingAdapter.js

@@ -0,0 +1,91 @@
+import { isRemoteMessageError } from "./../../message/error.js";
+import { RelayAllFrames, RelayFrameErrorKind } from "./../../types/relay.js";
+import RelayDiscovery from "../discovery/RelayDiscovery.js";
+import RelayMessage from "../RelayMessage.js";
+import {
+  fulfilledRelayFrame,
+  messageErrorKind,
+  rejectedRelayFrame,
+  RelayFrameTimeoutError,
+  sortRelayFrameResults,
+  withRelayTimeout
+} from "../result.js";
+import RelayAdapter from "./RelayAdapter.js";
+class RelayMessagingAdapter extends RelayAdapter {
+  discovery = new RelayDiscovery();
+  message;
+  constructor(name, target) {
+    super(name, target);
+    this.message = new RelayMessage(name);
+  }
+  async invoke(args, path) {
+    if (!this.isBatchTarget(this.target)) {
+      const target = this.scalarTarget();
+      return withRelayTimeout(
+        this.message.send({ path, args }, this.messageOptions(target)),
+        this.target.timeoutMs
+      );
+    }
+    if (this.target.allFrames === true || this.target.allFrames === RelayAllFrames.Any) {
+      const target = { tabId: this.target.tabId, allFrames: RelayAllFrames.Any };
+      try {
+        const result = await withRelayTimeout(
+          this.message.send({ path, args }, { tabId: this.target.tabId }),
+          this.target.timeoutMs
+        );
+        return [fulfilledRelayFrame(target, result)];
+      } catch (error) {
+        const kind = error instanceof RelayFrameTimeoutError ? RelayFrameErrorKind.Timeout : isRemoteMessageError(error) ? RelayFrameErrorKind.Remote : messageErrorKind(error);
+        return [rejectedRelayFrame(target, error, kind)];
+      }
+    }
+    const targets = await this.batchTargets();
+    const results = await Promise.all(
+      targets.map(async (target) => {
+        try {
+          const result = await withRelayTimeout(
+            this.message.send({ path, args }, this.messageOptions(target)),
+            this.target.timeoutMs
+          );
+          return fulfilledRelayFrame(target, result);
+        } catch (error) {
+          const kind = error instanceof RelayFrameTimeoutError ? RelayFrameErrorKind.Timeout : isRemoteMessageError(error) ? RelayFrameErrorKind.Remote : messageErrorKind(error);
+          return rejectedRelayFrame(target, error, kind);
+        }
+      })
+    );
+    return sortRelayFrameResults(results);
+  }
+  scalarTarget() {
+    if (this.target.frameId !== void 0) {
+      return { tabId: this.target.tabId, frameId: this.target.frameId };
+    }
+    if (this.target.documentId !== void 0) {
+      return { tabId: this.target.tabId, documentId: this.target.documentId };
+    }
+    return { tabId: this.target.tabId, frameId: 0 };
+  }
+  async batchTargets() {
+    if (this.target.allFrames === RelayAllFrames.All) {
+      return this.discovery.discover(this.target.tabId);
+    }
+    if (this.target.frameIds !== void 0) {
+      return this.target.frameIds.map((frameId) => ({ tabId: this.target.tabId, frameId }));
+    }
+    return (this.target.documentIds ?? []).map((documentId) => ({ tabId: this.target.tabId, documentId }));
+  }
+  messageOptions(target) {
+    if (target.frameId !== void 0) {
+      return {
+        tabId: target.tabId,
+        frameId: target.frameId,
+        ...target.documentId === void 0 ? {} : { documentId: target.documentId }
+      };
+    }
+    return { tabId: target.tabId, documentId: target.documentId };
+  }
+}
+export {
+  RelayMessagingAdapter as default
+};
+//# sourceMappingURL=RelayMessagingAdapter.js.map

package/dist/relay/adapters/RelayMessagingAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/relay/adapters/RelayMessagingAdapter.ts"],"sourcesContent":["import {isRemoteMessageError} from \"@message/error\";\n\nimport type {MessageSendOptions} from \"@typing/message\";\nimport {RelayAllFrames, RelayFrameErrorKind, type RelayAddressTarget, type RelayCallOptions} from \"@typing/relay\";\nimport type {TransportMessage} from \"@typing/transport\";\n\nimport RelayDiscovery from \"../discovery/RelayDiscovery\";\nimport RelayMessage from \"../RelayMessage\";\nimport {\n    fulfilledRelayFrame,\n    messageErrorKind,\n    rejectedRelayFrame,\n    RelayFrameTimeoutError,\n    sortRelayFrameResults,\n    withRelayTimeout,\n} from \"../result\";\nimport RelayAdapter from \"./RelayAdapter\";\n\nexport default class RelayMessagingAdapter extends RelayAdapter {\n    private readonly discovery = new RelayDiscovery();\n    private readonly message: TransportMessage;\n\n    public constructor(name: string, target: RelayCallOptions) {\n        super(name, target);\n\n        this.message = new RelayMessage(name);\n    }\n\n    public async invoke(args: any[], path?: string): Promise<any> {\n        if (!this.isBatchTarget(this.target)) {\n            const target = this.scalarTarget();\n\n            return withRelayTimeout(\n                this.message.send({path, args}, this.messageOptions(target)),\n                this.target.timeoutMs\n            );\n        }\n\n        if (this.target.allFrames === true || this.target.allFrames === RelayAllFrames.Any) {\n            const target = {tabId: this.target.tabId, allFrames: RelayAllFrames.Any} as const;\n\n            try {\n                const result = await withRelayTimeout(\n                    this.message.send({path, args}, {tabId: this.target.tabId}),\n                    this.target.timeoutMs\n                );\n\n                return [fulfilledRelayFrame(target, result)];\n            } catch (error) {\n                const kind =\n                    error instanceof RelayFrameTimeoutError\n                        ? RelayFrameErrorKind.Timeout\n                        : isRemoteMessageError(error)\n                          ? RelayFrameErrorKind.Remote\n                          : messageErrorKind(error);\n\n                return [rejectedRelayFrame(target, error, kind)];\n            }\n        }\n\n        const targets = await this.batchTargets();\n        const results = await Promise.all(\n            targets.map(async target => {\n                try {\n                    const result = await withRelayTimeout(\n                        this.message.send({path, args}, this.messageOptions(target)),\n                        this.target.timeoutMs\n                    );\n\n                    return fulfilledRelayFrame(target, result);\n                } catch (error) {\n                    const kind =\n                        error instanceof RelayFrameTimeoutError\n                            ? RelayFrameErrorKind.Timeout\n                            : isRemoteMessageError(error)\n                              ? RelayFrameErrorKind.Remote\n                              : messageErrorKind(error);\n\n                    return rejectedRelayFrame(target, error, kind);\n                }\n            })\n        );\n\n        return sortRelayFrameResults(results);\n    }\n\n    private scalarTarget(): RelayAddressTarget {\n        if (this.target.frameId !== undefined) {\n            return {tabId: this.target.tabId, frameId: this.target.frameId};\n        }\n\n        if (this.target.documentId !== undefined) {\n            return {tabId: this.target.tabId, documentId: this.target.documentId};\n        }\n\n        return {tabId: this.target.tabId, frameId: 0};\n    }\n\n    private async batchTargets(): Promise<RelayAddressTarget[]> {\n        if (this.target.allFrames === RelayAllFrames.All) {\n            return this.discovery.discover(this.target.tabId);\n        }\n\n        if (this.target.frameIds !== undefined) {\n            return this.target.frameIds.map(frameId => ({tabId: this.target.tabId, frameId}));\n        }\n\n        return (this.target.documentIds ?? []).map(documentId => ({tabId: this.target.tabId, documentId}));\n    }\n\n    private messageOptions(target: RelayAddressTarget): MessageSendOptions {\n        if (target.frameId !== undefined) {\n            return {\n                tabId: target.tabId,\n                frameId: target.frameId,\n                ...(target.documentId === undefined ? {} : {documentId: target.documentId}),\n            };\n        }\n\n        return {tabId: target.tabId, documentId: target.documentId};\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/relay/adapters/RelayScriptingAdapter.d.ts

@@ -0,0 +1,15 @@
+import { type RelayCallOptions } from "../../types/relay.js";
+import RelayAdapter from "./RelayAdapter.js";
+export default class RelayScriptingAdapter extends RelayAdapter {
+    private _injectScript?;
+    constructor(name: string, target: RelayCallOptions);
+    private get injectScript();
+    invoke(args: any[], path?: string): Promise<any>;
+    private normalize;
+    private resultTarget;
+    private unwrap;
+    private injectScriptOptions;
+    private isFrameTarget;
+    private isDocumentTarget;
+    private isAnyFramesTarget;
+}

package/dist/relay/adapters/RelayScriptingAdapter.js

@@ -0,0 +1,170 @@
+import injectScriptFactory from "@addon-core/inject-script";
+import { restoreError } from "./../../message/error.js";
+import {
+  RelayAllFrames,
+  RelayFrameErrorKind,
+  RelayGlobalKey
+} from "./../../types/relay.js";
+import { fulfilledRelayFrame, injectScriptErrorKind, rejectedRelayFrame, sortRelayFrameResults } from "../result.js";
+import RelayAdapter from "./RelayAdapter.js";
+class RelayScriptingAdapter extends RelayAdapter {
+  _injectScript;
+  constructor(name, target) {
+    super(name, target);
+  }
+  get injectScript() {
+    return this._injectScript ?? (this._injectScript = injectScriptFactory(this.injectScriptOptions()));
+  }
+  async invoke(args, path) {
+    const func = (name, path2, args2, key, retryManager) => {
+      const serialize = (error) => {
+        if (error instanceof Error) {
+          return {
+            name: error.name,
+            message: error.message,
+            ...error.stack ? { stack: error.stack } : {}
+          };
+        }
+        if (typeof error === "object" && error !== null) {
+          const record = error;
+          return {
+            name: typeof record.name === "string" ? record.name : "Error",
+            message: typeof record.message === "string" ? record.message : (() => {
+              try {
+                return JSON.stringify(error) ?? String(error);
+              } catch {
+                return String(error);
+              }
+            })(),
+            ...typeof record.stack === "string" ? { stack: record.stack } : {}
+          };
+        }
+        return { name: "Error", message: String(error) };
+      };
+      const invoke = (manager2) => {
+        try {
+          return Promise.resolve(manager2.property(name, { path: path2, args: args2 })).then(
+            (result) => result === void 0 ? { ok: true, hasResult: false } : { ok: true, hasResult: true, result },
+            (error) => ({ ok: false, error: serialize(error) })
+          );
+        } catch (error) {
+          return Promise.resolve({ ok: false, error: serialize(error) });
+        }
+      };
+      const manager = globalThis[key];
+      if (manager) {
+        return invoke(manager);
+      }
+      if (!retryManager) {
+        return Promise.reject(new Error("Relay manager not found."));
+      }
+      return new Promise((resolve, reject) => {
+        const maxAttempts = 10;
+        const delay = 300;
+        let attempts = 0;
+        const findManager = () => {
+          const delayedManager = globalThis[key];
+          if (delayedManager) {
+            resolve(invoke(delayedManager));
+            return;
+          }
+          attempts++;
+          if (attempts >= maxAttempts) {
+            reject(new Error(`Relay manager not found after ${maxAttempts} attempts.`));
+            return;
+          }
+          setTimeout(findManager, delay);
+        };
+        findManager();
+      });
+    };
+    const scriptArgs = [
+      this.name,
+      path ?? null,
+      args,
+      RelayGlobalKey,
+      !this.isAnyFramesTarget()
+    ];
+    const outcomes = await this.injectScript.run(func, scriptArgs);
+    const results = this.normalize(outcomes);
+    if (this.isAnyFramesTarget()) {
+      const result = results.find((result2) => result2.status === "fulfilled") ?? results[0];
+      return result ? [
+        {
+          ...result,
+          target: { tabId: this.target.tabId, allFrames: RelayAllFrames.Any }
+        }
+      ] : [];
+    }
+    if (this.isBatchTarget(this.target)) {
+      return results;
+    }
+    return this.unwrap(results);
+  }
+  normalize(outcomes) {
+    return sortRelayFrameResults(
+      outcomes.map((outcome) => {
+        const target = this.resultTarget(outcome.target);
+        if (!outcome.success) {
+          return rejectedRelayFrame(target, outcome.error, injectScriptErrorKind(outcome.error.kind));
+        }
+        if (!outcome.value.ok) {
+          return rejectedRelayFrame(target, outcome.value.error, RelayFrameErrorKind.Remote);
+        }
+        return fulfilledRelayFrame(target, outcome.value.hasResult ? outcome.value.result : void 0);
+      })
+    );
+  }
+  resultTarget(target) {
+    if (target.allFrames === true) {
+      return {
+        tabId: target.tabId,
+        allFrames: this.target.allFrames === RelayAllFrames.All ? RelayAllFrames.All : RelayAllFrames.Any
+      };
+    }
+    return target;
+  }
+  unwrap(results) {
+    const result = results[0];
+    if (!result) {
+      throw new Error(`Relay "${this.name}" did not return a frame result.`);
+    }
+    if (result.status === "fulfilled") {
+      return result.result;
+    }
+    throw restoreError(result.error);
+  }
+  injectScriptOptions() {
+    let injectTarget;
+    if (this.target.allFrames === true || this.target.allFrames === RelayAllFrames.Any || this.target.allFrames === RelayAllFrames.All) {
+      injectTarget = { tabId: this.target.tabId, allFrames: true };
+    } else if (this.target.frameIds !== void 0) {
+      injectTarget = { tabId: this.target.tabId, frameIds: this.target.frameIds };
+    } else if (this.target.documentIds !== void 0) {
+      injectTarget = { tabId: this.target.tabId, documentIds: this.target.documentIds };
+    } else if (this.isFrameTarget(this.target)) {
+      injectTarget = { tabId: this.target.tabId, frameIds: [this.target.frameId] };
+    } else if (this.isDocumentTarget(this.target)) {
+      injectTarget = { tabId: this.target.tabId, documentIds: [this.target.documentId] };
+    } else {
+      injectTarget = { tabId: this.target.tabId };
+    }
+    return {
+      target: injectTarget,
+      ...this.target.timeoutMs === void 0 ? {} : { timeoutMs: this.target.timeoutMs }
+    };
+  }
+  isFrameTarget(target) {
+    return target.frameId !== void 0;
+  }
+  isDocumentTarget(target) {
+    return target.documentId !== void 0;
+  }
+  isAnyFramesTarget() {
+    return this.target.allFrames === true || this.target.allFrames === RelayAllFrames.Any;
+  }
+}
+export {
+  RelayScriptingAdapter as default
+};
+//# sourceMappingURL=RelayScriptingAdapter.js.map

package/dist/relay/adapters/RelayScriptingAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/relay/adapters/RelayScriptingAdapter.ts"],"sourcesContent":["import injectScriptFactory, {\n    type InjectScriptContract,\n    type InjectScriptOptions,\n    type InjectScriptResult,\n    type InjectScriptResultTarget,\n    type InjectScriptTarget,\n    type JsonValue,\n} from \"@addon-core/inject-script\";\n\nimport {restoreError} from \"@message/error\";\n\nimport type {MessageError} from \"@typing/message\";\nimport {\n    RelayAllFrames,\n    RelayFrameErrorKind,\n    RelayGlobalKey,\n    type RelayCallOptions,\n    type RelayDocumentOptions,\n    type RelayFrameOptions,\n    type RelayFramesResult,\n    type RelayResultTarget,\n    type RelayScalarOptions,\n} from \"@typing/relay\";\n\nimport {fulfilledRelayFrame, injectScriptErrorKind, rejectedRelayFrame, sortRelayFrameResults} from \"../result\";\nimport RelayAdapter from \"./RelayAdapter\";\n\ntype RelayInvocationResult =\n    | {\n          ok: true;\n          hasResult: false;\n      }\n    | {\n          ok: true;\n          hasResult: true;\n          result: any;\n      }\n    | {\n          ok: false;\n          error: MessageError;\n      };\n\nexport default class RelayScriptingAdapter extends RelayAdapter {\n    private _injectScript?: InjectScriptContract;\n\n    public constructor(name: string, target: RelayCallOptions) {\n        super(name, target);\n    }\n\n    private get injectScript(): InjectScriptContract {\n        return (this._injectScript ??= injectScriptFactory(this.injectScriptOptions()));\n    }\n\n    public async invoke(args: any[], path?: string): Promise<any> {\n        const func = (\n            name: string,\n            path: string | null,\n            args: JsonValue[],\n            key: string,\n            retryManager: boolean\n        ): Promise<RelayInvocationResult> => {\n            const serialize = (error: unknown): MessageError => {\n                if (error instanceof Error) {\n                    return {\n                        name: error.name,\n                        message: error.message,\n                        ...(error.stack ? {stack: error.stack} : {}),\n                    };\n                }\n\n                if (typeof error === \"object\" && error !== null) {\n                    const record = error as Record<string, unknown>;\n\n                    return {\n                        name: typeof record.name === \"string\" ? record.name : \"Error\",\n                        message:\n                            typeof record.message === \"string\"\n                                ? record.message\n                                : (() => {\n                                      try {\n                                          return JSON.stringify(error) ?? String(error);\n                                      } catch {\n                                          return String(error);\n                                      }\n                                  })(),\n                        ...(typeof record.stack === \"string\" ? {stack: record.stack} : {}),\n                    };\n                }\n\n                return {name: \"Error\", message: String(error)};\n            };\n\n            const invoke = (manager: any): Promise<RelayInvocationResult> => {\n                try {\n                    return Promise.resolve(manager.property(name, {path, args})).then(\n                        result =>\n                            result === undefined\n                                ? {ok: true as const, hasResult: false as const}\n                                : {ok: true as const, hasResult: true as const, result},\n                        error => ({ok: false as const, error: serialize(error)})\n                    );\n                } catch (error) {\n                    return Promise.resolve({ok: false as const, error: serialize(error)});\n                }\n            };\n\n            const manager = globalThis[key];\n\n            if (manager) {\n                // Keep the normal Scripting path synchronous until the remote method starts.\n                return invoke(manager);\n            }\n\n            if (!retryManager) {\n                return Promise.reject(new Error(\"Relay manager not found.\"));\n            }\n\n            return new Promise<RelayInvocationResult>((resolve, reject) => {\n                const maxAttempts = 10;\n                const delay = 300;\n                let attempts = 0;\n\n                const findManager = () => {\n                    const delayedManager = globalThis[key];\n\n                    if (delayedManager) {\n                        resolve(invoke(delayedManager));\n                        return;\n                    }\n\n                    attempts++;\n\n                    if (attempts >= maxAttempts) {\n                        reject(new Error(`Relay manager not found after ${maxAttempts} attempts.`));\n                        return;\n                    }\n\n                    setTimeout(findManager, delay);\n                };\n\n                findManager();\n            });\n        };\n\n        const scriptArgs: [string, string | null, JsonValue[], string, boolean] = [\n            this.name,\n            path ?? null,\n            args as JsonValue[],\n            RelayGlobalKey,\n            !this.isAnyFramesTarget(),\n        ];\n        const outcomes = await this.injectScript.run(func, scriptArgs);\n        const results = this.normalize(outcomes);\n\n        if (this.isAnyFramesTarget()) {\n            const result = results.find(result => result.status === \"fulfilled\") ?? results[0];\n\n            return result\n                ? [\n                      {\n                          ...result,\n                          target: {tabId: this.target.tabId, allFrames: RelayAllFrames.Any},\n                      },\n                  ]\n                : [];\n        }\n\n        if (this.isBatchTarget(this.target)) {\n            return results;\n        }\n\n        return this.unwrap(results);\n    }\n\n    private normalize(outcomes: readonly InjectScriptResult<RelayInvocationResult>[]): RelayFramesResult<any> {\n        return sortRelayFrameResults(\n            outcomes.map(outcome => {\n                const target = this.resultTarget(outcome.target);\n\n                if (!outcome.success) {\n                    return rejectedRelayFrame(target, outcome.error, injectScriptErrorKind(outcome.error.kind));\n                }\n\n                if (!outcome.value.ok) {\n                    return rejectedRelayFrame(target, outcome.value.error, RelayFrameErrorKind.Remote);\n                }\n\n                return fulfilledRelayFrame(target, outcome.value.hasResult ? outcome.value.result : undefined);\n            })\n        );\n    }\n\n    private resultTarget(target: InjectScriptResultTarget): RelayResultTarget {\n        if (target.allFrames === true) {\n            return {\n                tabId: target.tabId,\n                allFrames: this.target.allFrames === RelayAllFrames.All ? RelayAllFrames.All : RelayAllFrames.Any,\n            };\n        }\n\n        return target;\n    }\n\n    private unwrap(results: RelayFramesResult<any>): any {\n        const result = results[0];\n\n        if (!result) {\n            throw new Error(`Relay \"${this.name}\" did not return a frame result.`);\n        }\n\n        if (result.status === \"fulfilled\") {\n            return result.result;\n        }\n\n        throw restoreError(result.error);\n    }\n\n    private injectScriptOptions(): InjectScriptOptions {\n        let injectTarget: InjectScriptTarget;\n\n        if (\n            this.target.allFrames === true ||\n            this.target.allFrames === RelayAllFrames.Any ||\n            this.target.allFrames === RelayAllFrames.All\n        ) {\n            injectTarget = {tabId: this.target.tabId, allFrames: true};\n        } else if (this.target.frameIds !== undefined) {\n            injectTarget = {tabId: this.target.tabId, frameIds: this.target.frameIds};\n        } else if (this.target.documentIds !== undefined) {\n            injectTarget = {tabId: this.target.tabId, documentIds: this.target.documentIds};\n        } else if (this.isFrameTarget(this.target)) {\n            injectTarget = {tabId: this.target.tabId, frameIds: [this.target.frameId]};\n        } else if (this.isDocumentTarget(this.target)) {\n            injectTarget = {tabId: this.target.tabId, documentIds: [this.target.documentId]};\n        } else {\n            injectTarget = {tabId: (this.target as RelayScalarOptions).tabId};\n        }\n\n        return {\n            target: injectTarget,\n            ...(this.target.timeoutMs === undefined ? {} : {timeoutMs: this.target.timeoutMs}),\n        };\n    }\n\n    private isFrameTarget(target: RelayCallOptions): target is RelayFrameOptions {\n        return target.frameId !== undefined;\n    }\n\n    private isDocumentTarget(target: RelayCallOptions): target is RelayDocumentOptions {\n        return target.documentId !== undefined;\n    }\n\n    private isAnyFramesTarget(): boolean {\n        return this.target.allFrames === true || this.target.allFrames === RelayAllFrames.Any;\n    }\n}\n"],"mappings":"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","names":["path","args","manager","result"]}

package/dist/relay/discovery/RelayDiscovery.d.ts

@@ -0,0 +1,10 @@
+import type { RelayAddressTarget } from "../../types/relay.js";
+export declare class RelayDiscoveryError extends Error {
+    constructor(message: string, cause?: unknown);
+}
+/** Enumerates frame addresses for strict Messaging All calls, without checking whether Relay is registered. */
+export default class RelayDiscovery {
+    discover(tabId: number): Promise<RelayAddressTarget[]>;
+    private assertSupported;
+    private normalize;
+}

package/dist/relay/discovery/RelayDiscovery.js

@@ -0,0 +1,62 @@
+import { getAllFrames, getManifest } from "@addon-core/browser";
+class RelayDiscoveryError extends Error {
+  constructor(message, cause) {
+    super(message, cause === void 0 ? void 0 : { cause });
+    this.name = "RelayDiscoveryError";
+  }
+}
+class RelayDiscovery {
+  async discover(tabId) {
+    this.assertSupported();
+    try {
+      const frames = await getAllFrames(tabId);
+      return this.normalize(
+        frames.map((frame) => ({
+          tabId,
+          frameId: frame.frameId,
+          ...frame.documentId ? { documentId: frame.documentId } : {}
+        }))
+      );
+    } catch (error) {
+      throw new RelayDiscoveryError(
+        `Relay failed to discover frames in tab ${tabId} through webNavigation.getAllFrames().`,
+        error
+      );
+    }
+  }
+  assertSupported() {
+    let permissions;
+    try {
+      permissions = getManifest().permissions ?? [];
+    } catch (error) {
+      throw new RelayDiscoveryError(
+        'Relay could not verify the "webNavigation" permission required for Messaging "allFrames".',
+        error
+      );
+    }
+    if (!permissions.includes("webNavigation")) {
+      throw new RelayDiscoveryError(
+        'Messaging Relay with RelayAllFrames.All requires the "webNavigation" permission. Configure the Relay entrypoint with allFrames: RelayAllFrames.All so the framework can declare it automatically, or use RelayAllFrames.Any, "frameIds" or "documentIds".'
+      );
+    }
+  }
+  normalize(targets) {
+    const unique = /* @__PURE__ */ new Map();
+    for (const target of targets) {
+      const key = target.frameId === void 0 ? `${target.tabId}:document:${target.documentId}` : `${target.tabId}:frame:${target.frameId}`;
+      unique.set(key, target);
+    }
+    return [...unique.values()].sort((a, b) => {
+      const frameDifference = (a.frameId ?? Number.MAX_SAFE_INTEGER) - (b.frameId ?? Number.MAX_SAFE_INTEGER);
+      if (frameDifference !== 0) {
+        return frameDifference;
+      }
+      return (a.documentId ?? "").localeCompare(b.documentId ?? "");
+    });
+  }
+}
+export {
+  RelayDiscoveryError,
+  RelayDiscovery as default
+};
+//# sourceMappingURL=RelayDiscovery.js.map

package/dist/relay/discovery/RelayDiscovery.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/relay/discovery/RelayDiscovery.ts"],"sourcesContent":["import {getAllFrames, getManifest} from \"@addon-core/browser\";\n\nimport type {RelayAddressTarget} from \"@typing/relay\";\n\nexport class RelayDiscoveryError extends Error {\n    public constructor(message: string, cause?: unknown) {\n        super(message, cause === undefined ? undefined : {cause});\n        this.name = \"RelayDiscoveryError\";\n    }\n}\n\n/** Enumerates frame addresses for strict Messaging All calls, without checking whether Relay is registered. */\nexport default class RelayDiscovery {\n    public async discover(tabId: number): Promise<RelayAddressTarget[]> {\n        this.assertSupported();\n\n        try {\n            const frames = await getAllFrames(tabId);\n\n            return this.normalize(\n                frames.map(frame => ({\n                    tabId,\n                    frameId: frame.frameId,\n                    ...(frame.documentId ? {documentId: frame.documentId} : {}),\n                }))\n            );\n        } catch (error) {\n            throw new RelayDiscoveryError(\n                `Relay failed to discover frames in tab ${tabId} through webNavigation.getAllFrames().`,\n                error\n            );\n        }\n    }\n\n    private assertSupported(): void {\n        let permissions: string[];\n\n        try {\n            permissions = getManifest().permissions ?? [];\n        } catch (error) {\n            throw new RelayDiscoveryError(\n                'Relay could not verify the \"webNavigation\" permission required for Messaging \"allFrames\".',\n                error\n            );\n        }\n\n        if (!permissions.includes(\"webNavigation\")) {\n            throw new RelayDiscoveryError(\n                'Messaging Relay with RelayAllFrames.All requires the \"webNavigation\" permission. Configure the Relay entrypoint with allFrames: RelayAllFrames.All so the framework can declare it automatically, or use RelayAllFrames.Any, \"frameIds\" or \"documentIds\".'\n            );\n        }\n    }\n\n    private normalize(targets: RelayAddressTarget[]): RelayAddressTarget[] {\n        const unique = new Map<string, RelayAddressTarget>();\n\n        for (const target of targets) {\n            const key =\n                target.frameId === undefined\n                    ? `${target.tabId}:document:${target.documentId}`\n                    : `${target.tabId}:frame:${target.frameId}`;\n\n            unique.set(key, target);\n        }\n\n        return [...unique.values()].sort((a, b) => {\n            const frameDifference = (a.frameId ?? Number.MAX_SAFE_INTEGER) - (b.frameId ?? Number.MAX_SAFE_INTEGER);\n\n            if (frameDifference !== 0) {\n                return frameDifference;\n            }\n\n            return (a.documentId ?? \"\").localeCompare(b.documentId ?? \"\");\n        });\n    }\n}\n"],"mappings":"AAAA,SAAQ,cAAc,mBAAkB;AAIjC,MAAM,4BAA4B,MAAM;AAAA,EACpC,YAAY,SAAiB,OAAiB;AACjD,UAAM,SAAS,UAAU,SAAY,SAAY,EAAC,MAAK,CAAC;AACxD,SAAK,OAAO;AAAA,EAChB;AACJ;AAGA,MAAO,eAA6B;AAAA,EAChC,MAAa,SAAS,OAA8C;AAChE,SAAK,gBAAgB;AAErB,QAAI;AACA,YAAM,SAAS,MAAM,aAAa,KAAK;AAEvC,aAAO,KAAK;AAAA,QACR,OAAO,IAAI,YAAU;AAAA,UACjB;AAAA,UACA,SAAS,MAAM;AAAA,UACf,GAAI,MAAM,aAAa,EAAC,YAAY,MAAM,WAAU,IAAI,CAAC;AAAA,QAC7D,EAAE;AAAA,MACN;AAAA,IACJ,SAAS,OAAO;AACZ,YAAM,IAAI;AAAA,QACN,0CAA0C,KAAK;AAAA,QAC/C;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAAA,EAEQ,kBAAwB;AAC5B,QAAI;AAEJ,QAAI;AACA,oBAAc,YAAY,EAAE,eAAe,CAAC;AAAA,IAChD,SAAS,OAAO;AACZ,YAAM,IAAI;AAAA,QACN;AAAA,QACA;AAAA,MACJ;AAAA,IACJ;AAEA,QAAI,CAAC,YAAY,SAAS,eAAe,GAAG;AACxC,YAAM,IAAI;AAAA,QACN;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAAA,EAEQ,UAAU,SAAqD;AACnE,UAAM,SAAS,oBAAI,IAAgC;AAEnD,eAAW,UAAU,SAAS;AAC1B,YAAM,MACF,OAAO,YAAY,SACb,GAAG,OAAO,KAAK,aAAa,OAAO,UAAU,KAC7C,GAAG,OAAO,KAAK,UAAU,OAAO,OAAO;AAEjD,aAAO,IAAI,KAAK,MAAM;AAAA,IAC1B;AAEA,WAAO,CAAC,GAAG,OAAO,OAAO,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM;AACvC,YAAM,mBAAmB,EAAE,WAAW,OAAO,qBAAqB,EAAE,WAAW,OAAO;AAEtF,UAAI,oBAAoB,GAAG;AACvB,eAAO;AAAA,MACX;AAEA,cAAQ,EAAE,cAAc,IAAI,cAAc,EAAE,cAAc,EAAE;AAAA,IAChE,CAAC;AAAA,EACL;AACJ;","names":[]}

package/dist/relay/index.d.ts

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

package/dist/relay/index.js

@@ -1,10 +1,8 @@
-import { ProxyRelay, RegisterRelay, Relay } from "./providers/index.js";
+import Relay from "./providers/Relay.js";
 const getRelay = (name) => {
   return new Relay(name).get();
 };
 export {
-  ProxyRelay,
-  RegisterRelay,
   getRelay
 };
 //# sourceMappingURL=index.js.map

package/dist/relay/index.js.map

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

package/dist/relay/providers/ProxyRelay.d.ts

@@ -1,23 +1,26 @@
-import { type InjectScriptOptions } from "@addon-core/inject-script";
 import ProxyTransport from "../../transport/ProxyTransport.js";
 import RelayPermission from "../RelayPermission.js";
-import { RelayOptions } from "../../types/relay.js";
-import { DeepAsyncProxy } from "../../types/helpers.js";
-import { TransportDictionary, TransportManager, TransportName } from "../../types/transport.js";
-export type ProxyRelayParams = number | (Omit<InjectScriptOptions, "frameId" | "documentId" | "timeFallback"> & {
-    frameId?: number;
-    documentId?: string;
-});
-export default class ProxyRelay<N extends TransportName, T = DeepAsyncProxy<TransportDictionary[N]>> extends ProxyTransport<N, T> {
-    protected options: RelayOptions;
-    protected params: ProxyRelayParams;
-    private injectScript;
-    private message;
-    constructor(name: N, options: RelayOptions, params: ProxyRelayParams);
+import type { RpcAsyncProxy } from "../../types/rpc.js";
+import { type RelayCallOptions, type RelayOptions } from "../../types/relay.js";
+import type { TransportDictionary, TransportManager, TransportName } from "../../types/transport.js";
+export type ProxyRelayParams = number | RelayCallOptions;
+export default class ProxyRelay<N extends TransportName, T = RpcAsyncProxy<TransportDictionary[N]>> extends ProxyTransport<N, T> {
+    protected readonly options: RelayOptions;
+    private readonly params;
+    private readonly permission;
+    private static readonly SelectorKeys;
+    private _adapter?;
+    private _target?;
+    constructor(name: N, options: RelayOptions, params: ProxyRelayParams, permission: RelayPermission);
+    private get adapter();
+    private get target();
     protected manager(): TransportManager;
-    protected permission(): RelayPermission;
     protected apply(args: any[], path?: string): Promise<any>;
-    private scriptingApply;
-    private messagingApply;
+    private validateTabId;
+    private validateFrameId;
+    private validateDocumentId;
+    private validateTimeout;
+    private validateArray;
+    private invalid;
     get(): T;
 }