@neetru/sdk 3.7.0 → 3.8.0

package/dist/usage.mjs

@@ -1,5 +1,5 @@
 // src/errors.ts
-var s = class e extends Error {
+var d = class e extends Error {
   code;
   status;
   requestId;
@@ -12,98 +12,161 @@ var s = class e extends Error {
    * para um `NeetruDbErrorCode` mais específico (recuperável vs não).
    */
   reason;
-  constructor(t, r, i, d, n) {
-    super(r), this.name = "NeetruError", this.code = t, this.status = i, this.requestId = d, this.reason = n, Object.setPrototypeOf(this, e.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(t, r, n, i, o, a) {
+    super(r), this.name = "NeetruError", this.code = t, this.status = n, this.requestId = i, this.reason = o, this.correlationId = a, Object.setPrototypeOf(this, e.prototype);
   }
 };
 
 // src/idempotency.ts
-function k() {
+function T() {
   let e = typeof globalThis < "u" && "crypto" in globalThis ? globalThis.crypto : void 0;
   if (e && typeof e.randomUUID == "function")
     return e.randomUUID();
-  throw new s(
+  throw new d(
     "runtime_unsupported",
     "crypto.randomUUID not available in this runtime. SDK 3.0 requires Node \u226520 or modern browser/Edge."
   );
 }
 
+// src/correlation.ts
+var S = "x-correlation-id";
+var j = /^[A-Za-z0-9._:\-]+$/;
+function x(e) {
+  return typeof e == "string" && e.length > 0 && e.length <= 128 && j.test(e);
+}
+function F() {
+  let e = globalThis.crypto;
+  try {
+    if (e && typeof e.randomUUID == "function") return e.randomUUID();
+  } catch {
+  }
+  let t = new Uint8Array(16), r = false;
+  try {
+    e && typeof e.getRandomValues == "function" && (e.getRandomValues(t), r = !0);
+  } catch {
+    r = false;
+  }
+  if (!r)
+    for (let i = 0; i < t.length; i++) t[i] = Math.floor(Math.random() * 256);
+  t[6] = t[6] & 15 | 64, t[8] = t[8] & 63 | 128;
+  let n = Array.from(t, (i) => i.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 D(e, t) {
+  let r, n = {};
+  for (let [o, a] of Object.entries(e)) {
+    if (o.toLowerCase() === S) {
+      x(a) && (r = a);
+      continue;
+    }
+    n[o] = a;
+  }
+  let i = r ?? (x(t) ? t : void 0) ?? F();
+  return n[S] = i, { headers: n, correlationId: i };
+}
+
+// src/server-only-key.ts
+function A() {
+  try {
+    let e = globalThis.navigator;
+    if (e && e.product === "ReactNative") return "react-native";
+  } catch {
+  }
+  try {
+    let e = globalThis;
+    if (typeof e.window < "u" && typeof e.document < "u") return "browser";
+  } catch {
+  }
+  return null;
+}
+
 // src/http.ts
-var O = {
+var H = {
   // 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 E(e) {
+function v(e) {
   return e.split("+")[0] ?? e;
 }
-function $(e, t) {
-  let r = E(e).split(".").map(Number), i = E(t).split(".").map(Number), d = Math.max(r.length, i.length);
-  for (let n = 0; n < d; n++) {
-    let a = r[n] ?? 0, l = i[n] ?? 0;
-    if (a !== l) return a - l;
+function V(e, t) {
+  let r = v(e).split(".").map(Number), n = v(t).split(".").map(Number), i = Math.max(r.length, n.length);
+  for (let o = 0; o < i; o++) {
+    let a = r[o] ?? 0, c = n[o] ?? 0;
+    if (a !== c) return a - c;
   }
   return 0;
 }
-function C() {
+function q() {
   try {
-    return "3.7.0";
+    return "3.8.0";
   } catch {
     return;
   }
 }
-function P() {
-  let e = C();
+function z() {
+  let e = q();
   return e ? parseInt(e.split(".")[0] ?? "3", 10) : 3;
 }
-var N = /* @__PURE__ */ new Set();
-function K(e) {
+var C = /* @__PURE__ */ new Set();
+function B(e) {
   if (!e) return;
-  let t = P(), r = O[t];
+  let t = z(), r = H[t];
   if (!r) return;
-  let i = E(e);
-  if ($(i, r) < 0) {
-    let d = `${t}:${i}`;
-    N.has(d) || (N.add(d), console.warn(
+  let n = v(e);
+  if (V(n, r) < 0) {
+    let i = `${t}:${n}`;
+    C.has(i) || (C.add(i), console.warn(
       `[Neetru SDK] Aten\xE7\xE3o: Core vers\xE3o "${e}" \xE9 anterior ao m\xEDnimo recomendado "${r}" para SDK major ${t}. Alguns recursos podem n\xE3o funcionar corretamente. Atualize o Core para a vers\xE3o mais recente.`
     ));
   }
 }
-var j = 2, F = 0, H = /* @__PURE__ */ new Set(["GET", "HEAD"]), z = /* @__PURE__ */ new Set([
+function G() {
+  let e = "This operation requires an apiKey. Pass it to createNeetruClient({ apiKey }) or set NEETRU_API_KEY env var.";
+  return A() ? "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. (" + e + ")" : e;
+}
+var X = 2, Y = 0, J = /* @__PURE__ */ new Set(["GET", "HEAD"]), W = /* @__PURE__ */ new Set([
   "rate_limited",
   "server_error",
   "network_error"
 ]);
-function x(e) {
+function O(e) {
   let t = 200 * Math.pow(4, e), r = t * 0.2 * (Math.random() * 2 - 1);
   return Math.max(50, Math.round(t + r));
 }
-var D = 6e4;
-function V(e) {
+var K = 6e4;
+function Z(e) {
   if (!e) return null;
   let t = Number(e);
-  if (Number.isFinite(t) && t >= 0) return Math.min(Math.round(t * 1e3), D);
+  if (Number.isFinite(t) && t >= 0) return Math.min(Math.round(t * 1e3), K);
   let r = Date.parse(e);
   if (Number.isFinite(r)) {
-    let i = r - Date.now();
-    if (i > 0) return Math.min(i, D);
+    let n = r - Date.now();
+    if (n > 0) return Math.min(n, K);
   }
   return null;
 }
-function q(e) {
+function M(e) {
   return new Promise((t) => setTimeout(t, e));
 }
-function G(e) {
+function Q(e) {
   return e === 401 ? "unauthorized" : e === 403 ? "forbidden" : e === 404 ? "not_found" : e === 409 ? "conflict" : e === 410 ? "gone" : e === 422 || e === 400 ? "validation_failed" : e === 429 ? "rate_limited" : e >= 500 ? "server_error" : "unknown";
 }
-function L(e, t, r) {
-  let i = e.replace(/\/+$/, ""), d = t.startsWith("/") ? t : `/${t}`, n = new URL(`${i}${d}`);
+function ee(e, t, r) {
+  let n = e.replace(/\/+$/, ""), i = t.startsWith("/") ? t : `/${t}`, o = new URL(`${n}${i}`);
   if (r)
-    for (let [a, l] of Object.entries(r))
-      l !== void 0 && n.searchParams.set(a, String(l));
-  return n.toString();
+    for (let [a, c] of Object.entries(r))
+      c !== void 0 && o.searchParams.set(a, String(c));
+  return o.toString();
 }
-async function A(e) {
+async function U(e) {
   let t = await e.text();
   if (t)
     try {
@@ -112,86 +175,90 @@ async function A(e) {
       return;
     }
 }
-async function v(e, t) {
-  let r = t.method ?? "GET", i = L(e.baseUrl, t.path, t.query), d = H.has(r) ? j : F, n = t.retries ?? d, a = {
-    accept: "application/json",
-    ...t.headers
-  }, l = C();
-  if (l && (a["x-neetru-sdk-version"] = l), t.requireAuth) {
+async function E(e, t) {
+  let r = t.method ?? "GET", n = ee(e.baseUrl, t.path, t.query), i = J.has(r) ? X : Y, o = t.retries ?? i, { headers: a, correlationId: c } = D(
+    { accept: "application/json", ...t.headers },
+    t.correlationId
+  ), R = q();
+  if (R && (a["x-neetru-sdk-version"] = R), t.requireAuth) {
     if (!e.apiKey)
-      throw new s(
-        "missing_api_key",
-        "This operation requires an apiKey. Pass it to createNeetruClient({ apiKey }) or set NEETRU_API_KEY env var."
-      );
+      throw new d("missing_api_key", G());
     a.authorization = `Bearer ${e.apiKey}`;
   }
   if (t.idempotencyKey) {
-    let f = typeof t.idempotencyKey == "string" ? t.idempotencyKey : k();
-    a["idempotency-key"] = f;
+    let p = typeof t.idempotencyKey == "string" ? t.idempotencyKey : T();
+    a["idempotency-key"] = p;
   }
-  let _ = t.body !== void 0 && r !== "GET" && r !== "DELETE" ? JSON.stringify(t.body) : void 0;
-  _ !== void 0 && (a["content-type"] = "application/json");
-  let g = null, p = t.deadlineMs != null ? Date.now() + t.deadlineMs : null;
-  for (let f = 0; f <= n; f++) {
-    if (p != null && Date.now() >= p)
-      throw g ?? new s("network_error", "Deadline excedido antes de completar a request");
+  let b = t.body !== void 0 && r !== "GET" && r !== "DELETE" ? JSON.stringify(t.body) : void 0;
+  b !== void 0 && (a["content-type"] = "application/json");
+  let g = null, f = t.deadlineMs != null ? Date.now() + t.deadlineMs : null;
+  for (let p = 0; p <= o; p++) {
+    if (f != null && Date.now() >= f)
+      throw g ?? new d(
+        "network_error",
+        "Deadline excedido antes de completar a request",
+        void 0,
+        void 0,
+        void 0,
+        c
+      );
     let w = { method: r, headers: a };
-    _ !== void 0 && (w.body = _);
-    let M = p != null ? Math.max(1, Math.min(3e4, p - Date.now())) : 3e4;
-    w.signal = AbortSignal.timeout(M);
+    b !== void 0 && (w.body = b);
+    let $ = f != null ? Math.max(1, Math.min(3e4, f - Date.now())) : 3e4;
+    w.signal = AbortSignal.timeout($);
     let u;
     try {
-      u = await e.fetch(i, w);
-    } catch (o) {
-      let h = o instanceof DOMException && o.name === "TimeoutError" ? "Network error: timeout after 30s" : `Network error: ${o instanceof Error ? o.message : "fetch failed"}`;
-      if (g = new s("network_error", h), f < n) {
-        let T = x(f);
-        if (p == null || Date.now() + T < p) {
-          await q(T);
+      u = await e.fetch(n, w);
+    } catch (s) {
+      let h = s instanceof DOMException && s.name === "TimeoutError" ? "Network error: timeout after 30s" : `Network error: ${s instanceof Error ? s.message : "fetch failed"}`;
+      if (g = new d("network_error", h, void 0, void 0, void 0, c), p < o) {
+        let k = O(p);
+        if (f == null || Date.now() + k < f) {
+          await M(k);
           continue;
         }
       }
       throw g;
     }
-    let U = u.headers.get("x-request-id") ?? u.headers.get("x-correlation-id") ?? void 0;
+    let L = u.headers.get("x-request-id") ?? u.headers.get("x-correlation-id") ?? void 0;
     if (u.ok) {
-      let o = u.headers.get("x-neetru-version");
-      return o && K(o), await A(u);
+      let s = u.headers.get("x-neetru-version");
+      return s && B(s), await U(u);
     }
-    let c = await A(u), b = G(u.status), m = `HTTP ${u.status}`, I;
-    if (c && typeof c == "object") {
-      let o = c.error;
-      typeof o == "string" ? m = o : o && typeof o == "object" ? (typeof o.code == "string" && (b = o.code), typeof o.message == "string" && (m = o.message), typeof o.reason == "string" && (I = o.reason)) : (typeof c.code == "string" && (b = c.code), typeof c.message == "string" && (m = c.message)), typeof c.reason == "string" && (I = c.reason);
+    let l = await U(u), _ = Q(u.status), m = `HTTP ${u.status}`, I;
+    if (l && typeof l == "object") {
+      let s = l.error;
+      typeof s == "string" ? m = s : s && typeof s == "object" ? (typeof s.code == "string" && (_ = s.code), typeof s.message == "string" && (m = s.message), typeof s.reason == "string" && (I = s.reason)) : (typeof l.code == "string" && (_ = l.code), typeof l.message == "string" && (m = l.message)), typeof l.reason == "string" && (I = l.reason);
     }
     if (u.status === 410) {
-      let o = u.headers.get("x-neetru-replacement");
-      m === `HTTP ${u.status}` && (m = `Endpoint ${t.path} foi removido do Core (HTTP 410 Gone) \u2014 atualize o @neetru/sdk e migre para a API substituta.`), o && !m.includes(o) && (m += ` Substituto: ${o}.`);
+      let s = u.headers.get("x-neetru-replacement");
+      m === `HTTP ${u.status}` && (m = `Endpoint ${t.path} foi removido do Core (HTTP 410 Gone) \u2014 atualize o @neetru/sdk e migre para a API substituta.`), s && !m.includes(s) && (m += ` Substituto: ${s}.`);
     }
-    let R = new s(b, m, u.status, U, I);
-    if (g = R, z.has(b) && f < n) {
-      let h = V(u.headers.get("retry-after")) ?? x(f);
-      if (p == null || Date.now() + h < p) {
-        await q(h);
+    let N = new d(_, m, u.status, L, I, c);
+    if (g = N, W.has(_) && p < o) {
+      let h = Z(u.headers.get("retry-after")) ?? O(p);
+      if (f == null || Date.now() + h < f) {
+        await M(h);
         continue;
       }
     }
-    throw R;
+    throw N;
   }
-  throw g ?? new s("unknown", "unexpected httpRequest exit");
+  throw g ?? new d("unknown", "unexpected httpRequest exit", void 0, void 0, void 0, c);
 }
 
 // src/validators.ts
-var S = /^[a-z0-9][a-z0-9_-]{0,62}$/i;
+var P = /^[a-z0-9][a-z0-9_-]{0,62}$/i;
 function y(e, t) {
-  if (typeof t != "string" || !S.test(t))
-    throw new s(
+  if (typeof t != "string" || !P.test(t))
+    throw new d(
       "validation_failed",
-      `${e} must match ${S.source} (lowercase alphanumeric, _, -; first char must be alphanumeric; max 63 chars)`
+      `${e} must match ${P.source} (lowercase alphanumeric, _, -; first char must be alphanumeric; max 63 chars)`
     );
 }
 
 // src/usage.ts
-function ie(e) {
+function ye(e) {
   return {
     /**
      * Reporta consumo metered de um resource. Hit no endpoint canônico
@@ -205,32 +272,32 @@ function ie(e) {
      * await client.usage.report('api_call', 5, { productId: 'gestovendas', tenantId: 't-acme' });
      * ```
      */
-    async report(t, r = 1, i) {
+    async report(t, r = 1, n) {
       if (!t || typeof t != "string")
-        throw new s("validation_failed", "resource is required");
+        throw new d("validation_failed", "resource is required");
       if (!Number.isFinite(r) || r <= 0 || !Number.isInteger(r))
-        throw new s("validation_failed", "qty must be a positive integer");
-      let d = i?.productId ?? e.productId, n = i?.tenantId ?? e.tenantId;
-      if (!d)
-        throw new s(
+        throw new d("validation_failed", "qty must be a positive integer");
+      let i = n?.productId ?? e.productId, o = n?.tenantId ?? e.tenantId;
+      if (!i)
+        throw new d(
           "validation_failed",
           "productId required (pass to options or set on createNeetruClient)"
         );
-      if (!n)
-        throw new s(
+      if (!o)
+        throw new d(
           "validation_failed",
           "tenantId required (pass to options or set on createNeetruClient)"
         );
-      y("productId", d), y("tenantId", n);
-      let a = await v(e, {
+      y("productId", i), y("tenantId", o);
+      let a = await E(e, {
         method: "POST",
         path: "/api/sdk/v1/usage/record",
-        body: { productId: d, tenantId: n, resource: t, qty: Math.floor(r) },
+        body: { productId: i, tenantId: o, resource: t, qty: Math.floor(r) },
         requireAuth: true,
         idempotencyKey: true
       });
       if (!a || a.ok !== true)
-        throw new s("invalid_response", "usage.report response missing ok");
+        throw new d("invalid_response", "usage.report response missing ok");
       return {
         ok: true,
         counterId: a.counterId,
@@ -248,34 +315,34 @@ function ie(e) {
      */
     async check(t, r) {
       if (!t || typeof t != "string")
-        throw new s("validation_failed", "resource is required");
-      let i = r?.productId ?? e.productId, d = r?.tenantId ?? e.tenantId;
-      if (!i || !d)
-        throw new s(
+        throw new d("validation_failed", "resource is required");
+      let n = r?.productId ?? e.productId, i = r?.tenantId ?? e.tenantId;
+      if (!n || !i)
+        throw new d(
           "validation_failed",
           "productId and tenantId required (pass to options or set on createNeetruClient)"
         );
-      y("productId", i), y("tenantId", d);
-      let n = await v(e, {
+      y("productId", n), y("tenantId", i);
+      let o = await E(e, {
         method: "GET",
         path: "/api/sdk/v1/entitlements",
-        query: { productId: i, tenantId: d, feature: t },
+        query: { productId: n, tenantId: i, feature: t },
         requireAuth: true
       });
-      if (!n || typeof n.allowed != "boolean")
-        throw new s("invalid_response", "usage.check response missing allowed");
-      let a = n.behavior ?? (n.reason === "limit_exceeded" ? "readonly" : null);
+      if (!o || typeof o.allowed != "boolean")
+        throw new d("invalid_response", "usage.check response missing allowed");
+      let a = o.behavior ?? (o.reason === "limit_exceeded" ? "readonly" : null);
       return {
-        allowed: n.allowed,
-        reason: n.reason,
-        remaining: n.remaining,
-        limit: n.limit,
-        planId: n.planId,
-        planFeatures: n.planFeatures,
+        allowed: o.allowed,
+        reason: o.reason,
+        remaining: o.remaining,
+        limit: o.limit,
+        planId: o.planId,
+        planFeatures: o.planFeatures,
         behavior: a
       };
     }
   };
 }
 
-export { ie as createUsageNamespace };
+export { ye as createUsageNamespace };