@cimplify/sdk 0.6.7 → 0.6.9

package/dist/advanced.mjs

@@ -7,6 +7,15 @@ function err(error) {
 }
 
 // src/types/common.ts
+function money(value) {
+  return value;
+}
+function moneyFromNumber(value) {
+  return value.toFixed(2);
+}
+function currencyCode(value) {
+  return value;
+}
 var ErrorCode = {
   // General
   UNKNOWN_ERROR: "UNKNOWN_ERROR"};
@@ -106,6 +115,74 @@ function enrichError(error, options = {}) {
   return error;
 }
 
+// src/query/builder.ts
+function escapeQueryValue(value) {
+  return value.replace(/'/g, "\\'");
+}
+var QueryBuilder = class {
+  constructor(entity) {
+    this.filters = [];
+    this.modifiers = [];
+    this.pathSegments = [];
+    this.entity = entity;
+  }
+  path(segment) {
+    this.pathSegments.push(segment);
+    return this;
+  }
+  where(field, op, value) {
+    const v = typeof value === "string" ? `'${escapeQueryValue(value)}'` : value;
+    if (op === "contains" || op === "startsWith") {
+      this.filters.push(`@.${field} ${op} ${v}`);
+    } else {
+      this.filters.push(`@.${field}${op}${v}`);
+    }
+    return this;
+  }
+  and(field, op, value) {
+    return this.where(field, op, value);
+  }
+  sort(field, order = "asc") {
+    this.modifiers.push(`sort(${field},${order})`);
+    return this;
+  }
+  limit(n) {
+    this.modifiers.push(`limit(${n})`);
+    return this;
+  }
+  offset(n) {
+    this.modifiers.push(`offset(${n})`);
+    return this;
+  }
+  count() {
+    this.modifiers.push("count");
+    return this;
+  }
+  enriched() {
+    this.modifiers.push("enriched");
+    return this;
+  }
+  build() {
+    let query2 = this.entity;
+    if (this.pathSegments.length > 0) {
+      query2 += "." + this.pathSegments.join(".");
+    }
+    if (this.filters.length > 0) {
+      query2 += `[?(${this.filters.join(" && ")})]`;
+    }
+    for (const mod of this.modifiers) {
+      query2 += `#${mod}`;
+    }
+    return query2;
+  }
+  toString() {
+    return this.build();
+  }
+};
+function query(entity) {
+  return new QueryBuilder(entity);
+}
+
 // src/catalogue.ts
 function toCimplifyError(error) {
   if (error instanceof CimplifyError) return enrichError(error);
@@ -186,7 +263,7 @@ var CatalogueQueries = class {
     let query2 = "products";
     const filters = [];
     if (options?.category) {
-      filters.push(`@.category_id=='${options.category}'`);
+      filters.push(`@.category_id=='${escapeQueryValue(options.category)}'`);
     }
     if (options?.featured !== void 0) {
       filters.push(`@.featured==${options.featured}`);
@@ -195,7 +272,7 @@ var CatalogueQueries = class {
       filters.push(`@.in_stock==${options.in_stock}`);
     }
     if (options?.search) {
-      filters.push(`@.name contains '${options.search}'`);
+      filters.push(`@.name contains '${escapeQueryValue(options.search)}'`);
     }
     if (options?.min_price !== void 0) {
       filters.push(`@.price>=${options.min_price}`);
@@ -226,7 +303,9 @@ var CatalogueQueries = class {
   }
   async getProductBySlug(slug) {
     const filteredResult = await safe(
-      this.client.query(`products[?(@.slug=='${slug}')]`)
+      this.client.query(
+        `products[?(@.slug=='${escapeQueryValue(slug)}')]`
+      )
     );
     if (!filteredResult.ok) return filteredResult;
     const exactMatch = findProductBySlug(filteredResult.value, slug);
@@ -278,7 +357,7 @@ var CatalogueQueries = class {
   }
   async getCategoryBySlug(slug) {
     const result = await safe(
-      this.client.query(`categories[?(@.slug=='${slug}')]`)
+      this.client.query(`categories[?(@.slug=='${escapeQueryValue(slug)}')]`)
     );
     if (!result.ok) return result;
     if (!result.value.length) {
@@ -287,7 +366,11 @@ var CatalogueQueries = class {
     return ok(result.value[0]);
   }
   async getCategoryProducts(categoryId) {
-    return safe(this.client.query(`products[?(@.category_id=='${categoryId}')]`));
+    return safe(
+      this.client.query(
+        `products[?(@.category_id=='${escapeQueryValue(categoryId)}')]`
+      )
+    );
   }
   async getCollections() {
     return safe(this.client.query("collections"));
@@ -297,7 +380,9 @@ var CatalogueQueries = class {
   }
   async getCollectionBySlug(slug) {
     const result = await safe(
-      this.client.query(`collections[?(@.slug=='${slug}')]`)
+      this.client.query(
+        `collections[?(@.slug=='${escapeQueryValue(slug)}')]`
+      )
     );
     if (!result.ok) return result;
     if (!result.value.length) {
@@ -310,7 +395,9 @@ var CatalogueQueries = class {
   }
   async searchCollections(query2, limit = 20) {
     return safe(
-      this.client.query(`collections[?(@.name contains '${query2}')]#limit(${limit})`)
+      this.client.query(
+        `collections[?(@.name contains '${escapeQueryValue(query2)}')]#limit(${limit})`
+      )
     );
   }
   async getBundles() {
@@ -321,7 +408,9 @@ var CatalogueQueries = class {
   }
   async getBundleBySlug(slug) {
     const result = await safe(
-      this.client.query(`bundles[?(@.slug=='${slug}')]`)
+      this.client.query(
+        `bundles[?(@.slug=='${escapeQueryValue(slug)}')]`
+      )
     );
     if (!result.ok) return result;
     if (!result.value.length) {
@@ -331,7 +420,9 @@ var CatalogueQueries = class {
   }
   async searchBundles(query2, limit = 20) {
     return safe(
-      this.client.query(`bundles[?(@.name contains '${query2}')]#limit(${limit})`)
+      this.client.query(
+        `bundles[?(@.name contains '${escapeQueryValue(query2)}')]#limit(${limit})`
+      )
     );
   }
   async getComposites(options) {
@@ -371,9 +462,9 @@ var CatalogueQueries = class {
   }
   async search(query2, options) {
     const limit = options?.limit ?? 20;
-    let searchQuery = `products[?(@.name contains '${query2}')]`;
+    let searchQuery = `products[?(@.name contains '${escapeQueryValue(query2)}')]`;
     if (options?.category) {
-      searchQuery = `products[?(@.name contains '${query2}' && @.category_id=='${options.category}')]`;
+      searchQuery = `products[?(@.name contains '${escapeQueryValue(query2)}' && @.category_id=='${escapeQueryValue(options.category)}')]`;
     }
     searchQuery += `#limit(${limit})`;
     return safe(this.client.query(searchQuery));
@@ -390,7 +481,7 @@ var CatalogueQueries = class {
   async getMenu(options) {
     let query2 = "menu";
     if (options?.category) {
-      query2 = `menu[?(@.category=='${options.category}')]`;
+      query2 = `menu[?(@.category=='${escapeQueryValue(options.category)}')]`;
     }
     if (options?.limit) {
       query2 += `#limit(${options.limit})`;
@@ -537,9 +628,6 @@ var CartOperations = class {
 
 // src/constants.ts
 var LINK_QUERY = {
-  DATA: "link.data",
-  ADDRESSES: "link.addresses",
-  MOBILE_MONEY: "link.mobile_money",
   PREFERENCES: "link.preferences"};
 var LINK_MUTATION = {
   CHECK_STATUS: "link.check_status",
@@ -548,12 +636,8 @@ var LINK_MUTATION = {
   UPDATE_PREFERENCES: "link.update_preferences",
   CREATE_ADDRESS: "link.create_address",
   UPDATE_ADDRESS: "link.update_address",
-  DELETE_ADDRESS: "link.delete_address",
-  SET_DEFAULT_ADDRESS: "link.set_default_address",
   TRACK_ADDRESS_USAGE: "link.track_address_usage",
   CREATE_MOBILE_MONEY: "link.create_mobile_money",
-  DELETE_MOBILE_MONEY: "link.delete_mobile_money",
-  SET_DEFAULT_MOBILE_MONEY: "link.set_default_mobile_money",
   TRACK_MOBILE_MONEY_USAGE: "link.track_mobile_money_usage",
   VERIFY_MOBILE_MONEY: "link.verify_mobile_money"};
 var AUTH_MUTATION = {
@@ -671,6 +755,8 @@ function normalizeStatusResponse(response) {
   }
   const res = response;
   const normalizedStatus = normalizePaymentStatusValue(res.status ?? void 0);
+  const normalizedAmount = typeof res.amount === "string" ? money(res.amount) : typeof res.amount === "number" && Number.isFinite(res.amount) ? moneyFromNumber(res.amount) : void 0;
+  const normalizedCurrency = typeof res.currency === "string" && res.currency.trim().length > 0 ? currencyCode(res.currency) : void 0;
   const paidValue = res.paid === true;
   const derivedPaid = paidValue || [
     "success",
@@ -683,8 +769,8 @@ function normalizeStatusResponse(response) {
   return {
     status: normalizedStatus,
     paid: derivedPaid,
-    amount: res.amount,
-    currency: res.currency,
+    amount: normalizedAmount,
+    currency: normalizedCurrency,
     reference: res.reference,
     message: res.message || ""
   };
@@ -1376,14 +1462,17 @@ var CheckoutService = class {
       pay_currency: data.pay_currency,
       fx_quote_id: data.fx_quote_id
     };
-    const baseCurrency = (cart.pricing.currency || checkoutData.pay_currency || "GHS").toUpperCase();
+    const baseCurrency = currencyCode(
+      (cart.pricing.currency || checkoutData.pay_currency || "GHS").toUpperCase()
+    );
     const payCurrency = data.pay_currency?.trim().toUpperCase();
+    const payCurrencyCode = payCurrency ? currencyCode(payCurrency) : void 0;
     const cartTotalAmount = Number.parseFloat(cart.pricing.total_price || "0");
-    if (payCurrency && payCurrency !== baseCurrency && !checkoutData.fx_quote_id && Number.isFinite(cartTotalAmount) && cartTotalAmount > 0) {
+    if (payCurrencyCode && payCurrencyCode !== baseCurrency && !checkoutData.fx_quote_id && Number.isFinite(cartTotalAmount) && cartTotalAmount > 0) {
       const fxQuoteResult = await this.client.fx.lockQuote({
         from: baseCurrency,
-        to: payCurrency,
-        amount: cartTotalAmount
+        to: payCurrencyCode,
+        amount: cart.pricing.total_price
       });
       if (!fxQuoteResult.ok) {
         return ok(
@@ -1394,7 +1483,7 @@ var CheckoutService = class {
           )
         );
       }
-      checkoutData.pay_currency = payCurrency;
+      checkoutData.pay_currency = payCurrencyCode;
       checkoutData.fx_quote_id = fxQuoteResult.value.id;
     }
     data.on_status_change?.("processing", {});
@@ -1499,6 +1588,9 @@ var LinkService = class {
   constructor(client) {
     this.client = client;
   }
+  async getProfile() {
+    return safe5(this.client.linkGet("/v1/link/profile"));
+  }
   async requestOtp(input) {
     return safe5(this.client.linkPost("/v1/link/auth/request-otp", input));
   }
@@ -1526,13 +1618,13 @@ var LinkService = class {
     );
   }
   async getLinkData() {
-    return safe5(this.client.query(LINK_QUERY.DATA));
+    return safe5(this.client.linkGet("/v1/link/data"));
   }
   async getAddresses() {
-    return safe5(this.client.query(LINK_QUERY.ADDRESSES));
+    return safe5(this.client.linkGet("/v1/link/addresses"));
   }
   async getMobileMoney() {
-    return safe5(this.client.query(LINK_QUERY.MOBILE_MONEY));
+    return safe5(this.client.linkGet("/v1/link/mobile-money"));
   }
   async getPreferences() {
     return safe5(this.client.query(LINK_QUERY.PREFERENCES));
@@ -1555,10 +1647,10 @@ var LinkService = class {
     return safe5(this.client.call(LINK_MUTATION.UPDATE_ADDRESS, input));
   }
   async deleteAddress(addressId) {
-    return safe5(this.client.call(LINK_MUTATION.DELETE_ADDRESS, addressId));
+    return safe5(this.client.linkDelete(`/v1/link/addresses/${addressId}`));
   }
   async setDefaultAddress(addressId) {
-    return safe5(this.client.call(LINK_MUTATION.SET_DEFAULT_ADDRESS, addressId));
+    return safe5(this.client.linkPost(`/v1/link/addresses/${addressId}/default`));
   }
   async trackAddressUsage(addressId) {
     return safe5(
@@ -1571,11 +1663,13 @@ var LinkService = class {
     return safe5(this.client.call(LINK_MUTATION.CREATE_MOBILE_MONEY, input));
   }
   async deleteMobileMoney(mobileMoneyId) {
-    return safe5(this.client.call(LINK_MUTATION.DELETE_MOBILE_MONEY, mobileMoneyId));
+    return safe5(
+      this.client.linkDelete(`/v1/link/mobile-money/${mobileMoneyId}`)
+    );
   }
   async setDefaultMobileMoney(mobileMoneyId) {
     return safe5(
-      this.client.call(LINK_MUTATION.SET_DEFAULT_MOBILE_MONEY, mobileMoneyId)
+      this.client.linkPost(`/v1/link/mobile-money/${mobileMoneyId}/default`)
     );
   }
   async trackMobileMoneyUsage(mobileMoneyId) {
@@ -2645,69 +2739,4 @@ function createElements(client, businessId, options) {
   return new CimplifyElements(client, businessId, options);
 }
 
-// src/query/builder.ts
-var QueryBuilder = class {
-  constructor(entity) {
-    this.filters = [];
-    this.modifiers = [];
-    this.pathSegments = [];
-    this.entity = entity;
-  }
-  path(segment) {
-    this.pathSegments.push(segment);
-    return this;
-  }
-  where(field, op, value) {
-    const v = typeof value === "string" ? `'${value}'` : value;
-    if (op === "contains" || op === "startsWith") {
-      this.filters.push(`@.${field} ${op} ${v}`);
-    } else {
-      this.filters.push(`@.${field}${op}${v}`);
-    }
-    return this;
-  }
-  and(field, op, value) {
-    return this.where(field, op, value);
-  }
-  sort(field, order = "asc") {
-    this.modifiers.push(`sort(${field},${order})`);
-    return this;
-  }
-  limit(n) {
-    this.modifiers.push(`limit(${n})`);
-    return this;
-  }
-  offset(n) {
-    this.modifiers.push(`offset(${n})`);
-    return this;
-  }
-  count() {
-    this.modifiers.push("count");
-    return this;
-  }
-  enriched() {
-    this.modifiers.push("enriched");
-    return this;
-  }
-  build() {
-    let query2 = this.entity;
-    if (this.pathSegments.length > 0) {
-      query2 += "." + this.pathSegments.join(".");
-    }
-    if (this.filters.length > 0) {
-      query2 += `[?(${this.filters.join(" && ")})]`;
-    }
-    for (const mod of this.modifiers) {
-      query2 += `#${mod}`;
-    }
-    return query2;
-  }
-  toString() {
-    return this.build();
-  }
-};
-function query(entity) {
-  return new QueryBuilder(entity);
-}
-
 export { AuthService, BusinessService, CartOperations, CatalogueQueries, CheckoutService as CheckoutOperations, CheckoutService, CimplifyElement, CimplifyElements, ELEMENT_TYPES, EVENT_TYPES, FxService, InventoryService, LinkService, LiteService, MESSAGE_TYPES, OrderQueries, QueryBuilder, SchedulingService, createElements, generateIdempotencyKey, query };

package/dist/{client-B4etj3AD.d.mts → client-COpV6Yuu.d.ts}

@@ -1,4 +1,4 @@
-import { M as Money, e as CimplifyError, m as AuthorizationType, o as PaymentMethod, I as InitializePaymentResult, S as SubmitAuthorizationInput, r as PaymentStatusResponse } from './payment-pjpfIKX8.mjs';
+import { M as Money, C as CurrencyCode, h as CimplifyError, q as AuthorizationType, s as PaymentMethod, I as InitializePaymentResult, S as SubmitAuthorizationInput, v as PaymentStatusResponse } from './payment-Cu75tmUc.js';
 
 /**
  * Observability hooks for monitoring SDK behavior.
@@ -50,6 +50,8 @@ interface RequestSuccessEvent extends RequestContext {
 interface RequestErrorEvent extends RequestContext {
     /** The error that occurred */
     error: Error;
+    /** HTTP status code (when available) */
+    status?: number;
     /** Duration in milliseconds */
     durationMs: number;
     /** Number of retries attempted before giving up */
@@ -84,7 +86,7 @@ interface ObservabilityHooks {
     onRequestStart?: (event: RequestStartEvent) => void;
     /** Called when a request completes successfully */
     onRequestSuccess?: (event: RequestSuccessEvent) => void;
-    /** Called when a request fails (after all retries exhausted) */
+    /** Called when a request fails (4xx/5xx responses or network errors after retries) */
     onRequestError?: (event: RequestErrorEvent) => void;
     /** Called before each retry attempt */
     onRetry?: (event: RetryEvent) => void;
@@ -152,7 +154,7 @@ interface Product {
     access_duration_days?: number;
     code_type?: string;
     code_value?: Money;
-    code_currency?: string;
+    code_currency?: CurrencyCode;
     duration_minutes?: number;
     preparation_time_minutes?: number;
     staff_required_count?: number;
@@ -613,7 +615,7 @@ interface ChosenPrice {
     markup_amount: Money;
     markup_discount_percentage: Money;
     markup_discount_amount: Money;
-    currency?: string;
+    currency?: CurrencyCode;
     custom_fields?: Record<string, unknown>;
     decision_path?: PriceDecisionPath;
     tax_info?: PricePathTaxInfo;
@@ -758,7 +760,7 @@ interface Cart {
     applied_discount_ids: string[];
     applied_discount_codes: string[];
     discount_details?: DiscountDetails;
-    currency: string;
+    currency: CurrencyCode;
     customer_name?: string;
     customer_email?: string;
     customer_phone?: string;
@@ -813,7 +815,7 @@ interface DisplayCart {
     total_items: number;
     tax_rate?: Money;
     service_charge_rate?: Money;
-    currency: string;
+    currency: CurrencyCode;
     channel: string;
     status: string;
     business_name: string;
@@ -888,7 +890,7 @@ interface UICartPricing {
     total_price: Money;
     tax_rate?: Money;
     service_charge_rate?: Money;
-    currency: string;
+    currency: CurrencyCode;
 }
 interface AddOnOptionDetails {
     id: string;
@@ -1015,7 +1017,7 @@ interface CartSummary {
     discount_amount: Money;
     tax_amount: Money;
     total: Money;
-    currency: string;
+    currency: CurrencyCode;
 }
 
 /**
@@ -1442,7 +1444,7 @@ interface Order {
     service_charge?: Money;
     tax?: Money;
     price_info: ChosenPrice;
-    currency: string;
+    currency: CurrencyCode;
     bill_token?: string;
     order_group_id?: string;
     paid_via_group: boolean;
@@ -1490,7 +1492,7 @@ interface OrderGroup {
     payment_status: OrderGroupPaymentState;
     split_method?: string;
     max_orders?: number;
-    currency?: string;
+    currency?: CurrencyCode;
     amount_to_pay: AmountToPay;
     metadata?: Record<string, unknown>;
 }
@@ -2004,7 +2006,7 @@ interface CheckoutFormData {
     idempotency_key?: string;
     /** Optional metadata passed through to the payment provider (e.g. success_url, cancel_url) */
     metadata?: Record<string, unknown>;
-    pay_currency?: string;
+    pay_currency?: CurrencyCode;
     fx_quote_id?: string;
 }
 interface CheckoutResult {
@@ -2020,10 +2022,10 @@ interface CheckoutResult {
     client_secret?: string;
     public_key?: string;
     fx?: {
-        base_currency: string;
-        base_amount: number;
-        pay_currency: string;
-        pay_amount: number;
+        base_currency: CurrencyCode;
+        base_amount: Money;
+        pay_currency: CurrencyCode;
+        pay_amount: Money;
         rate: number;
         quote_id: string;
     };
@@ -2046,7 +2048,7 @@ interface ProcessCheckoutOptions {
     scheduled_time?: string;
     tip_amount?: number;
     enroll_in_link?: boolean;
-    pay_currency?: string;
+    pay_currency?: CurrencyCode;
     timeout_ms?: number;
     on_status_change?: (status: CheckoutStatus, context: CheckoutStatusContext) => void;
 }
@@ -2057,7 +2059,7 @@ interface ProcessCheckoutResult {
         order_number: string;
         status: string;
         total: string;
-        currency: string;
+        currency: CurrencyCode;
     };
     error?: {
         code: string;
@@ -2139,6 +2141,7 @@ interface SuccessResult$2 {
 declare class LinkService {
     private client;
     constructor(client: CimplifyClient);
+    getProfile(): Promise<Result<LinkData["customer"], CimplifyError>>;
     requestOtp(input: RequestOtpInput): Promise<Result<SuccessResult$2, CimplifyError>>;
     verifyOtp(input: VerifyOtpInput): Promise<Result<AuthResponse, CimplifyError>>;
     logout(): Promise<Result<SuccessResult$2, CimplifyError>>;
@@ -2218,7 +2221,7 @@ interface Business {
     handle: string;
     business_type: BusinessType;
     email: string;
-    default_currency: string;
+    default_currency: CurrencyCode;
     default_phone?: string;
     default_address?: string;
     default_offers_table_service: boolean;
@@ -2256,7 +2259,7 @@ interface Location {
     phone?: string;
     address?: string;
     service_charge_rate?: number;
-    currency: string;
+    currency: CurrencyCode;
     capacity: number;
     status: string;
     enabled_payment_types?: string[];
@@ -2323,7 +2326,7 @@ interface StorefrontBootstrap {
     location?: Location;
     locations: Location[];
     categories: CategoryInfo[];
-    currency: string;
+    currency: CurrencyCode;
     is_open: boolean;
     accepts_orders: boolean;
     time_profiles?: LocationTimeProfile[];
@@ -2653,7 +2656,7 @@ interface Service {
     buffer_after_minutes: number;
     max_participants: number;
     price: Money;
-    currency: string;
+    currency: CurrencyCode;
     requires_staff: boolean;
     is_active: boolean;
     image_url?: string;
@@ -2873,24 +2876,24 @@ declare class LiteService {
 }
 
 interface FxQuoteRequest {
-    from: string;
-    to: string;
-    amount: number;
+    from: CurrencyCode;
+    to: CurrencyCode;
+    amount: Money;
 }
 interface FxQuote {
     id: string;
-    base_currency: string;
-    pay_currency: string;
+    base_currency: CurrencyCode;
+    pay_currency: CurrencyCode;
     rate: number;
     inverse_rate: number;
-    base_amount: number;
-    converted_amount: number;
+    base_amount: Money;
+    converted_amount: Money;
     quoted_at: string;
     valid_until: string;
 }
 interface FxRateResponse {
-    from: string;
-    to: string;
+    from: CurrencyCode;
+    to: CurrencyCode;
     rate: number;
     inverse_rate: number;
     quoted_at: string;
@@ -2900,7 +2903,7 @@ interface FxRateResponse {
 declare class FxService {
     private client;
     constructor(client: CimplifyClient);
-    getRate(from: string, to: string): Promise<Result<FxRateResponse, CimplifyError>>;
+    getRate(from: CurrencyCode, to: CurrencyCode): Promise<Result<FxRateResponse, CimplifyError>>;
     lockQuote(request: FxQuoteRequest): Promise<Result<FxQuote, CimplifyError>>;
 }
 
@@ -2947,7 +2950,7 @@ interface ElementOptions {
     mode?: "shipping" | "billing";
     prefillEmail?: string;
     amount?: number;
-    currency?: string;
+    currency?: CurrencyCode;
 }
 interface AddressInfo {
     id?: string;
@@ -3028,7 +3031,7 @@ type ParentToIframeMessage = {
     notes?: string;
     scheduled_time?: string;
     tip_amount?: number;
-    pay_currency?: string;
+    pay_currency?: CurrencyCode;
     enroll_in_link?: boolean;
     address?: AddressInfo;
     customer: ElementsCustomerInfo;
@@ -3084,7 +3087,7 @@ type IframeToParentMessage = {
         order_number: string;
         status: string;
         total: string;
-        currency: string;
+        currency: CurrencyCode;
     };
     error?: {
         code: string;
@@ -3170,6 +3173,8 @@ declare function createElements(client: CimplifyClient, businessId?: string, opt
 interface CimplifyConfig {
     publicKey?: string;
     credentials?: RequestCredentials;
+    /** Disable console warning when no public key is provided (for Link REST-only portal usage). */
+    suppressPublicKeyWarning?: boolean;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
     /** Maximum retry attempts for retryable errors (default: 3) */