@source-repo/rpc-cli 3.0.0

package/dist/extract.d.ts

@@ -0,0 +1,37 @@
+import { Node, Type } from 'ts-morph';
+import type { RpcSchema, TypeNode } from '@source-repo/rpc';
+/**
+ * Reads a contract out of TypeScript source.
+ *
+ * The rule that keeps this honest: anything the type language cannot represent is reported, never
+ * emitted as `any`. A schema that quietly degrades on the hard cases is worse than no schema,
+ * because it still looks like protection while checking nothing.
+ *
+ * Static analysis only - no user code is executed - so the namespace has to be declared in the
+ * source with @rpcNamespace rather than inferred from an exposeClassInstance call somewhere else.
+ */
+export interface Diagnostic {
+    /** Where the problem is, e.g. "Plant.writeSetpoint argument 0". */
+    where: string;
+    reason: string;
+    file?: string;
+    line?: number;
+}
+export interface ExtractResult {
+    schema: RpcSchema;
+    diagnostics: Diagnostic[];
+}
+interface Context {
+    types: {
+        [name: string]: TypeNode;
+    };
+    diagnostics: Diagnostic[];
+    /** Named types currently being converted, so a recursive one becomes a ref instead of looping. */
+    inProgress: Set<string>;
+    where: string;
+    node: Node;
+}
+export declare const typeToNode: (type: Type, context: Context, depth?: number) => TypeNode;
+export declare const extractSchema: (tsConfigFilePath: string) => ExtractResult;
+export {};
+//# sourceMappingURL=extract.d.ts.map

package/dist/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AACA,OAAO,EAAuC,IAAI,EAAe,IAAI,EAAE,MAAM,UAAU,CAAA;AACvF,OAAO,KAAK,EAAqD,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE9G;;;;;;;;;GASG;AAEH,MAAM,WAAW,UAAU;IACvB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,SAAS,CAAA;IACjB,WAAW,EAAE,UAAU,EAAE,CAAA;CAC5B;AAED,UAAU,OAAO;IACb,KAAK,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,CAAA;IACnC,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,kGAAkG;IAClG,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,IAAI,CAAA;CACb;AA4BD,eAAO,MAAM,UAAU,SAAU,IAAI,WAAW,OAAO,qBAAc,QA4CpE,CAAA;AAkJD,eAAO,MAAM,aAAa,qBAAsB,MAAM,KAAG,aAiDxD,CAAA"}

package/dist/extract.js

@@ -0,0 +1,272 @@
+import { resolve as resolvePath, dirname } from 'node:path';
+import { Node, Project, ts } from 'ts-morph';
+const fail = (context, reason) => {
+    context.diagnostics.push({
+        where: context.where,
+        reason,
+        file: context.node.getSourceFile().getFilePath(),
+        line: context.node.getStartLineNumber()
+    });
+    // Returned so extraction can continue and report everything at once. The caller refuses the
+    // whole run when any diagnostic was raised, so this never reaches a schema file.
+    return { kind: 'any' };
+};
+/** The name to key a shared or recursive type under, or undefined for an anonymous shape. */
+const nameOf = (type) => {
+    // An instantiated generic has a symbol but not a usable name: Record<string, number> and
+    // Record<string, string> share the symbol `Record`, so keying both under it would silently make
+    // the second a reference to the first's value type. Inline them instead.
+    if (type.getAliasTypeArguments().length || type.getTypeArguments().length)
+        return undefined;
+    const alias = type.getAliasSymbol()?.getName();
+    if (alias && alias !== '__type')
+        return alias;
+    const symbol = type.getSymbol()?.getName();
+    return symbol && symbol !== '__type' && symbol !== '__object' ? symbol : undefined;
+};
+const isPromise = (type) => type.getSymbol()?.getName() === 'Promise';
+export const typeToNode = (type, context, depth = 0) => {
+    if (depth > 24)
+        return fail(context, 'nests deeper than the extractor follows');
+    if (type.isAny() || type.isUnknown())
+        return { kind: 'any' };
+    if (type.isTypeParameter())
+        return fail(context, `is generic (${type.getText()}), which has no runtime type to check`);
+    if (type.getCallSignatures().length)
+        return fail(context, 'is a function, which cannot be checked on the wire');
+    if (type.isString())
+        return { kind: 'string' };
+    if (type.isNumber())
+        return { kind: 'number' };
+    if (type.isBoolean())
+        return { kind: 'boolean' };
+    if (type.isNull())
+        return { kind: 'null' };
+    if (type.isStringLiteral())
+        return { kind: 'literal', value: type.getLiteralValue() };
+    if (type.isNumberLiteral())
+        return { kind: 'literal', value: type.getLiteralValue() };
+    if (type.isBooleanLiteral())
+        return { kind: 'literal', value: type.getText() === 'true' };
+    const symbolName = type.getSymbol()?.getName();
+    // Both are values under MsgPack rather than encodings of them.
+    if (symbolName === 'Date')
+        return { kind: 'date' };
+    if (symbolName === 'Uint8Array')
+        return { kind: 'bytes' };
+    if (symbolName === 'Map' || symbolName === 'Set')
+        return fail(context, `is a ${symbolName}, which MsgPack does not carry; use an object or an array`);
+    if (type.isTuple())
+        return { kind: 'tuple', items: type.getTupleElements().map((element) => typeToNode(element, context, depth + 1)) };
+    if (type.isArray()) {
+        const element = type.getArrayElementType();
+        return element ? { kind: 'array', items: typeToNode(element, context, depth + 1) } : fail(context, 'is an array of an unknown element type');
+    }
+    // A named union or object becomes a reference. Registering only objects meant a recursive
+    // union - a value type, an AST node - was expanded inline until it ran out of depth.
+    const name = nameOf(type);
+    if (name && (type.isUnion() || type.isObject())) {
+        if (context.inProgress.has(name) || context.types[name])
+            return { kind: 'ref', name };
+        context.inProgress.add(name);
+        context.types[name] = { kind: 'any' }; // placeholder, so a member referring back resolves
+        context.types[name] = type.isUnion() ? unionToNode(type, context, depth) : objectToNode(type, context, depth);
+        context.inProgress.delete(name);
+        return { kind: 'ref', name };
+    }
+    if (type.isUnion())
+        return unionToNode(type, context, depth);
+    if (type.isObject())
+        return objectToNode(type, context, depth);
+    return fail(context, `has no representation in the schema type language (${type.getText()})`);
+};
+const unionToNode = (type, context, depth) => {
+    // undefined in a union means optional, which the parameter and field layers handle.
+    const options = type.getUnionTypes().filter((option) => !option.isUndefined());
+    if (!options.length)
+        return fail(context, 'is undefined only');
+    if (options.length === 1)
+        return typeToNode(options[0], context, depth + 1);
+    // A boolean surfaces as true | false; collapse it back.
+    if (options.length === 2 && options.every((option) => option.isBooleanLiteral()))
+        return { kind: 'boolean' };
+    return { kind: 'union', options: options.map((option) => typeToNode(option, context, depth + 1)) };
+};
+const objectToNode = (type, context, depth) => {
+    // getProperties() cannot see an index signature, so a dictionary has to be recognised here or
+    // it would be described as an object permitting no properties at all, refusing every value.
+    const indexed = type.getStringIndexType() ?? type.getNumberIndexType();
+    if (indexed) {
+        // Both at once would need a type that is part record and part object. Refused rather than
+        // guessed: dropping either half produces a contract that looks checked and is not.
+        if (type.getProperties().length)
+            return fail(context, 'has both declared properties and an index signature, which the schema type language cannot describe yet');
+        // A numeric index is still a string key on the wire, since JS object keys always are.
+        const numeric = !type.getStringIndexType();
+        return { kind: 'record', values: typeToNode(indexed, context, depth + 1), ...(numeric ? { keyPattern: '^-?\\d+$' } : {}) };
+    }
+    const fields = {};
+    for (const property of type.getProperties()) {
+        const propertyType = property.getTypeAtLocation(context.node);
+        const optional = property.isOptional() || propertyType.isNullable();
+        const nested = { ...context, where: `${context.where}.${property.getName()}` };
+        fields[property.getName()] = { type: typeToNode(propertyType, nested, depth + 1), ...(optional ? { optional: true } : {}) };
+    }
+    return { kind: 'object', fields };
+};
+const hasDecorator = (node, name) => node.getDecorators().some((decorator) => decorator.getName() === name);
+/** A string property of an object literal passed to a decorator, when it is written as a literal. */
+const literalOption = (argument, option) => {
+    if (!Node.isObjectLiteralExpression(argument))
+        return undefined;
+    const property = argument.getProperty(option);
+    if (!Node.isPropertyAssignment(property))
+        return undefined;
+    const initializer = property.getInitializer();
+    return Node.isStringLiteral(initializer) ? initializer.getLiteralValue() : undefined;
+};
+const SEMANTICS = new Set(['query', 'idempotent-command', 'non-repeatable-command']);
+/**
+ * What `@rpc({ semantics: '…' })` declares, if anything.
+ *
+ * Part of the contract rather than of the implementation: it is a promise about whether a caller
+ * may repeat the call, and `check` compares it between versions like any other part of the shape.
+ */
+const declaredSemantics = (method, context) => {
+    const decorator = method.getDecorators().find((candidate) => candidate.getName() === 'rpc');
+    const declared = literalOption(decorator?.getArguments()[0], 'semantics');
+    if (declared === undefined)
+        return undefined;
+    if (!SEMANTICS.has(declared)) {
+        // Named rather than dropped: a typo here would quietly publish a contract saying nothing
+        // about a method whose author thought they had said something about it.
+        context.diagnostics.push({
+            where: context.where,
+            reason: `declares semantics '${declared}', which is not one of ${[...SEMANTICS].join(', ')}`,
+            file: method.getSourceFile().getFilePath(),
+            line: method.getStartLineNumber()
+        });
+        return undefined;
+    }
+    return declared;
+};
+const namespaceDeclaration = (declaration) => {
+    const decorator = declaration.getDecorators().find((candidate) => candidate.getName() === 'rpcNamespace');
+    if (!decorator)
+        return undefined;
+    const [nameArgument, optionsArgument] = decorator.getArguments();
+    const name = Node.isStringLiteral(nameArgument) ? nameArgument.getLiteralValue() : undefined;
+    if (!name)
+        return undefined;
+    let version;
+    if (Node.isObjectLiteralExpression(optionsArgument)) {
+        const property = optionsArgument.getProperty('version');
+        if (Node.isPropertyAssignment(property)) {
+            const initializer = property.getInitializer();
+            if (Node.isStringLiteral(initializer))
+                version = initializer.getLiteralValue();
+        }
+    }
+    return { name, version };
+};
+const methodToSchema = (method, context) => {
+    const params = [];
+    const paramNames = [];
+    let rest;
+    for (const parameter of method.getParameters()) {
+        const at = { ...context, where: `${context.where} argument ${params.length}`, node: parameter };
+        if (parameter.isRestParameter()) {
+            const element = parameter.getType().getArrayElementType();
+            rest = element ? typeToNode(element, at) : fail(at, 'is a rest parameter of an unknown element type');
+            continue;
+        }
+        const node = typeToNode(parameter.getType(), at);
+        // An optional parameter is expressed as a union admitting null, which is what the
+        // validator reads to decide how few arguments a caller may send.
+        params.push(parameter.isOptional() ? { kind: 'union', options: [node, { kind: 'literal', value: null }] } : node);
+        paramNames.push(parameter.getName());
+    }
+    let returnType = method.getReturnType();
+    if (isPromise(returnType))
+        returnType = returnType.getTypeArguments()[0] ?? returnType;
+    const returns = returnType.isVoid() || returnType.isUndefined() ? undefined : typeToNode(returnType, { ...context, where: `${context.where} return` });
+    const semantics = declaredSemantics(method, context);
+    return {
+        params,
+        ...(paramNames.length ? { paramNames } : {}),
+        ...(rest ? { rest } : {}),
+        ...(returns ? { returns } : {}),
+        ...(semantics ? { semantics } : {})
+    };
+};
+/**
+ * Events are declared as a property type rather than inferred from emit() calls, which cannot be
+ * read statically with any confidence:
+ *
+ * ```typescript
+ * declare rpcEvents: { alarm: [message: string] }
+ * ```
+ */
+const eventsFromDeclaration = (declaration, context) => {
+    const property = declaration.getProperty('rpcEvents');
+    if (!property)
+        return undefined;
+    const events = {};
+    for (const event of property.getType().getProperties()) {
+        const at = { ...context, where: `${context.where} event ${event.getName()}`, node: property };
+        const tuple = event.getTypeAtLocation(property);
+        if (!tuple.isTuple()) {
+            fail(at, 'must be declared as a tuple of its arguments, e.g. [message: string]');
+            continue;
+        }
+        events[event.getName()] = { params: tuple.getTupleElements().map((element) => typeToNode(element, at)) };
+    }
+    return Object.keys(events).length ? events : undefined;
+};
+export const extractSchema = (tsConfigFilePath) => {
+    const project = new Project({ tsConfigFilePath });
+    // Exactly what include/files/exclude resolve to, asked of TypeScript rather than inferred.
+    // Resolving types pulls dependencies into the project, and `extract --project` should describe
+    // this project rather than every decorated class it happens to import.
+    const configured = ts.parseJsonConfigFileContent(ts.readConfigFile(tsConfigFilePath, ts.sys.readFile).config, ts.sys, dirname(resolvePath(tsConfigFilePath)));
+    const own = new Set(configured.fileNames.map((file) => resolvePath(file)));
+    const diagnostics = [];
+    const types = {};
+    const namespaces = {};
+    for (const sourceFile of project.getSourceFiles().filter((file) => own.has(resolvePath(file.getFilePath())))) {
+        for (const declaration of sourceFile.getClasses()) {
+            const declared = namespaceDeclaration(declaration);
+            if (!declared)
+                continue;
+            const methods = {};
+            const context = { types, diagnostics, inProgress: new Set(), where: declaration.getName() ?? 'class', node: declaration };
+            for (const method of declaration.getMethods()) {
+                if (!hasDecorator(method, 'rpc'))
+                    continue;
+                methods[method.getName()] = methodToSchema(method, { ...context, where: `${declared.name}.${method.getName()}`, node: method });
+            }
+            if (!Object.keys(methods).length) {
+                diagnostics.push({
+                    where: declared.name,
+                    reason: 'declares @rpcNamespace but marks no @rpc methods, so it would expose nothing',
+                    file: sourceFile.getFilePath(),
+                    line: declaration.getStartLineNumber()
+                });
+                continue;
+            }
+            const events = eventsFromDeclaration(declaration, { ...context, where: declared.name });
+            namespaces[declared.name] = { ...(declared.version ? { version: declared.version } : {}), methods, ...(events ? { events } : {}) };
+        }
+    }
+    // One unrepresentable type reaches every leaf beneath it, so the same complaint repeats.
+    const seen = new Set();
+    const unique = diagnostics.filter((diagnostic) => {
+        const key = `${diagnostic.where}|${diagnostic.reason}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+    return { schema: { schema: 1, ...(Object.keys(types).length ? { types } : {}), namespaces }, diagnostics: unique };
+};
+//# sourceMappingURL=extract.js.map

package/dist/extract.js.map

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

package/dist/fake.d.ts

@@ -0,0 +1,58 @@
+import { RpcServer, type RpcSchema, type TypeNode } from '@source-repo/rpc';
+import { type NetworkOptions } from './network.js';
+/**
+ * A peer built from a contract rather than from code: it answers every method the contract declares
+ * with a value of the declared shape, and refuses a call the contract would refuse.
+ *
+ * The point is to have something to develop against. An HMI cannot be worked on without the plant
+ * it talks to, a console cannot be exercised without a peer to select, and a test that needs a
+ * device which times out or throws needs a device willing to do that on request - which a real one
+ * is not. The contract is already extracted and committed for the deployed peer, so standing a
+ * stand-in up from it costs nothing and cannot drift: `source-rpc check` fails the build if it does.
+ *
+ * Generated values are deterministic. A fake whose readings wander is nicer to look at and useless
+ * to assert on, and `--script` is there for when a particular answer is what the test needs.
+ */
+/** Canned answers, deliberate failures and events on a timer. All optional. */
+export interface FakeScript {
+    /** `plant.read` -> the value to answer with, instead of one generated from the contract. */
+    returns?: {
+        [target: string]: unknown;
+    };
+    /**
+     * `plant.writeSetpoint` -> an RPC error code to answer with: Exception, Unauthorized,
+     * InvalidParams, and so on. `Timeout` is the special one - the call is never answered at all,
+     * which is the failure an HMI handles worst and can otherwise only be staged by pulling a cable.
+     */
+    fails?: {
+        [target: string]: string;
+    };
+    /** Events to emit on a timer, for the receiving end of an HMI that has nothing to receive. */
+    emits?: {
+        event: string;
+        every: number;
+        params?: unknown[];
+    }[];
+}
+export interface FakeOptions extends NetworkOptions {
+    /** The contract to serve. Every namespace in it is exposed. */
+    schema: RpcSchema;
+    script?: FakeScript;
+}
+/** Whether something handed over as a contract is one, so the wrong object is refused kindly. */
+export declare const looksLikeSchema: (value: unknown) => value is RpcSchema;
+/**
+ * A value of the declared shape.
+ *
+ * Bounds are honoured where the type language carries them, because a fake that answers 3000 where
+ * the contract says 0..2000 would be refused by the very validator this exists to exercise. What it
+ * cannot honour is `pattern`: satisfying an arbitrary regular expression is a different problem, so
+ * a constrained string comes back as the placeholder and is documented as such.
+ */
+export declare const sampleFor: (type: TypeNode | undefined, types: RpcSchema['types'], seen?: Set<string>, depth?: number) => unknown;
+export declare const startFake: (options: FakeOptions) => Promise<{
+    network: RpcServer;
+    namespaces: string[];
+    close: () => Promise<void>;
+}>;
+//# sourceMappingURL=fake.d.ts.map

package/dist/fake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake.d.ts","sourceRoot":"","sources":["../src/fake.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAwB,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACjG,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAErE;;;;;;;;;;;;GAYG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACvB,4FAA4F;IAC5F,OAAO,CAAC,EAAE;QAAE,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;IACvC;;;;OAIG;IACH,KAAK,CAAC,EAAE;QAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;IACpC,8FAA8F;IAC9F,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,EAAE,CAAA;CACjE;AAED,MAAM,WAAW,WAAY,SAAQ,cAAc;IAC/C,+DAA+D;IAC/D,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,CAAC,EAAE,UAAU,CAAA;CACtB;AAED,iGAAiG;AACjG,eAAO,MAAM,eAAe,UAAW,OAAO,KAAG,KAAK,IAAI,SAC0E,CAAA;AAcpI;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,SAAU,QAAQ,GAAG,SAAS,SAAS,SAAS,CAAC,OAAO,CAAC,SAAQ,GAAG,CAAC,MAAM,CAAC,qBAA0B,OA8D3H,CAAA;AA8BD,eAAO,MAAM,SAAS,YAAmB,WAAW;;;;EA6CnD,CAAA"}

package/dist/fake.js

@@ -0,0 +1,164 @@
+import { EventEmitter } from 'events';
+import { RpcServer } from '@source-repo/rpc';
+import { networkTransports } from './network.js';
+/** Whether something handed over as a contract is one, so the wrong object is refused kindly. */
+export const looksLikeSchema = (value) => !!value && typeof value === 'object' && !!value.namespaces && typeof value.namespaces === 'object';
+/** The code that means "never answer" rather than "answer with this error". */
+const NEVER_ANSWERS = 'Timeout';
+/**
+ * How deep a generated value goes before it stops. A recursive type - the schema's own TypeNode is
+ * one - would otherwise descend forever, and a sample twenty levels down says nothing a sample two
+ * levels down does not.
+ */
+const MAX_DEPTH = 6;
+const SAMPLE_TEXT = 'sample';
+/**
+ * A value of the declared shape.
+ *
+ * Bounds are honoured where the type language carries them, because a fake that answers 3000 where
+ * the contract says 0..2000 would be refused by the very validator this exists to exercise. What it
+ * cannot honour is `pattern`: satisfying an arbitrary regular expression is a different problem, so
+ * a constrained string comes back as the placeholder and is documented as such.
+ */
+export const sampleFor = (type, types, seen = new Set(), depth = 0) => {
+    if (!type || depth > MAX_DEPTH)
+        return null;
+    switch (type.kind) {
+        case 'any':
+        case 'null':
+            return null;
+        case 'boolean':
+            return true;
+        case 'number': {
+            // Inside the declared range, and the low end of it when only one side is given: a
+            // setpoint that starts at its maximum is a surprising thing for a fake to assert.
+            if (type.min !== undefined && type.max !== undefined) {
+                const middle = (type.min + type.max) / 2;
+                return type.integer ? Math.round(middle) : middle;
+            }
+            const value = type.min ?? (type.max !== undefined ? Math.min(0, type.max) : 0);
+            return type.integer ? Math.round(value) : value;
+        }
+        case 'string': {
+            let text = SAMPLE_TEXT;
+            if (type.minLength !== undefined && text.length < type.minLength)
+                text = text.padEnd(type.minLength, 'x');
+            if (type.maxLength !== undefined && text.length > type.maxLength)
+                text = text.slice(0, type.maxLength);
+            return text;
+        }
+        case 'bytes':
+            return Uint8Array.from([0x00, 0x01, 0x02, 0x03].slice(0, type.maxBytes ?? 4));
+        case 'date':
+            // The one value that is not fixed. A device reporting the epoch reads as a broken clock.
+            return new Date();
+        case 'literal':
+            return type.value;
+        case 'array':
+            return type.maxItems === 0 ? [] : [sampleFor(type.items, types, seen, depth + 1)];
+        case 'tuple':
+            return type.items.map((item) => sampleFor(item, types, seen, depth + 1));
+        case 'object':
+            // Required fields only, the same rule the console's argument forms use when they
+            // pre-fill a shape: an optional field is optional, and inventing one is not more honest.
+            return Object.fromEntries(Object.entries(type.fields)
+                .filter(([, field]) => !field.optional)
+                .map(([name, field]) => [name, sampleFor(field.type, types, seen, depth + 1)]));
+        case 'record':
+            // A key pattern cannot be satisfied in general, and an empty dictionary is a valid one.
+            if (type.keyPattern || type.maxEntries === 0)
+                return {};
+            return { [SAMPLE_TEXT]: sampleFor(type.values, types, seen, depth + 1) };
+        case 'union': {
+            // The first option that is not the null half of an optional: `mode?: 'auto' | 'manual'`
+            // should come back as 'auto' rather than as nothing at all.
+            const options = type.options.filter((option) => !(option.kind === 'literal' && option.value === null));
+            return sampleFor(options[0] ?? type.options[0], types, seen, depth + 1);
+        }
+        case 'ref': {
+            // Broken on the way back round: a type that contains itself has no finite sample.
+            if (seen.has(type.name))
+                return null;
+            const resolved = types?.[type.name];
+            return sampleFor(resolved, types, new Set([...seen, type.name]), depth + 1);
+        }
+        default:
+            return null;
+    }
+};
+/**
+ * One namespace as an object whose own properties are its methods.
+ *
+ * An EventEmitter, because the RPC layer only accepts a subscription to an instance that is one,
+ * and the methods are own properties because that is what `exposeObject` publishes - a plain
+ * object's methods are invisible to `exposeClassInstance`, which reads the prototype chain.
+ */
+class Fake extends EventEmitter {
+}
+const buildNamespace = (name, namespace, types, script) => {
+    // Named, so a console describing this peer says `Fake` where a real one names its class. That
+    // line is the only place the browser says out loud that it is not talking to a device.
+    const instance = new Fake();
+    for (const [method, described] of Object.entries(namespace.methods)) {
+        const target = `${name}.${method}`;
+        instance[method] = async () => {
+            const failure = script?.fails?.[target];
+            // Never answered rather than answered with a timeout: a caller has to see the call go
+            // unanswered for its own timeout to be what fires, which is the behaviour being staged.
+            if (failure === NEVER_ANSWERS)
+                return await new Promise(() => { });
+            if (failure)
+                throw Object.assign(new Error(`${target} is set to fail`), { code: failure });
+            if (script?.returns && target in script.returns)
+                return script.returns[target];
+            return sampleFor(described.returns, types);
+        };
+    }
+    return instance;
+};
+export const startFake = async (options) => {
+    const namespaces = Object.entries(options.schema.namespaces).filter(([name]) => name !== 'msgrpc');
+    if (!namespaces.length)
+        throw new Error('startFake: the contract describes no namespaces to serve');
+    // Built here rather than through connectNetwork, which makes a window onto the network; this
+    // one is a peer that serves. The schema is handed over so the fake refuses exactly what the real
+    // peer would - a stand-in that accepts calls the device rejects teaches the wrong lesson.
+    const network = new RpcServer({
+        name: options.name,
+        callTimeout: options.callTimeout,
+        readyTimeout: 15000,
+        schema: options.schema,
+        exposeIntrospection: true,
+        transports: networkTransports(options)
+    });
+    const instances = new Map();
+    for (const [name, namespace] of namespaces) {
+        const instance = buildNamespace(name, namespace, options.schema.types, options.script);
+        network.exposeObject(instance, name);
+        instances.set(name, instance);
+    }
+    await network.ready();
+    // Emitted on a timer, with parameters of the declared shape unless the script supplies them.
+    const timers = (options.script?.emits ?? []).map((emit) => {
+        const dot = emit.event.lastIndexOf('.');
+        const namespace = dot > 0 ? emit.event.slice(0, dot) : '';
+        const event = dot > 0 ? emit.event.slice(dot + 1) : emit.event;
+        const instance = instances.get(namespace);
+        if (!instance)
+            throw new Error(`startFake: nothing called '${namespace}' to emit ${emit.event} from`);
+        const declared = options.schema.namespaces[namespace]?.events?.[event];
+        const params = emit.params ?? (declared?.params ?? []).map((type) => sampleFor(type, options.schema.types));
+        // Unref'd: a fake with an emitter should not be the reason a process refuses to exit.
+        return setInterval(() => instance.emit(event, ...params), Math.max(emit.every, 50)).unref();
+    });
+    return {
+        network,
+        namespaces: namespaces.map(([name]) => name),
+        close: async () => {
+            for (const timer of timers)
+                clearInterval(timer);
+            await network.close();
+        }
+    };
+};
+//# sourceMappingURL=fake.js.map

package/dist/fake.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}