@behio/storefront-sdk 1.7.0 → 1.9.0

package/dist/{chunk-TJ4TZ5FI.js → chunk-CY6D2YEI.js}

@@ -116,6 +116,11 @@ function toSdkError(err2) {
 }
 
 // src/client.ts
+function isAvailabilityFailure(err2) {
+  if (err2 instanceof BehioNetworkError) return true;
+  if (err2 instanceof BehioApiError) return err2.isRetryable;
+  return false;
+}
 var BehioStorefront = class {
   constructor(config) {
     /** Consent-gated persistent visitor id — set by the analytics tracker. */
@@ -144,6 +149,7 @@ var BehioStorefront = class {
     this.retries = _nullishCoalesce(config.retries, () => ( 1));
     this.retryDelay = _nullishCoalesce(config.retryDelay, () => ( 1e3));
     this.visitorIp = config.visitorIp;
+    this.throwOnAvailabilityError = _nullishCoalesce(config.throwOnAvailabilityError, () => ( false));
     this.catalog = new CatalogModule(this);
     this.auth = new AuthModule(this);
     this.cart = new CartModule(this);
@@ -219,6 +225,21 @@ var BehioStorefront = class {
       body: input
     });
   }
+  /**
+   * Visitor messages from merchant automations (storefront.event action).
+   * Consent-gated visitor id; each message carries a merchant-defined `name`
+   * and free-form `payload` the template reacts to (modal, banner, ...).
+   * Messages stay listed until acknowledged via `ackVisitorMessage`.
+   */
+  async getVisitorMessages(visitorId) {
+    return this.request("GET", "/messages", { query: { visitorId } });
+  }
+  /** Acknowledge a visitor message so it is not delivered again. */
+  async ackVisitorMessage(messageId, visitorId) {
+    return this.request("POST", `/messages/${messageId}/ack`, {
+      query: { visitorId }
+    });
+  }
   /** Get basic shop info */
   async getShopInfo() {
     return this.request("GET", "/shop");
@@ -374,6 +395,9 @@ var BehioStorefront = class {
       const data = await this.rawRequest(method, path, options);
       return ok(data);
     } catch (err2) {
+      if (this.throwOnAvailabilityError && isAvailabilityFailure(err2)) {
+        throw err2;
+      }
       return { data: null, error: toSdkError(err2) };
     }
   }
@@ -401,6 +425,9 @@ var BehioStorefront = class {
       }
       return ok(await res.blob());
     } catch (err2) {
+      if (this.throwOnAvailabilityError && isAvailabilityFailure(err2)) {
+        throw err2;
+      }
       return { data: null, error: toSdkError(err2) };
     }
   }

package/dist/{chunk-TOSF3K7J.mjs → chunk-XMKY4RI5.mjs}

@@ -116,6 +116,11 @@ function toSdkError(err2) {
 }
 
 // src/client.ts
+function isAvailabilityFailure(err2) {
+  if (err2 instanceof BehioNetworkError) return true;
+  if (err2 instanceof BehioApiError) return err2.isRetryable;
+  return false;
+}
 var BehioStorefront = class {
   constructor(config) {
     /** Consent-gated persistent visitor id — set by the analytics tracker. */
@@ -144,6 +149,7 @@ var BehioStorefront = class {
     this.retries = config.retries ?? 1;
     this.retryDelay = config.retryDelay ?? 1e3;
     this.visitorIp = config.visitorIp;
+    this.throwOnAvailabilityError = config.throwOnAvailabilityError ?? false;
     this.catalog = new CatalogModule(this);
     this.auth = new AuthModule(this);
     this.cart = new CartModule(this);
@@ -219,6 +225,21 @@ var BehioStorefront = class {
       body: input
     });
   }
+  /**
+   * Visitor messages from merchant automations (storefront.event action).
+   * Consent-gated visitor id; each message carries a merchant-defined `name`
+   * and free-form `payload` the template reacts to (modal, banner, ...).
+   * Messages stay listed until acknowledged via `ackVisitorMessage`.
+   */
+  async getVisitorMessages(visitorId) {
+    return this.request("GET", "/messages", { query: { visitorId } });
+  }
+  /** Acknowledge a visitor message so it is not delivered again. */
+  async ackVisitorMessage(messageId, visitorId) {
+    return this.request("POST", `/messages/${messageId}/ack`, {
+      query: { visitorId }
+    });
+  }
   /** Get basic shop info */
   async getShopInfo() {
     return this.request("GET", "/shop");
@@ -374,6 +395,9 @@ var BehioStorefront = class {
       const data = await this.rawRequest(method, path, options);
       return ok(data);
     } catch (err2) {
+      if (this.throwOnAvailabilityError && isAvailabilityFailure(err2)) {
+        throw err2;
+      }
       return { data: null, error: toSdkError(err2) };
     }
   }
@@ -401,6 +425,9 @@ var BehioStorefront = class {
       }
       return ok(await res.blob());
     } catch (err2) {
+      if (this.throwOnAvailabilityError && isAvailabilityFailure(err2)) {
+        throw err2;
+      }
       return { data: null, error: toSdkError(err2) };
     }
   }

package/dist/{client-BSDdOEcK.d.mts → client-C635vSzU.d.mts}

@@ -29,6 +29,19 @@ interface BehioStorefrontConfig {
      * automatically from the incoming request headers.
      */
     visitorIp?: string | (() => string | null | undefined | Promise<string | null | undefined>);
+    /**
+     * Throw availability failures (429, 5xx, network, timeout) instead of
+     * returning them as `SdkResult.error`. Business outcomes (400, 401, 404,
+     * 409, …) keep the tuple shape either way.
+     *
+     * Why this exists: a storefront section that reads `result.data ?? []`
+     * silently renders an EMPTY catalog when the API is rate-limited or down,
+     * which looks exactly like a shop with no products. With this flag the
+     * failure surfaces as an exception, so SSR/ISR keeps the last good page and
+     * the visitor gets an error boundary instead of a lying page. Recommended
+     * `true` for every server-rendered catalog client.
+     */
+    throwOnAvailabilityError?: boolean;
     /** Request timeout in milliseconds. Default: 30000 (30s) */
     timeout?: number;
     /** Number of retries on network/5xx errors. Default: 1 */
@@ -2334,6 +2347,7 @@ declare class BehioStorefront {
     private rateLimitRemaining;
     private rateLimitReset;
     private visitorIp?;
+    private throwOnAvailabilityError;
     constructor(config: BehioStorefrontConfig);
     readonly catalog: CatalogModule;
     readonly auth: AuthModule;
@@ -2419,6 +2433,25 @@ declare class BehioStorefront {
         percent: number;
         expiresAt: number;
     }>>;
+    /**
+     * Visitor messages from merchant automations (storefront.event action).
+     * Consent-gated visitor id; each message carries a merchant-defined `name`
+     * and free-form `payload` the template reacts to (modal, banner, ...).
+     * Messages stay listed until acknowledged via `ackVisitorMessage`.
+     */
+    getVisitorMessages(visitorId: string): Promise<SdkResult<{
+        items: Array<{
+            id: string;
+            name: string;
+            payload: Record<string, unknown> | null;
+            createdAt: number;
+            expiresAt: number;
+        }>;
+    }>>;
+    /** Acknowledge a visitor message so it is not delivered again. */
+    ackVisitorMessage(messageId: string, visitorId: string): Promise<SdkResult<{
+        ok: boolean;
+    }>>;
     /** Get basic shop info */
     getShopInfo(): Promise<SdkResult<ShopInfo>>;
     /** Get SEO metadata for the shop homepage in the given locale (defaults to shop default). */

package/dist/{client-BSDdOEcK.d.ts → client-C635vSzU.d.ts}

@@ -29,6 +29,19 @@ interface BehioStorefrontConfig {
      * automatically from the incoming request headers.
      */
     visitorIp?: string | (() => string | null | undefined | Promise<string | null | undefined>);
+    /**
+     * Throw availability failures (429, 5xx, network, timeout) instead of
+     * returning them as `SdkResult.error`. Business outcomes (400, 401, 404,
+     * 409, …) keep the tuple shape either way.
+     *
+     * Why this exists: a storefront section that reads `result.data ?? []`
+     * silently renders an EMPTY catalog when the API is rate-limited or down,
+     * which looks exactly like a shop with no products. With this flag the
+     * failure surfaces as an exception, so SSR/ISR keeps the last good page and
+     * the visitor gets an error boundary instead of a lying page. Recommended
+     * `true` for every server-rendered catalog client.
+     */
+    throwOnAvailabilityError?: boolean;
     /** Request timeout in milliseconds. Default: 30000 (30s) */
     timeout?: number;
     /** Number of retries on network/5xx errors. Default: 1 */
@@ -2334,6 +2347,7 @@ declare class BehioStorefront {
     private rateLimitRemaining;
     private rateLimitReset;
     private visitorIp?;
+    private throwOnAvailabilityError;
     constructor(config: BehioStorefrontConfig);
     readonly catalog: CatalogModule;
     readonly auth: AuthModule;
@@ -2419,6 +2433,25 @@ declare class BehioStorefront {
         percent: number;
         expiresAt: number;
     }>>;
+    /**
+     * Visitor messages from merchant automations (storefront.event action).
+     * Consent-gated visitor id; each message carries a merchant-defined `name`
+     * and free-form `payload` the template reacts to (modal, banner, ...).
+     * Messages stay listed until acknowledged via `ackVisitorMessage`.
+     */
+    getVisitorMessages(visitorId: string): Promise<SdkResult<{
+        items: Array<{
+            id: string;
+            name: string;
+            payload: Record<string, unknown> | null;
+            createdAt: number;
+            expiresAt: number;
+        }>;
+    }>>;
+    /** Acknowledge a visitor message so it is not delivered again. */
+    ackVisitorMessage(messageId: string, visitorId: string): Promise<SdkResult<{
+        ok: boolean;
+    }>>;
     /** Get basic shop info */
     getShopInfo(): Promise<SdkResult<ShopInfo>>;
     /** Get SEO metadata for the shop homepage in the given locale (defaults to shop default). */

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 } from './client-BSDdOEcK.mjs';
-export { A as ActivePromotion, b as AddToCartInput, c as AddressDetail, d as AddressSuggestion, e as AddressType, f as AddressTypes, g as AuthTokens, h as BackInStockSubscription, i as BadgeTone, j as BehioApiError, k as BehioErrorCode, l as BehioEventHandler, m as BehioEventType, n as BehioNetworkError, o as BehioStorefrontConfig, p as Bundle, q as BundleItem, r as Cart, s as CartBundleLine, t as CartBundleLineItem, u as CartDiscount, v as CartItem, w as CartItemProduct, x as CartPromotion, y as Category, z as CategoryDetail, D as CertificateVerification, E as CheckoutAddress, F as CheckoutInput, G as CheckoutPaymentMethod, H as CheckoutSettings, I as CookieConsentInput, J as CourseAttachment, K as CourseCertificate, L as CourseComment, M as CourseCommentReply, N as CourseCommentsList, O as CourseDetail, Q as CourseLesson, R as CourseListItem, T as CourseModule, U as CoursePostedComment, V as CourseProgress, W as CourseTutorMessage, X as CourseTutorThread, Y as CrossSellItem, Z as CustomerAddress, _ as CustomerProfile, $ as DigitalDownload, a0 as DownloadUrl, a1 as Facet, a2 as FacetAvailability, a3 as FacetCategory, a4 as FacetLabel, a5 as FacetPriceRange, a6 as FacetRange, a7 as FacetRatingBucket, a8 as FacetValue, a9 as FacetsResponse, aa as FilterField, ab as FulfillmentStatus, ac as FulfillmentStatuses, ad as GiftCardBalance, ae as GiftCardPurchaseInput, af as GiftCardPurchaseResult, ag as GiftCardSummary, ah as LessonNote, ai as LessonQuiz, aj as LoginInput, ak as LoyaltyBalance, al as LoyaltyNextTier, am as LoyaltyProgram, an as LoyaltySummary, ao as LoyaltyTier, ap as LoyaltyTierPerks, aq as LoyaltyTransaction, ar as Menu, as as MenuItem, at as MenuItemRef, au as MenuItemType, av as MessageResponse, aw as NewsletterOptInDefault, ax as NewsletterSubscribeInput, ay as NewsletterSubscribeResult, az as NewsletterUnsubscribeResult, aA as OrderAccessRequestResponse, aB as OrderAccessVerifyResponse, aC as OrderDetail, aD as OrderItem, aE as OrderListItem, aF as OrderStatus, aG as OrderStatusHistory, aH as OrderStatuses, aI as OrderTracking, aJ as Page, aK as PageAttachment, aL as PageDetail, aM as PaginatedResponse, aN as PaymentStatus, aO as PaymentStatuses, aP as PickupPoint, aQ as PickupPointHours, aR as PickupPointsInput, aS as PriceDisplay, aT as ProductAssetGroup, aU as ProductAssetItem, aV as ProductAvailability, aW as ProductGroup, aX as ProductLabel, aY as ProductListItem, aZ as ProductMedia, a_ as ProductMediaVariant, a$ as ProductParameter, b0 as ProductParameterGroup, b1 as ProductParametersResponse, b2 as ProductPrice, b3 as ProductPromotionSummary, b4 as ProductReview, b5 as ProductReviewsResponse, b6 as ProductSibling, b7 as ProductSort, b8 as ProductSortValue, b9 as ProductVolumePrice, ba as ProductsQuery, bb as QuizAnswerInput, bc as QuizAnswerResult, bd as QuizQuestion, be as QuizResult, bf as QuoteItem, bg as QuoteRequest, bh as RegisterInput, bi as RegisterResult, bj as RequestInterceptor, bk as RequestInterceptorConfig, bl as ResponseInterceptor, bm as ResponseInterceptorData, bn as ReturnRequest, bo as ReturnRequestItem, bp as ReturnStatus, bq as ReturnStatusItem, br as ReturnableOrder, bs as ReturnableOrderItem, bt as SdkError, bu as ShippingMethodSummary, bv as ShippingQuote, bw as ShippingQuoteInput, bx as ShopInfo, by as ShopScript, bz as ShopScriptPlacement, bA as ShopScriptType, bB as ShopScripts, bC as ShopSeo, bD as ShopSeoIdentity, bE as Sitemap, bF as SitemapEntry, bG as StockBehavior, bH as StockMode, bI as SubmitQuoteInput, bJ as SubmitReturnInput, bK as SubmitReviewInput, bL as Subscription, bM as SubscriptionAction, bN as SubscriptionFrequency, bO as SubscriptionItem, bP as SubscriptionStatus, bQ as TaxBreakdownLine, bR as VariantAxis, bS as VariantAxisValue, bT as WishlistItem, bU as err, bV as ok, bW as toSdkError } from './client-BSDdOEcK.mjs';
+import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent } from './client-C635vSzU.mjs';
+export { A as ActivePromotion, b as AddToCartInput, c as AddressDetail, d as AddressSuggestion, e as AddressType, f as AddressTypes, g as AuthTokens, h as BackInStockSubscription, i as BadgeTone, j as BehioApiError, k as BehioErrorCode, l as BehioEventHandler, m as BehioEventType, n as BehioNetworkError, o as BehioStorefrontConfig, p as Bundle, q as BundleItem, r as Cart, s as CartBundleLine, t as CartBundleLineItem, u as CartDiscount, v as CartItem, w as CartItemProduct, x as CartPromotion, y as Category, z as CategoryDetail, D as CertificateVerification, E as CheckoutAddress, F as CheckoutInput, G as CheckoutPaymentMethod, H as CheckoutSettings, I as CookieConsentInput, J as CourseAttachment, K as CourseCertificate, L as CourseComment, M as CourseCommentReply, N as CourseCommentsList, O as CourseDetail, Q as CourseLesson, R as CourseListItem, T as CourseModule, U as CoursePostedComment, V as CourseProgress, W as CourseTutorMessage, X as CourseTutorThread, Y as CrossSellItem, Z as CustomerAddress, _ as CustomerProfile, $ as DigitalDownload, a0 as DownloadUrl, a1 as Facet, a2 as FacetAvailability, a3 as FacetCategory, a4 as FacetLabel, a5 as FacetPriceRange, a6 as FacetRange, a7 as FacetRatingBucket, a8 as FacetValue, a9 as FacetsResponse, aa as FilterField, ab as FulfillmentStatus, ac as FulfillmentStatuses, ad as GiftCardBalance, ae as GiftCardPurchaseInput, af as GiftCardPurchaseResult, ag as GiftCardSummary, ah as LessonNote, ai as LessonQuiz, aj as LoginInput, ak as LoyaltyBalance, al as LoyaltyNextTier, am as LoyaltyProgram, an as LoyaltySummary, ao as LoyaltyTier, ap as LoyaltyTierPerks, aq as LoyaltyTransaction, ar as Menu, as as MenuItem, at as MenuItemRef, au as MenuItemType, av as MessageResponse, aw as NewsletterOptInDefault, ax as NewsletterSubscribeInput, ay as NewsletterSubscribeResult, az as NewsletterUnsubscribeResult, aA as OrderAccessRequestResponse, aB as OrderAccessVerifyResponse, aC as OrderDetail, aD as OrderItem, aE as OrderListItem, aF as OrderStatus, aG as OrderStatusHistory, aH as OrderStatuses, aI as OrderTracking, aJ as Page, aK as PageAttachment, aL as PageDetail, aM as PaginatedResponse, aN as PaymentStatus, aO as PaymentStatuses, aP as PickupPoint, aQ as PickupPointHours, aR as PickupPointsInput, aS as PriceDisplay, aT as ProductAssetGroup, aU as ProductAssetItem, aV as ProductAvailability, aW as ProductGroup, aX as ProductLabel, aY as ProductListItem, aZ as ProductMedia, a_ as ProductMediaVariant, a$ as ProductParameter, b0 as ProductParameterGroup, b1 as ProductParametersResponse, b2 as ProductPrice, b3 as ProductPromotionSummary, b4 as ProductReview, b5 as ProductReviewsResponse, b6 as ProductSibling, b7 as ProductSort, b8 as ProductSortValue, b9 as ProductVolumePrice, ba as ProductsQuery, bb as QuizAnswerInput, bc as QuizAnswerResult, bd as QuizQuestion, be as QuizResult, bf as QuoteItem, bg as QuoteRequest, bh as RegisterInput, bi as RegisterResult, bj as RequestInterceptor, bk as RequestInterceptorConfig, bl as ResponseInterceptor, bm as ResponseInterceptorData, bn as ReturnRequest, bo as ReturnRequestItem, bp as ReturnStatus, bq as ReturnStatusItem, br as ReturnableOrder, bs as ReturnableOrderItem, bt as SdkError, bu as ShippingMethodSummary, bv as ShippingQuote, bw as ShippingQuoteInput, bx as ShopInfo, by as ShopScript, bz as ShopScriptPlacement, bA as ShopScriptType, bB as ShopScripts, bC as ShopSeo, bD as ShopSeoIdentity, bE as Sitemap, bF as SitemapEntry, bG as StockBehavior, bH as StockMode, bI as SubmitQuoteInput, bJ as SubmitReturnInput, bK as SubmitReviewInput, bL as Subscription, bM as SubscriptionAction, bN as SubscriptionFrequency, bO as SubscriptionItem, bP as SubscriptionStatus, bQ as TaxBreakdownLine, bR as VariantAxis, bS as VariantAxisValue, bT as WishlistItem, bU as err, bV as ok, bW as toSdkError } from './client-C635vSzU.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 } from './client-BSDdOEcK.js';
-export { A as ActivePromotion, b as AddToCartInput, c as AddressDetail, d as AddressSuggestion, e as AddressType, f as AddressTypes, g as AuthTokens, h as BackInStockSubscription, i as BadgeTone, j as BehioApiError, k as BehioErrorCode, l as BehioEventHandler, m as BehioEventType, n as BehioNetworkError, o as BehioStorefrontConfig, p as Bundle, q as BundleItem, r as Cart, s as CartBundleLine, t as CartBundleLineItem, u as CartDiscount, v as CartItem, w as CartItemProduct, x as CartPromotion, y as Category, z as CategoryDetail, D as CertificateVerification, E as CheckoutAddress, F as CheckoutInput, G as CheckoutPaymentMethod, H as CheckoutSettings, I as CookieConsentInput, J as CourseAttachment, K as CourseCertificate, L as CourseComment, M as CourseCommentReply, N as CourseCommentsList, O as CourseDetail, Q as CourseLesson, R as CourseListItem, T as CourseModule, U as CoursePostedComment, V as CourseProgress, W as CourseTutorMessage, X as CourseTutorThread, Y as CrossSellItem, Z as CustomerAddress, _ as CustomerProfile, $ as DigitalDownload, a0 as DownloadUrl, a1 as Facet, a2 as FacetAvailability, a3 as FacetCategory, a4 as FacetLabel, a5 as FacetPriceRange, a6 as FacetRange, a7 as FacetRatingBucket, a8 as FacetValue, a9 as FacetsResponse, aa as FilterField, ab as FulfillmentStatus, ac as FulfillmentStatuses, ad as GiftCardBalance, ae as GiftCardPurchaseInput, af as GiftCardPurchaseResult, ag as GiftCardSummary, ah as LessonNote, ai as LessonQuiz, aj as LoginInput, ak as LoyaltyBalance, al as LoyaltyNextTier, am as LoyaltyProgram, an as LoyaltySummary, ao as LoyaltyTier, ap as LoyaltyTierPerks, aq as LoyaltyTransaction, ar as Menu, as as MenuItem, at as MenuItemRef, au as MenuItemType, av as MessageResponse, aw as NewsletterOptInDefault, ax as NewsletterSubscribeInput, ay as NewsletterSubscribeResult, az as NewsletterUnsubscribeResult, aA as OrderAccessRequestResponse, aB as OrderAccessVerifyResponse, aC as OrderDetail, aD as OrderItem, aE as OrderListItem, aF as OrderStatus, aG as OrderStatusHistory, aH as OrderStatuses, aI as OrderTracking, aJ as Page, aK as PageAttachment, aL as PageDetail, aM as PaginatedResponse, aN as PaymentStatus, aO as PaymentStatuses, aP as PickupPoint, aQ as PickupPointHours, aR as PickupPointsInput, aS as PriceDisplay, aT as ProductAssetGroup, aU as ProductAssetItem, aV as ProductAvailability, aW as ProductGroup, aX as ProductLabel, aY as ProductListItem, aZ as ProductMedia, a_ as ProductMediaVariant, a$ as ProductParameter, b0 as ProductParameterGroup, b1 as ProductParametersResponse, b2 as ProductPrice, b3 as ProductPromotionSummary, b4 as ProductReview, b5 as ProductReviewsResponse, b6 as ProductSibling, b7 as ProductSort, b8 as ProductSortValue, b9 as ProductVolumePrice, ba as ProductsQuery, bb as QuizAnswerInput, bc as QuizAnswerResult, bd as QuizQuestion, be as QuizResult, bf as QuoteItem, bg as QuoteRequest, bh as RegisterInput, bi as RegisterResult, bj as RequestInterceptor, bk as RequestInterceptorConfig, bl as ResponseInterceptor, bm as ResponseInterceptorData, bn as ReturnRequest, bo as ReturnRequestItem, bp as ReturnStatus, bq as ReturnStatusItem, br as ReturnableOrder, bs as ReturnableOrderItem, bt as SdkError, bu as ShippingMethodSummary, bv as ShippingQuote, bw as ShippingQuoteInput, bx as ShopInfo, by as ShopScript, bz as ShopScriptPlacement, bA as ShopScriptType, bB as ShopScripts, bC as ShopSeo, bD as ShopSeoIdentity, bE as Sitemap, bF as SitemapEntry, bG as StockBehavior, bH as StockMode, bI as SubmitQuoteInput, bJ as SubmitReturnInput, bK as SubmitReviewInput, bL as Subscription, bM as SubscriptionAction, bN as SubscriptionFrequency, bO as SubscriptionItem, bP as SubscriptionStatus, bQ as TaxBreakdownLine, bR as VariantAxis, bS as VariantAxisValue, bT as WishlistItem, bU as err, bV as ok, bW as toSdkError } from './client-BSDdOEcK.js';
+import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent } from './client-C635vSzU.js';
+export { A as ActivePromotion, b as AddToCartInput, c as AddressDetail, d as AddressSuggestion, e as AddressType, f as AddressTypes, g as AuthTokens, h as BackInStockSubscription, i as BadgeTone, j as BehioApiError, k as BehioErrorCode, l as BehioEventHandler, m as BehioEventType, n as BehioNetworkError, o as BehioStorefrontConfig, p as Bundle, q as BundleItem, r as Cart, s as CartBundleLine, t as CartBundleLineItem, u as CartDiscount, v as CartItem, w as CartItemProduct, x as CartPromotion, y as Category, z as CategoryDetail, D as CertificateVerification, E as CheckoutAddress, F as CheckoutInput, G as CheckoutPaymentMethod, H as CheckoutSettings, I as CookieConsentInput, J as CourseAttachment, K as CourseCertificate, L as CourseComment, M as CourseCommentReply, N as CourseCommentsList, O as CourseDetail, Q as CourseLesson, R as CourseListItem, T as CourseModule, U as CoursePostedComment, V as CourseProgress, W as CourseTutorMessage, X as CourseTutorThread, Y as CrossSellItem, Z as CustomerAddress, _ as CustomerProfile, $ as DigitalDownload, a0 as DownloadUrl, a1 as Facet, a2 as FacetAvailability, a3 as FacetCategory, a4 as FacetLabel, a5 as FacetPriceRange, a6 as FacetRange, a7 as FacetRatingBucket, a8 as FacetValue, a9 as FacetsResponse, aa as FilterField, ab as FulfillmentStatus, ac as FulfillmentStatuses, ad as GiftCardBalance, ae as GiftCardPurchaseInput, af as GiftCardPurchaseResult, ag as GiftCardSummary, ah as LessonNote, ai as LessonQuiz, aj as LoginInput, ak as LoyaltyBalance, al as LoyaltyNextTier, am as LoyaltyProgram, an as LoyaltySummary, ao as LoyaltyTier, ap as LoyaltyTierPerks, aq as LoyaltyTransaction, ar as Menu, as as MenuItem, at as MenuItemRef, au as MenuItemType, av as MessageResponse, aw as NewsletterOptInDefault, ax as NewsletterSubscribeInput, ay as NewsletterSubscribeResult, az as NewsletterUnsubscribeResult, aA as OrderAccessRequestResponse, aB as OrderAccessVerifyResponse, aC as OrderDetail, aD as OrderItem, aE as OrderListItem, aF as OrderStatus, aG as OrderStatusHistory, aH as OrderStatuses, aI as OrderTracking, aJ as Page, aK as PageAttachment, aL as PageDetail, aM as PaginatedResponse, aN as PaymentStatus, aO as PaymentStatuses, aP as PickupPoint, aQ as PickupPointHours, aR as PickupPointsInput, aS as PriceDisplay, aT as ProductAssetGroup, aU as ProductAssetItem, aV as ProductAvailability, aW as ProductGroup, aX as ProductLabel, aY as ProductListItem, aZ as ProductMedia, a_ as ProductMediaVariant, a$ as ProductParameter, b0 as ProductParameterGroup, b1 as ProductParametersResponse, b2 as ProductPrice, b3 as ProductPromotionSummary, b4 as ProductReview, b5 as ProductReviewsResponse, b6 as ProductSibling, b7 as ProductSort, b8 as ProductSortValue, b9 as ProductVolumePrice, ba as ProductsQuery, bb as QuizAnswerInput, bc as QuizAnswerResult, bd as QuizQuestion, be as QuizResult, bf as QuoteItem, bg as QuoteRequest, bh as RegisterInput, bi as RegisterResult, bj as RequestInterceptor, bk as RequestInterceptorConfig, bl as ResponseInterceptor, bm as ResponseInterceptorData, bn as ReturnRequest, bo as ReturnRequestItem, bp as ReturnStatus, bq as ReturnStatusItem, br as ReturnableOrder, bs as ReturnableOrderItem, bt as SdkError, bu as ShippingMethodSummary, bv as ShippingQuote, bw as ShippingQuoteInput, bx as ShopInfo, by as ShopScript, bz as ShopScriptPlacement, bA as ShopScriptType, bB as ShopScripts, bC as ShopSeo, bD as ShopSeoIdentity, bE as Sitemap, bF as SitemapEntry, bG as StockBehavior, bH as StockMode, bI as SubmitQuoteInput, bJ as SubmitReturnInput, bK as SubmitReviewInput, bL as Subscription, bM as SubscriptionAction, bN as SubscriptionFrequency, bO as SubscriptionItem, bP as SubscriptionStatus, bQ as TaxBreakdownLine, bR as VariantAxis, bS as VariantAxisValue, bT as WishlistItem, bU as err, bV as ok, bW as toSdkError } from './client-C635vSzU.js';
 
 /**
  * Format a price amount with currency using Intl.NumberFormat.

package/dist/index.js

@@ -10,7 +10,7 @@
 
 
 
-var _chunkTJ4TZ5FIjs = require('./chunk-TJ4TZ5FI.js');
+var _chunkCY6D2YEIjs = require('./chunk-CY6D2YEI.js');
 
 // src/react/utils/format-price.ts
 function formatPrice(amount, currency, locale) {
@@ -243,4 +243,4 @@ async function revokeAnalyticsConsent(client) {
 
 
 
-exports.AddressTypes = _chunkTJ4TZ5FIjs.AddressTypes; exports.BehioApiError = _chunkTJ4TZ5FIjs.BehioApiError; exports.BehioNetworkError = _chunkTJ4TZ5FIjs.BehioNetworkError; exports.BehioStorefront = _chunkTJ4TZ5FIjs.BehioStorefront; exports.FulfillmentStatuses = _chunkTJ4TZ5FIjs.FulfillmentStatuses; exports.OrderStatuses = _chunkTJ4TZ5FIjs.OrderStatuses; exports.PaymentStatuses = _chunkTJ4TZ5FIjs.PaymentStatuses; exports.ProductSort = _chunkTJ4TZ5FIjs.ProductSort; exports.VARIANT_QUERY_PARAM = VARIANT_QUERY_PARAM; exports.availableAxisValues = availableAxisValues; exports.buildVariantComparison = buildVariantComparison; exports.err = _chunkTJ4TZ5FIjs.err; exports.findVariantByAttributes = findVariantByAttributes; exports.formatPrice = formatPrice; exports.generateVisitorId = generateVisitorId; exports.getStoredVisitorId = getStoredVisitorId; exports.grantAnalyticsConsent = grantAnalyticsConsent; exports.ok = _chunkTJ4TZ5FIjs.ok; exports.resolveVariantContent = resolveVariantContent; exports.revokeAnalyticsConsent = revokeAnalyticsConsent; exports.toSdkError = _chunkTJ4TZ5FIjs.toSdkError; exports.trackEcommerceEvent = trackEcommerceEvent; exports.variantFromQuery = variantFromQuery; exports.variantHref = variantHref;
+exports.AddressTypes = _chunkCY6D2YEIjs.AddressTypes; exports.BehioApiError = _chunkCY6D2YEIjs.BehioApiError; exports.BehioNetworkError = _chunkCY6D2YEIjs.BehioNetworkError; exports.BehioStorefront = _chunkCY6D2YEIjs.BehioStorefront; exports.FulfillmentStatuses = _chunkCY6D2YEIjs.FulfillmentStatuses; exports.OrderStatuses = _chunkCY6D2YEIjs.OrderStatuses; exports.PaymentStatuses = _chunkCY6D2YEIjs.PaymentStatuses; exports.ProductSort = _chunkCY6D2YEIjs.ProductSort; exports.VARIANT_QUERY_PARAM = VARIANT_QUERY_PARAM; exports.availableAxisValues = availableAxisValues; exports.buildVariantComparison = buildVariantComparison; exports.err = _chunkCY6D2YEIjs.err; exports.findVariantByAttributes = findVariantByAttributes; exports.formatPrice = formatPrice; exports.generateVisitorId = generateVisitorId; exports.getStoredVisitorId = getStoredVisitorId; exports.grantAnalyticsConsent = grantAnalyticsConsent; exports.ok = _chunkCY6D2YEIjs.ok; exports.resolveVariantContent = resolveVariantContent; exports.revokeAnalyticsConsent = revokeAnalyticsConsent; exports.toSdkError = _chunkCY6D2YEIjs.toSdkError; exports.trackEcommerceEvent = trackEcommerceEvent; exports.variantFromQuery = variantFromQuery; exports.variantHref = variantHref;

package/dist/index.mjs

@@ -10,7 +10,7 @@ import {
   err,
   ok,
   toSdkError
-} from "./chunk-TOSF3K7J.mjs";
+} from "./chunk-XMKY4RI5.mjs";
 
 // src/react/utils/format-price.ts
 function formatPrice(amount, currency, locale) {

package/dist/next.d.mts

@@ -1,4 +1,4 @@
-import { o as BehioStorefrontConfig, B as BehioStorefront } from './client-BSDdOEcK.mjs';
+import { o as BehioStorefrontConfig, B as BehioStorefront } from './client-C635vSzU.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 { o as BehioStorefrontConfig, B as BehioStorefront } from './client-BSDdOEcK.js';
+import { o as BehioStorefrontConfig, B as BehioStorefront } from './client-C635vSzU.js';
 
 interface GetBehioOptions extends Partial<BehioStorefrontConfig> {
     /** Override the cart session cookie name (default: "behio_cart_session"). */

package/dist/next.js

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkTJ4TZ5FIjs = require('./chunk-TJ4TZ5FI.js');
+var _chunkCY6D2YEIjs = require('./chunk-CY6D2YEI.js');
 
 // src/next.ts
 var _headers = require('next/headers');
@@ -18,7 +18,7 @@ async function getBehio(options = {}) {
   const locale = _nullishCoalesce(options.locale, () => ( process.env.BEHIO_LOCALE));
   const currency = _nullishCoalesce(options.currency, () => ( process.env.BEHIO_CURRENCY));
   const cookieName = _nullishCoalesce(options.cartCookieName, () => ( CART_COOKIE_NAME));
-  const client = new (0, _chunkTJ4TZ5FIjs.BehioStorefront)({
+  const client = new (0, _chunkCY6D2YEIjs.BehioStorefront)({
     apiKey,
     ...baseUrl ? { baseUrl } : {},
     ...locale ? { locale } : {},

package/dist/next.mjs

@@ -1,6 +1,6 @@
 import {
   BehioStorefront
-} from "./chunk-TOSF3K7J.mjs";
+} from "./chunk-XMKY4RI5.mjs";
 
 // src/next.ts
 import { cookies, headers } from "next/headers";

package/dist/react.d.mts

@@ -85,6 +85,19 @@ interface BehioStorefrontConfig {
      * automatically from the incoming request headers.
      */
     visitorIp?: string | (() => string | null | undefined | Promise<string | null | undefined>);
+    /**
+     * Throw availability failures (429, 5xx, network, timeout) instead of
+     * returning them as `SdkResult.error`. Business outcomes (400, 401, 404,
+     * 409, …) keep the tuple shape either way.
+     *
+     * Why this exists: a storefront section that reads `result.data ?? []`
+     * silently renders an EMPTY catalog when the API is rate-limited or down,
+     * which looks exactly like a shop with no products. With this flag the
+     * failure surfaces as an exception, so SSR/ISR keeps the last good page and
+     * the visitor gets an error boundary instead of a lying page. Recommended
+     * `true` for every server-rendered catalog client.
+     */
+    throwOnAvailabilityError?: boolean;
     /** Request timeout in milliseconds. Default: 30000 (30s) */
     timeout?: number;
     /** Number of retries on network/5xx errors. Default: 1 */
@@ -2378,6 +2391,7 @@ declare class BehioStorefront {
     private rateLimitRemaining;
     private rateLimitReset;
     private visitorIp?;
+    private throwOnAvailabilityError;
     constructor(config: BehioStorefrontConfig);
     readonly catalog: CatalogModule;
     readonly auth: AuthModule;
@@ -2463,6 +2477,25 @@ declare class BehioStorefront {
         percent: number;
         expiresAt: number;
     }>>;
+    /**
+     * Visitor messages from merchant automations (storefront.event action).
+     * Consent-gated visitor id; each message carries a merchant-defined `name`
+     * and free-form `payload` the template reacts to (modal, banner, ...).
+     * Messages stay listed until acknowledged via `ackVisitorMessage`.
+     */
+    getVisitorMessages(visitorId: string): Promise<SdkResult<{
+        items: Array<{
+            id: string;
+            name: string;
+            payload: Record<string, unknown> | null;
+            createdAt: number;
+            expiresAt: number;
+        }>;
+    }>>;
+    /** Acknowledge a visitor message so it is not delivered again. */
+    ackVisitorMessage(messageId: string, visitorId: string): Promise<SdkResult<{
+        ok: boolean;
+    }>>;
     /** Get basic shop info */
     getShopInfo(): Promise<SdkResult<ShopInfo>>;
     /** Get SEO metadata for the shop homepage in the given locale (defaults to shop default). */
@@ -3733,6 +3766,60 @@ declare function usePersonalOffers(options?: UsePersonalOffersOptions): {
     claimError: Error | null;
 };
 
+/**
+ * One message from a merchant automation (storefront.event action). `name`
+ * and `payload` are merchant-defined in the automation builder; the template
+ * decides how to react (modal, banner, toast, anything).
+ */
+interface VisitorMessage {
+    id: string;
+    name: string;
+    payload: Record<string, unknown> | null;
+    /** Epoch ms. */
+    createdAt: number;
+    /** Epoch ms. */
+    expiresAt: number;
+}
+interface UseVisitorMessagesOptions {
+    /**
+     * Consent-gated analytics visitor id. When omitted the hook polls
+     * `client.getAnalyticsVisitorId()` until the tracker resolves consent.
+     */
+    visitorId?: string;
+    enabled?: boolean;
+    /** Poll interval in ms (default 30000). Set 0 to fetch only on mount/focus. */
+    pollMs?: number;
+    /**
+     * Called once per delivered message. Acknowledge with the returned `ack`
+     * (or call `ack(message.id)` yourself later) so the message is not shown
+     * again on the next page view.
+     */
+    onMessage?: (message: VisitorMessage) => void;
+    /**
+     * Also dispatch each delivered message as a `behio:visitor-message`
+     * CustomEvent on `window` (detail = the message). Lets merchants react
+     * with plain JS outside React. Default true.
+     */
+    dispatchDomEvents?: boolean;
+}
+/**
+ * Visitor messages channel: pull-based delivery of automation events to the
+ * storefront. Consent-gated - without an analytics visitor id the hook stays
+ * idle, so it is always safe to mount. Typical use: show a modal when an
+ * automation sends `storefront.event` with name "sleva-modal".
+ */
+declare function useVisitorMessages(options?: UseVisitorMessagesOptions): {
+    messages: VisitorMessage[];
+    isLoading: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        items: VisitorMessage[];
+    }>, Error>>;
+    /** Mark a message as shown; it will not be delivered again. */
+    ack: (messageId: string) => Promise<boolean>;
+    visitorId: string | null;
+};
+
 /** One Behio Analytics ingest event (mirrors the public analytics DTO). */
 interface AnalyticsEventInput {
     type: "pageview" | "ecommerce" | "custom";
@@ -4666,4 +4753,4 @@ declare function revokeAnalyticsConsent(client: BehioStorefront): Promise<SdkRes
     success: boolean;
 }>>;
 
-export { type ActivePromotion, type AddToCartInput, type AnalyticsEventInput, type AuthTokens, BehioAnalyticsTracker, BehioApiError, BehioProvider, type BehioProviderProps, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CookieConsent, type CookieConsentInput, type CrossSellItem, CurrencySwitcher, type CurrencySwitcherProps, type CurrencySwitcherRenderProps, type CustomerAddress, type CustomerProfile, type EcommerceEventName, type EcommerceItem, type EcommercePayload, type Facet, type FacetRange, type FacetValue, type FacetsResponse, type FilterField, type FulfillmentStatus, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type Page, type PageDetail, type PaginatedResponse, type PaymentStatus, type PersonalOffer, type ProductDetail, type ProductLabel, type ProductListItem, type ProductParameter, type ProductParameterGroup, type ProductParametersResponse, type ProductPrice, type ProductReview, type ProductReviewsResponse, type ProductVariant, type ProductsQuery, type QuoteRequest, type RegisterInput, type ReturnRequest, type ShopInfo, type ShopSeo, type StorageAdapter, StorefrontScripts, type StorefrontScriptsProps, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCertificateVerificationOptions, type UseCourseCertificatesOptions, type UseCourseOptions, type UseCoursesOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFacetsOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseLessonCommentsOptions, type UseLessonNoteOptions, type UseLessonQuizOptions, type UseLessonTutorOptions, type UseLoyaltyOptions, type UseMenuOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UsePaymentMethodsOptions, type UsePersonalOffersOptions, type UseProductOptions, type UseProductParametersOptions, type UseProductsOptions, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingQuoteOptions, type UseShopInfoOptions, type UseShopScriptsOptions, type UseShopSeoOptions, type UseSubscriptionsOptions, type WishlistItem, cookieStorage, createMemoryStorage, detectStorage, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, localStorageAdapter, memoryStorage, revokeAnalyticsConsent, trackEcommerceEvent, useAddressAutocomplete, useAddresses, useAnalyticsEvents, useAuth, useBehio, useBehioClient, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCertificateVerification, useCheckout, useCookieConsent, useCourse, useCourseCertificates, useCourses, useCrossSell, useCurrency, useCustomer, useFacets, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLessonComments, useLessonNote, useLessonQuiz, useLessonTutor, useLookupReturnableOrder, useLoyalty, useMenu, useNewsletterSubscribe, useNewsletterUnsubscribe, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, usePaymentMethods, usePersonalOffers, usePickupPoints, useProduct, useProductGroup, useProductParameters, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShippingMethods, useShippingQuote, useShopInfo, useShopScripts, useShopSeo, useSubmitQuote, useSubmitReturn, useSubmitReview, useSubscriptions, useWishlist };
+export { type ActivePromotion, type AddToCartInput, type AnalyticsEventInput, type AuthTokens, BehioAnalyticsTracker, BehioApiError, BehioProvider, type BehioProviderProps, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CookieConsent, type CookieConsentInput, type CrossSellItem, CurrencySwitcher, type CurrencySwitcherProps, type CurrencySwitcherRenderProps, type CustomerAddress, type CustomerProfile, type EcommerceEventName, type EcommerceItem, type EcommercePayload, type Facet, type FacetRange, type FacetValue, type FacetsResponse, type FilterField, type FulfillmentStatus, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type Page, type PageDetail, type PaginatedResponse, type PaymentStatus, type PersonalOffer, type ProductDetail, type ProductLabel, type ProductListItem, type ProductParameter, type ProductParameterGroup, type ProductParametersResponse, type ProductPrice, type ProductReview, type ProductReviewsResponse, type ProductVariant, type ProductsQuery, type QuoteRequest, type RegisterInput, type ReturnRequest, type ShopInfo, type ShopSeo, type StorageAdapter, StorefrontScripts, type StorefrontScriptsProps, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCertificateVerificationOptions, type UseCourseCertificatesOptions, type UseCourseOptions, type UseCoursesOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFacetsOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseLessonCommentsOptions, type UseLessonNoteOptions, type UseLessonQuizOptions, type UseLessonTutorOptions, type UseLoyaltyOptions, type UseMenuOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UsePaymentMethodsOptions, type UsePersonalOffersOptions, type UseProductOptions, type UseProductParametersOptions, type UseProductsOptions, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingQuoteOptions, type UseShopInfoOptions, type UseShopScriptsOptions, type UseShopSeoOptions, type UseSubscriptionsOptions, type UseVisitorMessagesOptions, type VisitorMessage, type WishlistItem, cookieStorage, createMemoryStorage, detectStorage, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, localStorageAdapter, memoryStorage, revokeAnalyticsConsent, trackEcommerceEvent, useAddressAutocomplete, useAddresses, useAnalyticsEvents, useAuth, useBehio, useBehioClient, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCertificateVerification, useCheckout, useCookieConsent, useCourse, useCourseCertificates, useCourses, useCrossSell, useCurrency, useCustomer, useFacets, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLessonComments, useLessonNote, useLessonQuiz, useLessonTutor, useLookupReturnableOrder, useLoyalty, useMenu, useNewsletterSubscribe, useNewsletterUnsubscribe, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, usePaymentMethods, usePersonalOffers, usePickupPoints, useProduct, useProductGroup, useProductParameters, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShippingMethods, useShippingQuote, useShopInfo, useShopScripts, useShopSeo, useSubmitQuote, useSubmitReturn, useSubmitReview, useSubscriptions, useVisitorMessages, useWishlist };

package/dist/react.d.ts

@@ -85,6 +85,19 @@ interface BehioStorefrontConfig {
      * automatically from the incoming request headers.
      */
     visitorIp?: string | (() => string | null | undefined | Promise<string | null | undefined>);
+    /**
+     * Throw availability failures (429, 5xx, network, timeout) instead of
+     * returning them as `SdkResult.error`. Business outcomes (400, 401, 404,
+     * 409, …) keep the tuple shape either way.
+     *
+     * Why this exists: a storefront section that reads `result.data ?? []`
+     * silently renders an EMPTY catalog when the API is rate-limited or down,
+     * which looks exactly like a shop with no products. With this flag the
+     * failure surfaces as an exception, so SSR/ISR keeps the last good page and
+     * the visitor gets an error boundary instead of a lying page. Recommended
+     * `true` for every server-rendered catalog client.
+     */
+    throwOnAvailabilityError?: boolean;
     /** Request timeout in milliseconds. Default: 30000 (30s) */
     timeout?: number;
     /** Number of retries on network/5xx errors. Default: 1 */
@@ -2378,6 +2391,7 @@ declare class BehioStorefront {
     private rateLimitRemaining;
     private rateLimitReset;
     private visitorIp?;
+    private throwOnAvailabilityError;
     constructor(config: BehioStorefrontConfig);
     readonly catalog: CatalogModule;
     readonly auth: AuthModule;
@@ -2463,6 +2477,25 @@ declare class BehioStorefront {
         percent: number;
         expiresAt: number;
     }>>;
+    /**
+     * Visitor messages from merchant automations (storefront.event action).
+     * Consent-gated visitor id; each message carries a merchant-defined `name`
+     * and free-form `payload` the template reacts to (modal, banner, ...).
+     * Messages stay listed until acknowledged via `ackVisitorMessage`.
+     */
+    getVisitorMessages(visitorId: string): Promise<SdkResult<{
+        items: Array<{
+            id: string;
+            name: string;
+            payload: Record<string, unknown> | null;
+            createdAt: number;
+            expiresAt: number;
+        }>;
+    }>>;
+    /** Acknowledge a visitor message so it is not delivered again. */
+    ackVisitorMessage(messageId: string, visitorId: string): Promise<SdkResult<{
+        ok: boolean;
+    }>>;
     /** Get basic shop info */
     getShopInfo(): Promise<SdkResult<ShopInfo>>;
     /** Get SEO metadata for the shop homepage in the given locale (defaults to shop default). */
@@ -3733,6 +3766,60 @@ declare function usePersonalOffers(options?: UsePersonalOffersOptions): {
     claimError: Error | null;
 };
 
+/**
+ * One message from a merchant automation (storefront.event action). `name`
+ * and `payload` are merchant-defined in the automation builder; the template
+ * decides how to react (modal, banner, toast, anything).
+ */
+interface VisitorMessage {
+    id: string;
+    name: string;
+    payload: Record<string, unknown> | null;
+    /** Epoch ms. */
+    createdAt: number;
+    /** Epoch ms. */
+    expiresAt: number;
+}
+interface UseVisitorMessagesOptions {
+    /**
+     * Consent-gated analytics visitor id. When omitted the hook polls
+     * `client.getAnalyticsVisitorId()` until the tracker resolves consent.
+     */
+    visitorId?: string;
+    enabled?: boolean;
+    /** Poll interval in ms (default 30000). Set 0 to fetch only on mount/focus. */
+    pollMs?: number;
+    /**
+     * Called once per delivered message. Acknowledge with the returned `ack`
+     * (or call `ack(message.id)` yourself later) so the message is not shown
+     * again on the next page view.
+     */
+    onMessage?: (message: VisitorMessage) => void;
+    /**
+     * Also dispatch each delivered message as a `behio:visitor-message`
+     * CustomEvent on `window` (detail = the message). Lets merchants react
+     * with plain JS outside React. Default true.
+     */
+    dispatchDomEvents?: boolean;
+}
+/**
+ * Visitor messages channel: pull-based delivery of automation events to the
+ * storefront. Consent-gated - without an analytics visitor id the hook stays
+ * idle, so it is always safe to mount. Typical use: show a modal when an
+ * automation sends `storefront.event` with name "sleva-modal".
+ */
+declare function useVisitorMessages(options?: UseVisitorMessagesOptions): {
+    messages: VisitorMessage[];
+    isLoading: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        items: VisitorMessage[];
+    }>, Error>>;
+    /** Mark a message as shown; it will not be delivered again. */
+    ack: (messageId: string) => Promise<boolean>;
+    visitorId: string | null;
+};
+
 /** One Behio Analytics ingest event (mirrors the public analytics DTO). */
 interface AnalyticsEventInput {
     type: "pageview" | "ecommerce" | "custom";
@@ -4666,4 +4753,4 @@ declare function revokeAnalyticsConsent(client: BehioStorefront): Promise<SdkRes
     success: boolean;
 }>>;
 
-export { type ActivePromotion, type AddToCartInput, type AnalyticsEventInput, type AuthTokens, BehioAnalyticsTracker, BehioApiError, BehioProvider, type BehioProviderProps, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CookieConsent, type CookieConsentInput, type CrossSellItem, CurrencySwitcher, type CurrencySwitcherProps, type CurrencySwitcherRenderProps, type CustomerAddress, type CustomerProfile, type EcommerceEventName, type EcommerceItem, type EcommercePayload, type Facet, type FacetRange, type FacetValue, type FacetsResponse, type FilterField, type FulfillmentStatus, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type Page, type PageDetail, type PaginatedResponse, type PaymentStatus, type PersonalOffer, type ProductDetail, type ProductLabel, type ProductListItem, type ProductParameter, type ProductParameterGroup, type ProductParametersResponse, type ProductPrice, type ProductReview, type ProductReviewsResponse, type ProductVariant, type ProductsQuery, type QuoteRequest, type RegisterInput, type ReturnRequest, type ShopInfo, type ShopSeo, type StorageAdapter, StorefrontScripts, type StorefrontScriptsProps, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCertificateVerificationOptions, type UseCourseCertificatesOptions, type UseCourseOptions, type UseCoursesOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFacetsOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseLessonCommentsOptions, type UseLessonNoteOptions, type UseLessonQuizOptions, type UseLessonTutorOptions, type UseLoyaltyOptions, type UseMenuOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UsePaymentMethodsOptions, type UsePersonalOffersOptions, type UseProductOptions, type UseProductParametersOptions, type UseProductsOptions, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingQuoteOptions, type UseShopInfoOptions, type UseShopScriptsOptions, type UseShopSeoOptions, type UseSubscriptionsOptions, type WishlistItem, cookieStorage, createMemoryStorage, detectStorage, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, localStorageAdapter, memoryStorage, revokeAnalyticsConsent, trackEcommerceEvent, useAddressAutocomplete, useAddresses, useAnalyticsEvents, useAuth, useBehio, useBehioClient, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCertificateVerification, useCheckout, useCookieConsent, useCourse, useCourseCertificates, useCourses, useCrossSell, useCurrency, useCustomer, useFacets, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLessonComments, useLessonNote, useLessonQuiz, useLessonTutor, useLookupReturnableOrder, useLoyalty, useMenu, useNewsletterSubscribe, useNewsletterUnsubscribe, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, usePaymentMethods, usePersonalOffers, usePickupPoints, useProduct, useProductGroup, useProductParameters, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShippingMethods, useShippingQuote, useShopInfo, useShopScripts, useShopSeo, useSubmitQuote, useSubmitReturn, useSubmitReview, useSubscriptions, useWishlist };
+export { type ActivePromotion, type AddToCartInput, type AnalyticsEventInput, type AuthTokens, BehioAnalyticsTracker, BehioApiError, BehioProvider, type BehioProviderProps, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CookieConsent, type CookieConsentInput, type CrossSellItem, CurrencySwitcher, type CurrencySwitcherProps, type CurrencySwitcherRenderProps, type CustomerAddress, type CustomerProfile, type EcommerceEventName, type EcommerceItem, type EcommercePayload, type Facet, type FacetRange, type FacetValue, type FacetsResponse, type FilterField, type FulfillmentStatus, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type Page, type PageDetail, type PaginatedResponse, type PaymentStatus, type PersonalOffer, type ProductDetail, type ProductLabel, type ProductListItem, type ProductParameter, type ProductParameterGroup, type ProductParametersResponse, type ProductPrice, type ProductReview, type ProductReviewsResponse, type ProductVariant, type ProductsQuery, type QuoteRequest, type RegisterInput, type ReturnRequest, type ShopInfo, type ShopSeo, type StorageAdapter, StorefrontScripts, type StorefrontScriptsProps, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCertificateVerificationOptions, type UseCourseCertificatesOptions, type UseCourseOptions, type UseCoursesOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFacetsOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseLessonCommentsOptions, type UseLessonNoteOptions, type UseLessonQuizOptions, type UseLessonTutorOptions, type UseLoyaltyOptions, type UseMenuOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UsePaymentMethodsOptions, type UsePersonalOffersOptions, type UseProductOptions, type UseProductParametersOptions, type UseProductsOptions, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingQuoteOptions, type UseShopInfoOptions, type UseShopScriptsOptions, type UseShopSeoOptions, type UseSubscriptionsOptions, type UseVisitorMessagesOptions, type VisitorMessage, type WishlistItem, cookieStorage, createMemoryStorage, detectStorage, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, localStorageAdapter, memoryStorage, revokeAnalyticsConsent, trackEcommerceEvent, useAddressAutocomplete, useAddresses, useAnalyticsEvents, useAuth, useBehio, useBehioClient, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCertificateVerification, useCheckout, useCookieConsent, useCourse, useCourseCertificates, useCourses, useCrossSell, useCurrency, useCustomer, useFacets, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLessonComments, useLessonNote, useLessonQuiz, useLessonTutor, useLookupReturnableOrder, useLoyalty, useMenu, useNewsletterSubscribe, useNewsletterUnsubscribe, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, usePaymentMethods, usePersonalOffers, usePickupPoints, useProduct, useProductGroup, useProductParameters, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShippingMethods, useShippingQuote, useShopInfo, useShopScripts, useShopSeo, useSubmitQuote, useSubmitReturn, useSubmitReview, useSubscriptions, useVisitorMessages, useWishlist };