adnbn 0.7.1 → 0.9.0

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;
 }

package/dist/relay/providers/ProxyRelay.js

@@ -1,76 +1,102 @@
-import injectScriptFactory from "@addon-core/inject-script";
 import ProxyTransport from "./../../transport/ProxyTransport.js";
+import RelayMessagingAdapter from "../adapters/RelayMessagingAdapter.js";
+import RelayScriptingAdapter from "../adapters/RelayScriptingAdapter.js";
 import RelayManager from "../RelayManager.js";
-import RelayMessage from "../RelayMessage.js";
-import RelayPermission from "../RelayPermission.js";
 import { isRelayContext } from "../utils.js";
-import { RelayGlobalKey, RelayMethod } from "./../../types/relay.js";
+import { RelayAllFrames, RelayMethod } from "./../../types/relay.js";
 class ProxyRelay extends ProxyTransport {
-  constructor(name, options, params) {
+  constructor(name, options, params, permission) {
     super(name);
     this.options = options;
     this.params = params;
-    this.message = new RelayMessage(name);
-    this.injectScript = injectScriptFactory({
-      ...typeof params === "number" ? { tabId: params } : params,
-      timeFallback: 4e3
-    });
+    this.permission = permission;
   }
   options;
   params;
-  injectScript;
-  message;
+  permission;
+  static SelectorKeys = ["allFrames", "frameId", "frameIds", "documentId", "documentIds"];
+  _adapter;
+  _target;
+  get adapter() {
+    return this._adapter ?? (this._adapter = this.options.method === RelayMethod.Scripting ? new RelayScriptingAdapter(this.name, this.target) : new RelayMessagingAdapter(this.name, this.target));
+  }
+  get target() {
+    if (this._target) {
+      return this._target;
+    }
+    const target = typeof this.params === "number" ? { tabId: this.params } : { ...this.params };
+    this.validateTabId(target.tabId);
+    this.validateTimeout(target.timeoutMs);
+    const selected = ProxyRelay.SelectorKeys.filter((key) => target[key] !== void 0);
+    if (selected.length > 1) {
+      this.invalid(`selectors are mutually exclusive; received ${selected.map((key) => `"${key}"`).join(", ")}.`);
+    }
+    if (target.allFrames !== void 0 && target.allFrames !== false && target.allFrames !== true && target.allFrames !== RelayAllFrames.Any && target.allFrames !== RelayAllFrames.All) {
+      this.invalid('"allFrames" accepts only false, true, RelayAllFrames.Any or RelayAllFrames.All.');
+    }
+    if (target.frameId !== void 0) {
+      this.validateFrameId(target.frameId);
+    }
+    if (target.frameIds !== void 0) {
+      this.validateArray(target.frameIds, "frameIds", (item, property) => this.validateFrameId(item, property));
+    }
+    if (target.documentId !== void 0) {
+      this.validateDocumentId(target.documentId);
+    }
+    if (target.documentIds !== void 0) {
+      this.validateArray(
+        target.documentIds,
+        "documentIds",
+        (item, property) => this.validateDocumentId(item, property)
+      );
+    }
+    return this._target = target;
+  }
   manager() {
     return RelayManager.getInstance();
   }
-  permission() {
-    return RelayPermission.getInstance();
-  }
   async apply(args, path) {
-    if (!this.permission().allow(this.name)) {
-      if (!await this.permission().request(this.name)) {
+    if (!this.permission.allow(this.name)) {
+      if (!await this.permission.request(this.name)) {
         throw new Error(
           `ProxyRelay: User denied required permissions for relay "${this.name}" at path "${path}". Cannot proceed with the operation.`
         );
       }
     }
-    return this.options.method === RelayMethod.Scripting ? this.scriptingApply(args, path) : this.messagingApply(args, path);
+    return this.adapter.invoke(args, path);
   }
-  async scriptingApply(args, path) {
-    var _a;
-    const func = async (name, path2, args2, key) => {
-      try {
-        const awaitManager = async (maxAttempts = 10, delay = 300) => {
-          for (let count = 0; count < maxAttempts; count++) {
-            const manager2 = globalThis[key];
-            if (manager2) return manager2;
-            await new Promise((resolve) => setTimeout(resolve, delay));
-          }
-          throw new Error(`Relay manager not found after ${maxAttempts} attempts.`);
-        };
-        const manager = await awaitManager();
-        return await manager.property(name, { path: path2, args: args2 });
-      } catch (e) {
-        console.error(
-          `ProxyRelay.scriptingApply(): failed to access relay "${name}" at path "${path2}" via injected script; manager with key "${key}" is unavailable or property not found. URL: ${document.location.href}`,
-          e
-        );
-        throw e;
-      }
-    };
-    const result = await this.injectScript.run(func, [this.name, path, args, RelayGlobalKey]);
-    return (_a = result == null ? void 0 : result[0]) == null ? void 0 : _a.result;
+  validateTabId(tabId) {
+    if (!Number.isInteger(tabId) || tabId < 0) {
+      this.invalid('"tabId" must be a non-negative integer.');
+    }
+  }
+  validateFrameId(frameId, property = "frameId") {
+    if (!Number.isInteger(frameId) || frameId < 0) {
+      this.invalid(`"${property}" must contain only non-negative integers.`);
+    }
+  }
+  validateDocumentId(documentId, property = "documentId") {
+    if (typeof documentId !== "string" || documentId.trim() === "") {
+      this.invalid(`"${property}" must contain only non-empty strings.`);
+    }
+  }
+  validateTimeout(timeoutMs) {
+    if (timeoutMs !== void 0 && (!Number.isFinite(timeoutMs) || timeoutMs <= 0)) {
+      this.invalid('"timeoutMs" must be greater than zero.');
+    }
+  }
+  validateArray(value, property, validate) {
+    if (!Array.isArray(value) || value.length === 0) {
+      this.invalid(`"${property}" must be a non-empty array.`);
+    }
+    const items = value;
+    items.forEach((item) => validate(item, property));
+    if (new Set(items).size !== items.length) {
+      this.invalid(`"${property}" must not contain duplicate values.`);
+    }
   }
-  async messagingApply(args, path) {
-    const options = typeof this.params === "number" ? {
-      tabId: this.params,
-      frameId: 0
-    } : {
-      tabId: this.params.tabId,
-      frameId: this.params.frameId || 0,
-      documentId: this.params.documentId
-    };
-    return this.message.send({ path, args }, options);
+  invalid(message) {
+    throw new TypeError(`Invalid Relay target: ${message}`);
   }
   get() {
     if (isRelayContext()) {
@@ -78,6 +104,7 @@ class ProxyRelay extends ProxyTransport {
         `You are trying to get proxy relay "${this.name}" from script content. You can get original relay instead`
       );
     }
+    void this.target;
     return super.get();
   }
 }

package/dist/relay/providers/ProxyRelay.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/relay/providers/ProxyRelay.ts"],"sourcesContent":["import injectScriptFactory, {type InjectScriptContract, type InjectScriptOptions} from \"@addon-core/inject-script\";\n\nimport ProxyTransport from \"@transport/ProxyTransport\";\n\nimport RelayManager from \"../RelayManager\";\nimport RelayMessage from \"../RelayMessage\";\nimport RelayPermission from \"../RelayPermission\";\n\nimport {isRelayContext} from \"../utils\";\n\nimport {RelayGlobalKey, RelayMethod, RelayOptions} from \"@typing/relay\";\nimport {DeepAsyncProxy} from \"@typing/helpers\";\nimport {MessageSendOptions} from \"@typing/message\";\nimport {TransportDictionary, TransportManager, TransportMessage, TransportName} from \"@typing/transport\";\n\nexport type ProxyRelayParams =\n    | number\n    | (Omit<InjectScriptOptions, \"frameId\" | \"documentId\" | \"timeFallback\"> & {\n          frameId?: number;\n          documentId?: string;\n      });\n\nexport default class ProxyRelay<\n    N extends TransportName,\n    T = DeepAsyncProxy<TransportDictionary[N]>,\n> extends ProxyTransport<N, T> {\n    private injectScript: InjectScriptContract;\n    private message: TransportMessage;\n\n    constructor(\n        name: N,\n        protected options: RelayOptions,\n        protected params: ProxyRelayParams\n    ) {\n        super(name);\n\n        this.message = new RelayMessage(name);\n\n        this.injectScript = injectScriptFactory({\n            ...(typeof params === \"number\" ? {tabId: params} : params),\n            timeFallback: 4000,\n        });\n    }\n\n    protected manager(): TransportManager {\n        return RelayManager.getInstance();\n    }\n\n    protected permission(): RelayPermission {\n        return RelayPermission.getInstance();\n    }\n\n    protected async apply(args: any[], path?: string): Promise<any> {\n        if (!this.permission().allow(this.name)) {\n            if (!(await this.permission().request(this.name))) {\n                throw new Error(\n                    `ProxyRelay: User denied required permissions for relay \"${this.name}\" at path \"${path}\". Cannot proceed with the operation.`\n                );\n            }\n        }\n\n        return this.options.method === RelayMethod.Scripting\n            ? this.scriptingApply(args, path)\n            : this.messagingApply(args, path);\n    }\n\n    private async scriptingApply(args: any[], path?: string): Promise<any> {\n        const func = async (name: string, path: string, args: any[], key: string) => {\n            try {\n                const awaitManager = async (maxAttempts = 10, delay = 300): Promise<RelayManager> => {\n                    for (let count = 0; count < maxAttempts; count++) {\n                        const manager = globalThis[key];\n\n                        if (manager) return manager;\n\n                        await new Promise(resolve => setTimeout(resolve, delay));\n                    }\n\n                    throw new Error(`Relay manager not found after ${maxAttempts} attempts.`);\n                };\n\n                const manager: RelayManager = await awaitManager();\n\n                return await manager.property(name, {path, args});\n            } catch (e) {\n                console.error(\n                    `ProxyRelay.scriptingApply(): failed to access relay \"${name}\" at path \"${path}\" via injected script; manager with key \"${key}\" is unavailable or property not found. URL: ${document.location.href}`,\n                    e\n                );\n\n                throw e;\n            }\n        };\n\n        const result = await this.injectScript.run(func, [this.name, path!, args, RelayGlobalKey]);\n\n        return result?.[0]?.result;\n    }\n\n    private async messagingApply(args: any[], path?: string): Promise<any> {\n        const options: MessageSendOptions =\n            typeof this.params === \"number\"\n                ? {\n                      tabId: this.params,\n                      frameId: 0,\n                  }\n                : {\n                      tabId: this.params.tabId,\n                      frameId: this.params.frameId || 0,\n                      documentId: this.params.documentId,\n                  };\n\n        return this.message.send({path, args}, options);\n    }\n\n    public get(): T {\n        if (isRelayContext()) {\n            throw new Error(\n                `You are trying to get proxy relay \"${this.name}\" from script content. You can get original relay instead`\n            );\n        }\n\n        return super.get();\n    }\n}\n"],"mappings":"AAAA,OAAO,yBAAgF;AAEvF,OAAO,oBAAoB;AAE3B,OAAO,kBAAkB;AACzB,OAAO,kBAAkB;AACzB,OAAO,qBAAqB;AAE5B,SAAQ,sBAAqB;AAE7B,SAAQ,gBAAgB,mBAAgC;AAYxD,MAAO,mBAGG,eAAqB;AAAA,EAI3B,YACI,MACU,SACA,QACZ;AACE,UAAM,IAAI;AAHA;AACA;AAIV,SAAK,UAAU,IAAI,aAAa,IAAI;AAEpC,SAAK,eAAe,oBAAoB;AAAA,MACpC,GAAI,OAAO,WAAW,WAAW,EAAC,OAAO,OAAM,IAAI;AAAA,MACnD,cAAc;AAAA,IAClB,CAAC;AAAA,EACL;AAAA,EAXc;AAAA,EACA;AAAA,EANN;AAAA,EACA;AAAA,EAiBE,UAA4B;AAClC,WAAO,aAAa,YAAY;AAAA,EACpC;AAAA,EAEU,aAA8B;AACpC,WAAO,gBAAgB,YAAY;AAAA,EACvC;AAAA,EAEA,MAAgB,MAAM,MAAa,MAA6B;AAC5D,QAAI,CAAC,KAAK,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG;AACrC,UAAI,CAAE,MAAM,KAAK,WAAW,EAAE,QAAQ,KAAK,IAAI,GAAI;AAC/C,cAAM,IAAI;AAAA,UACN,2DAA2D,KAAK,IAAI,cAAc,IAAI;AAAA,QAC1F;AAAA,MACJ;AAAA,IACJ;AAEA,WAAO,KAAK,QAAQ,WAAW,YAAY,YACrC,KAAK,eAAe,MAAM,IAAI,IAC9B,KAAK,eAAe,MAAM,IAAI;AAAA,EACxC;AAAA,EAEA,MAAc,eAAe,MAAa,MAA6B;AAlE3E;AAmEQ,UAAM,OAAO,OAAO,MAAcA,OAAcC,OAAa,QAAgB;AACzE,UAAI;AACA,cAAM,eAAe,OAAO,cAAc,IAAI,QAAQ,QAA+B;AACjF,mBAAS,QAAQ,GAAG,QAAQ,aAAa,SAAS;AAC9C,kBAAMC,WAAU,WAAW,GAAG;AAE9B,gBAAIA,SAAS,QAAOA;AAEpB,kBAAM,IAAI,QAAQ,aAAW,WAAW,SAAS,KAAK,CAAC;AAAA,UAC3D;AAEA,gBAAM,IAAI,MAAM,iCAAiC,WAAW,YAAY;AAAA,QAC5E;AAEA,cAAM,UAAwB,MAAM,aAAa;AAEjD,eAAO,MAAM,QAAQ,SAAS,MAAM,EAAC,MAAAF,OAAM,MAAAC,MAAI,CAAC;AAAA,MACpD,SAAS,GAAG;AACR,gBAAQ;AAAA,UACJ,wDAAwD,IAAI,cAAcD,KAAI,4CAA4C,GAAG,gDAAgD,SAAS,SAAS,IAAI;AAAA,UACnM;AAAA,QACJ;AAEA,cAAM;AAAA,MACV;AAAA,IACJ;AAEA,UAAM,SAAS,MAAM,KAAK,aAAa,IAAI,MAAM,CAAC,KAAK,MAAM,MAAO,MAAM,cAAc,CAAC;AAEzF,YAAO,sCAAS,OAAT,mBAAa;AAAA,EACxB;AAAA,EAEA,MAAc,eAAe,MAAa,MAA6B;AACnE,UAAM,UACF,OAAO,KAAK,WAAW,WACjB;AAAA,MACI,OAAO,KAAK;AAAA,MACZ,SAAS;AAAA,IACb,IACA;AAAA,MACI,OAAO,KAAK,OAAO;AAAA,MACnB,SAAS,KAAK,OAAO,WAAW;AAAA,MAChC,YAAY,KAAK,OAAO;AAAA,IAC5B;AAEV,WAAO,KAAK,QAAQ,KAAK,EAAC,MAAM,KAAI,GAAG,OAAO;AAAA,EAClD;AAAA,EAEO,MAAS;AACZ,QAAI,eAAe,GAAG;AAClB,YAAM,IAAI;AAAA,QACN,sCAAsC,KAAK,IAAI;AAAA,MACnD;AAAA,IACJ;AAEA,WAAO,MAAM,IAAI;AAAA,EACrB;AACJ;","names":["path","args","manager"]}
+{"version":3,"sources":["../../../src/relay/providers/ProxyRelay.ts"],"sourcesContent":["import ProxyTransport from \"@transport/ProxyTransport\";\n\nimport RelayAdapter from \"../adapters/RelayAdapter\";\nimport RelayMessagingAdapter from \"../adapters/RelayMessagingAdapter\";\nimport RelayScriptingAdapter from \"../adapters/RelayScriptingAdapter\";\nimport RelayManager from \"../RelayManager\";\nimport RelayPermission from \"../RelayPermission\";\nimport {isRelayContext} from \"../utils\";\n\nimport type {RpcAsyncProxy} from \"@typing/rpc\";\nimport {RelayAllFrames, RelayMethod, type RelayCallOptions, type RelayOptions} from \"@typing/relay\";\nimport type {TransportDictionary, TransportManager, TransportName} from \"@typing/transport\";\n\nexport type ProxyRelayParams = number | RelayCallOptions;\n\nexport default class ProxyRelay<\n    N extends TransportName,\n    T = RpcAsyncProxy<TransportDictionary[N]>,\n> extends ProxyTransport<N, T> {\n    private static readonly SelectorKeys = [\"allFrames\", \"frameId\", \"frameIds\", \"documentId\", \"documentIds\"] as const;\n\n    private _adapter?: RelayAdapter;\n    private _target?: RelayCallOptions;\n\n    constructor(\n        name: N,\n        protected readonly options: RelayOptions,\n        private readonly params: ProxyRelayParams,\n        private readonly permission: RelayPermission\n    ) {\n        super(name);\n    }\n\n    private get adapter(): RelayAdapter {\n        return (this._adapter ??=\n            this.options.method === RelayMethod.Scripting\n                ? new RelayScriptingAdapter(this.name, this.target)\n                : new RelayMessagingAdapter(this.name, this.target));\n    }\n\n    private get target(): RelayCallOptions {\n        if (this._target) {\n            return this._target;\n        }\n\n        const target: Record<string, unknown> =\n            typeof this.params === \"number\" ? {tabId: this.params} : {...this.params};\n\n        this.validateTabId(target.tabId);\n        this.validateTimeout(target.timeoutMs);\n\n        const selected = ProxyRelay.SelectorKeys.filter(key => target[key] !== undefined);\n\n        if (selected.length > 1) {\n            this.invalid(`selectors are mutually exclusive; received ${selected.map(key => `\"${key}\"`).join(\", \")}.`);\n        }\n\n        if (\n            target.allFrames !== undefined &&\n            target.allFrames !== false &&\n            target.allFrames !== true &&\n            target.allFrames !== RelayAllFrames.Any &&\n            target.allFrames !== RelayAllFrames.All\n        ) {\n            this.invalid('\"allFrames\" accepts only false, true, RelayAllFrames.Any or RelayAllFrames.All.');\n        }\n\n        if (target.frameId !== undefined) {\n            this.validateFrameId(target.frameId);\n        }\n\n        if (target.frameIds !== undefined) {\n            this.validateArray(target.frameIds, \"frameIds\", (item, property) => this.validateFrameId(item, property));\n        }\n\n        if (target.documentId !== undefined) {\n            this.validateDocumentId(target.documentId);\n        }\n\n        if (target.documentIds !== undefined) {\n            this.validateArray(target.documentIds, \"documentIds\", (item, property) =>\n                this.validateDocumentId(item, property)\n            );\n        }\n\n        return (this._target = target as unknown as RelayCallOptions);\n    }\n\n    protected manager(): TransportManager {\n        return RelayManager.getInstance();\n    }\n\n    protected async apply(args: any[], path?: string): Promise<any> {\n        if (!this.permission.allow(this.name)) {\n            if (!(await this.permission.request(this.name))) {\n                throw new Error(\n                    `ProxyRelay: User denied required permissions for relay \"${this.name}\" at path \"${path}\". Cannot proceed with the operation.`\n                );\n            }\n        }\n\n        return this.adapter.invoke(args, path);\n    }\n\n    private validateTabId(tabId: unknown): void {\n        if (!Number.isInteger(tabId) || (tabId as number) < 0) {\n            this.invalid('\"tabId\" must be a non-negative integer.');\n        }\n    }\n\n    private validateFrameId(frameId: unknown, property = \"frameId\"): void {\n        if (!Number.isInteger(frameId) || (frameId as number) < 0) {\n            this.invalid(`\"${property}\" must contain only non-negative integers.`);\n        }\n    }\n\n    private validateDocumentId(documentId: unknown, property = \"documentId\"): void {\n        if (typeof documentId !== \"string\" || documentId.trim() === \"\") {\n            this.invalid(`\"${property}\" must contain only non-empty strings.`);\n        }\n    }\n\n    private validateTimeout(timeoutMs: unknown): void {\n        if (timeoutMs !== undefined && (!Number.isFinite(timeoutMs) || (timeoutMs as number) <= 0)) {\n            this.invalid('\"timeoutMs\" must be greater than zero.');\n        }\n    }\n\n    private validateArray(\n        value: unknown,\n        property: \"frameIds\" | \"documentIds\",\n        validate: (item: unknown, property: string) => void\n    ): void {\n        if (!Array.isArray(value) || value.length === 0) {\n            this.invalid(`\"${property}\" must be a non-empty array.`);\n        }\n\n        const items = value as unknown[];\n\n        items.forEach(item => validate(item, property));\n\n        if (new Set(items).size !== items.length) {\n            this.invalid(`\"${property}\" must not contain duplicate values.`);\n        }\n    }\n\n    private invalid(message: string): never {\n        throw new TypeError(`Invalid Relay target: ${message}`);\n    }\n\n    public get(): T {\n        if (isRelayContext()) {\n            throw new Error(\n                `You are trying to get proxy relay \"${this.name}\" from script content. You can get original relay instead`\n            );\n        }\n\n        void this.target;\n\n        return super.get();\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/relay/providers/RegisterRelay.js

@@ -25,9 +25,8 @@ class RegisterRelay_default extends RegisterTransport {
       const relay = this.init(...args);
       this.manager().add(this.name, relay);
       return relay;
-    } else {
-      return super.register(...args);
     }
+    return super.register(...args);
   }
   get() {
     if (!isRelayContext()) {

package/dist/relay/providers/RegisterRelay.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/relay/providers/RegisterRelay.ts"],"sourcesContent":["import RegisterTransport from \"@transport/RegisterTransport\";\n\nimport RelayMessage from \"../RelayMessage\";\nimport RelayManager from \"../RelayManager\";\nimport {isRelayContext} from \"../utils\";\n\nimport {TransportDictionary, TransportManager, TransportMessage, TransportName} from \"@typing/transport\";\nimport {RelayMethod} from \"@typing/relay\";\n\nexport default class<\n    N extends TransportName,\n    T extends object = TransportDictionary[N],\n    A extends any[] = [],\n> extends RegisterTransport<N, T, A> {\n    constructor(\n        name: N,\n        protected method: RelayMethod,\n        protected readonly init: (...args: A) => T\n    ) {\n        super(name, init);\n    }\n\n    protected message(): TransportMessage {\n        return new RelayMessage(this.name);\n    }\n\n    protected manager(): TransportManager {\n        return RelayManager.getInstance();\n    }\n\n    public register(...args: A): T {\n        if (this.method === RelayMethod.Scripting) {\n            if (this.manager().has(this.name)) {\n                throw new Error(`A relay with the name \"${this.name}\" already exists. The relay name must be unique.`);\n            }\n\n            const relay = this.init(...args);\n\n            this.manager().add(this.name, relay);\n\n            return relay;\n        } else {\n            return super.register(...args);\n        }\n    }\n\n    public get(): T {\n        if (!isRelayContext()) {\n            throw new Error(`Relay \"${this.name}\" can be getting only from content script`);\n        }\n\n        return super.get();\n    }\n}\n"],"mappings":"AAAA,OAAO,uBAAuB;AAE9B,OAAO,kBAAkB;AACzB,OAAO,kBAAkB;AACzB,SAAQ,sBAAqB;AAG7B,SAAQ,mBAAkB;AAE1B,MAAO,8BAIG,kBAA2B;AAAA,EACjC,YACI,MACU,QACS,MACrB;AACE,UAAM,MAAM,IAAI;AAHN;AACS;AAAA,EAGvB;AAAA,EAJc;AAAA,EACS;AAAA,EAKb,UAA4B;AAClC,WAAO,IAAI,aAAa,KAAK,IAAI;AAAA,EACrC;AAAA,EAEU,UAA4B;AAClC,WAAO,aAAa,YAAY;AAAA,EACpC;AAAA,EAEO,YAAY,MAAY;AAC3B,QAAI,KAAK,WAAW,YAAY,WAAW;AACvC,UAAI,KAAK,QAAQ,EAAE,IAAI,KAAK,IAAI,GAAG;AAC/B,cAAM,IAAI,MAAM,0BAA0B,KAAK,IAAI,kDAAkD;AAAA,MACzG;AAEA,YAAM,QAAQ,KAAK,KAAK,GAAG,IAAI;AAE/B,WAAK,QAAQ,EAAE,IAAI,KAAK,MAAM,KAAK;AAEnC,aAAO;AAAA,IACX,OAAO;AACH,aAAO,MAAM,SAAS,GAAG,IAAI;AAAA,IACjC;AAAA,EACJ;AAAA,EAEO,MAAS;AACZ,QAAI,CAAC,eAAe,GAAG;AACnB,YAAM,IAAI,MAAM,UAAU,KAAK,IAAI,2CAA2C;AAAA,IAClF;AAEA,WAAO,MAAM,IAAI;AAAA,EACrB;AACJ;","names":[]}
+{"version":3,"sources":["../../../src/relay/providers/RegisterRelay.ts"],"sourcesContent":["import RegisterTransport from \"@transport/RegisterTransport\";\n\nimport RelayMessage from \"../RelayMessage\";\nimport RelayManager from \"../RelayManager\";\nimport {isRelayContext} from \"../utils\";\n\nimport {TransportDictionary, TransportManager, TransportMessage, TransportName} from \"@typing/transport\";\nimport {RelayMethod} from \"@typing/relay\";\n\nexport default class<\n    N extends TransportName,\n    T extends object = TransportDictionary[N],\n    A extends any[] = [],\n> extends RegisterTransport<N, T, A> {\n    constructor(\n        name: N,\n        protected method: RelayMethod,\n        protected readonly init: (...args: A) => T\n    ) {\n        super(name, init);\n    }\n\n    protected message(): TransportMessage {\n        return new RelayMessage(this.name);\n    }\n\n    protected manager(): TransportManager {\n        return RelayManager.getInstance();\n    }\n\n    public register(...args: A): T {\n        if (this.method === RelayMethod.Scripting) {\n            if (this.manager().has(this.name)) {\n                throw new Error(`A relay with the name \"${this.name}\" already exists. The relay name must be unique.`);\n            }\n\n            const relay = this.init(...args);\n\n            this.manager().add(this.name, relay);\n\n            return relay;\n        }\n\n        return super.register(...args);\n    }\n\n    public get(): T {\n        if (!isRelayContext()) {\n            throw new Error(`Relay \"${this.name}\" can be getting only from content script`);\n        }\n\n        return super.get();\n    }\n}\n"],"mappings":"AAAA,OAAO,uBAAuB;AAE9B,OAAO,kBAAkB;AACzB,OAAO,kBAAkB;AACzB,SAAQ,sBAAqB;AAG7B,SAAQ,mBAAkB;AAE1B,MAAO,8BAIG,kBAA2B;AAAA,EACjC,YACI,MACU,QACS,MACrB;AACE,UAAM,MAAM,IAAI;AAHN;AACS;AAAA,EAGvB;AAAA,EAJc;AAAA,EACS;AAAA,EAKb,UAA4B;AAClC,WAAO,IAAI,aAAa,KAAK,IAAI;AAAA,EACrC;AAAA,EAEU,UAA4B;AAClC,WAAO,aAAa,YAAY;AAAA,EACpC;AAAA,EAEO,YAAY,MAAY;AAC3B,QAAI,KAAK,WAAW,YAAY,WAAW;AACvC,UAAI,KAAK,QAAQ,EAAE,IAAI,KAAK,IAAI,GAAG;AAC/B,cAAM,IAAI,MAAM,0BAA0B,KAAK,IAAI,kDAAkD;AAAA,MACzG;AAEA,YAAM,QAAQ,KAAK,KAAK,GAAG,IAAI;AAE/B,WAAK,QAAQ,EAAE,IAAI,KAAK,MAAM,KAAK;AAEnC,aAAO;AAAA,IACX;AAEA,WAAO,MAAM,SAAS,GAAG,IAAI;AAAA,EACjC;AAAA,EAEO,MAAS;AACZ,QAAI,CAAC,eAAe,GAAG;AACnB,YAAM,IAAI,MAAM,UAAU,KAAK,IAAI,2CAA2C;AAAA,IAClF;AAEA,WAAO,MAAM,IAAI;AAAA,EACrB;AACJ;","names":[]}

package/dist/relay/result.d.ts

@@ -0,0 +1,12 @@
+import { InjectScriptTargetErrorKind } from "@addon-core/inject-script";
+import { RelayFrameErrorKind, type RelayFrameResult, type RelayFramesResult, type RelayResultTarget } from "../types/relay.js";
+export declare class RelayFrameTimeoutError extends Error {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+export declare const fulfilledRelayFrame: <T>(target: RelayResultTarget, result: T) => RelayFrameResult<T>;
+export declare const rejectedRelayFrame: <T>(target: RelayResultTarget, error: unknown, kind: RelayFrameErrorKind) => RelayFrameResult<T>;
+export declare const messageErrorKind: (error: unknown) => RelayFrameErrorKind;
+export declare const injectScriptErrorKind: (kind: `${InjectScriptTargetErrorKind}`) => RelayFrameErrorKind;
+export declare const withRelayTimeout: <T>(promise: Promise<T>, timeoutMs?: number) => Promise<T>;
+export declare const sortRelayFrameResults: <T>(results: RelayFramesResult<T>) => RelayFramesResult<T>;