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

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, d as SubscriptionCallback, W as WhereClause, e as OrderByDirection, L as LocalMutationHandler, f as StoreConfig, A as ApplyRemoteOptions, g as MaterializedRowSnapshot, h as RowVersionState } from './types-BslDOTk0.cjs';
+export { M as MigrationPlan, i as OrderByClause, j as StorageFallbackReason, a as StorageOpenState, k as StoreIsolation, T as Transaction, l as TransactionBufferedEntry, m as TransactionCommitBatch, n as TransactionCommitResult, o as WhereOperators } from './types-BslDOTk0.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-C_GDavG-.cjs';
+export { C as Collection } from './types-C_GDavG-.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';
@@ -820,6 +820,14 @@ declare class Store implements OperationLog {
      * Route local CRUD through the unified apply pipeline (korajs ApplyPipeline).
      */
     setLocalMutationHandler(handler: LocalMutationHandler | null): void;
+    /**
+     * Notify this store that another same-origin runtime committed an operation to
+     * the shared local database. The operation has already been persisted and
+     * materialized by the database owner; this method only advances in-memory causal
+     * watermarks and invalidates local reactive queries so already-open tabs stay
+     * live without reapplying or rewriting the operation.
+     */
+    notifyExternalOperation(operation: Operation): void;
     /**
      * Build mutation context for a collection (used by ApplyPipeline side effects).
      */
@@ -858,6 +866,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 +917,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, d as SubscriptionCallback, W as WhereClause, e as OrderByDirection, L as LocalMutationHandler, f as StoreConfig, A as ApplyRemoteOptions, g as MaterializedRowSnapshot, h as RowVersionState } from './types-BslDOTk0.js';
+export { M as MigrationPlan, i as OrderByClause, j as StorageFallbackReason, a as StorageOpenState, k as StoreIsolation, T as Transaction, l as TransactionBufferedEntry, m as TransactionCommitBatch, n as TransactionCommitResult, o as WhereOperators } from './types-BslDOTk0.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-BOO9EPt1.js';
+export { C as Collection } from './types-BOO9EPt1.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';
@@ -820,6 +820,14 @@ declare class Store implements OperationLog {
      * Route local CRUD through the unified apply pipeline (korajs ApplyPipeline).
      */
     setLocalMutationHandler(handler: LocalMutationHandler | null): void;
+    /**
+     * Notify this store that another same-origin runtime committed an operation to
+     * the shared local database. The operation has already been persisted and
+     * materialized by the database owner; this method only advances in-memory causal
+     * watermarks and invalidates local reactive queries so already-open tabs stay
+     * live without reapplying or rewriting the operation.
+     */
+    notifyExternalOperation(operation: Operation): void;
     /**
      * Build mutation context for a collection (used by ApplyPipeline side effects).
      */
@@ -858,6 +866,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 +917,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

@@ -1,14 +1,8 @@
-import {
-  exportBackup,
-  readBackupManifest,
-  restoreBackup,
-  verifyBackupChecksum
-} from "./chunk-OCOGQRHW.js";
 import {
   decodeAuditExport,
   readAuditExportManifest,
   verifyAuditExportChecksum
-} from "./chunk-RCTG3IJG.js";
+} from "./chunk-CYO3YKFL.js";
 import {
   persistedAuditTraceFromEvent
 } from "./chunk-MYSJN3DF.js";
@@ -39,19 +33,7 @@ import {
   serializeRowVersion,
   validateStateTransition,
   validateUpdateStateMachine
-} from "./chunk-UXRWVXBP.js";
-import {
-  decodeRichtext,
-  decodeRichtextFieldsFromOpData,
-  deserializeOperationWithCollection,
-  deserializeRecord,
-  encodeRichtext,
-  encodeRichtextFieldsForOpData,
-  richtextStatesEqual,
-  richtextToPlainText,
-  serializeOperation,
-  serializeRecord
-} from "./chunk-6NKLDBTY.js";
+} from "./chunk-YT7MRFCP.js";
 import {
   AdapterError,
   NoLeaderError,
@@ -63,6 +45,24 @@ import {
   WorkerInitError,
   WorkerTimeoutError
 } from "./chunk-TUR7RGEP.js";
+import {
+  exportBackup,
+  readBackupManifest,
+  restoreBackup,
+  verifyBackupChecksum
+} from "./chunk-HS6DBMST.js";
+import {
+  decodeRichtext,
+  decodeRichtextFieldsFromOpData,
+  deserializeOperationWithCollection,
+  deserializeRecord,
+  encodeRichtext,
+  encodeRichtextFieldsForOpData,
+  richtextStatesEqual,
+  richtextToPlainText,
+  serializeOperation,
+  serializeRecord
+} from "./chunk-GSJ7EEUC.js";
 
 // src/compaction/types.ts
 var COMPACTION_BASELINE_META_KEY = "compaction_baseline_at";
@@ -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);
   }
   /**
@@ -2523,6 +2596,22 @@ var Store = class {
       col.setMutationHandler(handler);
     }
   }
+  /**
+   * Notify this store that another same-origin runtime committed an operation to
+   * the shared local database. The operation has already been persisted and
+   * materialized by the database owner; this method only advances in-memory causal
+   * watermarks and invalidates local reactive queries so already-open tabs stay
+   * live without reapplying or rewriting the operation.
+   */
+  notifyExternalOperation(operation) {
+    this.ensureOpen();
+    const definition = this.schema.collections[operation.collection];
+    if (!definition) {
+      return;
+    }
+    this.recordOperationSequence(operation);
+    this.subscriptionManager.notify(operation.collection, operation);
+  }
   /**
    * Build mutation context for a collection (used by ApplyPipeline side effects).
    */
@@ -2632,6 +2721,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 +2840,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 +2933,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 +2945,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);
   }
   /**