@neetru/sdk 3.0.1 → 3.1.0

package/dist/auth.cjs

@@ -2043,7 +2043,60 @@ var MutationQueue = class {
   }
 };
 
+// src/db/field-value.ts
+var NEETRU_SENTINEL_KEY = "__neetru__";
+function isFieldSentinel(v) {
+  return typeof v === "object" && v !== null && NEETRU_SENTINEL_KEY in v && typeof v[NEETRU_SENTINEL_KEY] === "string";
+}
+function isServerTimestampSentinel(v) {
+  return isFieldSentinel(v) && v.__neetru__ === "serverTimestamp";
+}
+function isIncrementSentinel(v) {
+  return isFieldSentinel(v) && v.__neetru__ === "increment" && typeof v.operand === "number" && Number.isFinite(v.operand);
+}
+function resolveSentinelLocally(value, baseValue) {
+  if (isServerTimestampSentinel(value)) {
+    return Date.now();
+  }
+  if (isIncrementSentinel(value)) {
+    const base = typeof baseValue === "number" && Number.isFinite(baseValue) ? baseValue : 0;
+    return base + value.operand;
+  }
+  return value;
+}
+function resolveSentinelsLocally(data, existing) {
+  let touched = false;
+  const out = {};
+  for (const [k, v] of Object.entries(data)) {
+    if (isFieldSentinel(v)) {
+      touched = true;
+      out[k] = resolveSentinelLocally(v, existing?.[k]);
+    } else {
+      out[k] = v;
+    }
+  }
+  return touched ? out : data;
+}
+function hasFieldSentinel(data) {
+  for (const v of Object.values(data)) {
+    if (isFieldSentinel(v)) return true;
+  }
+  return false;
+}
+
 // src/db/offline/sync-engine.ts
+function hasSentinels(payload) {
+  return payload !== null && hasFieldSentinel(payload);
+}
+function sanitizeSentinelPayload(payload) {
+  if (payload === null) return null;
+  if (!hasFieldSentinel(payload)) return payload;
+  const out = {};
+  for (const [k, v] of Object.entries(payload)) {
+    if (!isFieldSentinel(v)) out[k] = v;
+  }
+  return out;
+}
 var SyncEngine = class {
   _store;
   _queue;
@@ -2251,11 +2304,16 @@ var SyncEngine = class {
       }
       return;
     }
-    const newData = mut.payload ?? (existing?.data ?? {});
+    const literalPayload = sanitizeSentinelPayload(mut.payload);
+    const newData = literalPayload ?? (existing?.data ?? {});
     const updatedDoc = {
       collection,
       id: docId,
-      data: mut.op === "update" ? { ...existing?.data ?? {}, ...newData } : newData,
+      data: mut.op === "update" ? { ...existing?.data ?? {}, ...newData } : (
+        // add/set: se o payload tinha sentinels, o cache otimista (existing.data)
+        // é a fonte de verdade até o pull; senão usa o payload literal.
+        hasSentinels(mut.payload) ? { ...existing?.data ?? {}, ...newData } : newData
+      ),
       meta: {
         serverVersion,
         updatedAtServer: serverTimestamp,
@@ -3465,10 +3523,12 @@ var DbCollectionRefImpl = class {
     return this._buildListResult(q);
   }
   async add(data) {
+    const rawData = data;
+    const localData = resolveSentinelsLocally(rawData, void 0);
     const mutation = await this._queue.enqueue({
       collection: this._collection,
       op: "add",
-      payload: data,
+      payload: rawData,
       baseVersion: null,
       batchId: null
     });
@@ -3476,7 +3536,7 @@ var DbCollectionRefImpl = class {
     await this._store.putDoc({
       collection: this._collection,
       id: docId,
-      data,
+      data: localData,
       meta: {
         serverVersion: null,
         updatedAtServer: null,
@@ -3490,25 +3550,27 @@ var DbCollectionRefImpl = class {
     this._bus.emit([{
       type: "added",
       collection: this._collection,
-      doc: { id: docId, data }
+      doc: { id: docId, data: localData }
     }]);
     return { ok: true, id: docId };
   }
   async set(id, data) {
     assertValidId(id);
     const existing = await this._store.getDoc(this._collection, id);
+    const rawData = data;
+    const localData = resolveSentinelsLocally(rawData, void 0);
     const mutation = await this._queue.enqueue({
       collection: this._collection,
       docId: id,
       op: "set",
-      payload: data,
+      payload: rawData,
       baseVersion: existing?.meta.serverVersion ?? null,
       batchId: null
     });
     await this._store.putDoc({
       collection: this._collection,
       id,
-      data,
+      data: localData,
       meta: {
         serverVersion: existing?.meta.serverVersion ?? null,
         updatedAtServer: existing?.meta.updatedAtServer ?? null,
@@ -3522,19 +3584,22 @@ var DbCollectionRefImpl = class {
     this._bus.emit([{
       type: existing && !existing.meta.deleted ? "modified" : "added",
       collection: this._collection,
-      doc: { id, data }
+      doc: { id, data: localData }
     }]);
     return { ok: true };
   }
   async update(id, data) {
     assertValidId(id);
     const existing = await this._store.getDoc(this._collection, id);
-    const mergedData = existing?.meta.deleted ? { ...data } : { ...existing?.data ?? {}, ...data };
+    const rawData = data;
+    const existingBase = existing?.meta.deleted ? void 0 : existing?.data;
+    const localData = resolveSentinelsLocally(rawData, existingBase);
+    const mergedData = existing?.meta.deleted ? { ...localData } : { ...existing?.data ?? {}, ...localData };
     const mutation = await this._queue.enqueue({
       collection: this._collection,
       docId: id,
       op: "update",
-      payload: data,
+      payload: rawData,
       baseVersion: existing?.meta.serverVersion ?? null,
       batchId: null
     });
@@ -3591,6 +3656,7 @@ var DbCollectionRefImpl = class {
       const collection = this._collection;
       if (op.kind === "add") {
         const data = op.data;
+        const localData = resolveSentinelsLocally(data, void 0);
         const mutation = await this._queue.enqueue({
           collection,
           op: "add",
@@ -3602,7 +3668,7 @@ var DbCollectionRefImpl = class {
         await this._store.putDoc({
           collection,
           id: docId,
-          data,
+          data: localData,
           meta: {
             serverVersion: null,
             updatedAtServer: null,
@@ -3613,11 +3679,12 @@ var DbCollectionRefImpl = class {
             ownerId: null
           }
         });
-        busChanges.push({ type: "added", collection, doc: { id: docId, data } });
+        busChanges.push({ type: "added", collection, doc: { id: docId, data: localData } });
       } else if (op.kind === "set") {
         const id = op.id;
         const data = op.data;
         const existing = await this._store.getDoc(collection, id);
+        const localData = resolveSentinelsLocally(data, void 0);
         const mutation = await this._queue.enqueue({
           collection,
           docId: id,
@@ -3629,7 +3696,7 @@ var DbCollectionRefImpl = class {
         await this._store.putDoc({
           collection,
           id,
-          data,
+          data: localData,
           meta: {
             serverVersion: existing?.meta.serverVersion ?? null,
             updatedAtServer: existing?.meta.updatedAtServer ?? null,
@@ -3643,13 +3710,15 @@ var DbCollectionRefImpl = class {
         busChanges.push({
           type: existing && !existing.meta.deleted ? "modified" : "added",
           collection,
-          doc: { id, data }
+          doc: { id, data: localData }
         });
       } else if (op.kind === "update") {
         const id = op.id;
         const data = op.data;
         const existing = await this._store.getDoc(collection, id);
-        const merged = { ...existing?.data ?? {}, ...data };
+        const existingBase = existing?.meta.deleted ? void 0 : existing?.data;
+        const localData = resolveSentinelsLocally(data, existingBase);
+        const merged = { ...existing?.data ?? {}, ...localData };
         const mutation = await this._queue.enqueue({
           collection,
           docId: id,