@cimplify/sdk 0.6.4 → 0.6.6

package/dist/index.d.mts

@@ -0,0 +1,38 @@
+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-CUFdFugo.mjs';
+export { QueryBuilder, query } from './advanced.mjs';
+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-CJ9GkIXf.mjs';
+import { A as ApiError } from './payment-D-u3asA8.mjs';
+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.mjs';
+export { c as AdConfig, e as AdContextValue, d as AdCreative, a as AdPosition, A as AdSlot, b as AdTheme } from './ads-t3FBTU8p.mjs';
+
+/** Context sent with every request to scope operations to a specific location/branch */
+interface FrontendContext {
+    location_id?: string;
+}
+/** Request body for POST /api/q */
+interface QueryRequest {
+    query: string;
+    variables?: Record<string, unknown>;
+    cache_hint?: string;
+    context?: FrontendContext;
+}
+/** Request body for POST /api/m */
+interface MutationRequest {
+    method: string;
+    args: unknown[];
+    context?: FrontendContext;
+}
+/** Response metadata */
+interface ResponseMetadata {
+    execution_time_ms: number;
+    cache_hit: boolean;
+}
+/** Standard API response wrapper */
+interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: ApiError;
+    metadata?: ResponseMetadata;
+}
+
+export { ApiError, type ApiResponse, type FrontendContext, type MutationRequest, type QueryRequest, type ResponseMetadata };

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+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 {
+    location_id?: string;
+}
+/** Request body for POST /api/q */
+interface QueryRequest {
+    query: string;
+    variables?: Record<string, unknown>;
+    cache_hint?: string;
+    context?: FrontendContext;
+}
+/** Request body for POST /api/m */
+interface MutationRequest {
+    method: string;
+    args: unknown[];
+    context?: FrontendContext;
+}
+/** Response metadata */
+interface ResponseMetadata {
+    execution_time_ms: number;
+    cache_hit: boolean;
+}
+/** Standard API response wrapper */
+interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: ApiError;
+    metadata?: ResponseMetadata;
+}
+
+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 = {}) {

package/dist/payment-D-u3asA8.d.mts

@@ -0,0 +1,170 @@
+/** Decimal value represented as string for precision */
+type Money = string;
+/** Supported currencies */
+type Currency = "GHS" | "USD" | "NGN" | "KES" | "ZAR" | string;
+/** Pagination parameters */
+interface PaginationParams {
+    page?: number;
+    limit?: number;
+    offset?: number;
+}
+/** Pagination metadata in response */
+interface Pagination {
+    total_count: number;
+    current_page: number;
+    page_size: number;
+    total_pages: number;
+}
+/** Strongly-typed error codes for better DX */
+declare const ErrorCode: {
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly FORBIDDEN: "FORBIDDEN";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly CART_EMPTY: "CART_EMPTY";
+    readonly CART_EXPIRED: "CART_EXPIRED";
+    readonly CART_NOT_FOUND: "CART_NOT_FOUND";
+    readonly ITEM_UNAVAILABLE: "ITEM_UNAVAILABLE";
+    readonly VARIANT_NOT_FOUND: "VARIANT_NOT_FOUND";
+    readonly VARIANT_OUT_OF_STOCK: "VARIANT_OUT_OF_STOCK";
+    readonly ADDON_REQUIRED: "ADDON_REQUIRED";
+    readonly ADDON_MAX_EXCEEDED: "ADDON_MAX_EXCEEDED";
+    readonly CHECKOUT_VALIDATION_FAILED: "CHECKOUT_VALIDATION_FAILED";
+    readonly DELIVERY_ADDRESS_REQUIRED: "DELIVERY_ADDRESS_REQUIRED";
+    readonly CUSTOMER_INFO_REQUIRED: "CUSTOMER_INFO_REQUIRED";
+    readonly PAYMENT_FAILED: "PAYMENT_FAILED";
+    readonly PAYMENT_CANCELLED: "PAYMENT_CANCELLED";
+    readonly INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS";
+    readonly CARD_DECLINED: "CARD_DECLINED";
+    readonly INVALID_OTP: "INVALID_OTP";
+    readonly OTP_EXPIRED: "OTP_EXPIRED";
+    readonly AUTHORIZATION_FAILED: "AUTHORIZATION_FAILED";
+    readonly PAYMENT_ACTION_NOT_COMPLETED: "PAYMENT_ACTION_NOT_COMPLETED";
+    readonly SLOT_UNAVAILABLE: "SLOT_UNAVAILABLE";
+    readonly BOOKING_CONFLICT: "BOOKING_CONFLICT";
+    readonly SERVICE_NOT_FOUND: "SERVICE_NOT_FOUND";
+    readonly OUT_OF_STOCK: "OUT_OF_STOCK";
+    readonly INSUFFICIENT_QUANTITY: "INSUFFICIENT_QUANTITY";
+};
+type ErrorCodeType = (typeof ErrorCode)[keyof typeof ErrorCode];
+/** API error structure */
+interface ApiError {
+    code: string;
+    message: string;
+    retryable: boolean;
+}
+/**
+ * Custom error class for SDK errors with typed error codes.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.cart.addItem({ item_id: "prod_123" });
+ * } catch (error) {
+ *   if (isCimplifyError(error)) {
+ *     switch (error.code) {
+ *       case ErrorCode.ITEM_UNAVAILABLE:
+ *         toast.error("This item is no longer available");
+ *         break;
+ *       case ErrorCode.VARIANT_OUT_OF_STOCK:
+ *         toast.error("Selected option is out of stock");
+ *         break;
+ *       default:
+ *         toast.error(error.message);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare class CimplifyError extends Error {
+    code: string;
+    retryable: boolean;
+    constructor(code: string, message: string, retryable?: boolean);
+    /** User-friendly message safe to display */
+    get userMessage(): string;
+}
+/** Type guard for CimplifyError */
+declare function isCimplifyError(error: unknown): error is CimplifyError;
+/** Check if error is retryable */
+declare function isRetryableError(error: unknown): boolean;
+
+type PaymentStatus = "pending" | "processing" | "created" | "pending_confirmation" | "success" | "succeeded" | "failed" | "declined" | "authorized" | "refunded" | "partially_refunded" | "partially_paid" | "paid" | "unpaid" | "requires_action" | "requires_payment_method" | "requires_capture" | "captured" | "cancelled" | "completed" | "voided" | "error" | "unknown";
+type PaymentProvider = "stripe" | "paystack" | "mtn" | "vodafone" | "airtel" | "cellulant" | "offline" | "cash" | "manual";
+type PaymentMethodType = "card" | "mobile_money" | "bank_transfer" | "cash" | "custom";
+/** Authorization types for payment verification (OTP, PIN, etc.) */
+type AuthorizationType = "otp" | "pin" | "phone" | "birthday" | "address";
+/** Payment processing state machine states (for UI) */
+type PaymentProcessingState = "initial" | "preparing" | "processing" | "verifying" | "awaiting_authorization" | "success" | "error" | "timeout";
+interface PaymentMethod {
+    type: PaymentMethodType;
+    provider?: string;
+    phone_number?: string;
+    card_last_four?: string;
+    custom_value?: string;
+}
+interface Payment {
+    id: string;
+    order_id: string;
+    business_id: string;
+    amount: Money;
+    currency: Currency;
+    payment_method: PaymentMethod;
+    status: PaymentStatus;
+    provider: PaymentProvider;
+    provider_reference?: string;
+    failure_reason?: string;
+    created_at: string;
+    updated_at: string;
+}
+interface InitializePaymentResult {
+    payment_id: string;
+    status: PaymentStatus;
+    redirect_url?: string;
+    authorization_url?: string;
+    reference: string;
+    provider: PaymentProvider;
+}
+/** Normalized payment response from checkout or payment initialization */
+interface PaymentResponse {
+    method: string;
+    provider: string;
+    requires_action: boolean;
+    public_key?: string;
+    client_secret?: string;
+    access_code?: string;
+    redirect_url?: string;
+    transaction_id?: string;
+    order_id?: string;
+    reference?: string;
+    metadata?: Record<string, unknown>;
+    instructions?: string;
+    display_text?: string;
+    requires_authorization?: boolean;
+    authorization_type?: AuthorizationType;
+    provider_payment_id?: string;
+}
+/** Payment status polling response */
+interface PaymentStatusResponse {
+    status: PaymentStatus;
+    paid: boolean;
+    amount?: Money;
+    currency?: string;
+    reference?: string;
+    message?: string;
+}
+interface PaymentErrorDetails {
+    code: string;
+    message: string;
+    recoverable: boolean;
+    technical?: string;
+}
+interface SubmitAuthorizationInput {
+    reference: string;
+    auth_type: AuthorizationType;
+    value: string;
+}
+
+export { type ApiError as A, type Currency as C, ErrorCode as E, type InitializePaymentResult as I, type Money as M, type PaginationParams as P, type SubmitAuthorizationInput as S, type Pagination as a, type ErrorCodeType as b, CimplifyError as c, isRetryableError as d, type PaymentStatus as e, type PaymentProvider as f, type PaymentMethodType as g, type AuthorizationType as h, isCimplifyError as i, type PaymentProcessingState as j, type PaymentMethod as k, type Payment as l, type PaymentResponse as m, type PaymentStatusResponse as n, type PaymentErrorDetails as o };