@neetru/sdk 3.6.0 → 3.8.0

package/dist/ai.mjs

@@ -1,5 +1,5 @@
 // src/errors.ts
-var NeetruError = class _NeetruError extends Error {
+var u = class t extends Error {
   code;
   status;
   requestId;
@@ -12,517 +12,424 @@ 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(e, i, r, n, o, s) {
+    super(i), this.name = "NeetruError", this.code = e, this.status = r, this.requestId = n, this.reason = o, this.correlationId = s, Object.setPrototypeOf(this, t.prototype);
   }
 };
 
+// src/correlation.ts
+var w = "x-correlation-id";
+var V = /^[A-Za-z0-9._:\-]+$/;
+function E(t) {
+  return typeof t == "string" && t.length > 0 && t.length <= 128 && V.test(t);
+}
+function J() {
+  let t = globalThis.crypto;
+  try {
+    if (t && typeof t.randomUUID == "function") return t.randomUUID();
+  } catch {
+  }
+  let e = new Uint8Array(16), i = false;
+  try {
+    t && typeof t.getRandomValues == "function" && (t.getRandomValues(e), i = !0);
+  } catch {
+    i = false;
+  }
+  if (!i)
+    for (let n = 0; n < e.length; n++) e[n] = Math.floor(Math.random() * 256);
+  e[6] = e[6] & 15 | 64, e[8] = e[8] & 63 | 128;
+  let r = Array.from(e, (n) => n.toString(16).padStart(2, "0")).join("");
+  return `${r.slice(0, 8)}-${r.slice(8, 12)}-${r.slice(12, 16)}-${r.slice(16, 20)}-${r.slice(20)}`;
+}
+function x(t, e) {
+  let i, r = {};
+  for (let [o, s] of Object.entries(t)) {
+    if (o.toLowerCase() === w) {
+      E(s) && (i = s);
+      continue;
+    }
+    r[o] = s;
+  }
+  let n = i ?? (E(e) ? e : void 0) ?? J();
+  return r[w] = n, { headers: r, correlationId: n };
+}
+
 // src/http.ts
-var COMPAT_MATRIX = {
+var Y = {
   // 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 A(t) {
+  return t.split("+")[0] ?? t;
 }
-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 Z(t, e) {
+  let i = A(t).split(".").map(Number), r = A(e).split(".").map(Number), n = Math.max(i.length, r.length);
+  for (let o = 0; o < n; o++) {
+    let s = i[o] ?? 0, c = r[o] ?? 0;
+    if (s !== c) return s - 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 ee() {
+  let t = Q();
+  return t ? parseInt(t.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 R = /* @__PURE__ */ new Set();
+function k(t) {
+  if (!t) return;
+  let e = ee(), i = Y[e];
+  if (!i) return;
+  let r = A(t);
+  if (Z(r, i) < 0) {
+    let n = `${e}:${r}`;
+    R.has(n) || (R.add(n), console.warn(
+      `[Neetru SDK] Aten\xE7\xE3o: Core vers\xE3o "${t}" \xE9 anterior ao m\xEDnimo recomendado "${i}" para SDK major ${e}. Alguns recursos podem n\xE3o funcionar corretamente. Atualize o Core para a vers\xE3o mais recente.`
+    ));
   }
 }
-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 T(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";
 }
 
 // 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 b(t, e) {
+  if (typeof e != "string" || !S.test(e))
+    throw new u(
       "validation_failed",
-      `${field} must match ${SDK_ID_RE.source} (lowercase alphanumeric, _, -; first char must be alphanumeric; max 63 chars)`
+      `${t} must match ${S.source} (lowercase alphanumeric, _, -; first char must be alphanumeric; max 63 chars)`
     );
-  }
 }
 
 // src/ai.ts
-var AI_CHAT_PATH = "/api/sdk/v1/ai/chat";
-var AI_NONSTREAM_TIMEOUT_MS = 12e4;
-var MAX_TEXT_PART_LEN = 32768;
-var MAX_CONTENT_PARTS = 32;
-var MAX_DATA_URL_LEN = 4194304;
-var MAX_HTTPS_URL_LEN = 2048;
-var DATA_IMAGE_URL_RE = /^data:image\/(?:png|jpe?g|gif|webp);base64,[A-Za-z0-9+/]+={0,2}$/;
-var HTTPS_URL_RE = /^https:\/\/[^\s]+$/;
-var IMAGE_DETAIL_VALUES = /* @__PURE__ */ new Set(["low", "high", "auto"]);
-var AI_ROLES = /* @__PURE__ */ new Set(["system", "user", "assistant"]);
-var MAX_MESSAGES = 100;
-var MAX_MODEL_LEN = 128;
-var MAX_TOKENS_CAP = 32768;
-var MIN_TEMPERATURE = 0;
-var MAX_TEMPERATURE = 2;
-var MAX_TOTAL_CONTENT_PARTS = 200;
-var MAX_TOTAL_IMAGES = 20;
-var MAX_TOTAL_IMAGE_BYTES = 12 * 1024 * 1024;
-var MAX_SCHEMA_JSON_LEN = 5e4;
-var MAX_SCHEMA_DEPTH = 16;
-var MAX_SCHEMA_KEYS = 500;
-var FORBIDDEN_SCHEMA_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
-var RESPONSE_FORMAT_NAME_RE = /^[a-zA-Z0-9_-]+$/;
-function fail(msg) {
-  throw new NeetruError("validation_failed", msg);
+var te = "/api/sdk/v1/ai/chat", v = 12e4, _ = 32768, C = 32, I = 4194304, M = 2048, ne = /^data:image\/(?:png|jpe?g|gif|webp);base64,[A-Za-z0-9+/]+={0,2}$/, re = /^https:\/\/[^\s]+$/, ie = /* @__PURE__ */ new Set(["low", "high", "auto"]), oe = /* @__PURE__ */ new Set(["system", "user", "assistant"]), j = 100, N = 128, O = 32768, $ = 0, P = 2, D = 200, q = 20, F = 12 * 1024 * 1024, L = 5e4, U = 16, H = 500, se = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]), ae = /^[a-zA-Z0-9_-]+$/;
+function a(t) {
+  throw new u("validation_failed", t);
 }
-function isStrictBase64Payload(b64) {
-  if (b64.length === 0 || b64.length % 4 !== 0) return false;
-  const pad = b64.endsWith("==") ? 2 : b64.endsWith("=") ? 1 : 0;
-  const body = pad > 0 ? b64.slice(0, b64.length - pad) : b64;
-  return !body.includes("=");
+function ce(t) {
+  if (t.length === 0 || t.length % 4 !== 0) return false;
+  let e = t.endsWith("==") ? 2 : t.endsWith("=") ? 1 : 0;
+  return !(e > 0 ? t.slice(0, t.length - e) : t).includes("=");
 }
-function dataUrlDecodedBytes(url) {
-  const comma = url.indexOf(",");
-  if (comma === -1) return 0;
-  const b64 = url.slice(comma + 1);
-  const pad = b64.endsWith("==") ? 2 : b64.endsWith("=") ? 1 : 0;
-  return Math.max(0, Math.floor(b64.length * 3 / 4) - pad);
+function ue(t) {
+  let e = t.indexOf(",");
+  if (e === -1) return 0;
+  let i = t.slice(e + 1), r = i.endsWith("==") ? 2 : i.endsWith("=") ? 1 : 0;
+  return Math.max(0, Math.floor(i.length * 3 / 4) - r);
 }
-function checkAggregateMultimodalLimits(messages) {
-  let totalParts = 0;
-  let totalImages = 0;
-  let totalImageBytes = 0;
-  for (const m of messages) {
-    const content = m?.content;
-    if (!Array.isArray(content)) continue;
-    for (const part of content) {
-      totalParts++;
-      if (totalParts > MAX_TOTAL_CONTENT_PARTS) {
-        return `ai: total content parts exceeds ${MAX_TOTAL_CONTENT_PARTS} per request`;
-      }
-      if (part && typeof part === "object" && part.type === "image_url") {
-        totalImages++;
-        if (totalImages > MAX_TOTAL_IMAGES) {
-          return `ai: total images exceeds ${MAX_TOTAL_IMAGES} per request`;
-        }
-        const url = part.image_url?.url;
-        if (typeof url === "string" && url.startsWith("data:")) {
-          totalImageBytes += dataUrlDecodedBytes(url);
-          if (totalImageBytes > MAX_TOTAL_IMAGE_BYTES) {
-            return `ai: aggregate image bytes exceeds ${MAX_TOTAL_IMAGE_BYTES} per request`;
-          }
+function de(t) {
+  let e = 0, i = 0, r = 0;
+  for (let n of t) {
+    let o = n?.content;
+    if (Array.isArray(o))
+      for (let s of o) {
+        if (e++, e > D)
+          return `ai: total content parts exceeds ${D} per request`;
+        if (s && typeof s == "object" && s.type === "image_url") {
+          if (i++, i > q)
+            return `ai: total images exceeds ${q} per request`;
+          let c = s.image_url?.url;
+          if (typeof c == "string" && c.startsWith("data:") && (r += ue(c), r > F))
+            return `ai: aggregate image bytes exceeds ${F} per request`;
         }
       }
-    }
   }
   return null;
 }
-function validateStructuredSchema(schema) {
-  if (schema === void 0) return null;
-  if (schema === null || typeof schema !== "object") {
+function le(t) {
+  if (t === void 0) return null;
+  if (t === null || typeof t != "object")
     return "ai: responseFormat json_schema.schema must be an object";
-  }
-  let serialized;
+  let e;
   try {
-    serialized = JSON.stringify(schema);
+    e = JSON.stringify(t);
   } catch {
     return "ai: responseFormat json_schema.schema is not serializable";
   }
-  if (serialized === void 0) return "ai: responseFormat json_schema.schema is invalid";
-  if (serialized.length > MAX_SCHEMA_JSON_LEN) {
-    return `ai: responseFormat json_schema.schema exceeds ${MAX_SCHEMA_JSON_LEN} serialized chars`;
-  }
-  let keyCount = 0;
-  const walk = (node, depth) => {
-    if (depth > MAX_SCHEMA_DEPTH) {
-      return `ai: responseFormat json_schema.schema exceeds max depth ${MAX_SCHEMA_DEPTH}`;
-    }
-    if (Array.isArray(node)) {
-      for (const item of node) {
-        const e = walk(item, depth + 1);
-        if (e) return e;
+  if (e === void 0) return "ai: responseFormat json_schema.schema is invalid";
+  if (e.length > L)
+    return `ai: responseFormat json_schema.schema exceeds ${L} serialized chars`;
+  let i = 0, r = (n, o) => {
+    if (o > U)
+      return `ai: responseFormat json_schema.schema exceeds max depth ${U}`;
+    if (Array.isArray(n)) {
+      for (let s of n) {
+        let c = r(s, o + 1);
+        if (c) return c;
       }
       return null;
     }
-    if (node && typeof node === "object") {
-      for (const key of Object.getOwnPropertyNames(node)) {
-        if (FORBIDDEN_SCHEMA_KEYS.has(key)) {
-          return `ai: responseFormat json_schema.schema has forbidden key: ${key}`;
-        }
-        keyCount++;
-        if (keyCount > MAX_SCHEMA_KEYS) {
-          return `ai: responseFormat json_schema.schema exceeds ${MAX_SCHEMA_KEYS} keys`;
-        }
-        const e = walk(node[key], depth + 1);
-        if (e) return e;
+    if (n && typeof n == "object")
+      for (let s of Object.getOwnPropertyNames(n)) {
+        if (se.has(s))
+          return `ai: responseFormat json_schema.schema has forbidden key: ${s}`;
+        if (i++, i > H)
+          return `ai: responseFormat json_schema.schema exceeds ${H} keys`;
+        let c = r(n[s], o + 1);
+        if (c) return c;
       }
-    }
     return null;
   };
-  return walk(schema, 0);
+  return r(t, 0);
 }
-function validateImageUrl(url) {
-  if (typeof url !== "string" || url.length === 0) {
-    fail("ai: image_url.url must be a non-empty string");
-  }
-  const u = url;
-  if (u.startsWith("data:")) {
-    if (u.length > MAX_DATA_URL_LEN) fail(`ai: image_url.url (data:) exceeds ${MAX_DATA_URL_LEN} chars`);
-    if (!DATA_IMAGE_URL_RE.test(u)) {
-      fail("ai: image_url.url data: must be data:image/<png|jpeg|jpg|gif|webp>;base64,<...>");
-    }
-    const b64 = u.slice(u.indexOf(",") + 1);
-    if (!isStrictBase64Payload(b64)) {
-      fail("ai: image_url.url data: has invalid base64 (length/padding)");
-    }
+function fe(t) {
+  (typeof t != "string" || t.length === 0) && a("ai: image_url.url must be a non-empty string");
+  let e = t;
+  if (e.startsWith("data:")) {
+    e.length > I && a(`ai: image_url.url (data:) exceeds ${I} chars`), ne.test(e) || a("ai: image_url.url data: must be data:image/<png|jpeg|jpg|gif|webp>;base64,<...>");
+    let i = e.slice(e.indexOf(",") + 1);
+    ce(i) || a("ai: image_url.url data: has invalid base64 (length/padding)");
     return;
   }
-  if (u.startsWith("https://")) {
-    if (u.length > MAX_HTTPS_URL_LEN) fail(`ai: image_url.url (https:) exceeds ${MAX_HTTPS_URL_LEN} chars`);
-    if (!HTTPS_URL_RE.test(u)) fail("ai: image_url.url https: is invalid");
+  if (e.startsWith("https://")) {
+    e.length > M && a(`ai: image_url.url (https:) exceeds ${M} chars`), re.test(e) || a("ai: image_url.url https: is invalid");
     return;
   }
-  fail("ai: image_url.url must be a data:image/...;base64 or https:// URL (other schemes are rejected)");
+  a("ai: image_url.url must be a data:image/...;base64 or https:// URL (other schemes are rejected)");
 }
-function validateAiContent(content, role) {
-  if (typeof content === "string") {
-    if (content.length === 0) fail("ai: message content string must be non-empty");
-    if (content.length > MAX_TEXT_PART_LEN) fail(`ai: message content exceeds ${MAX_TEXT_PART_LEN} chars`);
+function me(t, e) {
+  if (typeof t == "string") {
+    t.length === 0 && a("ai: message content string must be non-empty"), t.length > _ && a(`ai: message content exceeds ${_} chars`);
     return;
   }
-  if (!Array.isArray(content) || content.length === 0) {
-    fail("ai: message content must be a non-empty string or array of parts");
+  (!Array.isArray(t) || t.length === 0) && a("ai: message content must be a non-empty string or array of parts"), t.length > C && a(`ai: message content has more than ${C} parts`);
+  for (let i of t) {
+    (!i || typeof i != "object") && a("ai: each content part must be an object");
+    let r = i.type;
+    if (r === "text") {
+      let n = i.text;
+      (typeof n != "string" || n.length === 0) && a("ai: text part must have non-empty { text: string }"), n.length > _ && a(`ai: text part exceeds ${_} chars`);
+    } else if (r === "image_url") {
+      e !== "user" && a(`ai: image_url is only allowed in role 'user' messages (got '${e}')`);
+      let n = i.image_url;
+      (!n || typeof n != "object") && a("ai: image_url part must have { image_url: { url } }"), fe(n.url);
+      let o = n.detail;
+      o !== void 0 && (typeof o != "string" || !ie.has(o)) && a("ai: image_url.detail must be 'low' | 'high' | 'auto'");
+    } else
+      a("ai: content part type must be 'text' or 'image_url'");
   }
-  if (content.length > MAX_CONTENT_PARTS) fail(`ai: message content has more than ${MAX_CONTENT_PARTS} parts`);
-  for (const part of content) {
-    if (!part || typeof part !== "object") fail("ai: each content part must be an object");
-    const type = part.type;
-    if (type === "text") {
-      const text = part.text;
-      if (typeof text !== "string" || text.length === 0) fail("ai: text part must have non-empty { text: string }");
-      if (text.length > MAX_TEXT_PART_LEN) fail(`ai: text part exceeds ${MAX_TEXT_PART_LEN} chars`);
-    } else if (type === "image_url") {
-      if (role !== "user") {
-        fail(`ai: image_url is only allowed in role 'user' messages (got '${role}')`);
-      }
-      const iu = part.image_url;
-      if (!iu || typeof iu !== "object") fail("ai: image_url part must have { image_url: { url } }");
-      validateImageUrl(iu.url);
-      const detail = iu.detail;
-      if (detail !== void 0 && (typeof detail !== "string" || !IMAGE_DETAIL_VALUES.has(detail))) {
-        fail("ai: image_url.detail must be 'low' | 'high' | 'auto'");
+}
+function pe(t) {
+  (!t || typeof t != "object") && a("ai: responseFormat must be an object");
+  let e = t.type;
+  if (!(e === "text" || e === "json_object")) {
+    if (e === "json_schema") {
+      let i = t.json_schema;
+      (!i || typeof i != "object") && a("ai: responseFormat json_schema requires { json_schema: { name } }");
+      let r = i, n = r.name;
+      if ((typeof n != "string" || n.length === 0) && a("ai: responseFormat json_schema.name is required"), n.length > 64 && a("ai: responseFormat json_schema.name exceeds 64 chars"), ae.test(n) || a("ai: responseFormat json_schema.name must match a-zA-Z0-9_-"), r.description !== void 0 && (typeof r.description != "string" && a("ai: responseFormat json_schema.description must be a string"), r.description.length > 1e3 && a("ai: responseFormat json_schema.description exceeds 1000 chars")), r.strict !== void 0 && typeof r.strict != "boolean" && a("ai: responseFormat json_schema.strict must be a boolean"), r.schema !== void 0) {
+        let o = le(r.schema);
+        o && a(o);
       }
-    } else {
-      fail("ai: content part type must be 'text' or 'image_url'");
+      return;
     }
+    a("ai: responseFormat.type must be 'text' | 'json_object' | 'json_schema'");
   }
 }
-function validateResponseFormat(rf) {
-  if (!rf || typeof rf !== "object") fail("ai: responseFormat must be an object");
-  const type = rf.type;
-  if (type === "text" || type === "json_object") return;
-  if (type === "json_schema") {
-    const js = rf.json_schema;
-    if (!js || typeof js !== "object") fail("ai: responseFormat json_schema requires { json_schema: { name } }");
-    const jso = js;
-    const name = jso.name;
-    if (typeof name !== "string" || name.length === 0) fail("ai: responseFormat json_schema.name is required");
-    if (name.length > 64) fail("ai: responseFormat json_schema.name exceeds 64 chars");
-    if (!RESPONSE_FORMAT_NAME_RE.test(name)) fail("ai: responseFormat json_schema.name must match a-zA-Z0-9_-");
-    if (jso.description !== void 0) {
-      if (typeof jso.description !== "string") fail("ai: responseFormat json_schema.description must be a string");
-      if (jso.description.length > 1e3) fail("ai: responseFormat json_schema.description exceeds 1000 chars");
-    }
-    if (jso.strict !== void 0 && typeof jso.strict !== "boolean") {
-      fail("ai: responseFormat json_schema.strict must be a boolean");
-    }
-    if (jso.schema !== void 0) {
-      const err = validateStructuredSchema(jso.schema);
-      if (err) fail(err);
-    }
-    return;
-  }
-  fail("ai: responseFormat.type must be 'text' | 'json_object' | 'json_schema'");
-}
-function resolveAiBody(config, opts, stream) {
-  if (!opts || typeof opts !== "object") {
-    throw new NeetruError("validation_failed", "ai: options object is required");
-  }
-  if (typeof opts.model !== "string" || opts.model.length === 0) {
-    throw new NeetruError("validation_failed", "ai: model is required");
-  }
-  if (opts.model.length > MAX_MODEL_LEN) {
-    throw new NeetruError("validation_failed", `ai: model exceeds ${MAX_MODEL_LEN} chars`);
-  }
-  if (!Array.isArray(opts.messages) || opts.messages.length === 0) {
-    throw new NeetruError("validation_failed", "ai: messages must be a non-empty array");
-  }
-  if (opts.messages.length > MAX_MESSAGES) {
-    throw new NeetruError("validation_failed", `ai: messages exceeds ${MAX_MESSAGES} per request`);
-  }
-  for (const m of opts.messages) {
-    if (!m || typeof m !== "object" || typeof m.role !== "string" || !AI_ROLES.has(m.role)) {
-      throw new NeetruError(
+function K(t, e, i) {
+  if (!e || typeof e != "object")
+    throw new u("validation_failed", "ai: options object is required");
+  if (typeof e.model != "string" || e.model.length === 0)
+    throw new u("validation_failed", "ai: model is required");
+  if (e.model.length > N)
+    throw new u("validation_failed", `ai: model exceeds ${N} chars`);
+  if (!Array.isArray(e.messages) || e.messages.length === 0)
+    throw new u("validation_failed", "ai: messages must be a non-empty array");
+  if (e.messages.length > j)
+    throw new u("validation_failed", `ai: messages exceeds ${j} per request`);
+  for (let c of e.messages) {
+    if (!c || typeof c != "object" || typeof c.role != "string" || !oe.has(c.role))
+      throw new u(
         "validation_failed",
         "ai: each message role must be 'system' | 'user' | 'assistant'"
       );
-    }
-    validateAiContent(m.content, m.role);
+    me(c.content, c.role);
   }
-  const aggErr = checkAggregateMultimodalLimits(opts.messages);
-  if (aggErr) throw new NeetruError("validation_failed", aggErr);
-  const productId = opts.productId ?? config.productId;
-  const tenantId = opts.tenantId ?? config.tenantId;
-  if (!productId) {
-    throw new NeetruError(
+  let r = de(e.messages);
+  if (r) throw new u("validation_failed", r);
+  let n = e.productId ?? t.productId, o = e.tenantId ?? t.tenantId;
+  if (!n)
+    throw new u(
       "validation_failed",
       "ai: productId required (pass to options or set on createNeetruClient)"
     );
-  }
-  if (!tenantId) {
-    throw new NeetruError(
+  if (!o)
+    throw new u(
       "validation_failed",
       "ai: tenantId required (pass to options or set on createNeetruClient)"
     );
-  }
-  assertValidSdkId("productId", productId);
-  assertValidSdkId("tenantId", tenantId);
-  const body = {
-    productId,
-    tenantId,
-    model: opts.model,
-    messages: opts.messages,
-    stream
+  b("productId", n), b("tenantId", o);
+  let s = {
+    productId: n,
+    tenantId: o,
+    model: e.model,
+    messages: e.messages,
+    stream: i
   };
-  if (opts.maxTokens !== void 0) {
-    if (!Number.isInteger(opts.maxTokens) || opts.maxTokens <= 0 || opts.maxTokens > MAX_TOKENS_CAP) {
-      throw new NeetruError(
+  if (e.maxTokens !== void 0) {
+    if (!Number.isInteger(e.maxTokens) || e.maxTokens <= 0 || e.maxTokens > O)
+      throw new u(
         "validation_failed",
-        `ai: maxTokens must be a positive integer <= ${MAX_TOKENS_CAP}`
+        `ai: maxTokens must be a positive integer <= ${O}`
       );
-    }
-    body.maxTokens = opts.maxTokens;
+    s.maxTokens = e.maxTokens;
   }
-  if (opts.temperature !== void 0) {
-    if (typeof opts.temperature !== "number" || !Number.isFinite(opts.temperature) || opts.temperature < MIN_TEMPERATURE || opts.temperature > MAX_TEMPERATURE) {
-      throw new NeetruError(
+  if (e.temperature !== void 0) {
+    if (typeof e.temperature != "number" || !Number.isFinite(e.temperature) || e.temperature < $ || e.temperature > P)
+      throw new u(
         "validation_failed",
-        `ai: temperature must be a finite number between ${MIN_TEMPERATURE} and ${MAX_TEMPERATURE}`
+        `ai: temperature must be a finite number between ${$} and ${P}`
       );
-    }
-    body.temperature = opts.temperature;
+    s.temperature = e.temperature;
   }
-  if (opts.responseFormat !== void 0) {
-    validateResponseFormat(opts.responseFormat);
-    body.responseFormat = opts.responseFormat;
-  }
-  return body;
+  return e.responseFormat !== void 0 && (pe(e.responseFormat), s.responseFormat = e.responseFormat), s;
 }
-async function safeJson(res) {
+async function B(t) {
   try {
-    const text = await res.text();
-    if (!text) return void 0;
-    return JSON.parse(text);
+    let e = await t.text();
+    return e ? JSON.parse(e) : void 0;
   } catch {
-    return void 0;
+    return;
   }
 }
-function joinUrl(baseUrl, path) {
-  const base = baseUrl.replace(/\/+$/, "");
-  const p = path.startsWith("/") ? path : `/${path}`;
-  return `${base}${p}`;
+function ge(t, e) {
+  let i = t.replace(/\/+$/, ""), r = e.startsWith("/") ? e : `/${e}`;
+  return `${i}${r}`;
 }
-async function aiFetch(config, body, signal, stream) {
-  if (!config.apiKey) {
-    throw new NeetruError(
+async function X(t, e, i, r) {
+  if (!t.apiKey)
+    throw new u(
       "missing_api_key",
       "ai requires an apiKey. Pass it to createNeetruClient({ apiKey }) or set NEETRU_API_KEY env var."
     );
-  }
-  const url = joinUrl(config.baseUrl, AI_CHAT_PATH);
-  const headers = {
+  let n = ge(t.baseUrl, te), { headers: o, correlationId: s } = x({
     "content-type": "application/json",
-    accept: stream ? "text/event-stream" : "application/json",
-    authorization: `Bearer ${config.apiKey}`
-  };
-  const init = { method: "POST", headers, body: JSON.stringify(body) };
-  if (stream) {
-    if (signal) init.signal = signal;
-  } else {
-    init.signal = signal ?? AbortSignal.timeout(AI_NONSTREAM_TIMEOUT_MS);
-  }
-  let res;
+    accept: r ? "text/event-stream" : "application/json",
+    authorization: `Bearer ${t.apiKey}`
+  }), c = { method: "POST", headers: o, body: JSON.stringify(e) };
+  r ? i && (c.signal = i) : c.signal = i ?? AbortSignal.timeout(v);
+  let l;
   try {
-    res = await config.fetch(url, init);
-  } catch (err) {
-    const message = err instanceof DOMException && err.name === "TimeoutError" ? `Network error: timeout after ${AI_NONSTREAM_TIMEOUT_MS / 1e3}s` : err instanceof DOMException && err.name === "AbortError" ? "Network error: request aborted" : `Network error: ${err instanceof Error ? err.message : "fetch failed"}`;
-    throw new NeetruError("network_error", message);
-  }
-  const requestId = res.headers.get("x-request-id") ?? res.headers.get("x-correlation-id") ?? void 0;
-  if (!res.ok) {
-    const parsed = await safeJson(res);
-    let code = statusToCode(res.status);
-    let message = `HTTP ${res.status}`;
-    if (parsed && typeof parsed === "object" && "error" in parsed) {
-      const errField = parsed.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;
-      }
+    l = await t.fetch(n, c);
+  } catch (d) {
+    let m = d instanceof DOMException && d.name === "TimeoutError" ? `Network error: timeout after ${v / 1e3}s` : d instanceof DOMException && d.name === "AbortError" ? "Network error: request aborted" : `Network error: ${d instanceof Error ? d.message : "fetch failed"}`;
+    throw new u("network_error", m, void 0, void 0, void 0, s);
+  }
+  let y = l.headers.get("x-request-id") ?? l.headers.get("x-correlation-id") ?? void 0;
+  if (!l.ok) {
+    let d = await B(l), m = T(l.status), g = `HTTP ${l.status}`;
+    if (d && typeof d == "object" && "error" in d) {
+      let f = d.error;
+      typeof f == "string" ? g = f : f && typeof f == "object" && (typeof f.code == "string" && (m = f.code), typeof f.message == "string" && (g = f.message));
     }
-    throw new NeetruError(code, message, res.status, requestId);
+    throw new u(m, g, l.status, y, void 0, s);
   }
-  const coreVersion = res.headers.get("x-neetru-version");
-  if (coreVersion) checkCoreVersionCompat(coreVersion);
-  return res;
+  let p = l.headers.get("x-neetru-version");
+  return p && k(p), l;
 }
-function readMeta(res) {
+function z(t) {
   return {
-    provider: res.headers.get("x-neetru-provider") ?? "",
-    usageWarning: res.headers.get("x-neetru-ai-usage-warning") === "1"
+    provider: t.headers.get("x-neetru-provider") ?? "",
+    usageWarning: t.headers.get("x-neetru-ai-usage-warning") === "1"
   };
 }
-function parseSseData(rawEvent) {
-  const dataLines = [];
-  for (const line of rawEvent.split("\n")) {
-    const trimmed = line.replace(/\r$/, "");
-    if (trimmed.startsWith("data:")) {
-      let v = trimmed.slice(5);
-      if (v.startsWith(" ")) v = v.slice(1);
-      dataLines.push(v);
+function W(t) {
+  let e = [];
+  for (let r of t.split(`
+`)) {
+    let n = r.replace(/\r$/, "");
+    if (n.startsWith("data:")) {
+      let o = n.slice(5);
+      o.startsWith(" ") && (o = o.slice(1)), e.push(o);
     }
   }
-  if (dataLines.length === 0) return null;
-  const payload = dataLines.join("\n");
-  if (payload === "[DONE]") return { done: true };
+  if (e.length === 0) return null;
+  let i = e.join(`
+`);
+  if (i === "[DONE]") return { done: true };
   try {
-    const obj = JSON.parse(payload);
-    const content = obj?.choices?.[0]?.delta?.content;
-    if (typeof content === "string" && content.length > 0) return { content };
-    return null;
+    let n = JSON.parse(i)?.choices?.[0]?.delta?.content;
+    return typeof n == "string" && n.length > 0 ? { content: n } : null;
   } catch {
     return null;
   }
 }
-function createAiNamespace(config) {
+function ke(t) {
   return {
-    async chat(opts) {
-      const body = resolveAiBody(config, opts, false);
-      const res = await aiFetch(config, body, opts.signal, false);
-      const { provider: providerHeader, usageWarning } = readMeta(res);
-      const raw = await safeJson(res);
-      if (!raw || raw.ok !== true || !Array.isArray(raw.choices)) {
-        throw new NeetruError("invalid_response", "ai.chat response missing ok/choices");
-      }
+    async chat(e) {
+      let i = K(t, e, false), r = await X(t, i, e.signal, false), { provider: n, usageWarning: o } = z(r), s = await B(r);
+      if (!s || s.ok !== true || !Array.isArray(s.choices))
+        throw new u("invalid_response", "ai.chat response missing ok/choices");
       return {
-        choices: raw.choices,
-        usage: raw.usage ?? { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 },
-        model: raw.model ?? opts.model,
-        provider: raw.provider ?? providerHeader ?? "",
-        usageWarning
+        choices: s.choices,
+        usage: s.usage ?? { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 },
+        model: s.model ?? e.model,
+        provider: s.provider ?? n ?? "",
+        usageWarning: o
       };
     },
-    stream(opts) {
-      const body = resolveAiBody(config, opts, true);
-      const responsePromise = aiFetch(config, body, opts.signal, true);
-      const meta = responsePromise.then(readMeta);
-      meta.catch(() => {
+    stream(e) {
+      let i = K(t, e, true), r = X(t, i, e.signal, true), n = r.then(z);
+      n.catch(() => {
       });
-      async function* iterate() {
-        const res = await responsePromise;
-        const stream = res.body;
-        if (!stream) {
-          throw new NeetruError("invalid_response", "ai.stream: response has no body");
-        }
-        const reader = stream.getReader();
-        const decoder = new TextDecoder();
-        let buffer = "";
+      async function* o() {
+        let c = (await r).body;
+        if (!c)
+          throw new u("invalid_response", "ai.stream: response has no body");
+        let l = c.getReader(), y = new TextDecoder(), p = "";
         try {
-          while (true) {
-            const { done, value } = await reader.read();
-            if (done) break;
-            buffer += decoder.decode(value, { stream: true });
-            let sep;
-            while ((sep = buffer.indexOf("\n\n")) !== -1) {
-              const rawEvent = buffer.slice(0, sep);
-              buffer = buffer.slice(sep + 2);
-              const parsed = parseSseData(rawEvent);
-              if (parsed && "done" in parsed) return;
-              if (parsed && "content" in parsed) yield parsed.content;
+          for (; ; ) {
+            let { done: m, value: g } = await l.read();
+            if (m) break;
+            p += y.decode(g, { stream: !0 });
+            let f;
+            for (; (f = p.indexOf(`
+
+`)) !== -1; ) {
+              let G = p.slice(0, f);
+              p = p.slice(f + 2);
+              let h = W(G);
+              if (h && "done" in h) return;
+              h && "content" in h && (yield h.content);
             }
           }
-          const tail = buffer.trim();
-          if (tail) {
-            const parsed = parseSseData(tail);
-            if (parsed && "content" in parsed) yield parsed.content;
+          let d = p.trim();
+          if (d) {
+            let m = W(d);
+            m && "content" in m && (yield m.content);
           }
         } finally {
           try {
-            reader.releaseLock();
+            l.releaseLock();
           } catch {
           }
           try {
-            await stream.cancel();
+            await c.cancel();
           } catch {
           }
         }
       }
       return {
-        meta,
-        [Symbol.asyncIterator]: iterate
+        meta: n,
+        [Symbol.asyncIterator]: o
       };
     }
   };
 }
 
-export { createAiNamespace };
-//# sourceMappingURL=ai.mjs.map
-//# sourceMappingURL=ai.mjs.map
+export { ke as createAiNamespace };