@neetru/sdk 3.1.7 → 3.1.9

package/dist/auth.cjs

@@ -448,7 +448,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) => {
@@ -957,7 +957,11 @@ function createTelemetryNamespace(config) {
             path: "/api/sdk/v1/telemetry/event",
             body,
             requireAuth: true,
-            retries: 1
+            retries: 1,
+            // caça-bruxas: retry sem Idempotency-Key duplicava o evento se o
+            // servidor já tinha persistido antes da falha transiente. Mesmo
+            // padrão do usage.report (key estável por chamada, reusada no retry).
+            idempotencyKey: true
           });
         } catch (err) {
           if (typeof console !== "undefined") {
@@ -1161,8 +1165,8 @@ function createUsageNamespace(config) {
       if (!resource || typeof resource !== "string") {
         throw new NeetruError("validation_failed", "resource is required");
       }
-      if (!Number.isFinite(qty) || qty <= 0) {
-        throw new NeetruError("validation_failed", "qty must be positive integer");
+      if (!Number.isFinite(qty) || qty <= 0 || !Number.isInteger(qty)) {
+        throw new NeetruError("validation_failed", "qty must be a positive integer");
       }
       const productId = options?.productId ?? config.productId;
       const tenantId = options?.tenantId ?? config.tenantId;
@@ -1411,7 +1415,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) {
@@ -1941,7 +1950,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;
@@ -1949,10 +1958,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 } : {}
         }
       };
     }
@@ -2001,13 +2012,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);
@@ -2045,7 +2056,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;
@@ -2374,10 +2387,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, serverTimestamp, mut, busChanges) {
@@ -3684,7 +3702,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;
@@ -3697,7 +3715,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,
@@ -3821,7 +3841,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,
@@ -4083,6 +4105,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,
@@ -4552,11 +4578,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") {
@@ -4572,7 +4598,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
@@ -4595,7 +4621,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 };
@@ -6111,15 +6154,15 @@ function createOidcAuthNamespace(config) {
       const overrideAuthUrl = typeof globalThis.NEETRU_AUTH_URL === "string" ? globalThis.NEETRU_AUTH_URL : null;
       const idpOrigin = overrideAuthUrl ?? config.baseUrl.replace(/^https?:\/\/api\./, "https://auth.");
       const issuer = idpOrigin;
-      const jwksUrl = `${idpOrigin}/api/v1/oauth/.well-known/jwks.json`;
+      const jwksUrl = `${idpOrigin}/api/v1/oauth/.well-known/jwks`;
       const cacheTtlMs = options?.jwksCacheTtlMs ?? DEFAULT_JWKS_TTL_MS;
       const audienceFromOptions = options?.audience;
       const parsedKey = tryParseApiKey(config.apiKey);
-      const audience = audienceFromOptions ?? parsedKey?.keyId;
+      const audience = audienceFromOptions ?? config.oidcClientId ?? parsedKey?.keyId;
       if (!audience) {
         throw new NeetruError(
           "invalid_config",
-          "verifyToken requires an audience: provide apiKey on the client or pass options.audience. Calling jwtVerify without an audience allows tokens issued for other OIDC clients to pass."
+          "verifyToken requires an audience: provide oidcClientId/apiKey on the client or pass options.audience. Calling jwtVerify without an audience allows tokens issued for other OIDC clients to pass."
         );
       }
       const jwks = _getJwks(jwksUrl, cacheTtlMs);