@shoppexio/storefront 1.0.91 → 1.0.93

package/dist/index.d.cts

@@ -1,10 +1,27 @@
-import { createApiClient } from '@shoppex/contracts/api-client';
 import { NavigationMenuSlot } from '@shoppex/contracts/navigation';
 export { NavigationMenuSlot } from '@shoppex/contracts/navigation';
+import { StorefrontDeliveryType } from '@shoppex/contracts/storefront-delivery-type';
 import * as src from 'src';
+import { createApiClient } from '@shoppex/contracts/api-client';
 import { CustomerWarrantyClaimWire, CustomerPortalAffiliateCreateLinkWire, CustomerPortalDashboardWire, CustomerPortalPaginatedInvoicesWire, CustomerPortalInvoiceDetailWire, CustomerLoyaltyWire, CustomerLoyaltyRedeemWire, CustomerWarrantyListWire, CustomerPortalNotificationPreferencesWire } from '@shoppex/contracts/customer-account-wire';
 export { CATALOG_UNIT_PRICE_DECIMAL_PLACES, CATALOG_UNIT_PRICE_FORMAT_OPTIONS, PAYABLE_AMOUNT_DECIMAL_PLACES, roundPayableAmount } from '@shoppex/contracts/catalog-unit-price';
 
+interface CacheStats {
+    hits: number;
+    misses: number;
+    pendingRequests: number;
+    entries: number;
+}
+declare function getCacheStats(): CacheStats;
+declare function clearCache(): void;
+declare function invalidateCache(prefixOrKey: string): void;
+
+/**
+ * Formatting Utilities
+ */
+declare function createFormatter(currency?: string, locale?: string): Intl.NumberFormat;
+declare function formatPrice(amount: number | string, currency?: string, locale?: string): string;
+
 /**
  * SDK Configuration Types
  */
@@ -321,6 +338,8 @@ interface Product {
     bestseller?: boolean | number;
     type?: string;
     subtype?: string | null;
+    /** What the buyer receives, read off the delivery mechanism; null when the mechanism does not say. */
+    delivery_type?: StorefrontDeliveryType | null;
     isSubscription?: boolean;
     isGroup?: boolean;
     images: ProductImage[];
@@ -332,11 +351,18 @@ interface Product {
     soldCount?: number;
     variants?: ProductVariant[];
     addons?: ProductAddon[];
+    /**
+     * Buyers must pick one of `addons`: the server refuses a line that names none
+     * (`errors.checkout.addon_required`). Asks nothing when `addons` is empty.
+     */
+    addons_required?: boolean;
     price_variants?: PriceVariant[];
     volume_discounts?: unknown;
     custom_fields?: string | unknown[] | null;
     categories?: ProductCategory[];
     bundles?: ProductBundle[];
+    /** The merchant's upsell picks, as product uniqids in the merchant's order; empty when they picked none. */
+    upsell_product_ids?: string[];
     faqs?: ProductFaq[];
     subscription?: Subscription;
     feedbacks?: Feedback[];
@@ -930,7 +956,9 @@ interface CartItem {
  * to the line for the life of the cart, and every quote-driven heal that tried
  * to clear it was a silent no-op.
  */
-type CartItemUpdate = Partial<Omit<CartItem, 'line_id' | 'product_id' | 'variant_id' | 'min_quantity' | 'max_quantity'>> & {
+type CartItemUpdate = Partial<Omit<CartItem, 'line_id' | 'product_id' | 'variant_id' | 'variant_title' | 'min_quantity' | 'max_quantity'>> & {
+    /** `null` clears the stored option name (the product has no options). */
+    variant_title?: string | null;
     /** `null` clears the stored minimum. */
     min_quantity?: number | null;
     /** `null` clears the stored ceiling. */
@@ -974,6 +1002,11 @@ interface EligibleCartDeal {
     label: string;
     missing_quantity: number;
     required_quantity: number;
+    /** Units of `required_quantity` the deal discounts. */
+    discounted_quantity: number;
+    discount_type: 'PERCENTAGE' | 'FREE';
+    /** The percent off those units as a 2-dp string; `"100.00"` for FREE. */
+    discount_value: string;
 }
 interface EligibleBundleDealProduct {
     product_id: string;
@@ -1023,6 +1056,10 @@ interface EligibleBundleDeal {
  *   `product_id`   the product identifier the cart sent, echoed exactly.
  *   `variant_id`   the resolved option id, `null` for a product with no variants.
  *   `quantity`     the quantity this line was quoted at.
+ *   `product_title` / `variant_title`  the catalog's names for the product and the option
+ *                  (`variant_title` null for a product with no variants), the names the invoice line
+ *                  carries. `product_title` is the base-language title; a storefront that shows
+ *                  translated titles keeps its own. Never compose or substitute them.
  *   `min_quantity` ABSENT when it is 1. Present values are the stepper's floor.
  *   `max_quantity` ABSENT when nothing bounds the line — absence is the unbounded sentinel, and
  *                  `-1` is never sent. Never coerce an absent key to 0.
@@ -1056,6 +1093,10 @@ interface EligibleBundleDeal {
 interface CartQuoteLine {
     product_id: string;
     variant_id: string | null;
+    /** Absent on servers older than this field. */
+    product_title?: string;
+    /** Absent on servers older than this field. */
+    variant_title?: string | null;
     quantity: number;
     /** Absent when 1. */
     min_quantity?: number;
@@ -1123,102 +1164,30 @@ interface CartStats {
 }
 
 /**
- * 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.
+ * Pages Module
  *
- * 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.
+ * API methods for public pages.
  */
-declare function getTypedClient(token?: string): ApiClient;
 
 /**
- * SDK Error Classes
+ * Get all public pages for the store
  */
+declare function getPages(): Promise<SDKResponse<Page[]>>;
 /**
- * `SDKResponse.code` of a priced read that asked for a currency the shop does
- * not sell in (ADR-0066). `errorParams.requested` names the currency,
- * `errorParams.available` lists the enabled ones.
+ * Get a public page by slug
  */
-declare const CURRENCY_UNAVAILABLE_ERROR_CODE = "errors.storefront.currency_unavailable";
-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 function getPage(slug: string): Promise<SDKResponse<Page>>;
+
 /**
- * A refusal the SERVER made and named. `code` is the backend's `error_code`
- * (e.g. `errors.checkout.coupon_no_longer_valid`) — the branchable identity of
- * the refusal, stable across locales, unlike the localized `message`.
+ * Invoices Module
  *
- * Distinct from {@link NetworkError}, whose `code` is always `NETWORK_ERROR`:
- * that one means "the request did not produce a named answer".
+ * Invoice status checking after payment.
  */
-declare class ApiError extends ShoppexError {
-    readonly errorParams?: Record<string, unknown>;
-    constructor(message: string, code: string, statusCode?: number, errorParams?: Record<string, unknown>);
-}
-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>;
-
-type VariantLike = Pick<ProductVariant, 'stock' | 'orderable' | 'supplier_backed'> | Pick<PriceVariant, 'stock' | 'orderable' | 'supplier_backed'>;
-type ProductLike = Pick<Product, 'type' | 'stock' | 'orderable' | 'supplier_backed' | 'on_hold' | 'price_variants' | 'variants'> & {
-    onHold?: boolean | number | string | null;
-    is_on_hold?: boolean | number | string | null;
-    isOnHold?: boolean | number | string | null;
-};
-declare function resolveVariantStockValue(variant: VariantLike | null | undefined): number;
-declare function resolveDisplayStock(product: ProductLike | null | undefined): number;
-declare function isProductOutOfStock(product: ProductLike | null | undefined): boolean;
-declare function isProductInStock(product: ProductLike | null | undefined): boolean;
-declare function isVariantOutOfStock(variant: VariantLike | null | undefined): boolean;
 
-declare function buildStorefrontProductLookup(products?: Product[]): Map<string, Product>;
-declare function getStorefrontGroupProducts(group: ProductGroup, productsOrLookup?: Product[] | Map<string, Product>): Product[];
-declare function getMergedStorefrontProducts(products?: Product[]): Product[];
+declare function getInvoice(invoiceId: string): Promise<SDKResponse<Invoice>>;
+declare function getInvoiceStatus(invoiceId: string): Promise<SDKResponse<{
+    status: string;
+}>>;
 
 interface StorefrontSearchFilterOptions {
     hideOutOfStock?: boolean;
@@ -1241,269 +1210,121 @@ declare function filterProductsBySearchQuery(products: Product[], query: string,
 declare function searchMergedStorefrontCatalogItems(products: Product[], groups: ProductGroup[], query: string, options?: StorefrontSearchFilterOptions): StorefrontCatalogSearchItem[];
 declare function searchMergedStorefrontCatalog(products: Product[], groups: ProductGroup[], query: string, options?: StorefrontSearchFilterOptions): Product[];
 
-type StorefrontContactTicketInput = {
-    shopSlug: string;
-    email: string;
-    message: string;
-    title?: string;
-    name?: string;
-    invoiceId?: string;
-    apiBaseUrl?: string;
-};
-type StorefrontContactTicketResult = {
-    uniqid: string;
-};
-declare function resolveStorefrontApiBaseUrl(options?: {
-    apiBaseUrl?: string;
-    hostname?: string;
-}): string;
-declare function buildStorefrontContactMessage(input: {
-    name?: string;
-    message: string;
-    maxLength?: number;
-}): string;
-declare function submitStorefrontContactTicket(input: StorefrontContactTicketInput): Promise<StorefrontContactTicketResult>;
-type StorefrontSocialLinks = {
-    discord?: string | null;
-    telegram?: string | null;
-};
-declare function resolveStorefrontSocialLinks(store: {
-    discord_link?: string | null;
-    telegram_link?: string | null;
-    social?: Record<string, string | null | undefined> | null;
-} | null | undefined): StorefrontSocialLinks;
+interface SearchOptions {
+    hideOutOfStock?: boolean;
+    maxResults?: number;
+}
+
+declare function searchCatalogItems(query: string, options?: SearchOptions): Promise<SDKResponse<StorefrontCatalogSearchItem[]>>;
+declare function searchProducts(query: string, options?: SearchOptions): Promise<SDKResponse<Product[]>>;
 
 /**
- * Theme configuration types (framework agnostic)
+ * Reviews Module
+ *
+ * Shop-level feedback/reviews.
+ * Note: Shoppex has shop-level feedback, not product-level reviews.
  */
-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>;
+
+/** `code` of a filtered request the API answered without applying the filter. */
+declare const PRODUCT_FILTER_UNSUPPORTED = "reviews_product_filter_unsupported";
+interface ShopReviewsPageOptions {
+    /**
+     * One product's reviews, by the product's public id (the `id` the catalog
+     * carries). The page's `summary` then counts that product's reviews only.
+     */
+    product?: string | null;
 }
-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;
+declare function getShopReviewsPage(cursor?: string | null, options?: ShopReviewsPageOptions): Promise<SDKResponse<ShopReviewsPage>>;
+declare function getShopReviews(): Promise<SDKResponse<Feedback[]>>;
 
 /**
- * Store Module
+ * Coupons Module
  *
- * API methods for store data.
+ * Coupon validation before checkout.
  */
 
-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>;
+declare function validateCoupon(code: string, productOrOptions?: string | CouponValidationOptions): Promise<SDKResponse<CouponValidation>>;
 
+type AffiliateAttributionMode = 'LAST_CLICK' | 'FIRST_CLICK';
+declare function setAffiliateCode(code: string | null | undefined, ttlDays?: number, mode?: AffiliateAttributionMode): string | null;
 /**
- * Products Module
+ * The stored attribution, or null when nothing valid is held.
  *
- * API methods for product data.
+ * Unlike `getAffiliateCode()` this also reports the mode the entry was written
+ * under, which is what `captureAffiliateFromUrl` needs BEFORE it decides
+ * whether it may overwrite.
  */
-
-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 getCartCouponSource(): CartCodeSource | null;
-declare function setCartCoupon(coupon: string | null | undefined, source?: CartCodeSource): string | null;
-declare function clearCartCoupon(): void;
-declare function getCart(): CartItem[];
-/** Resolve a cart line_id for product+variant. When multiple configs exist, returns the first line. */
-declare function resolveCartLineId(productId: string, variantId: string, cart?: CartItem[]): string;
-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 getStoredAffiliate(): {
+    code: string;
+    mode: AffiliateAttributionMode;
+    windowDays: number;
+    /**
+     * When this entry expires, as written. Reported so a hold that has to be put
+     * back after an early overwrite keeps its original expiry — the window runs
+     * from the click that earned it, not from the landing that failed to take it.
+     */
+    expiresAt: number;
+} | null;
+declare function clearAffiliateCode(): void;
+declare function getAffiliateCode(): string | null;
+declare function trackAffiliateEvent(eventType: 'add_to_cart' | 'checkout_started', options?: {
+    /**
+     * The code the surrounding call actually resolved and submitted (e.g.
+     * checkout()'s tri-state result). `null` means the caller explicitly
+     * submitted WITHOUT a referral — no event is recorded, so an ambient
+     * stored code is never credited for a sale it did not get. Omit the
+     * options object entirely to attribute to the stored ambient code.
+     */
+    code: string | null;
+    /**
+     * Overrides the per-browser-session dedupe key. checkout entry points
+     * pass `inv:<invoiceId>` so every created invoice counts as exactly one
+     * checkout — a session-wide key would drop the second checkout of a
+     * buyer who orders twice in one session while both sales still count.
+     */
+    dedupeKey?: string;
+}): Promise<void>;
+declare function validateAffiliateCode(code: string): Promise<SDKResponse<AffiliateValidation>>;
 /**
- * Patch one cart line.
+ * Validate a manually entered code and store it (ADR-0067).
  *
- * TRI-STATE BOUNDS: `min_quantity`/`max_quantity` accept `null` to DELETE the
- * stored bound — see {@link CartItemUpdate}. `undefined` (or an absent key)
- * leaves it alone, which is why a removed ceiling needs its own spelling.
+ * Attribution is governed by the same rules as a `?ref=` landing, deliberately:
+ * a themed "apply code" box must not be a way around first-click, or the rule
+ * is bypassed by any storefront that offers one. So a still-protected hold
+ * keeps the sale, and the stored entry always carries the mode and window the
+ * server just reported — the old unconditional `setAffiliateCode(code)` wrote
+ * a 30-day last-click entry whatever the shop or tier had configured.
  *
- * NO-OP UPDATES DO NOT WRITE. An update that leaves the cart byte-identical
- * returns without touching storage: no metadata bump, no `version` increment,
- * and — because the storage write is what other tabs observe — no `storage`
- * event. Writing anyway made an ineffective heal indistinguishable from a real
- * cart change, and two tabs healing the same line could hand the event back and
- * forth indefinitely. Line-shape healing of a legacy stored row is NOT this
- * function's job: `normalizeCartItems` clamps and repairs on every READ, which
- * is the chokepoint every access already flows through.
+ * The result reports what is now ATTRIBUTED, not merely what was validated:
+ * `affiliate_code` carries the winning code and `applied` says whether that is
+ * the one you passed. The documented integration hands `affiliate_code`
+ * straight to `checkout({ affiliateCode })`, and an explicit checkout code
+ * overrides storage — so returning the losing code here would credit it and
+ * walk right around the hold this function just honoured.
  */
-declare function updateCartItem(lineId: string, updates: CartItemUpdate): void;
-declare function removeFromCart(lineId: string): void;
+declare function applyAffiliateCode(code: string): Promise<SDKResponse<AffiliateValidation>>;
 /**
- * Discards the cart entirely — and with it the proof that describes it.
+ * Capture an affiliate code from the current URL and store it (ADR-0067).
  *
- * PAYMENT PATH. `latestQuoteToken` is evidence about a specific cart, and this
- * is the one mutation after which that cart does not exist in any form. Held
- * across the clear, the proof outlives its subject: a caller that clears and
- * re-adds (Buy Now REPLACES the cart) hands `/from-cart` a token bound to the
- * previous cart's hash, which is refused as `quote_token_stale` — a hand-off
- * dead-ended by a proof nobody asked for. And with no re-quote in between there
- * is nothing to replace it with, so the retry is refused identically.
+ * Example:
+ * - URL: https://mystore.com/product/abc?ref=deadbeef
+ * - captureAffiliateFromUrl() stores "deadbeef" and returns it.
  *
- * Only this path clears it. Every OTHER mutation turns one cart into another
- * cart, where a proof that no longer matches is the server's to refuse: it
- * answers `quote_token_stale`, the surfaces re-quote, and the buyer approves the
- * new total. Dropping the proof there instead would silently remove the approved
- * -total ceiling from a checkout that raced the re-quote, which is the failure
- * the token exists to prevent.
+ * Under LAST_CLICK (the default, and the only behaviour before ADR-0067) a new
+ * `?ref=` replaces whatever was stored. Under FIRST_CLICK an existing,
+ * unexpired attribution wins and the new code is NOT stored — the landing is
+ * still reported to the server so the affiliate's click statistics stay
+ * honest, but the credit stays with whoever was there first.
+ *
+ * The mode comes from the server, which means the FIRST landing in a browser
+ * can never be blocked by it — correct, because there is nothing to protect
+ * yet. From then on the mode travels with the stored entry.
+ *
+ * Enforcement is client-side. A buyer who edits localStorage can re-attribute
+ * their own visit; this is the same trust level as the window itself and must
+ * not be presented to merchants as fraud protection.
  */
-declare function clearCart(): void;
-declare function createCartBackup(): void;
-declare function restoreCartFromBackup(): boolean;
-declare function mergeBaskets(items: CartBasketMergeLine[]): CartItem[];
-declare function moveBasketItem(fromProductId: string, fromVariantId: string, toProductId: string, toVariantId: string): void;
-declare function validateCartIntegrity(): boolean;
-declare function getCartStats(): CartStats;
-/** @internal — read by checkout(); exported only across module boundaries. */
-declare function getLatestQuoteToken(): string | null;
-declare function quoteCart(coupon?: string, currency?: string): Promise<src.SDKResponse<CartQuote>>;
-
-type CartLineIdentityInput = Pick<CartItem, 'product_id' | 'variant_id' | 'price_variant_id' | 'addons' | 'custom_fields' | 'price_data' | 'pay_what_you_want_price'>;
-declare function computeCartLineId(input: CartLineIdentityInput): string;
-declare function ensureCartLineId(item: CartItem): CartItem;
+declare function captureAffiliateFromUrl(param?: string): Promise<string | null>;
 
 /**
  * Checkout Module
@@ -1642,121 +1463,369 @@ declare function buildCheckoutUrl(couponOrOptions?: string | CheckoutOptions, op
  */
 declare function buildCheckoutUrlSync(): never;
 
-interface SearchOptions {
-    hideOutOfStock?: boolean;
-    maxResults?: number;
-}
-
-declare function searchCatalogItems(query: string, options?: SearchOptions): Promise<SDKResponse<StorefrontCatalogSearchItem[]>>;
-declare function searchProducts(query: string, options?: SearchOptions): Promise<SDKResponse<Product[]>>;
-
-type AffiliateAttributionMode = 'LAST_CLICK' | 'FIRST_CLICK';
-declare function setAffiliateCode(code: string | null | undefined, ttlDays?: number, mode?: AffiliateAttributionMode): string | null;
+declare function getCartCoupon(): string | null;
+declare function getCartCouponSource(): CartCodeSource | null;
+declare function setCartCoupon(coupon: string | null | undefined, source?: CartCodeSource): string | null;
+declare function clearCartCoupon(): void;
+declare function getCart(): CartItem[];
+/** Resolve a cart line_id for product+variant. When multiple configs exist, returns the first line. */
+declare function resolveCartLineId(productId: string, variantId: string, cart?: CartItem[]): string;
+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;
 /**
- * The stored attribution, or null when nothing valid is held.
+ * Patch one cart line.
  *
- * Unlike `getAffiliateCode()` this also reports the mode the entry was written
- * under, which is what `captureAffiliateFromUrl` needs BEFORE it decides
- * whether it may overwrite.
+ * TRI-STATE BOUNDS: `min_quantity`/`max_quantity` accept `null` to DELETE the
+ * stored bound — see {@link CartItemUpdate}. `undefined` (or an absent key)
+ * leaves it alone, which is why a removed ceiling needs its own spelling.
+ *
+ * NO-OP UPDATES DO NOT WRITE. An update that leaves the cart byte-identical
+ * returns without touching storage: no metadata bump, no `version` increment,
+ * and — because the storage write is what other tabs observe — no `storage`
+ * event. Writing anyway made an ineffective heal indistinguishable from a real
+ * cart change, and two tabs healing the same line could hand the event back and
+ * forth indefinitely. Line-shape healing of a legacy stored row is NOT this
+ * function's job: `normalizeCartItems` clamps and repairs on every READ, which
+ * is the chokepoint every access already flows through.
  */
-declare function getStoredAffiliate(): {
-    code: string;
-    mode: AffiliateAttributionMode;
-    windowDays: number;
-    /**
-     * When this entry expires, as written. Reported so a hold that has to be put
-     * back after an early overwrite keeps its original expiry — the window runs
-     * from the click that earned it, not from the landing that failed to take it.
-     */
-    expiresAt: number;
-} | null;
-declare function clearAffiliateCode(): void;
-declare function getAffiliateCode(): string | null;
-declare function trackAffiliateEvent(eventType: 'add_to_cart' | 'checkout_started', options?: {
-    /**
-     * The code the surrounding call actually resolved and submitted (e.g.
-     * checkout()'s tri-state result). `null` means the caller explicitly
-     * submitted WITHOUT a referral — no event is recorded, so an ambient
-     * stored code is never credited for a sale it did not get. Omit the
-     * options object entirely to attribute to the stored ambient code.
-     */
-    code: string | null;
-    /**
-     * Overrides the per-browser-session dedupe key. checkout entry points
-     * pass `inv:<invoiceId>` so every created invoice counts as exactly one
-     * checkout — a session-wide key would drop the second checkout of a
-     * buyer who orders twice in one session while both sales still count.
-     */
-    dedupeKey?: string;
-}): Promise<void>;
-declare function validateAffiliateCode(code: string): Promise<SDKResponse<AffiliateValidation>>;
+declare function updateCartItem(lineId: string, updates: CartItemUpdate): void;
+declare function removeFromCart(lineId: string): void;
 /**
- * Validate a manually entered code and store it (ADR-0067).
+ * Discards the cart entirely — and with it the proof that describes it.
  *
- * Attribution is governed by the same rules as a `?ref=` landing, deliberately:
- * a themed "apply code" box must not be a way around first-click, or the rule
- * is bypassed by any storefront that offers one. So a still-protected hold
- * keeps the sale, and the stored entry always carries the mode and window the
- * server just reported — the old unconditional `setAffiliateCode(code)` wrote
- * a 30-day last-click entry whatever the shop or tier had configured.
+ * PAYMENT PATH. `latestQuoteToken` is evidence about a specific cart, and this
+ * is the one mutation after which that cart does not exist in any form. Held
+ * across the clear, the proof outlives its subject: a caller that clears and
+ * re-adds (Buy Now REPLACES the cart) hands `/from-cart` a token bound to the
+ * previous cart's hash, which is refused as `quote_token_stale` — a hand-off
+ * dead-ended by a proof nobody asked for. And with no re-quote in between there
+ * is nothing to replace it with, so the retry is refused identically.
  *
- * The result reports what is now ATTRIBUTED, not merely what was validated:
- * `affiliate_code` carries the winning code and `applied` says whether that is
- * the one you passed. The documented integration hands `affiliate_code`
- * straight to `checkout({ affiliateCode })`, and an explicit checkout code
- * overrides storage — so returning the losing code here would credit it and
- * walk right around the hold this function just honoured.
+ * Only this path clears it. Every OTHER mutation turns one cart into another
+ * cart, where a proof that no longer matches is the server's to refuse: it
+ * answers `quote_token_stale`, the surfaces re-quote, and the buyer approves the
+ * new total. Dropping the proof there instead would silently remove the approved
+ * -total ceiling from a checkout that raced the re-quote, which is the failure
+ * the token exists to prevent.
  */
-declare function applyAffiliateCode(code: string): Promise<SDKResponse<AffiliateValidation>>;
+declare function clearCart(): void;
+declare function createCartBackup(): void;
+declare function restoreCartFromBackup(): boolean;
+declare function mergeBaskets(items: CartBasketMergeLine[]): CartItem[];
+declare function moveBasketItem(fromProductId: string, fromVariantId: string, toProductId: string, toVariantId: string): void;
+declare function validateCartIntegrity(): boolean;
+declare function getCartStats(): CartStats;
+/** @internal — read by checkout(); exported only across module boundaries. */
+declare function getLatestQuoteToken(): string | null;
+declare function quoteCart(coupon?: string, currency?: string): Promise<src.SDKResponse<CartQuote>>;
+
 /**
- * Capture an affiliate code from the current URL and store it (ADR-0067).
+ * Products Module
  *
- * Example:
- * - URL: https://mystore.com/product/abc?ref=deadbeef
- * - captureAffiliateFromUrl() stores "deadbeef" and returns it.
+ * 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[]>>;
+
+/**
+ * Store Module
  *
- * Under LAST_CLICK (the default, and the only behaviour before ADR-0067) a new
- * `?ref=` replaces whatever was stored. Under FIRST_CLICK an existing,
- * unexpired attribution wins and the new code is NOT stored — the landing is
- * still reported to the server so the affiliate's click statistics stay
- * honest, but the credit stays with whoever was there first.
+ * 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>;
+
+/**
+ * Typed OpenAPI client factory.
  *
- * The mode comes from the server, which means the FIRST landing in a browser
- * can never be blocked by it — correct, because there is nothing to protect
- * yet. From then on the mode travels with the stored entry.
+ * 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.
  *
- * Enforcement is client-side. A buyer who edits localStorage can re-attribute
- * their own visit; this is the same trust level as the window itself and must
- * not be presented to merchants as fraud protection.
+ * 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.
  */
-declare function captureAffiliateFromUrl(param?: string): Promise<string | null>;
 
+type ApiClient = ReturnType<typeof createApiClient>;
 /**
- * Coupons Module
- *
- * Coupon validation before checkout.
+ * 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;
 
-declare function validateCoupon(code: string, productOrOptions?: string | CouponValidationOptions): Promise<SDKResponse<CouponValidation>>;
+/**
+ * SDK Configuration Management
+ */
+
+declare function getConfig(): ShoppexConfig;
+declare function isInitialized(): boolean;
 
 /**
- * Reviews Module
+ * SDK Error Classes
+ */
+/**
+ * `SDKResponse.code` of a priced read that asked for a currency the shop does
+ * not sell in (ADR-0066). `errorParams.requested` names the currency,
+ * `errorParams.available` lists the enabled ones.
+ */
+declare const CURRENCY_UNAVAILABLE_ERROR_CODE = "errors.storefront.currency_unavailable";
+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);
+}
+/**
+ * A refusal the SERVER made and named. `code` is the backend's `error_code`
+ * (e.g. `errors.checkout.coupon_no_longer_valid`) — the branchable identity of
+ * the refusal, stable across locales, unlike the localized `message`.
  *
- * Shop-level feedback/reviews.
- * Note: Shoppex has shop-level feedback, not product-level reviews.
+ * Distinct from {@link NetworkError}, whose `code` is always `NETWORK_ERROR`:
+ * that one means "the request did not produce a named answer".
+ */
+declare class ApiError extends ShoppexError {
+    readonly errorParams?: Record<string, unknown>;
+    constructor(message: string, code: string, statusCode?: number, errorParams?: Record<string, unknown>);
+}
+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;
+    /** Only on a `select`: the labels the buyer picks one of. */
+    options?: 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>;
+
+type VariantLike = Pick<ProductVariant, 'stock' | 'orderable' | 'supplier_backed'> | Pick<PriceVariant, 'stock' | 'orderable' | 'supplier_backed'>;
+type ProductLike = Pick<Product, 'type' | 'stock' | 'orderable' | 'supplier_backed' | 'on_hold' | 'price_variants' | 'variants'> & {
+    onHold?: boolean | number | string | null;
+    is_on_hold?: boolean | number | string | null;
+    isOnHold?: boolean | number | string | null;
+};
+declare function resolveVariantStockValue(variant: VariantLike | null | undefined): number;
+declare function resolveDisplayStock(product: ProductLike | null | undefined): number;
+declare function isProductOutOfStock(product: ProductLike | null | undefined): boolean;
+declare function isProductInStock(product: ProductLike | null | undefined): boolean;
+declare function isVariantOutOfStock(variant: VariantLike | null | undefined): boolean;
+
+declare function buildStorefrontProductLookup(products?: Product[]): Map<string, Product>;
+declare function getStorefrontGroupProducts(group: ProductGroup, productsOrLookup?: Product[] | Map<string, Product>): Product[];
+declare function getMergedStorefrontProducts(products?: Product[]): Product[];
+
+type StorefrontContactTicketInput = {
+    shopSlug: string;
+    email: string;
+    message: string;
+    title?: string;
+    name?: string;
+    invoiceId?: string;
+    apiBaseUrl?: string;
+};
+type StorefrontContactTicketResult = {
+    uniqid: string;
+};
+declare function resolveStorefrontApiBaseUrl(options?: {
+    apiBaseUrl?: string;
+    hostname?: string;
+}): string;
+declare function buildStorefrontContactMessage(input: {
+    name?: string;
+    message: string;
+    maxLength?: number;
+}): string;
+declare function submitStorefrontContactTicket(input: StorefrontContactTicketInput): Promise<StorefrontContactTicketResult>;
+type StorefrontSocialLinks = {
+    discord?: string | null;
+    telegram?: string | null;
+};
+declare function resolveStorefrontSocialLinks(store: {
+    discord_link?: string | null;
+    telegram_link?: string | null;
+    social?: Record<string, string | null | undefined> | null;
+} | null | undefined): StorefrontSocialLinks;
+
+/**
+ * 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;
+    };
+};
 
-/** `code` of a filtered request the API answered without applying the filter. */
-declare const PRODUCT_FILTER_UNSUPPORTED = "reviews_product_filter_unsupported";
-interface ShopReviewsPageOptions {
-    /**
-     * One product's reviews, by the product's public id (the `id` the catalog
-     * carries). The page's `summary` then counts that product's reviews only.
-     */
-    product?: string | null;
+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;
 }
-declare function getShopReviewsPage(cursor?: string | null, options?: ShopReviewsPageOptions): Promise<SDKResponse<ShopReviewsPage>>;
-declare function getShopReviews(): Promise<SDKResponse<Feedback[]>>;
+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;
+
+type CartLineIdentityInput = Pick<CartItem, 'product_id' | 'variant_id' | 'price_variant_id' | 'addons' | 'custom_fields' | 'price_data' | 'pay_what_you_want_price'>;
+declare function computeCartLineId(input: CartLineIdentityInput): string;
+declare function ensureCartLineId(item: CartItem): CartItem;
 
 /**
  * Customer Module
@@ -1882,6 +1951,7 @@ declare function subscriptionBillingHistory(uniqid: string): Promise<SDKResponse
 declare function cancelSubscription(uniqid: string, options?: CustomerSubscriptionCancelOptions): Promise<SDKResponse<unknown>>;
 declare function pauseSubscription(uniqid: string): Promise<SDKResponse<unknown>>;
 declare function resumeSubscription(uniqid: string): Promise<SDKResponse<unknown>>;
+declare function undoSubscriptionCancel(uniqid: string): Promise<SDKResponse<unknown>>;
 declare function favorites(): Promise<SDKResponse<unknown>>;
 /** Idempotent upstream, and a PUT — `customer-favorites.ts` has no POST route. */
 declare function addFavorite(productUniqid: string): Promise<SDKResponse<unknown>>;
@@ -1954,56 +2024,6 @@ declare function resellerOrder(uniqid: string): Promise<SDKResponse<unknown>>;
 declare function resellerWallet(): Promise<SDKResponse<unknown>>;
 declare function resellerApiKeys(): Promise<SDKResponse<unknown>>;
 
-/**
- * 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[];
-
 /**
  * Counts a page view. Call it once per page load or client-side navigation.
  * Passing the cart also records it for the live visitor map.
@@ -2041,96 +2061,33 @@ declare function touchStorefrontPresence(): Promise<SDKResponse<{
 }>>;
 
 /**
- * Formatting Utilities
+ * Navigation Module
+ *
+ * API methods for menus and navigation.
  */
-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/v1.0/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>
- * ```
+ * 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>>;
 /**
- * Initialize the SDK with a store slug
+ * Get a menu by canonical slot. The backend resolves legacy menu titles too.
  */
-declare function init(storeSlug: string, options?: ShoppexInitOptions): void;
-declare function init(options: ShoppexInitOptions & {
-    storeId: string;
-}): void;
+declare function getMenuBySlot(slot: NavigationMenuSlot): Promise<SDKResponse<Menu>>;
+declare function getMenuSlotTitles(slot: NavigationMenuSlot): string[];
+
 /**
  * Shoppex SDK instance
  */
 declare const shoppex: {
-    init: typeof init;
-    isInitialized: typeof isInitialized;
-    getConfig: typeof getConfig;
-    client: typeof getTypedClient;
-    getStore: typeof getStore;
-    getStorefront: typeof getStorefront;
-    getStoreLogoUrl: typeof getStoreLogoUrl;
-    getStoreBannerUrl: typeof getStoreBannerUrl;
-    resolveStoreByDomain: typeof resolveStoreByDomain;
-    getProducts: typeof getProducts;
-    getStorefrontProductsPage: typeof getStorefrontProductsPage;
-    getProduct: typeof getProduct;
-    getCategories: typeof getCategories;
-    getCart: typeof getCart;
-    getCartItemCount: typeof getCartItemCount;
-    getCartCoupon: typeof getCartCoupon;
-    getCartCouponSource: typeof getCartCouponSource;
-    setCartCoupon: typeof setCartCoupon;
-    clearCartCoupon: typeof clearCartCoupon;
-    addToCart: typeof addToCart;
-    setCartItem: typeof setCartItem;
-    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;
-    quoteCart: typeof quoteCart;
-    getLatestQuoteToken: typeof getLatestQuoteToken;
-    resolveCartLineId: typeof resolveCartLineId;
-    checkout: typeof checkout;
-    buildCheckoutUrl: typeof buildCheckoutUrl;
-    buildCheckoutUrlSync: typeof buildCheckoutUrlSync;
-    getRequestedCheckoutCurrency: typeof getRequestedCheckoutCurrency;
-    captureAffiliateFromUrl: typeof captureAffiliateFromUrl;
-    validateAffiliateCode: typeof validateAffiliateCode;
-    applyAffiliateCode: typeof applyAffiliateCode;
-    getAffiliateCode: typeof getAffiliateCode;
-    getStoredAffiliate: typeof getStoredAffiliate;
-    setAffiliateCode: typeof setAffiliateCode;
-    clearAffiliateCode: typeof clearAffiliateCode;
-    trackAffiliateEvent: typeof trackAffiliateEvent;
-    validateCoupon: typeof validateCoupon;
-    getShopReviews: typeof getShopReviews;
-    getShopReviewsPage: typeof getShopReviewsPage;
     requestOtp: typeof requestOtp;
     verifyOtp: typeof verifyOtp;
     logout: typeof logout;
@@ -2148,6 +2105,7 @@ declare const shoppex: {
     cancelSubscription: typeof cancelSubscription;
     pauseSubscription: typeof pauseSubscription;
     resumeSubscription: typeof resumeSubscription;
+    undoSubscriptionCancel: typeof undoSubscriptionCancel;
     favorites: typeof favorites;
     addFavorite: typeof addFavorite;
     removeFavorite: typeof removeFavorite;
@@ -2177,31 +2135,84 @@ declare const shoppex: {
     resellerOrder: typeof resellerOrder;
     resellerWallet: typeof resellerWallet;
     resellerApiKeys: typeof resellerApiKeys;
+    init: {
+        (storeSlug: string, options?: src.ShoppexInitOptions): void;
+        (options: src.ShoppexInitOptions & {
+            storeId: string;
+        }): void;
+    };
+    isInitialized: typeof isInitialized;
+    getConfig: typeof getConfig;
+    client: typeof getTypedClient;
+    getStore: typeof getStore;
+    getStorefront: typeof getStorefront;
+    getStoreLogoUrl: typeof getStoreLogoUrl;
+    getStoreBannerUrl: typeof getStoreBannerUrl;
+    resolveStoreByDomain: typeof resolveStoreByDomain;
+    getProducts: typeof getProducts;
+    getStorefrontProductsPage: typeof getStorefrontProductsPage;
+    getProduct: typeof getProduct;
+    getCategories: typeof getCategories;
+    getCart: typeof getCart;
+    getCartItemCount: typeof getCartItemCount;
+    getCartCoupon: typeof getCartCoupon;
+    getCartCouponSource: typeof getCartCouponSource;
+    setCartCoupon: typeof setCartCoupon;
+    clearCartCoupon: typeof clearCartCoupon;
+    addToCart: typeof addToCart;
+    setCartItem: typeof setCartItem;
+    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;
+    quoteCart: typeof quoteCart;
+    getLatestQuoteToken: typeof getLatestQuoteToken;
+    resolveCartLineId: typeof resolveCartLineId;
+    checkout: typeof checkout;
+    buildCheckoutUrl: typeof buildCheckoutUrl;
+    buildCheckoutUrlSync: typeof buildCheckoutUrlSync;
+    getRequestedCheckoutCurrency: typeof getRequestedCheckoutCurrency;
+    captureAffiliateFromUrl: typeof captureAffiliateFromUrl;
+    validateAffiliateCode: typeof validateAffiliateCode;
+    applyAffiliateCode: typeof applyAffiliateCode;
+    getAffiliateCode: typeof getAffiliateCode;
+    getStoredAffiliate: typeof getStoredAffiliate;
+    setAffiliateCode: typeof setAffiliateCode;
+    clearAffiliateCode: typeof clearAffiliateCode;
+    trackAffiliateEvent: typeof trackAffiliateEvent;
+    validateCoupon: typeof validateCoupon;
+    getShopReviews: typeof getShopReviews;
+    getShopReviewsPage: typeof src.getShopReviewsPage;
     searchProducts: typeof searchProducts;
     searchCatalogItems: typeof searchCatalogItems;
     getInvoice: typeof getInvoice;
     getInvoiceStatus: typeof getInvoiceStatus;
     getPages: typeof getPages;
     getPage: typeof getPage;
-    getMenus: typeof getMenus;
-    getMenu: typeof getMenu;
-    getMenuBySlot: typeof getMenuBySlot;
-    getMenuByTitle: typeof getMenuByTitle;
-    getMenuSlotTitles: typeof getMenuSlotTitles;
-    trackPageView: typeof trackPageView;
-    trackCartActivity: typeof trackCartActivity;
-    getStorefrontOnlineUsers: typeof getStorefrontOnlineUsers;
-    getStorefrontRecentSales: typeof getStorefrontRecentSales;
-    touchStorefrontPresence: typeof touchStorefrontPresence;
+    getMenus: typeof src.getMenus;
+    getMenu: typeof src.getMenu;
+    getMenuBySlot: typeof src.getMenuBySlot;
+    getMenuByTitle: typeof src.getMenuByTitle;
+    getMenuSlotTitles: typeof src.getMenuSlotTitles;
+    trackPageView: typeof src.trackPageView;
+    trackCartActivity: typeof src.trackCartActivity;
+    getStorefrontOnlineUsers: typeof src.getStorefrontOnlineUsers;
+    getStorefrontRecentSales: typeof src.getStorefrontRecentSales;
+    touchStorefrontPresence: typeof src.touchStorefrontPresence;
     createFormatter: typeof createFormatter;
     formatPrice: typeof formatPrice;
     clearCache: typeof clearCache;
     invalidateCache: typeof invalidateCache;
     getCacheStats: typeof getCacheStats;
-    fetchPublishedBuilderSettings: typeof fetchPublishedBuilderSettings;
-    fetchPublishedThemeSettings: typeof fetchPublishedThemeSettings;
-    resolveDefaults: typeof resolveDefaults;
-    mergeSettings: typeof mergeSettings;
+    fetchPublishedBuilderSettings: typeof src.fetchPublishedBuilderSettings;
+    fetchPublishedThemeSettings: typeof src.fetchPublishedThemeSettings;
+    resolveDefaults: typeof src.resolveDefaults;
+    mergeSettings: typeof src.mergeSettings;
 };
 
-export { type AffiliateValidation, ApiError, type ApiResponse, type BlockDefinition, type BlockInstance, type BuyerRewardActivityItem, type BuyerRewards, CURRENCY_UNAVAILABLE_ERROR_CODE, type CartAddOptions, type CartAddon, type CartAppliedDiscount, type CartBasketMergeLine, type CartCodeSource, CartError, type CartItem, type CartItemUpdate, type CartLineIdentityInput, type CartMetadata, type CartPayload, type CartQuote, type CartQuoteLine, type CartStats, type Category, CheckoutCreateError, type CheckoutOptions, type CheckoutResult, type CouponValidation, type CouponValidationOptions, type CursorPagination, type CustomFieldDefinition, type CustomerAffiliateLinkInput, type CustomerEmailPreferencesPatch, type CustomerInvoicePdf, type CustomerNotificationPreferencesPatch, type CustomerProfilePatch, type CustomerSubscriptionCancelOptions, type CustomerTicketPayload, type EligibleBundleDeal, type EligibleBundleDealProduct, type EligibleCartDeal, type Feedback, type Invoice, type InvoiceProduct, type Menu, type MenuItem, NetworkError, NotInitializedError, PRODUCT_FILTER_UNSUPPORTED, type Page, type PageLayout, type PriceVariant, type Product, type ProductAddon, type ProductBundle, type ProductBundleProduct, type ProductCategory, type ProductDescriptionTab, type ProductFaq, type ProductFeedback, type ProductGroup, type ProductImage, type ProductVariant, type PublishedBuilderSettings, type PublishedThemeSettingsPayload, type ResellerCatalogQuery, type ResellerOrderItem, type ResellerOrdersQuery, type ResolvedThemeSettings, type RewardActionType, type RewardGrantStatus, type RewardProgramSummary, type RewardProgramTeaserItem, type RewardReason, type SDKResponse, type SearchOptions, type SectionDefinition, type SettingField, type Shop, type ShopFeedback, type ShopReviewsPage, type ShopReviewsSummary, type ShopTheme, type ShoppexConfig, ShoppexError, type ShoppexInitOptions, type StorefrontAddon, type StorefrontAddonBootstrap, type StorefrontAnnouncementBarAddon, type StorefrontCatalogSearchItem, type StorefrontContactTicketInput, type StorefrontContactTicketResult, type StorefrontCountdownBarAddon, type StorefrontCouponPopupModalAddon, type StorefrontCustomField, type StorefrontData, type StorefrontItem, type StorefrontOnlineUsers, type StorefrontPromoInfoCardAddon, type StorefrontRecentPurchasePopupAddon, type StorefrontRecentSaleEntry, type StorefrontRecentSales, type StorefrontSearchFilterOptions, type StorefrontSocialLinks, type Subscription, type SubscriptionFlags, type SubscriptionInterval, type ThemeBlockManifest, type ThemeConfig, type TrustedChecks, ValidationError, acceptResellerInvite, addFavorite, affiliate, affiliateStats, applyForReseller, buildStorefrontContactMessage, buildStorefrontCustomFieldPayload, buildStorefrontProductLookup, cancelSubscription, claimWarranty, collectProductSearchHaystack, computeCartLineId, createAffiliateLink, createTicket, dashboard, shoppex as default, emailPreferences, enrollAsReseller, ensureCartLineId, favorites, fetchPublishedBuilderSettings, fetchPublishedThemeSettings, filterProductsBySearchQuery, getMenu, getMenuBySlot, getMenuByTitle, getMenuSlotTitles, getMenus, getMergedStorefrontProducts, getShopReviewsPage, getStorefrontGroupProducts, getStorefrontOnlineUsers, getStorefrontRecentSales, groupMatchesSearchQuery, invoicePdf, isProductInStock, isProductOutOfStock, isStorefrontCheckboxCustomFieldValueChecked, isVariantOutOfStock, logout, loyalty, me, mergeSettings, normalizeSearchQuery, normalizeStorefrontCustomFields, notificationPreferences, order, orders, pauseSubscription, productMatchesSearchQuery, quoteResellerOrder, redeemLoyaltyPoints, removeAvatar, removeFavorite, replyToTicket, requestOtp, reseller, resellerApiKeys, resellerCatalog, resellerOrder, resellerOrders, resellerWallet, resetLicenseHwid, resolveDefaults, resolveDisplayStock, resolveStorefrontApiBaseUrl, resolveStorefrontSocialLinks, resolveVariantStockValue, resumeSubscription, revokeAllSessions, revokeSession, searchMergedStorefrontCatalog, searchMergedStorefrontCatalogItems, sessions, shoppex, stripHtmlFromText, submitStorefrontContactTicket, subscriptionBillingHistory, ticket, touchStorefrontPresence, trackCartActivity, trackPageView, updateAvatar, updateEmailPreferences, updateNotificationPreferences, updateProfile, validateStorefrontCustomFieldValue, verifyOtp, warranties };
+export { type AffiliateValidation, ApiError, type ApiResponse, type BlockDefinition, type BlockInstance, type BuyerRewardActivityItem, type BuyerRewards, CURRENCY_UNAVAILABLE_ERROR_CODE, type CartAddOptions, type CartAddon, type CartAppliedDiscount, type CartBasketMergeLine, type CartCodeSource, CartError, type CartItem, type CartItemUpdate, type CartLineIdentityInput, type CartMetadata, type CartPayload, type CartQuote, type CartQuoteLine, type CartStats, type Category, CheckoutCreateError, type CheckoutOptions, type CheckoutResult, type CouponValidation, type CouponValidationOptions, type CursorPagination, type CustomFieldDefinition, type CustomerAffiliateLinkInput, type CustomerEmailPreferencesPatch, type CustomerInvoicePdf, type CustomerNotificationPreferencesPatch, type CustomerProfilePatch, type CustomerSubscriptionCancelOptions, type CustomerTicketPayload, type EligibleBundleDeal, type EligibleBundleDealProduct, type EligibleCartDeal, type Feedback, type Invoice, type InvoiceProduct, type Menu, type MenuItem, NetworkError, NotInitializedError, PRODUCT_FILTER_UNSUPPORTED, type Page, type PageLayout, type PriceVariant, type Product, type ProductAddon, type ProductBundle, type ProductBundleProduct, type ProductCategory, type ProductDescriptionTab, type ProductFaq, type ProductFeedback, type ProductGroup, type ProductImage, type ProductVariant, type PublishedBuilderSettings, type PublishedThemeSettingsPayload, type ResellerCatalogQuery, type ResellerOrderItem, type ResellerOrdersQuery, type ResolvedThemeSettings, type RewardActionType, type RewardGrantStatus, type RewardProgramSummary, type RewardProgramTeaserItem, type RewardReason, type SDKResponse, type SearchOptions, type SectionDefinition, type SettingField, type Shop, type ShopFeedback, type ShopReviewsPage, type ShopReviewsSummary, type ShopTheme, type ShoppexConfig, ShoppexError, type ShoppexInitOptions, type StorefrontAddon, type StorefrontAddonBootstrap, type StorefrontAnnouncementBarAddon, type StorefrontCatalogSearchItem, type StorefrontContactTicketInput, type StorefrontContactTicketResult, type StorefrontCountdownBarAddon, type StorefrontCouponPopupModalAddon, type StorefrontCustomField, type StorefrontData, type StorefrontItem, type StorefrontOnlineUsers, type StorefrontPromoInfoCardAddon, type StorefrontRecentPurchasePopupAddon, type StorefrontRecentSaleEntry, type StorefrontRecentSales, type StorefrontSearchFilterOptions, type StorefrontSocialLinks, type Subscription, type SubscriptionFlags, type SubscriptionInterval, type ThemeBlockManifest, type ThemeConfig, type TrustedChecks, ValidationError, acceptResellerInvite, addFavorite, affiliate, affiliateStats, applyForReseller, buildStorefrontContactMessage, buildStorefrontCustomFieldPayload, buildStorefrontProductLookup, cancelSubscription, claimWarranty, collectProductSearchHaystack, computeCartLineId, createAffiliateLink, createTicket, dashboard, shoppex as default, emailPreferences, enrollAsReseller, ensureCartLineId, favorites, fetchPublishedBuilderSettings, fetchPublishedThemeSettings, filterProductsBySearchQuery, getMenu, getMenuBySlot, getMenuByTitle, getMenuSlotTitles, getMenus, getMergedStorefrontProducts, getShopReviewsPage, getStorefrontGroupProducts, getStorefrontOnlineUsers, getStorefrontRecentSales, groupMatchesSearchQuery, invoicePdf, isProductInStock, isProductOutOfStock, isStorefrontCheckboxCustomFieldValueChecked, isVariantOutOfStock, logout, loyalty, me, mergeSettings, normalizeSearchQuery, normalizeStorefrontCustomFields, notificationPreferences, order, orders, pauseSubscription, productMatchesSearchQuery, quoteResellerOrder, redeemLoyaltyPoints, removeAvatar, removeFavorite, replyToTicket, requestOtp, reseller, resellerApiKeys, resellerCatalog, resellerOrder, resellerOrders, resellerWallet, resetLicenseHwid, resolveDefaults, resolveDisplayStock, resolveStorefrontApiBaseUrl, resolveStorefrontSocialLinks, resolveVariantStockValue, resumeSubscription, revokeAllSessions, revokeSession, searchMergedStorefrontCatalog, searchMergedStorefrontCatalogItems, sessions, shoppex, stripHtmlFromText, submitStorefrontContactTicket, subscriptionBillingHistory, ticket, touchStorefrontPresence, trackCartActivity, trackPageView, undoSubscriptionCancel, updateAvatar, updateEmailPreferences, updateNotificationPreferences, updateProfile, validateStorefrontCustomFieldValue, verifyOtp, warranties };