@ny4n/chord 0.0.0-stage → 1.0.1

package/dist/services/state-codec.js

@@ -0,0 +1,133 @@
+import { decoder, encoder } from "../delta/index.js";
+class StateCodecRegistry {
+    #create;
+    #entries = new Map();
+    constructor(create) {
+        this.#create = create;
+    }
+    reset() {
+        this.#entries.clear();
+    }
+    add(instance, member) {
+        const key = stateKey(instance, member);
+        if (this.#entries.has(key))
+            throw new Error(`Duplicate service state ${describeState(instance, member)}`);
+        const codec = this.#create();
+        this.#entries.set(key, { instance, codec });
+        return codec;
+    }
+    get(instance, member) {
+        const codec = this.#entries.get(stateKey(instance, member))?.codec;
+        if (codec === undefined)
+            throw new Error(`Unknown service state ${describeState(instance, member)}`);
+        return codec;
+    }
+    removeInstance(instance) {
+        for (const [key, entry] of this.#entries) {
+            if (sameAddress(entry.instance, instance))
+                this.#entries.delete(key);
+        }
+    }
+}
+export function createServiceStateEncoder() {
+    const codecs = new StateCodecRegistry(encoder);
+    return {
+        encodeSnapshot(snapshot) {
+            codecs.reset();
+            return {
+                ...snapshot,
+                instances: snapshot.instances.map((instance) => encodeInstance(instance, codecs)),
+            };
+        },
+        encodeUpdate(update) {
+            switch (update.type) {
+                case "reset":
+                    codecs.reset();
+                    return {
+                        ...update,
+                        snapshot: {
+                            ...update.snapshot,
+                            instances: update.snapshot.instances.map((instance) => encodeInstance(instance, codecs)),
+                        },
+                    };
+                case "state":
+                    return { ...update, ops: codecs.get(update.instance, update.member).encode(update.ops) };
+                case "replaced":
+                    codecs.reset();
+                    return { ...update, snapshot: encodeInstance(update.snapshot, codecs) };
+                case "spawned":
+                    return { ...update, instance: encodeInstance(update.instance, codecs) };
+                case "unavailable":
+                    codecs.reset();
+                    return update;
+                case "closed":
+                    codecs.removeInstance(update.instance);
+                    return update;
+            }
+        },
+    };
+}
+export function createServiceStateDecoder() {
+    const codecs = new StateCodecRegistry(decoder);
+    return {
+        decodeSnapshot(snapshot) {
+            codecs.reset();
+            return {
+                ...snapshot,
+                instances: snapshot.instances.map((instance) => decodeInstance(instance, codecs)),
+            };
+        },
+        decodeUpdate(update) {
+            switch (update.type) {
+                case "reset":
+                    codecs.reset();
+                    return {
+                        ...update,
+                        snapshot: {
+                            ...update.snapshot,
+                            instances: update.snapshot.instances.map((instance) => decodeInstance(instance, codecs)),
+                        },
+                    };
+                case "state":
+                    return { ...update, ops: codecs.get(update.instance, update.member).decode(update.ops) };
+                case "replaced":
+                    codecs.reset();
+                    return { ...update, snapshot: decodeInstance(update.snapshot, codecs) };
+                case "spawned":
+                    return { ...update, instance: decodeInstance(update.instance, codecs) };
+                case "unavailable":
+                    codecs.reset();
+                    return update;
+                case "closed":
+                    codecs.removeInstance(update.instance);
+                    return update;
+            }
+        },
+    };
+}
+function encodeInstance(instance, codecs) {
+    return {
+        ...instance,
+        members: instance.members.map((member) => member.kind === "state"
+            ? { ...member, ops: codecs.add(instance.instance, member.name).encode(member.ops) }
+            : member),
+    };
+}
+function decodeInstance(instance, codecs) {
+    return {
+        ...instance,
+        members: instance.members.map((member) => member.kind === "state"
+            ? { ...member, ops: codecs.add(instance.instance, member.name).decode(member.ops) }
+            : member),
+    };
+}
+function stateKey(instance, member) {
+    return JSON.stringify([instance?.key ?? null, instance?.generation ?? null, member]);
+}
+function sameAddress(left, right) {
+    return left?.key === right.key && left.generation === right.generation;
+}
+function describeState(instance, member) {
+    return instance === undefined ? member : `${instance.key}@${instance.generation}.${member}`;
+}
+//# sourceMappingURL=state-codec.js.map

package/dist/services/state-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-codec.js","sourceRoot":"","sources":["../../src/services/state-codec.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Decoder, decoder, type Encoder, encoder } from \"../delta/index.ts\";\nimport type {\n\tServiceInstanceAddress,\n\tServiceInstanceSnapshot,\n\tServiceProviderUpdate,\n\tServiceSubscriptionSnapshot,\n} from \"../types.ts\";\nimport type { WireServiceProviderUpdate, WireServiceSubscriptionSnapshot } from \"./wire.ts\";\n\n/** Stateful operation encoders for every replicated state in one service subscription. */\nexport interface ServiceStateEncoder {\n\tencodeSnapshot(snapshot: ServiceSubscriptionSnapshot): WireServiceSubscriptionSnapshot;\n\tencodeUpdate(update: ServiceProviderUpdate): WireServiceProviderUpdate;\n}\n\n/** Stateful operation decoders for every replicated state in one service subscription. */\nexport interface ServiceStateDecoder {\n\tdecodeSnapshot(snapshot: WireServiceSubscriptionSnapshot): ServiceSubscriptionSnapshot;\n\tdecodeUpdate(update: WireServiceProviderUpdate): ServiceProviderUpdate;\n}\n\ninterface CodecEntry<C> {\n\treadonly instance: ServiceInstanceAddress | undefined;\n\treadonly codec: C;\n}\n\nclass StateCodecRegistry<C> {\n\treadonly #create: () => C;\n\treadonly #entries = new Map<string, CodecEntry<C>>();\n\n\tconstructor(create: () => C) {\n\t\tthis.#create = create;\n\t}\n\n\treset(): void {\n\t\tthis.#entries.clear();\n\t}\n\n\tadd(instance: ServiceInstanceAddress | undefined, member: string): C {\n\t\tconst key = stateKey(instance, member);\n\t\tif (this.#entries.has(key)) throw new Error(`Duplicate service state ${describeState(instance, member)}`);\n\t\tconst codec = this.#create();\n\t\tthis.#entries.set(key, { instance, codec });\n\t\treturn codec;\n\t}\n\n\tget(instance: ServiceInstanceAddress | undefined, member: string): C {\n\t\tconst codec = this.#entries.get(stateKey(instance, member))?.codec;\n\t\tif (codec === undefined) throw new Error(`Unknown service state ${describeState(instance, member)}`);\n\t\treturn codec;\n\t}\n\n\tremoveInstance(instance: ServiceInstanceAddress): void {\n\t\tfor (const [key, entry] of this.#entries) {\n\t\t\tif (sameAddress(entry.instance, instance)) this.#entries.delete(key);\n\t\t}\n\t}\n}\n\nexport function createServiceStateEncoder(): ServiceStateEncoder {\n\tconst codecs = new StateCodecRegistry<Encoder>(encoder);\n\treturn {\n\t\tencodeSnapshot(snapshot) {\n\t\t\tcodecs.reset();\n\t\t\treturn {\n\t\t\t\t...snapshot,\n\t\t\t\tinstances: snapshot.instances.map((instance) => encodeInstance(instance, codecs)),\n\t\t\t};\n\t\t},\n\t\tencodeUpdate(update) {\n\t\t\tswitch (update.type) {\n\t\t\t\tcase \"reset\":\n\t\t\t\t\tcodecs.reset();\n\t\t\t\t\treturn {\n\t\t\t\t\t\t...update,\n\t\t\t\t\t\tsnapshot: {\n\t\t\t\t\t\t\t...update.snapshot,\n\t\t\t\t\t\t\tinstances: update.snapshot.instances.map((instance) => encodeInstance(instance, codecs)),\n\t\t\t\t\t\t},\n\t\t\t\t\t};\n\t\t\t\tcase \"state\":\n\t\t\t\t\treturn { ...update, ops: codecs.get(update.instance, update.member).encode(update.ops) };\n\t\t\t\tcase \"replaced\":\n\t\t\t\t\tcodecs.reset();\n\t\t\t\t\treturn { ...update, snapshot: encodeInstance(update.snapshot, codecs) };\n\t\t\t\tcase \"spawned\":\n\t\t\t\t\treturn { ...update, instance: encodeInstance(update.instance, codecs) };\n\t\t\t\tcase \"unavailable\":\n\t\t\t\t\tcodecs.reset();\n\t\t\t\t\treturn update;\n\t\t\t\tcase \"closed\":\n\t\t\t\t\tcodecs.removeInstance(update.instance);\n\t\t\t\t\treturn update;\n\t\t\t}\n\t\t},\n\t};\n}\n\nexport function createServiceStateDecoder(): ServiceStateDecoder {\n\tconst codecs = new StateCodecRegistry<Decoder>(decoder);\n\treturn {\n\t\tdecodeSnapshot(snapshot) {\n\t\t\tcodecs.reset();\n\t\t\treturn {\n\t\t\t\t...snapshot,\n\t\t\t\tinstances: snapshot.instances.map((instance) => decodeInstance(instance, codecs)),\n\t\t\t};\n\t\t},\n\t\tdecodeUpdate(update) {\n\t\t\tswitch (update.type) {\n\t\t\t\tcase \"reset\":\n\t\t\t\t\tcodecs.reset();\n\t\t\t\t\treturn {\n\t\t\t\t\t\t...update,\n\t\t\t\t\t\tsnapshot: {\n\t\t\t\t\t\t\t...update.snapshot,\n\t\t\t\t\t\t\tinstances: update.snapshot.instances.map((instance) => decodeInstance(instance, codecs)),\n\t\t\t\t\t\t},\n\t\t\t\t\t};\n\t\t\t\tcase \"state\":\n\t\t\t\t\treturn { ...update, ops: codecs.get(update.instance, update.member).decode(update.ops) };\n\t\t\t\tcase \"replaced\":\n\t\t\t\t\tcodecs.reset();\n\t\t\t\t\treturn { ...update, snapshot: decodeInstance(update.snapshot, codecs) };\n\t\t\t\tcase \"spawned\":\n\t\t\t\t\treturn { ...update, instance: decodeInstance(update.instance, codecs) };\n\t\t\t\tcase \"unavailable\":\n\t\t\t\t\tcodecs.reset();\n\t\t\t\t\treturn update;\n\t\t\t\tcase \"closed\":\n\t\t\t\t\tcodecs.removeInstance(update.instance);\n\t\t\t\t\treturn update;\n\t\t\t}\n\t\t},\n\t};\n}\n\nfunction encodeInstance(\n\tinstance: ServiceInstanceSnapshot,\n\tcodecs: StateCodecRegistry<Encoder>,\n): WireServiceSubscriptionSnapshot[\"instances\"][number] {\n\treturn {\n\t\t...instance,\n\t\tmembers: instance.members.map((member) =>\n\t\t\tmember.kind === \"state\"\n\t\t\t\t? { ...member, ops: codecs.add(instance.instance, member.name).encode(member.ops) }\n\t\t\t\t: member,\n\t\t),\n\t};\n}\n\nfunction decodeInstance(\n\tinstance: WireServiceSubscriptionSnapshot[\"instances\"][number],\n\tcodecs: StateCodecRegistry<Decoder>,\n): ServiceInstanceSnapshot {\n\treturn {\n\t\t...instance,\n\t\tmembers: instance.members.map((member) =>\n\t\t\tmember.kind === \"state\"\n\t\t\t\t? { ...member, ops: codecs.add(instance.instance, member.name).decode(member.ops) }\n\t\t\t\t: member,\n\t\t),\n\t};\n}\n\nfunction stateKey(instance: ServiceInstanceAddress | undefined, member: string): string {\n\treturn JSON.stringify([instance?.key ?? null, instance?.generation ?? null, member]);\n}\n\nfunction sameAddress(left: ServiceInstanceAddress | undefined, right: ServiceInstanceAddress): boolean {\n\treturn left?.key === right.key && left.generation === right.generation;\n}\n\nfunction describeState(instance: ServiceInstanceAddress | undefined, member: string): string {\n\treturn instance === undefined ? member : `${instance.key}@${instance.generation}.${member}`;\n}\n"]}

package/dist/services/state-internals.d.ts

@@ -0,0 +1,13 @@
+import type { Op } from "../delta/index.ts";
+import type { Context } from "../types.ts";
+export interface ReplicatedStateInternals {
+    /** Atomically capture the immutable value and its matching publication sequence. */
+    snapshot(): {
+        readonly value: unknown;
+        readonly sequence: number;
+    };
+    subscribe(listener: (ops: readonly Op[], sequence: number, context: Context) => void): () => void;
+}
+export declare function registerReplicatedStateInternals(value: object, internals: ReplicatedStateInternals): void;
+export declare function getReplicatedStateInternals(value: unknown): ReplicatedStateInternals | undefined;
+//# sourceMappingURL=state-internals.d.ts.map

package/dist/services/state-internals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-internals.d.ts","sourceRoot":"","sources":["../../src/services/state-internals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,wBAAwB;IACxC,oFAAoF;IACpF,QAAQ,IAAI;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAClG;AAID,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,wBAAwB,GAAG,IAAI,CAEzG;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,GAAG,SAAS,CAGhG"}

package/dist/services/state-internals.js

@@ -0,0 +1,10 @@
+const sources = new WeakMap();
+export function registerReplicatedStateInternals(value, internals) {
+    sources.set(value, internals);
+}
+export function getReplicatedStateInternals(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    return sources.get(value);
+}
+//# sourceMappingURL=state-internals.js.map

package/dist/services/state-internals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-internals.js","sourceRoot":"","sources":["../../src/services/state-internals.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,GAAG,IAAI,OAAO,EAAoC,CAAC;AAEhE,MAAM,UAAU,gCAAgC,CAAC,KAAa,EAAE,SAAmC;IAClG,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClE,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC","sourcesContent":["import type { Op } from \"../delta/index.ts\";\nimport type { Context } from \"../types.ts\";\n\nexport interface ReplicatedStateInternals {\n\t/** Atomically capture the immutable value and its matching publication sequence. */\n\tsnapshot(): { readonly value: unknown; readonly sequence: number };\n\tsubscribe(listener: (ops: readonly Op[], sequence: number, context: Context) => void): () => void;\n}\n\nconst sources = new WeakMap<object, ReplicatedStateInternals>();\n\nexport function registerReplicatedStateInternals(value: object, internals: ReplicatedStateInternals): void {\n\tsources.set(value, internals);\n}\n\nexport function getReplicatedStateInternals(value: unknown): ReplicatedStateInternals | undefined {\n\tif (typeof value !== \"object\" || value === null) return undefined;\n\treturn sources.get(value);\n}\n"]}

package/dist/services/state.d.ts

@@ -0,0 +1,28 @@
+import { type Op } from "../delta/index.ts";
+import type { AttachedReplicatedState, Context, JsonValue, MutableReplicatedState, ReplicatedState, ReplicatedStateDelivery, ReplicatedStateSource, ReplicatedStateSourceOptions } from "../types.ts";
+/** The void signature also accepts synchronous callbacks that return an ignored value. */
+type StateListener<T> = (value: T, context: Context, delivery: ReplicatedStateDelivery) => void;
+export declare class MutableReplicatedStateImpl<T extends object> implements MutableReplicatedState<T> {
+    #private;
+    constructor(initial: T);
+    get value(): T;
+    change(context: Context, mutate: Parameters<MutableReplicatedState<T>["change"]>[1]): void;
+    replace(context: Context, value: T): void;
+    subscribe(listener: StateListener<T>): () => void;
+}
+/** Attach a publication-only replicated state to one authoritative immutable source stream. */
+export declare function attachReplicatedStateSource<T>(source: ReplicatedStateSource<T>, options?: ReplicatedStateSourceOptions): AttachedReplicatedState<T>;
+/** A cold read-only state used by service consumers until a complete snapshot arrives. */
+export declare class ReplicatedStateReplica<T extends JsonValue = JsonValue> implements ReplicatedState<T> {
+    #private;
+    constructor(reportError: (error: Error) => void);
+    get value(): T | undefined;
+    subscribe(listener: StateListener<T>): () => void;
+    hydrate(sequence: number, ops: readonly Op[], context: Context): void;
+    update(sequence: number, ops: readonly Op[], context: Context): void;
+    clear(): void;
+}
+/** @internal Context for synthetic service deliveries without a caller. */
+export declare function serviceDeliveryContext(): Context;
+export {};
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/services/state.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,EAAE,EAAsC,MAAM,mBAAmB,CAAC;AAExG,OAAO,KAAK,EACX,uBAAuB,EACvB,OAAO,EACP,SAAS,EACT,sBAAsB,EACtB,eAAe,EACf,uBAAuB,EACvB,qBAAqB,EAGrB,4BAA4B,EAC5B,MAAM,aAAa,CAAC;AAGrB,0FAA0F;AAC1F,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,uBAAuB,KAAK,IAAI,CAAC;AAqKhG,qBAAa,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAE,YAAW,sBAAsB,CAAC,CAAC,CAAC;;IAK7F,YAAY,OAAO,EAAE,CAAC,EAOrB;IAED,IAAI,KAAK,IAAI,CAAC,CAEb;IAED,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CA2BzF;IAED,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CASxC;IAED,SAAS,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAEhD;CACD;AA8ED,+FAA+F;AAC/F,wBAAgB,2BAA2B,CAAC,CAAC,EAC5C,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAChC,OAAO,GAAE,4BAAiC,GACxC,uBAAuB,CAAC,CAAC,CAAC,CAc5B;AAED,0FAA0F;AAC1F,qBAAa,sBAAsB,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;;IAOjG,YAAY,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAE9C;IAED,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAEzB;IAED,SAAS,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAehD;IAED,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAYpE;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAkBnE;IAED,KAAK,IAAI,IAAI,CAIZ;CAUD;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD"}

package/dist/services/state.js

@@ -0,0 +1,397 @@
+import { BACKGROUND_CONTEXT } from "../context/index.js";
+import { applyImmutable, isBase, track } from "../delta/index.js";
+import { JsonRevisionValidator } from "../delta/revision-validator.js";
+import { registerReplicatedStateInternals } from "./state-internals.js";
+/** One public subscription, independent of producer and other subscriber progress. */
+class StateSubscriber {
+    #listener;
+    #reportError;
+    #pending = [];
+    #running = false;
+    #started = false;
+    #closed = false;
+    constructor(listener, reportError) {
+        this.#listener = listener;
+        this.#reportError = reportError;
+    }
+    push(frame) {
+        if (this.#closed)
+            return;
+        if (this.#pending.length === 100) {
+            // A cold replica can queue updates reentrantly before this subscriber's first hydration starts.
+            const hydration = this.#started ? undefined : this.#pending[0];
+            this.#pending.length = 0;
+            if (hydration !== undefined)
+                this.#pending.push(hydration);
+        }
+        this.#pending.push(frame);
+    }
+    drain() {
+        if (this.#running || this.#closed)
+            return;
+        this.#running = true;
+        for (let frame = this.#pending.shift(); frame !== undefined; frame = this.#pending.shift()) {
+            this.#started = true;
+            try {
+                const result = this.#listener(frame.value, frame.context, frame.delivery);
+                if (isPromiseLike(result)) {
+                    void Promise.resolve(result).then(() => this.#resume(), (error) => {
+                        this.#report(error);
+                        this.#resume();
+                    });
+                    return;
+                }
+            }
+            catch (error) {
+                this.#report(error);
+            }
+        }
+        this.#running = false;
+    }
+    clear() {
+        this.#pending.length = 0;
+    }
+    close() {
+        this.#closed = true;
+        this.clear();
+    }
+    #resume() {
+        this.#running = false;
+        this.drain();
+    }
+    #report(error) {
+        try {
+            this.#reportError(toError(error));
+        }
+        catch (reportError) {
+            reportErrorAsync(toError(reportError));
+        }
+    }
+}
+/** Maintains local publication order independently of how revisions are produced. */
+class ReplicatedStatePublisher {
+    #listeners = new Map();
+    #reportError;
+    #sourceListeners = new Set();
+    #publications = [];
+    #value;
+    #sequence = 0;
+    #delivering = false;
+    constructor(initial, reportError = reportErrorAsync) {
+        this.#value = initial;
+        this.#reportError = reportError;
+    }
+    get value() {
+        return this.#value;
+    }
+    snapshot() {
+        return { value: this.#value, sequence: this.#sequence };
+    }
+    subscribe(listener) {
+        const { value, sequence } = this.snapshot();
+        const subscriber = new StateSubscriber(listener, this.#reportError);
+        this.#listeners.set(subscriber, sequence);
+        subscriber.push({ value, context: serviceDeliveryContext(), delivery: { kind: "hydrate", sequence } });
+        subscriber.drain();
+        return () => {
+            subscriber.close();
+            this.#listeners.delete(subscriber);
+        };
+    }
+    subscribeSource(listener) {
+        this.#sourceListeners.add(listener);
+        return () => this.#sourceListeners.delete(listener);
+    }
+    /** Publish an already-prepared immutable revision and return isolated listener failures. */
+    publish(value, ops, context) {
+        this.#value = value;
+        this.#sequence += 1;
+        this.#publications.push({ value, ops, sequence: this.#sequence, context });
+        if (this.#delivering)
+            return [];
+        this.#delivering = true;
+        const errors = [];
+        try {
+            for (let publication = this.#publications.shift(); publication !== undefined; publication = this.#publications.shift()) {
+                for (const listener of [...this.#sourceListeners]) {
+                    try {
+                        listener(publication.ops, publication.sequence, publication.context);
+                    }
+                    catch (error) {
+                        errors.push(error);
+                    }
+                }
+                const delivery = { kind: "update", sequence: publication.sequence };
+                for (const [subscriber, hydratedSequence] of [...this.#listeners]) {
+                    if (publication.sequence <= hydratedSequence)
+                        continue;
+                    subscriber.push({ value: publication.value, context: publication.context, delivery });
+                    subscriber.drain();
+                }
+            }
+        }
+        finally {
+            this.#delivering = false;
+        }
+        return errors;
+    }
+}
+export class MutableReplicatedStateImpl {
+    #tracker;
+    #publisher;
+    #changing = false;
+    constructor(initial) {
+        this.#tracker = track(initial);
+        this.#publisher = new ReplicatedStatePublisher(this.#tracker.value);
+        registerReplicatedStateInternals(this, {
+            snapshot: () => this.#publisher.snapshot(),
+            subscribe: (listener) => this.#publisher.subscribeSource(listener),
+        });
+    }
+    get value() {
+        return this.#tracker.value;
+    }
+    change(context, mutate) {
+        if (this.#changing)
+            throw new Error("Replicated state cannot be changed reentrantly from a change callback");
+        this.#changing = true;
+        let prepared;
+        try {
+            const change = this.#tracker.beginChange();
+            try {
+                const outcome = mutate(change.state);
+                if (isPromiseLike(outcome)) {
+                    void Promise.resolve(outcome).catch(() => undefined);
+                    throw new TypeError("Replicated state change callbacks must be synchronous");
+                }
+                prepared = change.prepare();
+            }
+            catch (error) {
+                change.abort();
+                throw error;
+            }
+        }
+        finally {
+            this.#changing = false;
+        }
+        this.#tracker.adopt(prepared);
+        if (prepared.ops.length === 0)
+            return;
+        throwCollectedErrors(this.#publisher.publish(prepared.value, prepared.ops, context), "Replicated state listeners failed");
+    }
+    replace(context, value) {
+        if (this.#changing)
+            throw new Error("Replicated state cannot be replaced from a change callback");
+        const prepared = this.#tracker.prepareReplace(value);
+        this.#tracker.adopt(prepared);
+        if (prepared.ops.length === 0)
+            return;
+        throwCollectedErrors(this.#publisher.publish(prepared.value, prepared.ops, context), "Replicated state listeners failed");
+    }
+    subscribe(listener) {
+        return this.#publisher.subscribe(listener);
+    }
+}
+class AttachedReplicatedStateImpl {
+    #publisher;
+    #attachment;
+    #reportError;
+    #cursor;
+    #disposed = false;
+    constructor(attachment, options) {
+        const { snapshot } = attachment;
+        assertCursor(snapshot.cursor, "snapshot");
+        this.#attachment = attachment;
+        this.#cursor = snapshot.cursor;
+        this.#reportError = options.onError ?? reportErrorAsync;
+        this.#publisher = new ReplicatedStatePublisher(snapshot.value, (error) => this.#report(error));
+        registerReplicatedStateInternals(this, {
+            snapshot: () => this.#publisher.snapshot(),
+            subscribe: (listener) => this.#publisher.subscribeSource(listener),
+        });
+    }
+    get value() {
+        return this.#publisher.value;
+    }
+    subscribe(listener) {
+        return this.#publisher.subscribe(listener);
+    }
+    activate() {
+        this.#attachment.activate((frame) => this.#receive(frame));
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#attachment.dispose();
+    }
+    #receive(frame) {
+        if (this.#disposed)
+            return;
+        try {
+            assertCursor(frame.cursor, "frame");
+            const expected = this.#cursor + 1;
+            if (frame.cursor !== expected) {
+                throw new Error(`Replicated state source cursor has a gap: expected ${expected}, received ${frame.cursor}`);
+            }
+            this.#cursor = frame.cursor;
+            const errors = this.#publisher.publish(frame.value, frame.ops, frame.context);
+            if (errors.length === 1)
+                this.#report(errors[0]);
+            else if (errors.length > 1)
+                this.#report(new AggregateError(errors, "Replicated state listeners failed"));
+        }
+        catch (error) {
+            this.#fail(toError(error));
+        }
+    }
+    #fail(error) {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        try {
+            this.#attachment.dispose();
+        }
+        catch (disposeError) {
+            this.#report(new AggregateError([error, disposeError], "Replicated state source contract failed"));
+            return;
+        }
+        this.#report(error);
+    }
+    #report(error) {
+        try {
+            this.#reportError(toError(error));
+        }
+        catch (reportError) {
+            reportErrorAsync(toError(reportError));
+        }
+    }
+}
+/** Attach a publication-only replicated state to one authoritative immutable source stream. */
+export function attachReplicatedStateSource(source, options = {}) {
+    const attachment = source.attach();
+    try {
+        const state = new AttachedReplicatedStateImpl(attachment, options);
+        state.activate();
+        return state;
+    }
+    catch (error) {
+        try {
+            attachment.dispose();
+        }
+        catch (disposeError) {
+            throw new AggregateError([error, disposeError], "Failed to attach replicated state source");
+        }
+        throw error;
+    }
+}
+/** A cold read-only state used by service consumers until a complete snapshot arrives. */
+export class ReplicatedStateReplica {
+    #listeners = new Set();
+    #reportError;
+    #validator = new JsonRevisionValidator();
+    #value;
+    #sequence;
+    constructor(reportError) {
+        this.#reportError = reportError;
+    }
+    get value() {
+        return this.#value;
+    }
+    subscribe(listener) {
+        const subscriber = new StateSubscriber(listener, this.#reportError);
+        this.#listeners.add(subscriber);
+        if (this.#value !== undefined) {
+            subscriber.push({
+                value: this.#value,
+                context: serviceDeliveryContext(),
+                delivery: { kind: "hydrate", sequence: this.#sequence },
+            });
+            subscriber.drain();
+        }
+        return () => {
+            subscriber.close();
+            this.#listeners.delete(subscriber);
+        };
+    }
+    hydrate(sequence, ops, context) {
+        let next;
+        try {
+            if (!isBase(ops))
+                throw new Error("Replicated state snapshot is not a base operation batch");
+            next = this.#validator.validate(applyImmutable(undefined, ops));
+        }
+        catch (error) {
+            this.clear();
+            throw error;
+        }
+        this.#sequence = sequence;
+        this.#value = next;
+        this.#deliverAll(context, { kind: "hydrate", sequence });
+    }
+    update(sequence, ops, context) {
+        if (this.#sequence === undefined || this.#value === undefined) {
+            throw new Error("Replicated state received an update before hydration");
+        }
+        if (sequence !== this.#sequence + 1) {
+            this.clear();
+            throw new Error("Replicated state update sequence has a gap");
+        }
+        let next;
+        try {
+            next = this.#validator.validate(applyImmutable(this.#value, ops));
+        }
+        catch (error) {
+            this.clear();
+            throw error;
+        }
+        this.#sequence = sequence;
+        this.#value = next;
+        this.#deliverAll(context, { kind: "update", sequence });
+    }
+    clear() {
+        this.#value = undefined;
+        this.#sequence = undefined;
+        for (const subscriber of this.#listeners)
+            subscriber.clear();
+    }
+    #deliverAll(context, delivery) {
+        if (this.#value === undefined)
+            return;
+        const frame = { value: this.#value, context, delivery };
+        const subscribers = [...this.#listeners];
+        // Enqueue for everyone before user code can publish another revision reentrantly.
+        for (const subscriber of subscribers)
+            subscriber.push(frame);
+        for (const subscriber of subscribers)
+            subscriber.drain();
+    }
+}
+/** @internal Context for synthetic service deliveries without a caller. */
+export function serviceDeliveryContext() {
+    // TODO: Add delivery-scoped cancellation or metadata if deliveries gain an owned lifecycle.
+    return BACKGROUND_CONTEXT;
+}
+function assertCursor(cursor, kind) {
+    if (!Number.isSafeInteger(cursor))
+        throw new TypeError(`Replicated state source ${kind} cursor must be a safe integer`);
+}
+function isPromiseLike(value) {
+    return (((typeof value === "object" && value !== null) || typeof value === "function") &&
+        typeof value.then === "function");
+}
+function throwCollectedErrors(errors, message) {
+    if (errors.length === 1)
+        throw errors[0];
+    if (errors.length > 1)
+        throw new AggregateError(errors, message);
+}
+function reportErrorAsync(error) {
+    queueMicrotask(() => {
+        throw error;
+    });
+}
+function toError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+//# sourceMappingURL=state.js.map