@earendil-works/chord 1.1.0 → 1.2.0

package/dist/node/package.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/node/package.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile, realpath, stat } from \"node:fs/promises\";\nimport { basename, dirname, isAbsolute, join, relative, resolve, sep } from \"node:path\";\nimport { type BundleFacetsResult, bundleFacets } from \"./bundle.ts\";\n\nexport interface BundleFacetPackageOptions {\n\t/** Plugin package directory or its package.json path. */\n\treadonly packagePath: string;\n\treadonly outdir: string;\n\t/** Application conventions applied when the corresponding source file exists. */\n\treadonly defaultFacets?: Readonly<Record<string, string>>;\n}\n\nexport interface BundleFacetPackageResult extends BundleFacetsResult {\n\treadonly packageDirectory: string;\n\treadonly packageJsonPath: string;\n}\n\ninterface FacetPackageMetadata {\n\treadonly packageDirectory: string;\n\treadonly packageJsonPath: string;\n\treadonly name: string;\n\treadonly version: string;\n\treadonly peerDependencies: readonly string[];\n\treadonly configuredFacets: Readonly<Record<string, string | false>>;\n\treadonly external: readonly string[];\n\treadonly sourceMap: boolean;\n}\n\n/** Build a plugin package using package.json metadata and application-provided facet conventions. */\nexport async function bundleFacetPackage(options: BundleFacetPackageOptions): Promise<BundleFacetPackageResult> {\n\tconst metadata = await readFacetPackageMetadata(options.packagePath);\n\tconst entries = await resolveFacetEntries(metadata, options.defaultFacets ?? {});\n\tconst external = [...metadata.peerDependencies, ...metadata.external].flatMap((specifier) => [\n\t\tspecifier,\n\t\t`${specifier}/*`,\n\t]);\n\tconst result = await bundleFacets({\n\t\tplugin: { id: metadata.name, version: metadata.version },\n\t\tentries,\n\t\toutdir: options.outdir,\n\t\tworkingDirectory: metadata.packageDirectory,\n\t\texternal,\n\t\tsourceMap: metadata.sourceMap,\n\t});\n\treturn Object.freeze({\n\t\t...result,\n\t\tpackageDirectory: metadata.packageDirectory,\n\t\tpackageJsonPath: metadata.packageJsonPath,\n\t});\n}\n\nasync function readFacetPackageMetadata(packagePath: string): Promise<FacetPackageMetadata> {\n\tif (packagePath.length === 0) throw new TypeError(\"Facet package path must not be empty\");\n\tconst candidate = resolve(packagePath);\n\tlet packageDirectory: string;\n\tlet packageJsonPath: string;\n\tlet candidateStats: Awaited<ReturnType<typeof stat>>;\n\ttry {\n\t\tcandidateStats = await stat(candidate);\n\t} catch (error) {\n\t\tthrow new Error(`Could not access facet package ${candidate}`, { cause: error });\n\t}\n\tif (candidateStats.isDirectory()) {\n\t\tpackageDirectory = await realpath(candidate);\n\t\tpackageJsonPath = join(packageDirectory, \"package.json\");\n\t} else if (candidateStats.isFile() && basename(candidate) === \"package.json\") {\n\t\tpackageJsonPath = await realpath(candidate);\n\t\tpackageDirectory = dirname(packageJsonPath);\n\t} else {\n\t\tthrow new Error(`Facet package path must name a directory or package.json: ${candidate}`);\n\t}\n\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(await readFile(packageJsonPath, \"utf8\"));\n\t} catch (error) {\n\t\tthrow new Error(`Could not read facet package metadata ${packageJsonPath}`, { cause: error });\n\t}\n\tif (!isRecord(parsed)) throw new Error(`Facet package metadata must be an object: ${packageJsonPath}`);\n\tif (typeof parsed.name !== \"string\" || parsed.name.length === 0) {\n\t\tthrow new Error(`Facet package must have a non-empty name: ${packageJsonPath}`);\n\t}\n\tif (typeof parsed.version !== \"string\" || parsed.version.length === 0) {\n\t\tthrow new Error(`Facet package must have a non-empty version: ${packageJsonPath}`);\n\t}\n\tconst peerDependencies = parsePeerDependencies(parsed.peerDependencies, packageJsonPath);\n\tconst chord = parseChordConfiguration(parsed.chord, packageJsonPath);\n\treturn {\n\t\tpackageDirectory,\n\t\tpackageJsonPath,\n\t\tname: parsed.name,\n\t\tversion: parsed.version,\n\t\tpeerDependencies,\n\t\tconfiguredFacets: chord.facets,\n\t\texternal: chord.external,\n\t\tsourceMap: chord.sourceMap,\n\t};\n}\n\nfunction parsePeerDependencies(value: unknown, packageJsonPath: string): readonly string[] {\n\tif (value === undefined) return [];\n\tif (\n\t\t!isRecord(value) ||\n\t\tObject.entries(value).some(([name, version]) => name.length === 0 || typeof version !== \"string\")\n\t) {\n\t\tthrow new Error(`Facet package has invalid peerDependencies: ${packageJsonPath}`);\n\t}\n\treturn Object.freeze(Object.keys(value).sort());\n}\n\nfunction parseChordConfiguration(\n\tvalue: unknown,\n\tpackageJsonPath: string,\n): {\n\treadonly facets: Readonly<Record<string, string | false>>;\n\treadonly external: readonly string[];\n\treadonly sourceMap: boolean;\n} {\n\tif (value === undefined) return { facets: Object.freeze({}), external: Object.freeze([]), sourceMap: true };\n\tif (!isRecord(value)) throw new Error(`Facet package chord configuration must be an object: ${packageJsonPath}`);\n\tif (Object.keys(value).some((key) => key !== \"facets\" && key !== \"external\" && key !== \"sourceMap\")) {\n\t\tthrow new Error(`Facet package chord configuration has an unknown field: ${packageJsonPath}`);\n\t}\n\tconst facets: Record<string, string | false> = {};\n\tif (value.facets !== undefined) {\n\t\tif (!isRecord(value.facets)) {\n\t\t\tthrow new Error(`Facet package chord.facets must be an object: ${packageJsonPath}`);\n\t\t}\n\t\tfor (const [name, source] of Object.entries(value.facets)) {\n\t\t\tif (name.length === 0 || (typeof source !== \"string\" && source !== false) || source === \"\") {\n\t\t\t\tthrow new Error(`Facet package has an invalid chord.facets entry: ${packageJsonPath}`);\n\t\t\t}\n\t\t\tfacets[name] = source;\n\t\t}\n\t}\n\tlet external: readonly string[] = [];\n\tif (value.external !== undefined) {\n\t\tif (\n\t\t\t!Array.isArray(value.external) ||\n\t\t\tvalue.external.some((specifier) => typeof specifier !== \"string\" || specifier.length === 0)\n\t\t) {\n\t\t\tthrow new Error(`Facet package chord.external must contain non-empty strings: ${packageJsonPath}`);\n\t\t}\n\t\texternal = Object.freeze([...new Set(value.external as readonly string[])].sort());\n\t}\n\tif (value.sourceMap !== undefined && typeof value.sourceMap !== \"boolean\") {\n\t\tthrow new Error(`Facet package chord.sourceMap must be a boolean: ${packageJsonPath}`);\n\t}\n\treturn {\n\t\tfacets: Object.freeze(facets),\n\t\texternal,\n\t\tsourceMap: value.sourceMap ?? true,\n\t};\n}\n\nasync function resolveFacetEntries(\n\tmetadata: FacetPackageMetadata,\n\tdefaultFacets: Readonly<Record<string, string>>,\n): Promise<Readonly<Record<string, string>>> {\n\tconst entries: Record<string, string> = {};\n\tfor (const [name, source] of Object.entries(defaultFacets)) {\n\t\tvalidateFacetMapping(name, source, \"default\");\n\t\tconst path = resolvePackageEntry(metadata.packageDirectory, source, name);\n\t\ttry {\n\t\t\tconst entryStats = await stat(path);\n\t\t\tif (!entryStats.isFile()) throw new Error(`Default facet entry ${name} is not a file: ${path}`);\n\t\t\tconst canonicalPath = await realpath(path);\n\t\t\tvalidateCanonicalPackageEntry(metadata.packageDirectory, canonicalPath, name);\n\t\t\tentries[name] = canonicalPath;\n\t\t} catch (error) {\n\t\t\tif (isMissingPath(error)) continue;\n\t\t\tthrow error;\n\t\t}\n\t}\n\tfor (const [name, source] of Object.entries(metadata.configuredFacets)) {\n\t\tif (source === false) {\n\t\t\tdelete entries[name];\n\t\t\tcontinue;\n\t\t}\n\t\tvalidateFacetMapping(name, source, \"configured\");\n\t\tconst path = resolvePackageEntry(metadata.packageDirectory, source, name);\n\t\tlet entryStats: Awaited<ReturnType<typeof stat>>;\n\t\ttry {\n\t\t\tentryStats = await stat(path);\n\t\t} catch (error) {\n\t\t\tthrow new Error(`Could not access configured facet entry ${name}: ${path}`, { cause: error });\n\t\t}\n\t\tif (!entryStats.isFile()) throw new Error(`Configured facet entry ${name} is not a file: ${path}`);\n\t\tconst canonicalPath = await realpath(path);\n\t\tvalidateCanonicalPackageEntry(metadata.packageDirectory, canonicalPath, name);\n\t\tentries[name] = canonicalPath;\n\t}\n\tif (Object.keys(entries).length === 0) {\n\t\tthrow new Error(`Facet package ${metadata.name} has no configured or conventional facet entries`);\n\t}\n\treturn Object.freeze(entries);\n}\n\nfunction validateFacetMapping(name: string, source: string, kind: string): void {\n\tif (name.length === 0) throw new Error(`Facet package ${kind} entry name must not be empty`);\n\tif (source.length === 0) throw new Error(`Facet package ${kind} entry ${name} must have a source path`);\n}\n\nfunction resolvePackageEntry(packageDirectory: string, source: string, name: string): string {\n\tif (isAbsolute(source)) throw new Error(`Facet package entry ${name} must be relative to the package directory`);\n\tconst path = resolve(packageDirectory, source);\n\tconst relativePath = relative(packageDirectory, path);\n\tif (\n\t\trelativePath.length === 0 ||\n\t\trelativePath === \"..\" ||\n\t\trelativePath.startsWith(`..${sep}`) ||\n\t\tisAbsolute(relativePath)\n\t) {\n\t\tthrow new Error(`Facet package entry ${name} escapes the package directory`);\n\t}\n\treturn path;\n}\n\nfunction validateCanonicalPackageEntry(packageDirectory: string, path: string, name: string): void {\n\tconst relativePath = relative(packageDirectory, path);\n\tif (relativePath === \"..\" || relativePath.startsWith(`..${sep}`) || isAbsolute(relativePath)) {\n\t\tthrow new Error(`Facet package entry ${name} resolves outside the package directory`);\n\t}\n}\n\nfunction isMissingPath(error: unknown): boolean {\n\treturn isRecord(error) && error.code === \"ENOENT\";\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}

package/dist/services/consumer.d.ts

@@ -1,11 +0,0 @@
-import type { Context, RemoteServiceBinding, RemoteServiceBindingOptions, Service } from "../types.ts";
-export declare class RemoteServiceBindingImpl implements RemoteServiceBinding {
-    #private;
-    constructor(options: RemoteServiceBindingOptions);
-    use<T>(service: Service<T>): T;
-    observe<T>(service: Service<T>, handler: (service: T, context: Context) => void | Promise<void>): () => void;
-    ready(context: Context): Promise<void>;
-    rebind(bound: boolean, context: Context): Promise<void>;
-    dispose(context: Context): Promise<void>;
-}
-//# sourceMappingURL=consumer.d.ts.map

package/dist/services/consumer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"consumer.d.ts","sourceRoot":"","sources":["../../src/services/consumer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,OAAO,EAEP,oBAAoB,EACpB,2BAA2B,EAG3B,OAAO,EAOP,MAAM,aAAa,CAAC;AA2arB,qBAAa,wBAAyB,YAAW,oBAAoB;;IAapE,YAAY,OAAO,EAAE,2BAA2B,EAQ/C;IAED,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CA2B7B;IAED,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAsB3G;IAEK,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB3C;IAEK,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B5D;IAEK,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB7C;CAkED"}

package/dist/services/consumer.js

@@ -1,585 +0,0 @@
-import { awaitWithContext, BACKGROUND_CONTEXT } from "../context/index.js";
-import { RemoteServiceError } from "./errors.js";
-import { ServiceSlot } from "./handle.js";
-import { InstanceDirectory } from "./instances.js";
-import { ReplicatedStateReplica, serviceDeliveryContext } from "./state.js";
-class MemberSlot {
-    #serviceId;
-    #member;
-    #invoke;
-    #state;
-    #isActive;
-    #assertAccess;
-    value;
-    #kind;
-    #expectedKind;
-    constructor(serviceId, member, invoke, isActive, assertAccess, reportError) {
-        this.#serviceId = serviceId;
-        this.#member = member;
-        this.#invoke = invoke;
-        this.#isActive = isActive;
-        this.#assertAccess = assertAccess;
-        this.#state = new ReplicatedStateReplica(reportError);
-        const callable = () => { };
-        this.value = new Proxy(callable, {
-            apply: (_target, _thisArg, args) => this.#call(args),
-            get: (_target, property) => {
-                if (property === "value") {
-                    this.#assertAccess();
-                    this.#expect("state");
-                    return this.#state.value;
-                }
-                if (property === "subscribe")
-                    return this.#subscribe.bind(this);
-                if (property === Symbol.toStringTag)
-                    return "RemoteServiceMember";
-                if (property === "then")
-                    return undefined;
-                return undefined;
-            },
-        });
-    }
-    setDescription(kind) {
-        if (this.#kind !== undefined && this.#kind !== kind) {
-            throw new Error(`Remote service member ${this.#serviceId}.${this.#member} changed kind`);
-        }
-        this.#kind = kind;
-        if (this.#expectedKind !== undefined && this.#expectedKind !== kind) {
-            throw new RemoteServiceError("service_member_mismatch", `Remote service member ${this.#serviceId}.${this.#member} is ${kind}, not ${this.#expectedKind}`);
-        }
-    }
-    hydrate(sequence, ops, context) {
-        this.setDescription("state");
-        this.#state.hydrate(sequence, ops, context);
-    }
-    update(sequence, ops, context) {
-        this.setDescription("state");
-        this.#state.update(sequence, ops, context);
-    }
-    clear() {
-        this.#state.clear();
-    }
-    #subscribe(listener) {
-        this.#assertAccess();
-        if (typeof listener !== "function") {
-            throw new TypeError("Replicated state subscription listener must be a function");
-        }
-        this.#expect("state");
-        return this.#state.subscribe(listener);
-    }
-    #expect(kind) {
-        if (this.#expectedKind !== undefined && this.#expectedKind !== kind) {
-            throw new RemoteServiceError("service_member_mismatch", `Remote service member ${this.#serviceId}.${this.#member} was used as two different kinds`);
-        }
-        this.#expectedKind = kind;
-        if (this.#kind !== undefined && this.#kind !== kind) {
-            throw new RemoteServiceError("service_member_mismatch", `Remote service member ${this.#serviceId}.${this.#member} is ${this.#kind}, not ${kind}`);
-        }
-    }
-    #call(args) {
-        this.#assertAccess();
-        this.#expect("method");
-        if (!this.#isActive()) {
-            return Promise.reject(new RemoteServiceError("service_stale_instance", `Remote service ${this.#serviceId} binding is closed`));
-        }
-        const context = args.at(-1);
-        if (!isContext(context)) {
-            return Promise.reject(new RemoteServiceError("service_invalid_value", `Remote service method ${this.#serviceId}.${this.#member} requires a trailing Context`));
-        }
-        const businessArgs = args.slice(0, -1);
-        return this.#invoke(businessArgs, context);
-    }
-}
-class ServiceFacade {
-    #serviceId;
-    #address;
-    #transport;
-    #reportError;
-    #slots = new Map();
-    #descriptions = new Map();
-    #isActive;
-    #assertAccess;
-    proxy;
-    constructor(serviceId, address, transport, isActive, assertAccess, reportError) {
-        this.#serviceId = serviceId;
-        this.#address = address;
-        this.#transport = transport;
-        this.#isActive = isActive;
-        this.#assertAccess = assertAccess;
-        this.#reportError = reportError;
-        this.proxy = new Proxy(Object.create(null), {
-            get: (_target, property) => {
-                if (typeof property !== "string")
-                    return undefined;
-                return this.#slot(property).value;
-            },
-        });
-    }
-    install(snapshot, context) {
-        if (!sameAddress(snapshot.instance, this.#address))
-            throw new Error("Remote service snapshot has the wrong address");
-        const members = validateMembers(snapshot.members);
-        for (const name of this.#slots.keys()) {
-            if (!members.has(name)) {
-                throw new RemoteServiceError("service_member_not_found", `Unknown remote service member ${this.#serviceId}.${name}`);
-            }
-        }
-        this.#descriptions.clear();
-        for (const [name, member] of members)
-            this.#descriptions.set(name, member.kind);
-        for (const member of members.values()) {
-            const slot = this.#slots.get(member.name);
-            if (member.kind === "state") {
-                (slot ?? this.#slot(member.name)).hydrate(member.sequence, member.ops, context);
-            }
-            else {
-                slot?.setDescription(member.kind);
-            }
-        }
-    }
-    update(member, sequence, ops, context) {
-        if (this.#descriptions.get(member) !== "state") {
-            throw new Error(`Remote service update targets non-state member ${this.#serviceId}.${member}`);
-        }
-        this.#slot(member).update(sequence, ops, context);
-    }
-    clear() {
-        for (const slot of this.#slots.values())
-            slot.clear();
-    }
-    #slot(member) {
-        let slot = this.#slots.get(member);
-        if (slot !== undefined)
-            return slot;
-        slot = new MemberSlot(this.#serviceId, member, (args, context) => this.#transport.invoke({
-            serviceId: this.#serviceId,
-            ...(this.#address === undefined ? {} : { instance: this.#address }),
-            member,
-            args,
-        }, context), this.#isActive, this.#assertAccess, this.#reportError);
-        const kind = this.#descriptions.get(member);
-        if (kind !== undefined)
-            slot.setDescription(kind);
-        this.#slots.set(member, slot);
-        return slot;
-    }
-}
-class KeyedBinding {
-    #service;
-    #transport;
-    #reportError;
-    #assertAccess;
-    #onEmpty;
-    #instances;
-    #subscription;
-    #starting;
-    #closed = false;
-    #bound;
-    #revision = 0;
-    constructor(service, transport, reportError, assertAccess, onEmpty, bound) {
-        this.#service = service;
-        this.#transport = transport;
-        this.#reportError = reportError;
-        this.#assertAccess = assertAccess;
-        this.#onEmpty = onEmpty;
-        this.#bound = bound;
-        this.#instances = new InstanceDirectory({ ready: false, onError: reportError });
-    }
-    observe(handler) {
-        if (this.#closed)
-            throw new Error("Remote keyed service binding is closed");
-        let stopped = false;
-        const stop = this.#instances.observe((service, context) => {
-            const slot = new ServiceSlot(this.#service.id, true);
-            void slot.bind(service);
-            return handler(slot.view(() => {
-                this.#assertAccess();
-                if (stopped || context.abortSignal?.aborted) {
-                    throw new RemoteServiceError("service_stale_instance", `Remote service ${this.#service.id} observation is closed`);
-                }
-            }), context);
-        });
-        if (this.#bound && this.#starting === undefined) {
-            const revision = this.#revision;
-            const starting = this.#start(revision);
-            this.#starting = starting;
-            void starting.catch((error) => {
-                if (!this.#closed && this.#revision === revision && this.#bound)
-                    this.#reportError(toError(error));
-            });
-        }
-        return () => {
-            if (stopped)
-                return;
-            stopped = true;
-            stop();
-            if (this.#instances.observerCount === 0)
-                this.#onEmpty();
-        };
-    }
-    async rebind(bound, context) {
-        if (this.#closed)
-            return;
-        this.#bound = bound;
-        const revision = ++this.#revision;
-        await this.#reset(context, false);
-        if (this.#closed || this.#revision !== revision || this.#bound !== bound)
-            return;
-        if (bound && this.#instances.observerCount > 0) {
-            const starting = this.#start(revision);
-            this.#starting = starting;
-            await starting;
-        }
-    }
-    ready() {
-        return this.#starting ?? Promise.resolve();
-    }
-    async close(context) {
-        if (this.#closed)
-            return;
-        this.#closed = true;
-        this.#revision += 1;
-        await this.#reset(context, true);
-        this.#instances.dispose();
-    }
-    async #reset(context, waitForStarting) {
-        this.#instances.reset();
-        const starting = this.#starting;
-        this.#starting = undefined;
-        const subscription = this.#subscription;
-        this.#subscription = undefined;
-        await Promise.all([
-            waitForStarting ? starting?.catch(() => { }) : undefined,
-            subscription === undefined ? undefined : subscription.close(context),
-        ]);
-    }
-    async #start(revision) {
-        const subscription = await this.#transport.subscribe(this.#service.id, "keyed", (update, context) => {
-            if (this.#revision === revision)
-                this.#update(update, context);
-        }, BACKGROUND_CONTEXT);
-        if (this.#closed || !this.#bound || this.#revision !== revision) {
-            await subscription.close(BACKGROUND_CONTEXT);
-            return;
-        }
-        this.#subscription = subscription;
-        if (subscription.snapshot.mode !== "keyed" || subscription.snapshot.serviceId !== this.#service.id) {
-            throw new Error(`Remote service ${this.#service.id} returned the wrong keyed snapshot`);
-        }
-        for (const snapshot of subscription.snapshot.instances)
-            this.#spawn(snapshot, serviceDeliveryContext());
-        subscription.activate();
-        this.#instances.ready();
-    }
-    #update(update, context) {
-        if (this.#closed)
-            return;
-        try {
-            switch (update.type) {
-                case "reset": {
-                    validateResetSnapshot(update.snapshot, this.#service.id, "keyed");
-                    const snapshots = new Map(update.snapshot.instances.map((snapshot) => [snapshot.instance.key, snapshot]));
-                    for (const instance of [...this.#instances.values()]) {
-                        if (snapshots.get(instance.key)?.instance?.generation !== instance.generation) {
-                            this.#instances.remove(instance);
-                        }
-                    }
-                    for (const snapshot of snapshots.values()) {
-                        const instance = this.#instances.get(snapshot.instance.key);
-                        if (instance === undefined)
-                            this.#spawn(snapshot, context);
-                        else
-                            instance.facade.install(snapshot, context);
-                    }
-                    break;
-                }
-                case "unavailable":
-                case "replaced":
-                    throw new Error("Keyed service received a singleton lifecycle update");
-                case "spawned":
-                    this.#spawn(update.instance, context);
-                    break;
-                case "closed": {
-                    const instance = this.#instances.get(update.instance.key);
-                    if (instance?.generation === update.instance.generation)
-                        this.#instances.remove(instance);
-                    break;
-                }
-                case "state": {
-                    if (update.instance === undefined)
-                        throw new Error("Keyed state update has no instance address");
-                    const instance = this.#instances.get(update.instance.key);
-                    if (instance?.generation !== update.instance.generation)
-                        return;
-                    instance.facade.update(update.member, update.sequence, update.ops, context);
-                    break;
-                }
-            }
-        }
-        catch (error) {
-            this.#reportError(toError(error));
-        }
-    }
-    #spawn(snapshot, context) {
-        const address = snapshot.instance;
-        if (address === undefined)
-            throw new Error("Keyed service instance snapshot has no address");
-        let active = true;
-        const facade = new ServiceFacade(this.#service.id, address, this.#transport, () => active && !this.#closed, this.#assertAccess, this.#reportError);
-        facade.install(snapshot, context);
-        this.#instances.replace({
-            key: address.key,
-            generation: address.generation,
-            service: facade.proxy,
-            facade,
-            deactivate: () => {
-                active = false;
-                facade.clear();
-            },
-        });
-    }
-}
-export class RemoteServiceBindingImpl {
-    #transport;
-    #allowlist = new Set();
-    #reportError;
-    #modes = new Map();
-    #assertAccess;
-    #singletons = new Map();
-    #keyed = new Map();
-    #bound;
-    #readinessRevision = 0;
-    #bindingTransition = Promise.resolve();
-    #disposed = false;
-    constructor(options) {
-        this.#transport = options.transport;
-        const ids = options.services.map(({ id }) => id);
-        if (new Set(ids).size !== ids.length)
-            throw new TypeError("Remote service binding has duplicate service IDs");
-        for (const id of ids)
-            this.#allowlist.add(id);
-        this.#reportError = options.onError ?? (() => { });
-        this.#assertAccess = options.assertAccess ?? (() => { });
-        this.#bound = options.bound ?? true;
-    }
-    use(service) {
-        this.#assertRemotable(service);
-        this.#assertAvailable(service.id, "singleton");
-        let binding = this.#singletons.get(service.id);
-        if (binding !== undefined)
-            return binding.facade.proxy;
-        binding = { facade: undefined, active: true, revision: 0 };
-        binding.facade = new ServiceFacade(service.id, undefined, this.#transport, () => binding.active && !this.#disposed && this.#bound, () => this.#assertHandleAccess(), this.#reportError);
-        this.#singletons.set(service.id, binding);
-        this.#readinessRevision += 1;
-        if (this.#bound) {
-            const revision = binding.revision;
-            const starting = this.#startSingleton(service.id, binding, revision);
-            binding.starting = starting;
-            void starting.catch((error) => {
-                if (binding.active && binding.revision === revision && !this.#disposed && this.#bound) {
-                    this.#reportError(toError(error));
-                }
-            });
-        }
-        return binding.facade.proxy;
-    }
-    observe(service, handler) {
-        this.#assertRemotable(service);
-        this.#assertAvailable(service.id, "keyed");
-        let binding = this.#keyed.get(service.id);
-        if (binding === undefined) {
-            binding = new KeyedBinding(service, this.#transport, this.#reportError, () => this.#assertHandleAccess(), () => {
-                if (this.#keyed.get(service.id) !== binding)
-                    return;
-                this.#keyed.delete(service.id);
-                this.#readinessRevision += 1;
-                void binding.close(BACKGROUND_CONTEXT).catch(this.#reportError);
-            }, this.#bound);
-            this.#keyed.set(service.id, binding);
-            this.#readinessRevision += 1;
-        }
-        return binding.observe(handler);
-    }
-    async ready(context) {
-        if (this.#disposed)
-            throw new Error("Remote service binding is disposed");
-        while (true) {
-            const revision = this.#readinessRevision;
-            const starts = [
-                this.#bindingTransition,
-                ...[...this.#singletons.values()].flatMap((binding) => binding.starting === undefined ? [] : [binding.starting]),
-                ...[...this.#keyed.values()].map((binding) => binding.ready()),
-            ];
-            await awaitWithContext(Promise.all(starts).then(() => undefined), context);
-            if (this.#disposed)
-                throw new Error("Remote service binding is disposed");
-            if (revision === this.#readinessRevision)
-                return;
-        }
-    }
-    async rebind(bound, context) {
-        if (this.#disposed)
-            throw new Error("Remote service binding is disposed");
-        this.#bound = bound;
-        this.#readinessRevision += 1;
-        const transitions = [];
-        for (const [serviceId, binding] of this.#singletons) {
-            binding.revision += 1;
-            binding.facade.clear();
-            const subscription = binding.subscription;
-            delete binding.subscription;
-            const revision = binding.revision;
-            const starting = (async () => {
-                await subscription?.close(context);
-                if (bound)
-                    await this.#startSingleton(serviceId, binding, revision);
-            })();
-            binding.starting = starting;
-            transitions.push(starting);
-        }
-        for (const binding of this.#keyed.values())
-            transitions.push(binding.rebind(bound, context));
-        const completion = (async () => {
-            const results = await Promise.allSettled(transitions);
-            const errors = results.filter((result) => result.status === "rejected");
-            if (errors.length > 0)
-                throw new AggregateError(errors.map(({ reason }) => reason), "Failed to rebind services");
-        })();
-        this.#bindingTransition = completion;
-        await completion;
-    }
-    async dispose(context) {
-        if (this.#disposed)
-            return;
-        this.#disposed = true;
-        const closes = [];
-        for (const binding of this.#singletons.values()) {
-            binding.active = false;
-            binding.facade.clear();
-            if (binding.starting)
-                closes.push(binding.starting.catch(() => { }));
-            if (binding.subscription)
-                closes.push(Promise.resolve(binding.subscription.close(context)));
-        }
-        for (const binding of this.#keyed.values())
-            closes.push(binding.close(context));
-        this.#singletons.clear();
-        this.#keyed.clear();
-        const results = await Promise.allSettled(closes);
-        const errors = results.filter((result) => result.status === "rejected");
-        if (errors.length > 0)
-            throw new AggregateError(errors.map(({ reason }) => reason), "Failed to dispose services");
-    }
-    async #startSingleton(serviceId, binding, revision) {
-        const subscription = await this.#transport.subscribe(serviceId, "singleton", (update, context) => {
-            if (!binding.active || binding.revision !== revision)
-                return;
-            try {
-                if (update.type === "reset") {
-                    validateResetSnapshot(update.snapshot, serviceId, "singleton");
-                    const snapshot = update.snapshot.instances[0];
-                    if (snapshot === undefined)
-                        binding.facade.clear();
-                    else
-                        binding.facade.install(snapshot, context);
-                }
-                else if (update.type === "unavailable") {
-                    binding.facade.clear();
-                }
-                else if (update.type === "replaced") {
-                    if (update.snapshot.instance !== undefined) {
-                        throw new Error("Singleton replacement has an instance address");
-                    }
-                    binding.facade.install(update.snapshot, context);
-                }
-                else if (update.type === "state" && update.instance === undefined) {
-                    binding.facade.update(update.member, update.sequence, update.ops, context);
-                }
-            }
-            catch (error) {
-                this.#reportError(toError(error));
-            }
-        }, BACKGROUND_CONTEXT);
-        if (!binding.active || this.#disposed || !this.#bound || binding.revision !== revision) {
-            await subscription.close(BACKGROUND_CONTEXT);
-            return;
-        }
-        binding.subscription = subscription;
-        const snapshot = subscription.snapshot;
-        if (snapshot.mode !== "singleton" || snapshot.serviceId !== serviceId || snapshot.instances.length !== 1) {
-            throw new Error(`Remote service ${serviceId} returned an invalid singleton snapshot`);
-        }
-        binding.facade.install(snapshot.instances[0], serviceDeliveryContext());
-        subscription.activate();
-    }
-    #assertHandleAccess() {
-        if (this.#disposed)
-            throw new Error("Remote service binding is disposed");
-        this.#assertAccess();
-    }
-    #assertRemotable(service) {
-        if (service.local)
-            throw new RemoteServiceError("service_not_allowed", `Service ${service.id} is process-local`);
-    }
-    #assertAvailable(serviceId, mode) {
-        if (this.#disposed)
-            throw new Error("Remote service binding is disposed");
-        if (!this.#allowlist.has(serviceId)) {
-            throw new RemoteServiceError("service_not_allowed", `Remote service ${serviceId} is not allowlisted`);
-        }
-        const existing = this.#modes.get(serviceId);
-        if (existing !== undefined && existing !== mode) {
-            throw new RemoteServiceError("service_mode_mismatch", `Remote service ${serviceId} is already used as ${existing}`);
-        }
-        this.#modes.set(serviceId, mode);
-    }
-}
-function validateResetSnapshot(snapshot, serviceId, mode) {
-    if (snapshot.serviceId !== serviceId ||
-        snapshot.mode !== mode ||
-        (mode === "singleton" && snapshot.instances.length > 1)) {
-        throw new Error("Remote service reset has the wrong service or mode");
-    }
-    const keys = new Set();
-    for (const instance of snapshot.instances) {
-        if (mode === "singleton" ? instance.instance !== undefined : instance.instance === undefined) {
-            throw new Error("Remote service reset has an invalid instance address");
-        }
-        if (instance.instance !== undefined) {
-            if (keys.has(instance.instance.key))
-                throw new Error("Remote service reset repeats an instance key");
-            keys.add(instance.instance.key);
-        }
-        for (const member of instance.members) {
-            if (member.kind === "state" && (member.ops.length !== 1 || member.ops[0]?.[0] !== "r")) {
-                throw new Error("Remote service reset must contain full root replacements");
-            }
-        }
-    }
-}
-function validateMembers(members) {
-    const result = new Map();
-    for (const member of members) {
-        if (member.name.length === 0 || result.has(member.name)) {
-            throw new Error("Remote service has invalid member descriptions");
-        }
-        result.set(member.name, member);
-    }
-    return result;
-}
-function sameAddress(left, right) {
-    if (left === undefined || right === undefined)
-        return left === right;
-    return left.key === right.key && left.generation === right.generation;
-}
-function isContext(value) {
-    if (typeof value !== "object" || value === null)
-        return false;
-    const candidate = value;
-    return typeof candidate.value === "function" && typeof candidate.toString === "function";
-}
-function toError(error) {
-    return error instanceof Error ? error : new Error(String(error));
-}
-//# sourceMappingURL=consumer.js.map