@shoppexio/storefront 0.3.7 → 0.3.9

package/dist/index.d.ts

@@ -1,1118 +1,34 @@
-import { createApiClient } from '@shoppex/contracts';
-import { NavigationMenuSlot } from '@shoppex/contracts/navigation';
-export { NavigationMenuSlot } from '@shoppex/contracts/navigation';
-import * as src from 'src';
-
-/**
- * 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;
-    shopId?: 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;
-    message?: 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;
-    customers_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;
-    available_gateways?: string[];
-    reward_program_summary?: RewardProgramSummary | null;
-}
-interface RewardProgramTeaserItem {
-    trigger_type: RewardReason;
-    action_type: RewardActionType;
-    label: string;
-}
-interface RewardProgramSummary {
-    enabled: boolean;
-    headline: string;
-    items: RewardProgramTeaserItem[];
-}
-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;
-    detail_image_url?: string | null;
-    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;
-        createdAt?: string | null;
-        updated_at: string | null;
-        updatedAt?: string | null;
-        is_automated?: boolean;
-        isAutomated?: boolean;
-    }>;
-}
-interface ProductImage {
-    id: string;
-    url: string;
-    cloudflare_image_id?: string;
-    alt?: string;
-}
-interface ProductVariant {
-    id: string;
-    title: string;
-    price?: number;
-    stock?: number;
-    quantity_min?: number;
-    quantity_max?: number;
-    quantityMin?: number;
-    quantityMax?: number;
-    image_id?: string | null;
-    imageId?: string | null;
-    cloudflare_image_id?: string | null;
-    cloudflareImageId?: string | null;
-    image_url?: string | null;
-    imageUrl?: string | null;
-}
-interface ProductAddon {
-    id: string;
-    name?: string;
-    title?: string;
-    price: number;
-    required?: boolean;
-}
-interface PriceVariant {
-    id: string;
-    label?: string;
-    title?: string;
-    price: number;
-    stock?: number;
-    quantity_min?: number;
-    quantity_max?: number;
-    quantityMin?: number;
-    quantityMax?: number;
-    image_id?: string | null;
-    imageId?: string | null;
-    cloudflare_image_id?: string | null;
-    cloudflareImageId?: string | null;
-    image_url?: string | null;
-    imageUrl?: string | null;
-}
-interface CustomFieldDefinition {
-    id: string;
-    name: string;
-    type: 'text' | 'textarea' | 'select' | 'checkbox';
-    required?: boolean;
-    options?: string[];
-}
-interface Feedback {
-    id: string;
-    rating: number;
-    score?: number;
-    author?: string;
-    customer_name?: string;
-    comment?: string;
-    message?: string | null;
-    reply?: string | null;
-    is_automated?: boolean;
-    isAutomated?: boolean;
-    product_id?: string | null;
-    product_title?: string | null;
-    cloudflare_image_id?: string | null;
-    created_at: string;
-    updated_at?: string | number | null;
-}
-interface ProductBundle {
-    id?: string;
-    uniqid?: string;
-    title?: string;
-    discount_type?: 'PERCENTAGE' | 'FIXED';
-    discount_amount?: number;
-    products?: ProductBundleProduct[];
-}
-interface ProductBundleProduct {
-    id?: string;
-    uniqid: string;
-    title?: string | null;
-    default_variant_id?: string;
-}
-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;
-    rewards?: BuyerRewards | null;
-}
-interface InvoiceProduct {
-    product_id: string;
-    title: string;
-    quantity: number;
-    price: number;
-}
-type RewardActionType = 'WALLET_CREDIT' | 'COUPON';
-type RewardGrantStatus = 'PENDING' | 'FULFILLED' | 'FAILED' | 'REVOKED';
-type RewardReason = 'ORDER_COMPLETED' | 'ORDER_COUNT_REACHED' | 'SPEND_AMOUNT_REACHED' | 'POSITIVE_REVIEW_LEFT' | 'FIRST_PURCHASE_COMPLETED';
-interface BuyerRewardActivityItem {
-    id: string;
-    type: RewardActionType;
-    status: RewardGrantStatus;
-    amount: string | null;
-    currency: string | null;
-    coupon_code: string | null;
-    reason: RewardReason;
-    trigger_reference_type: string;
-    trigger_reference_id: string;
-    created_at: number;
-    fulfilled_at: number | null;
-    expires_at: number | null;
-}
-interface BuyerRewards {
-    summary: {
-        available: string;
-        pending: string;
-        lifetime_earned: string;
-        redeemed: string | null;
-        currency: string;
-    };
-    activity: BuyerRewardActivityItem[];
-    earned_after_invoice: BuyerRewardActivityItem[];
-    pending_after_invoice: BuyerRewardActivityItem[];
-}
-interface CouponValidation {
-    valid: boolean;
-    discount?: number;
-    discount_type?: 'percentage' | 'fixed';
-    source?: 'COUPON' | 'AFFILIATE';
-    product_restricted?: boolean;
-    variant_restricted?: boolean;
-    restriction_scope?: 'all' | 'products' | 'variants' | 'products_and_variants';
-    allowed_product_ids?: string[];
-    allowed_variant_ids?: string[];
-    message?: string;
-}
-interface CouponValidationOptions {
-    productId?: string;
-    variantId?: string;
-}
-interface AffiliateValidation {
-    valid: boolean;
-    program_enabled?: boolean;
-    affiliate_code: string | null;
-    discount_active: boolean;
-    discount_percent: number;
-    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;
-    product_uniqids?: string[];
-    products_bound?: Product[];
-    products_count?: number;
-    groups_bound?: ProductGroup[];
-    groups_count?: number;
-}
-interface CursorPagination {
-    next_cursor: string | null;
-    has_more: boolean;
-}
-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;
-        hero_image_url?: string | null;
-        discount_display?: string | null;
-        expires_at?: string | null;
-    };
-}
-type StorefrontAddon = StorefrontAnnouncementBarAddon | StorefrontCountdownBarAddon | StorefrontPromoInfoCardAddon | StorefrontRecentPurchasePopupAddon | StorefrontCouponPopupModalAddon;
-interface StorefrontAddonBootstrap {
-    items: StorefrontAddon[];
-}
-interface StorefrontOnlineUsers {
-    count: number;
-    window_seconds: number;
-}
-type StorefrontItem = {
-    item_type: 'PRODUCT' | 'GROUP';
-    uniqid: string;
-    sort_priority?: number | null;
-    title?: string | null;
-    name?: string | null;
-};
-interface StorefrontData {
-    shop: Shop;
-    products: Product[];
-    products_pagination?: CursorPagination | null;
-    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;
-    item_count?: number | 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' | 'link' | 'page' | null;
-    target?: '_self' | '_blank' | null;
-    sort_order: number;
-    page_slug: string | null;
-    created_at: number;
-    updated_at: number;
-    children?: MenuItem[];
-}
-
-/**
- * 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 CartAppliedDiscount {
-    source: 'PRODUCT_DISCOUNT' | 'VOLUME_DISCOUNT' | 'AUTOMATIC_PRODUCT_DEAL' | 'BUNDLE_DEAL' | 'COUPON';
-    source_id: string | null;
-    source_uniqid: string | null;
-    label: string;
-    amount: string;
-}
-interface EligibleCartDeal {
-    source?: 'AUTOMATIC_PRODUCT_DEAL';
-    deal_id: string;
-    deal_uniqid: string;
-    product_id: string;
-    product_uniqid: string | null;
-    label: string;
-    missing_quantity: number;
-    required_quantity: number;
-}
-interface EligibleBundleDealProduct {
-    product_id: string;
-    product_uniqid: string;
-    title: string;
-    quantity: number;
-    price: string;
-    currency: string;
-    default_variant_id: string;
-}
-interface EligibleBundleDeal {
-    source: 'BUNDLE_DEAL';
-    bundle_id: string;
-    bundle_uniqid: string;
-    label: string;
-    discount_type: 'PERCENTAGE' | 'FIXED';
-    discount_amount: string;
-    missing_products: EligibleBundleDealProduct[];
-    products: EligibleBundleDealProduct[];
-}
-interface CartQuote {
-    subtotal: string;
-    discount: string;
-    total: string;
-    currency: string;
-    applied_discounts: CartAppliedDiscount[];
-    automatic_product_deals: Array<Record<string, unknown>>;
-    bundle_deals: Array<Record<string, unknown>>;
-    eligible_deals: EligibleCartDeal[];
-    eligible_bundle_deals: EligibleBundleDeal[];
-}
-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;
-
-/**
- * Typed OpenAPI client factory.
- *
- * Surfaces the generated `createApiClient` from `@shoppex/contracts` with the
- * SDK's configured `apiBaseUrl`. This lets consumers of `@shoppexio/storefront`
- * call any public Dev API endpoint with full end-to-end types without
- * rebuilding a client from scratch.
- *
- * Prefer the high-level modules (`shoppex.getProducts()` etc.) for common
- * read flows — they handle caching, pagination defaults, and storefront
- * scoping. Drop down to `shoppex.client()` only when you need an endpoint
- * the high-level API does not cover yet.
- */
-
-type ApiClient = ReturnType<typeof createApiClient>;
-/**
- * Return a typed OpenAPI client bound to the SDK's configured API base URL.
- * The client is cached per base URL and recreated when the SDK is re-initialized
- * against a different host.
- */
-declare function getTypedClient(token?: string): ApiClient;
-
-/**
- * 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);
-}
-
-interface StorefrontCustomField {
-    name: string;
-    type: string;
-    required: boolean;
-    defaultValue: string;
-    placeholder: string;
-    regex?: string;
-}
-declare function normalizeStorefrontCustomFields(raw: unknown): StorefrontCustomField[];
-declare function isStorefrontCheckboxCustomFieldValueChecked(value: string | undefined): boolean;
-declare function validateStorefrontCustomFieldValue(field: StorefrontCustomField, value: string): string | null;
-declare function buildStorefrontCustomFieldPayload(fields: StorefrontCustomField[], values: Record<string, string>): Record<string, 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 BlockDefinition {
-    name: string;
-    description?: string;
-    icon?: string;
-    settings: Record<string, SettingField>;
-    allowedPages?: string[];
-    maxPerPage?: number;
-}
-interface BlockInstance {
-    id: string;
-    type: string;
-    visible?: boolean;
-    settings?: Record<string, SettingValue>;
-}
-interface PageLayout {
-    blocks: BlockInstance[];
-}
-interface ThemeBlockManifest {
-    pages: string[];
-    blocks: Record<string, BlockDefinition>;
-    defaultLayouts?: Record<string, PageLayout>;
-}
-interface ThemeConfig {
-    id: string;
-    name: string;
-    description?: string;
-    version: string;
-    author?: string;
-    preview?: string;
-    settings: Record<string, Record<string, SettingField>>;
-    sections: Record<string, SectionDefinition>;
-    blocks?: Record<string, BlockDefinition>;
-    pageLayouts?: Record<string, PageLayout>;
-    builder?: ThemeBlockManifest;
-}
-type SettingValue = string | number | boolean | null | string[] | Record<string, unknown>;
-type ResolvedThemeSettings = {
-    [Category: string]: {
-        [Key: string]: SettingValue;
-    };
-};
-
-type JsonRecord = Record<string, unknown>;
-interface PublishedBuilderSettings {
-    version: number;
-    revision: number;
-    theme: {
-        content: JsonRecord;
-        layout: JsonRecord;
-        style_slots: JsonRecord;
-        pages?: unknown[];
-        terms?: JsonRecord;
-        [key: string]: unknown;
-    };
-    [key: string]: unknown;
-}
-interface PublishedThemeSettingsPayload {
-    settings: ResolvedThemeSettings;
-    builder_settings: PublishedBuilderSettings | null;
-    content: JsonRecord;
-    style_slots: JsonRecord;
-}
-declare function fetchPublishedBuilderSettings(shopSlug: string): Promise<PublishedThemeSettingsPayload | null>;
-declare function fetchPublishedThemeSettings(shopSlug: string): Promise<ResolvedThemeSettings | null>;
-declare function resolveDefaults(config: ThemeConfig): ResolvedThemeSettings;
-declare function mergeSettings(defaults: ResolvedThemeSettings, overrides: Partial<ResolvedThemeSettings>): ResolvedThemeSettings;
-
-/**
- * Store Module
- *
- * API methods for store data.
- */
-
-interface GetStorefrontOptions {
-    productsLimit?: number;
-    productsCursor?: string | null;
-}
-declare function getStore(): Promise<SDKResponse<Shop>>;
-declare function resolveStoreByDomain(domain?: string, apiBaseUrl?: string): Promise<SDKResponse<Shop>>;
-declare function getStorefront(options?: GetStorefrontOptions): Promise<SDKResponse<StorefrontData>>;
-declare function getStoreLogoUrl(): Promise<string | null>;
-declare function getStoreBannerUrl(): Promise<string | null>;
-
-/**
- * Products Module
- *
- * API methods for product data.
- */
-
-interface GetStorefrontProductsPageOptions {
-    cursor?: string | null;
-    limit?: number;
-    sort?: 'featured' | 'newest' | 'price-asc' | 'price-desc' | string | null;
-    category?: string | null;
-    hideOutOfStock?: boolean;
-}
-declare function getProducts(): Promise<SDKResponse<Product[]>>;
-declare function getStorefrontProductsPage(options?: GetStorefrontProductsPageOptions): Promise<SDKResponse<{
-    products: Product[];
-    pagination: CursorPagination | null;
-}>>;
-declare function getProduct(idOrSlug: string): Promise<SDKResponse<Product>>;
-declare function getCategories(): Promise<SDKResponse<string[]>>;
-
-declare function getCartCoupon(): string | null;
-declare function setCartCoupon(coupon: string | null | undefined): string | null;
-declare function clearCartCoupon(): void;
-declare function getCart(): CartItem[];
-declare function getCartItemCount(): number;
-declare function addToCart(productId: string, variantId: string, quantity?: number, options?: CartAddOptions): void;
-declare function setCartItem(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;
-declare function quoteCart(coupon?: string): Promise<src.SDKResponse<CartQuote>>;
-
-/**
- * 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;
-    referralCode?: string;
-}
-interface CheckoutResult {
-    success: boolean;
-    redirectUrl?: string;
-    invoiceId?: string;
-    rewards?: BuyerRewards | null;
-    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 setAffiliateCode(code: string | null | undefined, ttlDays?: number): string | null;
-declare function clearAffiliateCode(): void;
-declare function getAffiliateCode(): string | null;
-declare function validateAffiliateCode(code: string): Promise<SDKResponse<AffiliateValidation>>;
-declare function applyAffiliateCode(code: string): Promise<SDKResponse<AffiliateValidation>>;
-/**
- * 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, productOrOptions?: string | CouponValidationOptions): 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 its exact title.
- */
-declare function getMenu(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>;
-
-declare function getStorefrontOnlineUsers(): Promise<SDKResponse<StorefrontOnlineUsers>>;
-declare function touchStorefrontPresence(): Promise<SDKResponse<{
-    pong: string;
-}>>;
-
-/**
- * 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;
-
-/**
- * Shoppex Storefront SDK
- *
- * Usage:
- * ```html
- * <script src="https://cdn.shoppex.io/sdk/v0.3/shoppex.umd.js"></script>
- * <script>
- *   shoppex.init('my-store');
- *
- *   shoppex.getStore().then(store => console.log(store));
- *   shoppex.addToCart('product-id', 'variant-id', 2);
- *   shoppex.checkout();
- * </script>
- * ```
- */
-
+import { isInitialized, getConfig } from './core/config';
+import { getTypedClient } from './core/typed-client';
+import { ShoppexInitOptions } from './types';
+import { getStore, getStorefront, getStoreLogoUrl, getStoreBannerUrl, resolveStoreByDomain } from './modules/store';
+import { getProducts, getProduct, getCategories, getStorefrontProductsPage } from './modules/products';
+import { getCart, getCartItemCount, getCartCoupon, setCartCoupon, clearCartCoupon, addToCart, setCartItem, updateCartItem, removeFromCart, clearCart, createCartBackup, restoreCartFromBackup, mergeBaskets, moveBasketItem, getCartStats, validateCartIntegrity, quoteCart } from './modules/cart';
+import { checkout, buildCheckoutUrl, buildCheckoutUrlSync } from './modules/checkout';
+import { applyAffiliateCode, captureAffiliateFromUrl, getAffiliateCode, setAffiliateCode, clearAffiliateCode, validateAffiliateCode } from './modules/affiliates';
+import { validateCoupon } from './modules/coupons';
+import { getShopReviews } from './modules/reviews';
+import { searchProducts } from './modules/search';
+import { getInvoice, getInvoiceStatus } from './modules/invoices';
+import { getPages, getPage } from './modules/pages';
+import { getMenus, getMenu, getMenuBySlot, getMenuByTitle, getMenuSlotTitles } from './modules/navigation';
+import { trackPageView } from './modules/analytics';
+import { getStorefrontOnlineUsers, touchStorefrontPresence } from './modules/presence';
+import { createFormatter, formatPrice } from './utils/format';
+import { clearCache, invalidateCache, getCacheStats } from './core/cache';
+import { fetchPublishedBuilderSettings, fetchPublishedThemeSettings, resolveDefaults, mergeSettings } from './modules/theme';
+export * from './types';
+export * from './core/errors';
+export { buildStorefrontCustomFieldPayload, isStorefrontCheckboxCustomFieldValueChecked, normalizeStorefrontCustomFields, validateStorefrontCustomFieldValue, } from './utils/storefront-custom-fields';
+export type { StorefrontCustomField } from './utils/storefront-custom-fields';
+export { isProductInStock, isProductOutOfStock, isVariantOutOfStock, resolveDisplayStock, resolveVariantStockValue, } from './utils/storefront-stock';
+export type { BlockDefinition, BlockInstance, PageLayout, ThemeConfig, ThemeBlockManifest, SettingField, SectionDefinition, ResolvedThemeSettings, } from './types/theme-config';
+export type { PublishedBuilderSettings, PublishedThemeSettingsPayload } from './modules/theme';
+export type { NavigationMenuSlot } from '@shoppex/contracts/navigation';
+export { fetchPublishedBuilderSettings, fetchPublishedThemeSettings, resolveDefaults, mergeSettings } from './modules/theme';
+export { trackPageView } from './modules/analytics';
+export { getStorefrontOnlineUsers, touchStorefrontPresence } from './modules/presence';
+export { getMenus, getMenu, getMenuBySlot, getMenuByTitle, getMenuSlotTitles } from './modules/navigation';
 /**
  * Initialize the SDK with a store slug
  */
@@ -1123,7 +39,7 @@ declare function init(options: ShoppexInitOptions & {
 /**
  * Shoppex SDK instance
  */
-declare const shoppex: {
+export declare const shoppex: {
     init: typeof init;
     isInitialized: typeof isInitialized;
     getConfig: typeof getConfig;
@@ -1188,5 +104,5 @@ declare const shoppex: {
     resolveDefaults: typeof resolveDefaults;
     mergeSettings: typeof mergeSettings;
 };
-
-export { type AffiliateValidation, type ApiResponse, type BlockDefinition, type BlockInstance, type BuyerRewardActivityItem, type BuyerRewards, type CartAddOptions, type CartAddon, type CartAppliedDiscount, CartError, type CartItem, type CartMetadata, type CartPayload, type CartQuote, type CartStats, type Category, type CouponValidation, type CouponValidationOptions, type CursorPagination, type CustomFieldDefinition, type EligibleBundleDeal, type EligibleBundleDealProduct, type EligibleCartDeal, type Feedback, type Invoice, type InvoiceProduct, type Menu, type MenuItem, NetworkError, NotInitializedError, type Page, type PageLayout, type PriceVariant, type Product, type ProductAddon, type ProductBundle, type ProductBundleProduct, type ProductCategory, type ProductFaq, type ProductFeedback, type ProductGroup, type ProductImage, type ProductVariant, type PublishedBuilderSettings, type PublishedThemeSettingsPayload, type ResolvedThemeSettings, type RewardActionType, type RewardGrantStatus, type RewardProgramSummary, type RewardProgramTeaserItem, type RewardReason, 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 StorefrontCustomField, type StorefrontData, type StorefrontItem, type StorefrontOnlineUsers, type StorefrontPromoInfoCardAddon, type StorefrontRecentPurchasePopupAddon, type Subscription, type SubscriptionFlags, type SubscriptionInterval, type ThemeBlockManifest, type ThemeConfig, type TrustedChecks, ValidationError, buildStorefrontCustomFieldPayload, shoppex as default, fetchPublishedBuilderSettings, fetchPublishedThemeSettings, getMenu, getMenuBySlot, getMenuByTitle, getMenuSlotTitles, getMenus, getStorefrontOnlineUsers, isStorefrontCheckboxCustomFieldValueChecked, mergeSettings, normalizeStorefrontCustomFields, resolveDefaults, shoppex, touchStorefrontPresence, trackPageView, validateStorefrontCustomFieldValue };
+export default shoppex;
+//# sourceMappingURL=index.d.ts.map