@neetru/sdk 3.7.0 → 3.8.0

package/dist/notifications.mjs

@@ -1,5 +1,5 @@
 // src/errors.ts
-var n = class t extends Error {
+var i = class t extends Error {
   code;
   status;
   requestId;
@@ -12,98 +12,161 @@ var n = class t extends Error {
    * para um `NeetruDbErrorCode` mais específico (recuperável vs não).
    */
   reason;
-  constructor(e, r, i, o, s) {
-    super(r), this.name = "NeetruError", this.code = e, this.status = i, this.requestId = o, this.reason = s, Object.setPrototypeOf(this, t.prototype);
+  /**
+   * 3.8.0: `x-correlation-id` da requisição que falhou. O SDK gera um UUID por
+   * chamada (ou usa o que o chamador passou) e manda no header; o Core grava o
+   * mesmo id nos logs/auditoria — cite-o ao abrir um ticket de suporte.
+   * `undefined` em erros que acontecem antes de qualquer requisição.
+   */
+  correlationId;
+  constructor(e, r, n, o, s, d) {
+    super(r), this.name = "NeetruError", this.code = e, this.status = n, this.requestId = o, this.reason = s, this.correlationId = d, Object.setPrototypeOf(this, t.prototype);
   }
 };
 
 // src/idempotency.ts
-function S() {
+function x() {
   let t = typeof globalThis < "u" && "crypto" in globalThis ? globalThis.crypto : void 0;
   if (t && typeof t.randomUUID == "function")
     return t.randomUUID();
-  throw new n(
+  throw new i(
     "runtime_unsupported",
     "crypto.randomUUID not available in this runtime. SDK 3.0 requires Node \u226520 or modern browser/Edge."
   );
 }
 
+// src/correlation.ts
+var D = "x-correlation-id";
+var B = /^[A-Za-z0-9._:\-]+$/;
+function T(t) {
+  return typeof t == "string" && t.length > 0 && t.length <= 128 && B.test(t);
+}
+function G() {
+  let t = globalThis.crypto;
+  try {
+    if (t && typeof t.randomUUID == "function") return t.randomUUID();
+  } catch {
+  }
+  let e = new Uint8Array(16), r = false;
+  try {
+    t && typeof t.getRandomValues == "function" && (t.getRandomValues(e), r = !0);
+  } catch {
+    r = false;
+  }
+  if (!r)
+    for (let o = 0; o < e.length; o++) e[o] = Math.floor(Math.random() * 256);
+  e[6] = e[6] & 15 | 64, e[8] = e[8] & 63 | 128;
+  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 O(t, e) {
+  let r, n = {};
+  for (let [s, d] of Object.entries(t)) {
+    if (s.toLowerCase() === D) {
+      T(d) && (r = d);
+      continue;
+    }
+    n[s] = d;
+  }
+  let o = r ?? (T(e) ? e : void 0) ?? G();
+  return n[D] = o, { headers: n, correlationId: o };
+}
+
+// src/server-only-key.ts
+function P() {
+  try {
+    let t = globalThis.navigator;
+    if (t && t.product === "ReactNative") return "react-native";
+  } catch {
+  }
+  try {
+    let t = globalThis;
+    if (typeof t.window < "u" && typeof t.document < "u") return "browser";
+  } catch {
+  }
+  return null;
+}
+
 // src/http.ts
-var L = {
+var X = {
   // 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"
 };
-function v(t) {
+function k(t) {
   return t.split("+")[0] ?? t;
 }
-function H(t, e) {
-  let r = v(t).split(".").map(Number), i = v(e).split(".").map(Number), o = Math.max(r.length, i.length);
+function Y(t, e) {
+  let r = k(t).split(".").map(Number), n = k(e).split(".").map(Number), o = Math.max(r.length, n.length);
   for (let s = 0; s < o; s++) {
-    let c = r[s] ?? 0, f = i[s] ?? 0;
-    if (c !== f) return c - f;
+    let d = r[s] ?? 0, u = n[s] ?? 0;
+    if (d !== u) return d - u;
   }
   return 0;
 }
-function C() {
+function q() {
   try {
-    return "3.7.0";
+    return "3.8.0";
   } catch {
     return;
   }
 }
-function V() {
-  let t = C();
+function J() {
+  let t = q();
   return t ? parseInt(t.split(".")[0] ?? "3", 10) : 3;
 }
-var x = /* @__PURE__ */ new Set();
-function z(t) {
+var C = /* @__PURE__ */ new Set();
+function W(t) {
   if (!t) return;
-  let e = V(), r = L[e];
+  let e = J(), r = X[e];
   if (!r) return;
-  let i = v(t);
-  if (H(i, r) < 0) {
-    let o = `${e}:${i}`;
-    x.has(o) || (x.add(o), console.warn(
+  let n = k(t);
+  if (Y(n, r) < 0) {
+    let o = `${e}:${n}`;
+    C.has(o) || (C.add(o), console.warn(
       `[Neetru SDK] Aten\xE7\xE3o: Core vers\xE3o "${t}" \xE9 anterior ao m\xEDnimo recomendado "${r}" para SDK major ${e}. Alguns recursos podem n\xE3o funcionar corretamente. Atualize o Core para a vers\xE3o mais recente.`
     ));
   }
 }
-var F = 2, G = 0, B = /* @__PURE__ */ new Set(["GET", "HEAD"]), J = /* @__PURE__ */ new Set([
+function Z() {
+  let t = "This operation requires an apiKey. Pass it to createNeetruClient({ apiKey }) or set NEETRU_API_KEY env var.";
+  return P() ? "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. (" + t + ")" : t;
+}
+var Q = 2, ee = 0, te = /* @__PURE__ */ new Set(["GET", "HEAD"]), re = /* @__PURE__ */ new Set([
   "rate_limited",
   "server_error",
   "network_error"
 ]);
-function T(t) {
+function U(t) {
   let e = 200 * Math.pow(4, t), r = e * 0.2 * (Math.random() * 2 - 1);
   return Math.max(50, Math.round(e + r));
 }
-var P = 6e4;
-function Y(t) {
+var M = 6e4;
+function ne(t) {
   if (!t) return null;
   let e = Number(t);
-  if (Number.isFinite(e) && e >= 0) return Math.min(Math.round(e * 1e3), P);
+  if (Number.isFinite(e) && e >= 0) return Math.min(Math.round(e * 1e3), M);
   let r = Date.parse(t);
   if (Number.isFinite(r)) {
-    let i = r - Date.now();
-    if (i > 0) return Math.min(i, P);
+    let n = r - Date.now();
+    if (n > 0) return Math.min(n, M);
   }
   return null;
 }
-function D(t) {
+function $(t) {
   return new Promise((e) => setTimeout(e, t));
 }
-function W(t) {
+function oe(t) {
   return t === 401 ? "unauthorized" : t === 403 ? "forbidden" : t === 404 ? "not_found" : t === 409 ? "conflict" : t === 410 ? "gone" : t === 422 || t === 400 ? "validation_failed" : t === 429 ? "rate_limited" : t >= 500 ? "server_error" : "unknown";
 }
-function X(t, e, r) {
-  let i = t.replace(/\/+$/, ""), o = e.startsWith("/") ? e : `/${e}`, s = new URL(`${i}${o}`);
+function ie(t, e, r) {
+  let n = t.replace(/\/+$/, ""), o = e.startsWith("/") ? e : `/${e}`, s = new URL(`${n}${o}`);
   if (r)
-    for (let [c, f] of Object.entries(r))
-      f !== void 0 && s.searchParams.set(c, String(f));
+    for (let [d, u] of Object.entries(r))
+      u !== void 0 && s.searchParams.set(d, String(u));
   return s.toString();
 }
-async function O(t) {
+async function K(t) {
   let e = await t.text();
   if (e)
     try {
@@ -113,97 +176,101 @@ async function O(t) {
     }
 }
 async function h(t, e) {
-  let r = e.method ?? "GET", i = X(t.baseUrl, e.path, e.query), o = B.has(r) ? F : G, s = e.retries ?? o, c = {
-    accept: "application/json",
-    ...e.headers
-  }, f = C();
-  if (f && (c["x-neetru-sdk-version"] = f), e.requireAuth) {
+  let r = e.method ?? "GET", n = ie(t.baseUrl, e.path, e.query), o = te.has(r) ? Q : ee, s = e.retries ?? o, { headers: d, correlationId: u } = O(
+    { accept: "application/json", ...e.headers },
+    e.correlationId
+  ), E = q();
+  if (E && (d["x-neetru-sdk-version"] = E), e.requireAuth) {
     if (!t.apiKey)
-      throw new n(
-        "missing_api_key",
-        "This operation requires an apiKey. Pass it to createNeetruClient({ apiKey }) or set NEETRU_API_KEY env var."
-      );
-    c.authorization = `Bearer ${t.apiKey}`;
+      throw new i("missing_api_key", Z());
+    d.authorization = `Bearer ${t.apiKey}`;
   }
   if (e.idempotencyKey) {
-    let m = typeof e.idempotencyKey == "string" ? e.idempotencyKey : S();
-    c["idempotency-key"] = m;
+    let p = typeof e.idempotencyKey == "string" ? e.idempotencyKey : x();
+    d["idempotency-key"] = p;
   }
-  let _ = e.body !== void 0 && r !== "GET" && r !== "DELETE" ? JSON.stringify(e.body) : void 0;
-  _ !== void 0 && (c["content-type"] = "application/json");
+  let b = e.body !== void 0 && r !== "GET" && r !== "DELETE" ? JSON.stringify(e.body) : void 0;
+  b !== void 0 && (d["content-type"] = "application/json");
   let g = null, l = e.deadlineMs != null ? Date.now() + e.deadlineMs : null;
-  for (let m = 0; m <= s; m++) {
+  for (let p = 0; p <= s; p++) {
     if (l != null && Date.now() >= l)
-      throw g ?? new n("network_error", "Deadline excedido antes de completar a request");
-    let k = { method: r, headers: c };
-    _ !== void 0 && (k.body = _);
-    let j = l != null ? Math.max(1, Math.min(3e4, l - Date.now())) : 3e4;
-    k.signal = AbortSignal.timeout(j);
-    let d;
+      throw g ?? new i(
+        "network_error",
+        "Deadline excedido antes de completar a request",
+        void 0,
+        void 0,
+        void 0,
+        u
+      );
+    let v = { method: r, headers: d };
+    b !== void 0 && (v.body = b);
+    let z = l != null ? Math.max(1, Math.min(3e4, l - Date.now())) : 3e4;
+    v.signal = AbortSignal.timeout(z);
+    let c;
     try {
-      d = await t.fetch(i, k);
+      c = await t.fetch(n, v);
     } catch (a) {
       let y = a instanceof DOMException && a.name === "TimeoutError" ? "Network error: timeout after 30s" : `Network error: ${a instanceof Error ? a.message : "fetch failed"}`;
-      if (g = new n("network_error", y), m < s) {
-        let R = T(m);
-        if (l == null || Date.now() + R < l) {
-          await D(R);
+      if (g = new i("network_error", y, void 0, void 0, void 0, u), p < s) {
+        let A = U(p);
+        if (l == null || Date.now() + A < l) {
+          await $(A);
           continue;
         }
       }
       throw g;
     }
-    let K = d.headers.get("x-request-id") ?? d.headers.get("x-correlation-id") ?? void 0;
-    if (d.ok) {
-      let a = d.headers.get("x-neetru-version");
-      return a && z(a), await O(d);
+    let F = c.headers.get("x-request-id") ?? c.headers.get("x-correlation-id") ?? void 0;
+    if (c.ok) {
+      let a = c.headers.get("x-neetru-version");
+      return a && W(a), await K(c);
     }
-    let u = await O(d), w = W(d.status), p = `HTTP ${d.status}`, I;
-    if (u && typeof u == "object") {
-      let a = u.error;
-      typeof a == "string" ? p = a : a && typeof a == "object" ? (typeof a.code == "string" && (w = a.code), typeof a.message == "string" && (p = a.message), typeof a.reason == "string" && (I = a.reason)) : (typeof u.code == "string" && (w = u.code), typeof u.message == "string" && (p = u.message)), typeof u.reason == "string" && (I = u.reason);
+    let f = await K(c), _ = oe(c.status), m = `HTTP ${c.status}`, I;
+    if (f && typeof f == "object") {
+      let a = f.error;
+      typeof a == "string" ? m = a : a && typeof a == "object" ? (typeof a.code == "string" && (_ = a.code), typeof a.message == "string" && (m = a.message), typeof a.reason == "string" && (I = a.reason)) : (typeof f.code == "string" && (_ = f.code), typeof f.message == "string" && (m = f.message)), typeof f.reason == "string" && (I = f.reason);
     }
-    if (d.status === 410) {
-      let a = d.headers.get("x-neetru-replacement");
-      p === `HTTP ${d.status}` && (p = `Endpoint ${e.path} foi removido do Core (HTTP 410 Gone) \u2014 atualize o @neetru/sdk e migre para a API substituta.`), a && !p.includes(a) && (p += ` Substituto: ${a}.`);
+    if (c.status === 410) {
+      let a = c.headers.get("x-neetru-replacement");
+      m === `HTTP ${c.status}` && (m = `Endpoint ${e.path} foi removido do Core (HTTP 410 Gone) \u2014 atualize o @neetru/sdk e migre para a API substituta.`), a && !m.includes(a) && (m += ` Substituto: ${a}.`);
     }
-    let A = new n(w, p, d.status, K, I);
-    if (g = A, J.has(w) && m < s) {
-      let y = Y(d.headers.get("retry-after")) ?? T(m);
+    let S = new i(_, m, c.status, F, I, u);
+    if (g = S, re.has(_) && p < s) {
+      let y = ne(c.headers.get("retry-after")) ?? U(p);
       if (l == null || Date.now() + y < l) {
-        await D(y);
+        await $(y);
         continue;
       }
     }
-    throw A;
+    throw S;
   }
-  throw g ?? new n("unknown", "unexpected httpRequest exit");
+  throw g ?? new i("unknown", "unexpected httpRequest exit", void 0, void 0, void 0, u);
 }
 
 // src/validators.ts
-var q = /^[a-z0-9][a-z0-9_-]{0,62}$/i;
+var L = /^[a-z0-9][a-z0-9_-]{0,62}$/i;
 function N(t, e) {
-  if (typeof e != "string" || !q.test(e))
-    throw new n(
+  if (typeof e != "string" || !L.test(e))
+    throw new i(
       "validation_failed",
-      `${t} must match ${q.source} (lowercase alphanumeric, _, -; first char must be alphanumeric; max 63 chars)`
+      `${t} must match ${L.source} (lowercase alphanumeric, _, -; first char must be alphanumeric; max 63 chars)`
     );
 }
 
 // src/notifications.ts
-var E = [
+var R = [
   "info",
   "success",
   "warning",
   "error"
 ];
-function M(t) {
+function j(t) {
   if (!t || typeof t != "object")
-    throw new n("invalid_response", "Notification response is not an object");
+    throw new i("invalid_response", "Notification response is not an object");
   let e = t;
   if (typeof e.id != "string")
-    throw new n("invalid_response", "Notification missing id");
-  let r = E.includes(e.severity) ? e.severity : "info";
+    throw new i("invalid_response", "Notification missing id");
+  let r = R.includes(e.severity) ? e.severity : "info";
   return {
     id: e.id,
     userId: typeof e.userId == "string" ? e.userId : "",
@@ -218,56 +285,56 @@ function M(t) {
     dismissedAt: typeof e.dismissedAt == "string" ? e.dismissedAt : void 0
   };
 }
-function $(t) {
-  if (!t.userId) throw new n("validation_failed", "userId obrigat\xF3rio");
-  if (!t.kind) throw new n("validation_failed", "kind obrigat\xF3rio");
-  if (!t.title) throw new n("validation_failed", "title obrigat\xF3rio");
-  if (t.severity && !E.includes(t.severity))
-    throw new n(
+function H(t) {
+  if (!t.userId) throw new i("validation_failed", "userId obrigat\xF3rio");
+  if (!t.kind) throw new i("validation_failed", "kind obrigat\xF3rio");
+  if (!t.title) throw new i("validation_failed", "title obrigat\xF3rio");
+  if (t.severity && !R.includes(t.severity))
+    throw new i(
       "validation_failed",
-      `severity inv\xE1lida: ${t.severity} (use ${E.join("|")})`
+      `severity inv\xE1lida: ${t.severity} (use ${R.join("|")})`
     );
   if (t.title.length > 200)
-    throw new n("validation_failed", "title m\xE1x 200 chars");
+    throw new i("validation_failed", "title m\xE1x 200 chars");
   if (t.body && t.body.length > 2e3)
-    throw new n("validation_failed", "body m\xE1x 2000 chars");
+    throw new i("validation_failed", "body m\xE1x 2000 chars");
 }
-function b(t, ...e) {
+function w(t, ...e) {
   for (let r of e)
     if (typeof r == "string" && r.length > 0)
       return N("productId", r), r;
   if (t.productId)
     return N("productId", t.productId), t.productId;
-  throw new n(
+  throw new i(
     "validation_failed",
     "productId required (pass to options/input or set on createNeetruClient)"
   );
 }
-function ue(t) {
+function Ie(t) {
   return {
     async send(e) {
-      $(e);
-      let i = {
-        productId: b(t, e.productId),
+      H(e);
+      let n = {
+        productId: w(t, e.productId),
         userId: e.userId,
         kind: e.kind,
         title: e.title,
         severity: e.severity ?? "info"
       };
-      e.body !== void 0 && (i.body = e.body), e.link !== void 0 && (i.link = e.link), e.metadata !== void 0 && (i.metadata = e.metadata), e.fingerprint !== void 0 && (i.fingerprint = e.fingerprint);
+      e.body !== void 0 && (n.body = e.body), e.link !== void 0 && (n.link = e.link), e.metadata !== void 0 && (n.metadata = e.metadata), e.fingerprint !== void 0 && (n.fingerprint = e.fingerprint);
       let o = await h(t, {
         method: "POST",
         path: "/api/sdk/v1/notifications",
-        body: i,
+        body: n,
         requireAuth: true,
         idempotencyKey: true
       });
-      return M(o);
+      return j(o);
     },
     async list(e, r) {
-      if (!e) throw new n("validation_failed", "userId obrigat\xF3rio");
+      if (!e) throw new i("validation_failed", "userId obrigat\xF3rio");
       let o = {
-        productId: b(t, r?.productId)
+        productId: w(t, r?.productId)
       };
       r?.includeDismissed && (o.includeDismissed = true), r?.onlyUnread && (o.onlyUnread = true), r?.limit && (o.limit = Math.min(Math.max(1, r.limit), 200));
       let s = await h(t, {
@@ -276,41 +343,41 @@ function ue(t) {
         query: o,
         requireAuth: true
       });
-      return (Array.isArray(s?.notifications) ? s.notifications : []).map(M);
+      return (Array.isArray(s?.notifications) ? s.notifications : []).map(j);
     },
     async markRead(e, r) {
-      if (!e) throw new n("validation_failed", "id obrigat\xF3rio");
-      let i = b(t, r?.productId);
+      if (!e) throw new i("validation_failed", "id obrigat\xF3rio");
+      let n = w(t, r?.productId);
       return await h(t, {
         method: "POST",
         path: `/api/sdk/v1/notifications/${encodeURIComponent(e)}/read`,
-        query: { productId: i },
+        query: { productId: n },
         requireAuth: true
       }), { ok: true };
     },
     async dismiss(e, r) {
-      if (!e) throw new n("validation_failed", "id obrigat\xF3rio");
-      let i = b(t, r?.productId);
+      if (!e) throw new i("validation_failed", "id obrigat\xF3rio");
+      let n = w(t, r?.productId);
       return await h(t, {
         method: "POST",
         path: `/api/sdk/v1/notifications/${encodeURIComponent(e)}/dismiss`,
-        query: { productId: i },
+        query: { productId: n },
         requireAuth: true
       }), { ok: true };
     }
   };
 }
-var U = class {
+var V = class {
   notifications = /* @__PURE__ */ new Map();
   nextId = 1;
   async send(e) {
-    if ($(e), e.fingerprint) {
+    if (H(e), e.fingerprint) {
       let o = Date.now() - 864e5;
       for (let s of this.notifications.values())
         if ((s.metadata ?? {}).fingerprint === e.fingerprint && s.userId === e.userId && new Date(s.createdAt).getTime() > o)
           return s;
     }
-    let r = `mock_notif_${this.nextId++}`, i = {
+    let r = `mock_notif_${this.nextId++}`, n = {
       id: r,
       userId: e.userId,
       kind: e.kind,
@@ -321,23 +388,23 @@ var U = class {
       metadata: e.fingerprint ? { ...e.metadata ?? {}, fingerprint: e.fingerprint } : e.metadata,
       createdAt: (/* @__PURE__ */ new Date()).toISOString()
     };
-    return this.notifications.set(r, i), i;
+    return this.notifications.set(r, n), n;
   }
   async list(e, r) {
-    if (!e) throw new n("validation_failed", "userId obrigat\xF3rio");
-    let i = Math.min(Math.max(1, r?.limit ?? 50), 200);
-    return [...this.notifications.values()].filter((o) => o.userId === e).filter((o) => r?.includeDismissed || !o.dismissedAt).filter((o) => !r?.onlyUnread || !o.readAt).sort((o, s) => s.createdAt.localeCompare(o.createdAt)).slice(0, i);
+    if (!e) throw new i("validation_failed", "userId obrigat\xF3rio");
+    let n = Math.min(Math.max(1, r?.limit ?? 50), 200);
+    return [...this.notifications.values()].filter((o) => o.userId === e).filter((o) => r?.includeDismissed || !o.dismissedAt).filter((o) => !r?.onlyUnread || !o.readAt).sort((o, s) => s.createdAt.localeCompare(o.createdAt)).slice(0, n);
   }
   async markRead(e, r) {
-    let i = this.notifications.get(e);
-    if (!i) throw new n("not_found", `Notification ${e} n\xE3o encontrada`);
-    return i.readAt || (i.readAt = (/* @__PURE__ */ new Date()).toISOString(), this.notifications.set(e, i)), { ok: true };
+    let n = this.notifications.get(e);
+    if (!n) throw new i("not_found", `Notification ${e} n\xE3o encontrada`);
+    return n.readAt || (n.readAt = (/* @__PURE__ */ new Date()).toISOString(), this.notifications.set(e, n)), { ok: true };
   }
   async dismiss(e, r) {
-    let i = this.notifications.get(e);
-    if (!i) throw new n("not_found", `Notification ${e} n\xE3o encontrada`);
-    return i.dismissedAt || (i.dismissedAt = (/* @__PURE__ */ new Date()).toISOString(), this.notifications.set(e, i)), { ok: true };
+    let n = this.notifications.get(e);
+    if (!n) throw new i("not_found", `Notification ${e} n\xE3o encontrada`);
+    return n.dismissedAt || (n.dismissedAt = (/* @__PURE__ */ new Date()).toISOString(), this.notifications.set(e, n)), { ok: true };
   }
 };
 
-export { U as MockNotifications, ue as createNotificationsNamespace };
+export { V as MockNotifications, Ie as createNotificationsNamespace };