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

package/dist/index.cjs

@@ -69,6 +69,7 @@ function encodeRichtext(value) {
   }
   if (typeof value === "string") {
     const doc = new Y.Doc();
+    doc.clientID = 0;
     doc.getText(TEXT_KEY).insert(0, value);
     return Y.encodeStateAsUpdate(doc);
   }
@@ -995,6 +996,7 @@ __export(index_exports, {
   InvalidStateTransitionError: () => InvalidStateTransitionError,
   LAST_ACKED_SERVER_VECTOR_META_KEY: () => LAST_ACKED_SERVER_VECTOR_META_KEY,
   MemoryBlobStore: () => MemoryBlobStore,
+  NoLeaderError: () => NoLeaderError,
   OpfsBlobStore: () => OpfsBlobStore,
   OptimisticLockError: () => OptimisticLockError,
   PersistenceError: () => PersistenceError,
@@ -1113,6 +1115,16 @@ var WorkerTimeoutError = class extends import_core.KoraError {
     this.name = "WorkerTimeoutError";
   }
 };
+var NoLeaderError = class extends import_core.KoraError {
+  constructor(operation) {
+    super(
+      `No live leader tab is answering multi-tab storage RPC for operation "${operation}"`,
+      "NO_LEADER",
+      { operation }
+    );
+    this.name = "NoLeaderError";
+  }
+};
 var PersistenceError = class extends import_core.KoraError {
   constructor(message, context) {
     super(`Persistence error: ${message}`, "PERSISTENCE_ERROR", context);
@@ -1187,6 +1199,7 @@ function buildDeleteSql(table, withAge) {
 var import_core3 = require("@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) {
@@ -1259,6 +1272,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
 var import_core23 = require("@korajs/core");
@@ -3880,7 +3932,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 = ?`,
@@ -3902,7 +3955,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 = {
@@ -4054,7 +4107,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 ${(0, import_core23.quoteIdent)(`_kora_ops_${collection}`)} WHERE record_id = ? AND type IN ('update', 'delete')`,
       [recordId]
@@ -4103,6 +4156,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) => import_core23.HybridLogicalClock.compare(a.timestamp, b.timestamp)
+      );
+      const folded = (0, import_core23.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) => `${(0, import_core23.quoteIdent)(c)} = ?`).join(", ");
+          await tx.execute(`UPDATE ${(0, import_core23.quoteIdent)(collection)} SET ${setClause} WHERE id = ?`, [
+            ...cols.map((c) => serialized[c]),
+            recordId
+          ]);
+        }
+      }
+    }
   }
   /**
    * Get operations from a node within a sequence number range.
@@ -4316,6 +4400,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.
    */
@@ -4406,6 +4519,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 ${(0, import_core23.quoteIdent)(`_kora_ops_${collection}`)} WHERE record_id = ?`,
+      [recordId]
+    );
+    const ops = rows.map((row) => deserializeOperationWithCollection(row, collection));
+    ops.sort((a, b) => import_core23.HybridLogicalClock.compare(a.timestamp, b.timestamp));
+    return ops;
+  }
   /** Expose the subscription manager for direct access (e.g., by QueryBuilder) */
   getSubscriptionManager() {
     return this.subscriptionManager;
@@ -5700,6 +5828,7 @@ function createChunkPortPair() {
   InvalidStateTransitionError,
   LAST_ACKED_SERVER_VECTOR_META_KEY,
   MemoryBlobStore,
+  NoLeaderError,
   OpfsBlobStore,
   OptimisticLockError,
   PersistenceError,