@zorveus/sdk 0.1.8 → 0.2.1

package/dist/index.mjs

@@ -1,3 +1,24 @@
+import {
+  APIConnectionError,
+  APIStatusError,
+  AppConnectionNotFoundError,
+  AuthenticationError,
+  CapExceededError,
+  CreditGrantExpiredError,
+  InsufficientFundsError,
+  InternalServerError,
+  NotFoundError,
+  PermissionDeniedError,
+  ProductUserAllowanceInsufficientError,
+  RateLimitError,
+  ReservationConflictError,
+  UnprocessableEntityError,
+  ZorveusBusinessError,
+  ZorveusError,
+  createAPIError,
+  parseZorveusGatewayError
+} from "./chunk-6SPZ5W5D.mjs";
+
 // src/http/headers.ts
 function buildHeaders(options) {
   const headers = {
@@ -21,178 +42,6 @@ function buildHeaders(options) {
   return headers;
 }
 
-// src/errors/zorveus-error.ts
-var ZorveusError = class extends Error {
-  status;
-  code;
-  param;
-  type;
-  headers;
-  rawBody;
-  constructor(message, options = {}) {
-    super(message);
-    this.name = "ZorveusError";
-    this.status = options.status;
-    this.code = options.code;
-    this.param = options.param;
-    this.type = options.type;
-    this.headers = options.headers;
-    this.rawBody = options.rawBody;
-    if (options.cause) {
-      this.cause = options.cause;
-    }
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var APIConnectionError = class extends ZorveusError {
-  constructor(message = "Connection to Zorveus API failed", options = {}) {
-    super(message, options);
-    this.name = "APIConnectionError";
-    if (options.cause) {
-      this.cause = options.cause;
-    }
-  }
-};
-var APIStatusError = class extends ZorveusError {
-  constructor(message, options) {
-    super(message, options);
-    this.name = "APIStatusError";
-  }
-};
-var AuthenticationError = class extends APIStatusError {
-  constructor(message = "Invalid or expired Zorveus credentials", options = {}) {
-    super(message, { ...options, status: options.status ?? 401 });
-    this.name = "AuthenticationError";
-  }
-};
-var PermissionDeniedError = class extends APIStatusError {
-  constructor(message = "Permission denied for this operation or model", options = {}) {
-    super(message, { ...options, status: options.status ?? 403 });
-    this.name = "PermissionDeniedError";
-  }
-};
-var NotFoundError = class extends APIStatusError {
-  constructor(message = "Resource not found", options = {}) {
-    super(message, { ...options, status: options.status ?? 404 });
-    this.name = "NotFoundError";
-  }
-};
-var UnprocessableEntityError = class extends APIStatusError {
-  constructor(message = "Request validation failed", options = {}) {
-    super(message, { ...options, status: options.status ?? 422 });
-    this.name = "UnprocessableEntityError";
-  }
-};
-var RateLimitError = class extends APIStatusError {
-  constructor(message = "Rate limit exceeded. Please retry after some time.", options = {}) {
-    super(message, { ...options, status: options.status ?? 429 });
-    this.name = "RateLimitError";
-  }
-};
-var InternalServerError = class extends APIStatusError {
-  constructor(message = "Zorveus internal server error", options = {}) {
-    super(message, { ...options, status: options.status ?? 500 });
-    this.name = "InternalServerError";
-  }
-};
-var ZorveusBusinessError = class extends APIStatusError {
-  constructor(message, options) {
-    super(message, options);
-    this.name = "ZorveusBusinessError";
-  }
-};
-var InsufficientFundsError = class extends ZorveusBusinessError {
-  constructor(message = "Wallet balance exhausted. Top up required.", options = {}) {
-    super(message, { ...options, status: options.status ?? 402, code: options.code ?? "insufficient_funds" });
-    this.name = "InsufficientFundsError";
-  }
-};
-var CapExceededError = class extends ZorveusBusinessError {
-  constructor(message = "Spending cap limit reached", options = {}) {
-    super(message, { ...options, status: options.status ?? 402, code: options.code ?? "cap_exceeded" });
-    this.name = "CapExceededError";
-  }
-};
-var CreditGrantExpiredError = class extends ZorveusBusinessError {
-  constructor(message = "Product user credit grant has expired", options = {}) {
-    super(message, { ...options, status: options.status ?? 403, code: options.code ?? "credit_grant_expired" });
-    this.name = "CreditGrantExpiredError";
-  }
-};
-function createAPIError(status, body, headers) {
-  let message = `Request failed with status ${status}`;
-  let code;
-  let param;
-  let type;
-  let parsedBody = body;
-  if (typeof body === "string") {
-    try {
-      parsedBody = JSON.parse(body);
-    } catch {
-      try {
-        parsedBody = JSON.parse(body.replace(/'/g, '"'));
-      } catch {
-        const codeMatch = body.match(/['"]code['"]\s*:\s*['"]([^'"]+)['"]/);
-        const msgMatch = body.match(/['"]message['"]\s*:\s*['"]([^'"]+)['"]/);
-        if (msgMatch?.[1]) message = msgMatch[1];
-        if (codeMatch?.[1]) code = codeMatch[1];
-      }
-    }
-  }
-  if (parsedBody && typeof parsedBody === "object") {
-    const obj = parsedBody;
-    if (obj.error && typeof obj.error === "object") {
-      const err = obj.error;
-      if (typeof err.message === "string") message = err.message;
-      if (typeof err.code === "string") code = err.code;
-      if (typeof err.param === "string") param = err.param;
-      if (typeof err.type === "string") type = err.type;
-    } else if (typeof obj.detail === "string") {
-      message = obj.detail;
-    } else if (Array.isArray(obj.detail) && obj.detail.length > 0) {
-      const first = obj.detail[0];
-      if (first && typeof first.msg === "string") {
-        message = first.msg;
-      }
-    } else if (typeof obj.message === "string") {
-      message = obj.message;
-    }
-  }
-  const options = { status, code, param, type, headers, rawBody: body };
-  const normalizedCode = (code || "").toLowerCase();
-  if (normalizedCode.includes("cap_exceed") || normalizedCode.includes("spend_cap") || message.toLowerCase().includes("spending cap")) {
-    return new CapExceededError(message, options);
-  }
-  if (normalizedCode.includes("insufficient_funds") || normalizedCode.includes("balance_exhausted") || normalizedCode.includes("insufficient_balance") || normalizedCode.includes("wallet_empty") || message.toLowerCase().includes("insufficient funds") || message.toLowerCase().includes("balance exhausted") || message.toLowerCase().includes("wallet is empty")) {
-    return new InsufficientFundsError(message, options);
-  }
-  if (normalizedCode.includes("grant_expired")) {
-    return new CreditGrantExpiredError(message, options);
-  }
-  if (status === 401) {
-    return new AuthenticationError(message, options);
-  }
-  if (status === 402) {
-    return new InsufficientFundsError(message, options);
-  }
-  if (status === 403) {
-    return new PermissionDeniedError(message, options);
-  }
-  if (status === 404) {
-    return new NotFoundError(message, options);
-  }
-  if (status === 422) {
-    return new UnprocessableEntityError(message, options);
-  }
-  if (status === 429) {
-    return new RateLimitError(message, options);
-  }
-  if (status >= 500) {
-    return new InternalServerError(message, options);
-  }
-  return new APIStatusError(message, options);
-}
-
 // src/http/transport.ts
 var HTTPTransport = class {
   apiKey;
@@ -436,6 +285,9 @@ function formatGatewayMetadata(meta) {
   if (meta.externalUserId) {
     result.external_user_id = meta.externalUserId;
   }
+  if (meta.productEndUserId) {
+    result.product_end_user_id = meta.productEndUserId;
+  }
   if (meta.displayName !== void 0 || meta.userEmail !== void 0 || meta.metadata !== void 0) {
     result.product_user = {
       display_name: meta.displayName ?? null,
@@ -492,6 +344,17 @@ var Chat = class {
   }
 };
 
+// src/types/usage-events.ts
+function normalInputTokens(event) {
+  if (event.cache_usage_breakdown_status !== "reported" || event.input_tokens === null) {
+    return null;
+  }
+  return Math.max(
+    0,
+    event.input_tokens - event.cache_read_input_tokens - event.cache_creation_input_tokens - event.cache_creation_1h_input_tokens
+  );
+}
+
 // src/resources/embeddings.ts
 var Embeddings = class {
   transport;
@@ -603,9 +466,6 @@ function isValidDecimalString(value) {
   return decimalRegex.test(trimmed);
 }
 function assertDecimalString(value, fieldName) {
-  if (typeof value === "number") {
-    return value.toFixed(4);
-  }
   if (isValidDecimalString(value)) {
     return value.trim();
   }
@@ -613,6 +473,36 @@ function assertDecimalString(value, fieldName) {
     `Field '${fieldName}' must be a valid decimal string (e.g. "15.0000"), received: ${JSON.stringify(value)}`
   );
 }
+function formatDecimalString(value, fractionDigits = 2) {
+  const decimal = assertDecimalString(value, "value");
+  if (!Number.isInteger(fractionDigits) || fractionDigits < 0) {
+    throw new RangeError("fractionDigits must be a non-negative integer");
+  }
+  const negative = decimal.startsWith("-");
+  const unsigned = negative ? decimal.slice(1) : decimal;
+  const [integer, fraction = ""] = unsigned.split(".");
+  const roundedInput = fraction.padEnd(fractionDigits + 1, "0");
+  let scaled = BigInt(integer + roundedInput.slice(0, fractionDigits).padEnd(fractionDigits, "0"));
+  if (Number(roundedInput[fractionDigits] ?? "0") >= 5) scaled += 1n;
+  const digits = scaled.toString().padStart(fractionDigits + 1, "0");
+  const formatted = fractionDigits === 0 ? digits : `${digits.slice(0, -fractionDigits)}.${digits.slice(-fractionDigits)}`;
+  return negative && scaled !== 0n ? `-${formatted}` : formatted;
+}
+function decimalPercentage(numerator, denominator) {
+  const toScaledInteger = (value, scale) => {
+    const [integer, fraction = ""] = assertDecimalString(value, "value").split(".");
+    return BigInt(integer + fraction.padEnd(scale, "0").slice(0, scale));
+  };
+  const fractionDigits = Math.max(
+    numerator.split(".")[1]?.length ?? 0,
+    denominator.split(".")[1]?.length ?? 0
+  );
+  const top = toScaledInteger(numerator, fractionDigits);
+  const bottom = toScaledInteger(denominator, fractionDigits);
+  if (bottom <= 0n) return 0;
+  const basisPoints = top * 10000n / bottom;
+  return Number(basisPoints) / 100;
+}
 
 // src/resources/product-users.ts
 var ProductUsers = class {
@@ -705,6 +595,7 @@ var ProductUsers = class {
   async list(params = {}, options = {}) {
     const query = {};
     if (params.orgId) query.org_id = params.orgId;
+    if (params.appId) query.app_id = params.appId;
     if (params.limit !== void 0) query.limit = params.limit;
     if (params.offset !== void 0) query.offset = params.offset;
     return this.transport.request("/product-users", {
@@ -828,12 +719,13 @@ var ProviderCredentials = class {
     this.transport = transport;
   }
   /**
-   * Registers an organization BYOK provider credential via Service Key (`POST /provider-credentials/org-programmatic`).
+   * Registers an organization BYOK provider credential via Service Key (`POST /provider-credentials`).
    */
   async create(params, options = {}) {
     const payload = {
       provider: params.provider,
       credential_name: params.credentialName,
+      secret: params.apiKey,
       api_key: params.apiKey,
       secret_kind: params.secretKind || "api_key",
       model_policies: params.modelPolicies || [],
@@ -853,7 +745,7 @@ var ProviderCredentials = class {
     );
   }
   /**
-   * Lists BYOK provider credentials for an organization (`GET /provider-credentials/org-programmatic`).
+   * Lists BYOK provider credentials for an organization (`GET /provider-credentials`).
    */
   async list(params = {}, options = {}) {
     const query = {};
@@ -868,6 +760,13 @@ var ProviderCredentials = class {
       }
     );
   }
+  /** Retrieves one BYOK provider credential by ID. */
+  async get(providerCredentialId, options = {}) {
+    return this.transport.request(
+      `/provider-credentials/org-programmatic/${encodeURIComponent(providerCredentialId)}`,
+      { method: "GET", ...options }
+    );
+  }
   /**
    * Rotates a provider credential secret (`POST /provider-credentials/org-programmatic/{id}/rotate`).
    */
@@ -913,10 +812,40 @@ var ProviderCredentials = class {
   }
 };
 
+// src/resources/usage-events.ts
+var UsageEvents = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  /** Lists immutable usage events with cursor pagination. */
+  async list(params = {}, options = {}) {
+    return this.transport.request("/dashboard-api/usage/events", {
+      method: "GET",
+      query: {
+        org_id: params.orgId,
+        app_id: params.appId,
+        app_connection_id: params.appConnectionId,
+        product_end_user_id: params.productEndUserId,
+        model: params.model,
+        provider: params.provider,
+        billing_mode: params.billingMode,
+        status: params.status,
+        created_after: params.createdAfter,
+        created_before: params.createdBefore,
+        limit: params.limit,
+        cursor: params.cursor
+      },
+      ...options
+    });
+  }
+};
+
 // src/service-client.ts
 var ZorveusServiceClient = class {
   productUsers;
   providerCredentials;
+  usageEvents;
   transport;
   constructor(options) {
     if (!options || !options.apiKey) {
@@ -935,6 +864,7 @@ var ZorveusServiceClient = class {
     });
     this.productUsers = new ProductUsers(this.transport);
     this.providerCredentials = new ProviderCredentials(this.transport);
+    this.usageEvents = new UsageEvents(this.transport);
   }
 };
 
@@ -1135,6 +1065,7 @@ var ZorveusOAuth = class {
 export {
   APIConnectionError,
   APIStatusError,
+  AppConnectionNotFoundError,
   AuthenticationError,
   CapExceededError,
   CreditGrantExpiredError,
@@ -1142,7 +1073,9 @@ export {
   InternalServerError,
   NotFoundError,
   PermissionDeniedError,
+  ProductUserAllowanceInsufficientError,
   RateLimitError,
+  ReservationConflictError,
   UnprocessableEntityError,
   Zorveus,
   ZorveusBusinessError,
@@ -1152,7 +1085,11 @@ export {
   ZorveusServiceClient,
   assertDecimalString,
   createAPIError,
+  decimalPercentage,
+  formatDecimalString,
   formatGatewayMetadata,
-  isValidDecimalString
+  isValidDecimalString,
+  normalInputTokens,
+  parseZorveusGatewayError
 };
 //# sourceMappingURL=index.mjs.map