@cimplify/sdk 0.6.5 → 0.6.6

package/dist/index.d.ts

@@ -1,348 +1,9 @@
-import { P as PaymentErrorDetails, a as PaymentResponse, b as PaymentStatusResponse, A as ApiError } from './ads-CmO7VVPP.js';
-export { ah as AUTHORIZATION_TYPE, am as AUTH_MUTATION, a6 as AbortablePromise, eM as AdConfig, eO as AdContextValue, eN as AdCreative, eK as AdPosition, eJ as AdSlot, eL as AdTheme, b6 as AddOn, bR as AddOnDetails, cb as AddOnGroupDetails, b8 as AddOnOption, ca as AddOnOptionDetails, b9 as AddOnOptionPrice, b7 as AddOnWithOptions, cg as AddToCartInput, e7 as AddressData, ez as AddressInfo, bG as AdjustmentType, cu as AmountToPay, bN as AppliedDiscount, ei as AuthResponse, p as AuthService, q as AuthStatus, eB as AuthenticatedCustomer, eD as AuthenticatedData, d2 as AuthorizationType, dX as AvailabilityCheck, dY as AvailabilityResult, dF as AvailableSlot, bM as BenefitType, dI as Booking, dz as BookingRequirementOverride, dH as BookingStatus, dJ as BookingWithDetails, cO as BufferTimes, bh as Bundle, bl as BundleComponentData, bm as BundleComponentInfo, bg as BundlePriceType, bj as BundleProduct, bW as BundleSelectionData, bU as BundleSelectionInput, bV as BundleStoredSelection, bi as BundleSummary, bk as BundleWithDetails, da as Business, dp as BusinessHours, d9 as BusinessPreferences, B as BusinessService, dn as BusinessSettings, d8 as BusinessType, dl as BusinessWithLocations, aa as CHECKOUT_MODE, an as CHECKOUT_MUTATION, ad as CHECKOUT_STEP, aj as CONTACT_TYPE, dN as CancelBookingInput, cI as CancelOrderInput, cQ as CancellationPolicy, b$ as Cart, bS as CartAddOn, bE as CartChannel, c0 as CartItem, cd as CartItemDetails, l as CartOperations, bD as CartStatus, ci as CartSummary, c1 as CartTotals, e as CatalogueQueries, bb as Category, dq as CategoryInfo, bc as CategorySummary, s as ChangePasswordInput, dL as CheckSlotAvailabilityInput, el as CheckoutAddressInfo, en as CheckoutCustomerInfo, $ as CheckoutFormData, cG as CheckoutInput, X as CheckoutMode, m as CheckoutOperations, Y as CheckoutOrderType, Z as CheckoutPaymentMethod, a0 as CheckoutResult, m as CheckoutService, a4 as CheckoutStatus, a5 as CheckoutStatusContext, _ as CheckoutStep, bL as ChosenPrice, C as CimplifyClient, d as CimplifyConfig, z as CimplifyElement, y as CimplifyElements, ay as CimplifyError, bd as Collection, bf as CollectionProduct, be as CollectionSummary, bs as ComponentGroup, bt as ComponentGroupWithComponents, bx as ComponentPriceBreakdown, bv as ComponentSelectionInput, bp as ComponentSourceType, bq as Composite, bu as CompositeComponent, bY as CompositePriceBreakdown, bw as CompositePriceResult, bn as CompositePricingMode, bZ as CompositeSelectionData, bv as CompositeSelectionInput, bX as CompositeStoredSelection, br as CompositeWithDetails, a9 as ContactType, e3 as CreateAddressInput, e5 as CreateMobileMoneyInput, at as Currency, d_ as Customer, d$ as CustomerAddress, e1 as CustomerLinkPreferences, e0 as CustomerMobileMoney, cN as CustomerServicePreferences, ar as DEFAULT_COUNTRY, aq as DEFAULT_CURRENCY, ai as DEVICE_TYPE, dG as DayAvailability, cX as DepositResult, aW as DepositType, a8 as DeviceType, aV as DigitalProductType, bO as DiscountBreakdown, bP as DiscountDetails, c4 as DisplayAddOn, c5 as DisplayAddOnOption, c2 as DisplayCart, c3 as DisplayCartItem, H as ELEMENT_TYPES, E as EVENT_TYPES, ey as ElementAppearance, eI as ElementEventHandler, W as ElementEventType, N as ElementOptions, V as ElementType, eE as ElementsCheckoutData, eF as ElementsCheckoutResult, eC as ElementsCustomerInfo, J as ElementsOptions, e9 as EnrollAndLinkOrderInput, ec as EnrollAndLinkOrderResult, e6 as EnrollmentData, aD as Err, aw as ErrorCode, ax as ErrorCodeType, ct as FeeBearerType, F as FetchQuoteInput, cr as FulfillmentLink, cq as FulfillmentStatus, cp as FulfillmentType, ep as FxQuote, eo as FxQuoteRequest, eq as FxRateResponse, v as FxService, dK as GetAvailableSlotsInput, o as GetOrdersOptions, G as GetProductsOptions, bo as GroupPricingBehavior, eH as IframeToParentMessage, d6 as InitializePaymentResult, I as InventoryService, dZ as InventorySummary, aT as InventoryType, K as KitchenOrderItem, x as KitchenOrderResult, al as LINK_MUTATION, ak as LINK_QUERY, b_ as LineConfiguration, cv as LineItem, cm as LineType, e2 as LinkData, eb as LinkEnrollResult, L as LinkService, ed as LinkSession, ea as LinkStatusResult, w as LiteBootstrap, u as LiteService, dd as Location, c_ as LocationAppointment, bA as LocationProductPrice, dW as LocationStock, db as LocationTaxBehavior, dc as LocationTaxOverrides, dg as LocationTimeProfile, dm as LocationWithDetails, M as MESSAGE_TYPES, ag as MOBILE_MONEY_PROVIDER, e8 as MobileMoneyData, em as MobileMoneyDetails, a7 as MobileMoneyProvider, as as Money, ap as ORDER_MUTATION, ab as ORDER_TYPE, ex as ObservabilityHooks, aC as Ok, cw as Order, cl as OrderChannel, cF as OrderFilter, cs as OrderFulfillmentSummary, cz as OrderGroup, cD as OrderGroupDetails, cA as OrderGroupPayment, cy as OrderGroupPaymentState, cC as OrderGroupPaymentSummary, cx as OrderHistory, cn as OrderLineState, co as OrderLineStatus, cE as OrderPaymentEvent, O as OrderQueries, cB as OrderSplitDetail, cj as OrderStatus, r as OtpResult, ac as PAYMENT_METHOD, ao as PAYMENT_MUTATION, ae as PAYMENT_STATE, af as PICKUP_TIME_TYPE, av as Pagination, au as PaginationParams, eG as ParentToIframeMessage, d5 as Payment, d4 as PaymentMethod, eA as PaymentMethodInfo, d1 as PaymentMethodType, d3 as PaymentProcessingState, d0 as PaymentProvider, ck as PaymentState, c$ as PaymentStatus, ek as PickupTime, ej as PickupTimeType, bz as Price, bH as PriceAdjustment, bK as PriceDecisionPath, by as PriceEntryType, bJ as PricePathTaxInfo, j as PriceQuote, bF as PriceSource, cS as PricingOverrides, a3 as ProcessAndResolveOptions, a1 as ProcessCheckoutOptions, a2 as ProcessCheckoutResult, aY as Product, ba as ProductAddOn, bB as ProductAvailability, dU as ProductStock, bC as ProductTimeProfile, aS as ProductType, a_ as ProductVariant, b3 as ProductVariantValue, aZ as ProductWithDetails, f as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, h as QuoteDynamicBuckets, g as QuoteStatus, i as QuoteUiMessage, R as RefreshQuoteInput, k as RefreshQuoteResult, cJ as RefundOrderInput, cM as ReminderMethod, cP as ReminderSettings, er as RequestContext, eu as RequestErrorEvent, eg as RequestOtpInput, es as RequestStartEvent, et as RequestSuccessEvent, dM as RescheduleBookingInput, cV as ResourceAssignment, dw as ResourceAvailabilityException, dv as ResourceAvailabilityRule, dA as ResourceType, aB as Result, ev as RetryEvent, ef as RevokeAllSessionsResult, ee as RevokeSessionResult, di as Room, aX as SalesChannel, cT as SchedulingMetadata, cW as SchedulingResult, t as SchedulingService, S as SearchOptions, bQ as SelectedAddOnOption, dB as Service, ds as ServiceAvailabilityException, dO as ServiceAvailabilityParams, dP as ServiceAvailabilityResult, dr as ServiceAvailabilityRule, dj as ServiceCharge, cR as ServiceNotes, cY as ServiceScheduleRequest, dy as ServiceStaffRequirement, cK as ServiceStatus, dC as ServiceWithStaff, ew as SessionChangeEvent, dD as Staff, cU as StaffAssignment, du as StaffAvailabilityException, dt as StaffAvailabilityRule, dx as StaffBookingProfile, cL as StaffRole, cZ as StaffScheduleItem, dS as Stock, dT as StockLevel, dQ as StockOwnershipType, dR as StockStatus, dk as StorefrontBootstrap, d7 as SubmitAuthorizationInput, dh as Table, T as TableInfo, bI as TaxPathComponent, de as TimeRange, df as TimeRanges, dE as TimeSlot, ce as UICart, c6 as UICartBusiness, c8 as UICartCustomer, c7 as UICartLocation, c9 as UICartPricing, cf as UICartResponse, e4 as UpdateAddressInput, ch as UpdateCartItemInput, cH as UpdateOrderStatusInput, U as UpdateProfileInput, b0 as VariantAxis, b5 as VariantAxisSelection, b2 as VariantAxisValue, b1 as VariantAxisWithValues, bT as VariantDetails, cc as VariantDetailsDTO, a$ as VariantDisplayAttribute, b4 as VariantLocationAvailability, dV as VariantStock, aU as VariantStrategy, eh as VerifyOtpInput, aQ as combine, aR as combineObject, c as createCimplifyClient, D as createElements, aF as err, aK as flatMap, aO as fromPromise, n as generateIdempotencyKey, aL as getOrElse, az as isCimplifyError, aH as isErr, aG as isOk, aA as isRetryableError, aJ as mapError, aI as mapResult, aE as ok, aN as toNullable, aP as tryCatch, aM as unwrap } from './ads-CmO7VVPP.js';
-
-type Operator = "==" | "!=" | ">" | "<" | ">=" | "<=" | "contains" | "startsWith";
-type SortOrder = "asc" | "desc";
-declare class QueryBuilder {
-    private entity;
-    private filters;
-    private modifiers;
-    private pathSegments;
-    constructor(entity: string);
-    path(segment: string): this;
-    where(field: string, op: Operator, value: unknown): this;
-    and(field: string, op: Operator, value: unknown): this;
-    sort(field: string, order?: SortOrder): this;
-    limit(n: number): this;
-    offset(n: number): this;
-    count(): this;
-    enriched(): this;
-    build(): string;
-    toString(): string;
-}
-declare function query(entity: string): QueryBuilder;
-
-/**
- * Price Types
- *
- * Types for price parsing, formatting, and display utilities.
- */
-/**
- * Individual tax component (e.g., VAT, NHIL, GETFund)
- */
-interface TaxComponent {
-    /** Tax component name */
-    name: string;
-    /** Tax rate as percentage (e.g., 15.0 for 15%) */
-    rate: number;
-}
-/**
- * Complete tax information from a pricing response
- */
-interface TaxInfo {
-    /** Total tax rate as percentage */
-    taxRate: number;
-    /** Calculated tax amount */
-    taxAmount: number;
-    /** Whether tax is included in the displayed price */
-    isInclusive: boolean;
-    /** Individual tax components that make up the total */
-    components: TaxComponent[];
-}
-/**
- * Price information in snake_case format (as returned from backend)
- * Used by components that work with raw API responses
- */
-interface PriceInfo {
-    /** Original price before markup/discount */
-    base_price: number;
-    /** Final price after all adjustments */
-    final_price: number;
-    /** Markup percentage if applicable */
-    markup_percentage?: number;
-    /** Markup amount if applicable */
-    markup_amount?: number;
-    /** Currency code (e.g., "GHS", "USD") */
-    currency?: string;
-    /** Tax information */
-    tax_info?: TaxInfo;
-    /** Decision path showing pricing adjustments */
-    decision_path?: string;
-}
-/**
- * Minimal product shape for price utilities.
- * Uses quote-aware `price_info` and plain numeric fallback fields.
- */
-interface ProductWithPrice {
-    /** Pre-parsed price info from backend */
-    price_info?: PriceInfo;
-    /** Final computed price in plain field form (if provided by API) */
-    final_price?: number | string | null;
-    /** Base/original price in plain field form */
-    base_price?: number | string | null;
-    /** Default/indicative price in plain field form */
-    default_price?: number | string | null;
-    /** Currency in plain field form */
-    currency?: string | null;
-}
-/**
- * Options for price formatting functions
- */
-interface FormatPriceOptions {
-    /** Currency code (default: "GHS") */
-    currency?: string;
-    /** Locale for Intl.NumberFormat (default: "en-US") */
-    locale?: string;
-    /** Minimum fraction digits (default: 2) */
-    minimumFractionDigits?: number;
-    /** Maximum fraction digits (default: 2) */
-    maximumFractionDigits?: number;
-}
-/**
- * Options for compact price formatting
- */
-interface FormatCompactOptions {
-    /** Currency code (default: "GHS") */
-    currency?: string;
-    /** Number of decimal places for compact notation (default: 1) */
-    decimals?: number;
-}
-
-/**
- * Price Utilities
- *
- * Comprehensive utilities for parsing, formatting, and displaying prices.
- * Handles quote-aware pricing fields, currency formatting, and product price helpers.
- *
- * @example
- * ```typescript
- * import {
- *   formatPrice,
- *   formatPriceCompact,
- *   isOnSale,
- *   getDiscountPercentage
- * } from '@cimplify/sdk';
- *
- * // Format prices
- * formatPrice(29.99, 'USD');        // "$29.99"
- * formatPrice(29.99, 'GHS');        // "GH₵29.99"
- * formatPriceCompact(1500000, 'USD'); // "$1.5M"
- *
- * // Check for discounts
- * if (isOnSale(product)) {
- *   console.log(`${getDiscountPercentage(product)}% off!`);
- * }
- * ```
- */
-
-/**
- * Currency code to symbol mapping
- * Includes major world currencies and African currencies
- */
-declare const CURRENCY_SYMBOLS: Record<string, string>;
-/**
- * Get currency symbol for a currency code
- * @param currencyCode - ISO 4217 currency code (e.g., "USD", "GHS")
- * @returns Currency symbol or the code itself if not found
- *
- * @example
- * getCurrencySymbol('USD') // "$"
- * getCurrencySymbol('GHS') // "GH₵"
- * getCurrencySymbol('XYZ') // "XYZ"
- */
-declare function getCurrencySymbol(currencyCode: string): string;
-/**
- * Format a number compactly with K/M/B suffixes
- * @param value - Number to format
- * @param decimals - Decimal places (default: 1)
- * @returns Compact string representation
- *
- * @example
- * formatNumberCompact(1234)      // "1.2K"
- * formatNumberCompact(1500000)   // "1.5M"
- * formatNumberCompact(2500000000) // "2.5B"
- */
-declare function formatNumberCompact(value: number, decimals?: number): string;
-/**
- * Format a price with locale-aware currency formatting
- * Uses Intl.NumberFormat for proper localization
- *
- * @param amount - Price amount (number or string)
- * @param currency - ISO 4217 currency code (default: "GHS")
- * @param locale - BCP 47 locale string (default: "en-US")
- * @returns Formatted price string
- *
- * @example
- * formatPrice(29.99, 'USD')      // "$29.99"
- * formatPrice(29.99, 'GHS')      // "GH₵29.99"
- * formatPrice('29.99', 'EUR')    // "€29.99"
- * formatPrice(1234.56, 'USD', 'de-DE') // "1.234,56 $"
- */
-declare function formatPrice(amount: number | string, currency?: string, locale?: string): string;
-/**
- * Format a price with +/- sign for adjustments
- * Useful for showing price changes, modifiers, or discounts
- *
- * @param amount - Adjustment amount (positive or negative)
- * @param currency - ISO 4217 currency code (default: "GHS")
- * @param locale - BCP 47 locale string (default: "en-US")
- * @returns Formatted adjustment string with sign
- *
- * @example
- * formatPriceAdjustment(5.00, 'USD')  // "+$5.00"
- * formatPriceAdjustment(-3.50, 'GHS') // "-GH₵3.50"
- * formatPriceAdjustment(0, 'EUR')     // "€0.00"
- */
-declare function formatPriceAdjustment(amount: number, currency?: string, locale?: string): string;
-/**
- * Format a price compactly for large numbers
- * Uses K/M/B suffixes for thousands, millions, billions
- *
- * @param amount - Price amount (number or string)
- * @param currency - ISO 4217 currency code (default: "GHS")
- * @param decimals - Decimal places for compact notation (default: 1)
- * @returns Compact formatted price
- *
- * @example
- * formatPriceCompact(999, 'USD')       // "$999.00"
- * formatPriceCompact(1500, 'GHS')      // "GH₵1.5K"
- * formatPriceCompact(2500000, 'USD')   // "$2.5M"
- * formatPriceCompact(1200000000, 'EUR') // "€1.2B"
- */
-declare function formatPriceCompact(amount: number | string, currency?: string, decimals?: number): string;
-/**
- * Simple currency symbol + amount format
- * Lighter alternative to formatPrice without Intl
- *
- * @param amount - Price amount (number or string)
- * @param currency - ISO 4217 currency code (default: "GHS")
- * @returns Simple formatted price
- *
- * @example
- * formatMoney(29.99, 'USD') // "$29.99"
- * formatMoney('15.00', 'GHS') // "GH₵15.00"
- */
-declare function formatMoney(amount: string | number, currency?: string): string;
-/**
- * Parse a price string or number to a numeric value
- * Handles various input formats gracefully
- *
- * @param value - Value to parse (string, number, or undefined)
- * @returns Parsed numeric value, or 0 if invalid
- *
- * @example
- * parsePrice('29.99')   // 29.99
- * parsePrice(29.99)     // 29.99
- * parsePrice('$29.99')  // 29.99 (strips non-numeric prefix)
- * parsePrice(undefined) // 0
- * parsePrice('invalid') // 0
- */
-declare function parsePrice(value: string | number | undefined | null): number;
-/**
- * Get the display price from a product.
- * Prefers quote-aware price_info, then plain price fields.
- *
- * @param product - Product with price data
- * @returns The final price to display
- *
- * @example
- * const price = getDisplayPrice(product);
- * console.log(formatPrice(price, 'GHS')); // "GH₵29.99"
- */
-declare function getDisplayPrice(product: ProductWithPrice): number;
-/**
- * Get the base price from a product (before markup/discount)
- *
- * @param product - Product with price data
- * @returns The base price before adjustments
- */
-declare function getBasePrice(product: ProductWithPrice): number;
-/**
- * Check if a product is on sale (discounted)
- *
- * @param product - Product with price data
- * @returns True if the final price is less than the base price
- *
- * @example
- * if (isOnSale(product)) {
- *   return <Badge>Sale!</Badge>;
- * }
- */
-declare function isOnSale(product: ProductWithPrice): boolean;
-/**
- * Get the discount percentage for a product on sale
- *
- * @param product - Product with price data
- * @returns Discount percentage (0-100), or 0 if not on sale
- *
- * @example
- * const discount = getDiscountPercentage(product);
- * if (discount > 0) {
- *   return <Badge>{discount}% OFF</Badge>;
- * }
- */
-declare function getDiscountPercentage(product: ProductWithPrice): number;
-/**
- * Get the markup percentage for a product
- *
- * @param product - Product with price data
- * @returns Markup percentage, or 0 if no markup
- */
-declare function getMarkupPercentage(product: ProductWithPrice): number;
-/**
- * Get the currency for a product
- *
- * @param product - Product with price data
- * @returns Currency code (default: "GHS")
- */
-declare function getProductCurrency(product: ProductWithPrice): string;
-/**
- * Format a product's display price
- * Convenience function combining getDisplayPrice and formatPrice
- *
- * @param product - Product with price data
- * @param locale - BCP 47 locale string (default: "en-US")
- * @returns Formatted price string
- *
- * @example
- * <span>{formatProductPrice(product)}</span> // "GH₵29.99"
- */
-declare function formatProductPrice(product: ProductWithPrice, locale?: string): string;
-
-/**
- * Categorize payment errors into user-friendly messages
- */
-declare function categorizePaymentError(error: Error, errorCode?: string): PaymentErrorDetails;
-/**
- * Normalize payment response from different formats into a standard PaymentResponse
- */
-declare function normalizePaymentResponse(response: unknown): PaymentResponse;
-declare function isPaymentStatusSuccess(status: string | undefined): boolean;
-declare function isPaymentStatusFailure(status: string | undefined): boolean;
-declare function isPaymentStatusRequiresAction(status: string | undefined): boolean;
-/**
- * Normalize payment status response into a standard format
- */
-declare function normalizeStatusResponse(response: unknown): PaymentStatusResponse;
-/** Mobile money provider display names */
-declare const MOBILE_MONEY_PROVIDERS: {
-    readonly mtn: {
-        readonly name: "MTN Mobile Money";
-        readonly prefix: readonly ["024", "054", "055", "059"];
-    };
-    readonly vodafone: {
-        readonly name: "Vodafone Cash";
-        readonly prefix: readonly ["020", "050"];
-    };
-    readonly airtel: {
-        readonly name: "AirtelTigo Money";
-        readonly prefix: readonly ["027", "057", "026", "056"];
-    };
-};
-/**
- * Detect mobile money provider from phone number
- */
-declare function detectMobileMoneyProvider(phoneNumber: string): "mtn" | "vodafone" | "airtel" | null;
+export { ad as AUTHORIZATION_TYPE, ai as AUTH_MUTATION, a2 as AbortablePromise, aV as AddOn, bE as AddOnDetails, b_ as AddOnGroupDetails, aX as AddOnOption, bZ as AddOnOptionDetails, aY as AddOnOptionPrice, aW as AddOnWithOptions, c3 as AddToCartInput, dN as AddressData, ed as AddressInfo, bt as AdjustmentType, ch as AmountToPay, bA as AppliedDiscount, dY as AuthResponse, A as AuthService, m as AuthStatus, ef as AuthenticatedCustomer, eh as AuthenticatedData, dB as AvailabilityCheck, dC as AvailabilityResult, di as AvailableSlot, bz as BenefitType, dl as Booking, dc as BookingRequirementOverride, dk as BookingStatus, dm as BookingWithDetails, cB as BufferTimes, b4 as Bundle, b8 as BundleComponentData, b9 as BundleComponentInfo, b3 as BundlePriceType, b6 as BundleProduct, bJ as BundleSelectionData, bH as BundleSelectionInput, bI as BundleStoredSelection, b5 as BundleSummary, b7 as BundleWithDetails, cQ as Business, d2 as BusinessHours, cP as BusinessPreferences, B as BusinessService, d1 as BusinessSettings, cO as BusinessType, c$ as BusinessWithLocations, a6 as CHECKOUT_MODE, aj as CHECKOUT_MUTATION, a9 as CHECKOUT_STEP, af as CONTACT_TYPE, dr as CancelBookingInput, cv as CancelOrderInput, cD as CancellationPolicy, bO as Cart, bF as CartAddOn, br as CartChannel, bP as CartItem, c0 as CartItemDetails, i as CartOperations, bq as CartStatus, c5 as CartSummary, bQ as CartTotals, b as CatalogueQueries, a_ as Category, d3 as CategoryInfo, a$ as CategorySummary, o as ChangePasswordInput, dp as CheckSlotAvailabilityInput, d$ as CheckoutAddressInfo, e1 as CheckoutCustomerInfo, X as CheckoutFormData, ct as CheckoutInput, J as CheckoutMode, j as CheckoutOperations, N as CheckoutOrderType, V as CheckoutPaymentMethod, Y as CheckoutResult, j as CheckoutService, a0 as CheckoutStatus, a1 as CheckoutStatusContext, W as CheckoutStep, by as ChosenPrice, C as CimplifyClient, a as CimplifyConfig, v as CimplifyElement, u as CimplifyElements, b0 as Collection, b2 as CollectionProduct, b1 as CollectionSummary, bf as ComponentGroup, bg as ComponentGroupWithComponents, bk as ComponentPriceBreakdown, bi as ComponentSelectionInput, bc as ComponentSourceType, bd as Composite, bh as CompositeComponent, bL as CompositePriceBreakdown, bj as CompositePriceResult, ba as CompositePricingMode, bM as CompositeSelectionData, bi as CompositeSelectionInput, bK as CompositeStoredSelection, be as CompositeWithDetails, a5 as ContactType, dJ as CreateAddressInput, dL as CreateMobileMoneyInput, dE as Customer, dF as CustomerAddress, dH as CustomerLinkPreferences, dG as CustomerMobileMoney, cA as CustomerServicePreferences, an as DEFAULT_COUNTRY, am as DEFAULT_CURRENCY, ae as DEVICE_TYPE, dj as DayAvailability, cK as DepositResult, aJ as DepositType, a4 as DeviceType, aI as DigitalProductType, bB as DiscountBreakdown, bC as DiscountDetails, bT as DisplayAddOn, bU as DisplayAddOnOption, bR as DisplayCart, bS as DisplayCartItem, x as ELEMENT_TYPES, E as EVENT_TYPES, ec as ElementAppearance, em as ElementEventHandler, H as ElementEventType, z as ElementOptions, D as ElementType, ei as ElementsCheckoutData, ej as ElementsCheckoutResult, eg as ElementsCustomerInfo, y as ElementsOptions, dP as EnrollAndLinkOrderInput, dS as EnrollAndLinkOrderResult, dM as EnrollmentData, aq as Err, cg as FeeBearerType, F as FetchQuoteInput, ce as FulfillmentLink, cd as FulfillmentStatus, cc as FulfillmentType, e3 as FxQuote, e2 as FxQuoteRequest, e4 as FxRateResponse, r as FxService, dn as GetAvailableSlotsInput, l as GetOrdersOptions, G as GetProductsOptions, bb as GroupPricingBehavior, el as IframeToParentMessage, I as InventoryService, dD as InventorySummary, aG as InventoryType, K as KitchenOrderItem, t as KitchenOrderResult, ah as LINK_MUTATION, ag as LINK_QUERY, bN as LineConfiguration, ci as LineItem, c9 as LineType, dI as LinkData, dR as LinkEnrollResult, L as LinkService, dT as LinkSession, dQ as LinkStatusResult, s as LiteBootstrap, q as LiteService, cT as Location, cN as LocationAppointment, bn as LocationProductPrice, dA as LocationStock, cR as LocationTaxBehavior, cS as LocationTaxOverrides, cW as LocationTimeProfile, d0 as LocationWithDetails, M as MESSAGE_TYPES, ac as MOBILE_MONEY_PROVIDER, dO as MobileMoneyData, e0 as MobileMoneyDetails, a3 as MobileMoneyProvider, al as ORDER_MUTATION, a7 as ORDER_TYPE, eb as ObservabilityHooks, ap as Ok, cj as Order, c8 as OrderChannel, cs as OrderFilter, cf as OrderFulfillmentSummary, cm as OrderGroup, cq as OrderGroupDetails, cn as OrderGroupPayment, cl as OrderGroupPaymentState, cp as OrderGroupPaymentSummary, ck as OrderHistory, ca as OrderLineState, cb as OrderLineStatus, cr as OrderPaymentEvent, O as OrderQueries, co as OrderSplitDetail, c6 as OrderStatus, n as OtpResult, a8 as PAYMENT_METHOD, ak as PAYMENT_MUTATION, aa as PAYMENT_STATE, ab as PICKUP_TIME_TYPE, ek as ParentToIframeMessage, ee as PaymentMethodInfo, c7 as PaymentState, d_ as PickupTime, dZ as PickupTimeType, bm as Price, bu as PriceAdjustment, bx as PriceDecisionPath, bl as PriceEntryType, bw as PricePathTaxInfo, P as PriceQuote, bs as PriceSource, cF as PricingOverrides, $ as ProcessAndResolveOptions, Z as ProcessCheckoutOptions, _ as ProcessCheckoutResult, aL as Product, aZ as ProductAddOn, bo as ProductAvailability, dy as ProductStock, bp as ProductTimeProfile, aF as ProductType, aN as ProductVariant, aS as ProductVariantValue, aM as ProductWithDetails, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, f as QuoteDynamicBuckets, e as QuoteStatus, g as QuoteUiMessage, R as RefreshQuoteInput, h as RefreshQuoteResult, cw as RefundOrderInput, cz as ReminderMethod, cC as ReminderSettings, e5 as RequestContext, e8 as RequestErrorEvent, dW as RequestOtpInput, e6 as RequestStartEvent, e7 as RequestSuccessEvent, dq as RescheduleBookingInput, cI as ResourceAssignment, d9 as ResourceAvailabilityException, d8 as ResourceAvailabilityRule, dd as ResourceType, ao as Result, e9 as RetryEvent, dV as RevokeAllSessionsResult, dU as RevokeSessionResult, cY as Room, aK as SalesChannel, cG as SchedulingMetadata, cJ as SchedulingResult, p as SchedulingService, S as SearchOptions, bD as SelectedAddOnOption, de as Service, d5 as ServiceAvailabilityException, ds as ServiceAvailabilityParams, dt as ServiceAvailabilityResult, d4 as ServiceAvailabilityRule, cZ as ServiceCharge, cE as ServiceNotes, cL as ServiceScheduleRequest, db as ServiceStaffRequirement, cx as ServiceStatus, df as ServiceWithStaff, ea as SessionChangeEvent, dg as Staff, cH as StaffAssignment, d7 as StaffAvailabilityException, d6 as StaffAvailabilityRule, da as StaffBookingProfile, cy as StaffRole, cM as StaffScheduleItem, dw as Stock, dx as StockLevel, du as StockOwnershipType, dv as StockStatus, c_ as StorefrontBootstrap, cX as Table, T as TableInfo, bv as TaxPathComponent, cU as TimeRange, cV as TimeRanges, dh as TimeSlot, c1 as UICart, bV as UICartBusiness, bX as UICartCustomer, bW as UICartLocation, bY as UICartPricing, c2 as UICartResponse, dK as UpdateAddressInput, c4 as UpdateCartItemInput, cu as UpdateOrderStatusInput, U as UpdateProfileInput, aP as VariantAxis, aU as VariantAxisSelection, aR as VariantAxisValue, aQ as VariantAxisWithValues, bG as VariantDetails, b$ as VariantDetailsDTO, aO as VariantDisplayAttribute, aT as VariantLocationAvailability, dz as VariantStock, aH as VariantStrategy, dX as VerifyOtpInput, aD as combine, aE as combineObject, c as createCimplifyClient, w as createElements, as as err, ax as flatMap, aB as fromPromise, k as generateIdempotencyKey, ay as getOrElse, au as isErr, at as isOk, aw as mapError, av as mapResult, ar as ok, aA as toNullable, aC as tryCatch, az as unwrap } from './client-CjqNbEM6.js';
+export { QueryBuilder, query } from './advanced.js';
+export { C as CURRENCY_SYMBOLS, x as FormatCompactOptions, F as FormatPriceOptions, M as MOBILE_MONEY_PROVIDERS, P as PriceInfo, w as ProductWithPrice, T as TaxComponent, v as TaxInfo, n as categorizePaymentError, u as detectMobileMoneyProvider, c as formatMoney, d as formatNumberCompact, f as formatPrice, a as formatPriceAdjustment, b as formatPriceCompact, e as formatProductPrice, i as getBasePrice, g as getCurrencySymbol, k as getDiscountPercentage, h as getDisplayPrice, l as getMarkupPercentage, m as getProductCurrency, j as isOnSale, r as isPaymentStatusFailure, s as isPaymentStatusRequiresAction, t as isPaymentStatusSuccess, o as normalizePaymentResponse, q as normalizeStatusResponse, p as parsePrice } from './index-B5Bj-Ikg.js';
+import { A as ApiError } from './payment-D-u3asA8.js';
+export { h as AuthorizationType, c as CimplifyError, C as Currency, E as ErrorCode, b as ErrorCodeType, I as InitializePaymentResult, M as Money, a as Pagination, P as PaginationParams, l as Payment, o as PaymentErrorDetails, k as PaymentMethod, g as PaymentMethodType, j as PaymentProcessingState, f as PaymentProvider, m as PaymentResponse, e as PaymentStatus, n as PaymentStatusResponse, S as SubmitAuthorizationInput, i as isCimplifyError, d as isRetryableError } from './payment-D-u3asA8.js';
+export { c as AdConfig, e as AdContextValue, d as AdCreative, a as AdPosition, A as AdSlot, b as AdTheme } from './ads-t3FBTU8p.js';
 
 /** Context sent with every request to scope operations to a specific location/branch */
 interface FrontendContext {
@@ -374,4 +35,4 @@ interface ApiResponse<T> {
     metadata?: ResponseMetadata;
 }
 
-export { ApiError, type ApiResponse, CURRENCY_SYMBOLS, type FormatCompactOptions, type FormatPriceOptions, type FrontendContext, MOBILE_MONEY_PROVIDERS, type MutationRequest, PaymentErrorDetails, PaymentResponse, PaymentStatusResponse, type PriceInfo, type ProductWithPrice, QueryBuilder, type QueryRequest, type ResponseMetadata, type TaxComponent, type TaxInfo, categorizePaymentError, detectMobileMoneyProvider, formatMoney, formatNumberCompact, formatPrice, formatPriceAdjustment, formatPriceCompact, formatProductPrice, getBasePrice, getCurrencySymbol, getDiscountPercentage, getDisplayPrice, getMarkupPercentage, getProductCurrency, isOnSale, isPaymentStatusFailure, isPaymentStatusRequiresAction, isPaymentStatusSuccess, normalizePaymentResponse, normalizeStatusResponse, parsePrice, query };
+export { ApiError, type ApiResponse, type FrontendContext, type MutationRequest, type QueryRequest, type ResponseMetadata };

package/dist/index.js

@@ -2533,8 +2533,9 @@ var CimplifyElements = class {
     this.paymentData = null;
     this.checkoutInProgress = false;
     this.activeCheckoutAbort = null;
+    this.businessIdResolvePromise = null;
     this.client = client;
-    this.businessId = businessId;
+    this.businessId = businessId ?? null;
     this.linkUrl = options.linkUrl || DEFAULT_LINK_URL;
     this.options = options;
     this.boundHandleMessage = this.handleMessage.bind(this);
@@ -2757,6 +2758,24 @@ var CimplifyElements = class {
   getPublicKey() {
     return this.client.getPublicKey();
   }
+  getBusinessId() {
+    return this.businessId;
+  }
+  async resolveBusinessId() {
+    if (this.businessId) {
+      return this.businessId;
+    }
+    if (this.businessIdResolvePromise) {
+      return this.businessIdResolvePromise;
+    }
+    this.businessIdResolvePromise = this.client.resolveBusinessId().then((resolvedBusinessId) => {
+      this.businessId = resolvedBusinessId;
+      return resolvedBusinessId;
+    }).catch(() => null).finally(() => {
+      this.businessIdResolvePromise = null;
+    });
+    return this.businessIdResolvePromise;
+  }
   getAppearance() {
     return this.options.appearance;
   }
@@ -2861,8 +2880,8 @@ var CimplifyElement = class {
       return;
     }
     this.container = target;
-    this.createIframe();
     this.mounted = true;
+    void this.createIframe();
   }
   destroy() {
     if (this.iframe) {
@@ -2916,11 +2935,21 @@ var CimplifyElement = class {
   isMounted() {
     return this.mounted && Boolean(this.iframe) && this.iframe?.isConnected === true;
   }
-  createIframe() {
+  async createIframe() {
     if (!this.container) return;
+    const resolvedBusinessId = this.businessId ?? await this.parent.resolveBusinessId();
+    if (!resolvedBusinessId || !this.container || !this.mounted) {
+      console.error("Unable to mount element without a resolved business ID");
+      this.emit(EVENT_TYPES.ERROR, {
+        code: "BUSINESS_ID_REQUIRED",
+        message: "Unable to initialize checkout without a business ID."
+      });
+      return;
+    }
+    this.businessId = resolvedBusinessId;
     const iframe = document.createElement("iframe");
     const url = new URL(`${this.linkUrl}/elements/${this.type}`);
-    url.searchParams.set("businessId", this.businessId);
+    url.searchParams.set("businessId", resolvedBusinessId);
     if (this.options.prefillEmail) url.searchParams.set("email", this.options.prefillEmail);
     if (this.options.mode) url.searchParams.set("mode", this.options.mode);
     iframe.src = url.toString();
@@ -2940,7 +2969,7 @@ var CimplifyElement = class {
       const publicKey = this.parent.getPublicKey();
       this.sendMessage({
         type: MESSAGE_TYPES.INIT,
-        businessId: this.businessId,
+        businessId: resolvedBusinessId,
         publicKey,
         demoMode: publicKey.length === 0,
         prefillEmail: this.options.prefillEmail,
@@ -3085,6 +3114,8 @@ var CimplifyClient = class {
   constructor(config = {}) {
     this.accessToken = null;
     this.context = {};
+    this.businessId = null;
+    this.businessIdResolvePromise = null;
     this.inflightRequests = /* @__PURE__ */ new Map();
     this.publicKey = config.publicKey || getEnvPublicKey() || "";
     const urls = deriveUrls();
@@ -3148,6 +3179,47 @@ var CimplifyClient = class {
   getLocationId() {
     return this.context.location_id ?? null;
   }
+  /** Cache a resolved business ID for future element/checkouts initialization. */
+  setBusinessId(businessId) {
+    const normalized = businessId.trim();
+    if (!normalized) {
+      return;
+    }
+    this.businessId = normalized;
+  }
+  /** Get cached business ID if available. */
+  getBusinessId() {
+    return this.businessId;
+  }
+  /**
+   * Resolve business ID from public key once and cache it.
+   * Subsequent calls return the cached value (or shared in-flight promise).
+   */
+  async resolveBusinessId() {
+    if (this.businessId) {
+      return this.businessId;
+    }
+    if (this.businessIdResolvePromise) {
+      return this.businessIdResolvePromise;
+    }
+    this.businessIdResolvePromise = (async () => {
+      const result = await this.business.getInfo();
+      if (!result.ok || !result.value?.id) {
+        throw new CimplifyError(
+          ErrorCode.NOT_FOUND,
+          "Unable to resolve business ID from the current public key.",
+          true
+        );
+      }
+      this.businessId = result.value.id;
+      return result.value.id;
+    })();
+    try {
+      return await this.businessIdResolvePromise;
+    } finally {
+      this.businessIdResolvePromise = null;
+    }
+  }
   loadAccessToken() {
     if (typeof window !== "undefined" && window.localStorage) {
       return localStorage.getItem(ACCESS_TOKEN_STORAGE_KEY);
@@ -3465,7 +3537,10 @@ var CimplifyClient = class {
    * ```
    */
   elements(businessId, options) {
-    return createElements(this, businessId, options);
+    if (businessId) {
+      this.setBusinessId(businessId);
+    }
+    return createElements(this, businessId ?? this.businessId ?? void 0, options);
   }
 };
 function createCimplifyClient(config = {}) {

package/dist/index.mjs

@@ -2531,8 +2531,9 @@ var CimplifyElements = class {
     this.paymentData = null;
     this.checkoutInProgress = false;
     this.activeCheckoutAbort = null;
+    this.businessIdResolvePromise = null;
     this.client = client;
-    this.businessId = businessId;
+    this.businessId = businessId ?? null;
     this.linkUrl = options.linkUrl || DEFAULT_LINK_URL;
     this.options = options;
     this.boundHandleMessage = this.handleMessage.bind(this);
@@ -2755,6 +2756,24 @@ var CimplifyElements = class {
   getPublicKey() {
     return this.client.getPublicKey();
   }
+  getBusinessId() {
+    return this.businessId;
+  }
+  async resolveBusinessId() {
+    if (this.businessId) {
+      return this.businessId;
+    }
+    if (this.businessIdResolvePromise) {
+      return this.businessIdResolvePromise;
+    }
+    this.businessIdResolvePromise = this.client.resolveBusinessId().then((resolvedBusinessId) => {
+      this.businessId = resolvedBusinessId;
+      return resolvedBusinessId;
+    }).catch(() => null).finally(() => {
+      this.businessIdResolvePromise = null;
+    });
+    return this.businessIdResolvePromise;
+  }
   getAppearance() {
     return this.options.appearance;
   }
@@ -2859,8 +2878,8 @@ var CimplifyElement = class {
       return;
     }
     this.container = target;
-    this.createIframe();
     this.mounted = true;
+    void this.createIframe();
   }
   destroy() {
     if (this.iframe) {
@@ -2914,11 +2933,21 @@ var CimplifyElement = class {
   isMounted() {
     return this.mounted && Boolean(this.iframe) && this.iframe?.isConnected === true;
   }
-  createIframe() {
+  async createIframe() {
     if (!this.container) return;
+    const resolvedBusinessId = this.businessId ?? await this.parent.resolveBusinessId();
+    if (!resolvedBusinessId || !this.container || !this.mounted) {
+      console.error("Unable to mount element without a resolved business ID");
+      this.emit(EVENT_TYPES.ERROR, {
+        code: "BUSINESS_ID_REQUIRED",
+        message: "Unable to initialize checkout without a business ID."
+      });
+      return;
+    }
+    this.businessId = resolvedBusinessId;
     const iframe = document.createElement("iframe");
     const url = new URL(`${this.linkUrl}/elements/${this.type}`);
-    url.searchParams.set("businessId", this.businessId);
+    url.searchParams.set("businessId", resolvedBusinessId);
     if (this.options.prefillEmail) url.searchParams.set("email", this.options.prefillEmail);
     if (this.options.mode) url.searchParams.set("mode", this.options.mode);
     iframe.src = url.toString();
@@ -2938,7 +2967,7 @@ var CimplifyElement = class {
       const publicKey = this.parent.getPublicKey();
       this.sendMessage({
         type: MESSAGE_TYPES.INIT,
-        businessId: this.businessId,
+        businessId: resolvedBusinessId,
         publicKey,
         demoMode: publicKey.length === 0,
         prefillEmail: this.options.prefillEmail,
@@ -3083,6 +3112,8 @@ var CimplifyClient = class {
   constructor(config = {}) {
     this.accessToken = null;
     this.context = {};
+    this.businessId = null;
+    this.businessIdResolvePromise = null;
     this.inflightRequests = /* @__PURE__ */ new Map();
     this.publicKey = config.publicKey || getEnvPublicKey() || "";
     const urls = deriveUrls();
@@ -3146,6 +3177,47 @@ var CimplifyClient = class {
   getLocationId() {
     return this.context.location_id ?? null;
   }
+  /** Cache a resolved business ID for future element/checkouts initialization. */
+  setBusinessId(businessId) {
+    const normalized = businessId.trim();
+    if (!normalized) {
+      return;
+    }
+    this.businessId = normalized;
+  }
+  /** Get cached business ID if available. */
+  getBusinessId() {
+    return this.businessId;
+  }
+  /**
+   * Resolve business ID from public key once and cache it.
+   * Subsequent calls return the cached value (or shared in-flight promise).
+   */
+  async resolveBusinessId() {
+    if (this.businessId) {
+      return this.businessId;
+    }
+    if (this.businessIdResolvePromise) {
+      return this.businessIdResolvePromise;
+    }
+    this.businessIdResolvePromise = (async () => {
+      const result = await this.business.getInfo();
+      if (!result.ok || !result.value?.id) {
+        throw new CimplifyError(
+          ErrorCode.NOT_FOUND,
+          "Unable to resolve business ID from the current public key.",
+          true
+        );
+      }
+      this.businessId = result.value.id;
+      return result.value.id;
+    })();
+    try {
+      return await this.businessIdResolvePromise;
+    } finally {
+      this.businessIdResolvePromise = null;
+    }
+  }
   loadAccessToken() {
     if (typeof window !== "undefined" && window.localStorage) {
       return localStorage.getItem(ACCESS_TOKEN_STORAGE_KEY);
@@ -3463,7 +3535,10 @@ var CimplifyClient = class {
    * ```
    */
   elements(businessId, options) {
-    return createElements(this, businessId, options);
+    if (businessId) {
+      this.setBusinessId(businessId);
+    }
+    return createElements(this, businessId ?? this.businessId ?? void 0, options);
   }
 };
 function createCimplifyClient(config = {}) {