@powerhousedao/reactor 4.1.0-dev.12 → 4.1.0-dev.121

package/dist/src/registry/implementation.js

@@ -0,0 +1,96 @@
+/**
+ * Error thrown when a document model module is not found in the registry.
+ */
+export class ModuleNotFoundError extends Error {
+    constructor(documentType) {
+        super(`Document model module not found for type: ${documentType}`);
+        this.name = "ModuleNotFoundError";
+    }
+}
+/**
+ * Error thrown when attempting to register a module that already exists.
+ */
+export class DuplicateModuleError extends Error {
+    constructor(documentType) {
+        super(`Document model module already registered for type: ${documentType}`);
+        this.name = "DuplicateModuleError";
+    }
+}
+/**
+ * Error thrown when a module is invalid or malformed.
+ */
+export class InvalidModuleError extends Error {
+    constructor(message) {
+        super(`Invalid document model module: ${message}`);
+        this.name = "InvalidModuleError";
+    }
+}
+/**
+ * In-memory implementation of the IDocumentModelRegistry interface.
+ * Manages document model modules and provides centralized access to their reducers, utils, and specifications.
+ */
+export class DocumentModelRegistry {
+    modules = new Map();
+    /**
+     * Register multiple modules at once.
+     *
+     * @param modules Document model modules to register
+     * @throws DuplicateModuleError if a module with the same document type is already registered
+     * @throws InvalidModuleError if a module is malformed
+     */
+    registerModules(...modules) {
+        for (const module of modules) {
+            const documentType = module.documentModel.global.id;
+            if (this.modules.has(documentType)) {
+                throw new DuplicateModuleError(documentType);
+            }
+            this.modules.set(documentType, module);
+        }
+    }
+    /**
+     * Unregister multiple document model modules at once.
+     *
+     * @param documentTypes The document types to unregister
+     * @returns true if all modules were unregistered, false if any were not found
+     */
+    unregisterModules(...documentTypes) {
+        let allFound = true;
+        for (const documentType of documentTypes) {
+            const wasDeleted = this.modules.delete(documentType);
+            if (!wasDeleted) {
+                allFound = false;
+            }
+        }
+        return allFound;
+    }
+    /**
+     * Get a specific document model module by document type.
+     *
+     * @param documentType The document type identifier
+     * @returns The document model module
+     * @throws ModuleNotFoundError if the document type is not registered
+     */
+    getModule(documentType) {
+        const module = this.modules.get(documentType);
+        if (module) {
+            return module;
+        }
+        throw new ModuleNotFoundError(documentType);
+    }
+    /**
+     * Get all registered document model modules.
+     * Note: This only returns loaded modules, not lazy-loaded ones.
+     *
+     * @returns Array of all registered modules
+     */
+    getAllModules() {
+        return Array.from(this.modules.values());
+    }
+    /**
+     * Clear all registered modules
+     */
+    clear() {
+        this.modules.clear();
+    }
+}
+//# sourceMappingURL=implementation.js.map

package/dist/src/registry/implementation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation.js","sourceRoot":"","sources":["../../../src/registry/implementation.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,YAAoB;QAC9B,KAAK,CAAC,6CAA6C,YAAY,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,YAAoB;QAC9B,KAAK,CAAC,sDAAsD,YAAY,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACxB,OAAO,GAAG,IAAI,GAAG,EAAoC,CAAC;IAE9D;;;;;;OAMG;IACH,eAAe,CAAC,GAAG,OAAmC;QACpD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAEpD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,oBAAoB,CAAC,YAAY,CAAC,CAAC;YAC/C,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,aAAuB;QAC1C,IAAI,QAAQ,GAAG,IAAI,CAAC;QAEpB,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YACrD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,QAAQ,GAAG,KAAK,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,YAAoB;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAE9C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,IAAI,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/src/registry/index.d.ts

@@ -0,0 +1,3 @@
+export { DocumentModelRegistry, DuplicateModuleError, InvalidModuleError, ModuleNotFoundError, } from "./implementation.js";
+export type { IDocumentModelRegistry } from "./interfaces.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/registry/index.js

@@ -0,0 +1,2 @@
+export { DocumentModelRegistry, DuplicateModuleError, InvalidModuleError, ModuleNotFoundError, } from "./implementation.js";
+//# sourceMappingURL=index.js.map

package/dist/src/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/src/registry/interfaces.d.ts

@@ -0,0 +1,39 @@
+import type { DocumentModelModule } from "document-model";
+/**
+ * Registry for managing document model modules.
+ * Provides centralized access to document models' reducers, utils, and specifications.
+ */
+export interface IDocumentModelRegistry {
+    /**
+     * Register multiple modules at once.
+     *
+     * @param modules Document model modules to register
+     * @throws Error if a module with the same document type is already registered
+     */
+    registerModules(...modules: DocumentModelModule<any>[]): void;
+    /**
+     * Unregister multiple document model modules at once.
+     *
+     * @param documentTypes The document types to unregister
+     * @returns true if all modules were unregistered, false if any were not found
+     */
+    unregisterModules(...documentTypes: string[]): boolean;
+    /**
+     * Get a specific document model module by document type.
+     *
+     * @param documentType The document type identifier
+     * @returns The document model module
+     * @throws Error if the document type is not registered
+     */
+    getModule(documentType: string): DocumentModelModule<any>;
+    /**
+     * Get all registered document model modules
+     * @returns Array of all registered modules
+     */
+    getAllModules(): DocumentModelModule<any>[];
+    /**
+     * Clear all registered modules
+     */
+    clear(): void;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/src/registry/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/registry/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,eAAe,CAAC,GAAG,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;IAE9D;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEvD;;;;;;OAMG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAE1D;;;OAGG;IACH,aAAa,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;IAE5C;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/src/registry/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/src/registry/interfaces.js.map

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

package/dist/src/shared/awaiter.d.ts

@@ -0,0 +1,32 @@
+import { type JobInfo } from "./types.js";
+export interface IJobAwaiter {
+    /**
+     * Waits for a job to complete: turns a job into a promise.
+     *
+     * @param jobId - The job id or job object
+     * @param signal - Optional abort signal to cancel the request
+     * @returns The result of the job
+     */
+    waitForJob(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
+    /**
+     * Shuts down the job awaiter. This will synchronously reject all pending jobs.
+     */
+    shutdown(): void;
+}
+/**
+ * Default implementation of IJobAwaiter that polls for job status.
+ * Uses a single interval timer to check all pending jobs.
+ */
+export declare class JobAwaiter implements IJobAwaiter {
+    private getJobStatus;
+    private pollIntervalMs;
+    private pendingJobs;
+    private intervalId;
+    constructor(getJobStatus: (jobId: string, signal?: AbortSignal) => Promise<JobInfo>, pollIntervalMs?: number);
+    shutdown(): void;
+    waitForJob(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
+    private startInterval;
+    private stopIntervalIfNoJobs;
+    private checkPendingJobs;
+}
+//# sourceMappingURL=awaiter.d.ts.map

package/dist/src/shared/awaiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"awaiter.d.ts","sourceRoot":"","sources":["../../../src/shared/awaiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElE;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;CAClB;AAQD;;;GAGG;AACH,qBAAa,UAAW,YAAW,WAAW;IAM1C,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,cAAc;IARxB,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,UAAU,CAA+B;gBAGvC,YAAY,EAAE,CACpB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,OAAO,CAAC,EACb,cAAc,SAAK;IAK7B,QAAQ,IAAI,IAAI;IAcV,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IA2CvE,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,oBAAoB;YAOd,gBAAgB;CA+D/B"}

package/dist/src/shared/awaiter.js

@@ -0,0 +1,132 @@
+import { JobStatus } from "./types.js";
+/**
+ * Default implementation of IJobAwaiter that polls for job status.
+ * Uses a single interval timer to check all pending jobs.
+ */
+export class JobAwaiter {
+    getJobStatus;
+    pollIntervalMs;
+    // Map from job ID to list of waiters (multiple waiters can wait for same job)
+    pendingJobs = new Map();
+    intervalId = null;
+    constructor(getJobStatus, pollIntervalMs = 10) {
+        this.getJobStatus = getJobStatus;
+        this.pollIntervalMs = pollIntervalMs;
+        //
+    }
+    shutdown() {
+        if (this.intervalId !== null) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        // Reject all pending jobs
+        for (const [, waiters] of this.pendingJobs) {
+            for (const waiter of waiters) {
+                waiter.reject(new Error("JobAwaiter destroyed"));
+            }
+        }
+        this.pendingJobs.clear();
+    }
+    async waitForJob(jobId, signal) {
+        // Check if signal is already aborted
+        if (signal?.aborted) {
+            throw new Error("Operation aborted");
+        }
+        // Create promise for this job
+        const promise = new Promise((resolve, reject) => {
+            const waiter = { resolve, reject, signal };
+            // Add to the list of waiters for this job
+            const existingWaiters = this.pendingJobs.get(jobId) || [];
+            existingWaiters.push(waiter);
+            this.pendingJobs.set(jobId, existingWaiters);
+            // If signal is provided, handle abort
+            if (signal) {
+                const abortHandler = () => {
+                    // Find and remove this specific waiter
+                    const waiters = this.pendingJobs.get(jobId);
+                    if (waiters) {
+                        const index = waiters.indexOf(waiter);
+                        if (index !== -1) {
+                            waiters.splice(index, 1);
+                            if (waiters.length === 0) {
+                                this.pendingJobs.delete(jobId);
+                            }
+                            waiter.reject(new Error("Operation aborted"));
+                            this.stopIntervalIfNoJobs();
+                        }
+                    }
+                };
+                signal.addEventListener("abort", abortHandler, { once: true });
+            }
+        });
+        // Start interval if not already running
+        this.startInterval();
+        return promise;
+    }
+    startInterval() {
+        if (this.intervalId === null && this.pendingJobs.size > 0) {
+            this.intervalId = setInterval(() => {
+                void this.checkPendingJobs();
+            }, this.pollIntervalMs);
+            // Check immediately as well - schedule it for next tick
+            setTimeout(() => void this.checkPendingJobs(), 0);
+        }
+    }
+    stopIntervalIfNoJobs() {
+        if (this.pendingJobs.size === 0 && this.intervalId !== null) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+    }
+    async checkPendingJobs() {
+        // Get unique job IDs to check
+        const jobIds = Array.from(this.pendingJobs.keys());
+        // Check each job
+        const jobChecks = jobIds.map(async (jobId) => {
+            const waiters = this.pendingJobs.get(jobId);
+            if (!waiters || waiters.length === 0) {
+                return;
+            }
+            try {
+                // Filter out aborted waiters
+                const activeWaiters = waiters.filter((w) => !w.signal?.aborted);
+                if (activeWaiters.length === 0) {
+                    // All waiters were aborted
+                    this.pendingJobs.delete(jobId);
+                    return;
+                }
+                // let errors bubble up
+                const jobInfo = await this.getJobStatus(jobId, activeWaiters[0].signal);
+                // Check if job is complete
+                if (jobInfo.status === JobStatus.COMPLETED ||
+                    jobInfo.status === JobStatus.FAILED) {
+                    // Remove from pending
+                    this.pendingJobs.delete(jobId);
+                    // Resolve all active waiters
+                    for (const waiter of activeWaiters) {
+                        waiter.resolve(jobInfo);
+                    }
+                    // Reject aborted waiters
+                    for (const waiter of waiters) {
+                        if (waiter.signal?.aborted) {
+                            waiter.reject(new Error("Operation aborted"));
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                // Remove from pending
+                this.pendingJobs.delete(jobId);
+                // Reject all waiters with the error
+                for (const waiter of waiters) {
+                    waiter.reject(error instanceof Error ? error : new Error(String(error)));
+                }
+            }
+        });
+        // Wait for all checks to complete
+        await Promise.all(jobChecks);
+        // Stop interval if no more jobs
+        this.stopIntervalIfNoJobs();
+    }
+}
+//# sourceMappingURL=awaiter.js.map

package/dist/src/shared/awaiter.js.map

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

package/dist/src/shared/consistency-tracker.d.ts

@@ -0,0 +1,48 @@
+import type { ConsistencyCoordinate, ConsistencyKey } from "./types.js";
+export interface IConsistencyTracker {
+    /**
+     * Updates the tracker with new operation indexes.
+     * When multiple coordinates have the same key, keeps the highest operationIndex.
+     * Resolves any pending waiters whose coordinates are now satisfied.
+     */
+    update(coordinates: ConsistencyCoordinate[]): void;
+    /**
+     * Returns the latest operation index for a given key, or undefined if not tracked.
+     */
+    getLatest(key: ConsistencyKey): number | undefined;
+    /**
+     * Returns a promise that resolves when all coordinates are satisfied.
+     * Rejects if the timeout is reached or the signal is aborted.
+     */
+    waitFor(coordinates: ConsistencyCoordinate[], timeoutMs?: number, signal?: AbortSignal): Promise<void>;
+    /**
+     * Returns a serializable snapshot of the current state.
+     */
+    serialize(): Array<[ConsistencyKey, number]>;
+    /**
+     * Restores state from a serialized snapshot.
+     */
+    hydrate(entries: Array<[ConsistencyKey, number]>): void;
+}
+/**
+ * Creates a consistency key from documentId, scope, and branch.
+ */
+export declare function makeConsistencyKey(documentId: string, scope: string, branch: string): ConsistencyKey;
+/**
+ * Tracks operation indexes for documents and provides read-after-write consistency guarantees.
+ * Maintains an in-memory map of the latest operation index for each (documentId, scope, branch) tuple.
+ */
+export declare class ConsistencyTracker implements IConsistencyTracker {
+    private state;
+    private waiters;
+    update(coordinates: ConsistencyCoordinate[]): void;
+    getLatest(key: ConsistencyKey): number | undefined;
+    waitFor(coordinates: ConsistencyCoordinate[], timeoutMs?: number, signal?: AbortSignal): Promise<void>;
+    serialize(): Array<[ConsistencyKey, number]>;
+    hydrate(entries: Array<[ConsistencyKey, number]>): void;
+    private deduplicateCoordinates;
+    private areCoordinatesSatisfied;
+    private checkWaiters;
+    private removeWaiter;
+}
+//# sourceMappingURL=consistency-tracker.d.ts.map

package/dist/src/shared/consistency-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consistency-tracker.d.ts","sourceRoot":"","sources":["../../../src/shared/consistency-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,CAAC,WAAW,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAC;IAEnD;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAAC;IAEnD;;;OAGG;IACH,OAAO,CACL,WAAW,EAAE,qBAAqB,EAAE,EACpC,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,SAAS,IAAI,KAAK,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IAE7C;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;CACzD;AAUD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,cAAc,CAEhB;AAED;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,OAAO,CAAgB;IAE/B,MAAM,CAAC,WAAW,EAAE,qBAAqB,EAAE,GAAG,IAAI;IAmBlD,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS;IAIlD,OAAO,CACL,WAAW,EAAE,qBAAqB,EAAE,EACpC,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAoChB,SAAS,IAAI,KAAK,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAI5C,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI;IAOvD,OAAO,CAAC,sBAAsB;IAsB9B,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,YAAY;CASrB"}

package/dist/src/shared/consistency-tracker.js

@@ -0,0 +1,123 @@
+/**
+ * Creates a consistency key from documentId, scope, and branch.
+ */
+export function makeConsistencyKey(documentId, scope, branch) {
+    return `${documentId}:${scope}:${branch}`;
+}
+/**
+ * Tracks operation indexes for documents and provides read-after-write consistency guarantees.
+ * Maintains an in-memory map of the latest operation index for each (documentId, scope, branch) tuple.
+ */
+export class ConsistencyTracker {
+    state = new Map();
+    waiters = [];
+    update(coordinates) {
+        const deduplicated = this.deduplicateCoordinates(coordinates);
+        for (let i = 0; i < deduplicated.length; i++) {
+            const coord = deduplicated[i];
+            const key = makeConsistencyKey(coord.documentId, coord.scope, coord.branch);
+            const current = this.state.get(key);
+            if (current === undefined || coord.operationIndex > current) {
+                this.state.set(key, coord.operationIndex);
+            }
+        }
+        this.checkWaiters();
+    }
+    getLatest(key) {
+        return this.state.get(key);
+    }
+    waitFor(coordinates, timeoutMs, signal) {
+        if (signal?.aborted) {
+            return Promise.reject(new Error("Operation aborted"));
+        }
+        if (this.areCoordinatesSatisfied(coordinates)) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve, reject) => {
+            const waiter = {
+                coordinates,
+                resolve,
+                reject,
+                signal,
+            };
+            if (timeoutMs !== undefined) {
+                waiter.timeoutId = setTimeout(() => {
+                    this.removeWaiter(waiter);
+                    reject(new Error(`Consistency wait timed out after ${timeoutMs}ms`));
+                }, timeoutMs);
+            }
+            if (signal) {
+                const abortHandler = () => {
+                    this.removeWaiter(waiter);
+                    reject(new Error("Operation aborted"));
+                };
+                signal.addEventListener("abort", abortHandler, { once: true });
+            }
+            this.waiters.push(waiter);
+        });
+    }
+    serialize() {
+        return Array.from(this.state.entries());
+    }
+    hydrate(entries) {
+        this.state.clear();
+        for (const [key, index] of entries) {
+            this.state.set(key, index);
+        }
+    }
+    deduplicateCoordinates(coordinates) {
+        const map = new Map();
+        for (let i = 0; i < coordinates.length; i++) {
+            const coord = coordinates[i];
+            const key = makeConsistencyKey(coord.documentId, coord.scope, coord.branch);
+            const existing = map.get(key);
+            if (!existing || coord.operationIndex > existing.operationIndex) {
+                map.set(key, coord);
+            }
+        }
+        return Array.from(map.values());
+    }
+    areCoordinatesSatisfied(coordinates) {
+        for (let i = 0; i < coordinates.length; i++) {
+            const coord = coordinates[i];
+            const key = makeConsistencyKey(coord.documentId, coord.scope, coord.branch);
+            const latest = this.state.get(key);
+            if (latest === undefined || latest < coord.operationIndex) {
+                return false;
+            }
+        }
+        return true;
+    }
+    checkWaiters() {
+        const satisfiedWaiters = [];
+        const unsatisfiedWaiters = [];
+        for (const waiter of this.waiters) {
+            if (waiter.signal?.aborted) {
+                continue;
+            }
+            if (this.areCoordinatesSatisfied(waiter.coordinates)) {
+                satisfiedWaiters.push(waiter);
+            }
+            else {
+                unsatisfiedWaiters.push(waiter);
+            }
+        }
+        this.waiters = unsatisfiedWaiters;
+        for (const waiter of satisfiedWaiters) {
+            if (waiter.timeoutId !== undefined) {
+                clearTimeout(waiter.timeoutId);
+            }
+            waiter.resolve();
+        }
+    }
+    removeWaiter(waiter) {
+        const index = this.waiters.indexOf(waiter);
+        if (index !== -1) {
+            this.waiters.splice(index, 1);
+        }
+        if (waiter.timeoutId !== undefined) {
+            clearTimeout(waiter.timeoutId);
+        }
+    }
+}
+//# sourceMappingURL=consistency-tracker.js.map

package/dist/src/shared/consistency-tracker.js.map

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

package/dist/src/shared/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Error thrown when attempting to access a deleted document.
+ */
+export declare class DocumentDeletedError extends Error {
+    readonly documentId: string;
+    readonly deletedAtUtcIso: string | null;
+    constructor(documentId: string, deletedAtUtcIso?: string | null);
+}
+/**
+ * Error thrown when attempting to add operations before CREATE_DOCUMENT.
+ */
+export declare class CreateDocumentRequiredError extends Error {
+    readonly documentId: string;
+    readonly scope: string;
+    constructor(documentId: string, scope: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/shared/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEnC,UAAU,EAAE,MAAM,EAAE,eAAe,GAAE,MAAM,GAAG,IAAW;CAYtE;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,KAAK,EAAE,MAAM,CAAC;gBAElB,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAU9C"}

package/dist/src/shared/errors.js

@@ -0,0 +1,33 @@
+/**
+ * Error thrown when attempting to access a deleted document.
+ */
+export class DocumentDeletedError extends Error {
+    documentId;
+    deletedAtUtcIso;
+    constructor(documentId, deletedAtUtcIso = null) {
+        const message = deletedAtUtcIso
+            ? `Document ${documentId} was deleted at ${deletedAtUtcIso}`
+            : `Document ${documentId} has been deleted`;
+        super(message);
+        this.name = "DocumentDeletedError";
+        this.documentId = documentId;
+        this.deletedAtUtcIso = deletedAtUtcIso;
+        Error.captureStackTrace(this, DocumentDeletedError);
+    }
+}
+/**
+ * Error thrown when attempting to add operations before CREATE_DOCUMENT.
+ */
+export class CreateDocumentRequiredError extends Error {
+    documentId;
+    scope;
+    constructor(documentId, scope) {
+        const message = `Document ${documentId} requires a CREATE_DOCUMENT operation at revision 0 in the "document" scope before operations can be added to scope "${scope}"`;
+        super(message);
+        this.name = "CreateDocumentRequiredError";
+        this.documentId = documentId;
+        this.scope = scope;
+        Error.captureStackTrace(this, CreateDocumentRequiredError);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7B,UAAU,CAAS;IACnB,eAAe,CAAgB;IAE/C,YAAY,UAAkB,EAAE,kBAAiC,IAAI;QACnE,MAAM,OAAO,GAAG,eAAe;YAC7B,CAAC,CAAC,YAAY,UAAU,mBAAmB,eAAe,EAAE;YAC5D,CAAC,CAAC,YAAY,UAAU,mBAAmB,CAAC;QAE9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QAEvC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IACtD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IACpC,UAAU,CAAS;IACnB,KAAK,CAAS;IAE9B,YAAY,UAAkB,EAAE,KAAa;QAC3C,MAAM,OAAO,GAAG,YAAY,UAAU,wHAAwH,KAAK,GAAG,CAAC;QAEvK,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/src/shared/factories.d.ts

@@ -0,0 +1,16 @@
+import type { ShutdownStatus } from "./types.js";
+/**
+ * Factory method to create a ShutdownStatus object
+ *
+ * @param isShutdown - Initial shutdown state
+ * @returns A ShutdownStatus object with a getter for the shutdown state
+ */
+export declare function createShutdownStatus(isShutdown: boolean): ShutdownStatus;
+/**
+ * Factory method to create a ShutdownStatus that can be updated
+ *
+ * @param initialState - Initial shutdown state (default: false)
+ * @returns A tuple of [ShutdownStatus, setter function]
+ */
+export declare function createMutableShutdownStatus(initialState?: boolean): [ShutdownStatus, (value: boolean) => void];
+//# sourceMappingURL=factories.d.ts.map

package/dist/src/shared/factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../../../src/shared/factories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,cAAc,CAQxE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,UAAQ,GACnB,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,CAc5C"}

package/dist/src/shared/factories.js

@@ -0,0 +1,33 @@
+/**
+ * Factory method to create a ShutdownStatus object
+ *
+ * @param isShutdown - Initial shutdown state
+ * @returns A ShutdownStatus object with a getter for the shutdown state
+ */
+export function createShutdownStatus(isShutdown) {
+    const shutdownState = isShutdown;
+    return {
+        get isShutdown() {
+            return shutdownState;
+        },
+    };
+}
+/**
+ * Factory method to create a ShutdownStatus that can be updated
+ *
+ * @param initialState - Initial shutdown state (default: false)
+ * @returns A tuple of [ShutdownStatus, setter function]
+ */
+export function createMutableShutdownStatus(initialState = false) {
+    let shutdownState = initialState;
+    const status = {
+        get isShutdown() {
+            return shutdownState;
+        },
+    };
+    const setShutdown = (value) => {
+        shutdownState = value;
+    };
+    return [status, setShutdown];
+}
+//# sourceMappingURL=factories.js.map

package/dist/src/shared/factories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factories.js","sourceRoot":"","sources":["../../../src/shared/factories.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAmB;IACtD,MAAM,aAAa,GAAG,UAAU,CAAC;IAEjC,OAAO;QACL,IAAI,UAAU;YACZ,OAAO,aAAa,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,YAAY,GAAG,KAAK;IAEpB,IAAI,aAAa,GAAG,YAAY,CAAC;IAEjC,MAAM,MAAM,GAAmB;QAC7B,IAAI,UAAU;YACZ,OAAO,aAAa,CAAC;QACvB,CAAC;KACF,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,KAAc,EAAE,EAAE;QACrC,aAAa,GAAG,KAAK,CAAC;IACxB,CAAC,CAAC;IAEF,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC/B,CAAC"}