@zorveus/sdk 0.1.9 → 0.2.1

package/dist/index.js

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   APIConnectionError: () => APIConnectionError,
   APIStatusError: () => APIStatusError,
+  AppConnectionNotFoundError: () => AppConnectionNotFoundError,
   AuthenticationError: () => AuthenticationError,
   CapExceededError: () => CapExceededError,
   CreditGrantExpiredError: () => CreditGrantExpiredError,
@@ -29,7 +30,9 @@ __export(index_exports, {
   InternalServerError: () => InternalServerError,
   NotFoundError: () => NotFoundError,
   PermissionDeniedError: () => PermissionDeniedError,
+  ProductUserAllowanceInsufficientError: () => ProductUserAllowanceInsufficientError,
   RateLimitError: () => RateLimitError,
+  ReservationConflictError: () => ReservationConflictError,
   UnprocessableEntityError: () => UnprocessableEntityError,
   Zorveus: () => Zorveus,
   ZorveusBusinessError: () => ZorveusBusinessError,
@@ -39,8 +42,12 @@ __export(index_exports, {
   ZorveusServiceClient: () => ZorveusServiceClient,
   assertDecimalString: () => assertDecimalString,
   createAPIError: () => createAPIError,
+  decimalPercentage: () => decimalPercentage,
+  formatDecimalString: () => formatDecimalString,
   formatGatewayMetadata: () => formatGatewayMetadata,
-  isValidDecimalString: () => isValidDecimalString
+  isValidDecimalString: () => isValidDecimalString,
+  normalInputTokens: () => normalInputTokens,
+  parseZorveusGatewayError: () => parseZorveusGatewayError
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -73,6 +80,7 @@ var ZorveusError = class extends Error {
   code;
   param;
   type;
+  params;
   headers;
   rawBody;
   constructor(message, options = {}) {
@@ -82,6 +90,7 @@ var ZorveusError = class extends Error {
     this.code = options.code;
     this.param = options.param;
     this.type = options.type;
+    this.params = options.params;
     this.headers = options.headers;
     this.rawBody = options.rawBody;
     if (options.cause) {
@@ -149,27 +158,71 @@ var ZorveusBusinessError = class extends APIStatusError {
 };
 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" });
+    super(message, {
+      ...options,
+      status: options.status ?? 402,
+      code: options.code ?? "zorveus_reservation_insufficient_balance"
+    });
     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" });
+    super(message, {
+      ...options,
+      status: options.status ?? 403,
+      code: options.code ?? "zorveus_cap_exceeded"
+    });
     this.name = "CapExceededError";
   }
 };
+var ProductUserAllowanceInsufficientError = class extends ZorveusBusinessError {
+  constructor(message = "Product user AI allowance is insufficient for this request.", options = {}) {
+    super(message, {
+      ...options,
+      status: options.status ?? 403,
+      code: options.code ?? "zorveus_product_user_allowance_insufficient",
+      params: options.params
+    });
+    this.name = "ProductUserAllowanceInsufficientError";
+  }
+};
 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" });
+    super(message, {
+      ...options,
+      status: options.status ?? 403,
+      code: options.code ?? "credit_grant_expired"
+    });
     this.name = "CreditGrantExpiredError";
   }
 };
+var AppConnectionNotFoundError = class extends ZorveusBusinessError {
+  constructor(message = "Inference key or app connection not found or revoked", options = {}) {
+    super(message, {
+      ...options,
+      status: options.status ?? 403,
+      code: options.code ?? "zorveus_app_connection_not_found"
+    });
+    this.name = "AppConnectionNotFoundError";
+  }
+};
+var ReservationConflictError = class extends ZorveusBusinessError {
+  constructor(message = "Idempotency key reused with conflicting request parameters", options = {}) {
+    super(message, {
+      ...options,
+      status: options.status ?? 409,
+      code: options.code ?? "zorveus_reservation_conflict"
+    });
+    this.name = "ReservationConflictError";
+  }
+};
 function createAPIError(status, body, headers) {
   let message = `Request failed with status ${status}`;
   let code;
   let param;
   let type;
+  let params;
   let parsedBody = body;
   if (typeof body === "string") {
     try {
@@ -187,29 +240,62 @@ function createAPIError(status, body, headers) {
   }
   if (parsedBody && typeof parsedBody === "object") {
     const obj = parsedBody;
-    if (obj.error && typeof obj.error === "object") {
+    const providerFields = obj.provider_specific_fields ?? obj.error?.provider_specific_fields;
+    const nestedGatewayError = providerFields?.error ?? providerFields;
+    if (nestedGatewayError && typeof nestedGatewayError === "object") {
+      if (typeof nestedGatewayError.message === "string") message = nestedGatewayError.message;
+      if (typeof nestedGatewayError.code === "string") code = nestedGatewayError.code;
+      if (typeof nestedGatewayError.param === "string") param = nestedGatewayError.param;
+      if (typeof nestedGatewayError.type === "string") type = nestedGatewayError.type;
+      if (nestedGatewayError.params && typeof nestedGatewayError.params === "object") {
+        params = nestedGatewayError.params;
+      }
+    } else 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;
+      if (err.params && typeof err.params === "object") {
+        params = err.params;
+      }
+    } else {
+      if (typeof obj.message === "string") message = obj.message;
+      if (typeof obj.code === "string") code = obj.code;
+      if (typeof obj.param === "string") param = obj.param;
+      if (typeof obj.type === "string") type = obj.type;
+      if (obj.params && typeof obj.params === "object") {
+        params = obj.params;
+      }
+      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 options = { status, code, param, type, params, headers, rawBody: body };
   const normalizedCode = (code || "").toLowerCase();
-  if (normalizedCode.includes("cap_exceed") || normalizedCode.includes("spend_cap") || message.toLowerCase().includes("spending cap")) {
+  if (normalizedCode === "zorveus_product_user_allowance_insufficient" || normalizedCode === "zorveus_product_user_credits_insufficient" || normalizedCode.includes("allowance_insufficient") || normalizedCode.includes("credits_insufficient") || message.toLowerCase().includes("allowance remaining")) {
+    return new ProductUserAllowanceInsufficientError(message, {
+      ...options,
+      status: status === 200 ? 403 : status,
+      params
+    });
+  }
+  if (normalizedCode === "zorveus_cap_exceeded" || 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")) {
+  if (normalizedCode === "zorveus_app_connection_not_found" || normalizedCode.includes("app_connection_not_found")) {
+    return new AppConnectionNotFoundError(message, options);
+  }
+  if (status === 409 || normalizedCode === "zorveus_reservation_conflict" || normalizedCode.includes("reservation_conflict")) {
+    return new ReservationConflictError(message, options);
+  }
+  if (status === 402 || normalizedCode === "zorveus_reservation_insufficient_balance" || 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")) {
@@ -218,9 +304,6 @@ function createAPIError(status, body, headers) {
   if (status === 401) {
     return new AuthenticationError(message, options);
   }
-  if (status === 402) {
-    return new InsufficientFundsError(message, options);
-  }
   if (status === 403) {
     return new PermissionDeniedError(message, options);
   }
@@ -238,6 +321,22 @@ function createAPIError(status, body, headers) {
   }
   return new APIStatusError(message, options);
 }
+function parseZorveusGatewayError(error) {
+  if (error instanceof ZorveusError) {
+    return error;
+  }
+  if (!error || typeof error !== "object") {
+    return error;
+  }
+  const errObj = error;
+  const status = typeof errObj.status === "number" ? errObj.status : typeof errObj.statusCode === "number" ? errObj.statusCode : void 0;
+  const rawBody = errObj.error ?? errObj.body ?? errObj.rawBody;
+  if (status !== void 0 && rawBody !== void 0) {
+    const headers = errObj.headers && typeof errObj.headers === "object" ? errObj.headers : void 0;
+    return createAPIError(status, rawBody, headers);
+  }
+  return error;
+}
 
 // src/http/transport.ts
 var HTTPTransport = class {
@@ -482,6 +581,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,
@@ -538,6 +640,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;
@@ -649,9 +762,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();
   }
@@ -659,6 +769,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 {
@@ -751,6 +891,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", {
@@ -874,12 +1015,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 || [],
@@ -899,7 +1041,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 = {};
@@ -914,6 +1056,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`).
    */
@@ -959,10 +1108,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) {
@@ -981,6 +1160,7 @@ var ZorveusServiceClient = class {
     });
     this.productUsers = new ProductUsers(this.transport);
     this.providerCredentials = new ProviderCredentials(this.transport);
+    this.usageEvents = new UsageEvents(this.transport);
   }
 };
 
@@ -1182,6 +1362,7 @@ var ZorveusOAuth = class {
 0 && (module.exports = {
   APIConnectionError,
   APIStatusError,
+  AppConnectionNotFoundError,
   AuthenticationError,
   CapExceededError,
   CreditGrantExpiredError,
@@ -1189,7 +1370,9 @@ var ZorveusOAuth = class {
   InternalServerError,
   NotFoundError,
   PermissionDeniedError,
+  ProductUserAllowanceInsufficientError,
   RateLimitError,
+  ReservationConflictError,
   UnprocessableEntityError,
   Zorveus,
   ZorveusBusinessError,
@@ -1199,7 +1382,11 @@ var ZorveusOAuth = class {
   ZorveusServiceClient,
   assertDecimalString,
   createAPIError,
+  decimalPercentage,
+  formatDecimalString,
   formatGatewayMetadata,
-  isValidDecimalString
+  isValidDecimalString,
+  normalInputTokens,
+  parseZorveusGatewayError
 });
 //# sourceMappingURL=index.js.map