@earendil-works/chord 0.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.d.ts","sourceRoot":"","sources":["../../src/services/consumer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,OAAO,EAEP,oBAAoB,EACpB,2BAA2B,EAE3B,OAAO,EAMP,MAAM,aAAa,CAAC;AA0ZrB,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;CA6DD","sourcesContent":["import { awaitWithContext, BACKGROUND_CONTEXT } from \"../context/index.ts\";\nimport type { Op } from \"../delta/index.ts\";\nimport type {\n\tContext,\n\tJsonValue,\n\tRemoteServiceBinding,\n\tRemoteServiceBindingOptions,\n\tRemoteServiceTransport,\n\tService,\n\tServiceInstanceAddress,\n\tServiceInstanceSnapshot,\n\tServiceMemberSnapshot,\n\tServiceProviderUpdate,\n\tServiceSubscription,\n} from \"../types.ts\";\nimport { RemoteServiceError } from \"./errors.ts\";\nimport { ServiceSlot } from \"./handle.ts\";\nimport { InstanceDirectory, type InstanceDirectoryEntry } from \"./instances.ts\";\nimport { ReplicatedStateReplica, serviceDeliveryContext } from \"./state.ts\";\n\ntype ErrorReporter = (error: Error) => void;\ntype ServiceMemberKind = ServiceMemberSnapshot[\"kind\"];\n\nclass MemberSlot {\n\treadonly #serviceId: string;\n\treadonly #member: string;\n\treadonly #invoke: (args: readonly JsonValue[], context: Context) => Promise<JsonValue | undefined>;\n\treadonly #state: ReplicatedStateReplica;\n\treadonly #isActive: () => boolean;\n\treadonly #assertAccess: () => void;\n\treadonly value: unknown;\n\t#kind: ServiceMemberKind | undefined;\n\t#expectedKind: ServiceMemberKind | undefined;\n\n\tconstructor(\n\t\tserviceId: string,\n\t\tmember: string,\n\t\tinvoke: (args: readonly JsonValue[], context: Context) => Promise<JsonValue | undefined>,\n\t\tisActive: () => boolean,\n\t\tassertAccess: () => void,\n\t\treportError: ErrorReporter,\n\t) {\n\t\tthis.#serviceId = serviceId;\n\t\tthis.#member = member;\n\t\tthis.#invoke = invoke;\n\t\tthis.#isActive = isActive;\n\t\tthis.#assertAccess = assertAccess;\n\t\tthis.#state = new ReplicatedStateReplica(reportError);\n\t\tconst callable = (): void => {};\n\t\tthis.value = new Proxy(callable, {\n\t\t\tapply: (_target, _thisArg, args) => this.#call(args),\n\t\t\tget: (_target, property) => {\n\t\t\t\tif (property === \"value\") {\n\t\t\t\t\tthis.#assertAccess();\n\t\t\t\t\tthis.#expect(\"state\");\n\t\t\t\t\treturn this.#state.value;\n\t\t\t\t}\n\t\t\t\tif (property === \"subscribe\") return this.#subscribe.bind(this);\n\t\t\t\tif (property === Symbol.toStringTag) return \"RemoteServiceMember\";\n\t\t\t\tif (property === \"then\") return undefined;\n\t\t\t\treturn undefined;\n\t\t\t},\n\t\t});\n\t}\n\n\tsetDescription(kind: ServiceMemberKind): void {\n\t\tif (this.#kind !== undefined && this.#kind !== kind) {\n\t\t\tthrow new Error(`Remote service member ${this.#serviceId}.${this.#member} changed kind`);\n\t\t}\n\t\tthis.#kind = kind;\n\t\tif (this.#expectedKind !== undefined && this.#expectedKind !== kind) {\n\t\t\tthrow new RemoteServiceError(\n\t\t\t\t\"service_member_mismatch\",\n\t\t\t\t`Remote service member ${this.#serviceId}.${this.#member} is ${kind}, not ${this.#expectedKind}`,\n\t\t\t);\n\t\t}\n\t}\n\n\thydrate(sequence: number, ops: readonly Op[], context: Context): void {\n\t\tthis.setDescription(\"state\");\n\t\tthis.#state.hydrate(sequence, ops, context);\n\t}\n\n\tupdate(sequence: number, ops: readonly Op[], context: Context): void {\n\t\tthis.setDescription(\"state\");\n\t\tthis.#state.update(sequence, ops, context);\n\t}\n\n\tclear(): void {\n\t\tthis.#state.clear();\n\t}\n\n\t#subscribe(listener: (value: JsonValue, context: Context) => void): () => void {\n\t\tthis.#assertAccess();\n\t\tif (typeof listener !== \"function\") {\n\t\t\tthrow new TypeError(\"Replicated state subscription listener must be a function\");\n\t\t}\n\t\tthis.#expect(\"state\");\n\t\treturn this.#state.subscribe(listener);\n\t}\n\n\t#expect(kind: ServiceMemberKind): void {\n\t\tif (this.#expectedKind !== undefined && this.#expectedKind !== kind) {\n\t\t\tthrow new RemoteServiceError(\n\t\t\t\t\"service_member_mismatch\",\n\t\t\t\t`Remote service member ${this.#serviceId}.${this.#member} was used as two different kinds`,\n\t\t\t);\n\t\t}\n\t\tthis.#expectedKind = kind;\n\t\tif (this.#kind !== undefined && this.#kind !== kind) {\n\t\t\tthrow new RemoteServiceError(\n\t\t\t\t\"service_member_mismatch\",\n\t\t\t\t`Remote service member ${this.#serviceId}.${this.#member} is ${this.#kind}, not ${kind}`,\n\t\t\t);\n\t\t}\n\t}\n\n\t#call(args: unknown[]): Promise<JsonValue | undefined> {\n\t\tthis.#assertAccess();\n\t\tthis.#expect(\"method\");\n\t\tif (!this.#isActive()) {\n\t\t\treturn Promise.reject(\n\t\t\t\tnew RemoteServiceError(\"service_stale_instance\", `Remote service ${this.#serviceId} binding is closed`),\n\t\t\t);\n\t\t}\n\t\tconst context = args.at(-1);\n\t\tif (!isContext(context)) {\n\t\t\treturn Promise.reject(\n\t\t\t\tnew RemoteServiceError(\n\t\t\t\t\t\"service_invalid_value\",\n\t\t\t\t\t`Remote service method ${this.#serviceId}.${this.#member} requires a trailing Context`,\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\t\tconst businessArgs = args.slice(0, -1) as JsonValue[];\n\t\treturn this.#invoke(businessArgs, context);\n\t}\n}\n\nclass ServiceFacade {\n\treadonly #serviceId: string;\n\treadonly #address: ServiceInstanceAddress | undefined;\n\treadonly #transport: RemoteServiceTransport;\n\treadonly #reportError: ErrorReporter;\n\treadonly #slots = new Map<string, MemberSlot>();\n\treadonly #descriptions = new Map<string, ServiceMemberKind>();\n\treadonly #isActive: () => boolean;\n\treadonly #assertAccess: () => void;\n\treadonly proxy: object;\n\n\tconstructor(\n\t\tserviceId: string,\n\t\taddress: ServiceInstanceAddress | undefined,\n\t\ttransport: RemoteServiceTransport,\n\t\tisActive: () => boolean,\n\t\tassertAccess: () => void,\n\t\treportError: ErrorReporter,\n\t) {\n\t\tthis.#serviceId = serviceId;\n\t\tthis.#address = address;\n\t\tthis.#transport = transport;\n\t\tthis.#isActive = isActive;\n\t\tthis.#assertAccess = assertAccess;\n\t\tthis.#reportError = reportError;\n\t\tthis.proxy = new Proxy(Object.create(null) as object, {\n\t\t\tget: (_target, property) => {\n\t\t\t\tif (typeof property !== \"string\") return undefined;\n\t\t\t\treturn this.#slot(property).value;\n\t\t\t},\n\t\t});\n\t}\n\n\tinstall(snapshot: ServiceInstanceSnapshot, context: Context): void {\n\t\tif (!sameAddress(snapshot.instance, this.#address))\n\t\t\tthrow new Error(\"Remote service snapshot has the wrong address\");\n\t\tconst members = validateMembers(snapshot.members);\n\t\tfor (const name of this.#slots.keys()) {\n\t\t\tif (!members.has(name)) {\n\t\t\t\tthrow new RemoteServiceError(\n\t\t\t\t\t\"service_member_not_found\",\n\t\t\t\t\t`Unknown remote service member ${this.#serviceId}.${name}`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tthis.#descriptions.clear();\n\t\tfor (const [name, member] of members) this.#descriptions.set(name, member.kind);\n\t\tfor (const member of members.values()) {\n\t\t\tconst slot = this.#slots.get(member.name);\n\t\t\tif (member.kind === \"state\") {\n\t\t\t\t(slot ?? this.#slot(member.name)).hydrate(member.sequence, member.ops, context);\n\t\t\t} else {\n\t\t\t\tslot?.setDescription(member.kind);\n\t\t\t}\n\t\t}\n\t}\n\n\tupdate(member: string, sequence: number, ops: readonly Op[], context: Context): void {\n\t\tif (this.#descriptions.get(member) !== \"state\") {\n\t\t\tthrow new Error(`Remote service update targets non-state member ${this.#serviceId}.${member}`);\n\t\t}\n\t\tthis.#slot(member).update(sequence, ops, context);\n\t}\n\n\tclear(): void {\n\t\tfor (const slot of this.#slots.values()) slot.clear();\n\t}\n\n\t#slot(member: string): MemberSlot {\n\t\tlet slot = this.#slots.get(member);\n\t\tif (slot !== undefined) return slot;\n\t\tslot = new MemberSlot(\n\t\t\tthis.#serviceId,\n\t\t\tmember,\n\t\t\t(args, context) =>\n\t\t\t\tthis.#transport.invoke(\n\t\t\t\t\t{\n\t\t\t\t\t\tserviceId: this.#serviceId,\n\t\t\t\t\t\t...(this.#address === undefined ? {} : { instance: this.#address }),\n\t\t\t\t\t\tmember,\n\t\t\t\t\t\targs,\n\t\t\t\t\t},\n\t\t\t\t\tcontext,\n\t\t\t\t),\n\t\t\tthis.#isActive,\n\t\t\tthis.#assertAccess,\n\t\t\tthis.#reportError,\n\t\t);\n\t\tconst kind = this.#descriptions.get(member);\n\t\tif (kind !== undefined) slot.setDescription(kind);\n\t\tthis.#slots.set(member, slot);\n\t\treturn slot;\n\t}\n}\n\ninterface SingletonBinding {\n\tfacade: ServiceFacade;\n\tsubscription?: ServiceSubscription;\n\tstarting?: Promise<void>;\n\tactive: boolean;\n\trevision: number;\n}\n\ninterface KeyedInstance extends InstanceDirectoryEntry {\n\treadonly facade: ServiceFacade;\n}\n\nclass KeyedBinding<T> {\n\treadonly #service: Service<T>;\n\treadonly #transport: RemoteServiceTransport;\n\treadonly #reportError: ErrorReporter;\n\treadonly #assertAccess: () => void;\n\treadonly #onEmpty: () => void;\n\treadonly #instances: InstanceDirectory<KeyedInstance>;\n\t#subscription: ServiceSubscription | undefined;\n\t#starting: Promise<void> | undefined;\n\t#closed = false;\n\t#bound: boolean;\n\t#revision = 0;\n\n\tconstructor(\n\t\tservice: Service<T>,\n\t\ttransport: RemoteServiceTransport,\n\t\treportError: ErrorReporter,\n\t\tassertAccess: () => void,\n\t\tonEmpty: () => void,\n\t\tbound: boolean,\n\t) {\n\t\tthis.#service = service;\n\t\tthis.#transport = transport;\n\t\tthis.#reportError = reportError;\n\t\tthis.#assertAccess = assertAccess;\n\t\tthis.#onEmpty = onEmpty;\n\t\tthis.#bound = bound;\n\t\tthis.#instances = new InstanceDirectory({ ready: false, onError: reportError });\n\t}\n\n\tobserve(handler: (service: T, context: Context) => void | Promise<void>): () => void {\n\t\tif (this.#closed) throw new Error(\"Remote keyed service binding is closed\");\n\t\tlet stopped = false;\n\t\tconst stop = this.#instances.observe<T>((service, context) => {\n\t\t\tconst slot = new ServiceSlot(this.#service.id, true);\n\t\t\tvoid slot.bind(service as object);\n\t\t\treturn handler(\n\t\t\t\tslot.view<T>(() => {\n\t\t\t\t\tthis.#assertAccess();\n\t\t\t\t\tif (stopped || context.abortSignal?.aborted) {\n\t\t\t\t\t\tthrow new RemoteServiceError(\n\t\t\t\t\t\t\t\"service_stale_instance\",\n\t\t\t\t\t\t\t`Remote service ${this.#service.id} observation is closed`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t\t\tcontext,\n\t\t\t);\n\t\t});\n\t\tif (this.#bound && this.#starting === undefined) {\n\t\t\tconst revision = this.#revision;\n\t\t\tconst starting = this.#start(revision);\n\t\t\tthis.#starting = starting;\n\t\t\tvoid starting.catch((error: unknown) => {\n\t\t\t\tif (!this.#closed && this.#revision === revision && this.#bound) this.#reportError(toError(error));\n\t\t\t});\n\t\t}\n\t\treturn () => {\n\t\t\tif (stopped) return;\n\t\t\tstopped = true;\n\t\t\tstop();\n\t\t\tif (this.#instances.observerCount === 0) this.#onEmpty();\n\t\t};\n\t}\n\n\tasync rebind(bound: boolean, context: Context): Promise<void> {\n\t\tif (this.#closed) return;\n\t\tthis.#bound = bound;\n\t\tconst revision = ++this.#revision;\n\t\tawait this.#reset(context, false);\n\t\tif (this.#closed || this.#revision !== revision || this.#bound !== bound) return;\n\t\tif (bound && this.#instances.observerCount > 0) {\n\t\t\tconst starting = this.#start(revision);\n\t\t\tthis.#starting = starting;\n\t\t\tawait starting;\n\t\t}\n\t}\n\n\tready(): Promise<void> {\n\t\treturn this.#starting ?? Promise.resolve();\n\t}\n\n\tasync close(context: Context): Promise<void> {\n\t\tif (this.#closed) return;\n\t\tthis.#closed = true;\n\t\tthis.#revision += 1;\n\t\tawait this.#reset(context, true);\n\t\tthis.#instances.dispose();\n\t}\n\n\tasync #reset(context: Context, waitForStarting: boolean): Promise<void> {\n\t\tthis.#instances.reset();\n\t\tconst starting = this.#starting;\n\t\tthis.#starting = undefined;\n\t\tconst subscription = this.#subscription;\n\t\tthis.#subscription = undefined;\n\t\tawait Promise.all([\n\t\t\twaitForStarting ? starting?.catch(() => {}) : undefined,\n\t\t\tsubscription === undefined ? undefined : subscription.close(context),\n\t\t]);\n\t}\n\n\tasync #start(revision: number): Promise<void> {\n\t\tconst subscription = await this.#transport.subscribe(\n\t\t\tthis.#service.id,\n\t\t\t\"keyed\",\n\t\t\t(update, context) => {\n\t\t\t\tif (this.#revision === revision) this.#update(update, context);\n\t\t\t},\n\t\t\tBACKGROUND_CONTEXT,\n\t\t);\n\t\tif (this.#closed || !this.#bound || this.#revision !== revision) {\n\t\t\tawait subscription.close(BACKGROUND_CONTEXT);\n\t\t\treturn;\n\t\t}\n\t\tthis.#subscription = subscription;\n\t\tif (subscription.snapshot.mode !== \"keyed\" || subscription.snapshot.serviceId !== this.#service.id) {\n\t\t\tthrow new Error(`Remote service ${this.#service.id} returned the wrong keyed snapshot`);\n\t\t}\n\t\tfor (const snapshot of subscription.snapshot.instances) this.#spawn(snapshot, serviceDeliveryContext());\n\t\tsubscription.activate();\n\t\tthis.#instances.ready();\n\t}\n\n\t#update(update: ServiceProviderUpdate, context: Context): void {\n\t\tif (this.#closed) return;\n\t\ttry {\n\t\t\tswitch (update.type) {\n\t\t\t\tcase \"unavailable\":\n\t\t\t\tcase \"replaced\":\n\t\t\t\t\tthrow new Error(\"Keyed service received a singleton lifecycle update\");\n\t\t\t\tcase \"spawned\":\n\t\t\t\t\tthis.#spawn(update.instance, context);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"closed\": {\n\t\t\t\t\tconst instance = this.#instances.get(update.instance.key);\n\t\t\t\t\tif (instance?.generation === update.instance.generation) this.#instances.remove(instance);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tcase \"state\": {\n\t\t\t\t\tif (update.instance === undefined) throw new Error(\"Keyed state update has no instance address\");\n\t\t\t\t\tconst instance = this.#instances.get(update.instance.key);\n\t\t\t\t\tif (instance?.generation !== update.instance.generation) return;\n\t\t\t\t\tinstance.facade.update(update.member, update.sequence, update.ops, context);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tthis.#reportError(toError(error));\n\t\t}\n\t}\n\n\t#spawn(snapshot: ServiceInstanceSnapshot, context: Context): void {\n\t\tconst address = snapshot.instance;\n\t\tif (address === undefined) throw new Error(\"Keyed service instance snapshot has no address\");\n\t\tlet active = true;\n\t\tconst facade = new ServiceFacade(\n\t\t\tthis.#service.id,\n\t\t\taddress,\n\t\t\tthis.#transport,\n\t\t\t() => active && !this.#closed,\n\t\t\tthis.#assertAccess,\n\t\t\tthis.#reportError,\n\t\t);\n\t\tfacade.install(snapshot, context);\n\t\tthis.#instances.replace({\n\t\t\tkey: address.key,\n\t\t\tgeneration: address.generation,\n\t\t\tservice: facade.proxy,\n\t\t\tfacade,\n\t\t\tdeactivate: () => {\n\t\t\t\tactive = false;\n\t\t\t\tfacade.clear();\n\t\t\t},\n\t\t});\n\t}\n}\n\nexport class RemoteServiceBindingImpl implements RemoteServiceBinding {\n\treadonly #transport: RemoteServiceTransport;\n\treadonly #allowlist = new Set<string>();\n\treadonly #reportError: ErrorReporter;\n\treadonly #modes = new Map<string, \"singleton\" | \"keyed\">();\n\treadonly #assertAccess: () => void;\n\treadonly #singletons = new Map<string, SingletonBinding>();\n\treadonly #keyed = new Map<string, KeyedBinding<unknown>>();\n\t#bound: boolean;\n\t#readinessRevision = 0;\n\t#bindingTransition = Promise.resolve();\n\t#disposed = false;\n\n\tconstructor(options: RemoteServiceBindingOptions) {\n\t\tthis.#transport = options.transport;\n\t\tconst ids = options.services.map(({ id }) => id);\n\t\tif (new Set(ids).size !== ids.length) throw new TypeError(\"Remote service binding has duplicate service IDs\");\n\t\tfor (const id of ids) this.#allowlist.add(id);\n\t\tthis.#reportError = options.onError ?? (() => {});\n\t\tthis.#assertAccess = options.assertAccess ?? (() => {});\n\t\tthis.#bound = options.bound ?? true;\n\t}\n\n\tuse<T>(service: Service<T>): T {\n\t\tthis.#assertRemotable(service);\n\t\tthis.#assertAvailable(service.id, \"singleton\");\n\t\tlet binding = this.#singletons.get(service.id);\n\t\tif (binding !== undefined) return binding.facade.proxy as T;\n\t\tbinding = { facade: undefined as unknown as ServiceFacade, active: true, revision: 0 };\n\t\tbinding.facade = new ServiceFacade(\n\t\t\tservice.id,\n\t\t\tundefined,\n\t\t\tthis.#transport,\n\t\t\t() => binding!.active && !this.#disposed && this.#bound,\n\t\t\t() => this.#assertHandleAccess(),\n\t\t\tthis.#reportError,\n\t\t);\n\t\tthis.#singletons.set(service.id, binding);\n\t\tthis.#readinessRevision += 1;\n\t\tif (this.#bound) {\n\t\t\tconst revision = binding.revision;\n\t\t\tconst starting = this.#startSingleton(service.id, binding, revision);\n\t\t\tbinding.starting = starting;\n\t\t\tvoid starting.catch((error: unknown) => {\n\t\t\t\tif (binding.active && binding.revision === revision && !this.#disposed && this.#bound) {\n\t\t\t\t\tthis.#reportError(toError(error));\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t\treturn binding.facade.proxy as T;\n\t}\n\n\tobserve<T>(service: Service<T>, handler: (service: T, context: Context) => void | Promise<void>): () => void {\n\t\tthis.#assertRemotable(service);\n\t\tthis.#assertAvailable(service.id, \"keyed\");\n\t\tlet binding = this.#keyed.get(service.id) as KeyedBinding<T> | undefined;\n\t\tif (binding === undefined) {\n\t\t\tbinding = new KeyedBinding(\n\t\t\t\tservice,\n\t\t\t\tthis.#transport,\n\t\t\t\tthis.#reportError,\n\t\t\t\t() => this.#assertHandleAccess(),\n\t\t\t\t() => {\n\t\t\t\t\tif (this.#keyed.get(service.id) !== binding) return;\n\t\t\t\t\tthis.#keyed.delete(service.id);\n\t\t\t\t\tthis.#readinessRevision += 1;\n\t\t\t\t\tvoid binding!.close(BACKGROUND_CONTEXT).catch(this.#reportError);\n\t\t\t\t},\n\t\t\t\tthis.#bound,\n\t\t\t);\n\t\t\tthis.#keyed.set(service.id, binding as KeyedBinding<unknown>);\n\t\t\tthis.#readinessRevision += 1;\n\t\t}\n\t\treturn binding.observe(handler);\n\t}\n\n\tasync ready(context: Context): Promise<void> {\n\t\tif (this.#disposed) throw new Error(\"Remote service binding is disposed\");\n\t\twhile (true) {\n\t\t\tconst revision = this.#readinessRevision;\n\t\t\tconst starts = [\n\t\t\t\tthis.#bindingTransition,\n\t\t\t\t...[...this.#singletons.values()].flatMap((binding) =>\n\t\t\t\t\tbinding.starting === undefined ? [] : [binding.starting],\n\t\t\t\t),\n\t\t\t\t...[...this.#keyed.values()].map((binding) => binding.ready()),\n\t\t\t];\n\t\t\tawait awaitWithContext(\n\t\t\t\tPromise.all(starts).then(() => undefined),\n\t\t\t\tcontext,\n\t\t\t);\n\t\t\tif (this.#disposed) throw new Error(\"Remote service binding is disposed\");\n\t\t\tif (revision === this.#readinessRevision) return;\n\t\t}\n\t}\n\n\tasync rebind(bound: boolean, context: Context): Promise<void> {\n\t\tif (this.#disposed) throw new Error(\"Remote service binding is disposed\");\n\t\tthis.#bound = bound;\n\t\tthis.#readinessRevision += 1;\n\t\tconst transitions: Promise<void>[] = [];\n\t\tfor (const [serviceId, binding] of this.#singletons) {\n\t\t\tbinding.revision += 1;\n\t\t\tbinding.facade.clear();\n\t\t\tconst subscription = binding.subscription;\n\t\t\tdelete binding.subscription;\n\t\t\tconst revision = binding.revision;\n\t\t\tconst starting = (async () => {\n\t\t\t\tawait subscription?.close(context);\n\t\t\t\tif (bound) await this.#startSingleton(serviceId, binding, revision);\n\t\t\t})();\n\t\t\tbinding.starting = starting;\n\t\t\ttransitions.push(starting);\n\t\t}\n\t\tfor (const binding of this.#keyed.values()) transitions.push(binding.rebind(bound, context));\n\t\tconst completion = (async () => {\n\t\t\tconst results = await Promise.allSettled(transitions);\n\t\t\tconst errors = results.filter((result): result is PromiseRejectedResult => result.status === \"rejected\");\n\t\t\tif (errors.length > 0)\n\t\t\t\tthrow new AggregateError(\n\t\t\t\t\terrors.map(({ reason }) => reason),\n\t\t\t\t\t\"Failed to rebind services\",\n\t\t\t\t);\n\t\t})();\n\t\tthis.#bindingTransition = completion;\n\t\tawait completion;\n\t}\n\n\tasync dispose(context: Context): Promise<void> {\n\t\tif (this.#disposed) return;\n\t\tthis.#disposed = true;\n\t\tconst closes: Promise<void>[] = [];\n\t\tfor (const binding of this.#singletons.values()) {\n\t\t\tbinding.active = false;\n\t\t\tbinding.facade.clear();\n\t\t\tif (binding.starting) closes.push(binding.starting.catch(() => {}));\n\t\t\tif (binding.subscription) closes.push(Promise.resolve(binding.subscription.close(context)));\n\t\t}\n\t\tfor (const binding of this.#keyed.values()) closes.push(binding.close(context));\n\t\tthis.#singletons.clear();\n\t\tthis.#keyed.clear();\n\t\tconst results = await Promise.allSettled(closes);\n\t\tconst errors = results.filter((result): result is PromiseRejectedResult => result.status === \"rejected\");\n\t\tif (errors.length > 0)\n\t\t\tthrow new AggregateError(\n\t\t\t\terrors.map(({ reason }) => reason),\n\t\t\t\t\"Failed to dispose services\",\n\t\t\t);\n\t}\n\n\tasync #startSingleton(serviceId: string, binding: SingletonBinding, revision: number): Promise<void> {\n\t\tconst subscription = await this.#transport.subscribe(\n\t\t\tserviceId,\n\t\t\t\"singleton\",\n\t\t\t(update, context) => {\n\t\t\t\tif (!binding.active || binding.revision !== revision) return;\n\t\t\t\ttry {\n\t\t\t\t\tif (update.type === \"unavailable\") {\n\t\t\t\t\t\tbinding.facade.clear();\n\t\t\t\t\t} else if (update.type === \"replaced\") {\n\t\t\t\t\t\tif (update.snapshot.instance !== undefined) {\n\t\t\t\t\t\t\tthrow new Error(\"Singleton replacement has an instance address\");\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbinding.facade.install(update.snapshot, context);\n\t\t\t\t\t} else if (update.type === \"state\" && update.instance === undefined) {\n\t\t\t\t\t\tbinding.facade.update(update.member, update.sequence, update.ops, context);\n\t\t\t\t\t}\n\t\t\t\t} catch (error) {\n\t\t\t\t\tthis.#reportError(toError(error));\n\t\t\t\t}\n\t\t\t},\n\t\t\tBACKGROUND_CONTEXT,\n\t\t);\n\t\tif (!binding.active || this.#disposed || !this.#bound || binding.revision !== revision) {\n\t\t\tawait subscription.close(BACKGROUND_CONTEXT);\n\t\t\treturn;\n\t\t}\n\t\tbinding.subscription = subscription;\n\t\tconst snapshot = subscription.snapshot;\n\t\tif (snapshot.mode !== \"singleton\" || snapshot.serviceId !== serviceId || snapshot.instances.length !== 1) {\n\t\t\tthrow new Error(`Remote service ${serviceId} returned an invalid singleton snapshot`);\n\t\t}\n\t\tbinding.facade.install(snapshot.instances[0]!, serviceDeliveryContext());\n\t\tsubscription.activate();\n\t}\n\n\t#assertHandleAccess(): void {\n\t\tif (this.#disposed) throw new Error(\"Remote service binding is disposed\");\n\t\tthis.#assertAccess();\n\t}\n\n\t#assertRemotable(service: { readonly id: string; readonly local: boolean }): void {\n\t\tif (service.local) throw new RemoteServiceError(\"service_not_allowed\", `Service ${service.id} is process-local`);\n\t}\n\n\t#assertAvailable(serviceId: string, mode: \"singleton\" | \"keyed\"): void {\n\t\tif (this.#disposed) throw new Error(\"Remote service binding is disposed\");\n\t\tif (!this.#allowlist.has(serviceId)) {\n\t\t\tthrow new RemoteServiceError(\"service_not_allowed\", `Remote service ${serviceId} is not allowlisted`);\n\t\t}\n\t\tconst existing = this.#modes.get(serviceId);\n\t\tif (existing !== undefined && existing !== mode) {\n\t\t\tthrow new RemoteServiceError(\n\t\t\t\t\"service_mode_mismatch\",\n\t\t\t\t`Remote service ${serviceId} is already used as ${existing}`,\n\t\t\t);\n\t\t}\n\t\tthis.#modes.set(serviceId, mode);\n\t}\n}\n\nfunction validateMembers(members: readonly ServiceMemberSnapshot[]): ReadonlyMap<string, ServiceMemberSnapshot> {\n\tconst result = new Map<string, ServiceMemberSnapshot>();\n\tfor (const member of members) {\n\t\tif (member.name.length === 0 || result.has(member.name)) {\n\t\t\tthrow new Error(\"Remote service has invalid member descriptions\");\n\t\t}\n\t\tresult.set(member.name, member);\n\t}\n\treturn result;\n}\n\nfunction sameAddress(left: ServiceInstanceAddress | undefined, right: ServiceInstanceAddress | undefined): boolean {\n\tif (left === undefined || right === undefined) return left === right;\n\treturn left.key === right.key && left.generation === right.generation;\n}\n\nfunction isContext(value: unknown): value is Context {\n\tif (typeof value !== \"object\" || value === null) return false;\n\tconst candidate = value as Partial<Context>;\n\treturn typeof candidate.value === \"function\" && typeof candidate.toString === \"function\";\n}\n\nfunction toError(error: unknown): Error {\n\treturn error instanceof Error ? error : new Error(String(error));\n}\n"]}

package/dist/services/consumer.js

@@ -0,0 +1,537 @@
+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 "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 === "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 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