@behio/storefront-sdk 2.13.0 → 2.14.0

package/dist/{client-Cf_xibuw.d.mts → client-DB_ve5Fp.d.mts}

@@ -508,7 +508,7 @@ interface ProductLabel {
     id: string;
     slug: string;
     name: string;
-    color?: string;
+    color?: string | null;
     /** Merchant icon name. Render a trusted local icon, with a safe fallback. */
     iconName?: string | null;
 }
@@ -538,9 +538,9 @@ interface ProductListItem {
     id: string;
     slug: string;
     name: string;
-    shortDescription?: string;
+    shortDescription?: string | null;
     sku: string;
-    gtin?: string;
+    gtin?: string | null;
     /** `null` when prices are gated behind login for guests (B2B mode). */
     price: ProductPrice | null;
     inStock: boolean;
@@ -629,6 +629,9 @@ interface ProductListItem {
         url: string;
         alt: string | null;
         order: number;
+        /** COVER | LISTING | HOVER | GALLERY when the cover came from a roled
+         *  product image; absent when it came from the inventory gallery (SDK 2.14.0). */
+        role?: string;
     } | null;
     labels: ProductLabel[];
     isFeatured: boolean;
@@ -843,7 +846,19 @@ interface ProductDetail extends ProductListItem {
      *  null when uncapped or the shop hides stock counts. Cap the PDP quantity
      *  stepper with it, it is exactly the cart rule. SDK 2.13.0. */
     maxPurchasableQuantity?: number | null;
-    longDescription?: string;
+    /**
+     * @deprecated Not sent on the product detail, only on list cards. Use
+     * `media` (or `images`) for the gallery.
+     */
+    image?: ProductListItem["image"];
+    /** @deprecated Not sent on the product detail, only on list cards. */
+    hoverImageUrl?: string | null;
+    /**
+     * @deprecated Not sent on the product detail, only on list cards. Read the
+     * PDP promotions with `catalog.getProductPromotions(slug)`.
+     */
+    activePromotion?: ProductPromotionSummary | null;
+    longDescription?: string | null;
     /**
      * @deprecated Legacy per-listing images. Prefer `media`. Each carries its
      * `role` (COVER | LISTING | HOVER | GALLERY) so the storefront can pick a
@@ -851,7 +866,7 @@ interface ProductDetail extends ProductListItem {
      */
     images: Array<{
         url: string;
-        alt?: string;
+        alt?: string | null;
         order: number;
         role?: string;
     }>;
@@ -919,6 +934,10 @@ interface ProductDetail extends ProductListItem {
         ogDescription?: string | null;
         ogImage?: string | null;
     };
+    /**
+     * @deprecated Never sent by the API. Load a group with
+     * `catalog.getProductGroup(slug)`.
+     */
     productGroups?: Array<{
         slug: string;
         name: string;
@@ -940,8 +959,8 @@ interface Category {
     id: string;
     slug: string;
     name: string;
-    description?: string;
-    imageUrl?: string;
+    description?: string | null;
+    imageUrl?: string | null;
     children: Category[];
     productCount?: number;
 }
@@ -1004,11 +1023,18 @@ interface Menu {
     locale: string;
     items: MenuItem[];
 }
-interface CategoryDetail extends Category {
+interface CategoryDetail extends Omit<Category, "children"> {
+    /**
+     * @deprecated Never sent on the category detail (it was typed as always
+     * present, so `children.map` crashed). Read subcategories from
+     * `catalog.getCategories()`.
+     */
+    children?: Category[];
     /**
      * SEO/Open Graph for the category page. Matches the backend's nested `seo`
      * shape (the old flat `seoTitle`/`seoDescription` never matched what the API
-     * returned). `keywords` is always null for categories.
+     * returned). `keywords` is always null for categories. Null when the
+     * category has no text in the requested language (SDK 2.14.0 types it).
      */
     seo?: {
         title?: string | null;
@@ -1017,7 +1043,7 @@ interface CategoryDetail extends Category {
         ogTitle?: string | null;
         ogDescription?: string | null;
         ogImage?: string | null;
-    };
+    } | null;
 }
 /**
  * One available filter, derived from a curated parameter the merchant marked
@@ -1035,7 +1061,7 @@ interface FilterField {
     groupSlug: string;
     groupName: string;
     unit?: string | null;
-    values?: string[];
+    values?: string[] | null;
 }
 interface FacetValue {
     /** Raw stored value (normalized), for exact filtering. */
@@ -1286,7 +1312,7 @@ interface CartItemProduct {
      *  arbitrary translation row, so this could come back in another language. */
     name: string;
     sku: string;
-    imageUrl?: string;
+    imageUrl?: string | null;
     inStock: boolean;
     /** Pieces left for an "only X left" note on the cart line; null when the
      *  shop does not track stock, hides the nudge or has plenty. SDK 2.13.0. */
@@ -1384,7 +1410,7 @@ interface Cart {
      *  200 net" was 20, now it is 24.20 at 21 %). It lowers base and VAT, see
      *  `taxBreakdown` and `vatTotal`. */
     discountTotal: number;
-    discount?: CartDiscount;
+    discount?: CartDiscount | null;
     /** Auto-apply promotion discount lines (sale/BOGO). */
     appliedPromotions: CartPromotion[];
     /** Sum of `appliedPromotions[].discountAmount`; already reflected in `grandTotal`. */
@@ -1589,6 +1615,12 @@ interface CheckoutInput {
      * guests. See `customer.getLoyalty()` for the available balance.
      */
     redeemLoyaltyPoints?: number;
+    /**
+     * Cart session to order. The SDK sends it in the `X-Cart-Session` header on
+     * its own, so leave it out; the body field is for clients without the
+     * header (SDK 2.14.0 documents it, the backend has always accepted it).
+     */
+    sessionToken?: string;
 }
 type OrderStatus = (typeof OrderStatuses)[keyof typeof OrderStatuses];
 type PaymentStatus = (typeof PaymentStatuses)[keyof typeof PaymentStatuses];
@@ -1604,6 +1636,8 @@ interface OrderListItem {
     createdAt: number;
 }
 interface OrderItem {
+    /** Order line id (SDK 2.14.0). */
+    id?: string;
     productName: string;
     sku: string;
     /** Photo snapshot from checkout, or the product's current photo. */
@@ -1615,9 +1649,23 @@ interface OrderItem {
     productSlug?: string | null;
     quantity: number;
     unitPrice: number;
+    /** VAT rate of the line in percent, e.g. 21 (SDK 2.14.0). */
+    taxRate?: number;
+    /** VAT of the whole line (SDK 2.14.0). */
+    taxAmount?: number;
     totalPrice: number;
     totalPriceWithTax: number;
 }
+/** A discount code applied to an order (SDK 2.14.0). */
+interface OrderDiscount {
+    code: string;
+    /** PERCENTAGE, FIXED_AMOUNT or FREE_SHIPPING. */
+    type: string;
+    /** Percent or amount as configured on the code. */
+    value: number;
+    /** Money the code took off this order. */
+    appliedAmount: number;
+}
 /**
  * PII-minimized order view returned by `orders.track(token)`. The tracking
  * token is shared in URLs and e-mails, so this deliberately omits full
@@ -1670,9 +1718,14 @@ interface OrderShipment {
     createdAt: number;
 }
 interface OrderStatusHistory {
-    fromStatus?: OrderStatus;
+    /** Null for the first entry of an order. */
+    fromStatus?: OrderStatus | null;
     toStatus: OrderStatus;
-    note?: string;
+    note?: string | null;
+    /**
+     * @deprecated Never sent: who changed the status is internal to the shop.
+     * Kept only so existing templates keep compiling.
+     */
     changedBy?: string;
     createdAt: number;
 }
@@ -1709,8 +1762,8 @@ interface OrderDetail extends OrderListItem {
     shippingAddress: CheckoutAddress;
     billingAddress: CheckoutAddress;
     email: string;
-    phone?: string;
-    customerNote?: string;
+    phone?: string | null;
+    customerNote?: string | null;
     subtotal: number;
     /** Goods VAT before order discounts (goods subtotal = `subtotal` + `taxTotal`). */
     taxTotal: number;
@@ -1732,6 +1785,12 @@ interface OrderDetail extends OrderListItem {
     discountTotal: number;
     fulfillmentStatus: FulfillmentStatus;
     statusHistory: OrderStatusHistory[];
+    /** Discount codes applied to the order (SDK 2.14.0). */
+    discounts?: OrderDiscount[];
+    /**
+     * @deprecated Not sent on the order detail. Only `checkout.createOrder()`
+     * returns it, see `CheckoutResult.trackingToken`.
+     */
     trackingToken?: string;
     /**
      * Digital product delivery (GAP-07): download grants for any digital assets
@@ -2051,10 +2110,12 @@ interface DownloadUrl {
 interface CustomerProfile {
     id: string;
     email: string;
-    firstName?: string;
-    lastName?: string;
-    phone?: string;
+    firstName?: string | null;
+    lastName?: string | null;
+    phone?: string | null;
     emailVerified: boolean;
+    /** Registration time (Unix ms). */
+    createdAt?: number;
     /**
      * B2B approval gate (GAP-19). `false` = the account is awaiting merchant
      * approval (or was deactivated) — show a "pending approval" banner and gate
@@ -2070,7 +2131,8 @@ interface CustomerAddress {
     isDefault: boolean;
     firstName: string;
     lastName: string;
-    company?: string;
+    /** Null when not set. Send null on update to clear it. */
+    company?: string | null;
     street: string;
     city: string;
     zip: string;
@@ -2088,7 +2150,8 @@ interface CustomerAddress {
     vatIdValid?: boolean | null;
     /** When the VAT ID was last checked (ms). Read-only. */
     vatIdCheckedAt?: number | null;
-    phone?: string;
+    /** Null when not set. Send null on update to clear it. */
+    phone?: string | null;
 }
 interface Page {
     slug: string;
@@ -3189,6 +3252,7 @@ declare class BehioStorefront {
         visitorId: string;
         email: string;
     }): Promise<SdkResult<{
+        /** Single-use code for the offered product, issued by this call. */
         code: string;
         percent: number;
         expiresAt: number;
@@ -3955,6 +4019,8 @@ interface AddressDetail {
     formattedAddress: string;
     lat: number;
     lng: number;
+    /** Set (and the address fields empty) when the request had no `placeId`. */
+    error?: string | null;
 }
 declare class AddressModule {
     private client;
@@ -4041,4 +4107,4 @@ declare function clearCartSummary(): void;
 /** Publish only authoritative current totals; server cart consumers call this after hydration and revalidation. */
 declare function publishCartSummary(summary: CartSummaryEvent): void;
 
-export { type CourseCommentReply as $, type ActivePromotion as A, BehioStorefront as B, type CookieConsent as C, type Cart as D, type CartBundleLine as E, type CartBundleLineItem as F, type CartDiscount as G, type CartItem as H, type CartItemProduct as I, type CartLinkClaimed as J, type CartPromotion as K, type CartSummaryEvent as L, type Category as M, type CategoryDetail as N, type CertificateVerification as O, type ProductDetail as P, type CheckoutAddress as Q, type CheckoutInput as R, type SdkResult as S, type CheckoutPaymentMethod as T, type CheckoutPreview as U, type CheckoutResult as V, type CheckoutSettings as W, type CookieConsentInput as X, type CourseAttachment as Y, type CourseCertificate as Z, type CourseComment as _, type ProductVariant as a, type OrderPickupPoint as a$, type CourseCommentsList as a0, type CourseDetail as a1, type CourseLesson as a2, type CourseListItem as a3, type CourseModule as a4, type CoursePostedComment as a5, type CourseProgress as a6, type CourseTutorMessage as a7, type CourseTutorThread as a8, type CrossSellItem as a9, type LessonNote as aA, type LessonQuiz as aB, type LoginInput as aC, type LoyaltyBalance as aD, type LoyaltyNextTier as aE, type LoyaltyProgram as aF, type LoyaltyQuery as aG, type LoyaltyReferralResult as aH, type LoyaltySummary as aI, type LoyaltyTier as aJ, type LoyaltyTierPerks as aK, type LoyaltyTransaction as aL, type Menu as aM, type MenuItem as aN, type MenuItemRef as aO, type MenuItemType as aP, type MessageResponse as aQ, type NewsletterOptInDefault as aR, type NewsletterSubscribeInput as aS, type NewsletterSubscribeResult as aT, type NewsletterUnsubscribeResult as aU, type OrderAccessRequestResponse as aV, type OrderAccessVerifyResponse as aW, type OrderDetail as aX, type OrderItem as aY, type OrderListItem as aZ, type OrderPaymentInstructions as a_, type CurrencyDisplayFormat as aa, type CustomerAddress as ab, type CustomerBadge as ac, type CustomerChallenge as ad, type CustomerGamification as ae, type CustomerGamificationQuery as af, type CustomerProfile as ag, type DigitalDownload as ah, type DownloadUrl as ai, type Facet as aj, type FacetAvailability as ak, type FacetCategory as al, type FacetLabel as am, type FacetPriceRange as an, type FacetRange as ao, type FacetRatingBucket as ap, type FacetValue as aq, type FacetsResponse as ar, type FilterField as as, type FulfillmentStatus as at, FulfillmentStatuses as au, type GamificationRefreshResult as av, type GiftCardBalance as aw, type GiftCardPurchaseInput as ax, type GiftCardPurchaseResult as ay, type GiftCardSummary as az, type StorefrontFormFieldError as b, type ShopScriptPlacement as b$, type OrderShipment as b0, type OrderStatus as b1, type OrderStatusHistory as b2, OrderStatuses as b3, type OrderTracking as b4, type Page as b5, type PageAttachment as b6, type PageDetail as b7, type PaginatedResponse as b8, type PaymentInstrument as b9, type ProductVolumePrice as bA, type ProductsQuery as bB, type QuizAnswerInput as bC, type QuizAnswerResult as bD, type QuizQuestion as bE, type QuizResult as bF, type QuoteItem as bG, type QuoteRequest as bH, type RegisterInput as bI, type RegisterResult as bJ, type RequestInterceptor as bK, type RequestInterceptorConfig as bL, type ResponseInterceptor as bM, type ResponseInterceptorData as bN, type ReturnRequest as bO, type ReturnRequestItem as bP, type ReturnStatus as bQ, type ReturnStatusItem as bR, type ReturnableOrder as bS, type ReturnableOrderItem as bT, type SdkError as bU, type ShippingMethodSummary as bV, type ShippingQuote as bW, type ShippingQuoteInput as bX, type ShopAppearance as bY, type ShopInfo as bZ, type ShopScript as b_, type PaymentStatus as ba, PaymentStatuses as bb, type PaymentSwift as bc, type PickupPoint as bd, type PickupPointHours as be, type PickupPointsInput as bf, type PickupWidgetConfig as bg, type PriceDisplay as bh, type ProductAssetGroup as bi, type ProductAssetItem as bj, type ProductAvailability as bk, type ProductGroup as bl, type ProductLabel as bm, type ProductListItem as bn, type ProductMedia as bo, type ProductMediaVariant as bp, type ProductParameter as bq, type ProductParameterGroup as br, type ProductParametersResponse as bs, type ProductPrice as bt, type ProductPromotionSummary as bu, type ProductReview as bv, type ProductReviewsResponse as bw, type ProductSibling as bx, ProductSort as by, type ProductSortValue as bz, type AddToCartInput as c, type ShopScriptType as c0, type ShopScripts as c1, type ShopSeo as c2, type ShopSeoIdentity as c3, type SiteFormField as c4, type SiteFormFieldOption as c5, type SiteFormFieldType as c6, type Sitemap as c7, type SitemapEntry as c8, type StockBehavior as c9, type StockMode as ca, type StorefrontForm as cb, type StorefrontFormFieldErrorCode as cc, type StorefrontFormFile as cd, type StorefrontFormSettings as ce, type StorefrontFormSubmitInput as cf, type StorefrontFormSubmitResult as cg, type StorefrontFormUpload as ch, type SubmitQuoteInput as ci, type SubmitReturnInput as cj, type SubmitReviewInput as ck, type Subscription as cl, type SubscriptionAction as cm, type SubscriptionFrequency as cn, type SubscriptionItem as co, type SubscriptionStatus as cp, type TaxBreakdownLine as cq, type VariantAxis as cr, type VariantAxisValue as cs, type WishlistItem as ct, clearCartSummary as cu, err as cv, ok as cw, publishCartSummary as cx, toSdkError as cy, type AddressDetail as d, type AddressSuggestion as e, type AddressType as f, AddressTypes as g, type AuthTokens as h, type BackInStockSubscription as i, type BadgeTone as j, BehioApiError as k, type BehioErrorCode as l, type BehioEventHandler as m, type BehioEventType as n, BehioNetworkError as o, type BehioStorefrontConfig as p, type Blog as q, type BlogPostDetail as r, type BlogPostListItem as s, type BlogPostsPage as t, type BlogPostsQuery as u, type BlogSettings as v, type BlogTag as w, type Bundle as x, type BundleCatalogQuery as y, type BundleItem as z };
+export { type CourseCommentReply as $, type ActivePromotion as A, BehioStorefront as B, type CookieConsent as C, type Cart as D, type CartBundleLine as E, type CartBundleLineItem as F, type CartDiscount as G, type CartItem as H, type CartItemProduct as I, type CartLinkClaimed as J, type CartPromotion as K, type CartSummaryEvent as L, type Category as M, type CategoryDetail as N, type CertificateVerification as O, type ProductDetail as P, type CheckoutAddress as Q, type CheckoutInput as R, type SdkResult as S, type CheckoutPaymentMethod as T, type CheckoutPreview as U, type CheckoutResult as V, type CheckoutSettings as W, type CookieConsentInput as X, type CourseAttachment as Y, type CourseCertificate as Z, type CourseComment as _, type ProductVariant as a, type OrderPaymentInstructions as a$, type CourseCommentsList as a0, type CourseDetail as a1, type CourseLesson as a2, type CourseListItem as a3, type CourseModule as a4, type CoursePostedComment as a5, type CourseProgress as a6, type CourseTutorMessage as a7, type CourseTutorThread as a8, type CrossSellItem as a9, type LessonNote as aA, type LessonQuiz as aB, type LoginInput as aC, type LoyaltyBalance as aD, type LoyaltyNextTier as aE, type LoyaltyProgram as aF, type LoyaltyQuery as aG, type LoyaltyReferralResult as aH, type LoyaltySummary as aI, type LoyaltyTier as aJ, type LoyaltyTierPerks as aK, type LoyaltyTransaction as aL, type Menu as aM, type MenuItem as aN, type MenuItemRef as aO, type MenuItemType as aP, type MessageResponse as aQ, type NewsletterOptInDefault as aR, type NewsletterSubscribeInput as aS, type NewsletterSubscribeResult as aT, type NewsletterUnsubscribeResult as aU, type OrderAccessRequestResponse as aV, type OrderAccessVerifyResponse as aW, type OrderDetail as aX, type OrderDiscount as aY, type OrderItem as aZ, type OrderListItem as a_, type CurrencyDisplayFormat as aa, type CustomerAddress as ab, type CustomerBadge as ac, type CustomerChallenge as ad, type CustomerGamification as ae, type CustomerGamificationQuery as af, type CustomerProfile as ag, type DigitalDownload as ah, type DownloadUrl as ai, type Facet as aj, type FacetAvailability as ak, type FacetCategory as al, type FacetLabel as am, type FacetPriceRange as an, type FacetRange as ao, type FacetRatingBucket as ap, type FacetValue as aq, type FacetsResponse as ar, type FilterField as as, type FulfillmentStatus as at, FulfillmentStatuses as au, type GamificationRefreshResult as av, type GiftCardBalance as aw, type GiftCardPurchaseInput as ax, type GiftCardPurchaseResult as ay, type GiftCardSummary as az, type StorefrontFormFieldError as b, type ShopScript as b$, type OrderPickupPoint as b0, type OrderShipment as b1, type OrderStatus as b2, type OrderStatusHistory as b3, OrderStatuses as b4, type OrderTracking as b5, type Page as b6, type PageAttachment as b7, type PageDetail as b8, type PaginatedResponse as b9, type ProductSortValue as bA, type ProductVolumePrice as bB, type ProductsQuery as bC, type QuizAnswerInput as bD, type QuizAnswerResult as bE, type QuizQuestion as bF, type QuizResult as bG, type QuoteItem as bH, type QuoteRequest as bI, type RegisterInput as bJ, type RegisterResult as bK, type RequestInterceptor as bL, type RequestInterceptorConfig as bM, type ResponseInterceptor as bN, type ResponseInterceptorData as bO, type ReturnRequest as bP, type ReturnRequestItem as bQ, type ReturnStatus as bR, type ReturnStatusItem as bS, type ReturnableOrder as bT, type ReturnableOrderItem as bU, type SdkError as bV, type ShippingMethodSummary as bW, type ShippingQuote as bX, type ShippingQuoteInput as bY, type ShopAppearance as bZ, type ShopInfo as b_, type PaymentInstrument as ba, type PaymentStatus as bb, PaymentStatuses as bc, type PaymentSwift as bd, type PickupPoint as be, type PickupPointHours as bf, type PickupPointsInput as bg, type PickupWidgetConfig as bh, type PriceDisplay as bi, type ProductAssetGroup as bj, type ProductAssetItem as bk, type ProductAvailability as bl, type ProductGroup as bm, type ProductLabel as bn, type ProductListItem as bo, type ProductMedia as bp, type ProductMediaVariant as bq, type ProductParameter as br, type ProductParameterGroup as bs, type ProductParametersResponse as bt, type ProductPrice as bu, type ProductPromotionSummary as bv, type ProductReview as bw, type ProductReviewsResponse as bx, type ProductSibling as by, ProductSort as bz, type AddToCartInput as c, type ShopScriptPlacement as c0, type ShopScriptType as c1, type ShopScripts as c2, type ShopSeo as c3, type ShopSeoIdentity as c4, type SiteFormField as c5, type SiteFormFieldOption as c6, type SiteFormFieldType as c7, type Sitemap as c8, type SitemapEntry as c9, type StockBehavior as ca, type StockMode as cb, type StorefrontForm as cc, type StorefrontFormFieldErrorCode as cd, type StorefrontFormFile as ce, type StorefrontFormSettings as cf, type StorefrontFormSubmitInput as cg, type StorefrontFormSubmitResult as ch, type StorefrontFormUpload as ci, type SubmitQuoteInput as cj, type SubmitReturnInput as ck, type SubmitReviewInput as cl, type Subscription as cm, type SubscriptionAction as cn, type SubscriptionFrequency as co, type SubscriptionItem as cp, type SubscriptionStatus as cq, type TaxBreakdownLine as cr, type VariantAxis as cs, type VariantAxisValue as ct, type WishlistItem as cu, clearCartSummary as cv, err as cw, ok as cx, publishCartSummary as cy, toSdkError as cz, type AddressDetail as d, type AddressSuggestion as e, type AddressType as f, AddressTypes as g, type AuthTokens as h, type BackInStockSubscription as i, type BadgeTone as j, BehioApiError as k, type BehioErrorCode as l, type BehioEventHandler as m, type BehioEventType as n, BehioNetworkError as o, type BehioStorefrontConfig as p, type Blog as q, type BlogPostDetail as r, type BlogPostListItem as s, type BlogPostsPage as t, type BlogPostsQuery as u, type BlogSettings as v, type BlogTag as w, type Bundle as x, type BundleCatalogQuery as y, type BundleItem as z };

package/dist/{client-Cf_xibuw.d.ts → client-DB_ve5Fp.d.ts}

@@ -508,7 +508,7 @@ interface ProductLabel {
     id: string;
     slug: string;
     name: string;
-    color?: string;
+    color?: string | null;
     /** Merchant icon name. Render a trusted local icon, with a safe fallback. */
     iconName?: string | null;
 }
@@ -538,9 +538,9 @@ interface ProductListItem {
     id: string;
     slug: string;
     name: string;
-    shortDescription?: string;
+    shortDescription?: string | null;
     sku: string;
-    gtin?: string;
+    gtin?: string | null;
     /** `null` when prices are gated behind login for guests (B2B mode). */
     price: ProductPrice | null;
     inStock: boolean;
@@ -629,6 +629,9 @@ interface ProductListItem {
         url: string;
         alt: string | null;
         order: number;
+        /** COVER | LISTING | HOVER | GALLERY when the cover came from a roled
+         *  product image; absent when it came from the inventory gallery (SDK 2.14.0). */
+        role?: string;
     } | null;
     labels: ProductLabel[];
     isFeatured: boolean;
@@ -843,7 +846,19 @@ interface ProductDetail extends ProductListItem {
      *  null when uncapped or the shop hides stock counts. Cap the PDP quantity
      *  stepper with it, it is exactly the cart rule. SDK 2.13.0. */
     maxPurchasableQuantity?: number | null;
-    longDescription?: string;
+    /**
+     * @deprecated Not sent on the product detail, only on list cards. Use
+     * `media` (or `images`) for the gallery.
+     */
+    image?: ProductListItem["image"];
+    /** @deprecated Not sent on the product detail, only on list cards. */
+    hoverImageUrl?: string | null;
+    /**
+     * @deprecated Not sent on the product detail, only on list cards. Read the
+     * PDP promotions with `catalog.getProductPromotions(slug)`.
+     */
+    activePromotion?: ProductPromotionSummary | null;
+    longDescription?: string | null;
     /**
      * @deprecated Legacy per-listing images. Prefer `media`. Each carries its
      * `role` (COVER | LISTING | HOVER | GALLERY) so the storefront can pick a
@@ -851,7 +866,7 @@ interface ProductDetail extends ProductListItem {
      */
     images: Array<{
         url: string;
-        alt?: string;
+        alt?: string | null;
         order: number;
         role?: string;
     }>;
@@ -919,6 +934,10 @@ interface ProductDetail extends ProductListItem {
         ogDescription?: string | null;
         ogImage?: string | null;
     };
+    /**
+     * @deprecated Never sent by the API. Load a group with
+     * `catalog.getProductGroup(slug)`.
+     */
     productGroups?: Array<{
         slug: string;
         name: string;
@@ -940,8 +959,8 @@ interface Category {
     id: string;
     slug: string;
     name: string;
-    description?: string;
-    imageUrl?: string;
+    description?: string | null;
+    imageUrl?: string | null;
     children: Category[];
     productCount?: number;
 }
@@ -1004,11 +1023,18 @@ interface Menu {
     locale: string;
     items: MenuItem[];
 }
-interface CategoryDetail extends Category {
+interface CategoryDetail extends Omit<Category, "children"> {
+    /**
+     * @deprecated Never sent on the category detail (it was typed as always
+     * present, so `children.map` crashed). Read subcategories from
+     * `catalog.getCategories()`.
+     */
+    children?: Category[];
     /**
      * SEO/Open Graph for the category page. Matches the backend's nested `seo`
      * shape (the old flat `seoTitle`/`seoDescription` never matched what the API
-     * returned). `keywords` is always null for categories.
+     * returned). `keywords` is always null for categories. Null when the
+     * category has no text in the requested language (SDK 2.14.0 types it).
      */
     seo?: {
         title?: string | null;
@@ -1017,7 +1043,7 @@ interface CategoryDetail extends Category {
         ogTitle?: string | null;
         ogDescription?: string | null;
         ogImage?: string | null;
-    };
+    } | null;
 }
 /**
  * One available filter, derived from a curated parameter the merchant marked
@@ -1035,7 +1061,7 @@ interface FilterField {
     groupSlug: string;
     groupName: string;
     unit?: string | null;
-    values?: string[];
+    values?: string[] | null;
 }
 interface FacetValue {
     /** Raw stored value (normalized), for exact filtering. */
@@ -1286,7 +1312,7 @@ interface CartItemProduct {
      *  arbitrary translation row, so this could come back in another language. */
     name: string;
     sku: string;
-    imageUrl?: string;
+    imageUrl?: string | null;
     inStock: boolean;
     /** Pieces left for an "only X left" note on the cart line; null when the
      *  shop does not track stock, hides the nudge or has plenty. SDK 2.13.0. */
@@ -1384,7 +1410,7 @@ interface Cart {
      *  200 net" was 20, now it is 24.20 at 21 %). It lowers base and VAT, see
      *  `taxBreakdown` and `vatTotal`. */
     discountTotal: number;
-    discount?: CartDiscount;
+    discount?: CartDiscount | null;
     /** Auto-apply promotion discount lines (sale/BOGO). */
     appliedPromotions: CartPromotion[];
     /** Sum of `appliedPromotions[].discountAmount`; already reflected in `grandTotal`. */
@@ -1589,6 +1615,12 @@ interface CheckoutInput {
      * guests. See `customer.getLoyalty()` for the available balance.
      */
     redeemLoyaltyPoints?: number;
+    /**
+     * Cart session to order. The SDK sends it in the `X-Cart-Session` header on
+     * its own, so leave it out; the body field is for clients without the
+     * header (SDK 2.14.0 documents it, the backend has always accepted it).
+     */
+    sessionToken?: string;
 }
 type OrderStatus = (typeof OrderStatuses)[keyof typeof OrderStatuses];
 type PaymentStatus = (typeof PaymentStatuses)[keyof typeof PaymentStatuses];
@@ -1604,6 +1636,8 @@ interface OrderListItem {
     createdAt: number;
 }
 interface OrderItem {
+    /** Order line id (SDK 2.14.0). */
+    id?: string;
     productName: string;
     sku: string;
     /** Photo snapshot from checkout, or the product's current photo. */
@@ -1615,9 +1649,23 @@ interface OrderItem {
     productSlug?: string | null;
     quantity: number;
     unitPrice: number;
+    /** VAT rate of the line in percent, e.g. 21 (SDK 2.14.0). */
+    taxRate?: number;
+    /** VAT of the whole line (SDK 2.14.0). */
+    taxAmount?: number;
     totalPrice: number;
     totalPriceWithTax: number;
 }
+/** A discount code applied to an order (SDK 2.14.0). */
+interface OrderDiscount {
+    code: string;
+    /** PERCENTAGE, FIXED_AMOUNT or FREE_SHIPPING. */
+    type: string;
+    /** Percent or amount as configured on the code. */
+    value: number;
+    /** Money the code took off this order. */
+    appliedAmount: number;
+}
 /**
  * PII-minimized order view returned by `orders.track(token)`. The tracking
  * token is shared in URLs and e-mails, so this deliberately omits full
@@ -1670,9 +1718,14 @@ interface OrderShipment {
     createdAt: number;
 }
 interface OrderStatusHistory {
-    fromStatus?: OrderStatus;
+    /** Null for the first entry of an order. */
+    fromStatus?: OrderStatus | null;
     toStatus: OrderStatus;
-    note?: string;
+    note?: string | null;
+    /**
+     * @deprecated Never sent: who changed the status is internal to the shop.
+     * Kept only so existing templates keep compiling.
+     */
     changedBy?: string;
     createdAt: number;
 }
@@ -1709,8 +1762,8 @@ interface OrderDetail extends OrderListItem {
     shippingAddress: CheckoutAddress;
     billingAddress: CheckoutAddress;
     email: string;
-    phone?: string;
-    customerNote?: string;
+    phone?: string | null;
+    customerNote?: string | null;
     subtotal: number;
     /** Goods VAT before order discounts (goods subtotal = `subtotal` + `taxTotal`). */
     taxTotal: number;
@@ -1732,6 +1785,12 @@ interface OrderDetail extends OrderListItem {
     discountTotal: number;
     fulfillmentStatus: FulfillmentStatus;
     statusHistory: OrderStatusHistory[];
+    /** Discount codes applied to the order (SDK 2.14.0). */
+    discounts?: OrderDiscount[];
+    /**
+     * @deprecated Not sent on the order detail. Only `checkout.createOrder()`
+     * returns it, see `CheckoutResult.trackingToken`.
+     */
     trackingToken?: string;
     /**
      * Digital product delivery (GAP-07): download grants for any digital assets
@@ -2051,10 +2110,12 @@ interface DownloadUrl {
 interface CustomerProfile {
     id: string;
     email: string;
-    firstName?: string;
-    lastName?: string;
-    phone?: string;
+    firstName?: string | null;
+    lastName?: string | null;
+    phone?: string | null;
     emailVerified: boolean;
+    /** Registration time (Unix ms). */
+    createdAt?: number;
     /**
      * B2B approval gate (GAP-19). `false` = the account is awaiting merchant
      * approval (or was deactivated) — show a "pending approval" banner and gate
@@ -2070,7 +2131,8 @@ interface CustomerAddress {
     isDefault: boolean;
     firstName: string;
     lastName: string;
-    company?: string;
+    /** Null when not set. Send null on update to clear it. */
+    company?: string | null;
     street: string;
     city: string;
     zip: string;
@@ -2088,7 +2150,8 @@ interface CustomerAddress {
     vatIdValid?: boolean | null;
     /** When the VAT ID was last checked (ms). Read-only. */
     vatIdCheckedAt?: number | null;
-    phone?: string;
+    /** Null when not set. Send null on update to clear it. */
+    phone?: string | null;
 }
 interface Page {
     slug: string;
@@ -3189,6 +3252,7 @@ declare class BehioStorefront {
         visitorId: string;
         email: string;
     }): Promise<SdkResult<{
+        /** Single-use code for the offered product, issued by this call. */
         code: string;
         percent: number;
         expiresAt: number;
@@ -3955,6 +4019,8 @@ interface AddressDetail {
     formattedAddress: string;
     lat: number;
     lng: number;
+    /** Set (and the address fields empty) when the request had no `placeId`. */
+    error?: string | null;
 }
 declare class AddressModule {
     private client;
@@ -4041,4 +4107,4 @@ declare function clearCartSummary(): void;
 /** Publish only authoritative current totals; server cart consumers call this after hydration and revalidation. */
 declare function publishCartSummary(summary: CartSummaryEvent): void;
 
-export { type CourseCommentReply as $, type ActivePromotion as A, BehioStorefront as B, type CookieConsent as C, type Cart as D, type CartBundleLine as E, type CartBundleLineItem as F, type CartDiscount as G, type CartItem as H, type CartItemProduct as I, type CartLinkClaimed as J, type CartPromotion as K, type CartSummaryEvent as L, type Category as M, type CategoryDetail as N, type CertificateVerification as O, type ProductDetail as P, type CheckoutAddress as Q, type CheckoutInput as R, type SdkResult as S, type CheckoutPaymentMethod as T, type CheckoutPreview as U, type CheckoutResult as V, type CheckoutSettings as W, type CookieConsentInput as X, type CourseAttachment as Y, type CourseCertificate as Z, type CourseComment as _, type ProductVariant as a, type OrderPickupPoint as a$, type CourseCommentsList as a0, type CourseDetail as a1, type CourseLesson as a2, type CourseListItem as a3, type CourseModule as a4, type CoursePostedComment as a5, type CourseProgress as a6, type CourseTutorMessage as a7, type CourseTutorThread as a8, type CrossSellItem as a9, type LessonNote as aA, type LessonQuiz as aB, type LoginInput as aC, type LoyaltyBalance as aD, type LoyaltyNextTier as aE, type LoyaltyProgram as aF, type LoyaltyQuery as aG, type LoyaltyReferralResult as aH, type LoyaltySummary as aI, type LoyaltyTier as aJ, type LoyaltyTierPerks as aK, type LoyaltyTransaction as aL, type Menu as aM, type MenuItem as aN, type MenuItemRef as aO, type MenuItemType as aP, type MessageResponse as aQ, type NewsletterOptInDefault as aR, type NewsletterSubscribeInput as aS, type NewsletterSubscribeResult as aT, type NewsletterUnsubscribeResult as aU, type OrderAccessRequestResponse as aV, type OrderAccessVerifyResponse as aW, type OrderDetail as aX, type OrderItem as aY, type OrderListItem as aZ, type OrderPaymentInstructions as a_, type CurrencyDisplayFormat as aa, type CustomerAddress as ab, type CustomerBadge as ac, type CustomerChallenge as ad, type CustomerGamification as ae, type CustomerGamificationQuery as af, type CustomerProfile as ag, type DigitalDownload as ah, type DownloadUrl as ai, type Facet as aj, type FacetAvailability as ak, type FacetCategory as al, type FacetLabel as am, type FacetPriceRange as an, type FacetRange as ao, type FacetRatingBucket as ap, type FacetValue as aq, type FacetsResponse as ar, type FilterField as as, type FulfillmentStatus as at, FulfillmentStatuses as au, type GamificationRefreshResult as av, type GiftCardBalance as aw, type GiftCardPurchaseInput as ax, type GiftCardPurchaseResult as ay, type GiftCardSummary as az, type StorefrontFormFieldError as b, type ShopScriptPlacement as b$, type OrderShipment as b0, type OrderStatus as b1, type OrderStatusHistory as b2, OrderStatuses as b3, type OrderTracking as b4, type Page as b5, type PageAttachment as b6, type PageDetail as b7, type PaginatedResponse as b8, type PaymentInstrument as b9, type ProductVolumePrice as bA, type ProductsQuery as bB, type QuizAnswerInput as bC, type QuizAnswerResult as bD, type QuizQuestion as bE, type QuizResult as bF, type QuoteItem as bG, type QuoteRequest as bH, type RegisterInput as bI, type RegisterResult as bJ, type RequestInterceptor as bK, type RequestInterceptorConfig as bL, type ResponseInterceptor as bM, type ResponseInterceptorData as bN, type ReturnRequest as bO, type ReturnRequestItem as bP, type ReturnStatus as bQ, type ReturnStatusItem as bR, type ReturnableOrder as bS, type ReturnableOrderItem as bT, type SdkError as bU, type ShippingMethodSummary as bV, type ShippingQuote as bW, type ShippingQuoteInput as bX, type ShopAppearance as bY, type ShopInfo as bZ, type ShopScript as b_, type PaymentStatus as ba, PaymentStatuses as bb, type PaymentSwift as bc, type PickupPoint as bd, type PickupPointHours as be, type PickupPointsInput as bf, type PickupWidgetConfig as bg, type PriceDisplay as bh, type ProductAssetGroup as bi, type ProductAssetItem as bj, type ProductAvailability as bk, type ProductGroup as bl, type ProductLabel as bm, type ProductListItem as bn, type ProductMedia as bo, type ProductMediaVariant as bp, type ProductParameter as bq, type ProductParameterGroup as br, type ProductParametersResponse as bs, type ProductPrice as bt, type ProductPromotionSummary as bu, type ProductReview as bv, type ProductReviewsResponse as bw, type ProductSibling as bx, ProductSort as by, type ProductSortValue as bz, type AddToCartInput as c, type ShopScriptType as c0, type ShopScripts as c1, type ShopSeo as c2, type ShopSeoIdentity as c3, type SiteFormField as c4, type SiteFormFieldOption as c5, type SiteFormFieldType as c6, type Sitemap as c7, type SitemapEntry as c8, type StockBehavior as c9, type StockMode as ca, type StorefrontForm as cb, type StorefrontFormFieldErrorCode as cc, type StorefrontFormFile as cd, type StorefrontFormSettings as ce, type StorefrontFormSubmitInput as cf, type StorefrontFormSubmitResult as cg, type StorefrontFormUpload as ch, type SubmitQuoteInput as ci, type SubmitReturnInput as cj, type SubmitReviewInput as ck, type Subscription as cl, type SubscriptionAction as cm, type SubscriptionFrequency as cn, type SubscriptionItem as co, type SubscriptionStatus as cp, type TaxBreakdownLine as cq, type VariantAxis as cr, type VariantAxisValue as cs, type WishlistItem as ct, clearCartSummary as cu, err as cv, ok as cw, publishCartSummary as cx, toSdkError as cy, type AddressDetail as d, type AddressSuggestion as e, type AddressType as f, AddressTypes as g, type AuthTokens as h, type BackInStockSubscription as i, type BadgeTone as j, BehioApiError as k, type BehioErrorCode as l, type BehioEventHandler as m, type BehioEventType as n, BehioNetworkError as o, type BehioStorefrontConfig as p, type Blog as q, type BlogPostDetail as r, type BlogPostListItem as s, type BlogPostsPage as t, type BlogPostsQuery as u, type BlogSettings as v, type BlogTag as w, type Bundle as x, type BundleCatalogQuery as y, type BundleItem as z };
+export { type CourseCommentReply as $, type ActivePromotion as A, BehioStorefront as B, type CookieConsent as C, type Cart as D, type CartBundleLine as E, type CartBundleLineItem as F, type CartDiscount as G, type CartItem as H, type CartItemProduct as I, type CartLinkClaimed as J, type CartPromotion as K, type CartSummaryEvent as L, type Category as M, type CategoryDetail as N, type CertificateVerification as O, type ProductDetail as P, type CheckoutAddress as Q, type CheckoutInput as R, type SdkResult as S, type CheckoutPaymentMethod as T, type CheckoutPreview as U, type CheckoutResult as V, type CheckoutSettings as W, type CookieConsentInput as X, type CourseAttachment as Y, type CourseCertificate as Z, type CourseComment as _, type ProductVariant as a, type OrderPaymentInstructions as a$, type CourseCommentsList as a0, type CourseDetail as a1, type CourseLesson as a2, type CourseListItem as a3, type CourseModule as a4, type CoursePostedComment as a5, type CourseProgress as a6, type CourseTutorMessage as a7, type CourseTutorThread as a8, type CrossSellItem as a9, type LessonNote as aA, type LessonQuiz as aB, type LoginInput as aC, type LoyaltyBalance as aD, type LoyaltyNextTier as aE, type LoyaltyProgram as aF, type LoyaltyQuery as aG, type LoyaltyReferralResult as aH, type LoyaltySummary as aI, type LoyaltyTier as aJ, type LoyaltyTierPerks as aK, type LoyaltyTransaction as aL, type Menu as aM, type MenuItem as aN, type MenuItemRef as aO, type MenuItemType as aP, type MessageResponse as aQ, type NewsletterOptInDefault as aR, type NewsletterSubscribeInput as aS, type NewsletterSubscribeResult as aT, type NewsletterUnsubscribeResult as aU, type OrderAccessRequestResponse as aV, type OrderAccessVerifyResponse as aW, type OrderDetail as aX, type OrderDiscount as aY, type OrderItem as aZ, type OrderListItem as a_, type CurrencyDisplayFormat as aa, type CustomerAddress as ab, type CustomerBadge as ac, type CustomerChallenge as ad, type CustomerGamification as ae, type CustomerGamificationQuery as af, type CustomerProfile as ag, type DigitalDownload as ah, type DownloadUrl as ai, type Facet as aj, type FacetAvailability as ak, type FacetCategory as al, type FacetLabel as am, type FacetPriceRange as an, type FacetRange as ao, type FacetRatingBucket as ap, type FacetValue as aq, type FacetsResponse as ar, type FilterField as as, type FulfillmentStatus as at, FulfillmentStatuses as au, type GamificationRefreshResult as av, type GiftCardBalance as aw, type GiftCardPurchaseInput as ax, type GiftCardPurchaseResult as ay, type GiftCardSummary as az, type StorefrontFormFieldError as b, type ShopScript as b$, type OrderPickupPoint as b0, type OrderShipment as b1, type OrderStatus as b2, type OrderStatusHistory as b3, OrderStatuses as b4, type OrderTracking as b5, type Page as b6, type PageAttachment as b7, type PageDetail as b8, type PaginatedResponse as b9, type ProductSortValue as bA, type ProductVolumePrice as bB, type ProductsQuery as bC, type QuizAnswerInput as bD, type QuizAnswerResult as bE, type QuizQuestion as bF, type QuizResult as bG, type QuoteItem as bH, type QuoteRequest as bI, type RegisterInput as bJ, type RegisterResult as bK, type RequestInterceptor as bL, type RequestInterceptorConfig as bM, type ResponseInterceptor as bN, type ResponseInterceptorData as bO, type ReturnRequest as bP, type ReturnRequestItem as bQ, type ReturnStatus as bR, type ReturnStatusItem as bS, type ReturnableOrder as bT, type ReturnableOrderItem as bU, type SdkError as bV, type ShippingMethodSummary as bW, type ShippingQuote as bX, type ShippingQuoteInput as bY, type ShopAppearance as bZ, type ShopInfo as b_, type PaymentInstrument as ba, type PaymentStatus as bb, PaymentStatuses as bc, type PaymentSwift as bd, type PickupPoint as be, type PickupPointHours as bf, type PickupPointsInput as bg, type PickupWidgetConfig as bh, type PriceDisplay as bi, type ProductAssetGroup as bj, type ProductAssetItem as bk, type ProductAvailability as bl, type ProductGroup as bm, type ProductLabel as bn, type ProductListItem as bo, type ProductMedia as bp, type ProductMediaVariant as bq, type ProductParameter as br, type ProductParameterGroup as bs, type ProductParametersResponse as bt, type ProductPrice as bu, type ProductPromotionSummary as bv, type ProductReview as bw, type ProductReviewsResponse as bx, type ProductSibling as by, ProductSort as bz, type AddToCartInput as c, type ShopScriptPlacement as c0, type ShopScriptType as c1, type ShopScripts as c2, type ShopSeo as c3, type ShopSeoIdentity as c4, type SiteFormField as c5, type SiteFormFieldOption as c6, type SiteFormFieldType as c7, type Sitemap as c8, type SitemapEntry as c9, type StockBehavior as ca, type StockMode as cb, type StorefrontForm as cc, type StorefrontFormFieldErrorCode as cd, type StorefrontFormFile as ce, type StorefrontFormSettings as cf, type StorefrontFormSubmitInput as cg, type StorefrontFormSubmitResult as ch, type StorefrontFormUpload as ci, type SubmitQuoteInput as cj, type SubmitReturnInput as ck, type SubmitReviewInput as cl, type Subscription as cm, type SubscriptionAction as cn, type SubscriptionFrequency as co, type SubscriptionItem as cp, type SubscriptionStatus as cq, type TaxBreakdownLine as cr, type VariantAxis as cs, type VariantAxisValue as ct, type WishlistItem as cu, clearCartSummary as cv, err as cw, ok as cx, publishCartSummary as cy, toSdkError as cz, type AddressDetail as d, type AddressSuggestion as e, type AddressType as f, AddressTypes as g, type AuthTokens as h, type BackInStockSubscription as i, type BadgeTone as j, BehioApiError as k, type BehioErrorCode as l, type BehioEventHandler as m, type BehioEventType as n, BehioNetworkError as o, type BehioStorefrontConfig as p, type Blog as q, type BlogPostDetail as r, type BlogPostListItem as s, type BlogPostsPage as t, type BlogPostsQuery as u, type BlogSettings as v, type BlogTag as w, type Bundle as x, type BundleCatalogQuery as y, type BundleItem as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent, b as StorefrontFormFieldError } from './client-Cf_xibuw.mjs';
-export { A as ActivePromotion, c as AddToCartInput, d as AddressDetail, e as AddressSuggestion, f as AddressType, g as AddressTypes, h as AuthTokens, i as BackInStockSubscription, j as BadgeTone, k as BehioApiError, l as BehioErrorCode, m as BehioEventHandler, n as BehioEventType, o as BehioNetworkError, p as BehioStorefrontConfig, q as Blog, r as BlogPostDetail, s as BlogPostListItem, t as BlogPostsPage, u as BlogPostsQuery, v as BlogSettings, w as BlogTag, x as Bundle, y as BundleCatalogQuery, z as BundleItem, D as Cart, E as CartBundleLine, F as CartBundleLineItem, G as CartDiscount, H as CartItem, I as CartItemProduct, J as CartLinkClaimed, K as CartPromotion, L as CartSummaryEvent, M as Category, N as CategoryDetail, O as CertificateVerification, Q as CheckoutAddress, R as CheckoutInput, T as CheckoutPaymentMethod, U as CheckoutPreview, V as CheckoutResult, W as CheckoutSettings, X as CookieConsentInput, Y as CourseAttachment, Z as CourseCertificate, _ as CourseComment, $ as CourseCommentReply, a0 as CourseCommentsList, a1 as CourseDetail, a2 as CourseLesson, a3 as CourseListItem, a4 as CourseModule, a5 as CoursePostedComment, a6 as CourseProgress, a7 as CourseTutorMessage, a8 as CourseTutorThread, a9 as CrossSellItem, aa as CurrencyDisplayFormat, ab as CustomerAddress, ac as CustomerBadge, ad as CustomerChallenge, ae as CustomerGamification, af as CustomerGamificationQuery, ag as CustomerProfile, ah as DigitalDownload, ai as DownloadUrl, aj as Facet, ak as FacetAvailability, al as FacetCategory, am as FacetLabel, an as FacetPriceRange, ao as FacetRange, ap as FacetRatingBucket, aq as FacetValue, ar as FacetsResponse, as as FilterField, at as FulfillmentStatus, au as FulfillmentStatuses, av as GamificationRefreshResult, aw as GiftCardBalance, ax as GiftCardPurchaseInput, ay as GiftCardPurchaseResult, az as GiftCardSummary, aA as LessonNote, aB as LessonQuiz, aC as LoginInput, aD as LoyaltyBalance, aE as LoyaltyNextTier, aF as LoyaltyProgram, aG as LoyaltyQuery, aH as LoyaltyReferralResult, aI as LoyaltySummary, aJ as LoyaltyTier, aK as LoyaltyTierPerks, aL as LoyaltyTransaction, aM as Menu, aN as MenuItem, aO as MenuItemRef, aP as MenuItemType, aQ as MessageResponse, aR as NewsletterOptInDefault, aS as NewsletterSubscribeInput, aT as NewsletterSubscribeResult, aU as NewsletterUnsubscribeResult, aV as OrderAccessRequestResponse, aW as OrderAccessVerifyResponse, aX as OrderDetail, aY as OrderItem, aZ as OrderListItem, a_ as OrderPaymentInstructions, a$ as OrderPickupPoint, b0 as OrderShipment, b1 as OrderStatus, b2 as OrderStatusHistory, b3 as OrderStatuses, b4 as OrderTracking, b5 as Page, b6 as PageAttachment, b7 as PageDetail, b8 as PaginatedResponse, b9 as PaymentInstrument, ba as PaymentStatus, bb as PaymentStatuses, bc as PaymentSwift, bd as PickupPoint, be as PickupPointHours, bf as PickupPointsInput, bg as PickupWidgetConfig, bh as PriceDisplay, bi as ProductAssetGroup, bj as ProductAssetItem, bk as ProductAvailability, bl as ProductGroup, bm as ProductLabel, bn as ProductListItem, bo as ProductMedia, bp as ProductMediaVariant, bq as ProductParameter, br as ProductParameterGroup, bs as ProductParametersResponse, bt as ProductPrice, bu as ProductPromotionSummary, bv as ProductReview, bw as ProductReviewsResponse, bx as ProductSibling, by as ProductSort, bz as ProductSortValue, bA as ProductVolumePrice, bB as ProductsQuery, bC as QuizAnswerInput, bD as QuizAnswerResult, bE as QuizQuestion, bF as QuizResult, bG as QuoteItem, bH as QuoteRequest, bI as RegisterInput, bJ as RegisterResult, bK as RequestInterceptor, bL as RequestInterceptorConfig, bM as ResponseInterceptor, bN as ResponseInterceptorData, bO as ReturnRequest, bP as ReturnRequestItem, bQ as ReturnStatus, bR as ReturnStatusItem, bS as ReturnableOrder, bT as ReturnableOrderItem, bU as SdkError, bV as ShippingMethodSummary, bW as ShippingQuote, bX as ShippingQuoteInput, bY as ShopAppearance, bZ as ShopInfo, b_ as ShopScript, b$ as ShopScriptPlacement, c0 as ShopScriptType, c1 as ShopScripts, c2 as ShopSeo, c3 as ShopSeoIdentity, c4 as SiteFormField, c5 as SiteFormFieldOption, c6 as SiteFormFieldType, c7 as Sitemap, c8 as SitemapEntry, c9 as StockBehavior, ca as StockMode, cb as StorefrontForm, cc as StorefrontFormFieldErrorCode, cd as StorefrontFormFile, ce as StorefrontFormSettings, cf as StorefrontFormSubmitInput, cg as StorefrontFormSubmitResult, ch as StorefrontFormUpload, ci as SubmitQuoteInput, cj as SubmitReturnInput, ck as SubmitReviewInput, cl as Subscription, cm as SubscriptionAction, cn as SubscriptionFrequency, co as SubscriptionItem, cp as SubscriptionStatus, cq as TaxBreakdownLine, cr as VariantAxis, cs as VariantAxisValue, ct as WishlistItem, cu as clearCartSummary, cv as err, cw as ok, cx as publishCartSummary, cy as toSdkError } from './client-Cf_xibuw.mjs';
+import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent, b as StorefrontFormFieldError } from './client-DB_ve5Fp.mjs';
+export { A as ActivePromotion, c as AddToCartInput, d as AddressDetail, e as AddressSuggestion, f as AddressType, g as AddressTypes, h as AuthTokens, i as BackInStockSubscription, j as BadgeTone, k as BehioApiError, l as BehioErrorCode, m as BehioEventHandler, n as BehioEventType, o as BehioNetworkError, p as BehioStorefrontConfig, q as Blog, r as BlogPostDetail, s as BlogPostListItem, t as BlogPostsPage, u as BlogPostsQuery, v as BlogSettings, w as BlogTag, x as Bundle, y as BundleCatalogQuery, z as BundleItem, D as Cart, E as CartBundleLine, F as CartBundleLineItem, G as CartDiscount, H as CartItem, I as CartItemProduct, J as CartLinkClaimed, K as CartPromotion, L as CartSummaryEvent, M as Category, N as CategoryDetail, O as CertificateVerification, Q as CheckoutAddress, R as CheckoutInput, T as CheckoutPaymentMethod, U as CheckoutPreview, V as CheckoutResult, W as CheckoutSettings, X as CookieConsentInput, Y as CourseAttachment, Z as CourseCertificate, _ as CourseComment, $ as CourseCommentReply, a0 as CourseCommentsList, a1 as CourseDetail, a2 as CourseLesson, a3 as CourseListItem, a4 as CourseModule, a5 as CoursePostedComment, a6 as CourseProgress, a7 as CourseTutorMessage, a8 as CourseTutorThread, a9 as CrossSellItem, aa as CurrencyDisplayFormat, ab as CustomerAddress, ac as CustomerBadge, ad as CustomerChallenge, ae as CustomerGamification, af as CustomerGamificationQuery, ag as CustomerProfile, ah as DigitalDownload, ai as DownloadUrl, aj as Facet, ak as FacetAvailability, al as FacetCategory, am as FacetLabel, an as FacetPriceRange, ao as FacetRange, ap as FacetRatingBucket, aq as FacetValue, ar as FacetsResponse, as as FilterField, at as FulfillmentStatus, au as FulfillmentStatuses, av as GamificationRefreshResult, aw as GiftCardBalance, ax as GiftCardPurchaseInput, ay as GiftCardPurchaseResult, az as GiftCardSummary, aA as LessonNote, aB as LessonQuiz, aC as LoginInput, aD as LoyaltyBalance, aE as LoyaltyNextTier, aF as LoyaltyProgram, aG as LoyaltyQuery, aH as LoyaltyReferralResult, aI as LoyaltySummary, aJ as LoyaltyTier, aK as LoyaltyTierPerks, aL as LoyaltyTransaction, aM as Menu, aN as MenuItem, aO as MenuItemRef, aP as MenuItemType, aQ as MessageResponse, aR as NewsletterOptInDefault, aS as NewsletterSubscribeInput, aT as NewsletterSubscribeResult, aU as NewsletterUnsubscribeResult, aV as OrderAccessRequestResponse, aW as OrderAccessVerifyResponse, aX as OrderDetail, aY as OrderDiscount, aZ as OrderItem, a_ as OrderListItem, a$ as OrderPaymentInstructions, b0 as OrderPickupPoint, b1 as OrderShipment, b2 as OrderStatus, b3 as OrderStatusHistory, b4 as OrderStatuses, b5 as OrderTracking, b6 as Page, b7 as PageAttachment, b8 as PageDetail, b9 as PaginatedResponse, ba as PaymentInstrument, bb as PaymentStatus, bc as PaymentStatuses, bd as PaymentSwift, be as PickupPoint, bf as PickupPointHours, bg as PickupPointsInput, bh as PickupWidgetConfig, bi as PriceDisplay, bj as ProductAssetGroup, bk as ProductAssetItem, bl as ProductAvailability, bm as ProductGroup, bn as ProductLabel, bo as ProductListItem, bp as ProductMedia, bq as ProductMediaVariant, br as ProductParameter, bs as ProductParameterGroup, bt as ProductParametersResponse, bu as ProductPrice, bv as ProductPromotionSummary, bw as ProductReview, bx as ProductReviewsResponse, by as ProductSibling, bz as ProductSort, bA as ProductSortValue, bB as ProductVolumePrice, bC as ProductsQuery, bD as QuizAnswerInput, bE as QuizAnswerResult, bF as QuizQuestion, bG as QuizResult, bH as QuoteItem, bI as QuoteRequest, bJ as RegisterInput, bK as RegisterResult, bL as RequestInterceptor, bM as RequestInterceptorConfig, bN as ResponseInterceptor, bO as ResponseInterceptorData, bP as ReturnRequest, bQ as ReturnRequestItem, bR as ReturnStatus, bS as ReturnStatusItem, bT as ReturnableOrder, bU as ReturnableOrderItem, bV as SdkError, bW as ShippingMethodSummary, bX as ShippingQuote, bY as ShippingQuoteInput, bZ as ShopAppearance, b_ as ShopInfo, b$ as ShopScript, c0 as ShopScriptPlacement, c1 as ShopScriptType, c2 as ShopScripts, c3 as ShopSeo, c4 as ShopSeoIdentity, c5 as SiteFormField, c6 as SiteFormFieldOption, c7 as SiteFormFieldType, c8 as Sitemap, c9 as SitemapEntry, ca as StockBehavior, cb as StockMode, cc as StorefrontForm, cd as StorefrontFormFieldErrorCode, ce as StorefrontFormFile, cf as StorefrontFormSettings, cg as StorefrontFormSubmitInput, ch as StorefrontFormSubmitResult, ci as StorefrontFormUpload, cj as SubmitQuoteInput, ck as SubmitReturnInput, cl as SubmitReviewInput, cm as Subscription, cn as SubscriptionAction, co as SubscriptionFrequency, cp as SubscriptionItem, cq as SubscriptionStatus, cr as TaxBreakdownLine, cs as VariantAxis, ct as VariantAxisValue, cu as WishlistItem, cv as clearCartSummary, cw as err, cx as ok, cy as publishCartSummary, cz as toSdkError } from './client-DB_ve5Fp.mjs';
 
 /**
  * Format a price amount with currency using Intl.NumberFormat.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent, b as StorefrontFormFieldError } from './client-Cf_xibuw.js';
-export { A as ActivePromotion, c as AddToCartInput, d as AddressDetail, e as AddressSuggestion, f as AddressType, g as AddressTypes, h as AuthTokens, i as BackInStockSubscription, j as BadgeTone, k as BehioApiError, l as BehioErrorCode, m as BehioEventHandler, n as BehioEventType, o as BehioNetworkError, p as BehioStorefrontConfig, q as Blog, r as BlogPostDetail, s as BlogPostListItem, t as BlogPostsPage, u as BlogPostsQuery, v as BlogSettings, w as BlogTag, x as Bundle, y as BundleCatalogQuery, z as BundleItem, D as Cart, E as CartBundleLine, F as CartBundleLineItem, G as CartDiscount, H as CartItem, I as CartItemProduct, J as CartLinkClaimed, K as CartPromotion, L as CartSummaryEvent, M as Category, N as CategoryDetail, O as CertificateVerification, Q as CheckoutAddress, R as CheckoutInput, T as CheckoutPaymentMethod, U as CheckoutPreview, V as CheckoutResult, W as CheckoutSettings, X as CookieConsentInput, Y as CourseAttachment, Z as CourseCertificate, _ as CourseComment, $ as CourseCommentReply, a0 as CourseCommentsList, a1 as CourseDetail, a2 as CourseLesson, a3 as CourseListItem, a4 as CourseModule, a5 as CoursePostedComment, a6 as CourseProgress, a7 as CourseTutorMessage, a8 as CourseTutorThread, a9 as CrossSellItem, aa as CurrencyDisplayFormat, ab as CustomerAddress, ac as CustomerBadge, ad as CustomerChallenge, ae as CustomerGamification, af as CustomerGamificationQuery, ag as CustomerProfile, ah as DigitalDownload, ai as DownloadUrl, aj as Facet, ak as FacetAvailability, al as FacetCategory, am as FacetLabel, an as FacetPriceRange, ao as FacetRange, ap as FacetRatingBucket, aq as FacetValue, ar as FacetsResponse, as as FilterField, at as FulfillmentStatus, au as FulfillmentStatuses, av as GamificationRefreshResult, aw as GiftCardBalance, ax as GiftCardPurchaseInput, ay as GiftCardPurchaseResult, az as GiftCardSummary, aA as LessonNote, aB as LessonQuiz, aC as LoginInput, aD as LoyaltyBalance, aE as LoyaltyNextTier, aF as LoyaltyProgram, aG as LoyaltyQuery, aH as LoyaltyReferralResult, aI as LoyaltySummary, aJ as LoyaltyTier, aK as LoyaltyTierPerks, aL as LoyaltyTransaction, aM as Menu, aN as MenuItem, aO as MenuItemRef, aP as MenuItemType, aQ as MessageResponse, aR as NewsletterOptInDefault, aS as NewsletterSubscribeInput, aT as NewsletterSubscribeResult, aU as NewsletterUnsubscribeResult, aV as OrderAccessRequestResponse, aW as OrderAccessVerifyResponse, aX as OrderDetail, aY as OrderItem, aZ as OrderListItem, a_ as OrderPaymentInstructions, a$ as OrderPickupPoint, b0 as OrderShipment, b1 as OrderStatus, b2 as OrderStatusHistory, b3 as OrderStatuses, b4 as OrderTracking, b5 as Page, b6 as PageAttachment, b7 as PageDetail, b8 as PaginatedResponse, b9 as PaymentInstrument, ba as PaymentStatus, bb as PaymentStatuses, bc as PaymentSwift, bd as PickupPoint, be as PickupPointHours, bf as PickupPointsInput, bg as PickupWidgetConfig, bh as PriceDisplay, bi as ProductAssetGroup, bj as ProductAssetItem, bk as ProductAvailability, bl as ProductGroup, bm as ProductLabel, bn as ProductListItem, bo as ProductMedia, bp as ProductMediaVariant, bq as ProductParameter, br as ProductParameterGroup, bs as ProductParametersResponse, bt as ProductPrice, bu as ProductPromotionSummary, bv as ProductReview, bw as ProductReviewsResponse, bx as ProductSibling, by as ProductSort, bz as ProductSortValue, bA as ProductVolumePrice, bB as ProductsQuery, bC as QuizAnswerInput, bD as QuizAnswerResult, bE as QuizQuestion, bF as QuizResult, bG as QuoteItem, bH as QuoteRequest, bI as RegisterInput, bJ as RegisterResult, bK as RequestInterceptor, bL as RequestInterceptorConfig, bM as ResponseInterceptor, bN as ResponseInterceptorData, bO as ReturnRequest, bP as ReturnRequestItem, bQ as ReturnStatus, bR as ReturnStatusItem, bS as ReturnableOrder, bT as ReturnableOrderItem, bU as SdkError, bV as ShippingMethodSummary, bW as ShippingQuote, bX as ShippingQuoteInput, bY as ShopAppearance, bZ as ShopInfo, b_ as ShopScript, b$ as ShopScriptPlacement, c0 as ShopScriptType, c1 as ShopScripts, c2 as ShopSeo, c3 as ShopSeoIdentity, c4 as SiteFormField, c5 as SiteFormFieldOption, c6 as SiteFormFieldType, c7 as Sitemap, c8 as SitemapEntry, c9 as StockBehavior, ca as StockMode, cb as StorefrontForm, cc as StorefrontFormFieldErrorCode, cd as StorefrontFormFile, ce as StorefrontFormSettings, cf as StorefrontFormSubmitInput, cg as StorefrontFormSubmitResult, ch as StorefrontFormUpload, ci as SubmitQuoteInput, cj as SubmitReturnInput, ck as SubmitReviewInput, cl as Subscription, cm as SubscriptionAction, cn as SubscriptionFrequency, co as SubscriptionItem, cp as SubscriptionStatus, cq as TaxBreakdownLine, cr as VariantAxis, cs as VariantAxisValue, ct as WishlistItem, cu as clearCartSummary, cv as err, cw as ok, cx as publishCartSummary, cy as toSdkError } from './client-Cf_xibuw.js';
+import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent, b as StorefrontFormFieldError } from './client-DB_ve5Fp.js';
+export { A as ActivePromotion, c as AddToCartInput, d as AddressDetail, e as AddressSuggestion, f as AddressType, g as AddressTypes, h as AuthTokens, i as BackInStockSubscription, j as BadgeTone, k as BehioApiError, l as BehioErrorCode, m as BehioEventHandler, n as BehioEventType, o as BehioNetworkError, p as BehioStorefrontConfig, q as Blog, r as BlogPostDetail, s as BlogPostListItem, t as BlogPostsPage, u as BlogPostsQuery, v as BlogSettings, w as BlogTag, x as Bundle, y as BundleCatalogQuery, z as BundleItem, D as Cart, E as CartBundleLine, F as CartBundleLineItem, G as CartDiscount, H as CartItem, I as CartItemProduct, J as CartLinkClaimed, K as CartPromotion, L as CartSummaryEvent, M as Category, N as CategoryDetail, O as CertificateVerification, Q as CheckoutAddress, R as CheckoutInput, T as CheckoutPaymentMethod, U as CheckoutPreview, V as CheckoutResult, W as CheckoutSettings, X as CookieConsentInput, Y as CourseAttachment, Z as CourseCertificate, _ as CourseComment, $ as CourseCommentReply, a0 as CourseCommentsList, a1 as CourseDetail, a2 as CourseLesson, a3 as CourseListItem, a4 as CourseModule, a5 as CoursePostedComment, a6 as CourseProgress, a7 as CourseTutorMessage, a8 as CourseTutorThread, a9 as CrossSellItem, aa as CurrencyDisplayFormat, ab as CustomerAddress, ac as CustomerBadge, ad as CustomerChallenge, ae as CustomerGamification, af as CustomerGamificationQuery, ag as CustomerProfile, ah as DigitalDownload, ai as DownloadUrl, aj as Facet, ak as FacetAvailability, al as FacetCategory, am as FacetLabel, an as FacetPriceRange, ao as FacetRange, ap as FacetRatingBucket, aq as FacetValue, ar as FacetsResponse, as as FilterField, at as FulfillmentStatus, au as FulfillmentStatuses, av as GamificationRefreshResult, aw as GiftCardBalance, ax as GiftCardPurchaseInput, ay as GiftCardPurchaseResult, az as GiftCardSummary, aA as LessonNote, aB as LessonQuiz, aC as LoginInput, aD as LoyaltyBalance, aE as LoyaltyNextTier, aF as LoyaltyProgram, aG as LoyaltyQuery, aH as LoyaltyReferralResult, aI as LoyaltySummary, aJ as LoyaltyTier, aK as LoyaltyTierPerks, aL as LoyaltyTransaction, aM as Menu, aN as MenuItem, aO as MenuItemRef, aP as MenuItemType, aQ as MessageResponse, aR as NewsletterOptInDefault, aS as NewsletterSubscribeInput, aT as NewsletterSubscribeResult, aU as NewsletterUnsubscribeResult, aV as OrderAccessRequestResponse, aW as OrderAccessVerifyResponse, aX as OrderDetail, aY as OrderDiscount, aZ as OrderItem, a_ as OrderListItem, a$ as OrderPaymentInstructions, b0 as OrderPickupPoint, b1 as OrderShipment, b2 as OrderStatus, b3 as OrderStatusHistory, b4 as OrderStatuses, b5 as OrderTracking, b6 as Page, b7 as PageAttachment, b8 as PageDetail, b9 as PaginatedResponse, ba as PaymentInstrument, bb as PaymentStatus, bc as PaymentStatuses, bd as PaymentSwift, be as PickupPoint, bf as PickupPointHours, bg as PickupPointsInput, bh as PickupWidgetConfig, bi as PriceDisplay, bj as ProductAssetGroup, bk as ProductAssetItem, bl as ProductAvailability, bm as ProductGroup, bn as ProductLabel, bo as ProductListItem, bp as ProductMedia, bq as ProductMediaVariant, br as ProductParameter, bs as ProductParameterGroup, bt as ProductParametersResponse, bu as ProductPrice, bv as ProductPromotionSummary, bw as ProductReview, bx as ProductReviewsResponse, by as ProductSibling, bz as ProductSort, bA as ProductSortValue, bB as ProductVolumePrice, bC as ProductsQuery, bD as QuizAnswerInput, bE as QuizAnswerResult, bF as QuizQuestion, bG as QuizResult, bH as QuoteItem, bI as QuoteRequest, bJ as RegisterInput, bK as RegisterResult, bL as RequestInterceptor, bM as RequestInterceptorConfig, bN as ResponseInterceptor, bO as ResponseInterceptorData, bP as ReturnRequest, bQ as ReturnRequestItem, bR as ReturnStatus, bS as ReturnStatusItem, bT as ReturnableOrder, bU as ReturnableOrderItem, bV as SdkError, bW as ShippingMethodSummary, bX as ShippingQuote, bY as ShippingQuoteInput, bZ as ShopAppearance, b_ as ShopInfo, b$ as ShopScript, c0 as ShopScriptPlacement, c1 as ShopScriptType, c2 as ShopScripts, c3 as ShopSeo, c4 as ShopSeoIdentity, c5 as SiteFormField, c6 as SiteFormFieldOption, c7 as SiteFormFieldType, c8 as Sitemap, c9 as SitemapEntry, ca as StockBehavior, cb as StockMode, cc as StorefrontForm, cd as StorefrontFormFieldErrorCode, ce as StorefrontFormFile, cf as StorefrontFormSettings, cg as StorefrontFormSubmitInput, ch as StorefrontFormSubmitResult, ci as StorefrontFormUpload, cj as SubmitQuoteInput, ck as SubmitReturnInput, cl as SubmitReviewInput, cm as Subscription, cn as SubscriptionAction, co as SubscriptionFrequency, cp as SubscriptionItem, cq as SubscriptionStatus, cr as TaxBreakdownLine, cs as VariantAxis, ct as VariantAxisValue, cu as WishlistItem, cv as clearCartSummary, cw as err, cx as ok, cy as publishCartSummary, cz as toSdkError } from './client-DB_ve5Fp.js';
 
 /**
  * Format a price amount with currency using Intl.NumberFormat.

package/dist/next.d.mts

@@ -1,4 +1,4 @@
-import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-Cf_xibuw.mjs';
+import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-DB_ve5Fp.mjs';
 
 interface GetBehioOptions extends Partial<BehioStorefrontConfig> {
     /** Override the cart session cookie name (default: "behio_cart_session"). */

package/dist/next.d.ts

@@ -1,4 +1,4 @@
-import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-Cf_xibuw.js';
+import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-DB_ve5Fp.js';
 
 interface GetBehioOptions extends Partial<BehioStorefrontConfig> {
     /** Override the cart session cookie name (default: "behio_cart_session"). */

package/dist/react.d.mts

@@ -564,7 +564,7 @@ interface ProductLabel {
     id: string;
     slug: string;
     name: string;
-    color?: string;
+    color?: string | null;
     /** Merchant icon name. Render a trusted local icon, with a safe fallback. */
     iconName?: string | null;
 }
@@ -594,9 +594,9 @@ interface ProductListItem {
     id: string;
     slug: string;
     name: string;
-    shortDescription?: string;
+    shortDescription?: string | null;
     sku: string;
-    gtin?: string;
+    gtin?: string | null;
     /** `null` when prices are gated behind login for guests (B2B mode). */
     price: ProductPrice | null;
     inStock: boolean;
@@ -685,6 +685,9 @@ interface ProductListItem {
         url: string;
         alt: string | null;
         order: number;
+        /** COVER | LISTING | HOVER | GALLERY when the cover came from a roled
+         *  product image; absent when it came from the inventory gallery (SDK 2.14.0). */
+        role?: string;
     } | null;
     labels: ProductLabel[];
     isFeatured: boolean;
@@ -899,7 +902,19 @@ interface ProductDetail extends ProductListItem {
      *  null when uncapped or the shop hides stock counts. Cap the PDP quantity
      *  stepper with it, it is exactly the cart rule. SDK 2.13.0. */
     maxPurchasableQuantity?: number | null;
-    longDescription?: string;
+    /**
+     * @deprecated Not sent on the product detail, only on list cards. Use
+     * `media` (or `images`) for the gallery.
+     */
+    image?: ProductListItem["image"];
+    /** @deprecated Not sent on the product detail, only on list cards. */
+    hoverImageUrl?: string | null;
+    /**
+     * @deprecated Not sent on the product detail, only on list cards. Read the
+     * PDP promotions with `catalog.getProductPromotions(slug)`.
+     */
+    activePromotion?: ProductPromotionSummary | null;
+    longDescription?: string | null;
     /**
      * @deprecated Legacy per-listing images. Prefer `media`. Each carries its
      * `role` (COVER | LISTING | HOVER | GALLERY) so the storefront can pick a
@@ -907,7 +922,7 @@ interface ProductDetail extends ProductListItem {
      */
     images: Array<{
         url: string;
-        alt?: string;
+        alt?: string | null;
         order: number;
         role?: string;
     }>;
@@ -975,6 +990,10 @@ interface ProductDetail extends ProductListItem {
         ogDescription?: string | null;
         ogImage?: string | null;
     };
+    /**
+     * @deprecated Never sent by the API. Load a group with
+     * `catalog.getProductGroup(slug)`.
+     */
     productGroups?: Array<{
         slug: string;
         name: string;
@@ -996,8 +1015,8 @@ interface Category {
     id: string;
     slug: string;
     name: string;
-    description?: string;
-    imageUrl?: string;
+    description?: string | null;
+    imageUrl?: string | null;
     children: Category[];
     productCount?: number;
 }
@@ -1060,11 +1079,18 @@ interface Menu {
     locale: string;
     items: MenuItem[];
 }
-interface CategoryDetail extends Category {
+interface CategoryDetail extends Omit<Category, "children"> {
+    /**
+     * @deprecated Never sent on the category detail (it was typed as always
+     * present, so `children.map` crashed). Read subcategories from
+     * `catalog.getCategories()`.
+     */
+    children?: Category[];
     /**
      * SEO/Open Graph for the category page. Matches the backend's nested `seo`
      * shape (the old flat `seoTitle`/`seoDescription` never matched what the API
-     * returned). `keywords` is always null for categories.
+     * returned). `keywords` is always null for categories. Null when the
+     * category has no text in the requested language (SDK 2.14.0 types it).
      */
     seo?: {
         title?: string | null;
@@ -1073,7 +1099,7 @@ interface CategoryDetail extends Category {
         ogTitle?: string | null;
         ogDescription?: string | null;
         ogImage?: string | null;
-    };
+    } | null;
 }
 /**
  * One available filter, derived from a curated parameter the merchant marked
@@ -1091,7 +1117,7 @@ interface FilterField {
     groupSlug: string;
     groupName: string;
     unit?: string | null;
-    values?: string[];
+    values?: string[] | null;
 }
 interface FacetValue {
     /** Raw stored value (normalized), for exact filtering. */
@@ -1342,7 +1368,7 @@ interface CartItemProduct {
      *  arbitrary translation row, so this could come back in another language. */
     name: string;
     sku: string;
-    imageUrl?: string;
+    imageUrl?: string | null;
     inStock: boolean;
     /** Pieces left for an "only X left" note on the cart line; null when the
      *  shop does not track stock, hides the nudge or has plenty. SDK 2.13.0. */
@@ -1440,7 +1466,7 @@ interface Cart {
      *  200 net" was 20, now it is 24.20 at 21 %). It lowers base and VAT, see
      *  `taxBreakdown` and `vatTotal`. */
     discountTotal: number;
-    discount?: CartDiscount;
+    discount?: CartDiscount | null;
     /** Auto-apply promotion discount lines (sale/BOGO). */
     appliedPromotions: CartPromotion[];
     /** Sum of `appliedPromotions[].discountAmount`; already reflected in `grandTotal`. */
@@ -1645,6 +1671,12 @@ interface CheckoutInput {
      * guests. See `customer.getLoyalty()` for the available balance.
      */
     redeemLoyaltyPoints?: number;
+    /**
+     * Cart session to order. The SDK sends it in the `X-Cart-Session` header on
+     * its own, so leave it out; the body field is for clients without the
+     * header (SDK 2.14.0 documents it, the backend has always accepted it).
+     */
+    sessionToken?: string;
 }
 type OrderStatus = (typeof OrderStatuses)[keyof typeof OrderStatuses];
 type PaymentStatus = (typeof PaymentStatuses)[keyof typeof PaymentStatuses];
@@ -1660,6 +1692,8 @@ interface OrderListItem {
     createdAt: number;
 }
 interface OrderItem {
+    /** Order line id (SDK 2.14.0). */
+    id?: string;
     productName: string;
     sku: string;
     /** Photo snapshot from checkout, or the product's current photo. */
@@ -1671,9 +1705,23 @@ interface OrderItem {
     productSlug?: string | null;
     quantity: number;
     unitPrice: number;
+    /** VAT rate of the line in percent, e.g. 21 (SDK 2.14.0). */
+    taxRate?: number;
+    /** VAT of the whole line (SDK 2.14.0). */
+    taxAmount?: number;
     totalPrice: number;
     totalPriceWithTax: number;
 }
+/** A discount code applied to an order (SDK 2.14.0). */
+interface OrderDiscount {
+    code: string;
+    /** PERCENTAGE, FIXED_AMOUNT or FREE_SHIPPING. */
+    type: string;
+    /** Percent or amount as configured on the code. */
+    value: number;
+    /** Money the code took off this order. */
+    appliedAmount: number;
+}
 /**
  * PII-minimized order view returned by `orders.track(token)`. The tracking
  * token is shared in URLs and e-mails, so this deliberately omits full
@@ -1726,9 +1774,14 @@ interface OrderShipment {
     createdAt: number;
 }
 interface OrderStatusHistory {
-    fromStatus?: OrderStatus;
+    /** Null for the first entry of an order. */
+    fromStatus?: OrderStatus | null;
     toStatus: OrderStatus;
-    note?: string;
+    note?: string | null;
+    /**
+     * @deprecated Never sent: who changed the status is internal to the shop.
+     * Kept only so existing templates keep compiling.
+     */
     changedBy?: string;
     createdAt: number;
 }
@@ -1765,8 +1818,8 @@ interface OrderDetail extends OrderListItem {
     shippingAddress: CheckoutAddress;
     billingAddress: CheckoutAddress;
     email: string;
-    phone?: string;
-    customerNote?: string;
+    phone?: string | null;
+    customerNote?: string | null;
     subtotal: number;
     /** Goods VAT before order discounts (goods subtotal = `subtotal` + `taxTotal`). */
     taxTotal: number;
@@ -1788,6 +1841,12 @@ interface OrderDetail extends OrderListItem {
     discountTotal: number;
     fulfillmentStatus: FulfillmentStatus;
     statusHistory: OrderStatusHistory[];
+    /** Discount codes applied to the order (SDK 2.14.0). */
+    discounts?: OrderDiscount[];
+    /**
+     * @deprecated Not sent on the order detail. Only `checkout.createOrder()`
+     * returns it, see `CheckoutResult.trackingToken`.
+     */
     trackingToken?: string;
     /**
      * Digital product delivery (GAP-07): download grants for any digital assets
@@ -2107,10 +2166,12 @@ interface DownloadUrl {
 interface CustomerProfile {
     id: string;
     email: string;
-    firstName?: string;
-    lastName?: string;
-    phone?: string;
+    firstName?: string | null;
+    lastName?: string | null;
+    phone?: string | null;
     emailVerified: boolean;
+    /** Registration time (Unix ms). */
+    createdAt?: number;
     /**
      * B2B approval gate (GAP-19). `false` = the account is awaiting merchant
      * approval (or was deactivated) — show a "pending approval" banner and gate
@@ -2126,7 +2187,8 @@ interface CustomerAddress {
     isDefault: boolean;
     firstName: string;
     lastName: string;
-    company?: string;
+    /** Null when not set. Send null on update to clear it. */
+    company?: string | null;
     street: string;
     city: string;
     zip: string;
@@ -2144,7 +2206,8 @@ interface CustomerAddress {
     vatIdValid?: boolean | null;
     /** When the VAT ID was last checked (ms). Read-only. */
     vatIdCheckedAt?: number | null;
-    phone?: string;
+    /** Null when not set. Send null on update to clear it. */
+    phone?: string | null;
 }
 interface Page {
     slug: string;
@@ -3199,6 +3262,7 @@ declare class BehioStorefront {
         visitorId: string;
         email: string;
     }): Promise<SdkResult<{
+        /** Single-use code for the offered product, issued by this call. */
         code: string;
         percent: number;
         expiresAt: number;
@@ -3965,6 +4029,8 @@ interface AddressDetail {
     formattedAddress: string;
     lat: number;
     lng: number;
+    /** Set (and the address fields empty) when the request had no `placeId`. */
+    error?: string | null;
 }
 declare class AddressModule {
     private client;

package/dist/react.d.ts

@@ -564,7 +564,7 @@ interface ProductLabel {
     id: string;
     slug: string;
     name: string;
-    color?: string;
+    color?: string | null;
     /** Merchant icon name. Render a trusted local icon, with a safe fallback. */
     iconName?: string | null;
 }
@@ -594,9 +594,9 @@ interface ProductListItem {
     id: string;
     slug: string;
     name: string;
-    shortDescription?: string;
+    shortDescription?: string | null;
     sku: string;
-    gtin?: string;
+    gtin?: string | null;
     /** `null` when prices are gated behind login for guests (B2B mode). */
     price: ProductPrice | null;
     inStock: boolean;
@@ -685,6 +685,9 @@ interface ProductListItem {
         url: string;
         alt: string | null;
         order: number;
+        /** COVER | LISTING | HOVER | GALLERY when the cover came from a roled
+         *  product image; absent when it came from the inventory gallery (SDK 2.14.0). */
+        role?: string;
     } | null;
     labels: ProductLabel[];
     isFeatured: boolean;
@@ -899,7 +902,19 @@ interface ProductDetail extends ProductListItem {
      *  null when uncapped or the shop hides stock counts. Cap the PDP quantity
      *  stepper with it, it is exactly the cart rule. SDK 2.13.0. */
     maxPurchasableQuantity?: number | null;
-    longDescription?: string;
+    /**
+     * @deprecated Not sent on the product detail, only on list cards. Use
+     * `media` (or `images`) for the gallery.
+     */
+    image?: ProductListItem["image"];
+    /** @deprecated Not sent on the product detail, only on list cards. */
+    hoverImageUrl?: string | null;
+    /**
+     * @deprecated Not sent on the product detail, only on list cards. Read the
+     * PDP promotions with `catalog.getProductPromotions(slug)`.
+     */
+    activePromotion?: ProductPromotionSummary | null;
+    longDescription?: string | null;
     /**
      * @deprecated Legacy per-listing images. Prefer `media`. Each carries its
      * `role` (COVER | LISTING | HOVER | GALLERY) so the storefront can pick a
@@ -907,7 +922,7 @@ interface ProductDetail extends ProductListItem {
      */
     images: Array<{
         url: string;
-        alt?: string;
+        alt?: string | null;
         order: number;
         role?: string;
     }>;
@@ -975,6 +990,10 @@ interface ProductDetail extends ProductListItem {
         ogDescription?: string | null;
         ogImage?: string | null;
     };
+    /**
+     * @deprecated Never sent by the API. Load a group with
+     * `catalog.getProductGroup(slug)`.
+     */
     productGroups?: Array<{
         slug: string;
         name: string;
@@ -996,8 +1015,8 @@ interface Category {
     id: string;
     slug: string;
     name: string;
-    description?: string;
-    imageUrl?: string;
+    description?: string | null;
+    imageUrl?: string | null;
     children: Category[];
     productCount?: number;
 }
@@ -1060,11 +1079,18 @@ interface Menu {
     locale: string;
     items: MenuItem[];
 }
-interface CategoryDetail extends Category {
+interface CategoryDetail extends Omit<Category, "children"> {
+    /**
+     * @deprecated Never sent on the category detail (it was typed as always
+     * present, so `children.map` crashed). Read subcategories from
+     * `catalog.getCategories()`.
+     */
+    children?: Category[];
     /**
      * SEO/Open Graph for the category page. Matches the backend's nested `seo`
      * shape (the old flat `seoTitle`/`seoDescription` never matched what the API
-     * returned). `keywords` is always null for categories.
+     * returned). `keywords` is always null for categories. Null when the
+     * category has no text in the requested language (SDK 2.14.0 types it).
      */
     seo?: {
         title?: string | null;
@@ -1073,7 +1099,7 @@ interface CategoryDetail extends Category {
         ogTitle?: string | null;
         ogDescription?: string | null;
         ogImage?: string | null;
-    };
+    } | null;
 }
 /**
  * One available filter, derived from a curated parameter the merchant marked
@@ -1091,7 +1117,7 @@ interface FilterField {
     groupSlug: string;
     groupName: string;
     unit?: string | null;
-    values?: string[];
+    values?: string[] | null;
 }
 interface FacetValue {
     /** Raw stored value (normalized), for exact filtering. */
@@ -1342,7 +1368,7 @@ interface CartItemProduct {
      *  arbitrary translation row, so this could come back in another language. */
     name: string;
     sku: string;
-    imageUrl?: string;
+    imageUrl?: string | null;
     inStock: boolean;
     /** Pieces left for an "only X left" note on the cart line; null when the
      *  shop does not track stock, hides the nudge or has plenty. SDK 2.13.0. */
@@ -1440,7 +1466,7 @@ interface Cart {
      *  200 net" was 20, now it is 24.20 at 21 %). It lowers base and VAT, see
      *  `taxBreakdown` and `vatTotal`. */
     discountTotal: number;
-    discount?: CartDiscount;
+    discount?: CartDiscount | null;
     /** Auto-apply promotion discount lines (sale/BOGO). */
     appliedPromotions: CartPromotion[];
     /** Sum of `appliedPromotions[].discountAmount`; already reflected in `grandTotal`. */
@@ -1645,6 +1671,12 @@ interface CheckoutInput {
      * guests. See `customer.getLoyalty()` for the available balance.
      */
     redeemLoyaltyPoints?: number;
+    /**
+     * Cart session to order. The SDK sends it in the `X-Cart-Session` header on
+     * its own, so leave it out; the body field is for clients without the
+     * header (SDK 2.14.0 documents it, the backend has always accepted it).
+     */
+    sessionToken?: string;
 }
 type OrderStatus = (typeof OrderStatuses)[keyof typeof OrderStatuses];
 type PaymentStatus = (typeof PaymentStatuses)[keyof typeof PaymentStatuses];
@@ -1660,6 +1692,8 @@ interface OrderListItem {
     createdAt: number;
 }
 interface OrderItem {
+    /** Order line id (SDK 2.14.0). */
+    id?: string;
     productName: string;
     sku: string;
     /** Photo snapshot from checkout, or the product's current photo. */
@@ -1671,9 +1705,23 @@ interface OrderItem {
     productSlug?: string | null;
     quantity: number;
     unitPrice: number;
+    /** VAT rate of the line in percent, e.g. 21 (SDK 2.14.0). */
+    taxRate?: number;
+    /** VAT of the whole line (SDK 2.14.0). */
+    taxAmount?: number;
     totalPrice: number;
     totalPriceWithTax: number;
 }
+/** A discount code applied to an order (SDK 2.14.0). */
+interface OrderDiscount {
+    code: string;
+    /** PERCENTAGE, FIXED_AMOUNT or FREE_SHIPPING. */
+    type: string;
+    /** Percent or amount as configured on the code. */
+    value: number;
+    /** Money the code took off this order. */
+    appliedAmount: number;
+}
 /**
  * PII-minimized order view returned by `orders.track(token)`. The tracking
  * token is shared in URLs and e-mails, so this deliberately omits full
@@ -1726,9 +1774,14 @@ interface OrderShipment {
     createdAt: number;
 }
 interface OrderStatusHistory {
-    fromStatus?: OrderStatus;
+    /** Null for the first entry of an order. */
+    fromStatus?: OrderStatus | null;
     toStatus: OrderStatus;
-    note?: string;
+    note?: string | null;
+    /**
+     * @deprecated Never sent: who changed the status is internal to the shop.
+     * Kept only so existing templates keep compiling.
+     */
     changedBy?: string;
     createdAt: number;
 }
@@ -1765,8 +1818,8 @@ interface OrderDetail extends OrderListItem {
     shippingAddress: CheckoutAddress;
     billingAddress: CheckoutAddress;
     email: string;
-    phone?: string;
-    customerNote?: string;
+    phone?: string | null;
+    customerNote?: string | null;
     subtotal: number;
     /** Goods VAT before order discounts (goods subtotal = `subtotal` + `taxTotal`). */
     taxTotal: number;
@@ -1788,6 +1841,12 @@ interface OrderDetail extends OrderListItem {
     discountTotal: number;
     fulfillmentStatus: FulfillmentStatus;
     statusHistory: OrderStatusHistory[];
+    /** Discount codes applied to the order (SDK 2.14.0). */
+    discounts?: OrderDiscount[];
+    /**
+     * @deprecated Not sent on the order detail. Only `checkout.createOrder()`
+     * returns it, see `CheckoutResult.trackingToken`.
+     */
     trackingToken?: string;
     /**
      * Digital product delivery (GAP-07): download grants for any digital assets
@@ -2107,10 +2166,12 @@ interface DownloadUrl {
 interface CustomerProfile {
     id: string;
     email: string;
-    firstName?: string;
-    lastName?: string;
-    phone?: string;
+    firstName?: string | null;
+    lastName?: string | null;
+    phone?: string | null;
     emailVerified: boolean;
+    /** Registration time (Unix ms). */
+    createdAt?: number;
     /**
      * B2B approval gate (GAP-19). `false` = the account is awaiting merchant
      * approval (or was deactivated) — show a "pending approval" banner and gate
@@ -2126,7 +2187,8 @@ interface CustomerAddress {
     isDefault: boolean;
     firstName: string;
     lastName: string;
-    company?: string;
+    /** Null when not set. Send null on update to clear it. */
+    company?: string | null;
     street: string;
     city: string;
     zip: string;
@@ -2144,7 +2206,8 @@ interface CustomerAddress {
     vatIdValid?: boolean | null;
     /** When the VAT ID was last checked (ms). Read-only. */
     vatIdCheckedAt?: number | null;
-    phone?: string;
+    /** Null when not set. Send null on update to clear it. */
+    phone?: string | null;
 }
 interface Page {
     slug: string;
@@ -3199,6 +3262,7 @@ declare class BehioStorefront {
         visitorId: string;
         email: string;
     }): Promise<SdkResult<{
+        /** Single-use code for the offered product, issued by this call. */
         code: string;
         percent: number;
         expiresAt: number;
@@ -3965,6 +4029,8 @@ interface AddressDetail {
     formattedAddress: string;
     lat: number;
     lng: number;
+    /** Set (and the address fields empty) when the request had no `placeId`. */
+    error?: string | null;
 }
 declare class AddressModule {
     private client;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behio/storefront-sdk",
-  "version": "2.13.0",
+  "version": "2.14.0",
   "description": "TypeScript SDK for Behio headless e-commerce: core client + React hooks",
   "author": "Behio",
   "license": "MIT",