@source-repo/rpc 3.0.0

package/dist/RPC/Expose.js

@@ -0,0 +1,110 @@
+/**
+ * Marking which methods of a class may be called remotely.
+ *
+ * exposeClassInstance walks the prototype chain and publishes every function it finds, so a helper
+ * a class never meant to offer becomes callable by anyone who can reach the transport. Marking the
+ * intended methods turns that into an allow-list.
+ *
+ * A class with no marks keeps the old behaviour, so the plain "just expose the class" style still
+ * works. Set requireExplicitExposure on RpcServer to make the marks compulsory instead.
+ */
+/** Marked method names per constructor. Subclasses accumulate their own plus the ones they inherit. */
+const marked = new WeakMap();
+/** Declared semantics per constructor and method name, for the methods that declare any. */
+const semantics = new WeakMap();
+const markOn = (constructor, method, declared) => {
+    let names = marked.get(constructor);
+    if (!names)
+        marked.set(constructor, (names = new Set()));
+    names.add(method);
+    if (!declared)
+        return;
+    let declarations = semantics.get(constructor);
+    if (!declarations)
+        semantics.set(constructor, (declarations = new Map()));
+    declarations.set(method, declared);
+};
+const mark = (context, options) => {
+    if (context.static)
+        throw new Error('@rpc: static methods cannot be exposed');
+    if (context.private)
+        throw new Error('@rpc: private methods cannot be exposed');
+    context.addInitializer(function () {
+        markOn(this.constructor, String(context.name), options.semantics);
+    });
+};
+export function rpc(targetOrOptions, context) {
+    // Applied directly, the runtime hands a decorator its target and context; called as a factory,
+    // the one argument is the options object. A function in the first position is the giveaway.
+    if (typeof targetOrOptions === 'function' && context)
+        return mark(context, {});
+    const options = targetOrOptions;
+    return (_target, methodContext) => mark(methodContext, options);
+}
+/**
+ * Marks methods without decorators, for JavaScript callers or code that prefers not to use them.
+ * Names that are not functions on the prototype are rejected, since a typo would silently expose
+ * nothing.
+ */
+export const exposeMethods = (constructor, methods) => {
+    for (const method of methods) {
+        if (typeof constructor.prototype[method] !== 'function')
+            throw new Error(`exposeMethods: ${constructor.name}.${method} is not a method`);
+        markOn(constructor, method);
+    }
+    return constructor;
+};
+/** Namespace declared by a class, so the name is written once and read by both ends. */
+const namespaces = new WeakMap();
+/**
+ * Declares the name a class is exposed under, and optionally the version of its contract and how
+ * its calls may overlap.
+ *
+ * The exposure name only existed at the call site - `exposeClassInstance(instance, 'plant')` - so
+ * nothing reading the source could tell which namespace a class belongs to. Declaring it here lets
+ * the extraction CLI key a schema correctly, and lets exposeClassInstance take the name as read.
+ *
+ * ```typescript
+ * @rpcNamespace('plant', { version: '3', execution: 'serial' })
+ * class Plant { @rpc async writeSetpoint(value: number) { ... } }
+ * ```
+ */
+export const rpcNamespace = (name, options = {}) => (target, _context) => {
+    namespaces.set(target, { name, version: options.version, execution: options.execution });
+    return target;
+};
+/** The namespace an instance's class declares, walking up so a subclass inherits it. */
+export const declaredNamespace = (instance) => {
+    for (let ctor = instance.constructor; ctor; ctor = Object.getPrototypeOf(ctor)) {
+        const declared = namespaces.get(ctor);
+        if (declared)
+            return declared;
+    }
+    return undefined;
+};
+/** The marked method names for an instance, or undefined when the class marks nothing. */
+export const markedMethods = (instance) => {
+    const names = new Set();
+    // Walk the chain so a subclass inherits its parent's marks.
+    for (let ctor = instance.constructor; ctor; ctor = Object.getPrototypeOf(ctor)) {
+        for (const name of marked.get(ctor) ?? [])
+            names.add(name);
+    }
+    return names.size ? names : undefined;
+};
+/**
+ * The semantics an instance's methods declare, walking the chain so a subclass inherits them.
+ *
+ * A subclass that redeclares wins, which is why the nearest constructor is consulted first: an
+ * override that turns a query into a command has to be able to say so.
+ */
+export const declaredSemantics = (instance) => {
+    const declarations = new Map();
+    for (let ctor = instance.constructor; ctor; ctor = Object.getPrototypeOf(ctor)) {
+        for (const [method, declared] of semantics.get(ctor) ?? [])
+            if (!declarations.has(method))
+                declarations.set(method, declared);
+    }
+    return declarations;
+};
+//# sourceMappingURL=Expose.js.map

package/dist/RPC/Expose.js.map

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

package/dist/RPC/Idempotency.d.ts

@@ -0,0 +1,90 @@
+import type { RpcErrorCode, RpcRemoteError } from './Messages.js';
+/**
+ * Making a command run once when the network is willing to deliver it twice.
+ *
+ * MQTT at QoS 1 is at-least-once, and the RPC server already suppresses a redelivery from its own
+ * memory. That covers the ordinary case and none of the interesting one:
+ *
+ * 1. the server invokes a command;
+ * 2. the command changes something physical, or something on disk;
+ * 3. the server dies before it can publish the answer or remember it;
+ * 4. the broker redelivers the request to the restarted server, or to a replica;
+ * 5. it runs a second time.
+ *
+ * Nothing held in one process's memory can close that, because the memory is what died. A store
+ * that outlives the process can, and this is the seam for one. The library deliberately ships no
+ * database: what it owes you is the semantics and a clean place to put Redis, Postgres or a file.
+ *
+ * **Without a store, delivery and execution are at least once.** That is the honest statement, and
+ * it is true of every RPC system that does not have one - the difference is whether it is written
+ * down.
+ */
+/** Everything a store needs to recognise one command and to record what it did. */
+export interface RpcInvocation {
+    /**
+     * Names the command rather than the attempt: two attempts at one command share it. Defaults to
+     * the request id, which makes a redelivered packet the same command, and a caller pressing the
+     * button again a different one - unless the caller says otherwise.
+     */
+    idempotencyKey: string;
+    /** The attempt, which is unique per request even when the key is not. */
+    requestId: string;
+    /** `namespace.method`, so one store can serve a whole server without keys colliding. */
+    scope: string;
+    /** Peer that sent the request. */
+    source: string;
+    /** Milliseconds the caller said it would still wait, when it said. */
+    ttl?: number;
+}
+/** What a completed command answered, in a form that survives being written down and read back. */
+export type StoredRpcOutcome = {
+    result: unknown;
+} | {
+    code: RpcErrorCode;
+    error?: RpcRemoteError;
+};
+export declare const isFailedOutcome: (outcome: StoredRpcOutcome) => outcome is {
+    code: RpcErrorCode;
+    error?: RpcRemoteError;
+};
+/**
+ * Claim the right to run a command, and record what it did.
+ *
+ * `begin` returns:
+ * - `'acquired'` — nobody else has this one; run it, then call `complete`.
+ * - `'in-progress'` — somebody else holds it. The caller is waiting on whoever holds it, so this
+ *   request is dropped rather than answered: two answers to one request would be worse than one.
+ * - a `StoredRpcOutcome` — it already ran, and this is what it answered. Sent back without running
+ *   anything, which is the entire point.
+ *
+ * A store that throws stops the call with `UnknownOutcome` rather than running it. Failing open
+ * would turn an unreachable store into exactly the double execution it was installed to prevent,
+ * and a command refused because its guard is down is a problem an operator can see.
+ */
+export interface RpcIdempotencyStore {
+    begin(invocation: RpcInvocation): Promise<'acquired' | 'in-progress' | StoredRpcOutcome>;
+    complete(invocation: RpcInvocation, outcome: StoredRpcOutcome): Promise<void>;
+    /** Release a claim that never completed, so a crashed attempt does not lock the key forever. */
+    abandon?(invocation: RpcInvocation): Promise<void>;
+}
+/**
+ * A store in memory, for tests and for a single process that will not be restarted mid-command.
+ *
+ * Included so the wiring can be exercised and so the shape is obvious, **not** as an answer to the
+ * problem above: it dies with the process, which is precisely when the durable one would earn its
+ * keep. Reach for it in a test; reach for something on disk in a plant.
+ */
+export declare class MemoryIdempotencyStore implements RpcIdempotencyStore {
+    /** Bound on remembered outcomes, oldest evicted first, since the keys come off the wire. */
+    maxRemembered: number;
+    private outcomes;
+    private running;
+    constructor(
+    /** Bound on remembered outcomes, oldest evicted first, since the keys come off the wire. */
+    maxRemembered?: number);
+    private id;
+    begin(invocation: RpcInvocation): Promise<"acquired" | "in-progress" | StoredRpcOutcome>;
+    complete(invocation: RpcInvocation, outcome: StoredRpcOutcome): Promise<void>;
+    abandon(invocation: RpcInvocation): Promise<void>;
+}
+//# sourceMappingURL=Idempotency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Idempotency.d.ts","sourceRoot":"","sources":["../../src/RPC/Idempotency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC1B;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAA;IACjB,wFAAwF;IACxF,KAAK,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAA;CACf;AAED,mGAAmG;AACnG,MAAM,MAAM,gBAAgB,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,cAAc,CAAA;CAAE,CAAA;AAEnG,eAAO,MAAM,eAAe,YAAa,gBAAgB,KAAG,OAAO,IAAI;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,cAAc,CAAA;CAAuB,CAAA;AAE1I;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAChC,KAAK,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,GAAG,aAAa,GAAG,gBAAgB,CAAC,CAAA;IACxF,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7E,gGAAgG;IAChG,OAAO,CAAC,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACrD;AAED;;;;;;GAMG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAK1D,4FAA4F;IACrF,aAAa;IALxB,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,OAAO,CAAoB;IAEnC;IACI,4FAA4F;IACrF,aAAa,SAAO,EAC3B;IAEJ,OAAO,CAAC,EAAE;IAIJ,KAAK,CAAC,UAAU,EAAE,aAAa,0DAOpC;IAEK,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,iBASlE;IAEK,OAAO,CAAC,UAAU,EAAE,aAAa,iBAEtC;CACJ"}

package/dist/RPC/Idempotency.js

@@ -0,0 +1,46 @@
+export const isFailedOutcome = (outcome) => 'code' in outcome;
+/**
+ * A store in memory, for tests and for a single process that will not be restarted mid-command.
+ *
+ * Included so the wiring can be exercised and so the shape is obvious, **not** as an answer to the
+ * problem above: it dies with the process, which is precisely when the durable one would earn its
+ * keep. Reach for it in a test; reach for something on disk in a plant.
+ */
+export class MemoryIdempotencyStore {
+    maxRemembered;
+    outcomes = new Map();
+    running = new Set();
+    constructor(
+    /** Bound on remembered outcomes, oldest evicted first, since the keys come off the wire. */
+    maxRemembered = 1000) {
+        this.maxRemembered = maxRemembered;
+    }
+    id(invocation) {
+        return `${invocation.scope}\u0000${invocation.idempotencyKey}`;
+    }
+    async begin(invocation) {
+        const id = this.id(invocation);
+        const done = this.outcomes.get(id);
+        if (done)
+            return done;
+        if (this.running.has(id))
+            return 'in-progress';
+        this.running.add(id);
+        return 'acquired';
+    }
+    async complete(invocation, outcome) {
+        const id = this.id(invocation);
+        this.running.delete(id);
+        this.outcomes.set(id, outcome);
+        while (this.outcomes.size > this.maxRemembered) {
+            const oldest = this.outcomes.keys().next();
+            if (oldest.done)
+                break;
+            this.outcomes.delete(oldest.value);
+        }
+    }
+    async abandon(invocation) {
+        this.running.delete(this.id(invocation));
+    }
+}
+//# sourceMappingURL=Idempotency.js.map

package/dist/RPC/Idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Idempotency.js","sourceRoot":"","sources":["../../src/RPC/Idempotency.ts"],"names":[],"mappings":"AA4CA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAyB,EAA6D,EAAE,CAAC,MAAM,IAAI,OAAO,CAAA;AAuB1I;;;;;;GAMG;AACH,MAAM,OAAO,sBAAsB;IAMpB,aAAa;IALhB,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAA;IAC9C,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;IAEnC;IACI,4FAA4F;IACrF,aAAa,GAAG,IAAI;6BAApB,aAAa;IACrB,CAAC;IAEI,EAAE,CAAC,UAAyB;QAChC,OAAO,GAAG,UAAU,CAAC,KAAK,SAAS,UAAU,CAAC,cAAc,EAAE,CAAA;IAClE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,UAAyB;QACjC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAA;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAClC,IAAI,IAAI;YAAE,OAAO,IAAI,CAAA;QACrB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,aAAsB,CAAA;QACvD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACpB,OAAO,UAAmB,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAAyB,EAAE,OAAyB;QAC/D,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAA;QAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAA;YAC1C,IAAI,MAAM,CAAC,IAAI;gBAAE,MAAK;YACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAyB;QACnC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;IAC5C,CAAC;CACJ"}

package/dist/RPC/Introspection.d.ts

@@ -0,0 +1,92 @@
+import type { RpcServerHandler } from './RpcServerHandler.js';
+import type { NamespaceSchema, RpcSchema, TypeNode } from './Schema.js';
+import type { RpcMethodSemantics } from './Messages.js';
+/**
+ * What a server can say about itself.
+ *
+ * Deliberately msgrpc's own shape rather than a borrowed one. OpenAPI is HTTP-shaped and has no
+ * good way to describe a server pushing events; AsyncAPI models everything as a channel, which
+ * fights an RPC surface. Both would mean describing this system in someone else's concepts to
+ * satisfy a viewer we would then still want to replace.
+ */
+export interface DescribedMethod {
+    name: string;
+    /** Present when a schema describes this method; absent when nothing does. */
+    params?: TypeNode[];
+    /** Positionally matching `params`, when the schema carries them. */
+    paramNames?: string[];
+    rest?: TypeNode;
+    returns?: TypeNode;
+    /**
+     * What calling it does to the world, when the method says: `query`, `idempotent-command` or
+     * `non-repeatable-command`. Absent means it does not say, which a person reading a list of
+     * methods should treat as "ask before pressing this".
+     */
+    semantics?: RpcMethodSemantics;
+}
+export interface DescribedEvent {
+    name: string;
+    params?: TypeNode[];
+    /** How many peers currently hold a subscription to it. */
+    subscribers: number;
+}
+export interface DescribedNamespace {
+    name: string;
+    version?: string;
+    /** Class the exposed instance came from, which is usually what a person is looking for. */
+    className?: string;
+    /** True when the instance was created at runtime through createRpcInstance. */
+    created: boolean;
+    /** True when the instance can emit events at all. */
+    emitter: boolean;
+    /** True when calls into this instance run one at a time rather than side by side. */
+    serialised?: boolean;
+    methods: DescribedMethod[];
+    events: DescribedEvent[];
+}
+export interface ServerDescription {
+    /** Name this server is addressed by. */
+    name: string;
+    /** Contract version of the schema as a whole, when one is loaded. */
+    version?: string;
+    /** True when arguments are being checked, which tells a caller how much to trust the types. */
+    validating: boolean;
+    namespaces: DescribedNamespace[];
+    /** Named types the described methods refer to. */
+    types?: {
+        [name: string]: TypeNode;
+    };
+}
+/** What this namespace offers, ready to merge into whatever schema a server was given. */
+export declare const introspectionSchema: {
+    namespace: NamespaceSchema;
+    types: {
+        [name: string]: TypeNode;
+    };
+};
+/**
+ * Adds the `msgrpc` namespace to a server's schema, so describe() is described like anything else -
+ * and so `validation: 'required'` does not refuse the one call a peer makes to find out what is
+ * here, which it did before this existed.
+ *
+ * A server given no schema still gets this one. That does not turn checking on: validation defaults
+ * from the schema the *caller* passed, so an undescribed server stays undescribed and only reports
+ * its own introspection honestly.
+ *
+ * A user schema already defining `msgrpc` wins untouched. It is the contract that server actually
+ * serves, and overwriting it would describe the server as something it is not.
+ */
+export declare const withIntrospection: (schema: RpcSchema | undefined) => RpcSchema;
+/**
+ * Exposed under the namespace `msgrpc` when RpcServer is constructed with exposeIntrospection.
+ *
+ * Off by default, and it goes through the ordinary dispatch path, so authorize() sees it as a call
+ * on `msgrpc.describe` and can restrict it. Listing every class, method and live instance is
+ * reconnaissance, and on a plant network instance names tend to encode plant structure.
+ */
+export declare class Introspection {
+    private handler;
+    constructor(handler: RpcServerHandler);
+    describe(): Promise<ServerDescription>;
+}
+//# sourceMappingURL=Introspection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Introspection.d.ts","sourceRoot":"","sources":["../../src/RPC/Introspection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAgB,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAKvD;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,6EAA6E;IAC7E,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,OAAO,CAAC,EAAE,QAAQ,CAAA;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAA;CACjC;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAA;IAChB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAA;IAChB,qFAAqF;IACrF,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,MAAM,EAAE,cAAc,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAC9B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+FAA+F;IAC/F,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,kBAAkB,EAAE,CAAA;IAChC,kDAAkD;IAClD,KAAK,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,CAAA;CACvC;AAsCD,0FAA0F;AAC1F,eAAO,MAAM,mBAAmB,EAAE;IAAE,SAAS,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,CAAA;CASlG,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,WAAY,SAAS,GAAG,SAAS,KAAG,SAQjE,CAAA;AAED;;;;;;GAMG;AACH,qBACa,aAAa;IACV,OAAO,CAAC,OAAO;IAA3B,YAAoB,OAAO,EAAE,gBAAgB,EAAI;IAG3C,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAmD3C;CACJ"}

package/dist/RPC/Introspection.js

@@ -0,0 +1,188 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import EventEmitter from 'events';
+import { rpc, rpcNamespace } from './Expose.js';
+// Extracted from this file by `npm run contract` in the CLI package and committed, so building
+// msgrpc never needs the extractor that reads it. A test there asserts it still matches this source.
+import extracted from './Introspection.types.json' with { type: 'json' };
+/**
+ * The schema format has one type map shared by every namespace, so a library adding types to a
+ * user's schema has to stay out of their names - a plant defining its own `TypeNode` would
+ * otherwise find describe() described against it. Everything here moves under a prefix that no
+ * extracted type can collide with, since `.` is not part of an identifier.
+ */
+const PREFIX = 'msgrpc.';
+const prefixRefs = (node) => {
+    switch (node.kind) {
+        case 'ref':
+            return { ...node, name: PREFIX + node.name };
+        case 'array':
+            return { ...node, items: prefixRefs(node.items) };
+        case 'record':
+            return { ...node, values: prefixRefs(node.values) };
+        case 'tuple':
+            return { ...node, items: node.items.map(prefixRefs) };
+        case 'union':
+            return { ...node, options: node.options.map(prefixRefs) };
+        case 'object':
+            return { ...node, fields: Object.fromEntries(Object.entries(node.fields).map(([name, field]) => [name, { ...field, type: prefixRefs(field.type) }])) };
+        default:
+            return node;
+    }
+};
+const prefixMethod = (method) => ({
+    ...method,
+    params: method.params.map(prefixRefs),
+    ...(method.rest ? { rest: prefixRefs(method.rest) } : {}),
+    ...(method.returns ? { returns: prefixRefs(method.returns) } : {})
+});
+const source = extracted;
+/** What this namespace offers, ready to merge into whatever schema a server was given. */
+export const introspectionSchema = {
+    namespace: {
+        ...source.namespaces.msgrpc,
+        methods: Object.fromEntries(Object.entries(source.namespaces.msgrpc.methods).map(([name, method]) => [name, prefixMethod(method)])),
+        ...(source.namespaces.msgrpc.events
+            ? { events: Object.fromEntries(Object.entries(source.namespaces.msgrpc.events).map(([name, event]) => [name, { params: event.params.map(prefixRefs) }])) }
+            : {})
+    },
+    types: Object.fromEntries(Object.entries(source.types ?? {}).map(([name, type]) => [PREFIX + name, prefixRefs(type)]))
+};
+/**
+ * Adds the `msgrpc` namespace to a server's schema, so describe() is described like anything else -
+ * and so `validation: 'required'` does not refuse the one call a peer makes to find out what is
+ * here, which it did before this existed.
+ *
+ * A server given no schema still gets this one. That does not turn checking on: validation defaults
+ * from the schema the *caller* passed, so an undescribed server stays undescribed and only reports
+ * its own introspection honestly.
+ *
+ * A user schema already defining `msgrpc` wins untouched. It is the contract that server actually
+ * serves, and overwriting it would describe the server as something it is not.
+ */
+export const withIntrospection = (schema) => {
+    if (schema?.namespaces.msgrpc)
+        return schema;
+    return {
+        schema: 1,
+        ...schema,
+        types: { ...schema?.types, ...introspectionSchema.types },
+        namespaces: { ...schema?.namespaces, msgrpc: introspectionSchema.namespace }
+    };
+};
+/**
+ * Exposed under the namespace `msgrpc` when RpcServer is constructed with exposeIntrospection.
+ *
+ * Off by default, and it goes through the ordinary dispatch path, so authorize() sees it as a call
+ * on `msgrpc.describe` and can restrict it. Listing every class, method and live instance is
+ * reconnaissance, and on a plant network instance names tend to encode plant structure.
+ */
+let Introspection = (() => {
+    let _classDecorators = [rpcNamespace('msgrpc')];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _instanceExtraInitializers = [];
+    let _describe_decorators;
+    var Introspection = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _describe_decorators = [rpc];
+            __esDecorate(this, null, _describe_decorators, { kind: "method", name: "describe", static: false, private: false, access: { has: obj => "describe" in obj, get: obj => obj.describe }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            Introspection = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        handler = __runInitializers(this, _instanceExtraInitializers);
+        constructor(handler) {
+            this.handler = handler;
+        }
+        async describe() {
+            const manage = this.handler.manageRpc;
+            const schema = this.handler.schema;
+            const created = new Set(manage.createdInstances.keys());
+            const namespaces = Object.entries(manage.exposedNameSpaceInstances).map(([name, instance]) => {
+                const described = schema?.namespaces[name];
+                const methodNames = [...(manage.findNameSpaceMethodMap(name)?.keys() ?? [])].sort();
+                const methods = methodNames.map((method) => {
+                    const signature = described?.methods[method];
+                    const semantics = this.handler.semanticsOf({ path: name, method });
+                    return {
+                        name: method,
+                        ...(signature ? { params: signature.params, paramNames: signature.paramNames, rest: signature.rest, returns: signature.returns } : {}),
+                        ...(semantics ? { semantics } : {})
+                    };
+                });
+                // Declared events plus any a peer is currently subscribed to, since a server without a
+                // schema still knows what has been subscribed.
+                const eventNames = new Set(Object.keys(described?.events ?? {}));
+                for (const proxy of this.handler.eventProxies.values())
+                    if (proxy.instanceName === name)
+                        eventNames.add(proxy.event);
+                const events = [...eventNames].sort().map((event) => ({
+                    name: event,
+                    ...(described?.events?.[event] ? { params: described.events[event].params } : {}),
+                    subscribers: [...this.handler.eventProxies.values()].filter((proxy) => proxy.instanceName === name && proxy.event === event).length
+                }));
+                const execution = manage.exposedExecution[name];
+                return {
+                    name,
+                    ...(described?.version ? { version: described.version } : {}),
+                    // Worth reporting because it changes what a caller should expect: on a serialised
+                    // instance a slow method delays every other call into it, and that is a property of
+                    // the server rather than of the network.
+                    ...(execution && execution !== 'parallel' ? { serialised: true } : {}),
+                    className: instance.constructor?.name,
+                    created: created.has(name),
+                    emitter: instance instanceof EventEmitter,
+                    methods,
+                    events
+                };
+            });
+            return {
+                name: this.handler.name,
+                ...(schema?.version ? { version: schema.version } : {}),
+                validating: !!schema && this.handler.validation !== 'off',
+                namespaces: namespaces.sort((a, b) => a.name.localeCompare(b.name)),
+                ...(schema?.types ? { types: schema.types } : {})
+            };
+        }
+    };
+    return Introspection = _classThis;
+})();
+export { Introspection };
+//# sourceMappingURL=Introspection.js.map

package/dist/RPC/Introspection.js.map

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