@neetru/sdk 3.6.0 → 3.8.0

package/dist/usage.mjs

@@ -1,5 +1,5 @@
 // src/errors.ts
-var NeetruError = class _NeetruError extends Error {
+var d = class e extends Error {
   code;
   status;
   requestId;
@@ -12,236 +12,253 @@ var NeetruError = class _NeetruError extends Error {
    * para um `NeetruDbErrorCode` mais específico (recuperável vs não).
    */
   reason;
-  constructor(code, message, status, requestId, reason) {
-    super(message);
-    this.name = "NeetruError";
-    this.code = code;
-    this.status = status;
-    this.requestId = requestId;
-    this.reason = reason;
-    Object.setPrototypeOf(this, _NeetruError.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 generateIdempotencyKey() {
-  const cryptoObj = typeof globalThis !== "undefined" && "crypto" in globalThis ? globalThis.crypto : void 0;
-  if (cryptoObj && typeof cryptoObj.randomUUID === "function") {
-    return cryptoObj.randomUUID();
-  }
-  throw new NeetruError(
+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 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 COMPAT_MATRIX = {
+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 stripRevision(v) {
-  return v.split("+")[0] ?? v;
+function v(e) {
+  return e.split("+")[0] ?? e;
 }
-function compareCalVer(a, b) {
-  const partsA = stripRevision(a).split(".").map(Number);
-  const partsB = stripRevision(b).split(".").map(Number);
-  const len = Math.max(partsA.length, partsB.length);
-  for (let i = 0; i < len; i++) {
-    const pa = partsA[i] ?? 0;
-    const pb = partsB[i] ?? 0;
-    if (pa !== pb) return pa - pb;
+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 readInjectedSdkVersion() {
+function q() {
   try {
-    return "3.6.0";
+    return "3.8.0";
   } catch {
-    return void 0;
+    return;
   }
 }
-function getSdkMajor() {
-  const ver = readInjectedSdkVersion();
-  if (ver) return parseInt(ver.split(".")[0] ?? "3", 10);
-  return 3;
+function z() {
+  let e = q();
+  return e ? parseInt(e.split(".")[0] ?? "3", 10) : 3;
 }
-var _warnedCoreTooOld = /* @__PURE__ */ new Set();
-function checkCoreVersionCompat(coreVersion) {
-  if (!coreVersion) return;
-  const sdkMajor = getSdkMajor();
-  const minCore = COMPAT_MATRIX[sdkMajor];
-  if (!minCore) return;
-  const stripped = stripRevision(coreVersion);
-  if (compareCalVer(stripped, minCore) < 0) {
-    const key = `${sdkMajor}:${stripped}`;
-    if (!_warnedCoreTooOld.has(key)) {
-      _warnedCoreTooOld.add(key);
-      console.warn(
-        `[Neetru SDK] Aten\xE7\xE3o: Core vers\xE3o "${coreVersion}" \xE9 anterior ao m\xEDnimo recomendado "${minCore}" para SDK major ${sdkMajor}. Alguns recursos podem n\xE3o funcionar corretamente. Atualize o Core para a vers\xE3o mais recente.`
-      );
-    }
+var C = /* @__PURE__ */ new Set();
+function B(e) {
+  if (!e) return;
+  let t = z(), r = H[t];
+  if (!r) return;
+  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 DEFAULT_RETRIES_READ = 2;
-var DEFAULT_RETRIES_WRITE = 0;
-var READ_METHODS = /* @__PURE__ */ new Set(["GET", "HEAD"]);
-var RETRYABLE_CODES = /* @__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 backoffMs(attempt) {
-  const base = 200 * Math.pow(4, attempt);
-  const jitter = base * 0.2 * (Math.random() * 2 - 1);
-  return Math.max(50, Math.round(base + jitter));
+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 MAX_RETRY_AFTER_MS = 6e4;
-function parseRetryAfter(value) {
-  if (!value) return null;
-  const secs = Number(value);
-  if (Number.isFinite(secs) && secs >= 0) return Math.min(Math.round(secs * 1e3), MAX_RETRY_AFTER_MS);
-  const dateMs = Date.parse(value);
-  if (Number.isFinite(dateMs)) {
-    const delta = dateMs - Date.now();
-    if (delta > 0) return Math.min(delta, MAX_RETRY_AFTER_MS);
+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), K);
+  let r = Date.parse(e);
+  if (Number.isFinite(r)) {
+    let n = r - Date.now();
+    if (n > 0) return Math.min(n, K);
   }
   return null;
 }
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+function M(e) {
+  return new Promise((t) => setTimeout(t, 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 statusToCode(status) {
-  if (status === 401) return "unauthorized";
-  if (status === 403) return "forbidden";
-  if (status === 404) return "not_found";
-  if (status === 409) return "conflict";
-  if (status === 422 || status === 400) return "validation_failed";
-  if (status === 429) return "rate_limited";
-  if (status >= 500) return "server_error";
-  return "unknown";
+function ee(e, t, r) {
+  let n = e.replace(/\/+$/, ""), i = t.startsWith("/") ? t : `/${t}`, o = new URL(`${n}${i}`);
+  if (r)
+    for (let [a, c] of Object.entries(r))
+      c !== void 0 && o.searchParams.set(a, String(c));
+  return o.toString();
 }
-function buildUrl(baseUrl, path, query) {
-  const base = baseUrl.replace(/\/+$/, "");
-  const p = path.startsWith("/") ? path : `/${path}`;
-  const url = new URL(`${base}${p}`);
-  if (query) {
-    for (const [k, v] of Object.entries(query)) {
-      if (v === void 0) continue;
-      url.searchParams.set(k, String(v));
+async function U(e) {
+  let t = await e.text();
+  if (t)
+    try {
+      return JSON.parse(t);
+    } catch {
+      return;
     }
-  }
-  return url.toString();
 }
-async function safeJson(res) {
-  const text = await res.text();
-  if (!text) return void 0;
-  try {
-    return JSON.parse(text);
-  } catch {
-    return void 0;
+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 d("missing_api_key", G());
+    a.authorization = `Bearer ${e.apiKey}`;
   }
-}
-async function httpRequest(config, opts) {
-  const method = opts.method ?? "GET";
-  const url = buildUrl(config.baseUrl, opts.path, opts.query);
-  const defaultRetries = READ_METHODS.has(method) ? DEFAULT_RETRIES_READ : DEFAULT_RETRIES_WRITE;
-  const maxRetries = opts.retries ?? defaultRetries;
-  const headers = {
-    accept: "application/json",
-    ...opts.headers
-  };
-  const sdkVersion = readInjectedSdkVersion();
-  if (sdkVersion) {
-    headers["x-neetru-sdk-version"] = sdkVersion;
+  if (t.idempotencyKey) {
+    let p = typeof t.idempotencyKey == "string" ? t.idempotencyKey : T();
+    a["idempotency-key"] = p;
   }
-  if (opts.requireAuth) {
-    if (!config.apiKey) {
-      throw new NeetruError(
-        "missing_api_key",
-        "This operation requires an apiKey. Pass it to createNeetruClient({ apiKey }) or set NEETRU_API_KEY env var."
+  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
       );
-    }
-    headers.authorization = `Bearer ${config.apiKey}`;
-  }
-  if (opts.idempotencyKey) {
-    const key = typeof opts.idempotencyKey === "string" ? opts.idempotencyKey : generateIdempotencyKey();
-    headers["idempotency-key"] = key;
-  }
-  const bodyString = opts.body !== void 0 && method !== "GET" && method !== "DELETE" ? JSON.stringify(opts.body) : void 0;
-  if (bodyString !== void 0) {
-    headers["content-type"] = "application/json";
-  }
-  let lastError = null;
-  for (let attempt = 0; attempt <= maxRetries; attempt++) {
-    const init = { method, headers };
-    if (bodyString !== void 0) init.body = bodyString;
-    init.signal = AbortSignal.timeout(3e4);
-    let res;
+    let w = { method: r, headers: a };
+    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 {
-      res = await config.fetch(url, init);
-    } catch (err2) {
-      const message2 = err2 instanceof DOMException && err2.name === "TimeoutError" ? "Network error: timeout after 30s" : `Network error: ${err2 instanceof Error ? err2.message : "fetch failed"}`;
-      lastError = new NeetruError("network_error", message2);
-      if (attempt < maxRetries) {
-        await sleep(backoffMs(attempt));
-        continue;
+      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 lastError;
+      throw g;
     }
-    const requestId = res.headers.get("x-request-id") ?? res.headers.get("x-correlation-id") ?? void 0;
-    if (res.ok) {
-      const coreVersion = res.headers.get("x-neetru-version");
-      if (coreVersion) checkCoreVersionCompat(coreVersion);
-      const parsed = await safeJson(res);
-      return parsed;
+    let L = u.headers.get("x-request-id") ?? u.headers.get("x-correlation-id") ?? void 0;
+    if (u.ok) {
+      let s = u.headers.get("x-neetru-version");
+      return s && B(s), await U(u);
     }
-    const body = await safeJson(res);
-    let code = statusToCode(res.status);
-    let message = `HTTP ${res.status}`;
-    let reason;
-    if (body && typeof body === "object") {
-      const errField = body.error;
-      if (typeof errField === "string") {
-        message = errField;
-      } else if (errField && typeof errField === "object") {
-        if (typeof errField.code === "string") code = errField.code;
-        if (typeof errField.message === "string") message = errField.message;
-        if (typeof errField.reason === "string") reason = errField.reason;
-      } else {
-        if (typeof body.code === "string") code = body.code;
-        if (typeof body.message === "string") message = body.message;
-      }
-      if (typeof body.reason === "string") reason = body.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);
     }
-    const err = new NeetruError(code, message, res.status, requestId, reason);
-    lastError = err;
-    const isRetryable = RETRYABLE_CODES.has(code);
-    if (isRetryable && attempt < maxRetries) {
-      const retryAfter = parseRetryAfter(res.headers.get("retry-after"));
-      const delay = retryAfter ?? backoffMs(attempt);
-      await sleep(delay);
-      continue;
+    if (u.status === 410) {
+      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 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 err;
+    throw N;
   }
-  throw lastError ?? new NeetruError("unknown", "unexpected httpRequest exit");
+  throw g ?? new d("unknown", "unexpected httpRequest exit", void 0, void 0, void 0, c);
 }
 
 // src/validators.ts
-var SDK_ID_RE = /^[a-z0-9][a-z0-9_-]{0,62}$/i;
-function assertValidSdkId(field, value) {
-  if (typeof value !== "string" || !SDK_ID_RE.test(value)) {
-    throw new NeetruError(
+var P = /^[a-z0-9][a-z0-9_-]{0,62}$/i;
+function y(e, t) {
+  if (typeof t != "string" || !P.test(t))
+    throw new d(
       "validation_failed",
-      `${field} must match ${SDK_ID_RE.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 createUsageNamespace(config) {
+function ye(e) {
   return {
     /**
      * Reporta consumo metered de um resource. Hit no endpoint canônico
@@ -255,46 +272,39 @@ function createUsageNamespace(config) {
      * await client.usage.report('api_call', 5, { productId: 'gestovendas', tenantId: 't-acme' });
      * ```
      */
-    async report(resource, qty = 1, options) {
-      if (!resource || typeof resource !== "string") {
-        throw new NeetruError("validation_failed", "resource is required");
-      }
-      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;
-      if (!productId) {
-        throw new NeetruError(
+    async report(t, r = 1, n) {
+      if (!t || typeof t != "string")
+        throw new d("validation_failed", "resource is required");
+      if (!Number.isFinite(r) || r <= 0 || !Number.isInteger(r))
+        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 (!tenantId) {
-        throw new NeetruError(
+      if (!o)
+        throw new d(
           "validation_failed",
           "tenantId required (pass to options or set on createNeetruClient)"
         );
-      }
-      assertValidSdkId("productId", productId);
-      assertValidSdkId("tenantId", tenantId);
-      const raw = await httpRequest(config, {
+      y("productId", i), y("tenantId", o);
+      let a = await E(e, {
         method: "POST",
         path: "/api/sdk/v1/usage/record",
-        body: { productId, tenantId, resource, qty: Math.floor(qty) },
+        body: { productId: i, tenantId: o, resource: t, qty: Math.floor(r) },
         requireAuth: true,
         idempotencyKey: true
       });
-      if (!raw || raw.ok !== true) {
-        throw new NeetruError("invalid_response", "usage.report response missing ok");
-      }
+      if (!a || a.ok !== true)
+        throw new d("invalid_response", "usage.report response missing ok");
       return {
         ok: true,
-        counterId: raw.counterId,
-        value: raw.value,
-        limit: raw.limit,
-        remaining: raw.remaining,
-        status: raw.status
+        counterId: a.counterId,
+        value: a.value,
+        limit: a.limit,
+        remaining: a.remaining,
+        status: a.status
       };
     },
     /**
@@ -303,43 +313,36 @@ function createUsageNamespace(config) {
      * 'subscription_inactive' | 'feature_not_in_plan' | 'limit_exceeded'),
      * `remaining`, `limit`, `planId`, `planFeatures`.
      */
-    async check(resource, options) {
-      if (!resource || typeof resource !== "string") {
-        throw new NeetruError("validation_failed", "resource is required");
-      }
-      const productId = options?.productId ?? config.productId;
-      const tenantId = options?.tenantId ?? config.tenantId;
-      if (!productId || !tenantId) {
-        throw new NeetruError(
+    async check(t, r) {
+      if (!t || typeof t != "string")
+        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)"
         );
-      }
-      assertValidSdkId("productId", productId);
-      assertValidSdkId("tenantId", tenantId);
-      const raw = await httpRequest(config, {
+      y("productId", n), y("tenantId", i);
+      let o = await E(e, {
         method: "GET",
         path: "/api/sdk/v1/entitlements",
-        query: { productId, tenantId, feature: resource },
+        query: { productId: n, tenantId: i, feature: t },
         requireAuth: true
       });
-      if (!raw || typeof raw.allowed !== "boolean") {
-        throw new NeetruError("invalid_response", "usage.check response missing allowed");
-      }
-      const behavior = raw.behavior ?? (raw.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: raw.allowed,
-        reason: raw.reason,
-        remaining: raw.remaining,
-        limit: raw.limit,
-        planId: raw.planId,
-        planFeatures: raw.planFeatures,
-        behavior
+        allowed: o.allowed,
+        reason: o.reason,
+        remaining: o.remaining,
+        limit: o.limit,
+        planId: o.planId,
+        planFeatures: o.planFeatures,
+        behavior: a
       };
     }
   };
 }
 
-export { createUsageNamespace };
-//# sourceMappingURL=usage.mjs.map
-//# sourceMappingURL=usage.mjs.map
+export { ye as createUsageNamespace };