@behio/storefront-sdk 1.7.0 → 1.8.0

package/dist/{chunk-TOSF3K7J.mjs → chunk-LA6K4KYS.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);
@@ -374,6 +380,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 +410,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-TJ4TZ5FI.js → chunk-LQ4GGXMJ.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);
@@ -374,6 +380,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 +410,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-BP9n3a_D.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;

package/dist/{client-BSDdOEcK.d.ts → client-BP9n3a_D.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;

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-BP9n3a_D.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-BP9n3a_D.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-BP9n3a_D.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-BP9n3a_D.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 _chunkLQ4GGXMJjs = require('./chunk-LQ4GGXMJ.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 = _chunkLQ4GGXMJjs.AddressTypes; exports.BehioApiError = _chunkLQ4GGXMJjs.BehioApiError; exports.BehioNetworkError = _chunkLQ4GGXMJjs.BehioNetworkError; exports.BehioStorefront = _chunkLQ4GGXMJjs.BehioStorefront; exports.FulfillmentStatuses = _chunkLQ4GGXMJjs.FulfillmentStatuses; exports.OrderStatuses = _chunkLQ4GGXMJjs.OrderStatuses; exports.PaymentStatuses = _chunkLQ4GGXMJjs.PaymentStatuses; exports.ProductSort = _chunkLQ4GGXMJjs.ProductSort; exports.VARIANT_QUERY_PARAM = VARIANT_QUERY_PARAM; exports.availableAxisValues = availableAxisValues; exports.buildVariantComparison = buildVariantComparison; exports.err = _chunkLQ4GGXMJjs.err; exports.findVariantByAttributes = findVariantByAttributes; exports.formatPrice = formatPrice; exports.generateVisitorId = generateVisitorId; exports.getStoredVisitorId = getStoredVisitorId; exports.grantAnalyticsConsent = grantAnalyticsConsent; exports.ok = _chunkLQ4GGXMJjs.ok; exports.resolveVariantContent = resolveVariantContent; exports.revokeAnalyticsConsent = revokeAnalyticsConsent; exports.toSdkError = _chunkLQ4GGXMJjs.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-LA6K4KYS.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-BP9n3a_D.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-BP9n3a_D.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 _chunkLQ4GGXMJjs = require('./chunk-LQ4GGXMJ.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, _chunkLQ4GGXMJjs.BehioStorefront)({
     apiKey,
     ...baseUrl ? { baseUrl } : {},
     ...locale ? { locale } : {},

package/dist/next.mjs

@@ -1,6 +1,6 @@
 import {
   BehioStorefront
-} from "./chunk-TOSF3K7J.mjs";
+} from "./chunk-LA6K4KYS.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;

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;

package/dist/react.js

@@ -188,6 +188,11 @@ function toSdkError(err) {
 }
 
 // src/client.ts
+function isAvailabilityFailure(err) {
+  if (err instanceof BehioNetworkError) return true;
+  if (err instanceof BehioApiError) return err.isRetryable;
+  return false;
+}
 var BehioStorefront = class {
   constructor(config) {
     /** Consent-gated persistent visitor id — set by the analytics tracker. */
@@ -216,6 +221,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);
@@ -446,6 +452,9 @@ var BehioStorefront = class {
       const data = await this.rawRequest(method, path, options);
       return ok(data);
     } catch (err) {
+      if (this.throwOnAvailabilityError && isAvailabilityFailure(err)) {
+        throw err;
+      }
       return { data: null, error: toSdkError(err) };
     }
   }
@@ -473,6 +482,9 @@ var BehioStorefront = class {
       }
       return ok(await res.blob());
     } catch (err) {
+      if (this.throwOnAvailabilityError && isAvailabilityFailure(err)) {
+        throw err;
+      }
       return { data: null, error: toSdkError(err) };
     }
   }

package/dist/react.mjs

@@ -85,6 +85,11 @@ function toSdkError(err) {
 }
 
 // src/client.ts
+function isAvailabilityFailure(err) {
+  if (err instanceof BehioNetworkError) return true;
+  if (err instanceof BehioApiError) return err.isRetryable;
+  return false;
+}
 var BehioStorefront = class {
   constructor(config) {
     /** Consent-gated persistent visitor id — set by the analytics tracker. */
@@ -113,6 +118,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);
@@ -343,6 +349,9 @@ var BehioStorefront = class {
       const data = await this.rawRequest(method, path, options);
       return ok(data);
     } catch (err) {
+      if (this.throwOnAvailabilityError && isAvailabilityFailure(err)) {
+        throw err;
+      }
       return { data: null, error: toSdkError(err) };
     }
   }
@@ -370,6 +379,9 @@ var BehioStorefront = class {
       }
       return ok(await res.blob());
     } catch (err) {
+      if (this.throwOnAvailabilityError && isAvailabilityFailure(err)) {
+        throw err;
+      }
       return { data: null, error: toSdkError(err) };
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behio/storefront-sdk",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "TypeScript SDK for Behio Headless E-Shop — core client + React hooks",
   "author": "Behio",
   "license": "MIT",