@powerhousedao/reactor 4.1.0-dev.9 → 4.1.0-dev.91

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/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"}

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

@@ -1,23 +1,95 @@
 /**
- * Basic Operation type for the queue
- * This is a simplified version that includes the essential fields needed for queuing
- */
-export type Operation = {
-    /** Position of the operation in the history */
-    index: number;
-    /** Timestamp of when the operation was added */
-    timestamp: string;
-    /** Hash of the resulting document data after the operation */
-    hash: string;
-    /** The number of operations skipped with this Operation */
-    skip: number;
-    /** The type/name of the operation */
-    type: string;
-    /** The input data for the operation */
-    input: any;
-    /** Error message for a failed action */
+ * The document ID used for system operations (CREATE_DOCUMENT, DELETE_DOCUMENT, etc.)
+ * System operations use this special ID along with the "system" scope.
+ */
+export declare const SYSTEM_DOCUMENT_ID = "00000000-0000-0000-0000-000000000000";
+/**
+ * Describes the status of a shutdown operation.
+ */
+export type ShutdownStatus = {
+    /**
+     * True if and only if the system has been shutdown.
+     *
+     * This value is meant to be polled to determine if the system has been shutdown.
+     *
+     * In the case of a browser process, the `kill` method should be able to synchronously set this to true.
+     *
+     * In the case of a server process, a graceful shutdown period should be allowed for the system to finish its work.
+     */
+    get isShutdown(): boolean;
+};
+/**
+ * Enum that determines deletion propagation.
+ */
+export declare enum PropagationMode {
+    None = "none",
+    Cascade = "cascade"
+}
+/**
+ * Enum that describes the type of relationship change.
+ */
+export declare enum RelationshipChangeType {
+    Added = "added",
+    Removed = "removed"
+}
+/**
+ * Describes the current state of a job.
+ */
+export type JobInfo = {
+    id: string;
+    status: JobStatus;
+    createdAtUtcIso: string;
+    completedAtUtcIso?: string;
     error?: string;
-    /** Unique operation id */
-    id?: string;
+    result?: any;
+};
+/**
+ * Job execution statuses
+ */
+export declare enum JobStatus {
+    /** Job is queued but not yet started */
+    PENDING = "PENDING",
+    /** Job is currently being executed */
+    RUNNING = "RUNNING",
+    /** Job completed successfully */
+    COMPLETED = "COMPLETED",
+    /** Job failed (may be retried) */
+    FAILED = "FAILED"
+}
+/**
+ * Describe the view of a set of documents. That is, what pieces of the
+ * documents are populated.
+ */
+export type ViewFilter = {
+    branch?: string;
+    scopes?: string[];
+    revision?: number;
+};
+/**
+ * Describes filter options for searching documents.
+ *
+ * Each parameter is treated as an AND condition.
+ */
+export type SearchFilter = {
+    type?: string;
+    parentId?: string;
+    ids?: string[];
+    slugs?: string[];
+};
+/**
+ * Describes the options for paging.
+ */
+export type PagingOptions = {
+    cursor: string;
+    limit: number;
+};
+/**
+ * The paged result.
+ */
+export type PagedResults<T> = {
+    results: T[];
+    options: PagingOptions;
+    next?: () => Promise<PagedResults<T>>;
+    nextCursor?: string;
 };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,KAAK,EAAE,GAAG,CAAC;IACX,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;;;OAQG;IACH,IAAI,UAAU,IAAI,OAAO,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,sBAAsB;IAChC,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,GAAG,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,oBAAY,SAAS;IACnB,wCAAwC;IACxC,OAAO,YAAY;IACnB,sCAAsC;IACtC,OAAO,YAAY;IACnB,iCAAiC;IACjC,SAAS,cAAc;IACvB,kCAAkC;IAClC,MAAM,WAAW;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IAEvB,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dist/src/shared/types.js

@@ -1,2 +1,36 @@
-export {};
+/**
+ * The document ID used for system operations (CREATE_DOCUMENT, DELETE_DOCUMENT, etc.)
+ * System operations use this special ID along with the "system" scope.
+ */
+export const SYSTEM_DOCUMENT_ID = "00000000-0000-0000-0000-000000000000";
+/**
+ * Enum that determines deletion propagation.
+ */
+export var PropagationMode;
+(function (PropagationMode) {
+    PropagationMode["None"] = "none";
+    PropagationMode["Cascade"] = "cascade";
+})(PropagationMode || (PropagationMode = {}));
+/**
+ * Enum that describes the type of relationship change.
+ */
+export var RelationshipChangeType;
+(function (RelationshipChangeType) {
+    RelationshipChangeType["Added"] = "added";
+    RelationshipChangeType["Removed"] = "removed";
+})(RelationshipChangeType || (RelationshipChangeType = {}));
+/**
+ * Job execution statuses
+ */
+export var JobStatus;
+(function (JobStatus) {
+    /** Job is queued but not yet started */
+    JobStatus["PENDING"] = "PENDING";
+    /** Job is currently being executed */
+    JobStatus["RUNNING"] = "RUNNING";
+    /** Job completed successfully */
+    JobStatus["COMPLETED"] = "COMPLETED";
+    /** Job failed (may be retried) */
+    JobStatus["FAILED"] = "FAILED";
+})(JobStatus || (JobStatus = {}));
 //# sourceMappingURL=types.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shared/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,sCAAsC,CAAC;AAkBzE;;GAEG;AACH,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,gCAAa,CAAA;IACb,sCAAmB,CAAA;AACrB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,yCAAe,CAAA;IACf,6CAAmB,CAAA;AACrB,CAAC,EAHW,sBAAsB,KAAtB,sBAAsB,QAGjC;AAcD;;GAEG;AACH,MAAM,CAAN,IAAY,SASX;AATD,WAAY,SAAS;IACnB,wCAAwC;IACxC,gCAAmB,CAAA;IACnB,sCAAsC;IACtC,gCAAmB,CAAA;IACnB,iCAAiC;IACjC,oCAAuB,CAAA;IACvB,kCAAkC;IAClC,8BAAiB,CAAA;AACnB,CAAC,EATW,SAAS,KAAT,SAAS,QASpB"}

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

@@ -0,0 +1,3 @@
+import type { ViewFilter } from "./types.js";
+export declare function matchesScope(view: ViewFilter | undefined, scope: string): boolean;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,YAAK,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAO1E"}