@celljs/rpc-core 3.0.0

package/lib/rpc.js

@@ -0,0 +1,287 @@
+"use strict";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformErrorForSerialization = exports.RPCImpl = void 0;
+const disposable_1 = require("@celljs/core/lib/common/utils/disposable");
+const promise_util_1 = require("@celljs/core/lib/common/utils/promise-util");
+const cancellation_1 = require("@celljs/core/lib/common/utils/cancellation");
+const rpc_protocol_1 = require("./rpc-protocol");
+const rpc_multiplexer_1 = require("./rpc-multiplexer");
+function isBoolean(value) {
+    return value === true || value === false;
+}
+function isCancellationToken(value) {
+    const candidate = value;
+    return (candidate &&
+        (candidate === cancellation_1.CancellationToken.None ||
+            candidate === cancellation_1.CancellationToken.Cancelled ||
+            (isBoolean(candidate.isCancellationRequested) && !!candidate.onCancellationRequested)));
+}
+class RPCImpl {
+    constructor(connection, transformations) {
+        this.locals = new Map();
+        this.proxies = new Map();
+        this.lastMessageId = 0;
+        this.cancellationTokenSources = new Map();
+        this.pendingRPCReplies = new Map();
+        this.readyDeferred = new promise_util_1.Deferred();
+        this.toDispose = new disposable_1.DisposableCollection(disposable_1.Disposable.create(() => {
+            /* mark as no disposed */
+        }));
+        this.toDispose.push((this.multiplexer = new rpc_multiplexer_1.RPCMultiplexer(connection)));
+        this.multiplexer.onMessage(msg => this.receiveOneMessage(msg));
+        this.toDispose.push(disposable_1.Disposable.create(() => {
+            this.proxies.clear();
+            for (const reply of this.pendingRPCReplies.values()) {
+                reply.reject(rpc_protocol_1.ConnectionClosedError.create());
+            }
+            this.pendingRPCReplies.clear();
+        }));
+        this.reviver = (transformations === null || transformations === void 0 ? void 0 : transformations.reviver) || rpc_protocol_1.ObjectsTransferrer.reviver;
+        this.replacer = (transformations === null || transformations === void 0 ? void 0 : transformations.replacer) || rpc_protocol_1.ObjectsTransferrer.replacer;
+        this.connect();
+    }
+    async connect() {
+        let count = 0;
+        const task = setInterval(() => {
+            const callId = String(++this.lastMessageId);
+            this.multiplexer.send(this.open(callId));
+            count++;
+            if (count > 300) {
+                clearInterval(task);
+            }
+        }, 500);
+        await this.readyDeferred.promise;
+        clearInterval(task);
+    }
+    get isDisposed() {
+        return this.toDispose.disposed;
+    }
+    dispose() {
+        this.toDispose.dispose();
+    }
+    getProxy(proxyId) {
+        if (this.isDisposed) {
+            throw rpc_protocol_1.ConnectionClosedError.create();
+        }
+        let proxy = this.proxies.get(proxyId.id);
+        if (!proxy) {
+            proxy = this.createProxy(proxyId.id);
+            this.proxies.set(proxyId.id, proxy);
+        }
+        return proxy;
+    }
+    getLocal(proxyId) {
+        if (this.isDisposed) {
+            throw rpc_protocol_1.ConnectionClosedError.create();
+        }
+        return this.locals.get(proxyId.id);
+    }
+    set(identifier, instance) {
+        if (this.isDisposed) {
+            throw rpc_protocol_1.ConnectionClosedError.create();
+        }
+        this.locals.set(identifier.id, instance);
+        if (disposable_1.Disposable.is(instance)) {
+            this.toDispose.push(instance);
+        }
+        this.toDispose.push(disposable_1.Disposable.create(() => this.locals.delete(identifier.id)));
+        return instance;
+    }
+    createProxy(proxyId) {
+        const handler = {
+            get: (target, name) => {
+                if (!target[name]) {
+                    target[name] = (...myArgs) => this.remoteCall(proxyId, name, myArgs);
+                }
+                return target[name];
+            },
+        };
+        return new Proxy(Object.create(null), handler); // eslint-disable-line no-null/no-null
+    }
+    remoteCall(proxyId, methodName, args) {
+        if (this.isDisposed) {
+            return Promise.reject(rpc_protocol_1.ConnectionClosedError.create());
+        }
+        return this.readyDeferred.promise.then(() => {
+            const cancellationToken = args.length && isCancellationToken(args[args.length - 1]) ? args.pop() : undefined;
+            if (cancellationToken && cancellationToken.isCancellationRequested) {
+                return Promise.reject(canceled());
+            }
+            const callId = String(++this.lastMessageId);
+            const result = new promise_util_1.Deferred();
+            if (cancellationToken) {
+                args.push('add.cancellation.token');
+                cancellationToken.onCancellationRequested(() => this.multiplexer.send(this.cancel(callId)));
+            }
+            this.pendingRPCReplies.set(callId, result);
+            this.multiplexer.send(this.request(callId, proxyId, methodName, args));
+            return result.promise;
+        });
+    }
+    receiveOneMessage(rawmsg) {
+        if (this.isDisposed) {
+            return;
+        }
+        try {
+            const msg = JSON.parse(rawmsg, this.reviver);
+            switch (msg.type) {
+                case 1 /* MessageType.Request */:
+                    this.receiveRequest(msg);
+                    break;
+                case 2 /* MessageType.Reply */:
+                    this.receiveReply(msg);
+                    break;
+                case 3 /* MessageType.ReplyErr */:
+                    this.receiveReplyErr(msg);
+                    break;
+                case 4 /* MessageType.Cancel */:
+                    this.receiveCancel(msg);
+                    break;
+                case 7 /* MessageType.Open */:
+                    this.receiveOpen(msg);
+                    break;
+                case 8 /* MessageType.Ready */:
+                    this.receiveReady(msg);
+                    break;
+            }
+        }
+        catch (e) {
+            // exception does not show problematic content: log it!
+            console.log('failed to parse message: ' + rawmsg);
+            throw e;
+        }
+    }
+    receiveOpen(msg) {
+        this.multiplexer.send(this.replyReady(msg.id));
+    }
+    receiveReady(msg) {
+        this.readyDeferred.resolve();
+    }
+    receiveCancel(msg) {
+        const cancellationTokenSource = this.cancellationTokenSources.get(msg.id);
+        if (cancellationTokenSource) {
+            cancellationTokenSource.cancel();
+        }
+    }
+    receiveRequest(msg) {
+        const callId = msg.id;
+        const proxyId = msg.proxyId;
+        // convert `null` to `undefined`, since we don't use `null` in internal plugin APIs
+        const args = msg.args.map(arg => (arg === null ? undefined : arg)); // eslint-disable-line no-null/no-null
+        const addToken = args.length && args[args.length - 1] === 'add.cancellation.token' ? args.pop() : false;
+        if (addToken) {
+            const tokenSource = new cancellation_1.CancellationTokenSource();
+            this.cancellationTokenSources.set(callId, tokenSource);
+            args.push(tokenSource.token);
+        }
+        const invocation = this.invokeHandler(proxyId, msg.method, args);
+        invocation.then(result => {
+            this.cancellationTokenSources.delete(callId);
+            this.multiplexer.send(this.replyOK(callId, result));
+        }, error => {
+            this.cancellationTokenSources.delete(callId);
+            this.multiplexer.send(this.replyErr(callId, error));
+        });
+    }
+    receiveReply(msg) {
+        const callId = msg.id;
+        const pendingReply = this.pendingRPCReplies.get(callId);
+        if (!pendingReply) {
+            return;
+        }
+        this.pendingRPCReplies.delete(callId);
+        pendingReply.resolve(msg.res);
+    }
+    receiveReplyErr(msg) {
+        const callId = msg.id;
+        const pendingReply = this.pendingRPCReplies.get(callId);
+        if (!pendingReply) {
+            return;
+        }
+        this.pendingRPCReplies.delete(callId);
+        let err = undefined;
+        if (msg.err && msg.err.$isError) {
+            err = new Error();
+            err.name = msg.err.name;
+            err.message = msg.err.message;
+            err.stack = msg.err.stack;
+        }
+        pendingReply.reject(err);
+    }
+    invokeHandler(proxyId, methodName, args) {
+        try {
+            return Promise.resolve(this.doInvokeHandler(proxyId, methodName, args));
+        }
+        catch (err) {
+            return Promise.reject(err);
+        }
+    }
+    doInvokeHandler(proxyId, methodName, args) {
+        const actor = this.locals.get(proxyId);
+        if (!actor) {
+            throw new Error('Unknown actor ' + proxyId);
+        }
+        const method = actor[methodName];
+        if (typeof method !== 'function') {
+            throw new Error('Unknown method ' + methodName + ' on actor ' + proxyId);
+        }
+        return method.apply(actor, args);
+    }
+    cancel(req) {
+        return `{"type":${4 /* MessageType.Cancel */},"id":"${req}"}`;
+    }
+    open(req) {
+        return `{"type":${7 /* MessageType.Open */},"id":"${req}"}`;
+    }
+    request(req, rpcId, method, args) {
+        return `{"type":${1 /* MessageType.Request */},"id":"${req}","proxyId":"${rpcId}","method":"${method}","args":${JSON.stringify(args, this.replacer)}}`;
+    }
+    replyReady(req) {
+        return `{"type":${8 /* MessageType.Ready */},"id":"${req}"}`;
+    }
+    replyOK(req, res) {
+        if (typeof res === 'undefined') {
+            return `{"type":${2 /* MessageType.Reply */},"id":"${req}"}`;
+        }
+        return `{"type":${2 /* MessageType.Reply */},"id":"${req}","res":${safeStringify(res, this.replacer)}}`;
+    }
+    replyErr(req, err) {
+        err = typeof err === 'string' ? new Error(err) : err;
+        if (err instanceof Error) {
+            return `{"type":${3 /* MessageType.ReplyErr */},"id":"${req}","err":${safeStringify(transformErrorForSerialization(err))}}`;
+        }
+        return `{"type":${3 /* MessageType.ReplyErr */},"id":"${req}","err":null}`;
+    }
+}
+exports.RPCImpl = RPCImpl;
+function canceled() {
+    const error = new Error('Canceled');
+    error.name = error.message;
+    return error;
+}
+function transformErrorForSerialization(error) {
+    if (error instanceof Error) {
+        const { name, message } = error;
+        const stack = error.stacktrace || error.stack;
+        return {
+            $isError: true,
+            name,
+            message,
+            stack,
+        };
+    }
+    // return as is
+    return error;
+}
+exports.transformErrorForSerialization = transformErrorForSerialization;
+function safeStringify(obj, replacer) {
+    try {
+        return JSON.stringify(obj, replacer);
+    }
+    catch (err) {
+        console.error('error stringifying response: ', err);
+        return 'null';
+    }
+}
+//# sourceMappingURL=rpc.js.map

package/lib/rpc.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@celljs/rpc-core",
+  "version": "3.0.0",
+  "description": "",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "dependencies": {
+    "@celljs/core": "3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "cell-component"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cellbang/cell.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cellbang/cell/issues"
+  },
+  "homepage": "https://github.com/cellbang/cell",
+  "files": [
+    "lib",
+    "src",
+    "cell.yml"
+  ],
+  "scripts": {
+    "lint": "cell-component lint",
+    "build": "cell-component build",
+    "watch": "cell-component watch",
+    "clean": "cell-component clean",
+    "test": "cell-component test:js"
+  },
+  "devDependencies": {
+    "@celljs/component": "3.0.0"
+  },
+  "gitHead": "c0ef8d269e33a795406bcbb240cac4b845c6c24c"
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './rpc-multiplexer';
+export * from './rpc-protocol';
+export * from './rpc';

package/src/package.spec.ts

@@ -0,0 +1,4 @@
+describe('rpc core package', () => {
+
+    it('support code coverage statistics', () => {});
+});

package/src/rpc-multiplexer.ts

@@ -0,0 +1,65 @@
+import { Event } from '@celljs/core/lib/common/utils/event';
+import { Emitter } from '@celljs/core/lib/common/utils/emitter';
+import { DisposableCollection, Disposable } from '@celljs/core/lib/common/utils/disposable';
+import { ConnectionClosedError, MessageConnection } from './rpc-protocol';
+
+/**
+ * Sends/Receives multiple messages in one go:
+ *  - multiple messages to be sent from one stack get sent in bulk at `process.nextTick`.
+ *  - each incoming message is handled in a separate `process.nextTick`.
+ */
+export class RPCMultiplexer implements Disposable, MessageConnection {
+    private readonly connection: MessageConnection;
+    private readonly sendAccumulatedBound: () => void;
+
+    private messagesToSend: string[];
+
+    private readonly messageEmitter = new Emitter<string>();
+    private readonly toDispose = new DisposableCollection();
+
+    constructor(connection: MessageConnection) {
+        this.connection = connection;
+        this.sendAccumulatedBound = this.sendAccumulated.bind(this);
+
+        this.toDispose.push(Disposable.create(() => (this.messagesToSend = [])));
+        this.toDispose.push(
+            this.connection.onMessage((msg: string) => {
+                try {
+                    const messages = JSON.parse(msg);
+                    for (const message of messages) {
+                        this.messageEmitter.fire(message);
+                    }
+                } catch (e) {
+                    // NoOp
+                }
+            })
+        );
+        this.toDispose.push(this.messageEmitter);
+
+        this.messagesToSend = [];
+    }
+
+    dispose(): void {
+        this.toDispose.dispose();
+    }
+
+    get onMessage(): Event<string> {
+        return this.messageEmitter.event;
+    }
+
+    private sendAccumulated(): void {
+        const tmp = this.messagesToSend;
+        this.messagesToSend = [];
+        this.connection.send(JSON.stringify(tmp));
+    }
+
+    public send(msg: string): void {
+        if (this.toDispose.disposed) {
+            throw ConnectionClosedError.create();
+        }
+        if (this.messagesToSend.length === 0) {
+            setTimeout(this.sendAccumulatedBound, 0);
+        }
+        this.messagesToSend.push(msg);
+    }
+}

package/src/rpc-protocol.ts

@@ -0,0 +1,137 @@
+import { Disposable } from '@celljs/core/lib/common/utils/disposable';
+import { CustomError } from '@celljs/core/lib/common/error';
+
+import { Event } from '@celljs/core/lib/common/utils/event';
+export { CancellationTokenSource } from '@celljs/core/lib/common/utils/cancellation';
+
+export class ProxyIdentifier<T> {
+    public readonly id: string;
+    constructor(public readonly isMain: boolean, id: string | T) {
+        // TODO this is nasty, rewrite this
+        this.id = (id as any).toString();
+    }
+}
+
+export function createProxyIdentifier<T>(identifier: string): ProxyIdentifier<T> {
+    return new ProxyIdentifier(false, identifier);
+}
+
+export interface MessageConnection {
+    send(msg: string): void;
+    onMessage: Event<string>;
+}
+
+export const RPC = Symbol('RPC');
+export interface RPC extends Disposable {
+    /**
+     * Returns a proxy to an object addressable/named in the iframe window or in the main window.
+     */
+    getProxy<T>(proxyId: ProxyIdentifier<T>): T;
+
+    /**
+     * Returns a local to an object addressable/named in the iframe window or in the main window.
+     */
+    getLocal<T>(proxyId: ProxyIdentifier<T>): T;
+
+    /**
+     * Register manually created instance.
+     */
+    set<T, R extends T>(identifier: ProxyIdentifier<T>, instance: R): R;
+}
+
+export interface ConnectionClosedError extends CustomError {
+    code: 'RPC_PROTOCOL_CLOSED';
+}
+export namespace ConnectionClosedError {
+    const code: ConnectionClosedError['code'] = 'RPC_PROTOCOL_CLOSED';
+    export function create(message: string = 'connection is closed'): ConnectionClosedError {
+        return Object.assign(new Error(message), { code });
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    export function is(error: any): error is ConnectionClosedError {
+        return !!error && typeof error === 'object' && 'code' in error && error['code'] === code;
+    }
+}
+
+/**
+ * These functions are responsible for correct transferring objects via rpc channel.
+ *
+ * To reach that some specific kind of objects is converted to json in some custom way
+ * and then, after receiving, revived to objects again,
+ * so there is feeling that object was transferred via rpc channel.
+ *
+ * To distinguish between regular and altered objects, field $type is added to altered ones.
+ * Also value of that field specifies kind of the object.
+ */
+export namespace ObjectsTransferrer {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    export function replacer(key: string | undefined, value: any): any {
+        return value;
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    export function reviver(key: string | undefined, value: any): any {
+        return value;
+    }
+}
+
+export const enum MessageType {
+    Request = 1,
+    Reply = 2,
+    ReplyErr = 3,
+    Cancel = 4,
+    Terminate = 5,
+    Terminated = 6,
+    Open = 7,
+    Ready = 8
+}
+
+export class OpenMessage {
+    type: MessageType.Open;
+    id: string;
+    channalId: number;
+}
+
+export class ReadyMessage {
+    type: MessageType.Ready;
+    id: string;
+    channalId: number;
+}
+
+export class CancelMessage {
+    type: MessageType.Cancel;
+    id: string;
+    channalId: number;
+}
+
+export class RequestMessage {
+    type: MessageType.Request;
+    id: string;
+    channalId: number;
+    proxyId: string;
+    method: string;
+    args: any[];
+}
+
+export class ReplyMessage {
+    type: MessageType.Reply;
+    id: string;
+    channalId: number;
+    res: any;
+}
+
+export class ReplyErrMessage {
+    type: MessageType.ReplyErr;
+    id: string;
+    channalId: number;
+    err: SerializedError;
+}
+
+export type RPCMessage = RequestMessage | ReplyMessage | ReplyErrMessage | CancelMessage | OpenMessage | ReadyMessage;
+
+export interface SerializedError {
+    readonly $isError: true;
+    readonly name: string;
+    readonly message: string;
+    readonly stack: string;
+}