@powerhousedao/reactor 4.1.0-dev.73 → 4.1.0-dev.75

package/dist/src/job-tracker/in-memory-job-tracker.js

@@ -0,0 +1,78 @@
+import { JobStatus } from "../shared/types.js";
+/**
+ * In-memory implementation of IJobTracker.
+ * Maintains job status in a Map for synchronous access.
+ */
+export class InMemoryJobTracker {
+    jobs = new Map();
+    registerJob(jobInfo) {
+        this.jobs.set(jobInfo.id, { ...jobInfo });
+    }
+    markRunning(jobId) {
+        const job = this.jobs.get(jobId);
+        if (!job) {
+            // Job not found - might have been registered elsewhere
+            // Create minimal job entry
+            this.jobs.set(jobId, {
+                id: jobId,
+                status: JobStatus.RUNNING,
+                createdAtUtcIso: new Date().toISOString(),
+            });
+            return;
+        }
+        // Update existing job
+        this.jobs.set(jobId, {
+            ...job,
+            status: JobStatus.RUNNING,
+        });
+    }
+    markCompleted(jobId, result) {
+        const job = this.jobs.get(jobId);
+        if (!job) {
+            // Job not found - create minimal completed entry
+            this.jobs.set(jobId, {
+                id: jobId,
+                status: JobStatus.COMPLETED,
+                createdAtUtcIso: new Date().toISOString(),
+                completedAtUtcIso: new Date().toISOString(),
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+                result,
+            });
+            return;
+        }
+        // Update existing job
+        this.jobs.set(jobId, {
+            ...job,
+            status: JobStatus.COMPLETED,
+            completedAtUtcIso: new Date().toISOString(),
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            result,
+        });
+    }
+    markFailed(jobId, error) {
+        const job = this.jobs.get(jobId);
+        if (!job) {
+            // Job not found - create minimal failed entry
+            this.jobs.set(jobId, {
+                id: jobId,
+                status: JobStatus.FAILED,
+                createdAtUtcIso: new Date().toISOString(),
+                completedAtUtcIso: new Date().toISOString(),
+                error,
+            });
+            return;
+        }
+        // Update existing job
+        this.jobs.set(jobId, {
+            ...job,
+            status: JobStatus.FAILED,
+            completedAtUtcIso: new Date().toISOString(),
+            error,
+        });
+    }
+    getJobStatus(jobId) {
+        const job = this.jobs.get(jobId);
+        return job ? { ...job } : null;
+    }
+}
+//# sourceMappingURL=in-memory-job-tracker.js.map

package/dist/src/job-tracker/in-memory-job-tracker.js.map

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

package/dist/src/job-tracker/index.d.ts

@@ -0,0 +1,3 @@
+export { InMemoryJobTracker } from "./in-memory-job-tracker.js";
+export type { IJobTracker } from "./interfaces.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/job-tracker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/job-tracker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/job-tracker/index.js

@@ -0,0 +1,2 @@
+export { InMemoryJobTracker } from "./in-memory-job-tracker.js";
+//# sourceMappingURL=index.js.map

package/dist/src/job-tracker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/job-tracker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/job-tracker/interfaces.d.ts

@@ -0,0 +1,41 @@
+import type { JobInfo } from "../shared/types.js";
+/**
+ * Interface for tracking job lifecycle status.
+ * Maintains job state throughout execution: PENDING → RUNNING → COMPLETED/FAILED.
+ */
+export interface IJobTracker {
+    /**
+     * Register a new job with PENDING status.
+     *
+     * @param jobInfo - The job information to register
+     */
+    registerJob(jobInfo: JobInfo): void;
+    /**
+     * Update a job's status to RUNNING.
+     *
+     * @param jobId - The job ID to mark as running
+     */
+    markRunning(jobId: string): void;
+    /**
+     * Mark a job as completed successfully.
+     *
+     * @param jobId - The job ID to mark as completed
+     * @param result - Optional result data from the job execution
+     */
+    markCompleted(jobId: string, result?: any): void;
+    /**
+     * Mark a job as failed.
+     *
+     * @param jobId - The job ID to mark as failed
+     * @param error - Error message describing the failure
+     */
+    markFailed(jobId: string, error: string): void;
+    /**
+     * Retrieve the current status of a job.
+     *
+     * @param jobId - The job ID to query
+     * @returns The job information, or null if the job is not found
+     */
+    getJobStatus(jobId: string): JobInfo | null;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/src/job-tracker/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/job-tracker/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAEpC;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IAEjD;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/C;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CAC7C"}

package/dist/src/job-tracker/interfaces.js

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

package/dist/src/job-tracker/interfaces.js.map

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

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

@@ -28,12 +28,12 @@ export type Job = {
     id: string;
     /** The document ID this job operates on */
     documentId: string;
-    /** The scope of the operation */
+    /** The scope of the operations */
     scope: string;
-    /** The branch of the operation */
+    /** The branch of the operations */
     branch: string;
-    /** The operation to be executed */
-    operation: Operation;
+    /** The operations to be executed (processed sequentially) */
+    operations: Operation[];
     /** Timestamp when the job was created */
     createdAt: string;
     /** The hint for the queue to use for ordering the job */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/queue/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,oBAAY,aAAa;IACvB,OAAO,KAAK;IACZ,aAAa,IAAI;IACjB,OAAO,IAAI;IACX,KAAK,IAAI;IACT,OAAO,IAAI;IACX,QAAQ,IAAI;CACb;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,IAAI,IAAI,CAAC;IACjB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG;IAChB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IAEX,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IAEnB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IAEd,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IAEf,mCAAmC;IACnC,SAAS,EAAE,SAAS,CAAC;IAErB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAElB,yDAAyD;IACzD,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;CAElB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/queue/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,oBAAY,aAAa;IACvB,OAAO,KAAK;IACZ,aAAa,IAAI;IACjB,OAAO,IAAI;IACX,KAAK,IAAI;IACT,OAAO,IAAI;IACX,QAAQ,IAAI;CACb;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,IAAI,IAAI,CAAC;IACjB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG;IAChB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IAEX,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IAEd,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IAEf,6DAA6D;IAC7D,UAAU,EAAE,SAAS,EAAE,CAAC;IAExB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAElB,yDAAyD;IACzD,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;CAElB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/src/read-models/coordinator.d.ts

@@ -0,0 +1,38 @@
+import type { IEventBus } from "../events/interfaces.js";
+import type { IReadModel, IReadModelCoordinator } from "./interfaces.js";
+/**
+ * Coordinates read model synchronization by listening to operation write events
+ * and updating all registered read models in parallel.
+ *
+ * This coordinator is responsible for:
+ * - Subscribing to OPERATION_WRITTEN events from the event bus
+ * - Distributing operation updates to all registered read models
+ * - Managing the lifecycle of read model subscriptions
+ *
+ * Read models are updated asynchronously and in parallel to avoid blocking
+ * the write path. Errors in read model updates are propagated through the
+ * event bus but do not affect the write operation success.
+ */
+export declare class ReadModelCoordinator implements IReadModelCoordinator {
+    private eventBus;
+    private readModels;
+    private unsubscribe?;
+    private isRunning;
+    constructor(eventBus: IEventBus, readModels: IReadModel[]);
+    /**
+     * Start listening for operation events and updating read models.
+     * Can be called multiple times safely (subsequent calls are no-ops).
+     */
+    start(): void;
+    /**
+     * Stop listening and clean up subscriptions.
+     * Can be called multiple times safely (subsequent calls are no-ops).
+     */
+    stop(): void;
+    /**
+     * Handle operation written events by updating all read models in parallel.
+     * Errors from individual read models are collected and re-thrown as an aggregate.
+     */
+    private handleOperationWritten;
+}
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/src/read-models/coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/read-models/coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAMzD,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAK9D,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,UAAU;IALpB,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,SAAS,CAAS;gBAGhB,QAAQ,EAAE,SAAS,EACnB,UAAU,EAAE,UAAU,EAAE;IAGlC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAgBb;;;OAGG;IACH,IAAI,IAAI,IAAI;IAaZ;;;OAGG;YACW,sBAAsB;CAWrC"}

package/dist/src/read-models/coordinator.js

@@ -0,0 +1,62 @@
+import { OperationEventTypes, } from "../events/types.js";
+/**
+ * Coordinates read model synchronization by listening to operation write events
+ * and updating all registered read models in parallel.
+ *
+ * This coordinator is responsible for:
+ * - Subscribing to OPERATION_WRITTEN events from the event bus
+ * - Distributing operation updates to all registered read models
+ * - Managing the lifecycle of read model subscriptions
+ *
+ * Read models are updated asynchronously and in parallel to avoid blocking
+ * the write path. Errors in read model updates are propagated through the
+ * event bus but do not affect the write operation success.
+ */
+export class ReadModelCoordinator {
+    eventBus;
+    readModels;
+    unsubscribe;
+    isRunning = false;
+    constructor(eventBus, readModels) {
+        this.eventBus = eventBus;
+        this.readModels = readModels;
+    }
+    /**
+     * Start listening for operation events and updating read models.
+     * Can be called multiple times safely (subsequent calls are no-ops).
+     */
+    start() {
+        if (this.isRunning) {
+            return;
+        }
+        // Subscribe to OPERATION_WRITTEN events
+        this.unsubscribe = this.eventBus.subscribe(OperationEventTypes.OPERATION_WRITTEN, async (type, event) => {
+            await this.handleOperationWritten(event);
+        });
+        this.isRunning = true;
+    }
+    /**
+     * Stop listening and clean up subscriptions.
+     * Can be called multiple times safely (subsequent calls are no-ops).
+     */
+    stop() {
+        if (!this.isRunning) {
+            return;
+        }
+        if (this.unsubscribe) {
+            this.unsubscribe();
+            this.unsubscribe = undefined;
+        }
+        this.isRunning = false;
+    }
+    /**
+     * Handle operation written events by updating all read models in parallel.
+     * Errors from individual read models are collected and re-thrown as an aggregate.
+     */
+    async handleOperationWritten(event) {
+        // Index into all read models in parallel
+        // If any read model fails, the error will be collected by the event bus
+        await Promise.all(this.readModels.map((readModel) => readModel.indexOperations(event.operations)));
+    }
+}
+//# sourceMappingURL=coordinator.js.map

package/dist/src/read-models/coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.js","sourceRoot":"","sources":["../../../src/read-models/coordinator.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,GAGpB,MAAM,oBAAoB,CAAC;AAG5B;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,oBAAoB;IAKrB;IACA;IALF,WAAW,CAAe;IAC1B,SAAS,GAAG,KAAK,CAAC;IAE1B,YACU,QAAmB,EACnB,UAAwB;QADxB,aAAQ,GAAR,QAAQ,CAAW;QACnB,eAAU,GAAV,UAAU,CAAc;IAC/B,CAAC;IAEJ;;;OAGG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,wCAAwC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CACxC,mBAAmB,CAAC,iBAAiB,EACrC,KAAK,EAAE,IAAI,EAAE,KAA4B,EAAE,EAAE;YAC3C,MAAM,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC,CACF,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC/B,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,sBAAsB,CAClC,KAA4B;QAE5B,yCAAyC;QACzC,wEAAwE;QACxE,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAChC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,CAC5C,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/read-models/document-view.d.ts

@@ -1,6 +1,6 @@
-import type { PHDocumentHeader } from "document-model";
+import type { PHDocument } from "document-model";
 import type { Kysely } from "kysely";
-import type { DocumentSnapshot, IDocumentView, IOperationStore, OperationWithContext } from "../storage/interfaces.js";
+import type { IDocumentView, IOperationStore, OperationWithContext, ViewFilter } from "../storage/interfaces.js";
 import type { Database as StorageDatabase } from "../storage/kysely/types.js";
 import type { DocumentViewDatabase } from "./types.js";
 type Database = StorageDatabase & DocumentViewDatabase;
@@ -11,11 +11,10 @@ export declare class KyselyDocumentView implements IDocumentView {
     constructor(db: Kysely<Database>, operationStore: IOperationStore);
     init(): Promise<void>;
     indexOperations(items: OperationWithContext[]): Promise<void>;
-    getHeader(documentId: string, branch: string, signal?: AbortSignal): Promise<PHDocumentHeader>;
     exists(documentIds: string[], signal?: AbortSignal): Promise<boolean[]>;
-    getMany(documentIds: string[], scope?: string, branch?: string, signal?: AbortSignal): Promise<(DocumentSnapshot | null)[]>;
-    private createTablesIfNotExist;
+    get<TDocument extends PHDocument>(documentId: string, view?: ViewFilter, signal?: AbortSignal): Promise<TDocument>;
     private checkTablesExist;
+    private createTablesIfNotExist;
 }
 export {};
 //# sourceMappingURL=document-view.d.ts.map

package/dist/src/read-models/document-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-view.d.ts","sourceRoot":"","sources":["../../../src/read-models/document-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAEjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAGpB,KAAK,QAAQ,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAEvD,qBAAa,kBAAmB,YAAW,aAAa;IAIpD,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,cAAc;IAJxB,OAAO,CAAC,eAAe,CAAa;gBAG1B,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,EACpB,cAAc,EAAE,eAAe;IAGnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCrB,eAAe,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwD7D,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,gBAAgB,CAAC;IAgEtB,MAAM,CACV,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,EAAE,CAAC;IAyBf,OAAO,CACX,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,GAAE,MAAiB,EACxB,MAAM,GAAE,MAAe,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,CAAC;YA0BzB,sBAAsB;YAuGtB,gBAAgB;CAa/B"}
+{"version":3,"file":"document-view.d.ts","sourceRoot":"","sources":["../../../src/read-models/document-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,UAAU,EAAoB,MAAM,gBAAgB,CAAC;AAE9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,UAAU,EACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAGpB,KAAK,QAAQ,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAEvD,qBAAa,kBAAmB,YAAW,aAAa;IAIpD,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,cAAc;IAJxB,OAAO,CAAC,eAAe,CAAa;gBAG1B,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,EACpB,cAAc,EAAE,eAAe;IAGnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCrB,eAAe,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoF7D,MAAM,CACV,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,EAAE,CAAC;IAyBf,GAAG,CAAC,SAAS,SAAS,UAAU,EACpC,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,UAAU,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,CAAC;YA4HP,gBAAgB;YAchB,sBAAsB;CAsGrC"}

package/dist/src/read-models/document-view.js

@@ -1,4 +1,4 @@
-import { createPresignedHeader } from "document-model/core";
+import { defaultBaseState } from "document-model/core";
 import { v4 as uuidv4 } from "uuid";
 export class KyselyDocumentView {
     db;
@@ -47,103 +47,72 @@ export class KyselyDocumentView {
                 const { operation, context } = item;
                 const { documentId, scope, branch, documentType } = context;
                 const { index, hash } = operation;
-                // Check if we need to create or update a snapshot
-                const existingSnapshot = await trx
-                    .selectFrom("DocumentSnapshot")
-                    .selectAll()
-                    .where("documentId", "=", documentId)
-                    .where("scope", "=", scope)
-                    .where("branch", "=", branch)
-                    .executeTakeFirst();
-                if (existingSnapshot) {
-                    // Update existing snapshot
-                    await trx
-                        .updateTable("DocumentSnapshot")
-                        .set({
-                        lastOperationIndex: index,
-                        lastOperationHash: hash,
-                        lastUpdatedAt: new Date(),
-                        snapshotVersion: existingSnapshot.snapshotVersion + 1,
-                    })
+                // Parse the full resulting state if present
+                let fullState = {};
+                if (operation.resultingState) {
+                    try {
+                        fullState = JSON.parse(operation.resultingState);
+                    }
+                    catch {
+                        // Failed to parse resultingState, use empty state
+                    }
+                }
+                // If resultingState is present, create/update snapshots for ALL scopes in the state
+                // Otherwise, fall back to creating/updating a snapshot for just the operation's scope
+                const scopesToIndex = Object.keys(fullState).length > 0
+                    ? Object.entries(fullState)
+                    : [[scope, {}]];
+                for (const [scopeName, scopeState] of scopesToIndex) {
+                    // Check if we need to create or update a snapshot for this scope
+                    const existingSnapshot = await trx
+                        .selectFrom("DocumentSnapshot")
+                        .selectAll()
                         .where("documentId", "=", documentId)
-                        .where("scope", "=", scope)
+                        .where("scope", "=", scopeName)
                         .where("branch", "=", branch)
-                        .execute();
-                }
-                else {
-                    // Create new snapshot
-                    const snapshot = {
-                        id: uuidv4(),
-                        documentId,
-                        slug: null,
-                        name: null,
-                        scope,
-                        branch,
-                        content: JSON.stringify({}), // Empty for now, will be filled when we build full documents
-                        documentType,
-                        lastOperationIndex: index,
-                        lastOperationHash: hash,
-                        identifiers: null,
-                        metadata: null,
-                        deletedAt: null,
-                    };
-                    await trx.insertInto("DocumentSnapshot").values(snapshot).execute();
+                        .executeTakeFirst();
+                    const newState = typeof scopeState === "object" && scopeState !== null
+                        ? scopeState
+                        : {};
+                    if (existingSnapshot) {
+                        // Update existing snapshot with new state
+                        await trx
+                            .updateTable("DocumentSnapshot")
+                            .set({
+                            lastOperationIndex: index,
+                            lastOperationHash: hash,
+                            lastUpdatedAt: new Date(),
+                            snapshotVersion: existingSnapshot.snapshotVersion + 1,
+                            content: JSON.stringify(newState),
+                        })
+                            .where("documentId", "=", documentId)
+                            .where("scope", "=", scopeName)
+                            .where("branch", "=", branch)
+                            .execute();
+                    }
+                    else {
+                        // Create new snapshot with computed state
+                        const snapshot = {
+                            id: uuidv4(),
+                            documentId,
+                            slug: null,
+                            name: null,
+                            scope: scopeName,
+                            branch,
+                            content: JSON.stringify(newState),
+                            documentType,
+                            lastOperationIndex: index,
+                            lastOperationHash: hash,
+                            identifiers: null,
+                            metadata: null,
+                            deletedAt: null,
+                        };
+                        await trx.insertInto("DocumentSnapshot").values(snapshot).execute();
+                    }
                 }
             }
         });
     }
-    async getHeader(documentId, branch, signal) {
-        if (signal?.aborted) {
-            throw new Error("Operation aborted");
-        }
-        // Query operations from header and document scopes only
-        // - "header" scope: CREATE_DOCUMENT actions contain initial header metadata
-        // - "document" scope: UPGRADE_DOCUMENT actions contain version transitions
-        const headerAndDocOps = await this.db
-            .selectFrom("Operation")
-            .selectAll()
-            .where("documentId", "=", documentId)
-            .where("branch", "=", branch)
-            .where("scope", "in", ["header", "document"])
-            .orderBy("timestampUtcMs", "asc") // Process in chronological order
-            .execute();
-        if (headerAndDocOps.length === 0) {
-            throw new Error(`Document header not found: ${documentId}`);
-        }
-        // Reconstruct header from header and document scope operations
-        let header = createPresignedHeader();
-        for (const op of headerAndDocOps) {
-            const action = JSON.parse(op.action);
-            if (action.type === "CREATE_DOCUMENT") {
-                const input = action.input;
-                // Extract header from CREATE_DOCUMENT action's signing parameters
-                if (input.signing) {
-                    header = {
-                        ...header,
-                        id: input.signing.signature, // documentId === signing.signature
-                        documentType: input.signing.documentType,
-                        createdAtUtcIso: input.signing.createdAtUtcIso,
-                        lastModifiedAtUtcIso: input.signing.createdAtUtcIso,
-                        sig: {
-                            nonce: input.signing.nonce,
-                            publicKey: input.signing.publicKey,
-                        },
-                    };
-                }
-            }
-            else if (action.type === "UPGRADE_DOCUMENT") {
-                // UPGRADE_DOCUMENT tracks version changes in the document scope
-                // Version information would be in the operation's resulting state
-                // For now, this is handled elsewhere in the document state
-            }
-        }
-        // Get revision map and latest timestamp from all scopes efficiently
-        const { revision, latestTimestamp } = await this.operationStore.getRevisions(documentId, branch, signal);
-        // Update header with cross-scope revision and timestamp information
-        header.revision = revision;
-        header.lastModifiedAtUtcIso = latestTimestamp;
-        return header;
-    }
     async exists(documentIds, signal) {
         if (signal?.aborted) {
             throw new Error("Operation aborted");
@@ -164,26 +133,122 @@ export class KyselyDocumentView {
         // Return a boolean array in the same order as the input
         return documentIds.map((id) => existingIds.has(id));
     }
-    async getMany(documentIds, scope = "global", branch = "main", signal) {
+    async get(documentId, view, signal) {
         if (signal?.aborted) {
             throw new Error("Operation aborted");
         }
-        if (documentIds.length === 0) {
-            return [];
+        const branch = view?.branch || "main";
+        // Determine which scopes to retrieve
+        let scopesToQuery;
+        if (view?.scopes && view.scopes.length > 0) {
+            // If scopes has values, always include header + document + specified scopes
+            // (header and document are the minimum scopes that must be returned)
+            scopesToQuery = [...new Set(["header", "document", ...view.scopes])];
         }
-        // Query for all documents at once
-        const snapshots = await this.db
+        else {
+            // If scopes is undefined, null, or empty array [], get all scopes (no filter)
+            scopesToQuery = [];
+        }
+        // Build query to get snapshots
+        let query = this.db
             .selectFrom("DocumentSnapshot")
             .selectAll()
-            .where("documentId", "in", documentIds)
-            .where("scope", "=", scope)
+            .where("documentId", "=", documentId)
             .where("branch", "=", branch)
-            .where("isDeleted", "=", false)
-            .execute();
-        // Create a Map of document ID to snapshot for fast lookup
-        const snapshotMap = new Map(snapshots.map((s) => [s.documentId, s]));
-        // Return an array in the same order as the input, with null for missing documents
-        return documentIds.map((id) => snapshotMap.get(id) || null);
+            .where("isDeleted", "=", false);
+        // Apply scope filter if we have specific scopes to query
+        if (scopesToQuery.length > 0) {
+            query = query.where("scope", "in", scopesToQuery);
+        }
+        // Execute the query
+        const snapshots = await query.execute();
+        if (snapshots.length === 0) {
+            throw new Error(`Document not found: ${documentId}`);
+        }
+        if (signal?.aborted) {
+            throw new Error("Operation aborted");
+        }
+        // Find the header snapshot
+        const headerSnapshot = snapshots.find((s) => s.scope === "header");
+        if (!headerSnapshot) {
+            throw new Error(`Document header not found: ${documentId}`);
+        }
+        // Parse the header
+        let header;
+        try {
+            header = JSON.parse(headerSnapshot.content);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse header for document ${documentId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Reconstruct the document state from all snapshots
+        // Note: exclude "header" scope from state since it's already in the header field
+        const state = {};
+        for (const snapshot of snapshots) {
+            // Skip header scope - it's stored separately in the header field
+            if (snapshot.scope === "header") {
+                continue;
+            }
+            try {
+                const scopeState = JSON.parse(snapshot.content);
+                state[snapshot.scope] = scopeState;
+            }
+            catch {
+                // Failed to parse snapshot content, use empty state
+                state[snapshot.scope] = {};
+            }
+        }
+        // Retrieve operations from the operation store to match legacy storage format
+        const operations = {};
+        // Get all operations for this document across all scopes
+        const allOps = await this.operationStore.getSinceId(0, signal);
+        const docOps = allOps.filter((op) => op.context.documentId === documentId && op.context.branch === branch);
+        // Group operations by scope and normalize to match legacy storage structure
+        for (const { operation, context } of docOps) {
+            if (!operations[context.scope]) {
+                operations[context.scope] = [];
+            }
+            // Normalize operation to match legacy storage format
+            // Legacy storage includes redundant top-level fields that duplicate action fields
+            const normalizedOp = {
+                action: operation.action,
+                index: operation.index,
+                timestampUtcMs: operation.timestampUtcMs,
+                hash: operation.hash,
+                skip: operation.skip,
+                // Add top-level fields that mirror action fields (legacy format)
+                ...operation.action,
+                // Legacy storage includes these optional fields
+                error: operation.error,
+                resultingState: operation.resultingState,
+            };
+            operations[context.scope].push(normalizedOp);
+        }
+        // Construct the PHDocument
+        const document = {
+            header,
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            state: state,
+            operations,
+            // to be removed...
+            initialState: defaultBaseState(),
+            clipboard: [],
+        };
+        return document;
+    }
+    async checkTablesExist() {
+        try {
+            // Try to query ViewState table
+            await this.db
+                .selectFrom("ViewState")
+                .select("lastOperationId")
+                .limit(1)
+                .execute();
+            return true;
+        }
+        catch {
+            return false;
+        }
     }
     async createTablesIfNotExist() {
         // Check if tables exist by trying to query them
@@ -267,19 +332,5 @@ export class KyselyDocumentView {
                 .execute();
         }
     }
-    async checkTablesExist() {
-        try {
-            // Try to query ViewState table
-            await this.db
-                .selectFrom("ViewState")
-                .select("lastOperationId")
-                .limit(1)
-                .execute();
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
 }
 //# sourceMappingURL=document-view.js.map