@korajs/store 1.0.0-beta.4 → 1.0.0-beta.5

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { C as CollectionRecord, S as StorageAdapter, Q as QueryDescriptor, c as SubscriptionCallback, W as WhereClause, d as OrderByDirection, L as LocalMutationHandler, e as StoreConfig, A as ApplyRemoteOptions, f as MaterializedRowSnapshot, g as RowVersionState } from './types-k6AZgiH4.cjs';
-export { M as MigrationPlan, h as OrderByClause, i as StoreIsolation, T as Transaction, j as TransactionBufferedEntry, k as TransactionCommitBatch, l as TransactionCommitResult, m as WhereOperators } from './types-k6AZgiH4.cjs';
+import { C as CollectionRecord, S as StorageAdapter, Q as QueryDescriptor, c as SubscriptionCallback, W as WhereClause, d as OrderByDirection, L as LocalMutationHandler, e as StoreConfig, A as ApplyRemoteOptions, f as MaterializedRowSnapshot, g as RowVersionState } from './types-D1MzKVmk.cjs';
+export { M as MigrationPlan, h as OrderByClause, i as StoreIsolation, T as Transaction, j as TransactionBufferedEntry, k as TransactionCommitBatch, l as TransactionCommitResult, m as WhereOperators } from './types-D1MzKVmk.cjs';
 import { Operation, KoraError, VersionVector, SchemaDefinition, HLCTimestamp, MergeTrace, CollectionDefinition, SequenceConfig, HybridLogicalClock, CausalTracker, OperationLog, ApplyResult, StateMachineDefinition, KoraBytesValue, KoraEvent, BlobRefMetadata, BlobRef } from '@korajs/core';
 export { ApplyResult } from '@korajs/core';
-import { R as RelationEnforcer, L as LocalMutationContext } from './types-DfPiPwKr.cjs';
-export { C as Collection } from './types-DfPiPwKr.cjs';
+import { R as RelationEnforcer, L as LocalMutationContext } from './types-DAo9oduO.cjs';
+export { C as Collection } from './types-DAo9oduO.cjs';
 import * as yjs from 'yjs';
 import { C as ContentAddressedBlobStore, M as MemoryBlobStore } from './content-addressed-blob-store-Dcj3SB9r.cjs';
 export { B as BlobIntegrityError } from './content-addressed-blob-store-Dcj3SB9r.cjs';
@@ -858,6 +858,23 @@ declare class Store implements OperationLog {
      * Persist or clear the delta cursor for paginated initial sync resume.
      */
     saveDeltaCursor(cursor: string | null): Promise<void>;
+    /**
+     * Load the persisted delivery watermark for a view signature (0 when none recorded).
+     * Defaults to the unfiltered view so existing single-watermark reads keep working.
+     */
+    loadDeliveryWatermark(signature?: string): Promise<number>;
+    /**
+     * Persist the delivery watermark for a view signature so it survives a client restart.
+     */
+    saveDeliveryWatermark(signature: string, watermark: number): Promise<void>;
+    /**
+     * Load every persisted view watermark, keyed by signature.
+     */
+    loadAllDeliveryWatermarks(): Promise<Record<string, number>>;
+    /**
+     * Delete a persisted view watermark (safe: the view back-fills from 0 when next visited).
+     */
+    deleteDeliveryWatermark(signature: string): Promise<void>;
     /**
      * Local operations not yet reflected on the server version vector.
      */
@@ -892,6 +909,12 @@ declare class Store implements OperationLog {
      * Latest operation for a record from any node (for 3-way merge when local op log is empty).
      */
     getLatestOperationForRecord(collection: string, recordId: string): Promise<Operation | null>;
+    /**
+     * All operations for a record, sorted in HLC total order (wallTime, logical,
+     * nodeId). Used by the apply pipeline to materialize atomic-op fields by folding
+     * the record's log, matching the server's materialization exactly.
+     */
+    getOperationsForRecord(collection: string, recordId: string): Promise<Operation[]>;
     /** Expose the subscription manager for direct access (e.g., by QueryBuilder) */
     getSubscriptionManager(): SubscriptionManager;
     /**

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { C as CollectionRecord, S as StorageAdapter, Q as QueryDescriptor, c as SubscriptionCallback, W as WhereClause, d as OrderByDirection, L as LocalMutationHandler, e as StoreConfig, A as ApplyRemoteOptions, f as MaterializedRowSnapshot, g as RowVersionState } from './types-k6AZgiH4.js';
-export { M as MigrationPlan, h as OrderByClause, i as StoreIsolation, T as Transaction, j as TransactionBufferedEntry, k as TransactionCommitBatch, l as TransactionCommitResult, m as WhereOperators } from './types-k6AZgiH4.js';
+import { C as CollectionRecord, S as StorageAdapter, Q as QueryDescriptor, c as SubscriptionCallback, W as WhereClause, d as OrderByDirection, L as LocalMutationHandler, e as StoreConfig, A as ApplyRemoteOptions, f as MaterializedRowSnapshot, g as RowVersionState } from './types-D1MzKVmk.js';
+export { M as MigrationPlan, h as OrderByClause, i as StoreIsolation, T as Transaction, j as TransactionBufferedEntry, k as TransactionCommitBatch, l as TransactionCommitResult, m as WhereOperators } from './types-D1MzKVmk.js';
 import { Operation, KoraError, VersionVector, SchemaDefinition, HLCTimestamp, MergeTrace, CollectionDefinition, SequenceConfig, HybridLogicalClock, CausalTracker, OperationLog, ApplyResult, StateMachineDefinition, KoraBytesValue, KoraEvent, BlobRefMetadata, BlobRef } from '@korajs/core';
 export { ApplyResult } from '@korajs/core';
-import { R as RelationEnforcer, L as LocalMutationContext } from './types-5h4Hqcwc.js';
-export { C as Collection } from './types-5h4Hqcwc.js';
+import { R as RelationEnforcer, L as LocalMutationContext } from './types-C1kigrWz.js';
+export { C as Collection } from './types-C1kigrWz.js';
 import * as yjs from 'yjs';
 import { C as ContentAddressedBlobStore, M as MemoryBlobStore } from './content-addressed-blob-store-Dcj3SB9r.js';
 export { B as BlobIntegrityError } from './content-addressed-blob-store-Dcj3SB9r.js';
@@ -858,6 +858,23 @@ declare class Store implements OperationLog {
      * Persist or clear the delta cursor for paginated initial sync resume.
      */
     saveDeltaCursor(cursor: string | null): Promise<void>;
+    /**
+     * Load the persisted delivery watermark for a view signature (0 when none recorded).
+     * Defaults to the unfiltered view so existing single-watermark reads keep working.
+     */
+    loadDeliveryWatermark(signature?: string): Promise<number>;
+    /**
+     * Persist the delivery watermark for a view signature so it survives a client restart.
+     */
+    saveDeliveryWatermark(signature: string, watermark: number): Promise<void>;
+    /**
+     * Load every persisted view watermark, keyed by signature.
+     */
+    loadAllDeliveryWatermarks(): Promise<Record<string, number>>;
+    /**
+     * Delete a persisted view watermark (safe: the view back-fills from 0 when next visited).
+     */
+    deleteDeliveryWatermark(signature: string): Promise<void>;
     /**
      * Local operations not yet reflected on the server version vector.
      */
@@ -892,6 +909,12 @@ declare class Store implements OperationLog {
      * Latest operation for a record from any node (for 3-way merge when local op log is empty).
      */
     getLatestOperationForRecord(collection: string, recordId: string): Promise<Operation | null>;
+    /**
+     * All operations for a record, sorted in HLC total order (wallTime, logical,
+     * nodeId). Used by the apply pipeline to materialize atomic-op fields by folding
+     * the record's log, matching the server's materialization exactly.
+     */
+    getOperationsForRecord(collection: string, recordId: string): Promise<Operation[]>;
     /** Expose the subscription manager for direct access (e.g., by QueryBuilder) */
     getSubscriptionManager(): SubscriptionManager;
     /**

package/dist/index.js

@@ -3,12 +3,12 @@ import {
   readBackupManifest,
   restoreBackup,
   verifyBackupChecksum
-} from "./chunk-OCOGQRHW.js";
+} from "./chunk-HS6DBMST.js";
 import {
   decodeAuditExport,
   readAuditExportManifest,
   verifyAuditExportChecksum
-} from "./chunk-RCTG3IJG.js";
+} from "./chunk-CYO3YKFL.js";
 import {
   persistedAuditTraceFromEvent
 } from "./chunk-MYSJN3DF.js";
@@ -39,7 +39,7 @@ import {
   serializeRowVersion,
   validateStateTransition,
   validateUpdateStateMachine
-} from "./chunk-UXRWVXBP.js";
+} from "./chunk-RL43UYQZ.js";
 import {
   decodeRichtext,
   decodeRichtextFieldsFromOpData,
@@ -51,7 +51,7 @@ import {
   richtextToPlainText,
   serializeOperation,
   serializeRecord
-} from "./chunk-6NKLDBTY.js";
+} from "./chunk-GSJ7EEUC.js";
 import {
   AdapterError,
   NoLeaderError,
@@ -131,6 +131,7 @@ function buildDeleteSql(table, withAge) {
 import { createVersionVector as createVersionVector2 } from "@korajs/core";
 var LAST_ACKED_SERVER_VECTOR_META_KEY = "last_acked_server_vector";
 var DELTA_CURSOR_META_KEY = "delta_cursor";
+var DELIVERY_WATERMARK_META_KEY = "delivery_watermark";
 function serializeVersionVectorToMeta(vector) {
   const record = {};
   for (const [nodeId, seq] of vector) {
@@ -203,6 +204,45 @@ async function saveDeltaCursor(adapter, cursor) {
     cursor
   ]);
 }
+function deliveryWatermarkKey(signature) {
+  return signature === "" ? DELIVERY_WATERMARK_META_KEY : `${DELIVERY_WATERMARK_META_KEY}:${signature}`;
+}
+async function loadDeliveryWatermark(adapter, signature) {
+  const rows = await adapter.query("SELECT value FROM _kora_meta WHERE key = ?", [
+    deliveryWatermarkKey(signature)
+  ]);
+  const value = rows[0]?.value;
+  if (value === void 0 || value === null) {
+    return 0;
+  }
+  const parsed = Number(value);
+  return Number.isFinite(parsed) && parsed >= 0 ? parsed : 0;
+}
+async function saveDeliveryWatermark(adapter, signature, watermark) {
+  await adapter.execute("INSERT OR REPLACE INTO _kora_meta (key, value) VALUES (?, ?)", [
+    deliveryWatermarkKey(signature),
+    String(watermark)
+  ]);
+}
+async function deleteDeliveryWatermark(adapter, signature) {
+  await adapter.execute("DELETE FROM _kora_meta WHERE key = ?", [deliveryWatermarkKey(signature)]);
+}
+async function loadAllDeliveryWatermarks(adapter) {
+  const rows = await adapter.query(
+    "SELECT key, value FROM _kora_meta WHERE key = ? OR key LIKE ?",
+    [DELIVERY_WATERMARK_META_KEY, `${DELIVERY_WATERMARK_META_KEY}:%`]
+  );
+  const result = {};
+  const prefix = `${DELIVERY_WATERMARK_META_KEY}:`;
+  for (const row of rows) {
+    const signature = row.key === DELIVERY_WATERMARK_META_KEY ? "" : row.key.slice(prefix.length);
+    const parsed = Number(row.value);
+    if (Number.isFinite(parsed) && parsed >= 0) {
+      result[signature] = parsed;
+    }
+  }
+  return result;
+}
 
 // src/store/store.ts
 import {
@@ -211,7 +251,8 @@ import {
   createVersionVector as createVersionVector3,
   generateUUIDv7 as generateUUIDv73,
   migrationStepsToSQL,
-  quoteIdent as quoteIdent7
+  quoteIdent as quoteIdent7,
+  replayOperationsForRecord
 } from "@korajs/core";
 
 // src/collection/collection.ts
@@ -2196,7 +2237,8 @@ var Store = class {
           throw new OptimisticLockError(collection, op.recordId);
         }
       };
-      if (op.type === "insert" && materializeSource) {
+      if (options?.logOnly) {
+      } else if (op.type === "insert" && materializeSource) {
         const serializedData = serializeRecord(materializeSource, definition.fields);
         const existing2 = await tx.query(
           `SELECT _updated_at, _version, _field_versions, _deleted FROM ${collection} WHERE id = ?`,
@@ -2218,7 +2260,7 @@ var Store = class {
           };
           const insertQuery = buildInsertQuery(collection, record);
           await tx.execute(insertQuery.sql, insertQuery.params);
-          await this.foldOrphanedOperations(tx, collection, definition, op.recordId);
+          await this.foldOrphanedOperations(tx, collection, definition, op.recordId, op);
         } else if (row._deleted === 1) {
           if (isIncomingNewerThanRow(materializeTimestamp, row)) {
             const fieldChanges = {
@@ -2370,7 +2412,7 @@ var Store = class {
    * necessarily an orphan (rows are soft-deleted, never removed, so a row
    * that is absent now was never materialized).
    */
-  async foldOrphanedOperations(tx, collection, definition, recordId) {
+  async foldOrphanedOperations(tx, collection, definition, recordId, insertOp) {
     const orphanRows = await tx.query(
       `SELECT * FROM ${quoteIdent7(`_kora_ops_${collection}`)} WHERE record_id = ? AND type IN ('update', 'delete')`,
       [recordId]
@@ -2419,6 +2461,37 @@ var Store = class {
         await tx.execute(query.sql, query.params);
       }
     }
+    const atomicFields = /* @__PURE__ */ new Set();
+    for (const orphan of orphans) {
+      if (orphan.type === "update" && orphan.atomicOps) {
+        for (const field of Object.keys(orphan.atomicOps)) {
+          atomicFields.add(field);
+        }
+      }
+    }
+    if (atomicFields.size > 0) {
+      const ordered = [insertOp, ...orphans].sort(
+        (a, b) => HybridLogicalClock3.compare(a.timestamp, b.timestamp)
+      );
+      const folded = replayOperationsForRecord(ordered);
+      if (folded) {
+        const composed = {};
+        for (const field of atomicFields) {
+          if (field in folded) {
+            composed[field] = folded[field];
+          }
+        }
+        const serialized = serializeRecord(composed, definition.fields);
+        const cols = Object.keys(serialized);
+        if (cols.length > 0) {
+          const setClause = cols.map((c) => `${quoteIdent7(c)} = ?`).join(", ");
+          await tx.execute(`UPDATE ${quoteIdent7(collection)} SET ${setClause} WHERE id = ?`, [
+            ...cols.map((c) => serialized[c]),
+            recordId
+          ]);
+        }
+      }
+    }
   }
   /**
    * Get operations from a node within a sequence number range.
@@ -2505,7 +2578,7 @@ var Store = class {
    */
   async exportAudit(options) {
     this.ensureOpen();
-    const { exportAudit: doExport } = await import("./export-audit-MT2LTMIN.js");
+    const { exportAudit: doExport } = await import("./export-audit-ODGQTQIK.js");
     return doExport(this.adapter, this.schema, this.nodeId, this.schema.version, options);
   }
   /**
@@ -2632,6 +2705,35 @@ var Store = class {
     this.ensureOpen();
     await saveDeltaCursor(this.adapter, cursor);
   }
+  /**
+   * Load the persisted delivery watermark for a view signature (0 when none recorded).
+   * Defaults to the unfiltered view so existing single-watermark reads keep working.
+   */
+  async loadDeliveryWatermark(signature = "") {
+    this.ensureOpen();
+    return loadDeliveryWatermark(this.adapter, signature);
+  }
+  /**
+   * Persist the delivery watermark for a view signature so it survives a client restart.
+   */
+  async saveDeliveryWatermark(signature, watermark) {
+    this.ensureOpen();
+    await saveDeliveryWatermark(this.adapter, signature, watermark);
+  }
+  /**
+   * Load every persisted view watermark, keyed by signature.
+   */
+  async loadAllDeliveryWatermarks() {
+    this.ensureOpen();
+    return loadAllDeliveryWatermarks(this.adapter);
+  }
+  /**
+   * Delete a persisted view watermark (safe: the view back-fills from 0 when next visited).
+   */
+  async deleteDeliveryWatermark(signature) {
+    this.ensureOpen();
+    await deleteDeliveryWatermark(this.adapter, signature);
+  }
   /**
    * Local operations not yet reflected on the server version vector.
    */
@@ -2722,6 +2824,21 @@ var Store = class {
     }
     return latest;
   }
+  /**
+   * All operations for a record, sorted in HLC total order (wallTime, logical,
+   * nodeId). Used by the apply pipeline to materialize atomic-op fields by folding
+   * the record's log, matching the server's materialization exactly.
+   */
+  async getOperationsForRecord(collection, recordId) {
+    this.ensureOpen();
+    const rows = await this.adapter.query(
+      `SELECT * FROM ${quoteIdent7(`_kora_ops_${collection}`)} WHERE record_id = ?`,
+      [recordId]
+    );
+    const ops = rows.map((row) => deserializeOperationWithCollection(row, collection));
+    ops.sort((a, b) => HybridLogicalClock3.compare(a.timestamp, b.timestamp));
+    return ops;
+  }
   /** Expose the subscription manager for direct access (e.g., by QueryBuilder) */
   getSubscriptionManager() {
     return this.subscriptionManager;
@@ -2800,7 +2917,7 @@ var Store = class {
    */
   async exportBackup(options) {
     this.ensureOpen();
-    const { exportBackup: doExport } = await import("./backup-IQE4QC7Q.js");
+    const { exportBackup: doExport } = await import("./backup-5S7K2Z35.js");
     return doExport(this.adapter, this.schema, this.nodeId, this.schema.version, options);
   }
   /**
@@ -2812,7 +2929,7 @@ var Store = class {
    */
   async importBackup(data, options) {
     this.ensureOpen();
-    const { restoreBackup: doRestore } = await import("./backup-IQE4QC7Q.js");
+    const { restoreBackup: doRestore } = await import("./backup-5S7K2Z35.js");
     return doRestore(this.adapter, this.schema, data, options);
   }
   /**