@zimi/remote 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2022 @zimi/utils authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,184 @@
+# @zimi/remote
+
+像调用本地函数一样调用远端的函数
+
+- 本地可以是浏览器、服务器，甚至一些受限的 `js` 子集
+- 远端可以是任何语言，如 `Java`
+- 对远端响应的数据格式也不严格限制
+
+## install
+```
+pnpm i @zimi/remote
+```
+
+## examples
+
+### iframe 与父级通信
+
+```ts
+// 1. 声明各自能提供的函数类型
+// type.d.ts
+
+// 父级能提供的函数
+export type FuncsFromParent = {
+  plus: (data: [number, number]) => Promise<number>
+}
+
+// 子级能提供的函数
+export type FuncsFromChild = {
+  multiply: (data: [number, number]) => Promise<number>
+}
+```
+
+```ts
+// 2. 父级 remote 初始化
+// parent.ts
+
+import { Remote, createIframeAdaptor } from '@zimi/remote'
+
+function getOpWindow() {
+  return (document.getElementById('child-iframe') as HTMLIFrameElement | null)?.contentWindow
+}
+
+// 我们提供了生成 iframe adaptor 的工具函数
+// 你也可以参考实现自己的 adaptor, 没多少代码
+const adaptor = createIframeAdaptor({
+  onEmit: (data) => {
+    getOpWindow()?.postMessage(data, '*')
+  },
+})
+
+const remote = new Remote<FuncsFromParent, FuncsFromChild>(adaptor, {
+  deviceId: 'parent',
+})
+
+// 父级注册自己能提供的函数
+remote.register('plus', async ([a, b]) => a + b)
+```
+
+```ts
+// 3. 子级 remote 初始化
+// child-iframe.ts
+
+import { Remote, createIframeAdaptor } from '@zimi/remote'
+
+function getOpWindow() {
+  return window.top
+}
+
+// 我们提供了生成 iframe adaptor 的工具函数
+// 你也可以参考实现自己的 adaptor, 没多少代码
+const adaptor = createIframeAdaptor({
+  onEmit: (data) => {
+    getOpWindow()?.postMessage(data, '*')
+  },
+})
+
+const remote = new Remote<FuncsFromChild, FuncsFromParent>(adaptor, {
+  // 当涉及到多子级时，可以通过该 deviceId 来区分彼此，
+  // 达到与不同子级通信的效果
+  deviceId: 'child',
+})
+
+// 子级注册自己能提供的函数
+remote.register('multiply', async ([a, b]) => a * b)
+```
+
+```ts
+// 好了，现在你可以父子间随意通信了
+
+// 对方所有函数都被代理到 remote._.xxx 上了
+
+// parent.ts
+// 父级中可以直接调用子级的函数
+// 有严格的类型与提示
+await remote._.multiply([3, 2])
+
+await remote._.multiply([3, 2], {
+  // 每个函数可以单独指定超时时间，超时后会抛出 RemoteTimeoutError
+  timeoutMs: 1000,
+  // 每个函数可以指定调用特定目标所有的函数（需要在 adaptor onEmit 中根据 targetDeviceId 往不同设备发送消息）
+  targetDeviceId: 'child-2'
+})
+
+// 调用对方未注册的函数，会抛出 RemoteNotFoundError
+await remote._.notRegisteredFunc()
+
+// 当对方函数发生运行时错误时，会抛出 RemoteError
+// 以上所有 error 都继承自 Error
+```
+
+### 浏览器与服务器通信
+
+```ts
+// 对方怎么写我们就不管了，假设对方返回的数据格式为：
+interface JavaResponse {
+  // 假设 code >= 300 为错误；code < 300 为成功
+  code: number
+  // 响应的数据
+  data: unknown
+  // 可能存在的错误信息
+  errorMsg?: string
+}
+```
+
+此时 adaptor 的 onEmit 函数稍微有些复杂，它需要解析服务端响应的数据，并封装为我们需要的格式：
+
+```ts
+const adaptor = createHttpAdaptor({
+  onEmit: async (data) => {
+    // 这里只是简单示意，使用者可以根据自己的情况构造 request
+    const res = await fetch(`https://xxx.com/api/${data.name}`, {
+      method: 'POST',
+      body: JSON.stringify(data.data),
+      headers: {
+        'Content-Type': 'application/json',
+      },
+    })
+    // 下面相当于我们代 server 端封装了一下数据
+    // callbackName 是一定会有的，此处只是为了类型安全
+    const callbackName = data.callbackName ?? 'IMPOSSIBLE_NO_CALLBACK_NAME'
+    const adaptorData: AdaptorPackageData = {
+      // 由于我们代 server 抛出事件
+      // 所以这里的 deviceId 和 targetDeviceId 是相反的
+      deviceId: data.targetDeviceId,
+      targetDeviceId: data.deviceId,
+      name: callbackName,
+      // 我们在下面根据不同情况来填充 data
+      data: null,
+    }
+    if (!res.ok) {
+      adaptorData.data = response.error(new RemoteError('network error'))
+    } else {
+      const json = (await res.json()) as {
+        code: number
+        data: unknown
+        errorMsg?: string
+      }
+      if (json.code < 300) {
+        adaptorData.data = response.success(json.data)
+      } else {
+        const error = new RemoteError(`server error: ${json.errorMsg}`)
+        // RemoteError 也接受 code, 你可以把服务端响应的错误码挂到其上，便于业务上区分处理
+        error.code = json.code
+        adaptorData.data = response.error(error)
+      }
+    }
+    // 一定要抛出 every 事件，remote 包基于此处理远端的响应
+    remoteEventManager.emit(remoteEventManager.EVERY_EVENT_NAME, adaptorData)
+    remoteEventManager.emit(callbackName, adaptorData)
+  },
+})
+
+// 由于服务端不会调用我们，所以我们无需提供函数，自然也无需调用 remote.register 注册函数
+const remote = new Remote<{}, FuncsFromHttp>(adaptor, {
+  deviceId: 'client',
+})
+
+// 使用方法同前
+await remote._.xxx(anyData)
+```
+
+### 与其他端通信（如 websocket）略
+
+你可以看看 `iframe adaptor` / `http adaptor` 源码，包含空行也就 30 行，依葫芦画瓢很轻易就能写一个。

package/dist/adaptors/http.d.ts

@@ -0,0 +1,13 @@
+import EventEmitter from 'eventemitter3';
+import type { Adaptor, AdaptorPackageData } from '../adaptor';
+declare class RemoteEventManager extends EventEmitter<{
+    [key: string]: [AdaptorPackageData];
+}> {
+    EVERY_EVENT_NAME: string;
+    onEvery(fn: (data: AdaptorPackageData) => void): void;
+}
+export declare const remoteEventManager: RemoteEventManager;
+export declare function createHttpAdaptor({ onEmit, }: {
+    onEmit: (data: AdaptorPackageData) => void;
+}): Adaptor;
+export {};

package/dist/adaptors/http.js

@@ -0,0 +1,26 @@
+import EventEmitter from 'eventemitter3';
+class RemoteEventManager extends EventEmitter {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "EVERY_EVENT_NAME", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: '__remote_every__'
+        });
+    }
+    onEvery(fn) {
+        this.on(this.EVERY_EVENT_NAME, fn);
+    }
+}
+export const remoteEventManager = new RemoteEventManager();
+export function createHttpAdaptor({ onEmit, }) {
+    const adaptor = {
+        every: remoteEventManager.onEvery.bind(remoteEventManager),
+        once: remoteEventManager.once.bind(remoteEventManager),
+        off: remoteEventManager.off.bind(remoteEventManager),
+        emit: onEmit,
+    };
+    return adaptor;
+}
+//# sourceMappingURL=http.js.map

package/dist/adaptors/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/adaptors/http.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,eAAe,CAAA;AAIxC,MAAM,kBAAmB,SAAQ,YAE/B;IAFF;;QAGE;;;;mBAAmB,kBAAkB;WAAA;IAKvC,CAAC;IAHC,OAAO,CAAC,EAAsC;QAC5C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAA;IACpC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAA;AAE1D,MAAM,UAAU,iBAAiB,CAAC,EAChC,MAAM,GAGP;IACC,MAAM,OAAO,GAAY;QACvB,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAC1D,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC;QACtD,GAAG,EAAE,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC;QACpD,IAAI,EAAE,MAAM;KACb,CAAA;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/adaptors/iframe.d.ts

@@ -0,0 +1,4 @@
+import type { Adaptor, AdaptorPackageData } from '../adaptor';
+export declare function createIframeAdaptor({ onEmit, }: {
+    onEmit: (data: AdaptorPackageData) => void;
+}): Adaptor;

package/dist/adaptors/iframe.js

@@ -0,0 +1,38 @@
+import EventEmitter from 'eventemitter3';
+import { isRemoteAdaptorData } from '../remote';
+class RemoteEventManager extends EventEmitter {
+    constructor() {
+        super();
+        Object.defineProperty(this, "EVERY_EVENT_NAME", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: '__remote_every__'
+        });
+        if (typeof window === 'undefined') {
+            return;
+        }
+        window.addEventListener('message', (event) => {
+            const { data } = event;
+            if (isRemoteAdaptorData(data)) {
+                this.emit(data.name, data);
+                // 一定要抛出 every 事件，remote 包基于此处理远端的响应
+                this.emit(this.EVERY_EVENT_NAME, data);
+            }
+        });
+    }
+    onEvery(fn) {
+        this.on(this.EVERY_EVENT_NAME, fn);
+    }
+}
+export function createIframeAdaptor({ onEmit, }) {
+    const remoteEventManager = new RemoteEventManager();
+    const adaptor = {
+        every: remoteEventManager.onEvery.bind(remoteEventManager),
+        once: remoteEventManager.once.bind(remoteEventManager),
+        off: remoteEventManager.off.bind(remoteEventManager),
+        emit: onEmit,
+    };
+    return adaptor;
+}
+//# sourceMappingURL=iframe.js.map

package/dist/adaptors/iframe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iframe.js","sourceRoot":"","sources":["../../src/adaptors/iframe.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAI/C,MAAM,kBAAmB,SAAQ,YAE/B;IAGA;QACE,KAAK,EAAE,CAAA;QAHT;;;;mBAAmB,kBAAkB;WAAA;QAInC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE;YACjC,OAAM;SACP;QACD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3C,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;YACtB,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE;gBAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;gBAC1B,oCAAoC;gBACpC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAA;aACvC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,CAAC,EAAsC;QAC5C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAA;IACpC,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,EAClC,MAAM,GAGP;IACC,MAAM,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAA;IAEnD,MAAM,OAAO,GAAY;QACvB,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAC1D,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC;QACtD,GAAG,EAAE,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC;QACpD,IAAI,EAAE,MAAM;KACb,CAAA;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { Remote, isRemoteAdaptorData } from './remote';
+export type { AdaptorPackageData, Adaptor } from './adaptor';
+export { RemoteError, RemoteNotFoundError, RemoteTimeoutError, response, } from './response';
+export { createIframeAdaptor } from './adaptors/iframe';
+export { createHttpAdaptor, remoteEventManager } from './adaptors/http';

package/dist/index.js

@@ -0,0 +1,5 @@
+export { Remote, isRemoteAdaptorData } from './remote';
+export { RemoteError, RemoteNotFoundError, RemoteTimeoutError, response, } from './response';
+export { createIframeAdaptor } from './adaptors/iframe';
+export { createHttpAdaptor, remoteEventManager } from './adaptors/http';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAEtD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,GACT,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/remote.d.ts

@@ -0,0 +1,79 @@
+import type { Adaptor, AdaptorPackageData } from './adaptor';
+type LogFunc = (...data: unknown[]) => void;
+type RemoteCallableFunc = (data: any) => Promise<any>;
+interface RemoteFuncRecords {
+    [key: string]: RemoteCallableFunc;
+}
+type FuncMapWithConfig<T extends RemoteFuncRecords> = {
+    [K in keyof T]: T[K] extends (data: infer Arg) => Promise<infer Ret> ? (data: Arg, config?: {
+        timeoutMs?: number;
+        targetDeviceId?: string;
+    }) => Promise<Ret> : never;
+};
+type RegisteredFunc<T extends RemoteCallableFunc> = T extends (data: infer Arg) => infer Ret ? (data: Arg, ctx: {
+    /**
+     * 对方的设备 id
+     */
+    deviceId: string;
+}) => Ret : never;
+export declare class Remote<
+/**
+ * MF means my functions
+ */
+MF extends RemoteFuncRecords, 
+/**
+ * OF means others functions
+ */
+OF extends RemoteFuncRecords> {
+    private adaptor;
+    debug: boolean;
+    private log;
+    /**
+     * （调用对方函数时的）默认超时时间，单位 ms
+     * @default 30000
+     */
+    private defaultTimeoutMs;
+    private map;
+    private deviceIdValue;
+    /**
+     * 设备 id 应该唯一，用于区分不同设备。
+     * 你可以在任何时候修改（更新）它。
+     * @default ''
+     */
+    get deviceId(): string;
+    set deviceId(deviceId: string);
+    constructor(adaptor: Adaptor, config?: {
+        /**
+         * 设备 id 应该唯一，用于区分不同设备。
+         * 你可以在任何时候修改（更新）它。
+         * @default ''
+         */
+        deviceId?: string;
+        /**
+         * （调用对方函数时的）默认超时时间，单位 ms
+         * @default 30000
+         */
+        defaultTimeoutMs?: number;
+        debug?: boolean;
+        /**
+         * 格式化 AdaptorPackageData 的函数，
+         * 用于调试时输出日志。
+         * @default JSON.stringify
+         */
+        log?: LogFunc;
+    });
+    /**
+     * 调用其他端的方法；会等待对方响应。
+     * 不能直接使用该方法，应该使用 proxy。
+     * @WARNING 不能用于响应其他端。
+     */
+    private callAsync;
+    /**
+     * 注册方法，供对方调用；
+     */
+    register<K extends keyof MF>(name: K, callback: RegisteredFunc<MF[K]>): void;
+    _: FuncMapWithConfig<OF>;
+    self: MF;
+}
+export declare function isRemoteAdaptorData(data: unknown): data is AdaptorPackageData;
+export {};

package/dist/remote.js

@@ -0,0 +1,192 @@
+import { RemoteError, RemoteNotFoundError, RemoteTimeoutError, response, } from './response';
+const RESPONSE_PREFIX = '_response_';
+function defaultLog(...data) {
+    if (!this.debug) {
+        return;
+    }
+    console.log(`[remote of ${this.deviceId}]`, ...data);
+}
+export class Remote {
+    /**
+     * 设备 id 应该唯一，用于区分不同设备。
+     * 你可以在任何时候修改（更新）它。
+     * @default ''
+     */
+    get deviceId() {
+        return this.deviceIdValue;
+    }
+    set deviceId(deviceId) {
+        this.log(`deviceId set: from "${this.deviceIdValue}" to "${deviceId}"`);
+        this.deviceIdValue = deviceId;
+    }
+    constructor(adaptor, config) {
+        var _a, _b, _c, _d;
+        Object.defineProperty(this, "adaptor", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: adaptor
+        });
+        Object.defineProperty(this, "debug", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "log", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * （调用对方函数时的）默认超时时间，单位 ms
+         * @default 30000
+         */
+        Object.defineProperty(this, "defaultTimeoutMs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 30000
+        });
+        Object.defineProperty(this, "map", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {}
+        });
+        Object.defineProperty(this, "deviceIdValue", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ''
+        });
+        Object.defineProperty(this, "_", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Proxy({}, {
+                get: (_, k) => this.callAsync.bind(this, k),
+            })
+        });
+        Object.defineProperty(this, "self", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Proxy({}, {
+                get: (_, k) => { var _a; return (_a = this.map[k]) === null || _a === void 0 ? void 0 : _a.callback; },
+            })
+        });
+        this.debug = (_a = config === null || config === void 0 ? void 0 : config.debug) !== null && _a !== void 0 ? _a : this.debug;
+        this.defaultTimeoutMs = (_b = config === null || config === void 0 ? void 0 : config.defaultTimeoutMs) !== null && _b !== void 0 ? _b : this.defaultTimeoutMs;
+        this.log = (_c = config === null || config === void 0 ? void 0 : config.log) !== null && _c !== void 0 ? _c : defaultLog.bind(this);
+        this.deviceId = (_d = config === null || config === void 0 ? void 0 : config.deviceId) !== null && _d !== void 0 ? _d : this.deviceId;
+        adaptor.every(async (e) => {
+            var _a;
+            const { deviceId: selfDeviceId } = this;
+            const { name, data, deviceId: targetDeviceId, callbackName } = e;
+            const callback = (_a = this.map[name]) === null || _a === void 0 ? void 0 : _a.callback;
+            if (!callback) {
+                if (name.startsWith(RESPONSE_PREFIX)) {
+                    // 这是响应，会在 callAsync once 中处理，这儿不用处理
+                    this.log('[every] response received: ', e);
+                    return;
+                }
+                this.log('callback not found: ', name);
+                if (callbackName) {
+                    adaptor.emit({
+                        deviceId: selfDeviceId,
+                        targetDeviceId,
+                        name: callbackName,
+                        data: response.error(new RemoteNotFoundError(`callback not found: ${name}`)),
+                    });
+                }
+                return;
+            }
+            if (!callbackName) {
+                this.log('should not respond: ', e);
+                void callback(data, { deviceId: targetDeviceId });
+                return;
+            }
+            this.log(`callback: ${name}; respondName: ${callbackName}; data: `, data);
+            try {
+                const ret = await callback(data, { deviceId: targetDeviceId });
+                this.log('callback return: ', ret);
+                adaptor.emit({
+                    deviceId: selfDeviceId,
+                    targetDeviceId,
+                    name: callbackName,
+                    data: response.success(ret),
+                });
+            }
+            catch (error) {
+                this.log('callback error: ', error);
+                adaptor.emit({
+                    deviceId: selfDeviceId,
+                    targetDeviceId,
+                    name: callbackName,
+                    data: response.error(RemoteError.fromError(error)),
+                });
+            }
+        });
+    }
+    /**
+     * 调用其他端的方法；会等待对方响应。
+     * 不能直接使用该方法，应该使用 proxy。
+     * @WARNING 不能用于响应其他端。
+     */
+    callAsync(name, data, config) {
+        var _a;
+        const timeoutMs = (_a = config === null || config === void 0 ? void 0 : config.timeoutMs) !== null && _a !== void 0 ? _a : this.defaultTimeoutMs;
+        const { deviceId } = this;
+        const randomStr = Math.random().toString(36).slice(2);
+        // 本条消息的响应名
+        const responseName = `${RESPONSE_PREFIX}-${name}-${deviceId}-${randomStr}`;
+        return new Promise((resolve, reject) => {
+            var _a;
+            let timer;
+            this.log(`callAsync ${name}: waiting for response: ${responseName}`);
+            const callback = (e) => {
+                var _a;
+                clearTimeout(timer);
+                this.log(`response received: ${responseName}`, e);
+                if (RemoteError.isRemoteError(e.data)) {
+                    reject(RemoteError.fromError(e.data));
+                }
+                else {
+                    resolve((_a = e.data) === null || _a === void 0 ? void 0 : _a.data);
+                }
+            };
+            this.adaptor.once(responseName, callback);
+            timer = setTimeout(() => {
+                this.log(`timeout: ${responseName}`);
+                this.adaptor.off(responseName, callback);
+                reject(new RemoteTimeoutError(`timeout: ${name}`));
+            }, timeoutMs);
+            this.adaptor.emit({
+                deviceId,
+                targetDeviceId: (_a = config === null || config === void 0 ? void 0 : config.targetDeviceId) !== null && _a !== void 0 ? _a : '',
+                name,
+                data,
+                callbackName: responseName,
+            });
+        });
+    }
+    /**
+     * 注册方法，供对方调用；
+     */
+    register(name, callback) {
+        this.map[name] = { callback };
+    }
+}
+export function isRemoteAdaptorData(data) {
+    return (!!data &&
+        typeof data === 'object' &&
+        'deviceId' in data &&
+        'name' in data &&
+        typeof data.deviceId === 'string' &&
+        typeof data.name === 'string' &&
+        !!data.deviceId &&
+        !!data.name);
+}
+//# sourceMappingURL=remote.js.map

package/dist/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"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"}