@behio/storefront-sdk 2.4.0 → 2.5.1

package/README.md

@@ -252,6 +252,13 @@ A failed price entitlement lookup returns HTTP 503 with `be.storefront.pricingUn
 
 `catalog.getCategoryProducts(slug, query)` shares the full `ProductsQuery` serializer with `getProducts`. Price bounds retain zero, boolean filters retain false, arrays use repeated parameters and public parameter/facet selections use JSON. Category, main-list and featured availability follow the same published-variant and stock-mode rules in the backend.
 
+### One of a kind (2.5)
+
+`ProductListItem.isUnique` marks a handmade original: one piece, never
+restocked, never sold beyond stock. `soldAt` is set once it sells and the
+availability label reads "Sold". Hide quantity steppers, never offer
+back-in-stock watching for originals, offer "I want a similar one" instead.
+
 ### Cart links from Behio Chat (2.4)
 
 `cart.claimLink(token)` adds the products of a prepared cart link (created by

package/dist/{chunk-XVKKDVOO.js → chunk-AD2VKVVM.js}

@@ -1307,9 +1307,12 @@ var CartModule = class {
    * visitor; the storefront handles `/cart/link/<token>`, calls this on the
    * server (Server Action or route handler, so the session cookie can be
    * written) and redirects to checkout. Items are ADDED, never replacing the
-   * cart; opening the link twice does not double quantities. A discount code
+   * cart; repeated and concurrent claims raise each quantity to at least the
+   * link target, never add a previously calculated delta. A discount code
    * carried by the link is applied with the normal validation. An expired or
    * unknown link fails with `be.storefront.cartLinkExpired` (404).
+   * Other failures need retry, not an expiry notice. Check linkSkippedItems
+   * and linkDiscountCode/linkDiscountApplied before redirecting to checkout.
    */
   async claimLink(token) {
     const res = await this.client.request("POST", `/cart/links/${encodeURIComponent(token)}/claim`, {});

package/dist/{chunk-5WHX5QA4.mjs → chunk-L5QBTEJ4.mjs}

@@ -1307,9 +1307,12 @@ var CartModule = class {
    * visitor; the storefront handles `/cart/link/<token>`, calls this on the
    * server (Server Action or route handler, so the session cookie can be
    * written) and redirects to checkout. Items are ADDED, never replacing the
-   * cart; opening the link twice does not double quantities. A discount code
+   * cart; repeated and concurrent claims raise each quantity to at least the
+   * link target, never add a previously calculated delta. A discount code
    * carried by the link is applied with the normal validation. An expired or
    * unknown link fails with `be.storefront.cartLinkExpired` (404).
+   * Other failures need retry, not an expiry notice. Check linkSkippedItems
+   * and linkDiscountCode/linkDiscountApplied before redirecting to checkout.
    */
   async claimLink(token) {
     const res = await this.client.request("POST", `/cart/links/${encodeURIComponent(token)}/claim`, {});

package/dist/{client-udU7tGhi.d.mts → client-DEE8yg6v.d.mts}

@@ -572,6 +572,19 @@ interface ProductListItem {
      * never turn it on.
      */
     variantsOnly: boolean;
+    /**
+     * One of a kind (handmade original, SDK 2.5): exactly one piece exists and it
+     * is never restocked. While available, show it as a one-off (the server label
+     * already says so in `availability.label`) and hide the quantity stepper.
+     * Once sold, `soldAt` is set, `availability.label` reads "Sold" and the
+     * product is not purchasable: never offer back-in-stock watching (the server
+     * refuses it), offer "I want a similar one" instead. The merchant decides
+     * whether sold originals stay listed (N days, forever) or disappear at once;
+     * in the last case the product page returns 404.
+     */
+    isUnique: boolean;
+    /** When the one-of-a-kind piece sold (epoch ms); null while available. */
+    soldAt: number | null;
     /**
      * "From" price: the CHEAPEST variant price, in the requested currency, or
      * null when the product has no variants (or prices are gated behind login in
@@ -2860,6 +2873,7 @@ interface CartLinkClaimed extends Cart {
     linkSkippedItems: number;
     /** A discount code carried by the link was applied. */
     linkDiscountApplied: boolean;
+    /** Code carried by the link, including a refused code. Null means no code was offered. */
     linkDiscountCode: string | null;
 }
 
@@ -3366,9 +3380,12 @@ declare class CartModule {
      * visitor; the storefront handles `/cart/link/<token>`, calls this on the
      * server (Server Action or route handler, so the session cookie can be
      * written) and redirects to checkout. Items are ADDED, never replacing the
-     * cart; opening the link twice does not double quantities. A discount code
+     * cart; repeated and concurrent claims raise each quantity to at least the
+     * link target, never add a previously calculated delta. A discount code
      * carried by the link is applied with the normal validation. An expired or
      * unknown link fails with `be.storefront.cartLinkExpired` (404).
+     * Other failures need retry, not an expiry notice. Check linkSkippedItems
+     * and linkDiscountCode/linkDiscountApplied before redirecting to checkout.
      */
     claimLink(token: string): Promise<SdkResult<CartLinkClaimed>>;
     /** Remove discount code */

package/dist/{client-udU7tGhi.d.ts → client-DEE8yg6v.d.ts}

@@ -572,6 +572,19 @@ interface ProductListItem {
      * never turn it on.
      */
     variantsOnly: boolean;
+    /**
+     * One of a kind (handmade original, SDK 2.5): exactly one piece exists and it
+     * is never restocked. While available, show it as a one-off (the server label
+     * already says so in `availability.label`) and hide the quantity stepper.
+     * Once sold, `soldAt` is set, `availability.label` reads "Sold" and the
+     * product is not purchasable: never offer back-in-stock watching (the server
+     * refuses it), offer "I want a similar one" instead. The merchant decides
+     * whether sold originals stay listed (N days, forever) or disappear at once;
+     * in the last case the product page returns 404.
+     */
+    isUnique: boolean;
+    /** When the one-of-a-kind piece sold (epoch ms); null while available. */
+    soldAt: number | null;
     /**
      * "From" price: the CHEAPEST variant price, in the requested currency, or
      * null when the product has no variants (or prices are gated behind login in
@@ -2860,6 +2873,7 @@ interface CartLinkClaimed extends Cart {
     linkSkippedItems: number;
     /** A discount code carried by the link was applied. */
     linkDiscountApplied: boolean;
+    /** Code carried by the link, including a refused code. Null means no code was offered. */
     linkDiscountCode: string | null;
 }
 
@@ -3366,9 +3380,12 @@ declare class CartModule {
      * visitor; the storefront handles `/cart/link/<token>`, calls this on the
      * server (Server Action or route handler, so the session cookie can be
      * written) and redirects to checkout. Items are ADDED, never replacing the
-     * cart; opening the link twice does not double quantities. A discount code
+     * cart; repeated and concurrent claims raise each quantity to at least the
+     * link target, never add a previously calculated delta. A discount code
      * carried by the link is applied with the normal validation. An expired or
      * unknown link fails with `be.storefront.cartLinkExpired` (404).
+     * Other failures need retry, not an expiry notice. Check linkSkippedItems
+     * and linkDiscountCode/linkDiscountApplied before redirecting to checkout.
      */
     claimLink(token: string): Promise<SdkResult<CartLinkClaimed>>;
     /** Remove discount code */

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-udU7tGhi.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 CustomerProfile, ad as DigitalDownload, ae as DownloadUrl, af as Facet, ag as FacetAvailability, ah as FacetCategory, ai as FacetLabel, aj as FacetPriceRange, ak as FacetRange, al as FacetRatingBucket, am as FacetValue, an as FacetsResponse, ao as FilterField, ap as FulfillmentStatus, aq as FulfillmentStatuses, ar as GiftCardBalance, as as GiftCardPurchaseInput, at as GiftCardPurchaseResult, au as GiftCardSummary, av as LessonNote, aw as LessonQuiz, ax as LoginInput, ay as LoyaltyBalance, az as LoyaltyNextTier, aA as LoyaltyProgram, aB as LoyaltySummary, aC as LoyaltyTier, aD as LoyaltyTierPerks, aE as LoyaltyTransaction, aF as Menu, aG as MenuItem, aH as MenuItemRef, aI as MenuItemType, aJ as MessageResponse, aK as NewsletterOptInDefault, aL as NewsletterSubscribeInput, aM as NewsletterSubscribeResult, aN as NewsletterUnsubscribeResult, aO as OrderAccessRequestResponse, aP as OrderAccessVerifyResponse, aQ as OrderDetail, aR as OrderItem, aS as OrderListItem, aT as OrderStatus, aU as OrderStatusHistory, aV as OrderStatuses, aW as OrderTracking, aX as Page, aY as PageAttachment, aZ as PageDetail, a_ as PaginatedResponse, a$ as PaymentInstrument, b0 as PaymentStatus, b1 as PaymentStatuses, b2 as PaymentSwift, b3 as PickupPoint, b4 as PickupPointHours, b5 as PickupPointsInput, b6 as PickupWidgetConfig, b7 as PriceDisplay, b8 as ProductAssetGroup, b9 as ProductAssetItem, ba as ProductAvailability, bb as ProductGroup, bc as ProductLabel, bd as ProductListItem, be as ProductMedia, bf as ProductMediaVariant, bg as ProductParameter, bh as ProductParameterGroup, bi as ProductParametersResponse, bj as ProductPrice, bk as ProductPromotionSummary, bl as ProductReview, bm as ProductReviewsResponse, bn as ProductSibling, bo as ProductSort, bp as ProductSortValue, bq as ProductVolumePrice, br as ProductsQuery, bs as QuizAnswerInput, bt as QuizAnswerResult, bu as QuizQuestion, bv as QuizResult, bw as QuoteItem, bx as QuoteRequest, by as RegisterInput, bz as RegisterResult, bA as RequestInterceptor, bB as RequestInterceptorConfig, bC as ResponseInterceptor, bD as ResponseInterceptorData, bE as ReturnRequest, bF as ReturnRequestItem, bG as ReturnStatus, bH as ReturnStatusItem, bI as ReturnableOrder, bJ as ReturnableOrderItem, bK as SdkError, bL as ShippingMethodSummary, bM as ShippingQuote, bN as ShippingQuoteInput, bO as ShopAppearance, bP as ShopInfo, bQ as ShopScript, bR as ShopScriptPlacement, bS as ShopScriptType, bT as ShopScripts, bU as ShopSeo, bV as ShopSeoIdentity, bW as SiteFormField, bX as SiteFormFieldOption, bY as SiteFormFieldType, bZ as Sitemap, b_ as SitemapEntry, b$ as StockBehavior, c0 as StockMode, c1 as StorefrontForm, c2 as StorefrontFormFieldErrorCode, c3 as StorefrontFormFile, c4 as StorefrontFormSettings, c5 as StorefrontFormSubmitInput, c6 as StorefrontFormSubmitResult, c7 as StorefrontFormUpload, c8 as SubmitQuoteInput, c9 as SubmitReturnInput, ca as SubmitReviewInput, cb as Subscription, cc as SubscriptionAction, cd as SubscriptionFrequency, ce as SubscriptionItem, cf as SubscriptionStatus, cg as TaxBreakdownLine, ch as VariantAxis, ci as VariantAxisValue, cj as WishlistItem, ck as err, cl as ok, cm as publishCartSummary, cn as toSdkError } from './client-udU7tGhi.mjs';
+import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent, b as StorefrontFormFieldError } from './client-DEE8yg6v.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 CustomerProfile, ad as DigitalDownload, ae as DownloadUrl, af as Facet, ag as FacetAvailability, ah as FacetCategory, ai as FacetLabel, aj as FacetPriceRange, ak as FacetRange, al as FacetRatingBucket, am as FacetValue, an as FacetsResponse, ao as FilterField, ap as FulfillmentStatus, aq as FulfillmentStatuses, ar as GiftCardBalance, as as GiftCardPurchaseInput, at as GiftCardPurchaseResult, au as GiftCardSummary, av as LessonNote, aw as LessonQuiz, ax as LoginInput, ay as LoyaltyBalance, az as LoyaltyNextTier, aA as LoyaltyProgram, aB as LoyaltySummary, aC as LoyaltyTier, aD as LoyaltyTierPerks, aE as LoyaltyTransaction, aF as Menu, aG as MenuItem, aH as MenuItemRef, aI as MenuItemType, aJ as MessageResponse, aK as NewsletterOptInDefault, aL as NewsletterSubscribeInput, aM as NewsletterSubscribeResult, aN as NewsletterUnsubscribeResult, aO as OrderAccessRequestResponse, aP as OrderAccessVerifyResponse, aQ as OrderDetail, aR as OrderItem, aS as OrderListItem, aT as OrderStatus, aU as OrderStatusHistory, aV as OrderStatuses, aW as OrderTracking, aX as Page, aY as PageAttachment, aZ as PageDetail, a_ as PaginatedResponse, a$ as PaymentInstrument, b0 as PaymentStatus, b1 as PaymentStatuses, b2 as PaymentSwift, b3 as PickupPoint, b4 as PickupPointHours, b5 as PickupPointsInput, b6 as PickupWidgetConfig, b7 as PriceDisplay, b8 as ProductAssetGroup, b9 as ProductAssetItem, ba as ProductAvailability, bb as ProductGroup, bc as ProductLabel, bd as ProductListItem, be as ProductMedia, bf as ProductMediaVariant, bg as ProductParameter, bh as ProductParameterGroup, bi as ProductParametersResponse, bj as ProductPrice, bk as ProductPromotionSummary, bl as ProductReview, bm as ProductReviewsResponse, bn as ProductSibling, bo as ProductSort, bp as ProductSortValue, bq as ProductVolumePrice, br as ProductsQuery, bs as QuizAnswerInput, bt as QuizAnswerResult, bu as QuizQuestion, bv as QuizResult, bw as QuoteItem, bx as QuoteRequest, by as RegisterInput, bz as RegisterResult, bA as RequestInterceptor, bB as RequestInterceptorConfig, bC as ResponseInterceptor, bD as ResponseInterceptorData, bE as ReturnRequest, bF as ReturnRequestItem, bG as ReturnStatus, bH as ReturnStatusItem, bI as ReturnableOrder, bJ as ReturnableOrderItem, bK as SdkError, bL as ShippingMethodSummary, bM as ShippingQuote, bN as ShippingQuoteInput, bO as ShopAppearance, bP as ShopInfo, bQ as ShopScript, bR as ShopScriptPlacement, bS as ShopScriptType, bT as ShopScripts, bU as ShopSeo, bV as ShopSeoIdentity, bW as SiteFormField, bX as SiteFormFieldOption, bY as SiteFormFieldType, bZ as Sitemap, b_ as SitemapEntry, b$ as StockBehavior, c0 as StockMode, c1 as StorefrontForm, c2 as StorefrontFormFieldErrorCode, c3 as StorefrontFormFile, c4 as StorefrontFormSettings, c5 as StorefrontFormSubmitInput, c6 as StorefrontFormSubmitResult, c7 as StorefrontFormUpload, c8 as SubmitQuoteInput, c9 as SubmitReturnInput, ca as SubmitReviewInput, cb as Subscription, cc as SubscriptionAction, cd as SubscriptionFrequency, ce as SubscriptionItem, cf as SubscriptionStatus, cg as TaxBreakdownLine, ch as VariantAxis, ci as VariantAxisValue, cj as WishlistItem, ck as err, cl as ok, cm as publishCartSummary, cn as toSdkError } from './client-DEE8yg6v.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-udU7tGhi.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 CustomerProfile, ad as DigitalDownload, ae as DownloadUrl, af as Facet, ag as FacetAvailability, ah as FacetCategory, ai as FacetLabel, aj as FacetPriceRange, ak as FacetRange, al as FacetRatingBucket, am as FacetValue, an as FacetsResponse, ao as FilterField, ap as FulfillmentStatus, aq as FulfillmentStatuses, ar as GiftCardBalance, as as GiftCardPurchaseInput, at as GiftCardPurchaseResult, au as GiftCardSummary, av as LessonNote, aw as LessonQuiz, ax as LoginInput, ay as LoyaltyBalance, az as LoyaltyNextTier, aA as LoyaltyProgram, aB as LoyaltySummary, aC as LoyaltyTier, aD as LoyaltyTierPerks, aE as LoyaltyTransaction, aF as Menu, aG as MenuItem, aH as MenuItemRef, aI as MenuItemType, aJ as MessageResponse, aK as NewsletterOptInDefault, aL as NewsletterSubscribeInput, aM as NewsletterSubscribeResult, aN as NewsletterUnsubscribeResult, aO as OrderAccessRequestResponse, aP as OrderAccessVerifyResponse, aQ as OrderDetail, aR as OrderItem, aS as OrderListItem, aT as OrderStatus, aU as OrderStatusHistory, aV as OrderStatuses, aW as OrderTracking, aX as Page, aY as PageAttachment, aZ as PageDetail, a_ as PaginatedResponse, a$ as PaymentInstrument, b0 as PaymentStatus, b1 as PaymentStatuses, b2 as PaymentSwift, b3 as PickupPoint, b4 as PickupPointHours, b5 as PickupPointsInput, b6 as PickupWidgetConfig, b7 as PriceDisplay, b8 as ProductAssetGroup, b9 as ProductAssetItem, ba as ProductAvailability, bb as ProductGroup, bc as ProductLabel, bd as ProductListItem, be as ProductMedia, bf as ProductMediaVariant, bg as ProductParameter, bh as ProductParameterGroup, bi as ProductParametersResponse, bj as ProductPrice, bk as ProductPromotionSummary, bl as ProductReview, bm as ProductReviewsResponse, bn as ProductSibling, bo as ProductSort, bp as ProductSortValue, bq as ProductVolumePrice, br as ProductsQuery, bs as QuizAnswerInput, bt as QuizAnswerResult, bu as QuizQuestion, bv as QuizResult, bw as QuoteItem, bx as QuoteRequest, by as RegisterInput, bz as RegisterResult, bA as RequestInterceptor, bB as RequestInterceptorConfig, bC as ResponseInterceptor, bD as ResponseInterceptorData, bE as ReturnRequest, bF as ReturnRequestItem, bG as ReturnStatus, bH as ReturnStatusItem, bI as ReturnableOrder, bJ as ReturnableOrderItem, bK as SdkError, bL as ShippingMethodSummary, bM as ShippingQuote, bN as ShippingQuoteInput, bO as ShopAppearance, bP as ShopInfo, bQ as ShopScript, bR as ShopScriptPlacement, bS as ShopScriptType, bT as ShopScripts, bU as ShopSeo, bV as ShopSeoIdentity, bW as SiteFormField, bX as SiteFormFieldOption, bY as SiteFormFieldType, bZ as Sitemap, b_ as SitemapEntry, b$ as StockBehavior, c0 as StockMode, c1 as StorefrontForm, c2 as StorefrontFormFieldErrorCode, c3 as StorefrontFormFile, c4 as StorefrontFormSettings, c5 as StorefrontFormSubmitInput, c6 as StorefrontFormSubmitResult, c7 as StorefrontFormUpload, c8 as SubmitQuoteInput, c9 as SubmitReturnInput, ca as SubmitReviewInput, cb as Subscription, cc as SubscriptionAction, cd as SubscriptionFrequency, ce as SubscriptionItem, cf as SubscriptionStatus, cg as TaxBreakdownLine, ch as VariantAxis, ci as VariantAxisValue, cj as WishlistItem, ck as err, cl as ok, cm as publishCartSummary, cn as toSdkError } from './client-udU7tGhi.js';
+import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent, b as StorefrontFormFieldError } from './client-DEE8yg6v.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 CustomerProfile, ad as DigitalDownload, ae as DownloadUrl, af as Facet, ag as FacetAvailability, ah as FacetCategory, ai as FacetLabel, aj as FacetPriceRange, ak as FacetRange, al as FacetRatingBucket, am as FacetValue, an as FacetsResponse, ao as FilterField, ap as FulfillmentStatus, aq as FulfillmentStatuses, ar as GiftCardBalance, as as GiftCardPurchaseInput, at as GiftCardPurchaseResult, au as GiftCardSummary, av as LessonNote, aw as LessonQuiz, ax as LoginInput, ay as LoyaltyBalance, az as LoyaltyNextTier, aA as LoyaltyProgram, aB as LoyaltySummary, aC as LoyaltyTier, aD as LoyaltyTierPerks, aE as LoyaltyTransaction, aF as Menu, aG as MenuItem, aH as MenuItemRef, aI as MenuItemType, aJ as MessageResponse, aK as NewsletterOptInDefault, aL as NewsletterSubscribeInput, aM as NewsletterSubscribeResult, aN as NewsletterUnsubscribeResult, aO as OrderAccessRequestResponse, aP as OrderAccessVerifyResponse, aQ as OrderDetail, aR as OrderItem, aS as OrderListItem, aT as OrderStatus, aU as OrderStatusHistory, aV as OrderStatuses, aW as OrderTracking, aX as Page, aY as PageAttachment, aZ as PageDetail, a_ as PaginatedResponse, a$ as PaymentInstrument, b0 as PaymentStatus, b1 as PaymentStatuses, b2 as PaymentSwift, b3 as PickupPoint, b4 as PickupPointHours, b5 as PickupPointsInput, b6 as PickupWidgetConfig, b7 as PriceDisplay, b8 as ProductAssetGroup, b9 as ProductAssetItem, ba as ProductAvailability, bb as ProductGroup, bc as ProductLabel, bd as ProductListItem, be as ProductMedia, bf as ProductMediaVariant, bg as ProductParameter, bh as ProductParameterGroup, bi as ProductParametersResponse, bj as ProductPrice, bk as ProductPromotionSummary, bl as ProductReview, bm as ProductReviewsResponse, bn as ProductSibling, bo as ProductSort, bp as ProductSortValue, bq as ProductVolumePrice, br as ProductsQuery, bs as QuizAnswerInput, bt as QuizAnswerResult, bu as QuizQuestion, bv as QuizResult, bw as QuoteItem, bx as QuoteRequest, by as RegisterInput, bz as RegisterResult, bA as RequestInterceptor, bB as RequestInterceptorConfig, bC as ResponseInterceptor, bD as ResponseInterceptorData, bE as ReturnRequest, bF as ReturnRequestItem, bG as ReturnStatus, bH as ReturnStatusItem, bI as ReturnableOrder, bJ as ReturnableOrderItem, bK as SdkError, bL as ShippingMethodSummary, bM as ShippingQuote, bN as ShippingQuoteInput, bO as ShopAppearance, bP as ShopInfo, bQ as ShopScript, bR as ShopScriptPlacement, bS as ShopScriptType, bT as ShopScripts, bU as ShopSeo, bV as ShopSeoIdentity, bW as SiteFormField, bX as SiteFormFieldOption, bY as SiteFormFieldType, bZ as Sitemap, b_ as SitemapEntry, b$ as StockBehavior, c0 as StockMode, c1 as StorefrontForm, c2 as StorefrontFormFieldErrorCode, c3 as StorefrontFormFile, c4 as StorefrontFormSettings, c5 as StorefrontFormSubmitInput, c6 as StorefrontFormSubmitResult, c7 as StorefrontFormUpload, c8 as SubmitQuoteInput, c9 as SubmitReturnInput, ca as SubmitReviewInput, cb as Subscription, cc as SubscriptionAction, cd as SubscriptionFrequency, ce as SubscriptionItem, cf as SubscriptionStatus, cg as TaxBreakdownLine, ch as VariantAxis, ci as VariantAxisValue, cj as WishlistItem, ck as err, cl as ok, cm as publishCartSummary, cn as toSdkError } from './client-DEE8yg6v.js';
 
 /**
  * Format a price amount with currency using Intl.NumberFormat.

package/dist/index.js

@@ -11,7 +11,7 @@
 
 
 
-var _chunkXVKKDVOOjs = require('./chunk-XVKKDVOO.js');
+var _chunkAD2VKVVMjs = require('./chunk-AD2VKVVM.js');
 
 // src/react/utils/format-price.ts
 function formatPrice(amount, currency, locale, display) {
@@ -949,7 +949,7 @@ var GENERIC = {
   en: "Something went wrong, please try again."
 };
 function bodyOf(err2) {
-  const body = err2 instanceof _chunkXVKKDVOOjs.BehioApiError ? err2.body : err2 && typeof err2 === "object" && "body" in err2 ? err2.body : err2;
+  const body = err2 instanceof _chunkAD2VKVVMjs.BehioApiError ? err2.body : err2 && typeof err2 === "object" && "body" in err2 ? err2.body : err2;
   return body && typeof body === "object" ? body : null;
 }
 function errorCode(err2) {
@@ -1062,4 +1062,4 @@ function formFieldErrors(err2) {
 
 
 
-exports.AddressTypes = _chunkXVKKDVOOjs.AddressTypes; exports.BehioApiError = _chunkXVKKDVOOjs.BehioApiError; exports.BehioNetworkError = _chunkXVKKDVOOjs.BehioNetworkError; exports.BehioStorefront = _chunkXVKKDVOOjs.BehioStorefront; exports.FulfillmentStatuses = _chunkXVKKDVOOjs.FulfillmentStatuses; exports.OrderStatuses = _chunkXVKKDVOOjs.OrderStatuses; exports.PaymentStatuses = _chunkXVKKDVOOjs.PaymentStatuses; exports.ProductSort = _chunkXVKKDVOOjs.ProductSort; exports.VARIANT_QUERY_PARAM = VARIANT_QUERY_PARAM; exports.availableAxisValues = availableAxisValues; exports.buildVariantComparison = buildVariantComparison; exports.err = _chunkXVKKDVOOjs.err; exports.errorCode = errorCode; exports.errorMessage = errorMessage; exports.errorParams = errorParams; exports.findVariantByAttributes = findVariantByAttributes; exports.formFieldErrors = formFieldErrors; exports.formatPrice = formatPrice; exports.generateVisitorId = generateVisitorId; exports.getStoredVisitorId = getStoredVisitorId; exports.grantAnalyticsConsent = grantAnalyticsConsent; exports.ok = _chunkXVKKDVOOjs.ok; exports.publishCartSummary = _chunkXVKKDVOOjs.publishCartSummary; exports.resolveVariantContent = resolveVariantContent; exports.revokeAnalyticsConsent = revokeAnalyticsConsent; exports.toSdkError = _chunkXVKKDVOOjs.toSdkError; exports.trackEcommerceEvent = trackEcommerceEvent; exports.validationFieldMessages = validationFieldMessages; exports.variantFromQuery = variantFromQuery; exports.variantHref = variantHref;
+exports.AddressTypes = _chunkAD2VKVVMjs.AddressTypes; exports.BehioApiError = _chunkAD2VKVVMjs.BehioApiError; exports.BehioNetworkError = _chunkAD2VKVVMjs.BehioNetworkError; exports.BehioStorefront = _chunkAD2VKVVMjs.BehioStorefront; exports.FulfillmentStatuses = _chunkAD2VKVVMjs.FulfillmentStatuses; exports.OrderStatuses = _chunkAD2VKVVMjs.OrderStatuses; exports.PaymentStatuses = _chunkAD2VKVVMjs.PaymentStatuses; exports.ProductSort = _chunkAD2VKVVMjs.ProductSort; exports.VARIANT_QUERY_PARAM = VARIANT_QUERY_PARAM; exports.availableAxisValues = availableAxisValues; exports.buildVariantComparison = buildVariantComparison; exports.err = _chunkAD2VKVVMjs.err; exports.errorCode = errorCode; exports.errorMessage = errorMessage; exports.errorParams = errorParams; exports.findVariantByAttributes = findVariantByAttributes; exports.formFieldErrors = formFieldErrors; exports.formatPrice = formatPrice; exports.generateVisitorId = generateVisitorId; exports.getStoredVisitorId = getStoredVisitorId; exports.grantAnalyticsConsent = grantAnalyticsConsent; exports.ok = _chunkAD2VKVVMjs.ok; exports.publishCartSummary = _chunkAD2VKVVMjs.publishCartSummary; exports.resolveVariantContent = resolveVariantContent; exports.revokeAnalyticsConsent = revokeAnalyticsConsent; exports.toSdkError = _chunkAD2VKVVMjs.toSdkError; exports.trackEcommerceEvent = trackEcommerceEvent; exports.validationFieldMessages = validationFieldMessages; exports.variantFromQuery = variantFromQuery; exports.variantHref = variantHref;

package/dist/index.mjs

@@ -11,7 +11,7 @@ import {
   ok,
   publishCartSummary,
   toSdkError
-} from "./chunk-5WHX5QA4.mjs";
+} from "./chunk-L5QBTEJ4.mjs";
 
 // src/react/utils/format-price.ts
 function formatPrice(amount, currency, locale, display) {

package/dist/next.d.mts

@@ -1,4 +1,4 @@
-import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-udU7tGhi.mjs';
+import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-DEE8yg6v.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-udU7tGhi.js';
+import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-DEE8yg6v.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 _chunkXVKKDVOOjs = require('./chunk-XVKKDVOO.js');
+var _chunkAD2VKVVMjs = require('./chunk-AD2VKVVM.js');
 
 // src/next.ts
 var _headers = require('next/headers');
@@ -19,7 +19,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, _chunkXVKKDVOOjs.BehioStorefront)({
+  const client = new (0, _chunkAD2VKVVMjs.BehioStorefront)({
     apiKey,
     ...baseUrl ? { baseUrl } : {},
     ...locale ? { locale } : {},

package/dist/next.mjs

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

package/dist/react.d.mts

@@ -628,6 +628,19 @@ interface ProductListItem {
      * never turn it on.
      */
     variantsOnly: boolean;
+    /**
+     * One of a kind (handmade original, SDK 2.5): exactly one piece exists and it
+     * is never restocked. While available, show it as a one-off (the server label
+     * already says so in `availability.label`) and hide the quantity stepper.
+     * Once sold, `soldAt` is set, `availability.label` reads "Sold" and the
+     * product is not purchasable: never offer back-in-stock watching (the server
+     * refuses it), offer "I want a similar one" instead. The merchant decides
+     * whether sold originals stay listed (N days, forever) or disappear at once;
+     * in the last case the product page returns 404.
+     */
+    isUnique: boolean;
+    /** When the one-of-a-kind piece sold (epoch ms); null while available. */
+    soldAt: number | null;
     /**
      * "From" price: the CHEAPEST variant price, in the requested currency, or
      * null when the product has no variants (or prices are gated behind login in
@@ -2870,6 +2883,7 @@ interface CartLinkClaimed extends Cart {
     linkSkippedItems: number;
     /** A discount code carried by the link was applied. */
     linkDiscountApplied: boolean;
+    /** Code carried by the link, including a refused code. Null means no code was offered. */
     linkDiscountCode: string | null;
 }
 
@@ -3376,9 +3390,12 @@ declare class CartModule {
      * visitor; the storefront handles `/cart/link/<token>`, calls this on the
      * server (Server Action or route handler, so the session cookie can be
      * written) and redirects to checkout. Items are ADDED, never replacing the
-     * cart; opening the link twice does not double quantities. A discount code
+     * cart; repeated and concurrent claims raise each quantity to at least the
+     * link target, never add a previously calculated delta. A discount code
      * carried by the link is applied with the normal validation. An expired or
      * unknown link fails with `be.storefront.cartLinkExpired` (404).
+     * Other failures need retry, not an expiry notice. Check linkSkippedItems
+     * and linkDiscountCode/linkDiscountApplied before redirecting to checkout.
      */
     claimLink(token: string): Promise<SdkResult<CartLinkClaimed>>;
     /** Remove discount code */

package/dist/react.d.ts

@@ -628,6 +628,19 @@ interface ProductListItem {
      * never turn it on.
      */
     variantsOnly: boolean;
+    /**
+     * One of a kind (handmade original, SDK 2.5): exactly one piece exists and it
+     * is never restocked. While available, show it as a one-off (the server label
+     * already says so in `availability.label`) and hide the quantity stepper.
+     * Once sold, `soldAt` is set, `availability.label` reads "Sold" and the
+     * product is not purchasable: never offer back-in-stock watching (the server
+     * refuses it), offer "I want a similar one" instead. The merchant decides
+     * whether sold originals stay listed (N days, forever) or disappear at once;
+     * in the last case the product page returns 404.
+     */
+    isUnique: boolean;
+    /** When the one-of-a-kind piece sold (epoch ms); null while available. */
+    soldAt: number | null;
     /**
      * "From" price: the CHEAPEST variant price, in the requested currency, or
      * null when the product has no variants (or prices are gated behind login in
@@ -2870,6 +2883,7 @@ interface CartLinkClaimed extends Cart {
     linkSkippedItems: number;
     /** A discount code carried by the link was applied. */
     linkDiscountApplied: boolean;
+    /** Code carried by the link, including a refused code. Null means no code was offered. */
     linkDiscountCode: string | null;
 }
 
@@ -3376,9 +3390,12 @@ declare class CartModule {
      * visitor; the storefront handles `/cart/link/<token>`, calls this on the
      * server (Server Action or route handler, so the session cookie can be
      * written) and redirects to checkout. Items are ADDED, never replacing the
-     * cart; opening the link twice does not double quantities. A discount code
+     * cart; repeated and concurrent claims raise each quantity to at least the
+     * link target, never add a previously calculated delta. A discount code
      * carried by the link is applied with the normal validation. An expired or
      * unknown link fails with `be.storefront.cartLinkExpired` (404).
+     * Other failures need retry, not an expiry notice. Check linkSkippedItems
+     * and linkDiscountCode/linkDiscountApplied before redirecting to checkout.
      */
     claimLink(token: string): Promise<SdkResult<CartLinkClaimed>>;
     /** Remove discount code */

package/dist/react.js

@@ -1386,9 +1386,12 @@ var CartModule = class {
    * visitor; the storefront handles `/cart/link/<token>`, calls this on the
    * server (Server Action or route handler, so the session cookie can be
    * written) and redirects to checkout. Items are ADDED, never replacing the
-   * cart; opening the link twice does not double quantities. A discount code
+   * cart; repeated and concurrent claims raise each quantity to at least the
+   * link target, never add a previously calculated delta. A discount code
    * carried by the link is applied with the normal validation. An expired or
    * unknown link fails with `be.storefront.cartLinkExpired` (404).
+   * Other failures need retry, not an expiry notice. Check linkSkippedItems
+   * and linkDiscountCode/linkDiscountApplied before redirecting to checkout.
    */
   async claimLink(token) {
     const res = await this.client.request("POST", `/cart/links/${encodeURIComponent(token)}/claim`, {});

package/dist/react.mjs

@@ -1276,9 +1276,12 @@ var CartModule = class {
    * visitor; the storefront handles `/cart/link/<token>`, calls this on the
    * server (Server Action or route handler, so the session cookie can be
    * written) and redirects to checkout. Items are ADDED, never replacing the
-   * cart; opening the link twice does not double quantities. A discount code
+   * cart; repeated and concurrent claims raise each quantity to at least the
+   * link target, never add a previously calculated delta. A discount code
    * carried by the link is applied with the normal validation. An expired or
    * unknown link fails with `be.storefront.cartLinkExpired` (404).
+   * Other failures need retry, not an expiry notice. Check linkSkippedItems
+   * and linkDiscountCode/linkDiscountApplied before redirecting to checkout.
    */
   async claimLink(token) {
     const res = await this.client.request("POST", `/cart/links/${encodeURIComponent(token)}/claim`, {});

package/package.json

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