adnbn 0.8.0 → 0.9.0

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

package/dist/relay/result.js

@@ -0,0 +1,88 @@
+import { serializeError } from "./../message/error.js";
+import { InjectScriptTargetErrorKind } from "@addon-core/inject-script";
+import {
+  RelayFrameErrorKind
+} from "./../types/relay.js";
+class RelayFrameTimeoutError extends Error {
+  constructor(timeoutMs) {
+    super(`Relay frame did not respond within ${timeoutMs}ms.`);
+    this.timeoutMs = timeoutMs;
+    this.name = "RelayFrameTimeoutError";
+  }
+  timeoutMs;
+}
+const fulfilledRelayFrame = (target, result) => ({
+  target,
+  status: "fulfilled",
+  result
+});
+const rejectedRelayFrame = (target, error, kind) => ({
+  target,
+  status: "rejected",
+  error: {
+    kind,
+    ...serializeError(error)
+  }
+});
+const messageErrorKind = (error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  if (/receiving end does not exist|no matching message handler|frame.*(?:removed|not found)|no frame with id|invalid frame id/i.test(
+    message
+  )) {
+    return RelayFrameErrorKind.TargetGone;
+  }
+  return RelayFrameErrorKind.Delivery;
+};
+const injectScriptErrorKind = (kind) => {
+  switch (kind) {
+    case InjectScriptTargetErrorKind.Execution:
+      return RelayFrameErrorKind.Execution;
+    case InjectScriptTargetErrorKind.Delivery:
+      return RelayFrameErrorKind.Delivery;
+    case InjectScriptTargetErrorKind.Timeout:
+      return RelayFrameErrorKind.Timeout;
+    case InjectScriptTargetErrorKind.TargetGone:
+      return RelayFrameErrorKind.TargetGone;
+    case InjectScriptTargetErrorKind.Unobservable:
+      return RelayFrameErrorKind.Unobservable;
+    default:
+      throw new TypeError(`Unsupported Inject Script target error kind: ${kind}`);
+  }
+};
+const withRelayTimeout = (promise, timeoutMs) => {
+  if (timeoutMs === void 0) {
+    return promise;
+  }
+  return new Promise((resolve, reject) => {
+    const timeout = setTimeout(() => reject(new RelayFrameTimeoutError(timeoutMs)), timeoutMs);
+    promise.then(
+      (result) => {
+        clearTimeout(timeout);
+        resolve(result);
+      },
+      (error) => {
+        clearTimeout(timeout);
+        reject(error);
+      }
+    );
+  });
+};
+const sortRelayFrameResults = (results) => {
+  return [...results].sort((a, b) => {
+    const frameDifference = (a.target.frameId ?? Number.MAX_SAFE_INTEGER) - (b.target.frameId ?? Number.MAX_SAFE_INTEGER);
+    if (frameDifference !== 0) {
+      return frameDifference;
+    }
+    return (a.target.documentId ?? "").localeCompare(b.target.documentId ?? "");
+  });
+};
+export {
+  RelayFrameTimeoutError,
+  fulfilledRelayFrame,
+  injectScriptErrorKind,
+  messageErrorKind,
+  rejectedRelayFrame,
+  sortRelayFrameResults,
+  withRelayTimeout
+};
+//# sourceMappingURL=result.js.map

package/dist/relay/result.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/relay/result.ts"],"sourcesContent":["import {serializeError} from \"@message/error\";\n\nimport {InjectScriptTargetErrorKind} from \"@addon-core/inject-script\";\n\nimport {\n    RelayFrameErrorKind,\n    type RelayFrameResult,\n    type RelayFramesResult,\n    type RelayResultTarget,\n} from \"@typing/relay\";\n\nexport class RelayFrameTimeoutError extends Error {\n    public constructor(public readonly timeoutMs: number) {\n        super(`Relay frame did not respond within ${timeoutMs}ms.`);\n        this.name = \"RelayFrameTimeoutError\";\n    }\n}\n\nexport const fulfilledRelayFrame = <T>(target: RelayResultTarget, result: T): RelayFrameResult<T> => ({\n    target,\n    status: \"fulfilled\",\n    result,\n});\n\nexport const rejectedRelayFrame = <T>(\n    target: RelayResultTarget,\n    error: unknown,\n    kind: RelayFrameErrorKind\n): RelayFrameResult<T> => ({\n    target,\n    status: \"rejected\",\n    error: {\n        kind,\n        ...serializeError(error),\n    },\n});\n\nexport const messageErrorKind = (error: unknown): RelayFrameErrorKind => {\n    const message = error instanceof Error ? error.message : String(error);\n\n    if (\n        /receiving end does not exist|no matching message handler|frame.*(?:removed|not found)|no frame with id|invalid frame id/i.test(\n            message\n        )\n    ) {\n        return RelayFrameErrorKind.TargetGone;\n    }\n\n    return RelayFrameErrorKind.Delivery;\n};\n\nexport const injectScriptErrorKind = (kind: `${InjectScriptTargetErrorKind}`): RelayFrameErrorKind => {\n    switch (kind) {\n        case InjectScriptTargetErrorKind.Execution:\n            return RelayFrameErrorKind.Execution;\n        case InjectScriptTargetErrorKind.Delivery:\n            return RelayFrameErrorKind.Delivery;\n        case InjectScriptTargetErrorKind.Timeout:\n            return RelayFrameErrorKind.Timeout;\n        case InjectScriptTargetErrorKind.TargetGone:\n            return RelayFrameErrorKind.TargetGone;\n        case InjectScriptTargetErrorKind.Unobservable:\n            return RelayFrameErrorKind.Unobservable;\n        default:\n            throw new TypeError(`Unsupported Inject Script target error kind: ${kind}`);\n    }\n};\n\nexport const withRelayTimeout = <T>(promise: Promise<T>, timeoutMs?: number): Promise<T> => {\n    if (timeoutMs === undefined) {\n        return promise;\n    }\n\n    return new Promise<T>((resolve, reject) => {\n        const timeout = setTimeout(() => reject(new RelayFrameTimeoutError(timeoutMs)), timeoutMs);\n\n        promise.then(\n            result => {\n                clearTimeout(timeout);\n                resolve(result);\n            },\n            error => {\n                clearTimeout(timeout);\n                reject(error);\n            }\n        );\n    });\n};\n\nexport const sortRelayFrameResults = <T>(results: RelayFramesResult<T>): RelayFramesResult<T> => {\n    return [...results].sort((a, b) => {\n        const frameDifference =\n            (a.target.frameId ?? Number.MAX_SAFE_INTEGER) - (b.target.frameId ?? Number.MAX_SAFE_INTEGER);\n\n        if (frameDifference !== 0) {\n            return frameDifference;\n        }\n\n        return (a.target.documentId ?? \"\").localeCompare(b.target.documentId ?? \"\");\n    });\n};\n"],"mappings":"AAAA,SAAQ,sBAAqB;AAE7B,SAAQ,mCAAkC;AAE1C;AAAA,EACI;AAAA,OAIG;AAEA,MAAM,+BAA+B,MAAM;AAAA,EACvC,YAA4B,WAAmB;AAClD,UAAM,sCAAsC,SAAS,KAAK;AAD3B;AAE/B,SAAK,OAAO;AAAA,EAChB;AAAA,EAHmC;AAIvC;AAEO,MAAM,sBAAsB,CAAI,QAA2B,YAAoC;AAAA,EAClG;AAAA,EACA,QAAQ;AAAA,EACR;AACJ;AAEO,MAAM,qBAAqB,CAC9B,QACA,OACA,UACuB;AAAA,EACvB;AAAA,EACA,QAAQ;AAAA,EACR,OAAO;AAAA,IACH;AAAA,IACA,GAAG,eAAe,KAAK;AAAA,EAC3B;AACJ;AAEO,MAAM,mBAAmB,CAAC,UAAwC;AACrE,QAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAErE,MACI,2HAA2H;AAAA,IACvH;AAAA,EACJ,GACF;AACE,WAAO,oBAAoB;AAAA,EAC/B;AAEA,SAAO,oBAAoB;AAC/B;AAEO,MAAM,wBAAwB,CAAC,SAAgE;AAClG,UAAQ,MAAM;AAAA,IACV,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B;AACI,YAAM,IAAI,UAAU,gDAAgD,IAAI,EAAE;AAAA,EAClF;AACJ;AAEO,MAAM,mBAAmB,CAAI,SAAqB,cAAmC;AACxF,MAAI,cAAc,QAAW;AACzB,WAAO;AAAA,EACX;AAEA,SAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AACvC,UAAM,UAAU,WAAW,MAAM,OAAO,IAAI,uBAAuB,SAAS,CAAC,GAAG,SAAS;AAEzF,YAAQ;AAAA,MACJ,YAAU;AACN,qBAAa,OAAO;AACpB,gBAAQ,MAAM;AAAA,MAClB;AAAA,MACA,WAAS;AACL,qBAAa,OAAO;AACpB,eAAO,KAAK;AAAA,MAChB;AAAA,IACJ;AAAA,EACJ,CAAC;AACL;AAEO,MAAM,wBAAwB,CAAI,YAAwD;AAC7F,SAAO,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM;AAC/B,UAAM,mBACD,EAAE,OAAO,WAAW,OAAO,qBAAqB,EAAE,OAAO,WAAW,OAAO;AAEhF,QAAI,oBAAoB,GAAG;AACvB,aAAO;AAAA,IACX;AAEA,YAAQ,EAAE,OAAO,cAAc,IAAI,cAAc,EAAE,OAAO,cAAc,EAAE;AAAA,EAC9E,CAAC;AACL;","names":[]}

package/dist/sandbox/index.d.ts

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

package/dist/sandbox/index.js.map

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

package/dist/sandbox/providers/ProxySandbox.d.ts

@@ -1,8 +1,8 @@
 import ProxyTransport from "../../transport/ProxyTransport.js";
-import type { DeepAsyncProxy } from "../../types/helpers.js";
+import type { RpcAsyncProxy } from "../../types/rpc.js";
 import type { SandboxParameters } from "../../types/sandbox.js";
 import type { TransportDictionary, TransportManager, TransportName } from "../../types/transport.js";
-export default class<N extends TransportName, T = DeepAsyncProxy<TransportDictionary[N]>> extends ProxyTransport<N, T> {
+export default class<N extends TransportName, T = RpcAsyncProxy<TransportDictionary[N]>> extends ProxyTransport<N, T> {
     private readonly parameters;
     constructor(name: N, parameters: SandboxParameters);
     protected manager(): TransportManager;

package/dist/sandbox/providers/ProxySandbox.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/sandbox/providers/ProxySandbox.ts"],"sourcesContent":["import ProxyTransport from \"@transport/ProxyTransport\";\n\nimport SandboxManager from \"../SandboxManager\";\nimport SandboxMessage from \"../SandboxMessage\";\n\nimport type {DeepAsyncProxy} from \"@typing/helpers\";\nimport type {SandboxParameters} from \"@typing/sandbox\";\nimport type {TransportDictionary, TransportManager, TransportName} from \"@typing/transport\";\n\nexport default class<N extends TransportName, T = DeepAsyncProxy<TransportDictionary[N]>> extends ProxyTransport<N, T> {\n    constructor(\n        name: N,\n        private readonly parameters: SandboxParameters\n    ) {\n        super(name);\n    }\n\n    protected manager(): TransportManager {\n        return SandboxManager.getInstance();\n    }\n\n    protected apply(args: any[], path?: string): Promise<any> {\n        return SandboxMessage.for(this.name, this.parameters).send({path, args});\n    }\n}\n"],"mappings":"AAAA,OAAO,oBAAoB;AAE3B,OAAO,oBAAoB;AAC3B,OAAO,oBAAoB;AAM3B,MAAO,6BAA2F,eAAqB;AAAA,EACnH,YACI,MACiB,YACnB;AACE,UAAM,IAAI;AAFO;AAAA,EAGrB;AAAA,EAHqB;AAAA,EAKX,UAA4B;AAClC,WAAO,eAAe,YAAY;AAAA,EACtC;AAAA,EAEU,MAAM,MAAa,MAA6B;AACtD,WAAO,eAAe,IAAI,KAAK,MAAM,KAAK,UAAU,EAAE,KAAK,EAAC,MAAM,KAAI,CAAC;AAAA,EAC3E;AACJ;","names":[]}
+{"version":3,"sources":["../../../src/sandbox/providers/ProxySandbox.ts"],"sourcesContent":["import ProxyTransport from \"@transport/ProxyTransport\";\n\nimport SandboxManager from \"../SandboxManager\";\nimport SandboxMessage from \"../SandboxMessage\";\n\nimport type {RpcAsyncProxy} from \"@typing/rpc\";\nimport type {SandboxParameters} from \"@typing/sandbox\";\nimport type {TransportDictionary, TransportManager, TransportName} from \"@typing/transport\";\n\nexport default class<N extends TransportName, T = RpcAsyncProxy<TransportDictionary[N]>> extends ProxyTransport<N, T> {\n    constructor(\n        name: N,\n        private readonly parameters: SandboxParameters\n    ) {\n        super(name);\n    }\n\n    protected manager(): TransportManager {\n        return SandboxManager.getInstance();\n    }\n\n    protected apply(args: any[], path?: string): Promise<any> {\n        return SandboxMessage.for(this.name, this.parameters).send({path, args});\n    }\n}\n"],"mappings":"AAAA,OAAO,oBAAoB;AAE3B,OAAO,oBAAoB;AAC3B,OAAO,oBAAoB;AAM3B,MAAO,6BAA0F,eAAqB;AAAA,EAClH,YACI,MACiB,YACnB;AACE,UAAM,IAAI;AAFO;AAAA,EAGrB;AAAA,EAHqB;AAAA,EAKX,UAA4B;AAClC,WAAO,eAAe,YAAY;AAAA,EACtC;AAAA,EAEU,MAAM,MAAa,MAA6B;AACtD,WAAO,eAAe,IAAI,KAAK,MAAM,KAAK,UAAU,EAAE,KAAK,EAAC,MAAM,KAAI,CAAC;AAAA,EAC3E;AACJ;","names":[]}

package/dist/service/providers/ProxyService.d.ts

@@ -1,7 +1,7 @@
 import ProxyTransport from "../../transport/ProxyTransport.js";
-import type { DeepAsyncProxy } from "../../types/helpers.js";
+import type { RpcAsyncProxy } from "../../types/rpc.js";
 import type { TransportDictionary, TransportManager, TransportMessage, TransportName } from "../../types/transport.js";
-export default class<N extends TransportName, T = DeepAsyncProxy<TransportDictionary[N]>> extends ProxyTransport<N, T> {
+export default class<N extends TransportName, T = RpcAsyncProxy<TransportDictionary[N]>> extends ProxyTransport<N, T> {
     protected message: TransportMessage;
     constructor(name: N);
     protected manager(): TransportManager;

package/dist/service/providers/ProxyService.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/service/providers/ProxyService.ts"],"sourcesContent":["import {isBackground} from \"@addon-core/browser\";\n\nimport ProxyTransport from \"@transport/ProxyTransport\";\n\nimport ServiceManager from \"../ServiceManager\";\nimport ServiceMessage from \"../ServiceMessage\";\n\nimport type {DeepAsyncProxy} from \"@typing/helpers\";\nimport type {TransportDictionary, TransportManager, TransportMessage, TransportName} from \"@typing/transport\";\n\nexport default class<N extends TransportName, T = DeepAsyncProxy<TransportDictionary[N]>> extends ProxyTransport<N, T> {\n    protected message: TransportMessage;\n\n    constructor(name: N) {\n        super(name);\n        this.message = new ServiceMessage(name);\n    }\n\n    protected manager(): TransportManager {\n        return ServiceManager.getInstance();\n    }\n\n    protected async apply(args: any[], path?: string): Promise<any> {\n        return this.message.send({path, args});\n    }\n\n    public get(): T {\n        if (isBackground()) {\n            throw new Error(\n                `You are trying to get proxy service \"${this.name}\" from background. You can get original service instead`\n            );\n        }\n\n        return super.get();\n    }\n}\n"],"mappings":"AAAA,SAAQ,oBAAmB;AAE3B,OAAO,oBAAoB;AAE3B,OAAO,oBAAoB;AAC3B,OAAO,oBAAoB;AAK3B,MAAO,6BAA2F,eAAqB;AAAA,EACzG;AAAA,EAEV,YAAY,MAAS;AACjB,UAAM,IAAI;AACV,SAAK,UAAU,IAAI,eAAe,IAAI;AAAA,EAC1C;AAAA,EAEU,UAA4B;AAClC,WAAO,eAAe,YAAY;AAAA,EACtC;AAAA,EAEA,MAAgB,MAAM,MAAa,MAA6B;AAC5D,WAAO,KAAK,QAAQ,KAAK,EAAC,MAAM,KAAI,CAAC;AAAA,EACzC;AAAA,EAEO,MAAS;AACZ,QAAI,aAAa,GAAG;AAChB,YAAM,IAAI;AAAA,QACN,wCAAwC,KAAK,IAAI;AAAA,MACrD;AAAA,IACJ;AAEA,WAAO,MAAM,IAAI;AAAA,EACrB;AACJ;","names":[]}
+{"version":3,"sources":["../../../src/service/providers/ProxyService.ts"],"sourcesContent":["import {isBackground} from \"@addon-core/browser\";\n\nimport ProxyTransport from \"@transport/ProxyTransport\";\n\nimport ServiceManager from \"../ServiceManager\";\nimport ServiceMessage from \"../ServiceMessage\";\n\nimport type {RpcAsyncProxy} from \"@typing/rpc\";\nimport type {TransportDictionary, TransportManager, TransportMessage, TransportName} from \"@typing/transport\";\n\nexport default class<N extends TransportName, T = RpcAsyncProxy<TransportDictionary[N]>> extends ProxyTransport<N, T> {\n    protected message: TransportMessage;\n\n    constructor(name: N) {\n        super(name);\n        this.message = new ServiceMessage(name);\n    }\n\n    protected manager(): TransportManager {\n        return ServiceManager.getInstance();\n    }\n\n    protected async apply(args: any[], path?: string): Promise<any> {\n        return this.message.send({path, args});\n    }\n\n    public get(): T {\n        if (isBackground()) {\n            throw new Error(\n                `You are trying to get proxy service \"${this.name}\" from background. You can get original service instead`\n            );\n        }\n\n        return super.get();\n    }\n}\n"],"mappings":"AAAA,SAAQ,oBAAmB;AAE3B,OAAO,oBAAoB;AAE3B,OAAO,oBAAoB;AAC3B,OAAO,oBAAoB;AAK3B,MAAO,6BAA0F,eAAqB;AAAA,EACxG;AAAA,EAEV,YAAY,MAAS;AACjB,UAAM,IAAI;AACV,SAAK,UAAU,IAAI,eAAe,IAAI;AAAA,EAC1C;AAAA,EAEU,UAA4B;AAClC,WAAO,eAAe,YAAY;AAAA,EACtC;AAAA,EAEA,MAAgB,MAAM,MAAa,MAA6B;AAC5D,WAAO,KAAK,QAAQ,KAAK,EAAC,MAAM,KAAI,CAAC;AAAA,EACzC;AAAA,EAEO,MAAS;AACZ,QAAI,aAAa,GAAG;AAChB,YAAM,IAAI;AAAA,QACN,wCAAwC,KAAK,IAAI;AAAA,MACrD;AAAA,IACJ;AAEA,WAAO,MAAM,IAAI;AAAA,EACrB;AACJ;","names":[]}

package/dist/transport/ProxyTransport.d.ts

@@ -1,7 +1,7 @@
 import BaseTransport from "./BaseTransport.js";
-import type { DeepAsyncProxy } from "../types/helpers.js";
+import type { RpcAsyncProxy } from "../types/rpc.js";
 import type { TransportDictionary, TransportName } from "../types/transport.js";
-export default abstract class<N extends TransportName, T = DeepAsyncProxy<TransportDictionary[N]>> extends BaseTransport<N, T> {
+export default abstract class<N extends TransportName, T = RpcAsyncProxy<TransportDictionary[N]>> extends BaseTransport<N, T> {
     protected abstract apply(args: any[], path?: string): any;
     protected createProxy(path?: string): T;
     get(): T;

package/dist/transport/ProxyTransport.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/transport/ProxyTransport.ts"],"sourcesContent":["import BaseTransport from \"./BaseTransport\";\n\nimport type {DeepAsyncProxy} from \"@typing/helpers\";\nimport type {TransportDictionary, TransportName} from \"@typing/transport\";\n\nexport default abstract class<\n    N extends TransportName,\n    T = DeepAsyncProxy<TransportDictionary[N]>,\n> extends BaseTransport<N, T> {\n    protected abstract apply(args: any[], path?: string): any;\n\n    protected createProxy(path?: string): T {\n        const wrapped = () => {};\n\n        const proxy = new Proxy(wrapped, {\n            apply: async (_target, _thisArg, args) => this.apply(args, path),\n\n            get: (_target, propertyName, receiver) => {\n                if (propertyName === \"__proxy\" || typeof propertyName !== \"string\") {\n                    return Reflect.get(wrapped, propertyName, receiver);\n                }\n\n                const newPath = path == null ? propertyName : `${path}.${String(propertyName)}`;\n\n                return this.createProxy(newPath);\n            },\n        });\n\n        // @ts-expect-error — Adding a hidden property\n        proxy.__proxy = true;\n\n        return proxy as unknown as T;\n    }\n\n    public get(): T {\n        return this.createProxy();\n    }\n}\n"],"mappings":"AAAA,OAAO,mBAAmB;AAK1B,MAAO,+BAGG,cAAoB;AAAA,EAGhB,YAAY,MAAkB;AACpC,UAAM,UAAU,MAAM;AAAA,IAAC;AAEvB,UAAM,QAAQ,IAAI,MAAM,SAAS;AAAA,MAC7B,OAAO,OAAO,SAAS,UAAU,SAAS,KAAK,MAAM,MAAM,IAAI;AAAA,MAE/D,KAAK,CAAC,SAAS,cAAc,aAAa;AACtC,YAAI,iBAAiB,aAAa,OAAO,iBAAiB,UAAU;AAChE,iBAAO,QAAQ,IAAI,SAAS,cAAc,QAAQ;AAAA,QACtD;AAEA,cAAM,UAAU,QAAQ,OAAO,eAAe,GAAG,IAAI,IAAI,OAAO,YAAY,CAAC;AAE7E,eAAO,KAAK,YAAY,OAAO;AAAA,MACnC;AAAA,IACJ,CAAC;AAGD,UAAM,UAAU;AAEhB,WAAO;AAAA,EACX;AAAA,EAEO,MAAS;AACZ,WAAO,KAAK,YAAY;AAAA,EAC5B;AACJ;","names":[]}
+{"version":3,"sources":["../../src/transport/ProxyTransport.ts"],"sourcesContent":["import BaseTransport from \"./BaseTransport\";\n\nimport type {RpcAsyncProxy} from \"@typing/rpc\";\nimport type {TransportDictionary, TransportName} from \"@typing/transport\";\n\nexport default abstract class<N extends TransportName, T = RpcAsyncProxy<TransportDictionary[N]>> extends BaseTransport<\n    N,\n    T\n> {\n    protected abstract apply(args: any[], path?: string): any;\n\n    protected createProxy(path?: string): T {\n        const wrapped = () => {};\n\n        const proxy = new Proxy(wrapped, {\n            apply: async (_target, _thisArg, args) => this.apply(args, path),\n\n            get: (_target, propertyName, receiver) => {\n                if (propertyName === \"__proxy\" || typeof propertyName !== \"string\") {\n                    return Reflect.get(wrapped, propertyName, receiver);\n                }\n\n                const newPath = path == null ? propertyName : `${path}.${String(propertyName)}`;\n\n                return this.createProxy(newPath);\n            },\n        });\n\n        // @ts-expect-error — Adding a hidden property\n        proxy.__proxy = true;\n\n        return proxy as unknown as T;\n    }\n\n    public get(): T {\n        return this.createProxy();\n    }\n}\n"],"mappings":"AAAA,OAAO,mBAAmB;AAK1B,MAAO,+BAAmG,cAGxG;AAAA,EAGY,YAAY,MAAkB;AACpC,UAAM,UAAU,MAAM;AAAA,IAAC;AAEvB,UAAM,QAAQ,IAAI,MAAM,SAAS;AAAA,MAC7B,OAAO,OAAO,SAAS,UAAU,SAAS,KAAK,MAAM,MAAM,IAAI;AAAA,MAE/D,KAAK,CAAC,SAAS,cAAc,aAAa;AACtC,YAAI,iBAAiB,aAAa,OAAO,iBAAiB,UAAU;AAChE,iBAAO,QAAQ,IAAI,SAAS,cAAc,QAAQ;AAAA,QACtD;AAEA,cAAM,UAAU,QAAQ,OAAO,eAAe,GAAG,IAAI,IAAI,OAAO,YAAY,CAAC;AAE7E,eAAO,KAAK,YAAY,OAAO;AAAA,MACnC;AAAA,IACJ,CAAC;AAGD,UAAM,UAAU;AAEhB,WAAO;AAAA,EACX;AAAA,EAEO,MAAS;AACZ,WAAO,KAAK,YAAY;AAAA,EAC5B;AACJ;","names":[]}

package/dist/transport/index.d.ts

@@ -1,4 +1,5 @@
-import type { DeepAsyncProxy } from "../types/helpers.js";
+import type { RpcAsyncProxy } from "../types/rpc.js";
+export type { RpcAsyncProxy, RpcAsyncProxyObject } from "../types/rpc.js";
 export type TransportTarget<T extends object, K extends keyof T> = T[K];
-export type TransportProxyTarget<T extends object, K extends keyof T> = DeepAsyncProxy<T[K]>;
+export type TransportProxyTarget<T extends object, K extends keyof T> = RpcAsyncProxy<T[K]>;
 export type { TransportDefinition, TransportResolvedDefinition, TransportUnresolvedDefinition, TransportType, TransportOptions, } from "../types/transport.js";

package/dist/types/helpers.d.ts

@@ -6,8 +6,4 @@ export type PickNonFunctionProperties<T> = {
 export type ExcludeFunctionsFromProperties<T> = {
     [K in keyof T]: ExcludeFunction<T[K]>;
 };
-export type DeepAsyncProxy<T> = {
-    [K in keyof T]: T[K] extends (...args: any[]) => any ? (...args: Parameters<T[K]>) => Promise<Awaited<ReturnType<T[K]>>> : T[K] extends object ? DeepAsyncProxyObject<T[K]> : () => Promise<Awaited<T[K]>>;
-};
-export type DeepAsyncProxyObject<T> = (() => Promise<DeepAsyncProxy<T>>) & DeepAsyncProxy<T>;
 export {};

package/dist/types/locale.d.ts

@@ -66,6 +66,8 @@ export declare const LocaleValuesSeparator = "|";
 export declare const LocaleCustomKeyForLanguage = "locale";
 export declare const LocaleKeyMarker = "@";
 export declare const LanguageCodes: ReadonlySet<string>;
+/** Native language names, independent of the selected UI language. */
+export declare const LanguageNames: Readonly<Record<Language, string>>;
 export declare const LocaleFileExtensions: ReadonlySet<string>;
 export type LocaleValue = string | number | Array<string | number>;
 export type LocaleData = {
@@ -123,6 +125,7 @@ export type LocaleSubstitutionArgs<T, K extends keyof T> = string extends keyof
 export interface LocaleProvider<S> {
     lang(): Language;
     languages(): Set<Language>;
+    languageNames(): Map<Language, string>;
     keys(): ReadonlySet<keyof S>;
     trans<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;
     choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;

package/dist/types/locale.js

@@ -68,10 +68,68 @@ const LocaleValuesSeparator = "|";
 const LocaleCustomKeyForLanguage = "locale";
 const LocaleKeyMarker = "@";
 const LanguageCodes = new Set(Object.values(Language));
+const LanguageNames = Object.freeze({
+  ["ar" /* Arabic */]: "\u0627\u0644\u0639\u0631\u0628\u064A\u0629",
+  ["am" /* Amharic */]: "\u12A0\u121B\u122D\u129B",
+  ["bg" /* Bulgarian */]: "\u0411\u044A\u043B\u0433\u0430\u0440\u0441\u043A\u0438",
+  ["bn" /* Bengali */]: "\u09AC\u09BE\u0982\u09B2\u09BE",
+  ["ca" /* Catalan */]: "Catal\xE0",
+  ["cs" /* Czech */]: "\u010Ce\u0161tina",
+  ["da" /* Danish */]: "Dansk",
+  ["de" /* German */]: "Deutsch",
+  ["el" /* Greek */]: "\u0395\u03BB\u03BB\u03B7\u03BD\u03B9\u03BA\u03AC",
+  ["en" /* English */]: "English",
+  ["en_AU" /* EnglishAustralia */]: "English (Australia)",
+  ["en_GB" /* EnglishGreatBritain */]: "English (United Kingdom)",
+  ["en_US" /* EnglishUSA */]: "English (United States)",
+  ["es" /* Spanish */]: "Espa\xF1ol",
+  ["es_419" /* SpanishLatinAmericaAndCaribbean */]: "Espa\xF1ol (Latinoam\xE9rica y el Caribe)",
+  ["et" /* Estonian */]: "Eesti",
+  ["fa" /* Persian */]: "\u0641\u0627\u0631\u0633\u06CC",
+  ["fi" /* Finnish */]: "Suomi",
+  ["fil" /* Filipino */]: "Filipino",
+  ["fr" /* French */]: "Fran\xE7ais",
+  ["gu" /* Gujarati */]: "\u0A97\u0AC1\u0A9C\u0AB0\u0ABE\u0AA4\u0AC0",
+  ["he" /* Hebrew */]: "\u05E2\u05D1\u05E8\u05D9\u05EA",
+  ["hi" /* Hindi */]: "\u0939\u093F\u0928\u094D\u0926\u0940",
+  ["hr" /* Croatian */]: "Hrvatski",
+  ["hu" /* Hungarian */]: "Magyar",
+  ["id" /* Indonesian */]: "Bahasa Indonesia",
+  ["it" /* Italian */]: "Italiano",
+  ["ja" /* Japanese */]: "\u65E5\u672C\u8A9E",
+  ["kn" /* Kannada */]: "\u0C95\u0CA8\u0CCD\u0CA8\u0CA1",
+  ["ko" /* Korean */]: "\uD55C\uAD6D\uC5B4",
+  ["lt" /* Lithuanian */]: "Lietuvi\u0173",
+  ["lv" /* Latvian */]: "Latvie\u0161u",
+  ["ml" /* Malayalam */]: "\u0D2E\u0D32\u0D2F\u0D3E\u0D33\u0D02",
+  ["mr" /* Marathi */]: "\u092E\u0930\u093E\u0920\u0940",
+  ["ms" /* Malay */]: "Bahasa Melayu",
+  ["nl" /* Dutch */]: "Nederlands",
+  ["no" /* Norwegian */]: "Norsk",
+  ["pl" /* Polish */]: "Polski",
+  ["pt_BR" /* PortugueseBrazil */]: "Portugu\xEAs (Brasil)",
+  ["pt_PT" /* PortuguesePortugal */]: "Portugu\xEAs (Portugal)",
+  ["ro" /* Romanian */]: "Rom\xE2n\u0103",
+  ["ru" /* Russian */]: "\u0420\u0443\u0441\u0441\u043A\u0438\u0439",
+  ["sk" /* Slovak */]: "Sloven\u010Dina",
+  ["sl" /* Slovenian */]: "Sloven\u0161\u010Dina",
+  ["sr" /* Serbian */]: "\u0421\u0440\u043F\u0441\u043A\u0438",
+  ["sv" /* Swedish */]: "Svenska",
+  ["sw" /* Swahili */]: "Kiswahili",
+  ["ta" /* Tamil */]: "\u0BA4\u0BAE\u0BBF\u0BB4\u0BCD",
+  ["te" /* Telugu */]: "\u0C24\u0C46\u0C32\u0C41\u0C17\u0C41",
+  ["th" /* Thai */]: "\u0E44\u0E17\u0E22",
+  ["tr" /* Turkish */]: "T\xFCrk\xE7e",
+  ["uk" /* Ukrainian */]: "\u0423\u043A\u0440\u0430\u0457\u043D\u0441\u044C\u043A\u0430",
+  ["vi" /* Vietnamese */]: "Ti\u1EBFng Vi\u1EC7t",
+  ["zh_CN" /* ChineseChina */]: "\u4E2D\u6587\uFF08\u7B80\u4F53\uFF09",
+  ["zh_TW" /* ChineseTaiwan */]: "\u4E2D\u6587\uFF08\u7E41\u9AD4\uFF09"
+});
 const LocaleFileExtensions = /* @__PURE__ */ new Set(["yaml", "yml", "json"]);
 export {
   Language,
   LanguageCodes,
+  LanguageNames,
   LocaleCustomKeyForLanguage,
   LocaleDir,
   LocaleFileExtensions,

package/dist/types/locale.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/locale.ts"],"sourcesContent":["export enum Language {\n    Arabic = \"ar\",\n    Amharic = \"am\",\n    Bulgarian = \"bg\",\n    Bengali = \"bn\",\n    Catalan = \"ca\",\n    Czech = \"cs\",\n    Danish = \"da\",\n    German = \"de\",\n    Greek = \"el\",\n    English = \"en\",\n    EnglishAustralia = \"en_AU\",\n    EnglishGreatBritain = \"en_GB\",\n    EnglishUSA = \"en_US\",\n    Spanish = \"es\",\n    SpanishLatinAmericaAndCaribbean = \"es_419\",\n    Estonian = \"et\",\n    Persian = \"fa\",\n    Finnish = \"fi\",\n    Filipino = \"fil\",\n    French = \"fr\",\n    Gujarati = \"gu\",\n    Hebrew = \"he\",\n    Hindi = \"hi\",\n    Croatian = \"hr\",\n    Hungarian = \"hu\",\n    Indonesian = \"id\",\n    Italian = \"it\",\n    Japanese = \"ja\",\n    Kannada = \"kn\",\n    Korean = \"ko\",\n    Lithuanian = \"lt\",\n    Latvian = \"lv\",\n    Malayalam = \"ml\",\n    Marathi = \"mr\",\n    Malay = \"ms\",\n    Dutch = \"nl\",\n    Norwegian = \"no\",\n    Polish = \"pl\",\n    PortugueseBrazil = \"pt_BR\",\n    PortuguesePortugal = \"pt_PT\",\n    Romanian = \"ro\",\n    Russian = \"ru\",\n    Slovak = \"sk\",\n    Slovenian = \"sl\",\n    Serbian = \"sr\",\n    Swedish = \"sv\",\n    Swahili = \"sw\",\n    Tamil = \"ta\",\n    Telugu = \"te\",\n    Thai = \"th\",\n    Turkish = \"tr\",\n    Ukrainian = \"uk\",\n    Vietnamese = \"vi\",\n    ChineseChina = \"zh_CN\",\n    ChineseTaiwan = \"zh_TW\",\n}\n\nexport enum LocaleDir {\n    RightToLeft = \"rtl\",\n    LeftToRight = \"ltr\",\n}\n\nexport const RtlLanguages: ReadonlySet<Language> = new Set([Language.Arabic, Language.Persian, Language.Hebrew]);\n\nexport const LocaleNestedKeysSeparator = \".\";\n\nexport const LocaleKeysSeparator = \"_\";\n\nexport const LocaleValuesSeparator = \"|\";\n\nexport const LocaleCustomKeyForLanguage = \"locale\";\n\nexport const LocaleKeyMarker = \"@\";\n\nexport const LanguageCodes: ReadonlySet<string> = new Set(Object.values(Language));\n\nexport const LocaleFileExtensions: ReadonlySet<string> = new Set([\"yaml\", \"yml\", \"json\"]);\n\nexport type LocaleValue = string | number | Array<string | number>;\n\nexport type LocaleData = {\n    [key: string]: LocaleValue | LocaleData;\n};\n\nexport type LocaleItems = Map<string, string>;\n\nexport type LocaleKeys = ReadonlySet<string>;\n\nexport type LocaleMessages = {\n    [key: string]: {\n        message: string;\n    };\n};\n\nexport interface LocaleBuilder {\n    lang(): Language;\n\n    merge(data: LocaleData): this;\n\n    build(): LocaleMessages;\n\n    get(): LocaleItems;\n\n    keys(): LocaleKeys;\n\n    structure(): LocaleStructure;\n\n    isValid(): boolean;\n\n    validate(): this;\n}\n\nexport type LocaleBuilders = Map<Language, LocaleBuilder>;\n\nexport interface LocaleValidator {\n    isValid(locale: LocaleBuilder): boolean;\n\n    validate(locale: LocaleBuilder): this;\n}\n\nexport interface LocaleContractValidator {\n    isValid(builders: LocaleBuilders): boolean;\n\n    validate(builders: LocaleBuilders): this;\n}\n\nexport interface LocaleFutures {\n    plural: boolean;\n    substitutions: readonly string[];\n}\n\nexport interface LocaleStructure {\n    [key: string]: LocaleFutures;\n}\n\nexport type LocaleNonPluralKeys<T> = {\n    [K in keyof T]: T[K] extends {plural: false} ? K : never;\n}[keyof T] &\n    string;\n\nexport type LocalePluralKeys<T> = {\n    [K in keyof T]: T[K] extends {plural: true} ? K : never;\n}[keyof T] &\n    string;\n\nexport type LocaleSubstitutionValue = string | number;\n\nexport type LocaleSubstitutionKeys<T, K extends keyof T> = T[K] extends {substitutions: readonly (infer U)[]}\n    ? U & string\n    : never;\n\nexport type LocaleSubstitutionsFor<T, K extends keyof T> = [LocaleSubstitutionKeys<T, K>] extends [never]\n    ? never\n    : Record<LocaleSubstitutionKeys<T, K>, LocaleSubstitutionValue>;\n\nexport type LocaleSubstitutionArgs<T, K extends keyof T> = string extends keyof T\n    ? [substitutions?: Record<string, LocaleSubstitutionValue>]\n    : [LocaleSubstitutionKeys<T, K>] extends [never]\n      ? []\n      : [substitutions: LocaleSubstitutionsFor<T, K>];\n\nexport interface LocaleProvider<S> {\n    lang(): Language;\n\n    languages(): Set<Language>;\n\n    keys(): ReadonlySet<keyof S>;\n\n    // non-plural keys\n    trans<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;\n\n    // plural keys\n    choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;\n}\n\nexport interface LocaleDynamicProvider<S> extends LocaleProvider<S> {\n    change(lang: Language): Promise<Language>;\n}\n"],"mappings":"AAAO,IAAK,WAAL,kBAAKA,cAAL;AACH,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,sBAAmB;AACnB,EAAAA,UAAA,yBAAsB;AACtB,EAAAA,UAAA,gBAAa;AACb,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,qCAAkC;AAClC,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,gBAAa;AACb,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,gBAAa;AACb,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,sBAAmB;AACnB,EAAAA,UAAA,wBAAqB;AACrB,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,UAAO;AACP,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,gBAAa;AACb,EAAAA,UAAA,kBAAe;AACf,EAAAA,UAAA,mBAAgB;AAvDR,SAAAA;AAAA,GAAA;AA0DL,IAAK,YAAL,kBAAKC,eAAL;AACH,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,iBAAc;AAFN,SAAAA;AAAA,GAAA;AAKL,MAAM,eAAsC,oBAAI,IAAI,CAAC,mBAAiB,oBAAkB,iBAAe,CAAC;AAExG,MAAM,4BAA4B;AAElC,MAAM,sBAAsB;AAE5B,MAAM,wBAAwB;AAE9B,MAAM,6BAA6B;AAEnC,MAAM,kBAAkB;AAExB,MAAM,gBAAqC,IAAI,IAAI,OAAO,OAAO,QAAQ,CAAC;AAE1E,MAAM,uBAA4C,oBAAI,IAAI,CAAC,QAAQ,OAAO,MAAM,CAAC;","names":["Language","LocaleDir"]}
+{"version":3,"sources":["../../src/types/locale.ts"],"sourcesContent":["export enum Language {\n    Arabic = \"ar\",\n    Amharic = \"am\",\n    Bulgarian = \"bg\",\n    Bengali = \"bn\",\n    Catalan = \"ca\",\n    Czech = \"cs\",\n    Danish = \"da\",\n    German = \"de\",\n    Greek = \"el\",\n    English = \"en\",\n    EnglishAustralia = \"en_AU\",\n    EnglishGreatBritain = \"en_GB\",\n    EnglishUSA = \"en_US\",\n    Spanish = \"es\",\n    SpanishLatinAmericaAndCaribbean = \"es_419\",\n    Estonian = \"et\",\n    Persian = \"fa\",\n    Finnish = \"fi\",\n    Filipino = \"fil\",\n    French = \"fr\",\n    Gujarati = \"gu\",\n    Hebrew = \"he\",\n    Hindi = \"hi\",\n    Croatian = \"hr\",\n    Hungarian = \"hu\",\n    Indonesian = \"id\",\n    Italian = \"it\",\n    Japanese = \"ja\",\n    Kannada = \"kn\",\n    Korean = \"ko\",\n    Lithuanian = \"lt\",\n    Latvian = \"lv\",\n    Malayalam = \"ml\",\n    Marathi = \"mr\",\n    Malay = \"ms\",\n    Dutch = \"nl\",\n    Norwegian = \"no\",\n    Polish = \"pl\",\n    PortugueseBrazil = \"pt_BR\",\n    PortuguesePortugal = \"pt_PT\",\n    Romanian = \"ro\",\n    Russian = \"ru\",\n    Slovak = \"sk\",\n    Slovenian = \"sl\",\n    Serbian = \"sr\",\n    Swedish = \"sv\",\n    Swahili = \"sw\",\n    Tamil = \"ta\",\n    Telugu = \"te\",\n    Thai = \"th\",\n    Turkish = \"tr\",\n    Ukrainian = \"uk\",\n    Vietnamese = \"vi\",\n    ChineseChina = \"zh_CN\",\n    ChineseTaiwan = \"zh_TW\",\n}\n\nexport enum LocaleDir {\n    RightToLeft = \"rtl\",\n    LeftToRight = \"ltr\",\n}\n\nexport const RtlLanguages: ReadonlySet<Language> = new Set([Language.Arabic, Language.Persian, Language.Hebrew]);\n\nexport const LocaleNestedKeysSeparator = \".\";\n\nexport const LocaleKeysSeparator = \"_\";\n\nexport const LocaleValuesSeparator = \"|\";\n\nexport const LocaleCustomKeyForLanguage = \"locale\";\n\nexport const LocaleKeyMarker = \"@\";\n\nexport const LanguageCodes: ReadonlySet<string> = new Set(Object.values(Language));\n\n/** Native language names, independent of the selected UI language. */\nexport const LanguageNames: Readonly<Record<Language, string>> = Object.freeze({\n    [Language.Arabic]: \"العربية\",\n    [Language.Amharic]: \"አማርኛ\",\n    [Language.Bulgarian]: \"Български\",\n    [Language.Bengali]: \"বাংলা\",\n    [Language.Catalan]: \"Català\",\n    [Language.Czech]: \"Čeština\",\n    [Language.Danish]: \"Dansk\",\n    [Language.German]: \"Deutsch\",\n    [Language.Greek]: \"Ελληνικά\",\n    [Language.English]: \"English\",\n    [Language.EnglishAustralia]: \"English (Australia)\",\n    [Language.EnglishGreatBritain]: \"English (United Kingdom)\",\n    [Language.EnglishUSA]: \"English (United States)\",\n    [Language.Spanish]: \"Español\",\n    [Language.SpanishLatinAmericaAndCaribbean]: \"Español (Latinoamérica y el Caribe)\",\n    [Language.Estonian]: \"Eesti\",\n    [Language.Persian]: \"فارسی\",\n    [Language.Finnish]: \"Suomi\",\n    [Language.Filipino]: \"Filipino\",\n    [Language.French]: \"Français\",\n    [Language.Gujarati]: \"ગુજરાતી\",\n    [Language.Hebrew]: \"עברית\",\n    [Language.Hindi]: \"हिन्दी\",\n    [Language.Croatian]: \"Hrvatski\",\n    [Language.Hungarian]: \"Magyar\",\n    [Language.Indonesian]: \"Bahasa Indonesia\",\n    [Language.Italian]: \"Italiano\",\n    [Language.Japanese]: \"日本語\",\n    [Language.Kannada]: \"ಕನ್ನಡ\",\n    [Language.Korean]: \"한국어\",\n    [Language.Lithuanian]: \"Lietuvių\",\n    [Language.Latvian]: \"Latviešu\",\n    [Language.Malayalam]: \"മലയാളം\",\n    [Language.Marathi]: \"मराठी\",\n    [Language.Malay]: \"Bahasa Melayu\",\n    [Language.Dutch]: \"Nederlands\",\n    [Language.Norwegian]: \"Norsk\",\n    [Language.Polish]: \"Polski\",\n    [Language.PortugueseBrazil]: \"Português (Brasil)\",\n    [Language.PortuguesePortugal]: \"Português (Portugal)\",\n    [Language.Romanian]: \"Română\",\n    [Language.Russian]: \"Русский\",\n    [Language.Slovak]: \"Slovenčina\",\n    [Language.Slovenian]: \"Slovenščina\",\n    [Language.Serbian]: \"Српски\",\n    [Language.Swedish]: \"Svenska\",\n    [Language.Swahili]: \"Kiswahili\",\n    [Language.Tamil]: \"தமிழ்\",\n    [Language.Telugu]: \"తెలుగు\",\n    [Language.Thai]: \"ไทย\",\n    [Language.Turkish]: \"Türkçe\",\n    [Language.Ukrainian]: \"Українська\",\n    [Language.Vietnamese]: \"Tiếng Việt\",\n    [Language.ChineseChina]: \"中文（简体）\",\n    [Language.ChineseTaiwan]: \"中文（繁體）\",\n});\n\nexport const LocaleFileExtensions: ReadonlySet<string> = new Set([\"yaml\", \"yml\", \"json\"]);\n\nexport type LocaleValue = string | number | Array<string | number>;\n\nexport type LocaleData = {\n    [key: string]: LocaleValue | LocaleData;\n};\n\nexport type LocaleItems = Map<string, string>;\n\nexport type LocaleKeys = ReadonlySet<string>;\n\nexport type LocaleMessages = {\n    [key: string]: {\n        message: string;\n    };\n};\n\nexport interface LocaleBuilder {\n    lang(): Language;\n\n    merge(data: LocaleData): this;\n\n    build(): LocaleMessages;\n\n    get(): LocaleItems;\n\n    keys(): LocaleKeys;\n\n    structure(): LocaleStructure;\n\n    isValid(): boolean;\n\n    validate(): this;\n}\n\nexport type LocaleBuilders = Map<Language, LocaleBuilder>;\n\nexport interface LocaleValidator {\n    isValid(locale: LocaleBuilder): boolean;\n\n    validate(locale: LocaleBuilder): this;\n}\n\nexport interface LocaleContractValidator {\n    isValid(builders: LocaleBuilders): boolean;\n\n    validate(builders: LocaleBuilders): this;\n}\n\nexport interface LocaleFutures {\n    plural: boolean;\n    substitutions: readonly string[];\n}\n\nexport interface LocaleStructure {\n    [key: string]: LocaleFutures;\n}\n\nexport type LocaleNonPluralKeys<T> = {\n    [K in keyof T]: T[K] extends {plural: false} ? K : never;\n}[keyof T] &\n    string;\n\nexport type LocalePluralKeys<T> = {\n    [K in keyof T]: T[K] extends {plural: true} ? K : never;\n}[keyof T] &\n    string;\n\nexport type LocaleSubstitutionValue = string | number;\n\nexport type LocaleSubstitutionKeys<T, K extends keyof T> = T[K] extends {substitutions: readonly (infer U)[]}\n    ? U & string\n    : never;\n\nexport type LocaleSubstitutionsFor<T, K extends keyof T> = [LocaleSubstitutionKeys<T, K>] extends [never]\n    ? never\n    : Record<LocaleSubstitutionKeys<T, K>, LocaleSubstitutionValue>;\n\nexport type LocaleSubstitutionArgs<T, K extends keyof T> = string extends keyof T\n    ? [substitutions?: Record<string, LocaleSubstitutionValue>]\n    : [LocaleSubstitutionKeys<T, K>] extends [never]\n      ? []\n      : [substitutions: LocaleSubstitutionsFor<T, K>];\n\nexport interface LocaleProvider<S> {\n    lang(): Language;\n\n    languages(): Set<Language>;\n\n    languageNames(): Map<Language, string>;\n\n    keys(): ReadonlySet<keyof S>;\n\n    // non-plural keys\n    trans<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;\n\n    // plural keys\n    choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;\n}\n\nexport interface LocaleDynamicProvider<S> extends LocaleProvider<S> {\n    change(lang: Language): Promise<Language>;\n}\n"],"mappings":"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","names":["Language","LocaleDir"]}