adnbn 0.7.1 → 0.9.0

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/config.d.ts

@@ -421,6 +421,14 @@ export interface Config {
      * Flag indicating whether to merge localizations from App and Shared directories.
      * When `true`, localization files from both directories will be combined.
      *
+     * Locale values are resolved from the least specific source to the most specific:
+     * plugins, source root, Shared, and App. Within each layer, a browser-specific
+     * file overrides its generic file. A value from a later source overrides the
+     * same key from an earlier source. When `false`, plugin locales remain available
+     * as a baseline and only the highest available workspace layer is selected.
+     * Multiple generic or browser-specific files for the same language in one layer
+     * are rejected as ambiguous.
+     *
      * @default true
      */
     mergeLocales: boolean;

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"]}

package/dist/types/relay.d.ts

@@ -1,20 +1,147 @@
 import { EntrypointOptions } from "./entrypoint.js";
 import { ContentScriptConfig, ContentScriptContext, ContentScriptDefinition } from "./content.js";
-import { TransportConfig, TransportDefinition, TransportType } from "./transport.js";
+import { TransportConfig, TransportDefinition, TransportType, type TransportProxyTarget } from "./transport.js";
 import { Awaiter } from "./helpers.js";
+import type { MessageError } from "./message.js";
+import type { RelayRegistry } from "../relay/index.js";
 export declare const RelayGlobalKey = "adnbnRelay";
 export declare enum RelayMethod {
     Scripting = "scripting",
     Messaging = "messaging"
 }
-export interface RelayConfig extends TransportConfig, ContentScriptConfig {
+export declare enum RelayAllFrames {
+    /**
+     * Executes the method in every frame reached by the selected transport and returns one outcome:
+     * Scripting prefers a fulfilled result, while Messaging returns the first response.
+     *
+     * Warning: mutating methods can execute in multiple frames even though only one outcome is returned.
+     */
+    Any = "any",
+    /** Executes the method in every discovered frame and returns an outcome for each frame. */
+    All = "all"
+}
+export declare enum RelayFrameErrorKind {
+    Remote = "remote",
+    Execution = "execution",
+    Delivery = "delivery",
+    Timeout = "timeout",
+    TargetGone = "target-gone",
+    Unobservable = "unobservable"
+}
+export type RelayNonEmptyReadonlyArray<T> = readonly [T, ...T[]];
+export interface RelayExecutionOptions {
+    /** Maximum execution time per addressed Messaging frame or for the Inject Script operation. */
+    timeoutMs?: number;
+}
+interface RelayTargetBase extends RelayExecutionOptions {
+    tabId: number;
+}
+export interface RelayTopFrameOptions extends RelayTargetBase {
+    allFrames?: false;
+    frameId?: never;
+    frameIds?: never;
+    documentId?: never;
+    documentIds?: never;
+}
+export interface RelayFrameOptions extends RelayTargetBase {
+    frameId: number;
+    allFrames?: never;
+    frameIds?: never;
+    documentId?: never;
+    documentIds?: never;
+}
+export interface RelayFramesOptions extends RelayTargetBase {
+    frameIds: RelayNonEmptyReadonlyArray<number>;
+    allFrames?: never;
+    frameId?: never;
+    documentId?: never;
+    documentIds?: never;
+}
+export interface RelayDocumentOptions extends RelayTargetBase {
+    documentId: string;
+    allFrames?: never;
+    frameId?: never;
+    frameIds?: never;
+    documentIds?: never;
+}
+export interface RelayDocumentsOptions extends RelayTargetBase {
+    documentIds: RelayNonEmptyReadonlyArray<string>;
+    allFrames?: never;
+    frameId?: never;
+    frameIds?: never;
+    documentId?: never;
+}
+/**
+ * Broadcasts the call to all frames without requiring an exhaustive frame list and returns one outcome.
+ * `true` is an alias for `RelayAllFrames.Any`.
+ *
+ * Warning: mutating methods can execute in multiple frames even though only one outcome is returned.
+ */
+export interface RelayAnyFramesOptions extends RelayTargetBase {
+    allFrames: true | RelayAllFrames.Any;
+    frameId?: never;
+    frameIds?: never;
+    documentId?: never;
+    documentIds?: never;
+}
+export interface RelayEveryFrameOptions extends RelayTargetBase {
+    allFrames: RelayAllFrames.All;
+    frameId?: never;
+    frameIds?: never;
+    documentId?: never;
+    documentIds?: never;
+}
+export type RelayAllFramesOptions = RelayAnyFramesOptions | RelayEveryFrameOptions;
+export type RelayScalarOptions = RelayTopFrameOptions | RelayFrameOptions | RelayDocumentOptions;
+export type RelayBatchOptions = RelayFramesOptions | RelayDocumentsOptions | RelayAllFramesOptions;
+export type RelayCallOptions = RelayScalarOptions | RelayBatchOptions;
+export type RelayAddressTarget = {
+    tabId: number;
+    frameId: number;
+    documentId?: string;
+    allFrames?: never;
+} | {
+    tabId: number;
+    frameId?: never;
+    documentId: string;
+    allFrames?: never;
+};
+export type RelayOperationTarget = {
+    tabId: number;
+    allFrames: RelayAllFrames;
+    frameId?: never;
+    documentId?: never;
+};
+export type RelayResultTarget = RelayAddressTarget | RelayOperationTarget;
+export interface RelayFrameError extends MessageError {
+    kind: RelayFrameErrorKind;
+}
+export type RelayFrameResult<T> = {
+    target: RelayResultTarget;
+    status: "fulfilled";
+    result: T;
+} | {
+    target: RelayResultTarget;
+    status: "rejected";
+    error: RelayFrameError;
+};
+export type RelayFramesResult<T> = readonly RelayFrameResult<T>[];
+export type RelayBatchRpcProxy<T> = {
+    [K in keyof T]: T[K] extends (...args: any[]) => any ? (...args: Parameters<T[K]>) => Promise<RelayFramesResult<Awaited<ReturnType<T[K]>>>> : T[K] extends object ? RelayBatchRpcProxyObject<T[K]> : () => Promise<RelayFramesResult<Awaited<T[K]>>>;
+};
+export type RelayBatchRpcProxyObject<T> = (() => Promise<RelayFramesResult<Awaited<T>>>) & RelayBatchRpcProxy<T>;
+export type RelayProxyTarget<N extends keyof RelayRegistry> = TransportProxyTarget<RelayRegistry, N>;
+export type RelayBatchProxyTarget<N extends keyof RelayRegistry> = RelayBatchRpcProxy<RelayRegistry[N]>;
+export interface RelayConfig extends TransportConfig, Omit<ContentScriptConfig, "allFrames"> {
+    allFrames?: boolean | RelayAllFrames;
     method?: RelayMethod;
 }
 export type RelayOptions = RelayConfig & EntrypointOptions;
 export type RelayOptionsMap = Map<string, RelayOptions>;
 export type RelayEntrypointOptions = Partial<RelayOptions>;
 export type RelayMainHandler<T extends TransportType> = (relay: T, context: ContentScriptContext, options: RelayEntrypointOptions) => Awaiter<void>;
-export interface RelayDefinition<T extends TransportType> extends Omit<TransportDefinition<RelayOptions, T>, "main">, Omit<ContentScriptDefinition, "main">, RelayEntrypointOptions {
+export interface RelayDefinition<T extends TransportType> extends Omit<TransportDefinition<RelayOptions, T>, "main">, Omit<ContentScriptDefinition, "main" | "allFrames">, RelayEntrypointOptions {
     main?: RelayMainHandler<T>;
 }
 export type RelayUnresolvedDefinition<T extends TransportType> = Partial<RelayDefinition<T>>;
+export {};

package/dist/types/relay.js

@@ -4,7 +4,23 @@ var RelayMethod = /* @__PURE__ */ ((RelayMethod2) => {
   RelayMethod2["Messaging"] = "messaging";
   return RelayMethod2;
 })(RelayMethod || {});
+var RelayAllFrames = /* @__PURE__ */ ((RelayAllFrames2) => {
+  RelayAllFrames2["Any"] = "any";
+  RelayAllFrames2["All"] = "all";
+  return RelayAllFrames2;
+})(RelayAllFrames || {});
+var RelayFrameErrorKind = /* @__PURE__ */ ((RelayFrameErrorKind2) => {
+  RelayFrameErrorKind2["Remote"] = "remote";
+  RelayFrameErrorKind2["Execution"] = "execution";
+  RelayFrameErrorKind2["Delivery"] = "delivery";
+  RelayFrameErrorKind2["Timeout"] = "timeout";
+  RelayFrameErrorKind2["TargetGone"] = "target-gone";
+  RelayFrameErrorKind2["Unobservable"] = "unobservable";
+  return RelayFrameErrorKind2;
+})(RelayFrameErrorKind || {});
 export {
+  RelayAllFrames,
+  RelayFrameErrorKind,
   RelayGlobalKey,
   RelayMethod
 };

package/dist/types/relay.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/relay.ts"],"sourcesContent":["import {EntrypointOptions} from \"@typing/entrypoint\";\nimport {ContentScriptConfig, ContentScriptContext, ContentScriptDefinition} from \"@typing/content\";\nimport {TransportConfig, TransportDefinition, TransportType} from \"@typing/transport\";\nimport {Awaiter} from \"@typing/helpers\";\n\nexport const RelayGlobalKey = \"adnbnRelay\";\n\nexport enum RelayMethod {\n    Scripting = \"scripting\",\n    Messaging = \"messaging\",\n}\n\nexport interface RelayConfig extends TransportConfig, ContentScriptConfig {\n    method?: RelayMethod;\n}\n\nexport type RelayOptions = RelayConfig & EntrypointOptions;\n\nexport type RelayOptionsMap = Map<string, RelayOptions>;\n\nexport type RelayEntrypointOptions = Partial<RelayOptions>;\n\nexport type RelayMainHandler<T extends TransportType> = (\n    relay: T,\n    context: ContentScriptContext,\n    options: RelayEntrypointOptions\n) => Awaiter<void>;\n\nexport interface RelayDefinition<T extends TransportType>\n    extends\n        Omit<TransportDefinition<RelayOptions, T>, \"main\">,\n        Omit<ContentScriptDefinition, \"main\">,\n        RelayEntrypointOptions {\n    main?: RelayMainHandler<T>;\n}\n\nexport type RelayUnresolvedDefinition<T extends TransportType> = Partial<RelayDefinition<T>>;\n"],"mappings":"AAKO,MAAM,iBAAiB;AAEvB,IAAK,cAAL,kBAAKA,iBAAL;AACH,EAAAA,aAAA,eAAY;AACZ,EAAAA,aAAA,eAAY;AAFJ,SAAAA;AAAA,GAAA;","names":["RelayMethod"]}
+{"version":3,"sources":["../../src/types/relay.ts"],"sourcesContent":["import {EntrypointOptions} from \"@typing/entrypoint\";\nimport {ContentScriptConfig, ContentScriptContext, ContentScriptDefinition} from \"@typing/content\";\nimport {TransportConfig, TransportDefinition, TransportType, type TransportProxyTarget} from \"@typing/transport\";\nimport {Awaiter} from \"@typing/helpers\";\nimport type {MessageError} from \"@typing/message\";\nimport type {RelayRegistry} from \"@relay/index\";\n\nexport const RelayGlobalKey = \"adnbnRelay\";\n\nexport enum RelayMethod {\n    Scripting = \"scripting\",\n    Messaging = \"messaging\",\n}\n\nexport enum RelayAllFrames {\n    /**\n     * Executes the method in every frame reached by the selected transport and returns one outcome:\n     * Scripting prefers a fulfilled result, while Messaging returns the first response.\n     *\n     * Warning: mutating methods can execute in multiple frames even though only one outcome is returned.\n     */\n    Any = \"any\",\n\n    /** Executes the method in every discovered frame and returns an outcome for each frame. */\n    All = \"all\",\n}\n\nexport enum RelayFrameErrorKind {\n    Remote = \"remote\",\n    Execution = \"execution\",\n    Delivery = \"delivery\",\n    Timeout = \"timeout\",\n    TargetGone = \"target-gone\",\n    Unobservable = \"unobservable\",\n}\n\nexport type RelayNonEmptyReadonlyArray<T> = readonly [T, ...T[]];\n\nexport interface RelayExecutionOptions {\n    /** Maximum execution time per addressed Messaging frame or for the Inject Script operation. */\n    timeoutMs?: number;\n}\n\ninterface RelayTargetBase extends RelayExecutionOptions {\n    tabId: number;\n}\n\nexport interface RelayTopFrameOptions extends RelayTargetBase {\n    allFrames?: false;\n    frameId?: never;\n    frameIds?: never;\n    documentId?: never;\n    documentIds?: never;\n}\n\nexport interface RelayFrameOptions extends RelayTargetBase {\n    frameId: number;\n    allFrames?: never;\n    frameIds?: never;\n    documentId?: never;\n    documentIds?: never;\n}\n\nexport interface RelayFramesOptions extends RelayTargetBase {\n    frameIds: RelayNonEmptyReadonlyArray<number>;\n    allFrames?: never;\n    frameId?: never;\n    documentId?: never;\n    documentIds?: never;\n}\n\nexport interface RelayDocumentOptions extends RelayTargetBase {\n    documentId: string;\n    allFrames?: never;\n    frameId?: never;\n    frameIds?: never;\n    documentIds?: never;\n}\n\nexport interface RelayDocumentsOptions extends RelayTargetBase {\n    documentIds: RelayNonEmptyReadonlyArray<string>;\n    allFrames?: never;\n    frameId?: never;\n    frameIds?: never;\n    documentId?: never;\n}\n\n/**\n * Broadcasts the call to all frames without requiring an exhaustive frame list and returns one outcome.\n * `true` is an alias for `RelayAllFrames.Any`.\n *\n * Warning: mutating methods can execute in multiple frames even though only one outcome is returned.\n */\nexport interface RelayAnyFramesOptions extends RelayTargetBase {\n    allFrames: true | RelayAllFrames.Any;\n    frameId?: never;\n    frameIds?: never;\n    documentId?: never;\n    documentIds?: never;\n}\n\nexport interface RelayEveryFrameOptions extends RelayTargetBase {\n    allFrames: RelayAllFrames.All;\n    frameId?: never;\n    frameIds?: never;\n    documentId?: never;\n    documentIds?: never;\n}\n\nexport type RelayAllFramesOptions = RelayAnyFramesOptions | RelayEveryFrameOptions;\n\nexport type RelayScalarOptions = RelayTopFrameOptions | RelayFrameOptions | RelayDocumentOptions;\n\nexport type RelayBatchOptions = RelayFramesOptions | RelayDocumentsOptions | RelayAllFramesOptions;\n\nexport type RelayCallOptions = RelayScalarOptions | RelayBatchOptions;\n\nexport type RelayAddressTarget =\n    | {\n          tabId: number;\n          frameId: number;\n          documentId?: string;\n          allFrames?: never;\n      }\n    | {\n          tabId: number;\n          frameId?: never;\n          documentId: string;\n          allFrames?: never;\n      };\n\nexport type RelayOperationTarget = {\n    tabId: number;\n    allFrames: RelayAllFrames;\n    frameId?: never;\n    documentId?: never;\n};\n\nexport type RelayResultTarget = RelayAddressTarget | RelayOperationTarget;\n\nexport interface RelayFrameError extends MessageError {\n    kind: RelayFrameErrorKind;\n}\n\nexport type RelayFrameResult<T> =\n    | {\n          target: RelayResultTarget;\n          status: \"fulfilled\";\n          result: T;\n      }\n    | {\n          target: RelayResultTarget;\n          status: \"rejected\";\n          error: RelayFrameError;\n      };\n\nexport type RelayFramesResult<T> = readonly RelayFrameResult<T>[];\n\nexport type RelayBatchRpcProxy<T> = {\n    [K in keyof T]: T[K] extends (...args: any[]) => any\n        ? (...args: Parameters<T[K]>) => Promise<RelayFramesResult<Awaited<ReturnType<T[K]>>>>\n        : T[K] extends object\n          ? RelayBatchRpcProxyObject<T[K]>\n          : () => Promise<RelayFramesResult<Awaited<T[K]>>>;\n};\n\nexport type RelayBatchRpcProxyObject<T> = (() => Promise<RelayFramesResult<Awaited<T>>>) & RelayBatchRpcProxy<T>;\n\nexport type RelayProxyTarget<N extends keyof RelayRegistry> = TransportProxyTarget<RelayRegistry, N>;\n\nexport type RelayBatchProxyTarget<N extends keyof RelayRegistry> = RelayBatchRpcProxy<RelayRegistry[N]>;\n\nexport interface RelayConfig extends TransportConfig, Omit<ContentScriptConfig, \"allFrames\"> {\n    allFrames?: boolean | RelayAllFrames;\n    method?: RelayMethod;\n}\n\nexport type RelayOptions = RelayConfig & EntrypointOptions;\n\nexport type RelayOptionsMap = Map<string, RelayOptions>;\n\nexport type RelayEntrypointOptions = Partial<RelayOptions>;\n\nexport type RelayMainHandler<T extends TransportType> = (\n    relay: T,\n    context: ContentScriptContext,\n    options: RelayEntrypointOptions\n) => Awaiter<void>;\n\nexport interface RelayDefinition<T extends TransportType>\n    extends\n        Omit<TransportDefinition<RelayOptions, T>, \"main\">,\n        Omit<ContentScriptDefinition, \"main\" | \"allFrames\">,\n        RelayEntrypointOptions {\n    main?: RelayMainHandler<T>;\n}\n\nexport type RelayUnresolvedDefinition<T extends TransportType> = Partial<RelayDefinition<T>>;\n"],"mappings":"AAOO,MAAM,iBAAiB;AAEvB,IAAK,cAAL,kBAAKA,iBAAL;AACH,EAAAA,aAAA,eAAY;AACZ,EAAAA,aAAA,eAAY;AAFJ,SAAAA;AAAA,GAAA;AAKL,IAAK,iBAAL,kBAAKC,oBAAL;AAOH,EAAAA,gBAAA,SAAM;AAGN,EAAAA,gBAAA,SAAM;AAVE,SAAAA;AAAA,GAAA;AAaL,IAAK,sBAAL,kBAAKC,yBAAL;AACH,EAAAA,qBAAA,YAAS;AACT,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,gBAAa;AACb,EAAAA,qBAAA,kBAAe;AANP,SAAAA;AAAA,GAAA;","names":["RelayMethod","RelayAllFrames","RelayFrameErrorKind"]}

package/dist/types/rpc.d.ts

@@ -0,0 +1,4 @@
+export type RpcAsyncProxy<T> = {
+    [K in keyof T]: T[K] extends (...args: any[]) => any ? (...args: Parameters<T[K]>) => Promise<Awaited<ReturnType<T[K]>>> : T[K] extends object ? RpcAsyncProxyObject<T[K]> : () => Promise<Awaited<T[K]>>;
+};
+export type RpcAsyncProxyObject<T> = (() => Promise<RpcAsyncProxy<T>>) & RpcAsyncProxy<T>;

package/dist/types/rpc.js

@@ -0,0 +1 @@
+//# sourceMappingURL=rpc.js.map

package/dist/types/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/transport.d.ts

@@ -1,7 +1,8 @@
 import { Required } from "utility-types";
 import { EntrypointOptions } from "./entrypoint.js";
-import { Awaiter, DeepAsyncProxy } from "./helpers.js";
+import { Awaiter } from "./helpers.js";
 import { MessageSender, MessageSendOptions } from "./message.js";
+import { RpcAsyncProxy } from "./rpc.js";
 export type TransportType = ((...args: any[]) => Promise<any>) | {
     [key: string]: any | TransportType;
 };
@@ -10,7 +11,7 @@ export interface TransportDictionary {
 }
 export type TransportName = Extract<keyof TransportDictionary, string>;
 export type TransportTarget<T extends TransportDictionary, K extends keyof T> = T[K];
-export type TransportProxyTarget<T extends TransportDictionary, K extends keyof T> = DeepAsyncProxy<T[K]>;
+export type TransportProxyTarget<T extends TransportDictionary, K extends keyof T> = RpcAsyncProxy<T[K]>;
 export interface TransportManager {
     add<K extends TransportName>(name: K, instance: TransportDictionary[K]): this;
     get<K extends TransportName>(name: K): TransportDictionary[K] | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "adnbn",
   "type": "module",
-  "version": "0.7.1",
+  "version": "0.9.0",
   "description": "Addon Bone - Cross-browser web extension framework with shared code base",
   "homepage": "https://addonbone.com",
   "author": "Anjey Tsibylskij (https://github.com/atldays)",
@@ -107,7 +107,8 @@
     "prepublishOnly": "npm run build",
     "build": "tsup && tsc -p tsconfig.build.json && node ./scripts/copy-dts.js && tsc-alias -p tsconfig.build.json -f -fe .js",
     "format": "prettier --write .",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck": "tsc -p tsconfig.json --noEmit && npm run typecheck:tests",
+    "typecheck:tests": "tsc -p tsconfig.tests.json --noEmit",
     "check:node-version": "node ./scripts/check-node-version.js",
     "test": "npm run build && jest",
     "test:ci": "npm run test -- --ci --passWithNoTests --coverage",
@@ -126,8 +127,8 @@
     "release:preview": "release-it --no-github.release --no-npm.publish --no-git.tag --ci"
   },
   "dependencies": {
-    "@addon-core/browser": "^0.7.1",
-    "@addon-core/inject-script": "^0.3.1",
+    "@addon-core/browser": "^0.7.2",
+    "@addon-core/inject-script": "^0.5.0",
     "@addon-core/storage": "^0.7.0",
     "@rsdoctor/rspack-plugin": "^1.5.1",
     "@rspack/cli": "^1.7.5",