@source-repo/rpc 3.0.0

package/dist/RPC/RpcClientHandler.js

@@ -0,0 +1,267 @@
+import { MessageModule, MessageType } from './Core.js';
+import { isEventFunction } from './Rpc.js';
+import { RpcMessageType } from './RpcServerHandler.js';
+import { EventEmitter } from 'events';
+import { v4 as uuidv4 } from 'uuid';
+export const defaultCallTimeout = 10000;
+/**
+ * Identifies one subscription: which peer, which exposed instance, which event.
+ *
+ * Handlers used to be registered under the bare event name, so a client watching `alarm` on two
+ * namespaces - or on two peers over one MQTT transport - delivered each event to all of them. An
+ * empty source matches any peer, for a proxy created without a target.
+ */
+export const subscriptionKey = (source, namespace, event) => `${source}\u0000${namespace}\u0000${event}`;
+export class RpcError extends Error {
+    code;
+    remoteStack;
+    constructor(code, message, 
+    /** Stack trace from the remote peer, when it sent one. */
+    remoteStack) {
+        super(message ? `${code}: ${message}` : code);
+        this.code = code;
+        this.remoteStack = remoteStack;
+        this.name = 'RpcError';
+    }
+}
+function isSuccessResponse(payload) {
+    return payload.type === RpcMessageType.success;
+}
+function isEventMessage(payload) {
+    return payload.type === RpcMessageType.event;
+}
+function isErrorResponse(payload) {
+    return payload.type === RpcMessageType.error;
+}
+export class RpcClientHandler extends MessageModule {
+    callTimeout;
+    responsePromiseMap = new Map();
+    responseTimeoutMap = new Map();
+    /** Contract versions this client was built against, by namespace, declared on each call. */
+    schemaVersions;
+    /** Remote subscriptions held by this client, replayed by resubscribe() after a reconnect. */
+    subscriptions = new Map();
+    eventEmitter = new EventEmitter();
+    constructor(name, sources, callTimeout = defaultCallTimeout) {
+        super(name, sources);
+        this.callTimeout = callTimeout;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async receive(message, source, target) {
+        const payload = message.payload;
+        if (!payload)
+            return;
+        if (isEventMessage(payload)) {
+            this.deliverEvent(payload, source);
+            return;
+        }
+        if (isSuccessResponse(payload)) {
+            this.takePending(payload.id)?.resolve(payload.result);
+            return;
+        }
+        if (isErrorResponse(payload)) {
+            // Requires payload.id. A peer older than this fix sends errors without one, in which
+            // case the call can only be settled by its timeout.
+            this.takePending(payload.id)?.reject(new RpcError(payload.code, payload.error?.message, payload.error?.stack));
+        }
+    }
+    /**
+     * Routes an event to the handlers registered for that peer and that instance, rather than to
+     * everything listening for the name.
+     */
+    deliverEvent(payload, source) {
+        // Held in a local so the narrowing survives into the delivery callbacks below.
+        const emitter = this.eventEmitter;
+        if (emitter instanceof EventEmitter) {
+            const from = source ?? '';
+            const keys = payload.path
+                ? [subscriptionKey(from, payload.path, payload.event), subscriptionKey('', payload.path, payload.event)]
+                : // A peer that does not name the emitting instance: deliver to every subscription
+                    // for this event whose peer matches, whatever namespace it was taken out on.
+                    emitter
+                        .eventNames()
+                        .filter((name) => typeof name === 'string')
+                        .filter((name) => {
+                        const [keySource, , keyEvent] = name.split('\u0000');
+                        return keyEvent === payload.event && (keySource === from || keySource === '');
+                    });
+            for (const key of new Set(keys))
+                this.deliverSafely(() => emitter.emit(key, ...payload.params), payload);
+        }
+        // The handler's own emitter stays keyed by name: it is a firehose of everything this client
+        // receives, and its consumers read the path off the payload.
+        this.deliverSafely(() => this.emit(payload.event, payload.params), payload);
+    }
+    /**
+     * Run one subscriber without letting it unwind into the transport that delivered the event.
+     *
+     * These are application callbacks reached from a transport's inbound loop, so a handler that
+     * threw propagated all the way back out and became an unhandled rejection - one subscriber's
+     * bug ending the process for everything else the client was doing.
+     */
+    deliverSafely(deliver, payload) {
+        try {
+            deliver();
+        }
+        catch (e) {
+            this.emit('subscriberError', { event: payload.event, path: payload.path, error: e });
+        }
+    }
+    /**
+     * Re-issue every remote subscription this client holds. Called after the transport reconnects:
+     * if the server kept its state the calls are no-ops on its side, and if the server restarted
+     * they rebuild it. Either way the outgoing frames re-identify this client to the server, which
+     * is what makes server-pushed events addressable again.
+     */
+    async resubscribe() {
+        const results = await Promise.allSettled([...this.subscriptions.values()].map((subscription) => this.call(subscription.remote, subscription.instanceName, 'on', subscription.event)));
+        const failed = results.filter((result) => result.status === 'rejected').length;
+        if (failed)
+            this.emit('resubscribeFailed', failed);
+        return results.length - failed;
+    }
+    /**
+     * Reject every in-flight call. A reply to a call that was in flight when the link dropped can
+     * no longer reach us, so failing now beats making every caller wait out the full timeout.
+     *
+     * How it failed depends on whether the request got out. One that never left cannot have run, and
+     * `TransportError` says so; one that was published and never answered may have run, and only
+     * `UnknownOutcome` is true of it. Reporting both the same way was the library telling callers
+     * that a command had failed when what it knew was that it had lost track of it.
+     */
+    failPendingCalls(reason) {
+        for (const id of [...this.responsePromiseMap.keys()]) {
+            const sent = this.sentRequests.has(id);
+            this.sentRequests.delete(id);
+            this.takePending(id)?.reject(sent
+                ? new RpcError('UnknownOutcome', `${reason}, after the request was sent - it may or may not have run`)
+                : new RpcError('TransportError', `${reason}, before the request was sent`));
+        }
+    }
+    /**
+     * Requests this client handed to a transport without it complaining.
+     *
+     * Not proof of delivery - nothing here can have that - but proof that the frame left, which is
+     * the line between a command that certainly did not run and one that might have.
+     */
+    sentRequests = new Set();
+    /** Detach a pending call and cancel its timeout. Returns undefined if it already settled. */
+    takePending(id) {
+        if (id === undefined)
+            return undefined;
+        const promise = this.responsePromiseMap.get(id);
+        this.responsePromiseMap.delete(id);
+        this.sentRequests.delete(id);
+        const timeout = this.responseTimeoutMap.get(id);
+        if (timeout !== undefined) {
+            clearTimeout(timeout);
+            this.responseTimeoutMap.delete(id);
+        }
+        return promise;
+    }
+    /**
+     * Call a method on the RPC server.
+     * @param method The method to call.
+     * @param additionalParameter The (optional) additionalParameter to include. See the JsonRpc class for more details.
+     * @param params
+     */
+    call(remote, instanceName, method, ...params) {
+        return this.callWith({}, remote, instanceName, method, ...params);
+    }
+    /**
+     * Call with per-call options. `call` is this with none.
+     *
+     * The only option so far is the idempotency key, which is the one thing a caller can say that
+     * the library cannot work out for itself: whether this is a new command or another go at one it
+     * has already sent.
+     */
+    callWith(options, remote, instanceName, method, ...params) {
+        const payload = {
+            id: uuidv4(),
+            type: RpcMessageType.CallInstanceMethod,
+            path: instanceName,
+            method,
+            params,
+            version: this.schemaVersions?.[instanceName],
+            // The same number that arms the timer below, so what the far end is told is exactly
+            // what this caller is going to do. A request carrying no ttl is one with no deadline,
+            // which is what a caller that has disabled its own timeout is asking for.
+            ttl: this.callTimeout > 0 ? this.callTimeout : undefined,
+            ...(options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : {})
+        };
+        return new Promise((resolve, reject) => {
+            // Registered before sending: a response can arrive before sendPayload's promise settles.
+            this.responsePromiseMap.set(payload.id, { resolve, reject });
+            this.responseTimeoutMap.set(payload.id, setTimeout(() => {
+                // A timeout is an unknown outcome by definition: the request went out, and
+                // nothing came back. Kept as Timeout because that names *why* nothing is known,
+                // which is more use than the general case - but a caller reading it should treat
+                // a command as possibly done. There is a note about this in the README.
+                this.takePending(payload.id)?.reject(new RpcError('Timeout', `no response to ${instanceName}.${method} within ${this.callTimeout} ms`));
+            }, this.callTimeout));
+            this.sendPayload(payload, MessageType.RequestMessage, this.name, remote).then(() => {
+                // Recorded only once the transport has accepted it, and only while the call is
+                // still pending - a reply may well have arrived and settled it already.
+                if (this.responsePromiseMap.has(payload.id))
+                    this.sentRequests.add(payload.id);
+            }, (e) => {
+                // It never left, so whatever it would have done, it did not.
+                this.takePending(payload.id)?.reject(new RpcError('TransportError', e instanceof Error ? e.message : String(e)));
+            });
+        });
+    }
+    /**
+     * Create a proxy object - a sort of wrapper for calling methods and listening for events.
+     * @param name Name of an existing instance on the server instance. If in the form "name: Class" an instance of type Class will be created
+     * on the server if it does not already exist.
+     */
+    proxy(name, remote, options = {}) {
+        const proxyObj = {};
+        return new Proxy(proxyObj, {
+            get: (target, prop) => {
+                let result;
+                if (typeof prop === 'string') {
+                    if (target[prop]) {
+                        return target[prop];
+                    }
+                    else if (prop === '$with') {
+                        // The one name on a proxy that is not a remote method: it returns another
+                        // proxy for the same instance whose calls carry these options. Prefixed with
+                        // `$` because everything else here is whatever the far end happens to expose,
+                        // and a collision would silently shadow a real method.
+                        target[prop] = (callOptions) => this.proxy(name, remote, { ...options, ...callOptions });
+                    }
+                    else if (isEventFunction(prop)) {
+                        target[prop] = (...args) => {
+                            const event = args[0];
+                            if (typeof event === 'string') {
+                                // Registered against this peer and this namespace, so a name shared
+                                // with another instance does not deliver to both.
+                                const key = subscriptionKey(remote ?? '', name, event);
+                                this.eventEmitter[prop](key, ...args.slice(1));
+                                // 'on' is the only form the server holds state for, so it is the
+                                // only one worth replaying after a reconnect.
+                                if (prop === 'on')
+                                    this.subscriptions.set(key, { remote, instanceName: name, event });
+                                else if (prop === 'off' || prop === 'removeListener')
+                                    this.subscriptions.delete(key);
+                            }
+                            else {
+                                // removeAllListeners, setMaxListeners and friends take no event.
+                                ;
+                                this.eventEmitter[prop](...args);
+                            }
+                            return this.call(remote, name, prop, args[0]);
+                        };
+                    }
+                    else {
+                        target[prop] = (...args) => this.callWith(options, remote, name, prop, ...args);
+                    }
+                    result = target[prop];
+                }
+                return result;
+            }
+        });
+    }
+}
+//# sourceMappingURL=RpcClientHandler.js.map

package/dist/RPC/RpcClientHandler.js.map

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

package/dist/RPC/RpcServerHandler.d.ts

@@ -0,0 +1,226 @@
+import { MessageModule, Message, GenericModule } from './Core.js';
+import { RpcMessage, RpcMethodSemantics } from './Messages.js';
+export * from './Messages.js';
+import { IManageRpc } from './Rpc.js';
+import { RpcAuthorizer, RpcIdentity } from './Auth.js';
+import { type RpcIdempotencyStore } from './Idempotency.js';
+import EventEmitter from 'events';
+import { ILogger } from '../Logging/ILogger.js';
+import { type RpcExecution } from './Expose.js';
+import { RpcSchema } from './Schema.js';
+export declare class EventProxy {
+    rpcServer: RpcServerHandler;
+    instance: EventEmitter;
+    event: string;
+    target: string;
+    instanceName: string;
+    /**
+     * Held so the listener can be removed again. Binding at registration time produced a fresh
+     * function that removeListener() could never match.
+     */
+    private readonly listener;
+    constructor(rpcServer: RpcServerHandler, instance: EventEmitter, event: string, target: string, instanceName: string);
+    attach(): void;
+    detach(): void;
+}
+export type BindObject = {
+    [index: string]: (...args: unknown[]) => unknown;
+};
+export type ObjectByString = {
+    [index: string]: unknown;
+};
+/** How one instance is exposed, beyond the name it answers to. */
+export interface ExposeOptions {
+    /**
+     * How far up the prototype chain to publish methods from. The old third argument, which was
+     * this number on its own; a number is still accepted so existing calls keep working.
+     */
+    prototypeSteps?: number;
+    /**
+     * Whether calls into this instance may overlap. Overrides what the class declares, since the
+     * call site knows how this particular instance is used.
+     */
+    execution?: RpcExecution;
+}
+export declare class RpcServerHandler extends MessageModule<Message<RpcMessage>, RpcMessage, Message<RpcMessage>, RpcMessage> {
+    manageRpc: ManageRpc;
+    eventProxies: Map<string, EventProxy>;
+    /** Decides whether a call may proceed. When unset, every call that resolves is allowed. */
+    authorize?: RpcAuthorizer;
+    /** Supplied by RpcServer; asks the transports which identity a peer name is bound to. */
+    resolveIdentity?: (source: string) => RpcIdentity | undefined;
+    /** Reject calls from peers no transport can vouch for. */
+    requireIdentity: boolean;
+    /**
+     * Suppress duplicate requests. MQTT at QoS 1 is at-least-once, so the same request can be
+     * delivered twice; without this a retransmission would run the method a second time, which is
+     * not something a caller can undo. A duplicate is answered from the cache instead.
+     */
+    deduplicateRequests: boolean;
+    /** How many recent request ids to remember. Oldest are evicted first. */
+    maxTrackedRequests: number;
+    /**
+     * Refuse a call whose caller has already stopped waiting for it, instead of running it late.
+     *
+     * A request carries the milliseconds its caller intended to wait, and that budget is counted
+     * from the moment this process received the frame. A read arriving late only wastes work; a
+     * command does not - the operator saw a timeout, did something else about it, and then the
+     * original 'start pump' runs anyway. On by default, because that outcome is worse than the
+     * failed call it replaces.
+     */
+    refuseExpiredCalls: boolean;
+    /**
+     * Where to record what a non-repeatable command did, so a redelivery after a crash is answered
+     * rather than executed a second time. Unset means execution is at least once - see
+     * RPC/Idempotency.ts, which spells out exactly what that leaves open.
+     */
+    idempotency?: RpcIdempotencyStore;
+    /** Describes what exposed methods accept. Absent means nothing is checked. */
+    schema?: RpcSchema;
+    /**
+     * 'described' checks calls into namespaces the schema covers and lets the rest through, so a
+     * partial schema is useful. 'required' refuses anything the schema does not describe.
+     */
+    validation: 'off' | 'described' | 'required';
+    /** Check what handlers return as well as what callers send. Off by default: it is a self-check. */
+    validateResults: boolean;
+    /**
+     * What to do with a caller declaring a contract version this schema has no history for.
+     * 'allow' by default, because truncating history is a legitimate operational choice and should
+     * not strand peers.
+     */
+    unknownVersion: 'allow' | 'reject';
+    /** Verdicts by namespace and declared version, so the comparison runs once per peer, not per call. */
+    private compatibility;
+    private recentResponses;
+    private inFlightRequests;
+    constructor(name: string, sources?: GenericModule<unknown, unknown, Message, RpcMessage>[]);
+    /**
+     * Gate a call before it reaches an exposed method. Returns an error code to reject with, or
+     * undefined to allow. Subscriptions go through here too: without that, anyone could attach to
+     * an instance's events and receive everything it emits.
+     */
+    private checkAccess;
+    /**
+     * Returns a reason to refuse the call, or undefined. The namespace's contract version rides
+     * along in the message, because a caller built against an older contract otherwise looks
+     * indistinguishable from one sending plain rubbish.
+     */
+    private checkParams;
+    /**
+     * Compares the contract a caller declares with the one served here. Only a genuine structural
+     * incompatibility is refused: a caller whose contract still holds keeps working, which is why
+     * this compares schemas rather than gating on a version or a hash being equal.
+     */
+    private checkVersion;
+    receive(message: Message<RpcMessage>, source: string, target: string): Promise<void>;
+    /**
+     * Send a response and remember it against its request id, so a redelivered request can be
+     * answered without running the method again.
+     */
+    private respond;
+    receivePayload(payload: RpcMessage, source: string, target: string): Promise<void>;
+    /**
+     * Last resort when dispatch itself failed. Answers the caller if the request can still be
+     * identified, and never throws: the thing that failed may well be the transport this reply
+     * would go out on, and a failure to report a failure has nowhere left to go.
+     */
+    private reportDispatchFailure;
+    private dispatch;
+    /**
+     * Run one call: check the budget, claim the command, invoke it, answer.
+     *
+     * Split out of dispatch because it is what a serial instance runs one at a time, and because
+     * the order of these four is the whole of the delivery semantics.
+     */
+    private invoke;
+    /**
+     * Write down what the command did, before its answer is sent.
+     *
+     * This order is the one that matters. Recording after answering would leave a window in which
+     * the caller has the result and the store does not, so a redelivery arriving in that window
+     * runs the command again - which is the whole failure this is here to prevent. A store that
+     * cannot record it is reported and the answer still goes out: the command has already run, and
+     * withholding the result would not un-run it.
+     */
+    private settle;
+    /** The command a call is an attempt at, or undefined when nothing here needs to know. */
+    private invocationFor;
+    /**
+     * What a method says it does to the world: the running class first, then the schema.
+     *
+     * The class wins because it is what will actually run. A schema is a description, and a server
+     * whose description has drifted from its code should act on the code.
+     */
+    semanticsOf(payload: {
+        path: string;
+        method: string;
+    }): RpcMethodSemantics | undefined;
+    /** The queue a call belongs in, or undefined when this instance lets calls overlap. */
+    private executionKey;
+    /** One promise chain per key. Entries go away once nothing is waiting, so idle costs nothing. */
+    private executionQueues;
+    private serialise;
+    /**
+     * How long ago the caller's budget ran out, or undefined while it still has one.
+     *
+     * The budget starts when the frame arrived here, so it covers the wait in front of this method
+     * and nothing before it. What came before is the transport's to account for: MQTT 5 hands the
+     * broker the same budget as a message expiry, so a request that sat in a queue arrives already
+     * shortened, or does not arrive at all.
+     */
+    private expiredBy;
+    /** Catches this server returning something its own contract does not allow. */
+    private checkResult;
+    private sendError;
+    /**
+     * Release every event subscription held for a peer that has gone away. Without this the
+     * exposed instance keeps the listener forever and each emit produces an undeliverable frame.
+     */
+    removePeer(source: string): void;
+    sendEvent(target: string, event: string, params: unknown[], path?: string): Promise<void>;
+}
+export declare class ManageRpc implements IManageRpc {
+    logger?: ILogger | undefined;
+    exposedNameSpaceMethodMaps: {
+        [nameSpace: string]: Map<string, (...args: unknown[]) => void>;
+    };
+    exposedNameSpaceInstances: {
+        [nameSpace: string]: object;
+    };
+    exposedClasses: {
+        [className: string]: new (...args: unknown[]) => unknown;
+    };
+    createdInstances: Map<string, object>;
+    /** What each exposed namespace's methods declare about repeating them. */
+    exposedSemantics: {
+        [nameSpace: string]: Map<string, RpcMethodSemantics>;
+    };
+    /** How each exposed namespace lets its calls overlap. Absent is `parallel`. */
+    exposedExecution: {
+        [nameSpace: string]: RpcExecution;
+    };
+    constructor(logger?: ILogger | undefined);
+    /**
+     * Make the management surface callable remotely. Off unless RpcServer is constructed with
+     * exposeManagement, because it is the most dangerous thing this library can offer.
+     *
+     * Only createRpcInstance is published, and only for classes already passed to exposeClass().
+     * The previous behaviour was exposeClassInstance(this, 'manageRpc'), which published every
+     * method on this class - including exposeClassInstance and exposeObject themselves, letting
+     * any peer that could reach the transport publish arbitrary objects and instantiate arbitrary
+     * exposed classes. The logger was published the same way, so anyone could write log entries.
+     */
+    exposeManagement(): void;
+    getNameSpaceMethodMap(name: string): Map<string, (...args: unknown[]) => void>;
+    /** Look up a namespace without creating one. Use this on paths that came off the wire. */
+    findNameSpaceMethodMap(name: string): Map<string, (...args: unknown[]) => void>;
+    /** Set by RpcServer: refuse to expose a class that marks nothing. */
+    requireExplicitExposure: boolean;
+    exposeClassInstance(instance: object, name?: string, options?: number | ExposeOptions): void;
+    exposeClass<T>(constructor: new () => T, aliasName?: string): void;
+    exposeObject(obj: object, name: string): void;
+    expose(methodName: string, method: () => void): void;
+    createRpcInstance(className: string, instanceName?: string, ...args: unknown[]): Promise<string>;
+}
+//# sourceMappingURL=RpcServerHandler.d.ts.map

package/dist/RPC/RpcServerHandler.d.ts.map

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