@cimplify/sdk 0.6.6 → 0.6.8

package/dist/{payment-D-u3asA8.d.mts → payment-Cu75tmUc.d.mts}

@@ -1,7 +1,22 @@
-/** Decimal value represented as string for precision */
-type Money = string;
-/** Supported currencies */
-type Currency = "GHS" | "USD" | "NGN" | "KES" | "ZAR" | string;
+declare const __money: unique symbol;
+/** Decimal monetary amount as a string (e.g. "29.99"). Branded to prevent mixing with plain strings. */
+type Money = string & {
+    readonly [__money]: true;
+};
+/** Create a Money value from a string decimal. */
+declare function money(value: string): Money;
+/** Create a Money value from a number. Converts to a 2-decimal string. */
+declare function moneyFromNumber(value: number): Money;
+/** Zero money constant. */
+declare const ZERO: Money;
+/** ISO 4217 currency codes supported by the platform */
+type CurrencyCode = "USD" | "EUR" | "GBP" | "JPY" | "CNY" | "CHF" | "CAD" | "AUD" | "GHS" | "NGN" | "KES" | "ZAR" | "XOF" | "XAF" | "EGP" | "TZS" | "UGX" | "RWF" | "ETB" | "ZMW" | "BWP" | "MUR" | "NAD" | "MWK" | "AOA" | "CDF" | "GMD" | "GNF" | "LRD" | "SLL" | "MZN" | "BIF" | "INR" | "BRL" | "MXN" | "KRW" | "TRY" | "THB" | "MYR" | "PHP" | "IDR" | "VND" | "SGD" | "HKD" | "TWD" | "AED" | "SAR" | "ILS";
+/** Assert a string as CurrencyCode at API boundaries. */
+declare function currencyCode(value: string): CurrencyCode;
+/**
+ * @deprecated Use `CurrencyCode` instead. Kept for backward compatibility.
+ */
+type Currency = CurrencyCode;
 /** Pagination parameters */
 interface PaginationParams {
     page?: number;
@@ -56,6 +71,11 @@ interface ApiError {
     message: string;
     retryable: boolean;
 }
+interface ErrorHint {
+    docs_url: string;
+    suggestion: string;
+}
+declare const ERROR_HINTS: Record<string, ErrorHint>;
 /**
  * Custom error class for SDK errors with typed error codes.
  *
@@ -82,12 +102,18 @@ interface ApiError {
 declare class CimplifyError extends Error {
     code: string;
     retryable: boolean;
-    constructor(code: string, message: string, retryable?: boolean);
+    docs_url?: string | undefined;
+    suggestion?: string | undefined;
+    constructor(code: string, message: string, retryable?: boolean, docs_url?: string | undefined, suggestion?: string | undefined);
     /** User-friendly message safe to display */
     get userMessage(): string;
 }
 /** Type guard for CimplifyError */
 declare function isCimplifyError(error: unknown): error is CimplifyError;
+declare function getErrorHint(code: string): ErrorHint | undefined;
+declare function enrichError(error: CimplifyError, options?: {
+    isTestMode?: boolean;
+}): CimplifyError;
 /** Check if error is retryable */
 declare function isRetryableError(error: unknown): boolean;
 
@@ -110,7 +136,7 @@ interface Payment {
     order_id: string;
     business_id: string;
     amount: Money;
-    currency: Currency;
+    currency: CurrencyCode;
     payment_method: PaymentMethod;
     status: PaymentStatus;
     provider: PaymentProvider;
@@ -151,7 +177,7 @@ interface PaymentStatusResponse {
     status: PaymentStatus;
     paid: boolean;
     amount?: Money;
-    currency?: string;
+    currency?: CurrencyCode;
     reference?: string;
     message?: string;
 }
@@ -167,4 +193,4 @@ interface SubmitAuthorizationInput {
     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 };
+export { type ApiError as A, type CurrencyCode as C, ErrorCode as E, type InitializePaymentResult as I, type Money as M, type PaginationParams as P, type SubmitAuthorizationInput as S, ZERO as Z, moneyFromNumber as a, type Currency as b, currencyCode as c, type Pagination as d, type ErrorCodeType as e, type ErrorHint as f, ERROR_HINTS as g, CimplifyError as h, isCimplifyError as i, getErrorHint as j, enrichError as k, isRetryableError as l, money as m, type PaymentStatus as n, type PaymentProvider as o, type PaymentMethodType as p, type AuthorizationType as q, type PaymentProcessingState as r, type PaymentMethod as s, type Payment as t, type PaymentResponse as u, type PaymentStatusResponse as v, type PaymentErrorDetails as w };

package/dist/{payment-D-u3asA8.d.ts → payment-Cu75tmUc.d.ts}

@@ -1,7 +1,22 @@
-/** Decimal value represented as string for precision */
-type Money = string;
-/** Supported currencies */
-type Currency = "GHS" | "USD" | "NGN" | "KES" | "ZAR" | string;
+declare const __money: unique symbol;
+/** Decimal monetary amount as a string (e.g. "29.99"). Branded to prevent mixing with plain strings. */
+type Money = string & {
+    readonly [__money]: true;
+};
+/** Create a Money value from a string decimal. */
+declare function money(value: string): Money;
+/** Create a Money value from a number. Converts to a 2-decimal string. */
+declare function moneyFromNumber(value: number): Money;
+/** Zero money constant. */
+declare const ZERO: Money;
+/** ISO 4217 currency codes supported by the platform */
+type CurrencyCode = "USD" | "EUR" | "GBP" | "JPY" | "CNY" | "CHF" | "CAD" | "AUD" | "GHS" | "NGN" | "KES" | "ZAR" | "XOF" | "XAF" | "EGP" | "TZS" | "UGX" | "RWF" | "ETB" | "ZMW" | "BWP" | "MUR" | "NAD" | "MWK" | "AOA" | "CDF" | "GMD" | "GNF" | "LRD" | "SLL" | "MZN" | "BIF" | "INR" | "BRL" | "MXN" | "KRW" | "TRY" | "THB" | "MYR" | "PHP" | "IDR" | "VND" | "SGD" | "HKD" | "TWD" | "AED" | "SAR" | "ILS";
+/** Assert a string as CurrencyCode at API boundaries. */
+declare function currencyCode(value: string): CurrencyCode;
+/**
+ * @deprecated Use `CurrencyCode` instead. Kept for backward compatibility.
+ */
+type Currency = CurrencyCode;
 /** Pagination parameters */
 interface PaginationParams {
     page?: number;
@@ -56,6 +71,11 @@ interface ApiError {
     message: string;
     retryable: boolean;
 }
+interface ErrorHint {
+    docs_url: string;
+    suggestion: string;
+}
+declare const ERROR_HINTS: Record<string, ErrorHint>;
 /**
  * Custom error class for SDK errors with typed error codes.
  *
@@ -82,12 +102,18 @@ interface ApiError {
 declare class CimplifyError extends Error {
     code: string;
     retryable: boolean;
-    constructor(code: string, message: string, retryable?: boolean);
+    docs_url?: string | undefined;
+    suggestion?: string | undefined;
+    constructor(code: string, message: string, retryable?: boolean, docs_url?: string | undefined, suggestion?: string | undefined);
     /** User-friendly message safe to display */
     get userMessage(): string;
 }
 /** Type guard for CimplifyError */
 declare function isCimplifyError(error: unknown): error is CimplifyError;
+declare function getErrorHint(code: string): ErrorHint | undefined;
+declare function enrichError(error: CimplifyError, options?: {
+    isTestMode?: boolean;
+}): CimplifyError;
 /** Check if error is retryable */
 declare function isRetryableError(error: unknown): boolean;
 
@@ -110,7 +136,7 @@ interface Payment {
     order_id: string;
     business_id: string;
     amount: Money;
-    currency: Currency;
+    currency: CurrencyCode;
     payment_method: PaymentMethod;
     status: PaymentStatus;
     provider: PaymentProvider;
@@ -151,7 +177,7 @@ interface PaymentStatusResponse {
     status: PaymentStatus;
     paid: boolean;
     amount?: Money;
-    currency?: string;
+    currency?: CurrencyCode;
     reference?: string;
     message?: string;
 }
@@ -167,4 +193,4 @@ interface SubmitAuthorizationInput {
     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 };
+export { type ApiError as A, type CurrencyCode as C, ErrorCode as E, type InitializePaymentResult as I, type Money as M, type PaginationParams as P, type SubmitAuthorizationInput as S, ZERO as Z, moneyFromNumber as a, type Currency as b, currencyCode as c, type Pagination as d, type ErrorCodeType as e, type ErrorHint as f, ERROR_HINTS as g, CimplifyError as h, isCimplifyError as i, getErrorHint as j, enrichError as k, isRetryableError as l, money as m, type PaymentStatus as n, type PaymentProvider as o, type PaymentMethodType as p, type AuthorizationType as q, type PaymentProcessingState as r, type PaymentMethod as s, type Payment as t, type PaymentResponse as u, type PaymentStatusResponse as v, type PaymentErrorDetails as w };

package/dist/react.d.mts

@@ -1,8 +1,8 @@
-import { C as CimplifyClient, _ as ProcessCheckoutResult, a0 as CheckoutStatus, a1 as CheckoutStatusContext, cT as Location, cQ as Business, u as CimplifyElements, y as ElementsOptions, eh as AuthenticatedData, ed as AddressInfo, ee as PaymentMethodInfo, ej as ElementsCheckoutResult, Z as ProcessCheckoutOptions } from './client-CUFdFugo.mjs';
+import { C as CimplifyClient, _ as ProcessCheckoutResult, a0 as CheckoutStatus, a1 as CheckoutStatusContext, cT as Location, cQ as Business, aL as Product, aM as ProductWithDetails, a_ as Category, bH as BundleSelectionInput, bi as ComponentSelectionInput, cj as Order, b0 as Collection, b7 as BundleWithDetails, be as CompositeWithDetails, bj as CompositePriceResult, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, P as PriceQuote, g as QuoteUiMessage, u as CimplifyElements, y as ElementsOptions, eh as AuthenticatedData, ed as AddressInfo, ee as PaymentMethodInfo, ej as ElementsCheckoutResult, Z as ProcessCheckoutOptions } from './client-FQUyv41r.mjs';
 import React, { ReactNode } from 'react';
+import { h as CimplifyError, C as CurrencyCode } from './payment-Cu75tmUc.mjs';
 import { A as AdSlot, a as AdPosition, e as AdContextValue } from './ads-t3FBTU8p.mjs';
 export { c as AdConfig } from './ads-t3FBTU8p.mjs';
-import './payment-D-u3asA8.mjs';
 
 interface UserIdentity {
     uid: string;
@@ -94,6 +94,227 @@ interface CimplifyProviderProps {
 }
 declare function CimplifyProvider({ client, children, onLocationChange, }: CimplifyProviderProps): React.ReactElement;
 declare function useCimplify(): CimplifyContextValue;
+declare function useOptionalCimplify(): CimplifyContextValue | null;
+
+interface UseProductsOptions {
+    category?: string;
+    collection?: string;
+    search?: string;
+    featured?: boolean;
+    limit?: number;
+    enabled?: boolean;
+    client?: CimplifyClient;
+}
+interface UseProductsResult {
+    products: Product[];
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useProducts(options?: UseProductsOptions): UseProductsResult;
+
+interface UseProductOptions {
+    enabled?: boolean;
+    client?: CimplifyClient;
+}
+interface UseProductResult {
+    product: ProductWithDetails | null;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useProduct(slugOrId: string | null | undefined, options?: UseProductOptions): UseProductResult;
+
+interface UseCategoriesOptions {
+    enabled?: boolean;
+    client?: CimplifyClient;
+}
+interface UseCategoriesResult {
+    categories: Category[];
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useCategories(options?: UseCategoriesOptions): UseCategoriesResult;
+
+interface CartVariantSelection {
+    id: string;
+    name: string;
+    price_adjustment?: string;
+}
+interface CartAddOnOptionSelection {
+    id: string;
+    name: string;
+    add_on_id?: string;
+    default_price?: string;
+}
+interface UseCartItem {
+    id: string;
+    product: Product;
+    quantity: number;
+    locationId?: string;
+    variantId?: string;
+    variant?: CartVariantSelection;
+    quoteId?: string;
+    addOnOptionIds?: string[];
+    addOnOptions?: CartAddOnOptionSelection[];
+    bundleSelections?: BundleSelectionInput[];
+    compositeSelections?: ComponentSelectionInput[];
+    specialInstructions?: string;
+}
+interface AddToCartOptions {
+    locationId?: string;
+    variantId?: string;
+    variant?: CartVariantSelection;
+    quoteId?: string;
+    addOnOptionIds?: string[];
+    addOnOptions?: CartAddOnOptionSelection[];
+    bundleSelections?: BundleSelectionInput[];
+    compositeSelections?: ComponentSelectionInput[];
+    specialInstructions?: string;
+}
+interface UseCartOptions {
+    client?: CimplifyClient;
+    demoMode?: boolean;
+    locationId?: string;
+    currency?: string;
+}
+interface UseCartResult {
+    items: UseCartItem[];
+    itemCount: number;
+    subtotal: number;
+    tax: number;
+    total: number;
+    currency: string;
+    isEmpty: boolean;
+    isLoading: boolean;
+    addItem: (product: Product, quantity?: number, options?: AddToCartOptions) => Promise<void>;
+    removeItem: (itemId: string) => Promise<void>;
+    updateQuantity: (itemId: string, quantity: number) => Promise<void>;
+    clearCart: () => Promise<void>;
+    sync: () => Promise<void>;
+}
+declare function useCart(options?: UseCartOptions): UseCartResult;
+
+interface UseOrderOptions {
+    poll?: boolean;
+    pollInterval?: number;
+    enabled?: boolean;
+    client?: CimplifyClient;
+}
+interface UseOrderResult {
+    order: Order | null;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useOrder(orderId: string | null | undefined, options?: UseOrderOptions): UseOrderResult;
+
+interface UseLocationsOptions {
+    client?: CimplifyClient;
+}
+interface UseLocationsResult {
+    locations: Location[];
+    currentLocation: Location | null;
+    setCurrentLocation: (location: Location) => void;
+    isLoading: boolean;
+}
+declare function useLocations(options?: UseLocationsOptions): UseLocationsResult;
+
+interface UseCollectionsOptions {
+    client?: CimplifyClient;
+    enabled?: boolean;
+}
+interface UseCollectionsResult {
+    collections: Collection[];
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useCollections(options?: UseCollectionsOptions): UseCollectionsResult;
+
+interface UseCollectionOptions {
+    client?: CimplifyClient;
+    enabled?: boolean;
+}
+interface UseCollectionResult {
+    collection: Collection | null;
+    products: Product[];
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useCollection(idOrSlug: string | null | undefined, options?: UseCollectionOptions): UseCollectionResult;
+
+interface UseBundleOptions {
+    client?: CimplifyClient;
+    enabled?: boolean;
+}
+interface UseBundleResult {
+    bundle: BundleWithDetails | null;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useBundle(idOrSlug: string | null | undefined, options?: UseBundleOptions): UseBundleResult;
+
+interface UseCompositeOptions {
+    client?: CimplifyClient;
+    enabled?: boolean;
+    byProductId?: boolean;
+}
+interface UseCompositeResult {
+    composite: CompositeWithDetails | null;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+    calculatePrice: (selections: ComponentSelectionInput[], locationId?: string) => Promise<CompositePriceResult | null>;
+    priceResult: CompositePriceResult | null;
+    isPriceLoading: boolean;
+}
+declare function useComposite(idOrProductId: string | null | undefined, options?: UseCompositeOptions): UseCompositeResult;
+
+interface UseSearchOptions {
+    client?: CimplifyClient;
+    minLength?: number;
+    debounceMs?: number;
+    limit?: number;
+    category?: string;
+}
+interface UseSearchResult {
+    results: Product[];
+    isLoading: boolean;
+    error: CimplifyError | null;
+    query: string;
+    setQuery: (query: string) => void;
+    clear: () => void;
+}
+declare function useSearch(options?: UseSearchOptions): UseSearchResult;
+
+interface UseQuoteOptions {
+    client?: CimplifyClient;
+    enabled?: boolean;
+    autoRefresh?: boolean;
+    refreshBeforeExpiryMs?: number;
+}
+interface UseQuoteInput {
+    productId: string;
+    variantId?: string;
+    locationId?: string;
+    quantity?: number;
+    addOnOptionIds?: string[];
+    bundleSelections?: QuoteBundleSelectionInput[];
+    compositeSelections?: QuoteCompositeSelectionInput[];
+}
+interface UseQuoteResult {
+    quote: PriceQuote | null;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refresh: () => Promise<void>;
+    isExpired: boolean;
+    messages: QuoteUiMessage[];
+}
+declare function useQuote(input: UseQuoteInput | null | undefined, options?: UseQuoteOptions): UseQuoteResult;
 
 declare function useElements(): CimplifyElements | null;
 declare function useElementsReady(): boolean;
@@ -131,7 +352,7 @@ interface AddressElementProps extends BaseElementProps {
 declare function AddressElement({ className, style, mode, onReady, onChange, onError, }: AddressElementProps): React.ReactElement | null;
 interface PaymentElementProps extends BaseElementProps {
     amount?: number;
-    currency?: string;
+    currency?: CurrencyCode;
     onChange?: (data: {
         paymentMethod: PaymentMethodInfo;
         saveToLink: boolean;
@@ -151,4 +372,4 @@ declare function useCheckout(): {
     isLoading: boolean;
 };
 
-export { Ad, AdPosition, type AdProps, AdProvider, AdSlot, AddressElement, AuthElement, CimplifyCheckout, type CimplifyCheckoutProps, type CimplifyContextValue, CimplifyProvider, type CimplifyProviderProps, ElementsProvider, PaymentElement, useAds, useCheckout, useCimplify, useElements, useElementsReady };
+export { Ad, AdPosition, type AdProps, AdProvider, AdSlot, type AddToCartOptions, AddressElement, AuthElement, CimplifyCheckout, type CimplifyCheckoutProps, type CimplifyContextValue, CimplifyProvider, type CimplifyProviderProps, ElementsProvider, PaymentElement, type UseBundleOptions, type UseBundleResult, type UseCartItem, type UseCartOptions, type UseCartResult, type UseCategoriesOptions, type UseCategoriesResult, type UseCollectionOptions, type UseCollectionResult, type UseCollectionsOptions, type UseCollectionsResult, type UseCompositeOptions, type UseCompositeResult, type UseLocationsOptions, type UseLocationsResult, type UseOrderOptions, type UseOrderResult, type UseProductOptions, type UseProductResult, type UseProductsOptions, type UseProductsResult, type UseQuoteInput, type UseQuoteOptions, type UseQuoteResult, type UseSearchOptions, type UseSearchResult, useAds, useBundle, useCart, useCategories, useCheckout, useCimplify, useCollection, useCollections, useComposite, useElements, useElementsReady, useLocations, useOptionalCimplify, useOrder, useProduct, useProducts, useQuote, useSearch };

package/dist/react.d.ts

@@ -1,8 +1,8 @@
-import { C as CimplifyClient, _ as ProcessCheckoutResult, a0 as CheckoutStatus, a1 as CheckoutStatusContext, cT as Location, cQ as Business, u as CimplifyElements, y as ElementsOptions, eh as AuthenticatedData, ed as AddressInfo, ee as PaymentMethodInfo, ej as ElementsCheckoutResult, Z as ProcessCheckoutOptions } from './client-CjqNbEM6.js';
+import { C as CimplifyClient, _ as ProcessCheckoutResult, a0 as CheckoutStatus, a1 as CheckoutStatusContext, cT as Location, cQ as Business, aL as Product, aM as ProductWithDetails, a_ as Category, bH as BundleSelectionInput, bi as ComponentSelectionInput, cj as Order, b0 as Collection, b7 as BundleWithDetails, be as CompositeWithDetails, bj as CompositePriceResult, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, P as PriceQuote, g as QuoteUiMessage, u as CimplifyElements, y as ElementsOptions, eh as AuthenticatedData, ed as AddressInfo, ee as PaymentMethodInfo, ej as ElementsCheckoutResult, Z as ProcessCheckoutOptions } from './client-D4vA6FY_.js';
 import React, { ReactNode } from 'react';
+import { h as CimplifyError, C as CurrencyCode } from './payment-Cu75tmUc.js';
 import { A as AdSlot, a as AdPosition, e as AdContextValue } from './ads-t3FBTU8p.js';
 export { c as AdConfig } from './ads-t3FBTU8p.js';
-import './payment-D-u3asA8.js';
 
 interface UserIdentity {
     uid: string;
@@ -94,6 +94,227 @@ interface CimplifyProviderProps {
 }
 declare function CimplifyProvider({ client, children, onLocationChange, }: CimplifyProviderProps): React.ReactElement;
 declare function useCimplify(): CimplifyContextValue;
+declare function useOptionalCimplify(): CimplifyContextValue | null;
+
+interface UseProductsOptions {
+    category?: string;
+    collection?: string;
+    search?: string;
+    featured?: boolean;
+    limit?: number;
+    enabled?: boolean;
+    client?: CimplifyClient;
+}
+interface UseProductsResult {
+    products: Product[];
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useProducts(options?: UseProductsOptions): UseProductsResult;
+
+interface UseProductOptions {
+    enabled?: boolean;
+    client?: CimplifyClient;
+}
+interface UseProductResult {
+    product: ProductWithDetails | null;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useProduct(slugOrId: string | null | undefined, options?: UseProductOptions): UseProductResult;
+
+interface UseCategoriesOptions {
+    enabled?: boolean;
+    client?: CimplifyClient;
+}
+interface UseCategoriesResult {
+    categories: Category[];
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useCategories(options?: UseCategoriesOptions): UseCategoriesResult;
+
+interface CartVariantSelection {
+    id: string;
+    name: string;
+    price_adjustment?: string;
+}
+interface CartAddOnOptionSelection {
+    id: string;
+    name: string;
+    add_on_id?: string;
+    default_price?: string;
+}
+interface UseCartItem {
+    id: string;
+    product: Product;
+    quantity: number;
+    locationId?: string;
+    variantId?: string;
+    variant?: CartVariantSelection;
+    quoteId?: string;
+    addOnOptionIds?: string[];
+    addOnOptions?: CartAddOnOptionSelection[];
+    bundleSelections?: BundleSelectionInput[];
+    compositeSelections?: ComponentSelectionInput[];
+    specialInstructions?: string;
+}
+interface AddToCartOptions {
+    locationId?: string;
+    variantId?: string;
+    variant?: CartVariantSelection;
+    quoteId?: string;
+    addOnOptionIds?: string[];
+    addOnOptions?: CartAddOnOptionSelection[];
+    bundleSelections?: BundleSelectionInput[];
+    compositeSelections?: ComponentSelectionInput[];
+    specialInstructions?: string;
+}
+interface UseCartOptions {
+    client?: CimplifyClient;
+    demoMode?: boolean;
+    locationId?: string;
+    currency?: string;
+}
+interface UseCartResult {
+    items: UseCartItem[];
+    itemCount: number;
+    subtotal: number;
+    tax: number;
+    total: number;
+    currency: string;
+    isEmpty: boolean;
+    isLoading: boolean;
+    addItem: (product: Product, quantity?: number, options?: AddToCartOptions) => Promise<void>;
+    removeItem: (itemId: string) => Promise<void>;
+    updateQuantity: (itemId: string, quantity: number) => Promise<void>;
+    clearCart: () => Promise<void>;
+    sync: () => Promise<void>;
+}
+declare function useCart(options?: UseCartOptions): UseCartResult;
+
+interface UseOrderOptions {
+    poll?: boolean;
+    pollInterval?: number;
+    enabled?: boolean;
+    client?: CimplifyClient;
+}
+interface UseOrderResult {
+    order: Order | null;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useOrder(orderId: string | null | undefined, options?: UseOrderOptions): UseOrderResult;
+
+interface UseLocationsOptions {
+    client?: CimplifyClient;
+}
+interface UseLocationsResult {
+    locations: Location[];
+    currentLocation: Location | null;
+    setCurrentLocation: (location: Location) => void;
+    isLoading: boolean;
+}
+declare function useLocations(options?: UseLocationsOptions): UseLocationsResult;
+
+interface UseCollectionsOptions {
+    client?: CimplifyClient;
+    enabled?: boolean;
+}
+interface UseCollectionsResult {
+    collections: Collection[];
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useCollections(options?: UseCollectionsOptions): UseCollectionsResult;
+
+interface UseCollectionOptions {
+    client?: CimplifyClient;
+    enabled?: boolean;
+}
+interface UseCollectionResult {
+    collection: Collection | null;
+    products: Product[];
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useCollection(idOrSlug: string | null | undefined, options?: UseCollectionOptions): UseCollectionResult;
+
+interface UseBundleOptions {
+    client?: CimplifyClient;
+    enabled?: boolean;
+}
+interface UseBundleResult {
+    bundle: BundleWithDetails | null;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useBundle(idOrSlug: string | null | undefined, options?: UseBundleOptions): UseBundleResult;
+
+interface UseCompositeOptions {
+    client?: CimplifyClient;
+    enabled?: boolean;
+    byProductId?: boolean;
+}
+interface UseCompositeResult {
+    composite: CompositeWithDetails | null;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+    calculatePrice: (selections: ComponentSelectionInput[], locationId?: string) => Promise<CompositePriceResult | null>;
+    priceResult: CompositePriceResult | null;
+    isPriceLoading: boolean;
+}
+declare function useComposite(idOrProductId: string | null | undefined, options?: UseCompositeOptions): UseCompositeResult;
+
+interface UseSearchOptions {
+    client?: CimplifyClient;
+    minLength?: number;
+    debounceMs?: number;
+    limit?: number;
+    category?: string;
+}
+interface UseSearchResult {
+    results: Product[];
+    isLoading: boolean;
+    error: CimplifyError | null;
+    query: string;
+    setQuery: (query: string) => void;
+    clear: () => void;
+}
+declare function useSearch(options?: UseSearchOptions): UseSearchResult;
+
+interface UseQuoteOptions {
+    client?: CimplifyClient;
+    enabled?: boolean;
+    autoRefresh?: boolean;
+    refreshBeforeExpiryMs?: number;
+}
+interface UseQuoteInput {
+    productId: string;
+    variantId?: string;
+    locationId?: string;
+    quantity?: number;
+    addOnOptionIds?: string[];
+    bundleSelections?: QuoteBundleSelectionInput[];
+    compositeSelections?: QuoteCompositeSelectionInput[];
+}
+interface UseQuoteResult {
+    quote: PriceQuote | null;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refresh: () => Promise<void>;
+    isExpired: boolean;
+    messages: QuoteUiMessage[];
+}
+declare function useQuote(input: UseQuoteInput | null | undefined, options?: UseQuoteOptions): UseQuoteResult;
 
 declare function useElements(): CimplifyElements | null;
 declare function useElementsReady(): boolean;
@@ -131,7 +352,7 @@ interface AddressElementProps extends BaseElementProps {
 declare function AddressElement({ className, style, mode, onReady, onChange, onError, }: AddressElementProps): React.ReactElement | null;
 interface PaymentElementProps extends BaseElementProps {
     amount?: number;
-    currency?: string;
+    currency?: CurrencyCode;
     onChange?: (data: {
         paymentMethod: PaymentMethodInfo;
         saveToLink: boolean;
@@ -151,4 +372,4 @@ declare function useCheckout(): {
     isLoading: boolean;
 };
 
-export { Ad, AdPosition, type AdProps, AdProvider, AdSlot, AddressElement, AuthElement, CimplifyCheckout, type CimplifyCheckoutProps, type CimplifyContextValue, CimplifyProvider, type CimplifyProviderProps, ElementsProvider, PaymentElement, useAds, useCheckout, useCimplify, useElements, useElementsReady };
+export { Ad, AdPosition, type AdProps, AdProvider, AdSlot, type AddToCartOptions, AddressElement, AuthElement, CimplifyCheckout, type CimplifyCheckoutProps, type CimplifyContextValue, CimplifyProvider, type CimplifyProviderProps, ElementsProvider, PaymentElement, type UseBundleOptions, type UseBundleResult, type UseCartItem, type UseCartOptions, type UseCartResult, type UseCategoriesOptions, type UseCategoriesResult, type UseCollectionOptions, type UseCollectionResult, type UseCollectionsOptions, type UseCollectionsResult, type UseCompositeOptions, type UseCompositeResult, type UseLocationsOptions, type UseLocationsResult, type UseOrderOptions, type UseOrderResult, type UseProductOptions, type UseProductResult, type UseProductsOptions, type UseProductsResult, type UseQuoteInput, type UseQuoteOptions, type UseQuoteResult, type UseSearchOptions, type UseSearchResult, useAds, useBundle, useCart, useCategories, useCheckout, useCimplify, useCollection, useCollections, useComposite, useElements, useElementsReady, useLocations, useOptionalCimplify, useOrder, useProduct, useProducts, useQuote, useSearch };