@neetru/sdk 3.8.1 → 3.9.0

package/dist/db.mjs

@@ -1,10 +1,10 @@
 import { openDB } from 'idb';
 
-var Ye = Object.defineProperty;
+var Ze = Object.defineProperty;
 var S = (r, e) => () => (r && (e = r(r = 0)), e);
 var me = (r, e) => {
   for (var t in e)
-    Ye(r, t, { get: e[t], enumerable: true });
+    Ze(r, t, { get: e[t], enumerable: true });
 };
 
 // src/errors.ts
@@ -36,9 +36,9 @@ var b, x = S(() => {
 });
 
 // src/db-errors.ts
-var Ze, f, I = S(() => {
+var et, f, I = S(() => {
   x();
-  Ze = /* @__PURE__ */ new Set([
+  et = /* @__PURE__ */ new Set([
     "db_unavailable",
     "db_conflict",
     "db_timeout"
@@ -56,13 +56,13 @@ var Ze, f, I = S(() => {
      */
     dbId;
     constructor(e, t, n) {
-      super(e, t), this.name = "NeetruDbError", this.code = e, this.retryable = Ze.has(e), this.dbId = n, Object.setPrototypeOf(this, r.prototype);
+      super(e, t), this.name = "NeetruDbError", this.code = e, this.retryable = et.has(e), this.dbId = n, Object.setPrototypeOf(this, r.prototype);
     }
   };
 });
 
 // src/idempotency.ts
-function Te() {
+function Re() {
   let r = typeof globalThis < "u" && "crypto" in globalThis ? globalThis.crypto : void 0;
   if (r && typeof r.randomUUID == "function")
     return r.randomUUID();
@@ -71,15 +71,15 @@ function Te() {
     "crypto.randomUUID not available in this runtime. SDK 3.0 requires Node \u226520 or modern browser/Edge."
   );
 }
-var Re = S(() => {
+var De = S(() => {
   x();
 });
 
 // src/correlation.ts
-function ke(r) {
-  return typeof r == "string" && r.length > 0 && r.length <= 128 && wt.test(r);
+function Ce(r) {
+  return typeof r == "string" && r.length > 0 && r.length <= 128 && Tt.test(r);
 }
-function St() {
+function Rt() {
   let r = globalThis.crypto;
   try {
     if (r && typeof r.randomUUID == "function") return r.randomUUID();
@@ -97,24 +97,24 @@ function St() {
   let n = Array.from(e, (o) => o.toString(16).padStart(2, "0")).join("");
   return `${n.slice(0, 8)}-${n.slice(8, 12)}-${n.slice(12, 16)}-${n.slice(16, 20)}-${n.slice(20)}`;
 }
-function Ce(r, e) {
+function Ie(r, e) {
   let t, n = {};
   for (let [i, s] of Object.entries(r)) {
-    if (i.toLowerCase() === De) {
-      ke(s) && (t = s);
+    if (i.toLowerCase() === ke) {
+      Ce(s) && (t = s);
       continue;
     }
     n[i] = s;
   }
-  let o = t ?? (ke(e) ? e : void 0) ?? St();
-  return n[De] = o, { headers: n, correlationId: o };
+  let o = t ?? (Ce(e) ? e : void 0) ?? Rt();
+  return n[ke] = o, { headers: n, correlationId: o };
 }
-var De, wt, Ie = S(() => {
-  De = "x-correlation-id", wt = /^[A-Za-z0-9._:\-]+$/;
+var ke, Tt, Pe = S(() => {
+  ke = "x-correlation-id", Tt = /^[A-Za-z0-9._:\-]+$/;
 });
 
 // src/server-only-key.ts
-function Pe() {
+function Ee() {
   try {
     let r = globalThis.navigator;
     if (r && r.product === "ReactNative") return "react-native";
@@ -127,20 +127,20 @@ function Pe() {
   }
   return null;
 }
-var Ee = S(() => {
+var Le = S(() => {
 });
 
 // src/http.ts
 var U = {};
 me(U, {
-  checkCoreVersionCompat: () => qe,
-  httpRequest: () => Ot,
-  statusToCode: () => Fe
+  checkCoreVersionCompat: () => Fe,
+  httpRequest: () => At,
+  statusToCode: () => Ue
 });
 function se(r) {
   return r.split("+")[0] ?? r;
 }
-function Rt(r, e) {
+function kt(r, e) {
   let t = se(r).split(".").map(Number), n = se(e).split(".").map(Number), o = Math.max(t.length, n.length);
   for (let i = 0; i < o; i++) {
     let s = t[i] ?? 0, a = n[i] ?? 0;
@@ -148,62 +148,62 @@ function Rt(r, e) {
   }
   return 0;
 }
-function Ne() {
+function qe() {
   try {
-    return "3.8.1";
+    return "3.9.0";
   } catch {
     return;
   }
 }
-function Dt() {
-  let r = Ne();
+function Ct() {
+  let r = qe();
   return r ? parseInt(r.split(".")[0] ?? "3", 10) : 3;
 }
-function qe(r) {
+function Fe(r) {
   if (!r) return;
-  let e = Dt(), t = Tt[e];
+  let e = Ct(), t = Dt[e];
   if (!t) return;
   let n = se(r);
-  if (Rt(n, t) < 0) {
+  if (kt(n, t) < 0) {
     let o = `${e}:${n}`;
-    Le.has(o) || (Le.add(o), console.warn(
+    Me.has(o) || (Me.add(o), console.warn(
       `[Neetru SDK] Aten\xE7\xE3o: Core vers\xE3o "${r}" \xE9 anterior ao m\xEDnimo recomendado "${t}" para SDK major ${e}. Alguns recursos podem n\xE3o funcionar corretamente. Atualize o Core para a vers\xE3o mais recente.`
     ));
   }
 }
-function kt() {
+function It() {
   let r = "This operation requires an apiKey. Pass it to createNeetruClient({ apiKey }) or set NEETRU_API_KEY env var.";
-  return Pe() ? "Esta opera\xE7\xE3o exige a credencial nrt_ do produto, que \xE9 S\xD3 DE SERVIDOR. No navegador/app, chame a API do seu produto (ex.: https://<produto>.neetru.com/api/v1) com o token do usu\xE1rio \u2014 o backend do produto faz esta chamada com o SDK e a chave. (" + r + ")" : r;
+  return Ee() ? "Esta opera\xE7\xE3o exige a credencial nrt_ do produto, que \xE9 S\xD3 DE SERVIDOR. No navegador/app, chame a API do seu produto (ex.: https://<produto>.neetru.com/api/v1) com o token do usu\xE1rio \u2014 o backend do produto faz esta chamada com o SDK e a chave. (" + r + ")" : r;
 }
-function Me(r) {
+function Oe(r) {
   let e = 200 * Math.pow(4, r), t = e * 0.2 * (Math.random() * 2 - 1);
   return Math.max(50, Math.round(e + t));
 }
-function Lt(r) {
+function Ot(r) {
   if (!r) return null;
   let e = Number(r);
-  if (Number.isFinite(e) && e >= 0) return Math.min(Math.round(e * 1e3), Oe);
+  if (Number.isFinite(e) && e >= 0) return Math.min(Math.round(e * 1e3), xe);
   let t = Date.parse(r);
   if (Number.isFinite(t)) {
     let n = t - Date.now();
-    if (n > 0) return Math.min(n, Oe);
+    if (n > 0) return Math.min(n, xe);
   }
   return null;
 }
-function xe(r) {
+function Ae(r) {
   return new Promise((e) => setTimeout(e, r));
 }
-function Fe(r) {
+function Ue(r) {
   return r === 401 ? "unauthorized" : r === 403 ? "forbidden" : r === 404 ? "not_found" : r === 409 ? "conflict" : r === 410 ? "gone" : r === 422 || r === 400 ? "validation_failed" : r === 429 ? "rate_limited" : r >= 500 ? "server_error" : "unknown";
 }
-function Mt(r, e, t) {
+function xt(r, e, t) {
   let n = r.replace(/\/+$/, ""), o = e.startsWith("/") ? e : `/${e}`, i = new URL(`${n}${o}`);
   if (t)
     for (let [s, a] of Object.entries(t))
       a !== void 0 && i.searchParams.set(s, String(a));
   return i.toString();
 }
-async function Ae(r) {
+async function Ne(r) {
   let e = await r.text();
   if (e)
     try {
@@ -212,18 +212,18 @@ async function Ae(r) {
       return;
     }
 }
-async function Ot(r, e) {
-  let t = e.method ?? "GET", n = Mt(r.baseUrl, e.path, e.query), o = Pt.has(t) ? Ct : It, i = e.retries ?? o, { headers: s, correlationId: a } = Ce(
+async function At(r, e) {
+  let t = e.method ?? "GET", n = xt(r.baseUrl, e.path, e.query), o = Lt.has(t) ? Pt : Et, i = e.retries ?? o, { headers: s, correlationId: a } = Ie(
     { accept: "application/json", ...e.headers },
     e.correlationId
-  ), c = Ne();
+  ), c = qe();
   if (c && (s["x-neetru-sdk-version"] = c), e.requireAuth) {
     if (!r.apiKey)
-      throw new b("missing_api_key", kt());
+      throw new b("missing_api_key", It());
     s.authorization = `Bearer ${r.apiKey}`;
   }
   if (e.idempotencyKey) {
-    let p = typeof e.idempotencyKey == "string" ? e.idempotencyKey : Te();
+    let p = typeof e.idempotencyKey == "string" ? e.idempotencyKey : Re();
     s["idempotency-key"] = p;
   }
   let l = e.body !== void 0 && t !== "GET" && t !== "DELETE" ? JSON.stringify(e.body) : void 0;
@@ -249,9 +249,9 @@ async function Ot(r, e) {
     } catch (m) {
       let O = m instanceof DOMException && m.name === "TimeoutError" ? "Network error: timeout after 30s" : `Network error: ${m instanceof Error ? m.message : "fetch failed"}`;
       if (d = new b("network_error", O, void 0, void 0, void 0, a), p < i) {
-        let he = Me(p);
+        let he = Oe(p);
         if (u == null || Date.now() + he < u) {
-          await xe(he);
+          await Ae(he);
           continue;
         }
       }
@@ -260,9 +260,9 @@ async function Ot(r, e) {
     let B = y.headers.get("x-request-id") ?? y.headers.get("x-correlation-id") ?? void 0;
     if (y.ok) {
       let m = y.headers.get("x-neetru-version");
-      return m && qe(m), await Ae(y);
+      return m && Fe(m), await Ne(y);
     }
-    let g = await Ae(y), v = Fe(y.status), w = `HTTP ${y.status}`, C;
+    let g = await Ne(y), v = Ue(y.status), w = `HTTP ${y.status}`, C;
     if (g && typeof g == "object") {
       let m = g.error;
       typeof m == "string" ? w = m : m && typeof m == "object" ? (typeof m.code == "string" && (v = m.code), typeof m.message == "string" && (w = m.message), typeof m.reason == "string" && (C = m.reason)) : (typeof g.code == "string" && (v = g.code), typeof g.message == "string" && (w = g.message)), typeof g.reason == "string" && (C = g.reason);
@@ -272,10 +272,10 @@ async function Ot(r, e) {
       w === `HTTP ${y.status}` && (w = `Endpoint ${e.path} foi removido do Core (HTTP 410 Gone) \u2014 atualize o @neetru/sdk e migre para a API substituta.`), m && !w.includes(m) && (w += ` Substituto: ${m}.`);
     }
     let fe = new b(v, w, y.status, B, C, a);
-    if (d = fe, Et.has(v) && p < i) {
-      let O = Lt(y.headers.get("retry-after")) ?? Me(p);
+    if (d = fe, Mt.has(v) && p < i) {
+      let O = Ot(y.headers.get("retry-after")) ?? Oe(p);
       if (u == null || Date.now() + O < u) {
-        await xe(O);
+        await Ae(O);
         continue;
       }
     }
@@ -283,30 +283,30 @@ async function Ot(r, e) {
   }
   throw d ?? new b("unknown", "unexpected httpRequest exit", void 0, void 0, void 0, a);
 }
-var Tt, Le, Ct, It, Pt, Et, Oe, W = S(() => {
+var Dt, Me, Pt, Et, Lt, Mt, xe, W = S(() => {
   x();
-  Re();
-  Ie();
-  Ee();
-  Tt = {
+  De();
+  Pe();
+  Le();
+  Dt = {
     // SDK major 3.x requer Core ≥ 2026.05.1 (suporte a X-Neetru-Version header,
     // runTransaction write-after-read, verifyWebhookRequest, webhooks 3.0+)
     3: "2026.05.1"
   };
-  Le = /* @__PURE__ */ new Set();
-  Ct = 2, It = 0, Pt = /* @__PURE__ */ new Set(["GET", "HEAD"]), Et = /* @__PURE__ */ new Set([
+  Me = /* @__PURE__ */ new Set();
+  Pt = 2, Et = 0, Lt = /* @__PURE__ */ new Set(["GET", "HEAD"]), Mt = /* @__PURE__ */ new Set([
     "rate_limited",
     "server_error",
     "network_error"
   ]);
-  Oe = 6e4;
+  xe = 6e4;
 });
 
 // src/db/sql/resilient-pool.ts
 function J(r) {
   return typeof r == "object" && r !== null && r[ae] === true;
 }
-function xt(r) {
+function Nt(r) {
   let e = r && typeof r == "object" && "code" in r ? r.code : void 0;
   if (e === "ECONNREFUSED" || e === "ETIMEDOUT" || e === "ENOTFOUND" || e === "EHOSTUNREACH" || e === "EAI_AGAIN")
     return true;
@@ -318,15 +318,15 @@ function xt(r) {
   let n = (r instanceof Error ? r.message : typeof r == "string" ? r : "").toLowerCase();
   return n.length === 0 ? false : !!(n.includes("certificate expired") || n.includes("certificate has expired") || n.includes("cert_has_expired") || n.includes("alert certificate expired") || n.includes("err_ssl") || n.includes("sslv3 alert") || n.includes("tlsv1 alert") || n.includes("econnrefused") || n.includes("etimedout") || n.includes("enotfound") || n.includes("ehostunreach") || n.includes("getaddrinfo"));
 }
-function Ue(r) {
+function We(r) {
   let e = r && typeof r == "object" && "code" in r ? r.code : void 0;
-  if (typeof e == "string" && At.has(e.toUpperCase()))
+  if (typeof e == "string" && qt.has(e.toUpperCase()))
     return true;
   let n = (r instanceof Error ? r.message : typeof r == "string" ? r : "").toLowerCase();
   return n.length === 0 ? false : n.includes("password authentication failed") || n.includes("sasl authentication failed");
 }
-function Nt(r) {
-  return xt(r) || Ue(r);
+function Ft(r) {
+  return Nt(r) || We(r);
 }
 function ce(r) {
   let e = { current: r }, t = null, n = {
@@ -356,7 +356,7 @@ function ce(r) {
       }
       return await o(d, e.current, p);
     }
-  })(), s = i("query", Nt), a = i("connect", Ue), c = Object.create(Object.getPrototypeOf(r));
+  })(), s = i("query", Ft), a = i("connect", We), c = Object.create(Object.getPrototypeOf(r));
   return new Proxy(c, {
     get(d, u) {
       if (u === ae) return true;
@@ -375,16 +375,16 @@ function ce(r) {
     }
   });
 }
-var ae, At, le = S(() => {
+var ae, qt, le = S(() => {
   ae = /* @__PURE__ */ Symbol.for("neetru.sdk.resilientPool");
-  At = /* @__PURE__ */ new Set(["28P01", "28000"]);
+  qt = /* @__PURE__ */ new Set(["28P01", "28000"]);
 });
 
 // src/db/sql/lease.ts
-function Ft(r, e) {
+function Wt(r, e) {
   return r ? r.leaseId !== e.leaseId || r.credentialVersion !== e.credentialVersion || r.host !== e.host || r.port !== e.port || r.dbName !== e.dbName || r.user !== e.user || r.password !== e.password || r.sslca !== e.sslca || r.clientCert !== e.clientCert || r.clientKey !== e.clientKey : true;
 }
-function Ut(r) {
+function $t(r) {
   if (r instanceof f) return r;
   let e = r instanceof Error ? r.message : String(r), t = r instanceof Error ? r.code : void 0;
   return typeof t == "string" && (t === "ECONNREFUSED" || t === "ENOTFOUND" || t === "ETIMEDOUT") ? new f(
@@ -392,10 +392,10 @@ function Ut(r) {
     `Pool connection failed (${t}): ${e}`
   ) : e.includes("statement timeout") || e.includes("lock timeout") ? new f("db_timeout", `Query timeout: ${e}`) : e.includes("40001") || e.includes("40P01") || e.includes("deadlock") ? new f("db_conflict", `Transaction conflict: ${e}`) : e.includes("42501") || e.toLowerCase().includes("permission denied") ? new f("db_permission_denied", `Permission denied: ${e}`) : new f("db_unavailable", `Database error: ${e}`);
 }
-var qt, M, $, We = S(() => {
+var Ut, M, $, $e = S(() => {
   I();
   le();
-  qt = 0.8, M = 3e4, $ = class {
+  Ut = 0.8, M = 3e4, $ = class {
     /**
      * Lease atual. `null` no modo LAZY antes da 1ª query (o 1º lease é adiado —
      * ver `_ensureInitialLease`). Após a 1ª aquisição, sempre não-nulo.
@@ -435,7 +435,7 @@ var qt, M, $, We = S(() => {
           isolationLevel: t.isolationLevel
         }) : await this._orm.transaction(e);
       } catch (n) {
-        throw Ut(n);
+        throw $t(n);
       }
     }
     async close() {
@@ -458,7 +458,7 @@ var qt, M, $, We = S(() => {
       if (!Number.isFinite(e)) return M;
       let t = this._deps.now(), n = e - t;
       if (n <= 0) return M;
-      let o = n * (1 - qt);
+      let o = n * (1 - Ut);
       return Math.max(M, Math.round(o));
     }
     _scheduleRenewal() {
@@ -597,7 +597,7 @@ var qt, M, $, We = S(() => {
      * Exposto como método protegido para testes.
      */
     async _swapPool(e) {
-      if (!Ft(this._lease, e)) {
+      if (!Wt(this._lease, e)) {
         this._lease = e;
         return;
       }
@@ -624,29 +624,29 @@ var qt, M, $, We = S(() => {
 });
 
 // src/db/sql/sql-client.ts
-var He = {};
-me(He, {
-  DEFAULT_POOL_CONNECT_TIMEOUT_MS: () => ze,
-  DEFAULT_POOL_IDLE_MS: () => Qe,
-  DEFAULT_POOL_MAX: () => Ve,
-  LEASE_ENDPOINT: () => $e,
-  LEASE_RENEW_ENDPOINT: () => Be,
-  createDrizzleHandle: () => jt,
+var Ge = {};
+me(Ge, {
+  DEFAULT_POOL_CONNECT_TIMEOUT_MS: () => Ke,
+  DEFAULT_POOL_IDLE_MS: () => ze,
+  DEFAULT_POOL_MAX: () => Qe,
+  LEASE_ENDPOINT: () => Be,
+  LEASE_RENEW_ENDPOINT: () => Ve,
+  createDrizzleHandle: () => Qt,
   createHttpLeaseFetcher: () => je,
-  createPgPool: () => Bt,
-  createSqlClientFromConfig: () => Qt,
-  createSqlClientWithDeps: () => Ke,
+  createPgPool: () => jt,
+  createSqlClientFromConfig: () => Kt,
+  createSqlClientWithDeps: () => He,
   resolvePoolTuning: () => ue
 });
-function Wt(r) {
+function Bt(r) {
   return r === "workspace" ? "staging" : r === "prod" ? "production" : "dev-local";
 }
 function je(r) {
   return async (e) => {
-    let { httpRequest: t } = await Promise.resolve().then(() => (W(), U)), n = !!e?.leaseId, o = n ? Be : $e, i;
+    let { httpRequest: t } = await Promise.resolve().then(() => (W(), U)), n = !!e?.leaseId, o = n ? Ve : Be, i;
     n ? i = { leaseId: e.leaseId } : (i = {
       productId: r.productId ?? "",
-      environment: Wt(r.env ?? "prod")
+      environment: Bt(r.env ?? "prod")
     }, e?.database !== void 0 && (i.database = e.database));
     let s;
     try {
@@ -672,10 +672,10 @@ function je(r) {
         `Falha ao ${c} lease SQL: ${l}`
       );
     }
-    return $t(s);
+    return Vt(s);
   };
 }
-function $t(r) {
+function Vt(r) {
   if (!r || typeof r != "object")
     throw new f("db_unavailable", "Resposta de lease inv\xE1lida (n\xE3o \xE9 objeto).");
   let t = r.lease;
@@ -717,12 +717,12 @@ function ue() {
   return {
     // Teto 100: bem abaixo do `max_client_conn = 500` do PgBouncer, com folga
     // para múltiplas instâncias do app dividirem o mesmo front-door.
-    max: de("NEETRU_DB_POOL_MAX", Ve, 1, 100),
+    max: de("NEETRU_DB_POOL_MAX", Qe, 1, 100),
     // Teto 15min = janela do cert; piso 1s.
-    idleTimeoutMillis: de("NEETRU_DB_POOL_IDLE_MS", Qe, 1e3, 9e5),
+    idleTimeoutMillis: de("NEETRU_DB_POOL_IDLE_MS", ze, 1e3, 9e5),
     connectionTimeoutMillis: de(
       "NEETRU_DB_POOL_CONNECT_TIMEOUT_MS",
-      ze,
+      Ke,
       1e3,
       12e4
     ),
@@ -730,7 +730,7 @@ function ue() {
     keepAliveInitialDelayMillis: 1e4
   };
 }
-async function Bt(r) {
+async function jt(r) {
   let { Pool: e } = await import(
     /* webpackIgnore: true */
     'pg'
@@ -750,14 +750,14 @@ async function Bt(r) {
     ...ue()
   });
 }
-async function jt(r, e) {
+async function Qt(r, e) {
   let { drizzle: t } = await import(
     /* webpackIgnore: true */
     'drizzle-orm/node-postgres'
   );
   return t(r, { schema: e });
 }
-function Vt(r, e) {
+function zt(r, e) {
   let t = null, n = null, o = () => t ? Promise.resolve(t) : (n || (n = e().then((s) => (t = s, n = null, s)).catch((s) => {
     throw n = null, s;
   })), n), i = {
@@ -773,10 +773,10 @@ function Vt(r, e) {
   };
   return r && Object.setPrototypeOf(i, r), i;
 }
-async function Ke(r, e) {
+async function He(r, e) {
   let t = e?.database !== void 0 ? { ...r, database: e.database } : r;
   if (t.lazy) {
-    let c = null, l = Vt(t.poolPrototype ?? null, () => {
+    let c = null, l = zt(t.poolPrototype ?? null, () => {
       if (!c)
         throw new f("db_unavailable", "SQL client n\xE3o inicializado (manager ausente).");
       return c._ensureInitialLease();
@@ -817,7 +817,7 @@ async function Ke(r, e) {
   let a = new $(n, i, s, t);
   return i.__neetruSetReLease(() => a._reactiveReLease()), a;
 }
-async function Qt(r, e, t) {
+async function Kt(r, e, t) {
   let n = je(r), o, i;
   try {
     o = await import(
@@ -834,7 +834,7 @@ async function Qt(r, e, t) {
     );
   }
   let s = o.Pool ?? o.default?.Pool;
-  return Ke(
+  return He(
     {
       fetchLease: n,
       createPool: (l) => {
@@ -869,24 +869,37 @@ async function Qt(r, e, t) {
     t
   );
 }
-var $e, Be, Ve, Qe, ze, Ge = S(() => {
+var Be, Ve, Qe, ze, Ke, Xe = S(() => {
   I();
   x();
-  We();
+  $e();
   le();
-  $e = "/api/sdk/v1/db/lease", Be = "/api/sdk/v1/db/lease/renew";
-  Ve = 10, Qe = 6e4, ze = 1e4;
+  Be = "/api/sdk/v1/db/lease", Ve = "/api/sdk/v1/db/lease/renew";
+  Qe = 10, ze = 6e4, Ke = 1e4;
 });
 
 // src/db/client-db.ts
 I();
 
-// src/db/offline/query-engine.ts
+// src/runtime-env.ts
+function tt() {
+  try {
+    if (typeof process < "u" && process.env)
+      return process.env.NODE_ENV === "production";
+  } catch {
+  }
+  return false;
+}
 function _e(r) {
+  return r === "dev" && !tt();
+}
+
+// src/db/offline/query-engine.ts
+function ye(r) {
   return r == null ? 0 : typeof r == "number" ? 1 : typeof r == "string" ? 2 : typeof r == "boolean" ? 3 : 4;
 }
 function A(r, e) {
-  let t = _e(r), n = _e(e);
+  let t = ye(r), n = ye(e);
   if (t !== n) return t - n;
   if (r == null) return 0;
   if (typeof r == "number" && typeof e == "number") return r - e;
@@ -904,7 +917,7 @@ function Z(r, e) {
   }
   return n;
 }
-function et(r, e) {
+function nt(r, e) {
   let t = Z(r, e.field);
   if (t === void 0) return false;
   let { op: n, value: o } = e;
@@ -935,10 +948,10 @@ function et(r, e) {
       );
   }
 }
-function tt(r, e) {
-  return e.every((t) => et(r, t));
+function rt(r, e) {
+  return e.every((t) => nt(r, t));
 }
-function nt(r) {
+function ot(r) {
   return (e, t) => {
     if (r) {
       let n = Z(e.data, r.field), o = Z(t.data, r.field), i = A(n, o);
@@ -948,7 +961,7 @@ function nt(r) {
     return e.id < t.id ? -1 : e.id > t.id ? 1 : 0;
   };
 }
-function rt(r, e) {
+function it(r, e) {
   let t = r.findIndex((n) => n.id === e.docId);
   return t === -1 ? r : e.type === "startAfter" ? r.slice(t + 1) : r.slice(0, t);
 }
@@ -966,9 +979,9 @@ var P = class r {
   evaluate(e, t) {
     let n = e.filter((d) => !d.meta.deleted), o = t.where ?? [];
     o.length > 0 && (n = n.filter(
-      (d) => tt(d.data, o)
+      (d) => rt(d.data, o)
     ));
-    let i = nt(t.orderBy), s = [...n].sort(i), a = t.cursor ? rt(s, t.cursor) : s, c = Math.min(t.limit ?? 20, 500);
+    let i = ot(t.orderBy), s = [...n].sort(i), a = t.cursor ? it(s, t.cursor) : s, c = Math.min(t.limit ?? 20, 500);
     return {
       docs: a.slice(0, c).map((d) => ({ id: d.id, data: d.data })),
       // `incomplete` é sempre true aqui — o QueryEngine não sabe se o cache
@@ -988,7 +1001,7 @@ var P = class r {
 };
 
 // src/db/offline/local-store.ts
-var it = 1, T = "documents", R = "mutations", N = "query_cache", j = "sync_meta", E = "conflict_log", V = class {
+var at = 1, T = "documents", R = "mutations", N = "query_cache", V = "sync_meta", E = "conflict_log", j = class {
   db = null;
   dbName;
   constructor(e) {
@@ -1000,7 +1013,7 @@ var it = 1, T = "documents", R = "mutations", N = "query_cache", j = "sync_meta"
    * Idempotente — chamadas subsequentes são no-ops se o banco já está aberto.
    */
   async open() {
-    this.db === null && (this.db = await openDB(this.dbName, it, {
+    this.db === null && (this.db = await openDB(this.dbName, at, {
       upgrade(e) {
         if (!e.objectStoreNames.contains(T)) {
           let t = e.createObjectStore(T, {
@@ -1014,7 +1027,7 @@ var it = 1, T = "documents", R = "mutations", N = "query_cache", j = "sync_meta"
           });
           t.createIndex("by_seq", "seq"), t.createIndex("by_status", "status"), t.createIndex("by_doc", ["collection", "docId"]), t.createIndex("by_batch", "batchId");
         }
-        if (e.objectStoreNames.contains(N) || e.createObjectStore(N, { keyPath: "queryHash" }), e.objectStoreNames.contains(j) || e.createObjectStore(j, { keyPath: "key" }), !e.objectStoreNames.contains(E)) {
+        if (e.objectStoreNames.contains(N) || e.createObjectStore(N, { keyPath: "queryHash" }), e.objectStoreNames.contains(V) || e.createObjectStore(V, { keyPath: "key" }), !e.objectStoreNames.contains(E)) {
           let t = e.createObjectStore(E, {
             keyPath: "id",
             autoIncrement: true
@@ -1101,14 +1114,14 @@ var it = 1, T = "documents", R = "mutations", N = "query_cache", j = "sync_meta"
    *   'lastFullResyncAt', 'leaderTabId'.
    */
   async getMeta(e) {
-    let n = await this.assertOpen().get(j, e);
+    let n = await this.assertOpen().get(V, e);
     return n ? n.value : null;
   }
   /**
    * Armazena ou atualiza um valor na store `sync_meta`.
    */
   async setMeta(e, t) {
-    await this.assertOpen().put(j, { key: e, value: t });
+    await this.assertOpen().put(V, { key: e, value: t });
   }
   // ─── Conflict log ───────────────────────────────────────────────────────────
   /**
@@ -1549,10 +1562,10 @@ var z = class {
 
 // src/db/field-value.ts
 var te = "__neetru__";
-function st() {
+function ct() {
   return { __neetru__: "serverTimestamp" };
 }
-function at(r) {
+function lt(r) {
   if (typeof r != "number" || !Number.isFinite(r))
     throw new TypeError(
       `increment(n): n deve ser um n\xFAmero finito (recebido: ${String(r)}).`
@@ -1562,19 +1575,19 @@ function at(r) {
 function D(r) {
   return typeof r == "object" && r !== null && te in r && typeof r[te] == "string";
 }
-function ye(r) {
+function ge(r) {
   return D(r) && r.__neetru__ === "serverTimestamp";
 }
-function ge(r) {
+function be(r) {
   return D(r) && r.__neetru__ === "increment" && typeof r.operand == "number" && Number.isFinite(r.operand);
 }
-function ct(r, e) {
-  return ye(r) ? Date.now() : ge(r) ? (typeof e == "number" && Number.isFinite(e) ? e : 0) + r.operand : r;
+function dt(r, e) {
+  return ge(r) ? Date.now() : be(r) ? (typeof e == "number" && Number.isFinite(e) ? e : 0) + r.operand : r;
 }
 function k(r, e) {
   let t = false, n = {};
   for (let [o, i] of Object.entries(r))
-    D(i) ? (t = true, n[o] = ct(i, e?.[o])) : n[o] = i;
+    D(i) ? (t = true, n[o] = dt(i, e?.[o])) : n[o] = i;
   return t ? n : r;
 }
 function ne(r) {
@@ -1584,11 +1597,11 @@ function ne(r) {
 }
 
 // src/db/offline/sync-engine.ts
-var lt = 8, dt = 1e3, ut = 300 * 1e3, re = "truncatedCollections";
-function pt(r) {
+var ut = 8, pt = 1e3, ft = 300 * 1e3, re = "truncatedCollections";
+function ht(r) {
   return r !== null && ne(r);
 }
-function ft(r) {
+function mt(r) {
   if (r === null) return null;
   if (!ne(r)) return r;
   let e = {};
@@ -1790,13 +1803,13 @@ var K = class {
       }), s.push({ type: "removed", collection: e, doc: { id: t, data: a.data } }));
       return;
     }
-    let l = ft(i.payload) ?? a?.data ?? {}, d = {
+    let l = mt(i.payload) ?? a?.data ?? {}, d = {
       collection: e,
       id: t,
       data: i.op === "update" ? { ...a?.data ?? {}, ...l } : (
         // 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.
-        pt(i.payload) ? { ...a?.data ?? {}, ...l } : l
+        ht(i.payload) ? { ...a?.data ?? {}, ...l } : l
       ),
       meta: {
         serverVersion: n,
@@ -1949,7 +1962,7 @@ var K = class {
    *   pending do doc no cache + registra `lastError`/dispara `onError`.
    */
   async _retryOrDeadLetter(e, t, n) {
-    if (e.attempts + 1 < lt) {
+    if (e.attempts + 1 < ut) {
       await this._queue.markRetry(e.mutationId, t);
       return;
     }
@@ -1990,7 +2003,7 @@ var K = class {
   }
   /** Backoff exponencial keyed em `attempts`, com teto `BACKOFF_CAP_MS`. */
   _backoffDelayMs(e) {
-    return Math.min(dt * 2 ** (e - 1), ut);
+    return Math.min(pt * 2 ** (e - 1), ft);
   }
   // ─── FASE 2 — pull (reconciliar o cache) ─────────────────────────────────────
   /**
@@ -2242,7 +2255,7 @@ var K = class {
 };
 
 // src/db/offline/conflict-resolver.ts
-function be(r, e) {
+function ve(r, e) {
   return e === null ? false : r === null ? true : e > r;
 }
 var H = class r {
@@ -2279,7 +2292,7 @@ var H = class r {
         resolvedData: t.data,
         conflictRecord: null
       };
-    if (!be(
+    if (!ve(
       e.meta.updatedAtServer,
       t.meta.updatedAtServer
     ))
@@ -2326,7 +2339,7 @@ var H = class r {
     let i = t.data;
     if (e === null)
       return { outcome: "no_conflict", resolvedData: { ...i, ...n.payload ?? {} }, conflictRecord: null };
-    if (!be(
+    if (!ve(
       e.meta.updatedAtServer,
       t.meta.updatedAtServer
     ))
@@ -2404,7 +2417,7 @@ var H = class r {
 };
 
 // src/db/offline/change-bus.ts
-function ht(r) {
+function _t(r) {
   return `${r.collection}::${r.doc.id}`;
 }
 var G = class {
@@ -2452,7 +2465,7 @@ var G = class {
     if (e.length === 0) return;
     let t = /* @__PURE__ */ new Map();
     for (let i of e)
-      t.set(ht(i), i);
+      t.set(_t(i), i);
     let n = Array.from(t.values()), o = /* @__PURE__ */ new Map();
     for (let i of n)
       o.has(i.collection) || o.set(i.collection, []), o.get(i.collection).push(i);
@@ -2771,15 +2784,15 @@ var q = class {
 
 // src/db/collection-ref.ts
 I();
-function mt() {
+function yt() {
   return typeof indexedDB > "u" || typeof window > "u";
 }
-var ve = /^[a-z0-9][a-z0-9_-]{0,62}$/;
-function _t(r) {
-  if (!ve.test(r))
+var we = /^[a-z0-9][a-z0-9_-]{0,62}$/;
+function gt(r) {
+  if (!we.test(r))
     throw new f(
       "db_invalid_query",
-      `Nome de cole\xE7\xE3o inv\xE1lido: "${r}". Deve seguir o padr\xE3o ${ve}.`
+      `Nome de cole\xE7\xE3o inv\xE1lido: "${r}". Deve seguir o padr\xE3o ${we}.`
     );
 }
 function L(r, e = "id") {
@@ -2789,7 +2802,7 @@ function L(r, e = "id") {
       `${e} \xE9 obrigat\xF3rio e deve ser uma string n\xE3o-vazia.`
     );
 }
-function yt(r) {
+function bt(r) {
   let e = {};
   if (r?.where && (e.where = r.where.map((t) => ({
     field: t.field,
@@ -2806,7 +2819,7 @@ function yt(r) {
     }
   return e;
 }
-function gt(r, e) {
+function vt(r, e) {
   if (r.length < e) return null;
   let t = r[r.length - 1];
   return t ? btoa(JSON.stringify({ type: "startAfter", docId: t.id })) : null;
@@ -2853,7 +2866,7 @@ var oe = class {
   }
   /** Constrói um DbListResult para a coleção com query opcional. */
   async _buildListResult(e) {
-    let t = yt(e), n = t.limit ?? 20, o = await this._store.listDocs(this._collection, t), i = await this._hasPendingWrites(), s = this._isOnline(), a = this._engine.getSyncState(), c = gt(o.docs, n), l = await this._store.getMeta(re), d = Array.isArray(l) && l.includes(this._collection), u = !s || a.status === "offline" || d, p = i || a.lastSyncedAt === null || u;
+    let t = bt(e), n = t.limit ?? 20, o = await this._store.listDocs(this._collection, t), i = await this._hasPendingWrites(), s = this._isOnline(), a = this._engine.getSyncState(), c = vt(o.docs, n), l = await this._store.getMeta(re), d = Array.isArray(l) && l.includes(this._collection), u = !s || a.status === "offline" || d, p = i || a.lastSyncedAt === null || u;
     return {
       docs: o.docs.map((h) => ({ id: h.id, data: h.data })),
       nextCursor: c,
@@ -3196,7 +3209,7 @@ var oe = class {
     this._store = e.store, this._queue = e.queue, this._bus = e.bus, this._engine = e.engine, this._connectivity = e.connectivity;
   }
   collection(e) {
-    return _t(e), new oe(
+    return gt(e), new oe(
       e,
       this._store,
       this._queue,
@@ -3225,8 +3238,8 @@ var oe = class {
     return this._engine.onError(e);
   }
 };
-async function we(r) {
-  let e = mt() ? new Q() : new V(r.dbName);
+async function Se(r) {
+  let e = yt() ? new Q() : new j(r.dbName);
   await e.open();
   let t = new z(e), n = new H(), o = new G(), i = new X({
     // Se startOnline=false, injeta um navigator falso
@@ -3261,9 +3274,9 @@ async function we(r) {
 }
 
 // src/db/realtime/realtime-client.ts
-var bt = 0;
-function Se() {
-  return typeof globalThis.crypto?.randomUUID == "function" ? globalThis.crypto.randomUUID() : `nrt-sub-${Date.now()}-${++bt}-${Math.random().toString(36).slice(2)}`;
+var wt = 0;
+function Te() {
+  return typeof globalThis.crypto?.randomUUID == "function" ? globalThis.crypto.randomUUID() : `nrt-sub-${Date.now()}-${++wt}-${Math.random().toString(36).slice(2)}`;
 }
 var F = class {
   // ── configuração ──────────────────────────────────────────────────────────
@@ -3303,7 +3316,7 @@ var F = class {
   _pendingFrames = [];
   // ── construtor ────────────────────────────────────────────────────────────
   constructor(e) {
-    this._gatewayUrl = e.gatewayUrl, this._wsFactory = e.webSocketFactory ?? vt, this._setTimeout = e.setTimeoutFn ?? globalThis.setTimeout.bind(globalThis), this._clearTimeout = e.clearTimeoutFn ?? globalThis.clearTimeout.bind(globalThis), this._backoffBaseMs = e.backoffBaseMs ?? 1e3, this._backoffMaxMs = e.backoffMaxMs ?? 3e4, this._heartbeatIntervalMs = e.heartbeatIntervalMs ?? 25e3, this._ticketProvider = e.ticketProvider, this._dbId = e.dbId, this._connect();
+    this._gatewayUrl = e.gatewayUrl, this._wsFactory = e.webSocketFactory ?? St, this._setTimeout = e.setTimeoutFn ?? globalThis.setTimeout.bind(globalThis), this._clearTimeout = e.clearTimeoutFn ?? globalThis.clearTimeout.bind(globalThis), this._backoffBaseMs = e.backoffBaseMs ?? 1e3, this._backoffMaxMs = e.backoffMaxMs ?? 3e4, this._heartbeatIntervalMs = e.heartbeatIntervalMs ?? 25e3, this._ticketProvider = e.ticketProvider, this._dbId = e.dbId, this._connect();
   }
   // ── API pública ───────────────────────────────────────────────────────────
   /**
@@ -3317,8 +3330,8 @@ var F = class {
    */
   subscribe(e, t, n) {
     if (this._closed)
-      return Se();
-    let o = Se();
+      return Te();
+    let o = Te();
     this._subscriptions.set(o, {
       subscriptionId: o,
       collection: e,
@@ -3582,7 +3595,7 @@ var F = class {
   _detachHandlers(e) {
     e.onopen = null, e.onmessage = null, e.onclose = null, e.onerror = null;
   }
-}, vt = (r) => {
+}, St = (r) => {
   if (typeof WebSocket > "u")
     throw new Error(
       "[NeetruRealtimeClient] WebSocket n\xE3o dispon\xEDvel neste ambiente. Injete uma implementa\xE7\xE3o via `webSocketFactory` nas op\xE7\xF5es."
@@ -3592,11 +3605,11 @@ var F = class {
 
 // src/db/client-db.ts
 I();
-var zt = (r) => `/api/sdk/v1/datastore/${encodeURIComponent(r)}`, Y = (r, e) => `/api/sdk/v1/datastore/${encodeURIComponent(r)}/${encodeURIComponent(e)}`, Xe = 200;
-function Kt(r, e, t) {
-  return e._transport ? e._transport : r === "firestore" && e.firestoreTransport ? e.firestoreTransport : r === "nosql-vm" && e.realtimeGatewayUrl ? Ht(e.realtimeGatewayUrl, t, e) : Je(t);
+var Ht = (r) => `/api/sdk/v1/datastore/${encodeURIComponent(r)}`, Y = (r, e) => `/api/sdk/v1/datastore/${encodeURIComponent(r)}/${encodeURIComponent(e)}`, Je = 200;
+function Gt(r, e, t) {
+  return e._transport ? e._transport : r === "firestore" && e.firestoreTransport ? e.firestoreTransport : r === "nosql-vm" && e.realtimeGatewayUrl ? Xt(e.realtimeGatewayUrl, t, e) : Ye(t);
 }
-function Je(r) {
+function Ye(r) {
   return {
     async pushMutations(e) {
       if (!r)
@@ -3674,7 +3687,7 @@ function Je(r) {
         try {
           l = await t(r, {
             method: "GET",
-            path: zt(c),
+            path: Ht(c),
             requireAuth: !0,
             retries: 2,
             headers: o,
@@ -3682,7 +3695,7 @@ function Je(r) {
             // TRUNCADAS — reportadas em `truncatedCollections` p/ o SyncEngine
             // (a) NÃO rodar deleção-por-ausência e (b) sinalizar
             // `DbListResult.truncated`. Paginação por cursor é tarefa Core (gated).
-            query: { limit: Xe }
+            query: { limit: Je }
           });
         } catch (p) {
           let h = p instanceof Error ? p.message : String(p);
@@ -3692,7 +3705,7 @@ function Je(r) {
           );
         }
         let d = l, u = Array.isArray(d?.items) ? d.items : [];
-        u.length >= Xe && a.push(c);
+        u.length >= Je && a.push(c);
         for (let p of u) {
           if (!p || typeof p != "object") continue;
           let h = p, _ = typeof h.id == "string" ? h.id : null;
@@ -3721,10 +3734,10 @@ function Je(r) {
     }
   };
 }
-function Ht(r, e, t) {
-  let n = Je(e), o = new F({
+function Xt(r, e, t) {
+  let n = Ye(e), o = new F({
     gatewayUrl: r,
-    ticketProvider: Gt(e, t),
+    ticketProvider: Jt(e, t),
     dbId: t.dbId,
     webSocketFactory: t._wsFactory
   });
@@ -3760,7 +3773,7 @@ function Ht(r, e, t) {
     }
   };
 }
-function Gt(r, e) {
+function Jt(r, e) {
   return async () => {
     let { httpRequest: t } = await Promise.resolve().then(() => (W(), U));
     return await t(r, {
@@ -3775,27 +3788,27 @@ function Gt(r, e) {
     });
   };
 }
-function Gn(r, e, t, n) {
+function Zn(r, e, t, n) {
   return new F({ gatewayUrl: r, ticketProvider: e, dbId: t, webSocketFactory: n });
 }
 var pe = false;
-function Xn() {
+function er() {
   pe = false;
 }
-function Xt(r, e) {
+function Yt(r, e) {
   pe || e.dbId && r.env !== "prod" && (typeof window > "u" || typeof console > "u" || typeof console.warn != "function" || (pe = true, console.warn(
     '[neetru/sdk] client.db recebeu `dbId` ("' + e.dbId + '") mas ele N\xC3O roteia nem escopa nada no servidor: as escritas do mundo Documentos (add/set/update/remove/list) SEMPRE caem no datastore gen\xE9rico do Core, escopado s\xF3 por tenant/produto (header x-neetru-tenant). `dbId` apenas nomeia o cache offline LOCAL (IndexedDB). ATEN\xC7\xC3O: usar dbIds distintos no MESMO tenant/produto N\xC3O isola os dados no servidor \u2014 eles se misturam (co-mingling). Veja o JSDoc de NeetruDbOptions.dbId.'
   )));
 }
-function Jn(r, e = {}) {
-  Xt(r, e);
+function tr(r, e = {}) {
+  Yt(r, e);
   let t;
   e.transport !== void 0 ? t = e.transport : e.engine !== void 0 ? (console.warn(
     '[neetru/sdk] NeetruDbOptions.engine est\xE1 depreciado e ser\xE1 removido em v3.0. Use NeetruDbOptions.transport em vez de engine. Valores v\xE1lidos: "rest" | "firestore" | "nosql-vm". Nota: "engine" no SDK configura o TRANSPORTE (REST/Firestore/WebSocket), n\xE3o o storage engine do admin database (firestore-instance, cloud-sql-postgres, \u2026).'
   ), t = e.engine) : t = "rest";
-  let n = Kt(t, e, r), o = e.dbId ?? "default", i = e.dbName ?? `neetru-db__${r.productId ?? "sdk"}__${o}__${r.env}`, s = null, a = null;
+  let n = Gt(t, e, r), o = e.dbId ?? "default", i = e.dbName ?? `neetru-db__${r.productId ?? "sdk"}__${o}__${r.env}`, s = null, a = null;
   function c() {
-    return s || (s = we({
+    return s || (s = Se({
       dbName: i,
       transport: n,
       singleTab: e.singleTab ?? r.env !== "prod"
@@ -3803,15 +3816,15 @@ function Jn(r, e = {}) {
   }
   return {
     collection(l) {
-      return a ? a.collection(l) : Jt(l, c);
+      return a ? a.collection(l) : Zt(l, c);
     },
     async sql(l, d) {
-      if (r.env === "dev")
+      if (_e(r.env))
         throw new f(
           "db_unavailable",
           "[SDK] db.sql() n\xE3o dispon\xEDvel em NEETRU_ENV=dev. Use `neetru dev` para subir o container Postgres local."
         );
-      return (await Promise.resolve().then(() => (Ge(), He))).createSqlClientFromConfig(r, l, d);
+      return (await Promise.resolve().then(() => (Xe(), Ge))).createSqlClientFromConfig(r, l, d);
     },
     get syncState() {
       return a?.syncState ?? {
@@ -3850,7 +3863,7 @@ function Jn(r, e = {}) {
     }
   };
 }
-function Jt(r, e) {
+function Zt(r, e) {
   async function t() {
     return (await e()).collection(r);
   }
@@ -3928,4 +3941,4 @@ function Jt(r, e) {
   };
 }
 
-export { te as NEETRU_SENTINEL_KEY, f as NeetruDbError, Xn as __resetDbIdWarningForTests, Jn as createNeetruDb, Je as createRestSyncTransport, Gn as getWebSocketRealtimeClient, at as increment, D as isFieldSentinel, ge as isIncrementSentinel, ye as isServerTimestampSentinel, st as serverTimestamp };
+export { te as NEETRU_SENTINEL_KEY, f as NeetruDbError, er as __resetDbIdWarningForTests, tr as createNeetruDb, Ye as createRestSyncTransport, Zn as getWebSocketRealtimeClient, lt as increment, D as isFieldSentinel, be as isIncrementSentinel, ge as isServerTimestampSentinel, ct as serverTimestamp };