@korajs/store 1.0.0-beta.1 → 1.0.0-beta.10

package/dist/index.js

@@ -1,14 +1,8 @@
-import {
-  exportBackup,
-  readBackupManifest,
-  restoreBackup,
-  verifyBackupChecksum
-} from "./chunk-X57MWW35.js";
 import {
   decodeAuditExport,
   readAuditExportManifest,
   verifyAuditExportChecksum
-} from "./chunk-FFYA7J5H.js";
+} from "./chunk-CYO3YKFL.js";
 import {
   persistedAuditTraceFromEvent
 } from "./chunk-MYSJN3DF.js";
@@ -39,7 +33,24 @@ import {
   serializeRowVersion,
   validateStateTransition,
   validateUpdateStateMachine
-} from "./chunk-ZLWAYQEQ.js";
+} from "./chunk-YT7MRFCP.js";
+import {
+  AdapterError,
+  NoLeaderError,
+  OptimisticLockError,
+  PersistenceError,
+  QueryError,
+  RecordNotFoundError,
+  StoreNotOpenError,
+  WorkerInitError,
+  WorkerTimeoutError
+} from "./chunk-TUR7RGEP.js";
+import {
+  exportBackup,
+  readBackupManifest,
+  restoreBackup,
+  verifyBackupChecksum
+} from "./chunk-HS6DBMST.js";
 import {
   decodeRichtext,
   decodeRichtextFieldsFromOpData,
@@ -51,23 +62,13 @@ import {
   richtextToPlainText,
   serializeOperation,
   serializeRecord
-} from "./chunk-6NKLDBTY.js";
-import {
-  AdapterError,
-  OptimisticLockError,
-  PersistenceError,
-  QueryError,
-  RecordNotFoundError,
-  StoreNotOpenError,
-  WorkerInitError,
-  WorkerTimeoutError
-} from "./chunk-QL2XVZRN.js";
+} from "./chunk-GSJ7EEUC.js";
 
 // src/compaction/types.ts
 var COMPACTION_BASELINE_META_KEY = "compaction_baseline_at";
 
 // src/compaction/compact-operation-log.ts
-import { HybridLogicalClock, createVersionVector } from "@korajs/core";
+import { HybridLogicalClock, createVersionVector, quoteIdent } from "@korajs/core";
 function computeAckCompactionWatermark(serverVector) {
   const watermark = createVersionVector();
   for (const [nodeId, seq] of serverVector) {
@@ -95,7 +96,7 @@ async function compactOperationLog(adapter, schema, strategy, serverVector) {
   const collectionNames = Object.keys(schema.collections);
   await adapter.transaction(async (tx) => {
     for (const collectionName of collectionNames) {
-      const table = `_kora_ops_${collectionName}`;
+      const table = quoteIdent(`_kora_ops_${collectionName}`);
       for (const [nodeId, maxSeq] of watermark) {
         if (maxSeq <= 0) continue;
         const countSql = buildCountSql(table, ageCutoffSerialized !== null);
@@ -130,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) {
@@ -202,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 {
@@ -209,10 +250,13 @@ import {
   HybridLogicalClock as HybridLogicalClock3,
   createVersionVector as createVersionVector3,
   generateUUIDv7 as generateUUIDv73,
-  migrationStepsToSQL
+  migrationStepsToSQL,
+  quoteIdent as quoteIdent7,
+  replayOperationsForRecord
 } from "@korajs/core";
 
 // src/collection/collection.ts
+import { quoteIdent as quoteIdent2 } from "@korajs/core";
 var Collection = class {
   constructor(name, definition, schema, adapter, clock, nodeId, allocateSequenceNumber, onMutation, relationEnforcer, mutationHandler, causalTracker, secretKeyProvider) {
     this.name = name;
@@ -264,7 +308,7 @@ var Collection = class {
   }
   async findById(id) {
     const rows = await this.adapter.query(
-      `SELECT * FROM ${this.name} WHERE id = ? AND _deleted = 0`,
+      `SELECT * FROM ${quoteIdent2(this.name)} WHERE id = ? AND _deleted = 0`,
       [id]
     );
     const row = rows[0];
@@ -296,6 +340,9 @@ var Collection = class {
   }
 };
 
+// src/query/query-builder.ts
+import { quoteIdent as quoteIdent3 } from "@korajs/core";
+
 // src/query/pluralize.ts
 function isVowel(char) {
   if (!char) return false;
@@ -525,7 +572,7 @@ var QueryBuilder = class _QueryBuilder {
     const relatedDef = this.schema?.collections[relatedCollection];
     if (!relatedDef) return;
     const placeholders = uniqueFks.map(() => "?").join(", ");
-    const sql = `SELECT * FROM ${relatedCollection} WHERE id IN (${placeholders}) AND _deleted = 0`;
+    const sql = `SELECT * FROM ${quoteIdent3(relatedCollection)} WHERE id IN (${placeholders}) AND _deleted = 0`;
     const rows = await this.adapter.query(sql, uniqueFks);
     const relatedRecords = rows.map((row) => deserializeRecord(row, relatedDef.fields));
     const lookup = /* @__PURE__ */ new Map();
@@ -548,7 +595,7 @@ var QueryBuilder = class _QueryBuilder {
     if (!relatedDef) return;
     const fkField = relation.field;
     const placeholders = primaryIds.map(() => "?").join(", ");
-    const sql = `SELECT * FROM ${relatedCollection} WHERE ${fkField} IN (${placeholders}) AND _deleted = 0`;
+    const sql = `SELECT * FROM ${quoteIdent3(relatedCollection)} WHERE ${quoteIdent3(fkField)} IN (${placeholders}) AND _deleted = 0`;
     const rows = await this.adapter.query(sql, primaryIds);
     const relatedRecords = rows.map((row) => deserializeRecord(row, relatedDef.fields));
     const grouped = /* @__PURE__ */ new Map();
@@ -590,7 +637,7 @@ var QueryError2 = class extends Error {
 };
 
 // src/relations/relation-enforcer.ts
-import { KoraError, createOperation } from "@korajs/core";
+import { KoraError, createOperation, quoteIdent as quoteIdent4 } from "@korajs/core";
 
 // src/relations/relation-lookup.ts
 function buildRelationLookup(schema) {
@@ -693,7 +740,7 @@ var RelationEnforcer = class {
   async enforceCascade(incoming, deletedRecordId, tx, causalDeps) {
     const { sourceCollection, foreignKeyField } = incoming;
     const referencingRows = await tx.query(
-      `SELECT id FROM ${sourceCollection} WHERE ${foreignKeyField} = ? AND _deleted = 0`,
+      `SELECT id FROM ${quoteIdent4(sourceCollection)} WHERE ${quoteIdent4(foreignKeyField)} = ? AND _deleted = 0`,
       [deletedRecordId]
     );
     if (referencingRows.length === 0) {
@@ -740,7 +787,7 @@ var RelationEnforcer = class {
       return [];
     }
     const referencingRows = await tx.query(
-      `SELECT id FROM ${sourceCollection} WHERE ${foreignKeyField} = ? AND _deleted = 0`,
+      `SELECT id FROM ${quoteIdent4(sourceCollection)} WHERE ${quoteIdent4(foreignKeyField)} = ? AND _deleted = 0`,
       [deletedRecordId]
     );
     if (referencingRows.length === 0) {
@@ -788,7 +835,7 @@ var RelationEnforcer = class {
   async enforceRestrict(incoming, deletedRecordId, tx) {
     const { sourceCollection, foreignKeyField, relationName } = incoming;
     const countRows = await tx.query(
-      `SELECT COUNT(*) as cnt FROM ${sourceCollection} WHERE ${foreignKeyField} = ? AND _deleted = 0`,
+      `SELECT COUNT(*) as cnt FROM ${quoteIdent4(sourceCollection)} WHERE ${quoteIdent4(foreignKeyField)} = ? AND _deleted = 0`,
       [deletedRecordId]
     );
     const count = countRows[0]?.cnt ?? 0;
@@ -1476,7 +1523,7 @@ var SubscriptionManager = class {
 };
 
 // src/sync/rebase-unsynced-operations.ts
-import { HybridLogicalClock as HybridLogicalClock2, MAX_LOGICAL } from "@korajs/core";
+import { HybridLogicalClock as HybridLogicalClock2, MAX_LOGICAL, quoteIdent as quoteIdent5 } from "@korajs/core";
 import { computeOperationId } from "@korajs/core/internal";
 var LOGICAL_COUNTER_LIMIT = MAX_LOGICAL + 1;
 function emptyResult() {
@@ -1490,7 +1537,9 @@ async function rebaseUnsyncedOperationsInLog(adapter, schema, unsyncedOpIds, cor
   const rebased = [];
   let maxOtherSerializedTs = null;
   for (const collectionName of Object.keys(schema.collections)) {
-    const rows = await adapter.query(`SELECT * FROM _kora_ops_${collectionName}`);
+    const rows = await adapter.query(
+      `SELECT * FROM ${quoteIdent5(`_kora_ops_${collectionName}`)}`
+    );
     for (const row of rows) {
       if (rebaseIds.has(row.id)) {
         rebased.push(deserializeOperationWithCollection(row, collectionName));
@@ -1559,7 +1608,7 @@ async function rebaseUnsyncedOperationsInLog(adapter, schema, unsyncedOpIds, cor
         continue;
       }
       const opsTable = `_kora_ops_${oldOp.collection}`;
-      await tx.execute(`DELETE FROM ${opsTable} WHERE id = ?`, [oldOp.id]);
+      await tx.execute(`DELETE FROM ${quoteIdent5(opsTable)} WHERE id = ?`, [oldOp.id]);
       const opInsert = buildInsertQuery(
         opsTable,
         serializeOperation(newOp)
@@ -1568,11 +1617,11 @@ async function rebaseUnsyncedOperationsInLog(adapter, schema, unsyncedOpIds, cor
       const oldVersion = serializeRowVersion(oldOp.timestamp);
       const newVersion = serializeRowVersion(newOp.timestamp);
       await tx.execute(
-        `UPDATE ${oldOp.collection} SET _version = ?, _updated_at = ? WHERE id = ? AND _version = ?`,
+        `UPDATE ${quoteIdent5(oldOp.collection)} SET _version = ?, _updated_at = ? WHERE id = ? AND _version = ?`,
         [newVersion, newOp.timestamp.wallTime, oldOp.recordId, oldVersion]
       );
       const rows = await tx.query(
-        `SELECT _field_versions FROM ${oldOp.collection} WHERE id = ?`,
+        `SELECT _field_versions FROM ${quoteIdent5(oldOp.collection)} WHERE id = ?`,
         [oldOp.recordId]
       );
       const fieldVersions = parseFieldVersions(rows[0]?._field_versions);
@@ -1584,14 +1633,14 @@ async function rebaseUnsyncedOperationsInLog(adapter, schema, unsyncedOpIds, cor
         }
       }
       if (changed) {
-        await tx.execute(`UPDATE ${oldOp.collection} SET _field_versions = ? WHERE id = ?`, [
-          serializeFieldVersions(fieldVersions),
-          oldOp.recordId
-        ]);
+        await tx.execute(
+          `UPDATE ${quoteIdent5(oldOp.collection)} SET _field_versions = ? WHERE id = ?`,
+          [serializeFieldVersions(fieldVersions), oldOp.recordId]
+        );
       }
       if (oldOp.type === "insert") {
         await tx.execute(
-          `UPDATE ${oldOp.collection} SET _created_at = ? WHERE id = ? AND _created_at = ?`,
+          `UPDATE ${quoteIdent5(oldOp.collection)} SET _created_at = ? WHERE id = ? AND _created_at = ?`,
           [newOp.timestamp.wallTime, oldOp.recordId, oldOp.timestamp.wallTime]
         );
       }
@@ -1611,6 +1660,7 @@ import {
   createOperation as createOperation2,
   generateUUIDv7,
   isAtomicOp,
+  quoteIdent as quoteIdent6,
   resolveAtomicOp,
   toAtomicOp,
   validateRecord
@@ -1927,7 +1977,7 @@ var TransactionContext = class {
       }
     }
     const rows = await this.config.adapter.query(
-      `SELECT * FROM ${collectionName} WHERE id = ? AND _deleted = 0`,
+      `SELECT * FROM ${quoteIdent6(collectionName)} WHERE id = ? AND _deleted = 0`,
       [id]
     );
     let record = rows[0] ? deserializeRecord(rows[0], definition.fields) : null;
@@ -2162,7 +2212,7 @@ var Store = class {
       return "skipped";
     }
     const existing = await this.adapter.query(
-      `SELECT id FROM _kora_ops_${collection} WHERE id = ?`,
+      `SELECT id FROM ${quoteIdent7(`_kora_ops_${collection}`)} WHERE id = ?`,
       [op.id]
     );
     if (existing.length > 0) {
@@ -2187,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 = ?`,
@@ -2209,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 = {
@@ -2267,7 +2318,7 @@ var Store = class {
         const serializedChanges = serializeRecord(materializeSource, definition.fields);
         const changedFields = Object.keys(serializedChanges);
         const currentRows = await tx.query(
-          `SELECT _version, _field_versions FROM ${collection} WHERE id = ?`,
+          `SELECT _version, _field_versions FROM ${quoteIdent7(collection)} WHERE id = ?`,
           [op.recordId]
         );
         const currentRow = currentRows[0];
@@ -2361,9 +2412,9 @@ 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 _kora_ops_${collection} WHERE record_id = ? AND type IN ('update', 'delete')`,
+      `SELECT * FROM ${quoteIdent7(`_kora_ops_${collection}`)} WHERE record_id = ? AND type IN ('update', 'delete')`,
       [recordId]
     );
     if (orphanRows.length === 0) {
@@ -2376,7 +2427,7 @@ var Store = class {
       if (orphan.type === "update" && orphan.data) {
         const orphanChanges = serializeRecord(orphan.data, definition.fields);
         const rows = await tx.query(
-          `SELECT _version, _field_versions FROM ${collection} WHERE id = ?`,
+          `SELECT _version, _field_versions FROM ${quoteIdent7(collection)} WHERE id = ?`,
           [recordId]
         );
         const current = rows[0];
@@ -2410,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.
@@ -2426,7 +2508,7 @@ var Store = class {
     const allOps = [];
     for (const collectionName of Object.keys(this.schema.collections)) {
       const rows = await this.adapter.query(
-        `SELECT * FROM _kora_ops_${collectionName} WHERE node_id = ? AND sequence_number >= ? AND sequence_number <= ? ORDER BY sequence_number ASC`,
+        `SELECT * FROM ${quoteIdent7(`_kora_ops_${collectionName}`)} WHERE node_id = ? AND sequence_number >= ? AND sequence_number <= ? ORDER BY sequence_number ASC`,
         [nodeId, fromSeq, toSeq]
       );
       for (const row of rows) {
@@ -2445,7 +2527,7 @@ var Store = class {
     const allOps = [];
     for (const collectionName of Object.keys(this.schema.collections)) {
       const rows = await this.adapter.query(
-        `SELECT * FROM _kora_ops_${collectionName} ORDER BY sequence_number ASC`
+        `SELECT * FROM ${quoteIdent7(`_kora_ops_${collectionName}`)} ORDER BY sequence_number ASC`
       );
       for (const row of rows) {
         allOps.push(deserializeOperationWithCollection(row, collectionName));
@@ -2496,7 +2578,7 @@ var Store = class {
    */
   async exportAudit(options) {
     this.ensureOpen();
-    const { exportAudit: doExport } = await import("./export-audit-AJ7RORNK.js");
+    const { exportAudit: doExport } = await import("./export-audit-ODGQTQIK.js");
     return doExport(this.adapter, this.schema, this.nodeId, this.schema.version, options);
   }
   /**
@@ -2514,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).
    */
@@ -2555,7 +2653,7 @@ var Store = class {
       return null;
     }
     const rows = await this.adapter.query(
-      `SELECT * FROM ${collection} WHERE id = ?`,
+      `SELECT * FROM ${quoteIdent7(collection)} WHERE id = ?`,
       [recordId]
     );
     const row = rows[0];
@@ -2580,7 +2678,7 @@ var Store = class {
       return null;
     }
     const rows = await this.adapter.query(
-      `SELECT _version, _field_versions FROM ${collection} WHERE id = ?`,
+      `SELECT _version, _field_versions FROM ${quoteIdent7(collection)} WHERE id = ?`,
       [recordId]
     );
     const row = rows[0];
@@ -2623,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.
    */
@@ -2686,7 +2813,7 @@ var Store = class {
   async getLatestLocalOperationForRecord(collection, recordId) {
     this.ensureOpen();
     const rows = await this.adapter.query(
-      `SELECT * FROM _kora_ops_${collection} WHERE node_id = ? AND record_id = ? ORDER BY sequence_number DESC LIMIT 1`,
+      `SELECT * FROM ${quoteIdent7(`_kora_ops_${collection}`)} WHERE node_id = ? AND record_id = ? ORDER BY sequence_number DESC LIMIT 1`,
       [this.nodeId, recordId]
     );
     const row = rows[0];
@@ -2701,7 +2828,7 @@ var Store = class {
   async getLatestOperationForRecord(collection, recordId) {
     this.ensureOpen();
     const rows = await this.adapter.query(
-      `SELECT * FROM _kora_ops_${collection} WHERE record_id = ?`,
+      `SELECT * FROM ${quoteIdent7(`_kora_ops_${collection}`)} WHERE record_id = ?`,
       [recordId]
     );
     let latest = null;
@@ -2713,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;
@@ -2791,7 +2933,7 @@ var Store = class {
    */
   async exportBackup(options) {
     this.ensureOpen();
-    const { exportBackup: doExport } = await import("./backup-ZV4Y424B.js");
+    const { exportBackup: doExport } = await import("./backup-5S7K2Z35.js");
     return doExport(this.adapter, this.schema, this.nodeId, this.schema.version, options);
   }
   /**
@@ -2803,7 +2945,7 @@ var Store = class {
    */
   async importBackup(data, options) {
     this.ensureOpen();
-    const { restoreBackup: doRestore } = await import("./backup-ZV4Y424B.js");
+    const { restoreBackup: doRestore } = await import("./backup-5S7K2Z35.js");
     return doRestore(this.adapter, this.schema, data, options);
   }
   /**
@@ -2888,14 +3030,14 @@ var Store = class {
    */
   async runBackfill(collection, transform) {
     const rows = await this.adapter.query(
-      `SELECT * FROM ${collection} WHERE _deleted = 0`
+      `SELECT * FROM ${quoteIdent7(collection)} WHERE _deleted = 0`
     );
     await this.adapter.transaction(async (tx) => {
       for (const row of rows) {
         const updates = transform(row);
         const fields = Object.keys(updates);
         if (fields.length === 0) continue;
-        const setClauses = fields.map((f) => `${f} = ?`).join(", ");
+        const setClauses = fields.map((f) => `${quoteIdent7(f)} = ?`).join(", ");
         const values = fields.map((f) => {
           const val = updates[f];
           if (typeof val === "boolean") return val ? 1 : 0;
@@ -2905,7 +3047,7 @@ var Store = class {
           return val;
         });
         values.push(row.id);
-        await tx.execute(`UPDATE ${collection} SET ${setClauses} WHERE id = ?`, values);
+        await tx.execute(`UPDATE ${quoteIdent7(collection)} SET ${setClauses} WHERE id = ?`, values);
       }
     });
   }
@@ -2965,6 +3107,7 @@ var QueryStore = class {
   listeners = /* @__PURE__ */ new Set();
   unsubscribeQuery = null;
   active = false;
+  hasEmittedSnapshot = false;
   queryBuilder;
   constructor(queryBuilder) {
     this.queryBuilder = queryBuilder;
@@ -2990,16 +3133,25 @@ var QueryStore = class {
   getSnapshot = () => {
     return this.snapshot;
   };
+  /**
+   * Whether the underlying query subscription has delivered at least one
+   * authoritative result for the current subscription lifecycle.
+   */
+  hasSnapshot = () => {
+    return this.hasEmittedSnapshot;
+  };
   /** Tear down listeners and the underlying query subscription. */
   destroy() {
     this.stopSubscription();
     this.listeners.clear();
     this.snapshot = EMPTY_ARRAY;
+    this.hasEmittedSnapshot = false;
   }
   startSubscription() {
     this.active = true;
     this.unsubscribeQuery = this.queryBuilder.subscribe((results) => {
       if (!this.active) return;
+      this.hasEmittedSnapshot = true;
       this.snapshot = Object.freeze([...results]);
       this.notifyListeners();
     });
@@ -3944,6 +4096,7 @@ export {
   InvalidStateTransitionError,
   LAST_ACKED_SERVER_VECTOR_META_KEY,
   MemoryBlobStore,
+  NoLeaderError,
   OpfsBlobStore,
   OptimisticLockError,
   PersistenceError,