@shoppexio/storefront 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,901 @@
+import { NavigationMenuSlot } from '@shoppex/contracts/navigation';
+export { NavigationMenuSlot } from '@shoppex/contracts/navigation';
+
+/**
+ * SDK Configuration Types
+ */
+interface ShoppexConfig {
+    storeSlug: string;
+    locale?: string;
+    currency?: string;
+    apiBaseUrl?: string;
+    checkoutBaseUrl?: string;
+}
+interface ShoppexInitOptions {
+    locale?: string;
+    currency?: string;
+    apiBaseUrl?: string;
+    checkoutBaseUrl?: string;
+}
+
+/**
+ * API Response Types
+ *
+ * Backend returns: { status: number, data: T, error: string | null }
+ * SDK maps to: { success: boolean, data?: T, message?: string }
+ */
+interface ApiResponse<T> {
+    status: number;
+    data: T;
+    error: string | null;
+}
+interface SDKResponse<T> {
+    success: boolean;
+    data?: T;
+    message?: string;
+}
+interface Shop {
+    id: string;
+    name: string;
+    slug: string;
+    domain?: string;
+    description?: string;
+    title?: string;
+    message?: string;
+    url?: string;
+    logo?: string;
+    banner?: string;
+    avatar?: string;
+    average_score?: number | null;
+    rating?: number | null;
+    products_sold_count?: number;
+    hide_products_sold?: boolean;
+    currency: string;
+    tos_enabled?: boolean;
+    dark_mode?: boolean;
+    search_enabled?: boolean;
+    sort_enabled?: boolean;
+    cart_enabled?: boolean;
+    hide_out_of_stock?: boolean;
+    hide_stock_counter?: boolean;
+    center_product_titles?: boolean;
+    center_group_titles?: boolean;
+    default_sort?: string;
+    social?: Record<string, string | null>;
+    discord_link?: string | null;
+    twitter_link?: string | null;
+    instagram_link?: string | null;
+    facebook_link?: string | null;
+    telegram_link?: string | null;
+    youtube_link?: string | null;
+    reddit_link?: string | null;
+    tiktok_link?: string | null;
+    verified?: boolean;
+    on_hold?: boolean;
+    theme?: ShopTheme | null;
+    builder_settings?: Record<string, unknown> | null;
+    feedback?: ShopFeedback;
+    trusted_checks?: TrustedChecks | null;
+}
+interface ShopTheme {
+    primary_color?: string;
+    secondary_color?: string;
+    font?: string;
+    logo?: string | null;
+    logo_cloudflare_image_id?: string | null;
+    background_image?: string | null;
+    background_image_cloudflare_image_id?: string | null;
+    cards_in_row?: number | string;
+    cards_align?: string;
+    card_animation?: string;
+    dark_color?: string;
+    light_color?: string;
+    border_color?: string;
+    button_color?: string;
+}
+interface ShopFeedback {
+    positive: number;
+    neutral: number;
+    negative: number;
+    total: number;
+}
+interface TrustedChecks {
+    identity_verified?: boolean;
+    feedback_score?: string | null;
+    trusted_score?: number;
+    sales_last14days_metric?: string;
+}
+interface ProductCategory {
+    uniqid: string;
+    title: string;
+    description?: string | null;
+    image_attachment?: string | null;
+    image_name?: string | null;
+    image_storage?: string | null;
+    cloudflare_image_id?: string | null;
+    cdn_image_url?: string | null;
+}
+interface Product {
+    id?: string;
+    uniqid: string;
+    title: string;
+    slug?: string | null;
+    description?: string | null;
+    product_highlights?: string[];
+    price: string;
+    price_display?: string;
+    price_discount?: number;
+    currency: string;
+    stock?: number;
+    quantity_min?: number;
+    quantity_max?: number;
+    min_quantity?: number;
+    max_quantity?: number;
+    on_hold?: boolean | number;
+    unlisted?: boolean | number;
+    private?: boolean | number;
+    bestseller?: boolean | number;
+    type?: string;
+    subtype?: string | null;
+    isSubscription?: boolean;
+    isGroup?: boolean;
+    images: ProductImage[];
+    image_name?: string | null;
+    image_storage?: string | null;
+    cloudflare_image_id?: string | null;
+    image_attachment?: string | null;
+    sold_count?: number;
+    soldCount?: number;
+    image_attachments?: unknown[];
+    file_attachments?: unknown[];
+    variants?: ProductVariant[];
+    addons?: ProductAddon[];
+    price_variants?: PriceVariant[];
+    volume_discounts?: unknown;
+    custom_fields?: string | unknown[] | null;
+    categories?: ProductCategory[];
+    bundles?: ProductBundle[];
+    faqs?: ProductFaq[];
+    subscription?: Subscription;
+    feedbacks?: Feedback[];
+    feedback?: ProductFeedback;
+    cdn_image_url?: string;
+    recurring_interval?: string | null;
+    recurring_interval_count?: number | null;
+    trial_period?: number | null;
+    setup_cost?: string;
+    licensing_enabled?: boolean | number;
+    license_period?: number | null;
+    gateways?: string;
+    delivery_text?: string;
+    service_text?: string;
+    terms_of_service?: string | null;
+    warranty?: number;
+    warranty_text?: string | null;
+    sort_priority?: number;
+    price_conversions?: Record<string, number>;
+    pay_what_you_want?: boolean | number;
+    cost?: string | null;
+    cost_display?: string | null;
+}
+interface ProductFeedback {
+    total: number;
+    positive: number;
+    neutral: number;
+    negative: number;
+    numbers?: Record<number, number>;
+    list?: Array<{
+        score: number;
+        message: string | null;
+        reply: string | null;
+        created_at: string | null;
+        updated_at: string | null;
+    }>;
+}
+interface ProductImage {
+    id: string;
+    url: string;
+    cloudflare_image_id?: string;
+    alt?: string;
+}
+interface ProductVariant {
+    id: string;
+    title: string;
+    price?: number;
+    stock?: number;
+}
+interface ProductAddon {
+    id: string;
+    name?: string;
+    title?: string;
+    price: number;
+    required?: boolean;
+}
+interface PriceVariant {
+    id: string;
+    label?: string;
+    title?: string;
+    price: number;
+}
+interface CustomFieldDefinition {
+    id: string;
+    name: string;
+    type: 'text' | 'textarea' | 'select' | 'checkbox';
+    required?: boolean;
+    options?: string[];
+}
+interface Feedback {
+    id: string;
+    rating: number;
+    author?: string;
+    comment?: string;
+    is_automated?: boolean;
+    created_at: string;
+}
+interface ProductBundle {
+    id?: string;
+    uniqid?: string;
+    title?: string;
+    discount_type?: 'PERCENTAGE' | 'FIXED';
+    discount_amount?: number;
+    products?: Product[];
+}
+interface ProductFaq {
+    id?: string;
+    uniqid?: string;
+    question: string;
+    answer: string;
+}
+interface SubscriptionInterval {
+    unit?: string;
+    count?: number;
+    label?: string;
+}
+interface SubscriptionFlags {
+    cancel_anytime?: boolean;
+}
+interface Subscription {
+    id?: string;
+    name?: string;
+    description?: string;
+    badge?: string;
+    interval?: SubscriptionInterval;
+    flags?: SubscriptionFlags;
+}
+interface Invoice {
+    uniqid: string;
+    status: string;
+    total: number;
+    currency: string;
+    gateway?: string;
+    products: InvoiceProduct[];
+    created_at: string;
+}
+interface InvoiceProduct {
+    product_id: string;
+    title: string;
+    quantity: number;
+    price: number;
+}
+interface CouponValidation {
+    valid: boolean;
+    discount?: number;
+    discount_type?: 'percentage' | 'fixed';
+    message?: string;
+}
+interface ProductGroup {
+    id?: string;
+    uniqid: string;
+    category_id?: string | null;
+    slug?: string | null;
+    name?: string | null;
+    title: string;
+    description?: string | null;
+    products_bound?: Product[];
+    products_count?: number;
+    image_attachment?: string | null;
+    image_name?: string | null;
+    image_storage?: string | null;
+    cloudflare_image_id?: string | null;
+    cdn_image_url?: string | null;
+    sort_priority?: number | null;
+}
+interface Category {
+    uniqid: string;
+    title: string;
+    description?: string | null;
+    image_attachment?: string | null;
+    image_name?: string | null;
+    image_storage?: string | null;
+    cloudflare_image_id?: string | null;
+    cdn_image_url?: string | null;
+    products_bound?: Product[];
+    products_count?: number;
+    groups_bound?: ProductGroup[];
+    groups_count?: number;
+}
+interface StorefrontAnnouncementBarAddon {
+    id: string;
+    type: 'announcement_bar';
+    slot: string;
+    component: 'announcement_bar';
+    sort_order: number;
+    props: {
+        addon_id: string;
+        text: string;
+        link_label?: string | null;
+        link_url?: string | null;
+        dismissible: boolean;
+        display_mode: 'static' | 'marquee';
+        theme_preset: 'brand_blue' | 'emerald' | 'sunset' | 'rose' | 'charcoal' | 'custom';
+        animation_speed_seconds: number;
+        background_color: string;
+        text_color: string;
+    };
+}
+interface StorefrontCountdownBarAddon {
+    id: string;
+    type: 'countdown_bar';
+    slot: string;
+    component: 'countdown_bar';
+    sort_order: number;
+    props: {
+        addon_id: string;
+        text: string;
+        end_at: string;
+        link_label?: string | null;
+        link_url?: string | null;
+        dismissible: boolean;
+        theme_preset: 'brand_blue' | 'emerald' | 'sunset' | 'rose' | 'charcoal' | 'custom';
+        expired_behavior: 'hide' | 'message';
+        expired_message?: string | null;
+        density: 'compact' | 'comfortable';
+        cta_style: 'subtle' | 'outline' | 'solid';
+        timer_style: 'minimal' | 'boxed';
+        background_color: string;
+        text_color: string;
+    };
+}
+interface StorefrontPromoInfoCardAddon {
+    id: string;
+    type: 'promo_info_card';
+    slot: string;
+    component: 'promo_info_card';
+    sort_order: number;
+    props: {
+        addon_id: string;
+        eyebrow?: string | null;
+        title: string;
+        body: string;
+        link_label?: string | null;
+        link_url?: string | null;
+        theme_preset: 'indigo' | 'emerald' | 'amber' | 'rose' | 'slate' | 'custom';
+        layout_style: 'compact' | 'feature' | 'alert';
+        density: 'compact' | 'comfortable';
+        cta_style: 'subtle' | 'outline' | 'solid';
+        icon: 'sparkles' | 'megaphone' | 'gift' | 'truck' | 'shield' | 'support' | 'none';
+        icon_visibility: 'show' | 'hide';
+        background_color: string;
+        text_color: string;
+        accent_color: string;
+    };
+}
+interface StorefrontRecentPurchasePopupAddon {
+    id: string;
+    type: 'recent_purchase_popup';
+    slot: string;
+    component: 'recent_purchase_popup';
+    sort_order: number;
+    props: {
+        addon_id: string;
+        title: string;
+        cooldown_seconds: number;
+        items: Array<{
+            customer_label: string;
+            product_title: string;
+            created_at: string;
+        }>;
+    };
+}
+interface StorefrontCouponPopupModalAddon {
+    id: string;
+    type: 'coupon_popup_modal';
+    slot: string;
+    component: 'coupon_popup_modal';
+    sort_order: number;
+    props: {
+        addon_id: string;
+        eyebrow?: string | null;
+        title: string;
+        body: string;
+        coupon_code: string;
+        primary_button_label: string;
+        secondary_button_label: string;
+        disclaimer?: string | null;
+        theme_preset: 'midnight' | 'ocean' | 'ember' | 'forest' | 'custom';
+        trigger: 'delay' | 'exit_intent';
+        delay_seconds: number;
+        show_once_per_session: boolean;
+        reminder_hours: number;
+        background_color: string;
+        text_color: string;
+        accent_color: string;
+    };
+}
+type StorefrontAddon = StorefrontAnnouncementBarAddon | StorefrontCountdownBarAddon | StorefrontPromoInfoCardAddon | StorefrontRecentPurchasePopupAddon | StorefrontCouponPopupModalAddon;
+interface StorefrontAddonBootstrap {
+    items: StorefrontAddon[];
+}
+type StorefrontItem = (Product & {
+    item_type: 'PRODUCT';
+}) | (ProductGroup & {
+    item_type: 'GROUP';
+});
+interface StorefrontData {
+    shop: Shop;
+    products: Product[];
+    groups: ProductGroup[];
+    items: StorefrontItem[];
+    categories: Category[];
+    addons: StorefrontAddonBootstrap;
+}
+interface Page {
+    id: string;
+    shop_id?: string;
+    slug: string;
+    name: string;
+    content: string | null;
+    template_type: string;
+    is_system: boolean;
+    settings: Record<string, unknown> | null;
+    visible_after: string | null;
+    created_at: number;
+    updated_at: number;
+}
+interface Menu {
+    id: string;
+    shop_id: string;
+    title: string;
+    slot?: NavigationMenuSlot | null;
+    items?: MenuItem[];
+    created_at: number;
+    updated_at: number;
+}
+interface MenuItem {
+    id: string;
+    shop_id?: string;
+    menu_id: string;
+    page_id: string | null;
+    title: string;
+    url?: string | null;
+    link_type?: 'link' | 'page';
+    target?: '_self' | '_blank' | null;
+    sort_order: number;
+    page_slug: string | null;
+    created_at: number;
+    updated_at: number;
+}
+
+/**
+ * Cart Types
+ *
+ * Extended cart schema supporting Shoppex features:
+ * - Addons (express shipping, gift wrap, etc.)
+ * - Custom Fields (engraving, gift message, etc.)
+ * - Price Variants (different pricing tiers)
+ *
+ * All fields use snake_case to match API conventions.
+ */
+interface CartAddon {
+    id: string;
+    quantity?: number;
+}
+interface CartItem {
+    product_id: string;
+    variant_id: string;
+    quantity: number;
+    addons?: CartAddon[];
+    custom_fields?: Record<string, string>;
+    price_variant_id?: string;
+    price_data?: {
+        unit_price: number;
+    };
+}
+interface CartAddOptions {
+    addons?: CartAddon[];
+    custom_fields?: Record<string, string>;
+    price_variant_id?: string;
+    price_data?: {
+        unit_price: number;
+    };
+}
+interface CartPayload {
+    store_slug: string;
+    items: CartItem[];
+    coupon?: string;
+}
+interface CartMetadata {
+    created_at: number;
+    last_modified: number;
+    version: number;
+    checksum: string;
+}
+interface CartStats {
+    item_count: number;
+    total_quantity: number;
+    last_modified: number;
+    version: number;
+    has_backup: boolean;
+    integrity_valid: boolean;
+    total_price: number;
+    total_price_is_estimate: boolean;
+}
+
+/**
+ * SDK Configuration Management
+ */
+
+declare function getConfig(): ShoppexConfig;
+declare function isInitialized(): boolean;
+
+/**
+ * SDK Error Classes
+ */
+declare class ShoppexError extends Error {
+    readonly code: string;
+    readonly statusCode?: number;
+    constructor(message: string, code: string, statusCode?: number);
+}
+declare class NotInitializedError extends ShoppexError {
+    constructor();
+}
+declare class NetworkError extends ShoppexError {
+    constructor(message: string, statusCode?: number);
+}
+declare class ValidationError extends ShoppexError {
+    readonly invalidFields?: string[];
+    constructor(message: string, invalidFields?: string[]);
+}
+declare class CartError extends ShoppexError {
+    constructor(message: string);
+}
+
+/**
+ * Theme configuration types (framework agnostic)
+ */
+type SettingFieldType = 'color' | 'text' | 'range' | 'select' | 'boolean' | 'image' | 'font' | 'richtext' | 'products' | 'images';
+interface BaseSettingField {
+    type: SettingFieldType;
+    label: string;
+    description?: string;
+}
+interface ColorField extends BaseSettingField {
+    type: 'color';
+    default: string;
+}
+interface RangeField extends BaseSettingField {
+    type: 'range';
+    default: number;
+    min: number;
+    max: number;
+    step?: number;
+    unit?: string;
+}
+interface SelectField extends BaseSettingField {
+    type: 'select';
+    default: string;
+    options: string[] | {
+        value: string;
+        label: string;
+    }[];
+}
+interface BooleanField extends BaseSettingField {
+    type: 'boolean';
+    default: boolean;
+}
+interface TextField extends BaseSettingField {
+    type: 'text';
+    default: string;
+}
+interface ImageField extends BaseSettingField {
+    type: 'image';
+    default: string | null;
+}
+interface FontField extends BaseSettingField {
+    type: 'font';
+    default: string;
+    options?: string[];
+}
+interface RichtextField extends BaseSettingField {
+    type: 'richtext';
+    default: string;
+}
+interface ProductsField extends BaseSettingField {
+    type: 'products';
+    default: string[];
+    max?: number;
+}
+interface ImagesField extends BaseSettingField {
+    type: 'images';
+    default: string[];
+    max?: number;
+}
+type SettingField = ColorField | RangeField | SelectField | BooleanField | TextField | ImageField | FontField | RichtextField | ProductsField | ImagesField;
+interface SectionDefinition {
+    name: string;
+    description?: string;
+    icon?: string;
+    settings: Record<string, SettingField>;
+}
+interface ThemeConfig {
+    id: string;
+    name: string;
+    description?: string;
+    version: string;
+    author?: string;
+    preview?: string;
+    settings: Record<string, Record<string, SettingField>>;
+    sections: Record<string, SectionDefinition>;
+}
+type SettingValue = string | number | boolean | null | string[] | Record<string, unknown>;
+type ResolvedThemeSettings = {
+    [Category: string]: {
+        [Key: string]: SettingValue;
+    };
+};
+
+/**
+ * Store Module
+ *
+ * API methods for store data.
+ */
+
+declare function getStore(): Promise<SDKResponse<Shop>>;
+declare function resolveStoreByDomain(domain?: string, apiBaseUrl?: string): Promise<SDKResponse<Shop>>;
+declare function getStorefront(): Promise<SDKResponse<StorefrontData>>;
+declare function getStoreLogoUrl(): Promise<string | null>;
+declare function getStoreBannerUrl(): Promise<string | null>;
+
+/**
+ * Products Module
+ *
+ * API methods for product data.
+ */
+
+declare function getProducts(): Promise<SDKResponse<Product[]>>;
+declare function getProduct(idOrSlug: string): Promise<SDKResponse<Product>>;
+declare function getCategories(): Promise<SDKResponse<string[]>>;
+
+/**
+ * Cart Module
+ *
+ * localStorage-based cart with support for Shoppex features:
+ * - Addons (express shipping, gift wrap, etc.)
+ * - Custom Fields (engraving, gift message, etc.)
+ * - Price Variants (different pricing tiers)
+ */
+
+declare function getCart(): CartItem[];
+declare function getCartItemCount(): number;
+declare function addToCart(productId: string, variantId: string, quantity?: number, options?: CartAddOptions): void;
+declare function updateCartItem(productId: string, variantId: string, updates: Partial<Omit<CartItem, 'product_id' | 'variant_id'>>): void;
+declare function removeFromCart(productId: string, variantId: string): void;
+declare function clearCart(): void;
+declare function createCartBackup(): void;
+declare function restoreCartFromBackup(): boolean;
+declare function mergeBaskets(items: CartItem[]): CartItem[];
+declare function moveBasketItem(fromProductId: string, fromVariantId: string, toProductId: string, toVariantId: string): void;
+declare function validateCartIntegrity(): boolean;
+declare function getCartStats(): CartStats;
+
+/**
+ * Checkout Module
+ *
+ * Creates invoice via backend API and redirects to hosted checkout page.
+ * All checkout flows go through: checkout.shoppex.io/invoice/{invoiceId}
+ */
+interface CheckoutOptions {
+    autoRedirect?: boolean;
+    locale?: string;
+    email?: string;
+    coupon?: string;
+    affiliateCode?: string;
+}
+interface CheckoutResult {
+    success: boolean;
+    redirectUrl?: string;
+    invoiceId?: string;
+    message?: string;
+}
+declare function checkout(couponOrOptions?: string | CheckoutOptions, options?: CheckoutOptions): Promise<CheckoutResult>;
+/**
+ * Build checkout URL by creating invoice first.
+ * Returns the checkout URL for the created invoice.
+ */
+declare function buildCheckoutUrl(couponOrOptions?: string | CheckoutOptions, options?: CheckoutOptions): Promise<string>;
+/**
+ * @deprecated Use buildCheckoutUrl instead.
+ * Sync version is no longer supported as invoice creation requires API call.
+ */
+declare function buildCheckoutUrlSync(): never;
+
+declare function clearAffiliateCode(): void;
+declare function getAffiliateCode(): string | null;
+/**
+ * Capture an affiliate code from the current URL and store it for 30 days (last-click).
+ *
+ * Example:
+ * - URL: https://mystore.com/product/abc?ref=deadbeef
+ * - captureAffiliateFromUrl() stores "deadbeef" and returns it.
+ */
+declare function captureAffiliateFromUrl(param?: string): Promise<string | null>;
+
+/**
+ * Coupons Module
+ *
+ * Coupon validation before checkout.
+ */
+
+declare function validateCoupon(code: string, productId?: string): Promise<SDKResponse<CouponValidation>>;
+
+/**
+ * Reviews Module
+ *
+ * Shop-level feedback/reviews.
+ * Note: Shoppex has shop-level feedback, not product-level reviews.
+ */
+
+declare function getShopReviews(): Promise<SDKResponse<Feedback[]>>;
+
+interface SearchOptions {
+    hideOutOfStock?: boolean;
+}
+declare function searchProducts(query: string, options?: SearchOptions): Promise<SDKResponse<Product[]>>;
+
+/**
+ * Invoices Module
+ *
+ * Invoice status checking after payment.
+ */
+
+declare function getInvoice(invoiceId: string): Promise<SDKResponse<Invoice>>;
+declare function getInvoiceStatus(invoiceId: string): Promise<SDKResponse<{
+    status: string;
+}>>;
+
+/**
+ * Pages Module
+ *
+ * API methods for public pages.
+ */
+
+/**
+ * Get all public pages for the store
+ */
+declare function getPages(): Promise<SDKResponse<Page[]>>;
+/**
+ * Get a public page by slug
+ */
+declare function getPage(slug: string): Promise<SDKResponse<Page>>;
+
+/**
+ * Navigation Module
+ *
+ * API methods for menus and navigation.
+ */
+
+/**
+ * Get all menus for the store
+ */
+declare function getMenus(): Promise<SDKResponse<Menu[]>>;
+/**
+ * Get a menu by its exact title.
+ */
+declare function getMenuByTitle(title: string): Promise<SDKResponse<Menu>>;
+/**
+ * Get a menu by canonical slot. The backend resolves legacy menu titles too.
+ */
+declare function getMenuBySlot(slot: NavigationMenuSlot): Promise<SDKResponse<Menu>>;
+declare function getMenuSlotTitles(slot: NavigationMenuSlot): string[];
+
+declare function trackPageView(cartValue?: number, itemCount?: number): Promise<void>;
+
+/**
+ * Formatting Utilities
+ */
+declare function createFormatter(currency?: string, locale?: string): Intl.NumberFormat;
+declare function formatPrice(amount: number | string, currency?: string, locale?: string): string;
+
+interface CacheStats {
+    hits: number;
+    misses: number;
+    pendingRequests: number;
+    entries: number;
+}
+declare function getCacheStats(): CacheStats;
+declare function clearCache(): void;
+declare function invalidateCache(prefixOrKey: string): void;
+
+declare function fetchPublishedThemeSettings(shopSlug: string): Promise<ResolvedThemeSettings | null>;
+declare function resolveDefaults(config: ThemeConfig): ResolvedThemeSettings;
+declare function mergeSettings(defaults: ResolvedThemeSettings, overrides: Partial<ResolvedThemeSettings>): ResolvedThemeSettings;
+
+/**
+ * Shoppex Storefront SDK
+ *
+ * Usage:
+ * ```html
+ * <script src="https://cdn.shoppex.io/sdk/v1/shoppex.min.js"></script>
+ * <script>
+ *   shoppex.init('my-store');
+ *
+ *   shoppex.getStore().then(store => console.log(store));
+ *   shoppex.addToCart('product-id', 'variant-id', 2);
+ *   shoppex.checkout();
+ * </script>
+ * ```
+ */
+
+/**
+ * Initialize the SDK with a store slug
+ */
+declare function init(storeSlug: string, options?: ShoppexInitOptions): void;
+declare function init(options: ShoppexInitOptions & {
+    storeId: string;
+}): void;
+/**
+ * Shoppex SDK instance
+ */
+declare const shoppex: {
+    init: typeof init;
+    isInitialized: typeof isInitialized;
+    getConfig: typeof getConfig;
+    getStore: typeof getStore;
+    getStorefront: typeof getStorefront;
+    getStoreLogoUrl: typeof getStoreLogoUrl;
+    getStoreBannerUrl: typeof getStoreBannerUrl;
+    resolveStoreByDomain: typeof resolveStoreByDomain;
+    getProducts: typeof getProducts;
+    getProduct: typeof getProduct;
+    getCategories: typeof getCategories;
+    getCart: typeof getCart;
+    getCartItemCount: typeof getCartItemCount;
+    addToCart: typeof addToCart;
+    updateCartItem: typeof updateCartItem;
+    removeFromCart: typeof removeFromCart;
+    clearCart: typeof clearCart;
+    createCartBackup: typeof createCartBackup;
+    restoreCartFromBackup: typeof restoreCartFromBackup;
+    mergeBaskets: typeof mergeBaskets;
+    moveBasketItem: typeof moveBasketItem;
+    getCartStats: typeof getCartStats;
+    validateCartIntegrity: typeof validateCartIntegrity;
+    checkout: typeof checkout;
+    buildCheckoutUrl: typeof buildCheckoutUrl;
+    buildCheckoutUrlSync: typeof buildCheckoutUrlSync;
+    captureAffiliateFromUrl: typeof captureAffiliateFromUrl;
+    getAffiliateCode: typeof getAffiliateCode;
+    clearAffiliateCode: typeof clearAffiliateCode;
+    validateCoupon: typeof validateCoupon;
+    getShopReviews: typeof getShopReviews;
+    searchProducts: typeof searchProducts;
+    getInvoice: typeof getInvoice;
+    getInvoiceStatus: typeof getInvoiceStatus;
+    getPages: typeof getPages;
+    getPage: typeof getPage;
+    getMenus: typeof getMenus;
+    getMenuBySlot: typeof getMenuBySlot;
+    getMenuByTitle: typeof getMenuByTitle;
+    getMenuSlotTitles: typeof getMenuSlotTitles;
+    trackPageView: typeof trackPageView;
+    createFormatter: typeof createFormatter;
+    formatPrice: typeof formatPrice;
+    clearCache: typeof clearCache;
+    invalidateCache: typeof invalidateCache;
+    getCacheStats: typeof getCacheStats;
+    fetchPublishedThemeSettings: typeof fetchPublishedThemeSettings;
+    resolveDefaults: typeof resolveDefaults;
+    mergeSettings: typeof mergeSettings;
+};
+
+export { type ApiResponse, type CartAddOptions, type CartAddon, CartError, type CartItem, type CartMetadata, type CartPayload, type CartStats, type Category, type CouponValidation, type CustomFieldDefinition, type Feedback, type Invoice, type InvoiceProduct, type Menu, type MenuItem, NetworkError, NotInitializedError, type Page, type PriceVariant, type Product, type ProductAddon, type ProductBundle, type ProductCategory, type ProductFaq, type ProductFeedback, type ProductGroup, type ProductImage, type ProductVariant, type ResolvedThemeSettings, type SDKResponse, type SectionDefinition, type SettingField, type Shop, type ShopFeedback, type ShopTheme, type ShoppexConfig, ShoppexError, type ShoppexInitOptions, type StorefrontAddon, type StorefrontAddonBootstrap, type StorefrontAnnouncementBarAddon, type StorefrontCountdownBarAddon, type StorefrontCouponPopupModalAddon, type StorefrontData, type StorefrontItem, type StorefrontPromoInfoCardAddon, type StorefrontRecentPurchasePopupAddon, type Subscription, type SubscriptionFlags, type SubscriptionInterval, type ThemeConfig, type TrustedChecks, ValidationError, shoppex as default, fetchPublishedThemeSettings, getMenuBySlot, getMenuByTitle, getMenuSlotTitles, mergeSettings, resolveDefaults, shoppex, trackPageView };