@neetru/sdk 3.5.0 → 3.7.0

package/dist/usage.mjs

@@ -1,5 +1,5 @@
 // src/errors.ts
-var NeetruError = class _NeetruError extends Error {
+var s = class e extends Error {
   code;
   status;
   requestId;
@@ -12,236 +12,186 @@ 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);
+  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);
   }
 };
 
 // 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 k() {
+  let e = typeof globalThis < "u" && "crypto" in globalThis ? globalThis.crypto : void 0;
+  if (e && typeof e.randomUUID == "function")
+    return e.randomUUID();
+  throw new s(
     "runtime_unsupported",
     "crypto.randomUUID not available in this runtime. SDK 3.0 requires Node \u226520 or modern browser/Edge."
   );
 }
 
 // src/http.ts
-var COMPAT_MATRIX = {
+var O = {
   // 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 E(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 $(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;
   }
   return 0;
 }
-function readInjectedSdkVersion() {
+function C() {
   try {
-    return "3.5.0";
+    return "3.7.0";
   } catch {
-    return void 0;
+    return;
   }
 }
-function getSdkMajor() {
-  const ver = readInjectedSdkVersion();
-  if (ver) return parseInt(ver.split(".")[0] ?? "3", 10);
-  return 3;
+function P() {
+  let e = C();
+  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 N = /* @__PURE__ */ new Set();
+function K(e) {
+  if (!e) return;
+  let t = P(), r = O[t];
+  if (!r) return;
+  let i = E(e);
+  if ($(i, r) < 0) {
+    let d = `${t}:${i}`;
+    N.has(d) || (N.add(d), 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([
+var j = 2, F = 0, H = /* @__PURE__ */ new Set(["GET", "HEAD"]), z = /* @__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 x(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 D = 6e4;
+function V(e) {
+  if (!e) return null;
+  let t = Number(e);
+  if (Number.isFinite(t) && t >= 0) return Math.min(Math.round(t * 1e3), D);
+  let r = Date.parse(e);
+  if (Number.isFinite(r)) {
+    let i = r - Date.now();
+    if (i > 0) return Math.min(i, D);
   }
   return null;
 }
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+function q(e) {
+  return new Promise((t) => setTimeout(t, e));
 }
-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 G(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 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));
-    }
-  }
-  return url.toString();
+function L(e, t, r) {
+  let i = e.replace(/\/+$/, ""), d = t.startsWith("/") ? t : `/${t}`, n = new URL(`${i}${d}`);
+  if (r)
+    for (let [a, l] of Object.entries(r))
+      l !== void 0 && n.searchParams.set(a, String(l));
+  return n.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 A(e) {
+  let t = await e.text();
+  if (t)
+    try {
+      return JSON.parse(t);
+    } catch {
+      return;
+    }
 }
-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 = {
+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",
-    ...opts.headers
-  };
-  const sdkVersion = readInjectedSdkVersion();
-  if (sdkVersion) {
-    headers["x-neetru-sdk-version"] = sdkVersion;
-  }
-  if (opts.requireAuth) {
-    if (!config.apiKey) {
-      throw new NeetruError(
+    ...t.headers
+  }, l = C();
+  if (l && (a["x-neetru-sdk-version"] = l), 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."
       );
-    }
-    headers.authorization = `Bearer ${config.apiKey}`;
-  }
-  if (opts.idempotencyKey) {
-    const key = typeof opts.idempotencyKey === "string" ? opts.idempotencyKey : generateIdempotencyKey();
-    headers["idempotency-key"] = key;
+    a.authorization = `Bearer ${e.apiKey}`;
   }
-  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";
+  if (t.idempotencyKey) {
+    let f = typeof t.idempotencyKey == "string" ? t.idempotencyKey : k();
+    a["idempotency-key"] = f;
   }
-  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 _ = 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 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);
+    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(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);
+          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 U = 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);
     }
-    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 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);
     }
-    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 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}.`);
     }
-    throw err;
+    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);
+        continue;
+      }
+    }
+    throw R;
   }
-  throw lastError ?? new NeetruError("unknown", "unexpected httpRequest exit");
+  throw g ?? new s("unknown", "unexpected httpRequest exit");
 }
 
 // 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 S = /^[a-z0-9][a-z0-9_-]{0,62}$/i;
+function y(e, t) {
+  if (typeof t != "string" || !S.test(t))
+    throw new s(
       "validation_failed",
-      `${field} must match ${SDK_ID_RE.source} (lowercase alphanumeric, _, -; first char must be alphanumeric; max 63 chars)`
+      `${e} must match ${S.source} (lowercase alphanumeric, _, -; first char must be alphanumeric; max 63 chars)`
     );
-  }
 }
 
 // src/usage.ts
-function createUsageNamespace(config) {
+function ie(e) {
   return {
     /**
      * Reporta consumo metered de um resource. Hit no endpoint canônico
@@ -255,46 +205,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, i) {
+      if (!t || typeof t != "string")
+        throw new s("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(
           "validation_failed",
           "productId required (pass to options or set on createNeetruClient)"
         );
-      }
-      if (!tenantId) {
-        throw new NeetruError(
+      if (!n)
+        throw new s(
           "validation_failed",
           "tenantId required (pass to options or set on createNeetruClient)"
         );
-      }
-      assertValidSdkId("productId", productId);
-      assertValidSdkId("tenantId", tenantId);
-      const raw = await httpRequest(config, {
+      y("productId", d), y("tenantId", n);
+      let a = await v(e, {
         method: "POST",
         path: "/api/sdk/v1/usage/record",
-        body: { productId, tenantId, resource, qty: Math.floor(qty) },
+        body: { productId: d, tenantId: n, 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 s("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 +246,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 s("validation_failed", "resource is required");
+      let i = r?.productId ?? e.productId, d = r?.tenantId ?? e.tenantId;
+      if (!i || !d)
+        throw new s(
           "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", i), y("tenantId", d);
+      let n = await v(e, {
         method: "GET",
         path: "/api/sdk/v1/entitlements",
-        query: { productId, tenantId, feature: resource },
+        query: { productId: i, tenantId: d, 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 (!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);
       return {
-        allowed: raw.allowed,
-        reason: raw.reason,
-        remaining: raw.remaining,
-        limit: raw.limit,
-        planId: raw.planId,
-        planFeatures: raw.planFeatures,
-        behavior
+        allowed: n.allowed,
+        reason: n.reason,
+        remaining: n.remaining,
+        limit: n.limit,
+        planId: n.planId,
+        planFeatures: n.planFeatures,
+        behavior: a
       };
     }
   };
 }
 
-export { createUsageNamespace };
-//# sourceMappingURL=usage.mjs.map
-//# sourceMappingURL=usage.mjs.map
+export { ie as createUsageNamespace };