@neetru/sdk 3.1.6 → 3.1.9

package/dist/db.d.cts

@@ -1,3 +1,3 @@
-export { j as ConflictRecord, k as CreateOfflineDocumentsOptions, m as DbBatchOp, n as DbChangeType, o as DbCollectionRef, p as DbDoc, q as DbDocRef, r as DbGetResult, s as DbListResult, u as DbQuery, v as DbSqlLease, x as DbWhereFilter, F as FieldSentinel, I as IncrementSentinel, N as NEETRU_SENTINEL_KEY, H as NeetruDb, J as NeetruDbDocuments, K as NeetruDbEngine, O as NeetruDbError, P as NeetruDbErrorCode, Q as NeetruDbOptions, R as NeetruDbTransport, T as NeetruSqlClient, a0 as RealtimeTransport, a5 as ServerTimestampSentinel, a7 as SqlOptions, ac as SyncState, at as WithFieldSentinels, av as createNeetruDb, ax as createRestSyncTransport, az as getWebSocketRealtimeClient, aA as increment, aB as isFieldSentinel, aC as isIncrementSentinel, aD as isServerTimestampSentinel, aE as serverTimestamp } from './types-BXvGHppn.cjs';
+export { j as ConflictRecord, k as CreateOfflineDocumentsOptions, m as DbBatchOp, n as DbChangeType, o as DbCollectionRef, p as DbDoc, q as DbDocRef, r as DbGetResult, s as DbListResult, u as DbQuery, v as DbSqlLease, x as DbWhereFilter, F as FieldSentinel, I as IncrementSentinel, N as NEETRU_SENTINEL_KEY, H as NeetruDb, J as NeetruDbDocuments, K as NeetruDbEngine, O as NeetruDbError, P as NeetruDbErrorCode, Q as NeetruDbOptions, R as NeetruDbTransport, T as NeetruSqlClient, a0 as RealtimeTransport, a5 as ServerTimestampSentinel, a7 as SqlOptions, ac as SyncState, at as WithFieldSentinels, av as createNeetruDb, ax as createRestSyncTransport, az as getWebSocketRealtimeClient, aA as increment, aB as isFieldSentinel, aC as isIncrementSentinel, aD as isServerTimestampSentinel, aE as serverTimestamp } from './types-DDiVzgCT.cjs';
 import 'drizzle-orm/node-postgres';
 import './errors.cjs';

package/dist/db.d.ts

@@ -1,3 +1,3 @@
-export { j as ConflictRecord, k as CreateOfflineDocumentsOptions, m as DbBatchOp, n as DbChangeType, o as DbCollectionRef, p as DbDoc, q as DbDocRef, r as DbGetResult, s as DbListResult, u as DbQuery, v as DbSqlLease, x as DbWhereFilter, F as FieldSentinel, I as IncrementSentinel, N as NEETRU_SENTINEL_KEY, H as NeetruDb, J as NeetruDbDocuments, K as NeetruDbEngine, O as NeetruDbError, P as NeetruDbErrorCode, Q as NeetruDbOptions, R as NeetruDbTransport, T as NeetruSqlClient, a0 as RealtimeTransport, a5 as ServerTimestampSentinel, a7 as SqlOptions, ac as SyncState, at as WithFieldSentinels, av as createNeetruDb, ax as createRestSyncTransport, az as getWebSocketRealtimeClient, aA as increment, aB as isFieldSentinel, aC as isIncrementSentinel, aD as isServerTimestampSentinel, aE as serverTimestamp } from './types-CQVak2a3.js';
+export { j as ConflictRecord, k as CreateOfflineDocumentsOptions, m as DbBatchOp, n as DbChangeType, o as DbCollectionRef, p as DbDoc, q as DbDocRef, r as DbGetResult, s as DbListResult, u as DbQuery, v as DbSqlLease, x as DbWhereFilter, F as FieldSentinel, I as IncrementSentinel, N as NEETRU_SENTINEL_KEY, H as NeetruDb, J as NeetruDbDocuments, K as NeetruDbEngine, O as NeetruDbError, P as NeetruDbErrorCode, Q as NeetruDbOptions, R as NeetruDbTransport, T as NeetruSqlClient, a0 as RealtimeTransport, a5 as ServerTimestampSentinel, a7 as SqlOptions, ac as SyncState, at as WithFieldSentinels, av as createNeetruDb, ax as createRestSyncTransport, az as getWebSocketRealtimeClient, aA as increment, aB as isFieldSentinel, aC as isIncrementSentinel, aD as isServerTimestampSentinel, aE as serverTimestamp } from './types-HWDOUmlC.js';
 import 'drizzle-orm/node-postgres';
 import './errors.js';

package/dist/db.mjs

@@ -445,7 +445,7 @@ __export(sql_client_exports, {
 function mapEnvToCore(sdkEnv) {
   if (sdkEnv === "workspace") return "staging";
   if (sdkEnv === "prod") return "production";
-  return "dev";
+  return "dev-local";
 }
 function createHttpLeaseFetcher(config) {
   return async (opts) => {
@@ -704,7 +704,12 @@ function evaluateFilter(data, filter) {
       if (!Array.isArray(value)) return true;
       return !value.includes(fieldValue);
     default:
-      return false;
+      if (op === "array-contains-any") {
+        return Array.isArray(fieldValue) && Array.isArray(value) && value.some((v) => fieldValue.includes(v));
+      }
+      throw new Error(
+        `QueryEngine: operador de filtro '${String(op)}' n\xE3o suportado em leitura offline/cache. Use um operador suportado (==, !=, <, <=, >, >=, array-contains, array-contains-any, in, not-in) ou fa\xE7a a query server-side.`
+      );
   }
 }
 function matchesAllFilters(data, filters) {
@@ -1234,7 +1239,7 @@ var MutationQueue = class {
    *   - `{ removed: true }`       — a mutação existente deve ser deletada (add+remove)
    *   - `null`                    — não é possível coalescir
    */
-  tryCoalesce(existing, newOp, newPayload, newBatchId) {
+  tryCoalesce(existing, newOp, newPayload, newBatchId, newUpsert) {
     if (existing.batchId !== newBatchId) return null;
     if (existing.status === "inflight") return null;
     const existingOp = existing.op;
@@ -1242,10 +1247,12 @@ var MutationQueue = class {
       return { removed: true };
     }
     if (existingOp === "update" && newOp === "update") {
+      const mergedUpsert = existing.upsert || newUpsert;
       return {
         coalesced: {
           ...existing,
-          payload: { ...existing.payload ?? {}, ...newPayload ?? {} }
+          payload: { ...existing.payload ?? {}, ...newPayload ?? {} },
+          ...mergedUpsert ? { upsert: true } : {}
         }
       };
     }
@@ -1294,13 +1301,13 @@ var MutationQueue = class {
    * Atômico: a persistência final é uma única operação putMutation.
    */
   async enqueue(params) {
-    const { collection, op, payload, baseVersion, batchId } = params;
+    const { collection, op, payload, baseVersion, batchId, upsert } = params;
     const docId = params.docId ?? (op === "add" ? generateUUIDv4() : "");
     await this.syncSeq();
     const existingMutations = await this.store.listMutations({ collection, docId });
     const lastQueued = existingMutations.filter((m) => m.status === "queued").sort((a, b) => b.seq - a.seq)[0];
     if (lastQueued !== void 0) {
-      const coalesceResult = this.tryCoalesce(lastQueued, op, payload, batchId);
+      const coalesceResult = this.tryCoalesce(lastQueued, op, payload, batchId, upsert);
       if (coalesceResult !== null) {
         if ("removed" in coalesceResult) {
           await this.store.deleteMutation(lastQueued.mutationId);
@@ -1338,7 +1345,9 @@ var MutationQueue = class {
       attempts: 0,
       lastError: null,
       status: "queued",
-      batchId
+      batchId,
+      // bug_0273e4dd: só persiste o flag quando verdadeiro (mantém o doc limpo).
+      ...upsert ? { upsert: true } : {}
     };
     await this.store.putMutation(mutation);
     return mutation;
@@ -1678,10 +1687,15 @@ var SyncEngine = class {
         await this._applyRejected(mut, res, busChanges);
       }
     }
+    const processedIds = new Set(result.results.map((r) => r.mutationId));
+    const unprocessed = mutations.filter((m) => !processedIds.has(m.mutationId));
+    for (const mut of unprocessed) {
+      await this._queue.markRetry(mut.mutationId, "partial_push: muta\xE7\xE3o n\xE3o processada no lote");
+    }
     if (busChanges.length > 0) {
       this._bus.emit(busChanges);
     }
-    return true;
+    return unprocessed.length === 0;
   }
   /** Atualiza o cache após confirmação de escrita (outcome=confirmed). */
   async _applySyncedDoc(collection, docId, serverVersion, serverTimestamp2, mut, busChanges) {
@@ -2988,7 +3002,7 @@ var DbCollectionRefImpl = class {
     }]);
     return { ok: true };
   }
-  async update(id, data) {
+  async update(id, data, opts) {
     assertValidId(id);
     const existing = await this._store.getDoc(this._collection, id);
     const rawData = data;
@@ -3001,7 +3015,9 @@ var DbCollectionRefImpl = class {
       op: "update",
       payload: rawData,
       baseVersion: existing?.meta.serverVersion ?? null,
-      batchId: null
+      batchId: null,
+      // bug_0273e4dd: propaga merge-upsert (setDoc({merge:true}) cria-se-ausente).
+      upsert: opts?.upsert
     });
     await this._store.putDoc({
       collection: this._collection,
@@ -3125,7 +3141,9 @@ var DbCollectionRefImpl = class {
           op: "update",
           payload: data,
           baseVersion: existing?.meta.serverVersion ?? null,
-          batchId
+          batchId,
+          // bug_0273e4dd: propaga merge-upsert (writeBatch.set(merge) cria-se-ausente).
+          upsert: op.upsert
         });
         await this._store.putDoc({
           collection,
@@ -3387,6 +3405,10 @@ async function createOfflineDocumentsNamespace(opts) {
     connectivity,
     periodicSyncIntervalMs: opts.periodicSyncIntervalMs ?? 5 * 60 * 1e3
   });
+  connectivity.start();
+  if (!opts.singleTab && tabCoordinatorLike instanceof TabCoordinator) {
+    tabCoordinatorLike.start();
+  }
   return new NeetruDbDocumentsImpl({
     store,
     queue,
@@ -3857,11 +3879,11 @@ function createRestSyncTransport(config) {
           let raw;
           if (m.op === "add") {
             raw = await httpRequest2(config, {
-              method: "POST",
-              path: DATASTORE_COLLECTION_ENDPOINT(m.collection),
+              method: "PUT",
+              path: DATASTORE_DOC_ENDPOINT(m.collection, m.docId),
               body: { data: m.payload ?? {} },
               requireAuth: true,
-              retries: 0,
+              retries: 2,
               headers: tenantHeaders
             });
           } else if (m.op === "set") {
@@ -3877,7 +3899,7 @@ function createRestSyncTransport(config) {
             raw = await httpRequest2(config, {
               method: "PATCH",
               path: DATASTORE_DOC_ENDPOINT(m.collection, m.docId),
-              body: { data: m.payload ?? {} },
+              body: { data: m.payload ?? {}, ...m.upsert ? { upsert: true } : {} },
               requireAuth: true,
               retries: 2,
               headers: tenantHeaders
@@ -3900,7 +3922,24 @@ function createRestSyncTransport(config) {
           });
         } catch (err) {
           const msg = err instanceof Error ? err.message : String(err);
-          throw new NeetruDbError("db_unavailable", `pushMutations falhou: ${msg}`);
+          const code = err?.code;
+          const status = err?.status;
+          const isPermanent = code === "forbidden" || code === "unauthorized" || code === "not_found" || code === "conflict" || code === "validation_failed" || typeof status === "number" && status >= 400 && status < 500 && status !== 408 && status !== 429;
+          if (isPermanent) {
+            const reason = code === "forbidden" || code === "unauthorized" ? "rejected_permission" : "rejected_validation";
+            results.push({
+              mutationId: m.mutationId,
+              outcome: "rejected",
+              reason,
+              serverVersion: null,
+              serverData: null
+            });
+            continue;
+          }
+          if (results.length === 0) {
+            throw new NeetruDbError("db_unavailable", `pushMutations falhou: ${msg}`);
+          }
+          break;
         }
       }
       return { results };