@behio/storefront-sdk 0.5.0 → 0.7.0

package/dist/{chunk-KRGDHGTY.js → chunk-DMTMGPUZ.js}

@@ -487,6 +487,14 @@ var CatalogModule = class {
     );
   }
   /** Active promotions applicable to a product (with countdown end time) */
+  /** Back-in-stock notification subscription for a sold-out product. */
+  async notifyWhenAvailable(productId, email) {
+    return this.client.request(
+      "POST",
+      `/catalog/products/${productId}/notify-when-available`,
+      { body: { email } }
+    );
+  }
   async getProductPromotions(productSlug) {
     return this.client.request("GET", `/catalog/products/${productSlug}/promotions`);
   }
@@ -494,6 +502,12 @@ var CatalogModule = class {
   async checkGiftCard(code) {
     return this.client.request("GET", `/catalog/gift-cards/${encodeURIComponent(code)}/check`);
   }
+  /** List configured payment methods (filtered by currency). */
+  async listPaymentMethods(opts) {
+    const query = {};
+    if (_optionalChain([opts, 'optionalAccess', _23 => _23.currency])) query.currency = opts.currency;
+    return this.client.request("GET", "/catalog/payment-methods", { query });
+  }
 };
 var AuthModule = class {
   constructor(client) {
@@ -732,7 +746,7 @@ var OrdersModule = class {
   /** List customer orders (requires auth) */
   async list(options) {
     return this.client.request("GET", "/orders", {
-      query: { page: _optionalChain([options, 'optionalAccess', _23 => _23.page]), limit: _optionalChain([options, 'optionalAccess', _24 => _24.limit]) }
+      query: { page: _optionalChain([options, 'optionalAccess', _24 => _24.page]), limit: _optionalChain([options, 'optionalAccess', _25 => _25.limit]) }
     });
   }
   /** Get order detail (requires auth) */
@@ -833,6 +847,16 @@ var ReturnsModule = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * Guest order lookup for the EU withdrawal form: order number + the email
+   * used on the order resolve to the order id and per-item returnable
+   * quantities. POST so the email never appears in a URL.
+   */
+  async lookupOrder(orderNumber, email) {
+    return this.client.request("POST", "/returns/lookup-order", {
+      body: { orderNumber, email }
+    });
+  }
   async submit(input) {
     return this.client.request("POST", "/returns", { body: input });
   }
@@ -848,7 +872,11 @@ var ConsentModule = class {
     return this.client.request("POST", "/consent", { body: input, auth: false });
   }
   async get(visitorId) {
-    return this.client.request("GET", `/consent/${visitorId}`, { auth: false });
+    const result = await this.client.request("GET", `/consent/${visitorId}`, { auth: false });
+    if (result.error && result.error.status === 404) {
+      return { data: null, error: null };
+    }
+    return result;
   }
   async revoke(visitorId) {
     return this.client.request("DELETE", `/consent/${visitorId}`, { auth: false });
@@ -864,8 +892,10 @@ var QuotesModule = class {
   async accept(quoteId, email) {
     return this.client.request("POST", `/quotes/${quoteId}/accept`, { body: { email } });
   }
-  async getStatus(quoteId) {
-    return this.client.request("GET", `/quotes/${quoteId}`);
+  /** Email is the ownership gate — quotes carry contact PII and negotiated
+   *  prices, so the id alone is never enough. POST keeps it out of URLs. */
+  async getStatus(quoteId, email) {
+    return this.client.request("POST", `/quotes/${quoteId}/status`, { body: { email } });
   }
 };
 var AddressModule = class {
@@ -898,10 +928,10 @@ var ShippingModule = class {
    */
   async listMethods(opts) {
     const query = {};
-    if (_optionalChain([opts, 'optionalAccess', _25 => _25.currency])) query.currency = opts.currency;
-    if (_optionalChain([opts, 'optionalAccess', _26 => _26.country])) query.country = opts.country;
-    if (_optionalChain([opts, 'optionalAccess', _27 => _27.cartTotal]) != null) query.cartTotal = String(opts.cartTotal);
-    if (_optionalChain([opts, 'optionalAccess', _28 => _28.cartWeightKg]) != null) query.cartWeightKg = String(opts.cartWeightKg);
+    if (_optionalChain([opts, 'optionalAccess', _26 => _26.currency])) query.currency = opts.currency;
+    if (_optionalChain([opts, 'optionalAccess', _27 => _27.country])) query.country = opts.country;
+    if (_optionalChain([opts, 'optionalAccess', _28 => _28.cartTotal]) != null) query.cartTotal = String(opts.cartTotal);
+    if (_optionalChain([opts, 'optionalAccess', _29 => _29.cartWeightKg]) != null) query.cartWeightKg = String(opts.cartWeightKg);
     return this.client.request(
       "GET",
       "/catalog/shipping-methods",

package/dist/{chunk-3GOQSB25.mjs → chunk-EZEZUV2B.mjs}

@@ -487,6 +487,14 @@ var CatalogModule = class {
     );
   }
   /** Active promotions applicable to a product (with countdown end time) */
+  /** Back-in-stock notification subscription for a sold-out product. */
+  async notifyWhenAvailable(productId, email) {
+    return this.client.request(
+      "POST",
+      `/catalog/products/${productId}/notify-when-available`,
+      { body: { email } }
+    );
+  }
   async getProductPromotions(productSlug) {
     return this.client.request("GET", `/catalog/products/${productSlug}/promotions`);
   }
@@ -494,6 +502,12 @@ var CatalogModule = class {
   async checkGiftCard(code) {
     return this.client.request("GET", `/catalog/gift-cards/${encodeURIComponent(code)}/check`);
   }
+  /** List configured payment methods (filtered by currency). */
+  async listPaymentMethods(opts) {
+    const query = {};
+    if (opts?.currency) query.currency = opts.currency;
+    return this.client.request("GET", "/catalog/payment-methods", { query });
+  }
 };
 var AuthModule = class {
   constructor(client) {
@@ -833,6 +847,16 @@ var ReturnsModule = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * Guest order lookup for the EU withdrawal form: order number + the email
+   * used on the order resolve to the order id and per-item returnable
+   * quantities. POST so the email never appears in a URL.
+   */
+  async lookupOrder(orderNumber, email) {
+    return this.client.request("POST", "/returns/lookup-order", {
+      body: { orderNumber, email }
+    });
+  }
   async submit(input) {
     return this.client.request("POST", "/returns", { body: input });
   }
@@ -848,7 +872,11 @@ var ConsentModule = class {
     return this.client.request("POST", "/consent", { body: input, auth: false });
   }
   async get(visitorId) {
-    return this.client.request("GET", `/consent/${visitorId}`, { auth: false });
+    const result = await this.client.request("GET", `/consent/${visitorId}`, { auth: false });
+    if (result.error && result.error.status === 404) {
+      return { data: null, error: null };
+    }
+    return result;
   }
   async revoke(visitorId) {
     return this.client.request("DELETE", `/consent/${visitorId}`, { auth: false });
@@ -864,8 +892,10 @@ var QuotesModule = class {
   async accept(quoteId, email) {
     return this.client.request("POST", `/quotes/${quoteId}/accept`, { body: { email } });
   }
-  async getStatus(quoteId) {
-    return this.client.request("GET", `/quotes/${quoteId}`);
+  /** Email is the ownership gate — quotes carry contact PII and negotiated
+   *  prices, so the id alone is never enough. POST keeps it out of URLs. */
+  async getStatus(quoteId, email) {
+    return this.client.request("POST", `/quotes/${quoteId}/status`, { body: { email } });
   }
 };
 var AddressModule = class {

package/dist/index.d.mts

@@ -140,13 +140,40 @@ interface ProductListItem {
     labels: ProductLabel[];
     isFeatured: boolean;
 }
+/** A single responsive derivative (size + format) of a media image. */
+interface ProductMediaVariant {
+    variant: 'thumb' | 'medium' | 'large' | 'xlarge';
+    format: 'jpeg' | 'webp' | 'avif';
+    url: string;
+    width: number;
+    height: number;
+}
+/**
+ * A product gallery entry (image or video), sourced from the inventory item
+ * so it is shared across every storefront listing the product. Images carry
+ * responsive `variants` (webp/avif/jpeg in three sizes) for fast LCP; pick
+ * the smallest format the client supports.
+ */
+interface ProductMedia {
+    id: string;
+    type: 'IMAGE' | 'VIDEO';
+    /** Original uploaded file URL. */
+    url: string;
+    alt?: string | null;
+    isCover: boolean;
+    order: number;
+    variants: ProductMediaVariant[];
+}
 interface ProductDetail extends ProductListItem {
     longDescription?: string;
+    /** @deprecated Legacy per-listing images. Prefer `media`. */
     images: Array<{
         url: string;
         alt?: string;
         order: number;
     }>;
+    /** Product gallery (images + videos) with responsive derivatives. */
+    media: ProductMedia[];
     categories: Array<{
         id: string;
         slug: string;
@@ -328,6 +355,20 @@ interface CheckoutInput {
     email: string;
     phone?: string;
     customerNote?: string;
+    /**
+     * Chosen shipping method. Required whenever the eshop has at least one
+     * enabled shipping method — the backend rejects the order without it.
+     * Prefer also sending `shippingQuoteId` from `shipping.quote()`; with only
+     * the method id the backend re-quotes the cart server-side.
+     */
+    shippingMethodId?: string;
+    /**
+     * Quote id from `shipping.quote()` — pins the exact server-computed price
+     * the customer saw. Expired quotes are re-quoted automatically; a consumed
+     * or foreign quote is rejected.
+     */
+    shippingQuoteId?: string;
+    paymentMethodId?: string;
 }
 type OrderStatus = (typeof OrderStatuses)[keyof typeof OrderStatuses];
 type PaymentStatus = (typeof PaymentStatuses)[keyof typeof PaymentStatuses];
@@ -372,6 +413,13 @@ interface OrderDetail extends OrderListItem {
     fulfillmentStatus: FulfillmentStatus;
     statusHistory: OrderStatusHistory[];
     trackingToken?: string;
+    /**
+     * For redirect payment gateways (GoPay, ...), the hosted URL the
+     * storefront must send the customer to in order to pay. Present only on
+     * the order returned by `checkout.createOrder()`. Null/absent for
+     * offline methods (bank transfer, COD) and zero-total orders.
+     */
+    paymentRedirectUrl?: string | null;
 }
 interface CustomerProfile {
     id: string;
@@ -532,11 +580,13 @@ interface ShippingMethodSummary {
     description: string | null;
     /** Internal routing id ("zaslat", "ppl_direct", "manual", …). Not for display. */
     provider: string;
+    /** "fixed" = price known upfront; "live_quote" = must call shipping.quote() with address. */
+    priceStrategy: "fixed" | "live_quote";
     currency: string | null;
-    /** Final customer-facing price. Equals `basePrice` unless free-shipping kicks in. */
-    price: number;
-    /** Per-currency base price from the merchant's config. */
-    basePrice: number;
+    /** Final customer-facing price. Null for live_quote methods (call quote() to resolve). */
+    price: number | null;
+    /** Per-currency base price from the merchant's config. Null for live_quote. */
+    basePrice: number | null;
     isFreeShipping: boolean;
     freeShippingThreshold: number | null;
     /** "address" | "pickup_point" | "in_store" | "digital". */
@@ -583,6 +633,10 @@ interface ShippingQuote extends ShippingMethodSummary {
     strategy: "fixed" | "live_quote";
     available: boolean;
     reason: string | null;
+    /** Server-generated quote ID. Null for fixed-price methods. Pass to checkout for tamper-proof pricing. */
+    quoteId: string | null;
+    /** Quote expiry (epoch ms). Null for fixed-price methods. */
+    expiresAt: number | null;
 }
 interface CrossSellItem {
     productId: string;
@@ -634,14 +688,24 @@ interface ProductReview {
     helpfulCount: number;
     unhelpfulCount: number;
     replyContent: string | null;
+    replyAt: number | null;
     createdAt: number;
 }
 interface ProductReviewsResponse {
-    items: ProductReview[];
+    reviews: ProductReview[];
+    total: number;
+    page: number;
+    limit: number;
     averageRating: number;
     reviewCount: number;
-    page: number;
-    totalPages: number;
+}
+/** Returned by `catalog.notifyWhenAvailable()` — back-in-stock subscription. */
+interface BackInStockSubscription {
+    id: string;
+    eshopId: string;
+    productId: string;
+    email: string;
+    createdAt: number;
 }
 interface SubmitReviewInput {
     productId: string;
@@ -652,18 +716,75 @@ interface SubmitReviewInput {
     authorEmail?: string;
     imageUrls?: string[];
 }
+interface ReturnableOrderItem {
+    orderItemId: string;
+    productName: string;
+    /** Quantity ordered */
+    quantity: number;
+    /** Units still returnable (ordered minus active return claims) */
+    returnableQuantity: number;
+}
+/**
+ * Result of the guest order lookup used by the EU withdrawal form:
+ * the customer enters their order number + email and gets back the
+ * internal ids needed to submit a return. No account required.
+ */
+interface ReturnableOrder {
+    orderId: string;
+    orderNumber: string;
+    status: string;
+    items: ReturnableOrderItem[];
+    createdAt: number;
+}
+interface ReturnRequestItem {
+    id: string;
+    orderItemId: string;
+    productName: string;
+    quantity: number;
+    reason: string | null;
+    imageUrls: string[];
+}
+/** Returned by `returns.submit()` — the acknowledged withdrawal request. */
 interface ReturnRequest {
     id: string;
+    eshopId: string;
     orderId: string;
+    /** REQUESTED | APPROVED | SHIPPED_BACK | RECEIVED | REFUNDED | REJECTED | CLOSED */
+    status: string;
+    reason: string;
+    customerNote: string | null;
+    items: ReturnRequestItem[];
+    createdAt: number;
+}
+interface ReturnStatusItem {
+    id: string;
+    productName: string;
+    quantity: number;
+    reason: string | null;
+}
+/** Returned by `returns.getStatus()` — the full public view of a return. */
+interface ReturnStatus {
+    id: string;
+    orderNumber: string;
+    /** REQUESTED | APPROVED | SHIPPED_BACK | RECEIVED | REFUNDED | REJECTED | CLOSED */
     status: string;
     reason: string;
     customerNote: string | null;
-    refundAmount: number | null;
     refundMethod: string | null;
+    refundAmount: number | null;
+    refundedAt: number | null;
+    returnTrackingNumber: string | null;
+    items: ReturnStatusItem[];
     createdAt: number;
+    updatedAt: number;
 }
 interface SubmitReturnInput {
     orderId: string;
+    /**
+     * Email used on the order. Required — it is the ownership gate for guest
+     * withdrawals; the backend rejects submissions whose email doesn't match.
+     */
+    email: string;
     reason: string;
     customerNote?: string;
     items: {
@@ -687,13 +808,24 @@ interface CookieConsentInput {
     marketing: boolean;
     preferences: boolean;
 }
+interface QuoteItem {
+    productId: string;
+    quantity: number;
+    requestedPrice: number | null;
+    quotedPrice: number | null;
+}
 interface QuoteRequest {
     id: string;
+    /** PENDING | QUOTED | ACCEPTED | REJECTED | EXPIRED */
     status: string;
     contactName: string;
     contactEmail: string;
     companyName: string | null;
     quotedTotal: number | null;
+    quotedCurrency: string | null;
+    quotedNote: string | null;
+    expiresAt: number | null;
+    items: QuoteItem[];
     createdAt: number;
 }
 interface SubmitQuoteInput {
@@ -849,11 +981,19 @@ declare class CatalogModule {
         crossSell: CrossSellItem[];
     }>>;
     /** Active promotions applicable to a product (with countdown end time) */
+    /** Back-in-stock notification subscription for a sold-out product. */
+    notifyWhenAvailable(productId: string, email: string): Promise<SdkResult<BackInStockSubscription>>;
     getProductPromotions(productSlug: string): Promise<SdkResult<{
         items: ActivePromotion[];
     }>>;
     /** Check a gift card code — returns validity and remaining balance */
     checkGiftCard(code: string): Promise<SdkResult<GiftCardBalance>>;
+    /** List configured payment methods (filtered by currency). */
+    listPaymentMethods(opts?: {
+        currency?: string;
+    }): Promise<SdkResult<{
+        items: CheckoutPaymentMethod[];
+    }>>;
 }
 declare class AuthModule {
     private client;
@@ -1008,8 +1148,14 @@ declare class ReviewsModule {
 declare class ReturnsModule {
     private client;
     constructor(client: BehioStorefront);
+    /**
+     * Guest order lookup for the EU withdrawal form: order number + the email
+     * used on the order resolve to the order id and per-item returnable
+     * quantities. POST so the email never appears in a URL.
+     */
+    lookupOrder(orderNumber: string, email: string): Promise<SdkResult<ReturnableOrder>>;
     submit(input: SubmitReturnInput): Promise<SdkResult<ReturnRequest>>;
-    getStatus(returnId: string, email: string): Promise<SdkResult<ReturnRequest>>;
+    getStatus(returnId: string, email: string): Promise<SdkResult<ReturnStatus>>;
 }
 declare class ConsentModule {
     private client;
@@ -1025,7 +1171,9 @@ declare class QuotesModule {
     constructor(client: BehioStorefront);
     submit(input: SubmitQuoteInput): Promise<SdkResult<QuoteRequest>>;
     accept(quoteId: string, email: string): Promise<SdkResult<QuoteRequest>>;
-    getStatus(quoteId: string): Promise<SdkResult<QuoteRequest>>;
+    /** Email is the ownership gate — quotes carry contact PII and negotiated
+     *  prices, so the id alone is never enough. POST keeps it out of URLs. */
+    getStatus(quoteId: string, email: string): Promise<SdkResult<QuoteRequest>>;
 }
 interface AddressSuggestion {
     placeId: string;
@@ -1099,4 +1247,4 @@ declare class ShippingModule {
     }>>;
 }
 
-export { type ActivePromotion, type AddToCartInput, type AddressDetail, type AddressSuggestion, type AddressType, AddressTypes, type AuthTokens, BehioApiError, type BehioErrorCode, type BehioEventHandler, type BehioEventType, BehioNetworkError, BehioStorefront, type BehioStorefrontConfig, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type CartItemProduct, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CheckoutPaymentMethod, type CookieConsent, type CookieConsentInput, type CrossSellItem, type CustomerAddress, type CustomerProfile, type DataGroupFieldType, type FilterField, type FulfillmentStatus, FulfillmentStatuses, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type OrderStatusHistory, OrderStatuses, type Page, type PageDetail, type PaginatedResponse, type PaymentStatus, PaymentStatuses, type ProductDetail, type ProductLabel, type ProductListItem, type ProductPrice, type ProductReview, type ProductReviewsResponse, ProductSort, type ProductSortValue, type ProductVariant, type ProductVolumePrice, type ProductsQuery, type QuoteRequest, type RegisterInput, type RequestInterceptor, type RequestInterceptorConfig, type ResponseInterceptor, type ResponseInterceptorData, type ReturnRequest, type SdkError, type SdkResult, type ShippingMethodSummary, type ShippingQuote, type ShippingQuoteInput, type ShopInfo, type ShopSeo, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type WishlistItem, err, ok, toSdkError };
+export { type ActivePromotion, type AddToCartInput, type AddressDetail, type AddressSuggestion, type AddressType, AddressTypes, type AuthTokens, type BackInStockSubscription, BehioApiError, type BehioErrorCode, type BehioEventHandler, type BehioEventType, BehioNetworkError, BehioStorefront, type BehioStorefrontConfig, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type CartItemProduct, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CheckoutPaymentMethod, type CookieConsent, type CookieConsentInput, type CrossSellItem, type CustomerAddress, type CustomerProfile, type DataGroupFieldType, type FilterField, type FulfillmentStatus, FulfillmentStatuses, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type OrderStatusHistory, OrderStatuses, type Page, type PageDetail, type PaginatedResponse, type PaymentStatus, PaymentStatuses, type ProductDetail, type ProductLabel, type ProductListItem, type ProductMedia, type ProductMediaVariant, type ProductPrice, type ProductReview, type ProductReviewsResponse, ProductSort, type ProductSortValue, type ProductVariant, type ProductVolumePrice, type ProductsQuery, type QuoteItem, type QuoteRequest, type RegisterInput, type RequestInterceptor, type RequestInterceptorConfig, type ResponseInterceptor, type ResponseInterceptorData, type ReturnRequest, type ReturnRequestItem, type ReturnStatus, type ReturnStatusItem, type ReturnableOrder, type ReturnableOrderItem, type SdkError, type SdkResult, type ShippingMethodSummary, type ShippingQuote, type ShippingQuoteInput, type ShopInfo, type ShopSeo, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type WishlistItem, err, ok, toSdkError };

package/dist/index.d.ts

@@ -140,13 +140,40 @@ interface ProductListItem {
     labels: ProductLabel[];
     isFeatured: boolean;
 }
+/** A single responsive derivative (size + format) of a media image. */
+interface ProductMediaVariant {
+    variant: 'thumb' | 'medium' | 'large' | 'xlarge';
+    format: 'jpeg' | 'webp' | 'avif';
+    url: string;
+    width: number;
+    height: number;
+}
+/**
+ * A product gallery entry (image or video), sourced from the inventory item
+ * so it is shared across every storefront listing the product. Images carry
+ * responsive `variants` (webp/avif/jpeg in three sizes) for fast LCP; pick
+ * the smallest format the client supports.
+ */
+interface ProductMedia {
+    id: string;
+    type: 'IMAGE' | 'VIDEO';
+    /** Original uploaded file URL. */
+    url: string;
+    alt?: string | null;
+    isCover: boolean;
+    order: number;
+    variants: ProductMediaVariant[];
+}
 interface ProductDetail extends ProductListItem {
     longDescription?: string;
+    /** @deprecated Legacy per-listing images. Prefer `media`. */
     images: Array<{
         url: string;
         alt?: string;
         order: number;
     }>;
+    /** Product gallery (images + videos) with responsive derivatives. */
+    media: ProductMedia[];
     categories: Array<{
         id: string;
         slug: string;
@@ -328,6 +355,20 @@ interface CheckoutInput {
     email: string;
     phone?: string;
     customerNote?: string;
+    /**
+     * Chosen shipping method. Required whenever the eshop has at least one
+     * enabled shipping method — the backend rejects the order without it.
+     * Prefer also sending `shippingQuoteId` from `shipping.quote()`; with only
+     * the method id the backend re-quotes the cart server-side.
+     */
+    shippingMethodId?: string;
+    /**
+     * Quote id from `shipping.quote()` — pins the exact server-computed price
+     * the customer saw. Expired quotes are re-quoted automatically; a consumed
+     * or foreign quote is rejected.
+     */
+    shippingQuoteId?: string;
+    paymentMethodId?: string;
 }
 type OrderStatus = (typeof OrderStatuses)[keyof typeof OrderStatuses];
 type PaymentStatus = (typeof PaymentStatuses)[keyof typeof PaymentStatuses];
@@ -372,6 +413,13 @@ interface OrderDetail extends OrderListItem {
     fulfillmentStatus: FulfillmentStatus;
     statusHistory: OrderStatusHistory[];
     trackingToken?: string;
+    /**
+     * For redirect payment gateways (GoPay, ...), the hosted URL the
+     * storefront must send the customer to in order to pay. Present only on
+     * the order returned by `checkout.createOrder()`. Null/absent for
+     * offline methods (bank transfer, COD) and zero-total orders.
+     */
+    paymentRedirectUrl?: string | null;
 }
 interface CustomerProfile {
     id: string;
@@ -532,11 +580,13 @@ interface ShippingMethodSummary {
     description: string | null;
     /** Internal routing id ("zaslat", "ppl_direct", "manual", …). Not for display. */
     provider: string;
+    /** "fixed" = price known upfront; "live_quote" = must call shipping.quote() with address. */
+    priceStrategy: "fixed" | "live_quote";
     currency: string | null;
-    /** Final customer-facing price. Equals `basePrice` unless free-shipping kicks in. */
-    price: number;
-    /** Per-currency base price from the merchant's config. */
-    basePrice: number;
+    /** Final customer-facing price. Null for live_quote methods (call quote() to resolve). */
+    price: number | null;
+    /** Per-currency base price from the merchant's config. Null for live_quote. */
+    basePrice: number | null;
     isFreeShipping: boolean;
     freeShippingThreshold: number | null;
     /** "address" | "pickup_point" | "in_store" | "digital". */
@@ -583,6 +633,10 @@ interface ShippingQuote extends ShippingMethodSummary {
     strategy: "fixed" | "live_quote";
     available: boolean;
     reason: string | null;
+    /** Server-generated quote ID. Null for fixed-price methods. Pass to checkout for tamper-proof pricing. */
+    quoteId: string | null;
+    /** Quote expiry (epoch ms). Null for fixed-price methods. */
+    expiresAt: number | null;
 }
 interface CrossSellItem {
     productId: string;
@@ -634,14 +688,24 @@ interface ProductReview {
     helpfulCount: number;
     unhelpfulCount: number;
     replyContent: string | null;
+    replyAt: number | null;
     createdAt: number;
 }
 interface ProductReviewsResponse {
-    items: ProductReview[];
+    reviews: ProductReview[];
+    total: number;
+    page: number;
+    limit: number;
     averageRating: number;
     reviewCount: number;
-    page: number;
-    totalPages: number;
+}
+/** Returned by `catalog.notifyWhenAvailable()` — back-in-stock subscription. */
+interface BackInStockSubscription {
+    id: string;
+    eshopId: string;
+    productId: string;
+    email: string;
+    createdAt: number;
 }
 interface SubmitReviewInput {
     productId: string;
@@ -652,18 +716,75 @@ interface SubmitReviewInput {
     authorEmail?: string;
     imageUrls?: string[];
 }
+interface ReturnableOrderItem {
+    orderItemId: string;
+    productName: string;
+    /** Quantity ordered */
+    quantity: number;
+    /** Units still returnable (ordered minus active return claims) */
+    returnableQuantity: number;
+}
+/**
+ * Result of the guest order lookup used by the EU withdrawal form:
+ * the customer enters their order number + email and gets back the
+ * internal ids needed to submit a return. No account required.
+ */
+interface ReturnableOrder {
+    orderId: string;
+    orderNumber: string;
+    status: string;
+    items: ReturnableOrderItem[];
+    createdAt: number;
+}
+interface ReturnRequestItem {
+    id: string;
+    orderItemId: string;
+    productName: string;
+    quantity: number;
+    reason: string | null;
+    imageUrls: string[];
+}
+/** Returned by `returns.submit()` — the acknowledged withdrawal request. */
 interface ReturnRequest {
     id: string;
+    eshopId: string;
     orderId: string;
+    /** REQUESTED | APPROVED | SHIPPED_BACK | RECEIVED | REFUNDED | REJECTED | CLOSED */
+    status: string;
+    reason: string;
+    customerNote: string | null;
+    items: ReturnRequestItem[];
+    createdAt: number;
+}
+interface ReturnStatusItem {
+    id: string;
+    productName: string;
+    quantity: number;
+    reason: string | null;
+}
+/** Returned by `returns.getStatus()` — the full public view of a return. */
+interface ReturnStatus {
+    id: string;
+    orderNumber: string;
+    /** REQUESTED | APPROVED | SHIPPED_BACK | RECEIVED | REFUNDED | REJECTED | CLOSED */
     status: string;
     reason: string;
     customerNote: string | null;
-    refundAmount: number | null;
     refundMethod: string | null;
+    refundAmount: number | null;
+    refundedAt: number | null;
+    returnTrackingNumber: string | null;
+    items: ReturnStatusItem[];
     createdAt: number;
+    updatedAt: number;
 }
 interface SubmitReturnInput {
     orderId: string;
+    /**
+     * Email used on the order. Required — it is the ownership gate for guest
+     * withdrawals; the backend rejects submissions whose email doesn't match.
+     */
+    email: string;
     reason: string;
     customerNote?: string;
     items: {
@@ -687,13 +808,24 @@ interface CookieConsentInput {
     marketing: boolean;
     preferences: boolean;
 }
+interface QuoteItem {
+    productId: string;
+    quantity: number;
+    requestedPrice: number | null;
+    quotedPrice: number | null;
+}
 interface QuoteRequest {
     id: string;
+    /** PENDING | QUOTED | ACCEPTED | REJECTED | EXPIRED */
     status: string;
     contactName: string;
     contactEmail: string;
     companyName: string | null;
     quotedTotal: number | null;
+    quotedCurrency: string | null;
+    quotedNote: string | null;
+    expiresAt: number | null;
+    items: QuoteItem[];
     createdAt: number;
 }
 interface SubmitQuoteInput {
@@ -849,11 +981,19 @@ declare class CatalogModule {
         crossSell: CrossSellItem[];
     }>>;
     /** Active promotions applicable to a product (with countdown end time) */
+    /** Back-in-stock notification subscription for a sold-out product. */
+    notifyWhenAvailable(productId: string, email: string): Promise<SdkResult<BackInStockSubscription>>;
     getProductPromotions(productSlug: string): Promise<SdkResult<{
         items: ActivePromotion[];
     }>>;
     /** Check a gift card code — returns validity and remaining balance */
     checkGiftCard(code: string): Promise<SdkResult<GiftCardBalance>>;
+    /** List configured payment methods (filtered by currency). */
+    listPaymentMethods(opts?: {
+        currency?: string;
+    }): Promise<SdkResult<{
+        items: CheckoutPaymentMethod[];
+    }>>;
 }
 declare class AuthModule {
     private client;
@@ -1008,8 +1148,14 @@ declare class ReviewsModule {
 declare class ReturnsModule {
     private client;
     constructor(client: BehioStorefront);
+    /**
+     * Guest order lookup for the EU withdrawal form: order number + the email
+     * used on the order resolve to the order id and per-item returnable
+     * quantities. POST so the email never appears in a URL.
+     */
+    lookupOrder(orderNumber: string, email: string): Promise<SdkResult<ReturnableOrder>>;
     submit(input: SubmitReturnInput): Promise<SdkResult<ReturnRequest>>;
-    getStatus(returnId: string, email: string): Promise<SdkResult<ReturnRequest>>;
+    getStatus(returnId: string, email: string): Promise<SdkResult<ReturnStatus>>;
 }
 declare class ConsentModule {
     private client;
@@ -1025,7 +1171,9 @@ declare class QuotesModule {
     constructor(client: BehioStorefront);
     submit(input: SubmitQuoteInput): Promise<SdkResult<QuoteRequest>>;
     accept(quoteId: string, email: string): Promise<SdkResult<QuoteRequest>>;
-    getStatus(quoteId: string): Promise<SdkResult<QuoteRequest>>;
+    /** Email is the ownership gate — quotes carry contact PII and negotiated
+     *  prices, so the id alone is never enough. POST keeps it out of URLs. */
+    getStatus(quoteId: string, email: string): Promise<SdkResult<QuoteRequest>>;
 }
 interface AddressSuggestion {
     placeId: string;
@@ -1099,4 +1247,4 @@ declare class ShippingModule {
     }>>;
 }
 
-export { type ActivePromotion, type AddToCartInput, type AddressDetail, type AddressSuggestion, type AddressType, AddressTypes, type AuthTokens, BehioApiError, type BehioErrorCode, type BehioEventHandler, type BehioEventType, BehioNetworkError, BehioStorefront, type BehioStorefrontConfig, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type CartItemProduct, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CheckoutPaymentMethod, type CookieConsent, type CookieConsentInput, type CrossSellItem, type CustomerAddress, type CustomerProfile, type DataGroupFieldType, type FilterField, type FulfillmentStatus, FulfillmentStatuses, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type OrderStatusHistory, OrderStatuses, type Page, type PageDetail, type PaginatedResponse, type PaymentStatus, PaymentStatuses, type ProductDetail, type ProductLabel, type ProductListItem, type ProductPrice, type ProductReview, type ProductReviewsResponse, ProductSort, type ProductSortValue, type ProductVariant, type ProductVolumePrice, type ProductsQuery, type QuoteRequest, type RegisterInput, type RequestInterceptor, type RequestInterceptorConfig, type ResponseInterceptor, type ResponseInterceptorData, type ReturnRequest, type SdkError, type SdkResult, type ShippingMethodSummary, type ShippingQuote, type ShippingQuoteInput, type ShopInfo, type ShopSeo, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type WishlistItem, err, ok, toSdkError };
+export { type ActivePromotion, type AddToCartInput, type AddressDetail, type AddressSuggestion, type AddressType, AddressTypes, type AuthTokens, type BackInStockSubscription, BehioApiError, type BehioErrorCode, type BehioEventHandler, type BehioEventType, BehioNetworkError, BehioStorefront, type BehioStorefrontConfig, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type CartItemProduct, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CheckoutPaymentMethod, type CookieConsent, type CookieConsentInput, type CrossSellItem, type CustomerAddress, type CustomerProfile, type DataGroupFieldType, type FilterField, type FulfillmentStatus, FulfillmentStatuses, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type OrderStatusHistory, OrderStatuses, type Page, type PageDetail, type PaginatedResponse, type PaymentStatus, PaymentStatuses, type ProductDetail, type ProductLabel, type ProductListItem, type ProductMedia, type ProductMediaVariant, type ProductPrice, type ProductReview, type ProductReviewsResponse, ProductSort, type ProductSortValue, type ProductVariant, type ProductVolumePrice, type ProductsQuery, type QuoteItem, type QuoteRequest, type RegisterInput, type RequestInterceptor, type RequestInterceptorConfig, type ResponseInterceptor, type ResponseInterceptorData, type ReturnRequest, type ReturnRequestItem, type ReturnStatus, type ReturnStatusItem, type ReturnableOrder, type ReturnableOrderItem, type SdkError, type SdkResult, type ShippingMethodSummary, type ShippingQuote, type ShippingQuoteInput, type ShopInfo, type ShopSeo, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type WishlistItem, err, ok, toSdkError };

package/dist/index.js

@@ -10,7 +10,7 @@
 
 
 
-var _chunkKRGDHGTYjs = require('./chunk-KRGDHGTY.js');
+var _chunkDMTMGPUZjs = require('./chunk-DMTMGPUZ.js');
 
 
 
@@ -23,4 +23,4 @@ var _chunkKRGDHGTYjs = require('./chunk-KRGDHGTY.js');
 
 
 
-exports.AddressTypes = _chunkKRGDHGTYjs.AddressTypes; exports.BehioApiError = _chunkKRGDHGTYjs.BehioApiError; exports.BehioNetworkError = _chunkKRGDHGTYjs.BehioNetworkError; exports.BehioStorefront = _chunkKRGDHGTYjs.BehioStorefront; exports.FulfillmentStatuses = _chunkKRGDHGTYjs.FulfillmentStatuses; exports.OrderStatuses = _chunkKRGDHGTYjs.OrderStatuses; exports.PaymentStatuses = _chunkKRGDHGTYjs.PaymentStatuses; exports.ProductSort = _chunkKRGDHGTYjs.ProductSort; exports.err = _chunkKRGDHGTYjs.err; exports.ok = _chunkKRGDHGTYjs.ok; exports.toSdkError = _chunkKRGDHGTYjs.toSdkError;
+exports.AddressTypes = _chunkDMTMGPUZjs.AddressTypes; exports.BehioApiError = _chunkDMTMGPUZjs.BehioApiError; exports.BehioNetworkError = _chunkDMTMGPUZjs.BehioNetworkError; exports.BehioStorefront = _chunkDMTMGPUZjs.BehioStorefront; exports.FulfillmentStatuses = _chunkDMTMGPUZjs.FulfillmentStatuses; exports.OrderStatuses = _chunkDMTMGPUZjs.OrderStatuses; exports.PaymentStatuses = _chunkDMTMGPUZjs.PaymentStatuses; exports.ProductSort = _chunkDMTMGPUZjs.ProductSort; exports.err = _chunkDMTMGPUZjs.err; exports.ok = _chunkDMTMGPUZjs.ok; exports.toSdkError = _chunkDMTMGPUZjs.toSdkError;

package/dist/index.mjs

@@ -10,7 +10,7 @@ import {
   err,
   ok,
   toSdkError
-} from "./chunk-3GOQSB25.mjs";
+} from "./chunk-EZEZUV2B.mjs";
 export {
   AddressTypes,
   BehioApiError,

package/dist/next.d.mts

@@ -0,0 +1,14 @@
+import { BehioStorefrontConfig, BehioStorefront } from './index.mjs';
+
+interface GetBehioOptions extends Partial<BehioStorefrontConfig> {
+    /** Override the cart session cookie name (default: "behio_cart_session"). */
+    cartCookieName?: string;
+}
+/**
+ * Returns a per-request bound BehioStorefront instance. Reads the cart
+ * session cookie on entry, writes new session tokens back to the cookie
+ * automatically. Safe to call from any Server Component or Server Action.
+ */
+declare function getBehio(options?: GetBehioOptions): Promise<BehioStorefront>;
+
+export { type GetBehioOptions, getBehio };

package/dist/next.d.ts

@@ -0,0 +1,14 @@
+import { BehioStorefrontConfig, BehioStorefront } from './index.js';
+
+interface GetBehioOptions extends Partial<BehioStorefrontConfig> {
+    /** Override the cart session cookie name (default: "behio_cart_session"). */
+    cartCookieName?: string;
+}
+/**
+ * Returns a per-request bound BehioStorefront instance. Reads the cart
+ * session cookie on entry, writes new session tokens back to the cookie
+ * automatically. Safe to call from any Server Component or Server Action.
+ */
+declare function getBehio(options?: GetBehioOptions): Promise<BehioStorefront>;
+
+export { type GetBehioOptions, getBehio };

package/dist/next.js

@@ -0,0 +1,57 @@
+"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 _chunkDMTMGPUZjs = require('./chunk-DMTMGPUZ.js');
+
+// src/next.ts
+var _headers = require('next/headers');
+var CART_COOKIE_NAME = "behio_cart_session";
+var CART_COOKIE_MAX_AGE = 60 * 60 * 24 * 30;
+async function getBehio(options = {}) {
+  const apiKey = _nullishCoalesce(options.apiKey, () => ( process.env.BEHIO_API_KEY));
+  if (!apiKey) {
+    throw new Error(
+      "[@behio/storefront-sdk/next] Missing API key. Set BEHIO_API_KEY env var or pass {apiKey} to getBehio()."
+    );
+  }
+  const baseUrl = _nullishCoalesce(options.baseUrl, () => ( process.env.BEHIO_API_URL));
+  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, _chunkDMTMGPUZjs.BehioStorefront)({
+    apiKey,
+    ...baseUrl ? { baseUrl } : {},
+    ...locale ? { locale } : {},
+    ...currency ? { currency } : {},
+    ...options
+  });
+  const cookieStore = await _headers.cookies.call(void 0, );
+  const existing = _optionalChain([cookieStore, 'access', _ => _.get, 'call', _2 => _2(cookieName), 'optionalAccess', _3 => _3.value]);
+  if (existing) {
+    client.setCartSession(existing);
+  }
+  const originalSet = client.setCartSession.bind(client);
+  const originalClear = client.clearCartSession.bind(client);
+  client.setCartSession = (token) => {
+    originalSet(token);
+    try {
+      cookieStore.set(cookieName, token, {
+        httpOnly: true,
+        sameSite: "lax",
+        path: "/",
+        maxAge: CART_COOKIE_MAX_AGE
+      });
+    } catch (e) {
+    }
+  };
+  client.clearCartSession = () => {
+    originalClear();
+    try {
+      cookieStore.delete(cookieName);
+    } catch (e2) {
+    }
+  };
+  return client;
+}
+
+
+exports.getBehio = getBehio;

package/dist/next.mjs

@@ -0,0 +1,57 @@
+import {
+  BehioStorefront
+} from "./chunk-EZEZUV2B.mjs";
+
+// src/next.ts
+import { cookies } from "next/headers";
+var CART_COOKIE_NAME = "behio_cart_session";
+var CART_COOKIE_MAX_AGE = 60 * 60 * 24 * 30;
+async function getBehio(options = {}) {
+  const apiKey = options.apiKey ?? process.env.BEHIO_API_KEY;
+  if (!apiKey) {
+    throw new Error(
+      "[@behio/storefront-sdk/next] Missing API key. Set BEHIO_API_KEY env var or pass {apiKey} to getBehio()."
+    );
+  }
+  const baseUrl = options.baseUrl ?? process.env.BEHIO_API_URL;
+  const locale = options.locale ?? process.env.BEHIO_LOCALE;
+  const currency = options.currency ?? process.env.BEHIO_CURRENCY;
+  const cookieName = options.cartCookieName ?? CART_COOKIE_NAME;
+  const client = new BehioStorefront({
+    apiKey,
+    ...baseUrl ? { baseUrl } : {},
+    ...locale ? { locale } : {},
+    ...currency ? { currency } : {},
+    ...options
+  });
+  const cookieStore = await cookies();
+  const existing = cookieStore.get(cookieName)?.value;
+  if (existing) {
+    client.setCartSession(existing);
+  }
+  const originalSet = client.setCartSession.bind(client);
+  const originalClear = client.clearCartSession.bind(client);
+  client.setCartSession = (token) => {
+    originalSet(token);
+    try {
+      cookieStore.set(cookieName, token, {
+        httpOnly: true,
+        sameSite: "lax",
+        path: "/",
+        maxAge: CART_COOKIE_MAX_AGE
+      });
+    } catch {
+    }
+  };
+  client.clearCartSession = () => {
+    originalClear();
+    try {
+      cookieStore.delete(cookieName);
+    } catch {
+    }
+  };
+  return client;
+}
+export {
+  getBehio
+};

package/dist/react.d.mts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
-import { BehioStorefront, ProductsQuery, PaginatedResponse, ProductListItem, ProductDetail, Category, CategoryDetail, ProductLabel, FilterField, Cart, CustomerProfile, RegisterInput, CustomerAddress, AddressSuggestion, AddressDetail, OrderListItem, OrderDetail, CheckoutInput, PageDetail, Page, ShopInfo, ShopSeo, Bundle, CrossSellItem, ActivePromotion, GiftCardBalance, WishlistItem, ProductReviewsResponse, SubmitReviewInput, ReturnRequest, SubmitReturnInput, CookieConsent, CookieConsentInput, QuoteRequest, SubmitQuoteInput } from './index.mjs';
+import { BehioStorefront, ProductsQuery, PaginatedResponse, ProductListItem, ProductDetail, Category, CategoryDetail, ProductLabel, FilterField, Cart, CustomerProfile, RegisterInput, CustomerAddress, AddressSuggestion, AddressDetail, OrderListItem, OrderDetail, CheckoutInput, PageDetail, Page, ShopInfo, ShopSeo, Bundle, CrossSellItem, ActivePromotion, GiftCardBalance, WishlistItem, ProductReviewsResponse, SubmitReviewInput, ReturnableOrder, ReturnStatus, ReturnRequest, SubmitReturnInput, CookieConsent, CookieConsentInput, QuoteRequest, SubmitQuoteInput, BackInStockSubscription } from './index.mjs';
 export { AddToCartInput, AuthTokens, BehioApiError, BundleItem, CartDiscount, CartItem, CheckoutAddress, FulfillmentStatus, LoginInput, MessageResponse, OrderItem, OrderStatus, PaymentStatus, ProductPrice, ProductReview, ProductVariant } from './index.mjs';
 import * as _tanstack_query_core from '@tanstack/query-core';
 
@@ -639,8 +639,13 @@ declare function useSubmitReview(): _tanstack_react_query.UseMutationResult<{
     id: string;
 }, Error, SubmitReviewInput, unknown>;
 
+/** Guest order lookup for the EU withdrawal form (order number + order email). */
+declare function useLookupReturnableOrder(): _tanstack_react_query.UseMutationResult<ReturnableOrder, Error, {
+    orderNumber: string;
+    email: string;
+}, unknown>;
 declare function useSubmitReturn(): _tanstack_react_query.UseMutationResult<ReturnRequest, Error, SubmitReturnInput, unknown>;
-declare function useReturnStatus(returnId: string | undefined, email: string | undefined): _tanstack_react_query.UseQueryResult<ReturnRequest, Error>;
+declare function useReturnStatus(returnId: string | undefined, email: string | undefined): _tanstack_react_query.UseQueryResult<ReturnStatus, Error>;
 
 declare function useCookieConsent(visitorId: string | undefined): {
     record: _tanstack_react_query.UseMutateAsyncFunction<CookieConsent, Error, CookieConsentInput, unknown>;
@@ -831,7 +836,13 @@ declare function useCookieConsent(visitorId: string | undefined): {
 };
 
 declare function useSubmitQuote(): _tanstack_react_query.UseMutationResult<QuoteRequest, Error, SubmitQuoteInput, unknown>;
-declare function useQuoteStatus(quoteId: string | undefined): _tanstack_react_query.UseQueryResult<QuoteRequest, Error>;
+declare function useQuoteStatus(quoteId: string | undefined, email: string | undefined): _tanstack_react_query.UseQueryResult<QuoteRequest, Error>;
+
+/** Subscribe an email to a back-in-stock notification for a product. */
+declare function useNotifyWhenAvailable(): _tanstack_react_query.UseMutationResult<BackInStockSubscription, Error, {
+    productId: string;
+    email: string;
+}, unknown>;
 
 /**
  * Returns the raw BehioStorefront client instance.
@@ -851,4 +862,4 @@ declare function useBehioClient(): BehioStorefront;
  */
 declare function formatPrice(amount: number, currency: string, locale?: string): string;
 
-export { ActivePromotion, BehioProvider, type BehioProviderProps, Bundle, Cart, Category, CategoryDetail, CheckoutInput, CookieConsent, CookieConsentInput, CrossSellItem, CustomerAddress, CustomerProfile, FilterField, GiftCardBalance, OrderDetail, OrderListItem, Page, PageDetail, PaginatedResponse, ProductDetail, ProductLabel, ProductListItem, ProductReviewsResponse, ProductsQuery, QuoteRequest, RegisterInput, ReturnRequest, ShopInfo, ShopSeo, type StorageAdapter, SubmitQuoteInput, SubmitReturnInput, SubmitReviewInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCustomerOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UseProductOptions, type UseProductsOptions, type UseSearchOptions, type UseShopInfoOptions, type UseShopSeoOptions, WishlistItem, cookieStorage, createMemoryStorage, detectStorage, formatPrice, localStorageAdapter, memoryStorage, useAddressAutocomplete, useAddresses, useAuth, useBehio, useBehioClient, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCheckout, useCookieConsent, useCrossSell, useCustomer, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useOrder, useOrders, usePage, usePages, useProduct, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShopInfo, useShopSeo, useSubmitQuote, useSubmitReturn, useSubmitReview, useWishlist };
+export { ActivePromotion, BehioProvider, type BehioProviderProps, Bundle, Cart, Category, CategoryDetail, CheckoutInput, CookieConsent, CookieConsentInput, CrossSellItem, CustomerAddress, CustomerProfile, FilterField, GiftCardBalance, OrderDetail, OrderListItem, Page, PageDetail, PaginatedResponse, ProductDetail, ProductLabel, ProductListItem, ProductReviewsResponse, ProductsQuery, QuoteRequest, RegisterInput, ReturnRequest, ShopInfo, ShopSeo, type StorageAdapter, SubmitQuoteInput, SubmitReturnInput, SubmitReviewInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCustomerOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UseProductOptions, type UseProductsOptions, type UseSearchOptions, type UseShopInfoOptions, type UseShopSeoOptions, WishlistItem, cookieStorage, createMemoryStorage, detectStorage, formatPrice, localStorageAdapter, memoryStorage, useAddressAutocomplete, useAddresses, useAuth, useBehio, useBehioClient, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCheckout, useCookieConsent, useCrossSell, useCustomer, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLookupReturnableOrder, useNotifyWhenAvailable, useOrder, useOrders, usePage, usePages, useProduct, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShopInfo, useShopSeo, useSubmitQuote, useSubmitReturn, useSubmitReview, useWishlist };

package/dist/react.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
-import { BehioStorefront, ProductsQuery, PaginatedResponse, ProductListItem, ProductDetail, Category, CategoryDetail, ProductLabel, FilterField, Cart, CustomerProfile, RegisterInput, CustomerAddress, AddressSuggestion, AddressDetail, OrderListItem, OrderDetail, CheckoutInput, PageDetail, Page, ShopInfo, ShopSeo, Bundle, CrossSellItem, ActivePromotion, GiftCardBalance, WishlistItem, ProductReviewsResponse, SubmitReviewInput, ReturnRequest, SubmitReturnInput, CookieConsent, CookieConsentInput, QuoteRequest, SubmitQuoteInput } from './index.js';
+import { BehioStorefront, ProductsQuery, PaginatedResponse, ProductListItem, ProductDetail, Category, CategoryDetail, ProductLabel, FilterField, Cart, CustomerProfile, RegisterInput, CustomerAddress, AddressSuggestion, AddressDetail, OrderListItem, OrderDetail, CheckoutInput, PageDetail, Page, ShopInfo, ShopSeo, Bundle, CrossSellItem, ActivePromotion, GiftCardBalance, WishlistItem, ProductReviewsResponse, SubmitReviewInput, ReturnableOrder, ReturnStatus, ReturnRequest, SubmitReturnInput, CookieConsent, CookieConsentInput, QuoteRequest, SubmitQuoteInput, BackInStockSubscription } from './index.js';
 export { AddToCartInput, AuthTokens, BehioApiError, BundleItem, CartDiscount, CartItem, CheckoutAddress, FulfillmentStatus, LoginInput, MessageResponse, OrderItem, OrderStatus, PaymentStatus, ProductPrice, ProductReview, ProductVariant } from './index.js';
 import * as _tanstack_query_core from '@tanstack/query-core';
 
@@ -639,8 +639,13 @@ declare function useSubmitReview(): _tanstack_react_query.UseMutationResult<{
     id: string;
 }, Error, SubmitReviewInput, unknown>;
 
+/** Guest order lookup for the EU withdrawal form (order number + order email). */
+declare function useLookupReturnableOrder(): _tanstack_react_query.UseMutationResult<ReturnableOrder, Error, {
+    orderNumber: string;
+    email: string;
+}, unknown>;
 declare function useSubmitReturn(): _tanstack_react_query.UseMutationResult<ReturnRequest, Error, SubmitReturnInput, unknown>;
-declare function useReturnStatus(returnId: string | undefined, email: string | undefined): _tanstack_react_query.UseQueryResult<ReturnRequest, Error>;
+declare function useReturnStatus(returnId: string | undefined, email: string | undefined): _tanstack_react_query.UseQueryResult<ReturnStatus, Error>;
 
 declare function useCookieConsent(visitorId: string | undefined): {
     record: _tanstack_react_query.UseMutateAsyncFunction<CookieConsent, Error, CookieConsentInput, unknown>;
@@ -831,7 +836,13 @@ declare function useCookieConsent(visitorId: string | undefined): {
 };
 
 declare function useSubmitQuote(): _tanstack_react_query.UseMutationResult<QuoteRequest, Error, SubmitQuoteInput, unknown>;
-declare function useQuoteStatus(quoteId: string | undefined): _tanstack_react_query.UseQueryResult<QuoteRequest, Error>;
+declare function useQuoteStatus(quoteId: string | undefined, email: string | undefined): _tanstack_react_query.UseQueryResult<QuoteRequest, Error>;
+
+/** Subscribe an email to a back-in-stock notification for a product. */
+declare function useNotifyWhenAvailable(): _tanstack_react_query.UseMutationResult<BackInStockSubscription, Error, {
+    productId: string;
+    email: string;
+}, unknown>;
 
 /**
  * Returns the raw BehioStorefront client instance.
@@ -851,4 +862,4 @@ declare function useBehioClient(): BehioStorefront;
  */
 declare function formatPrice(amount: number, currency: string, locale?: string): string;
 
-export { ActivePromotion, BehioProvider, type BehioProviderProps, Bundle, Cart, Category, CategoryDetail, CheckoutInput, CookieConsent, CookieConsentInput, CrossSellItem, CustomerAddress, CustomerProfile, FilterField, GiftCardBalance, OrderDetail, OrderListItem, Page, PageDetail, PaginatedResponse, ProductDetail, ProductLabel, ProductListItem, ProductReviewsResponse, ProductsQuery, QuoteRequest, RegisterInput, ReturnRequest, ShopInfo, ShopSeo, type StorageAdapter, SubmitQuoteInput, SubmitReturnInput, SubmitReviewInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCustomerOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UseProductOptions, type UseProductsOptions, type UseSearchOptions, type UseShopInfoOptions, type UseShopSeoOptions, WishlistItem, cookieStorage, createMemoryStorage, detectStorage, formatPrice, localStorageAdapter, memoryStorage, useAddressAutocomplete, useAddresses, useAuth, useBehio, useBehioClient, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCheckout, useCookieConsent, useCrossSell, useCustomer, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useOrder, useOrders, usePage, usePages, useProduct, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShopInfo, useShopSeo, useSubmitQuote, useSubmitReturn, useSubmitReview, useWishlist };
+export { ActivePromotion, BehioProvider, type BehioProviderProps, Bundle, Cart, Category, CategoryDetail, CheckoutInput, CookieConsent, CookieConsentInput, CrossSellItem, CustomerAddress, CustomerProfile, FilterField, GiftCardBalance, OrderDetail, OrderListItem, Page, PageDetail, PaginatedResponse, ProductDetail, ProductLabel, ProductListItem, ProductReviewsResponse, ProductsQuery, QuoteRequest, RegisterInput, ReturnRequest, ShopInfo, ShopSeo, type StorageAdapter, SubmitQuoteInput, SubmitReturnInput, SubmitReviewInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCustomerOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UseProductOptions, type UseProductsOptions, type UseSearchOptions, type UseShopInfoOptions, type UseShopSeoOptions, WishlistItem, cookieStorage, createMemoryStorage, detectStorage, formatPrice, localStorageAdapter, memoryStorage, useAddressAutocomplete, useAddresses, useAuth, useBehio, useBehioClient, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCheckout, useCookieConsent, useCrossSell, useCustomer, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLookupReturnableOrder, useNotifyWhenAvailable, useOrder, useOrders, usePage, usePages, useProduct, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShopInfo, useShopSeo, useSubmitQuote, useSubmitReturn, useSubmitReview, useWishlist };

package/dist/react.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 _chunkKRGDHGTYjs = require('./chunk-KRGDHGTY.js');
+var _chunkDMTMGPUZjs = require('./chunk-DMTMGPUZ.js');
 
 // src/react/provider.tsx
 var _react = require('react');
@@ -114,7 +114,7 @@ function BehioProvider({
   const storageAdapter = _react.useMemo.call(void 0, () => resolveStorage(storageOption), [storageOption]);
   const clientRef = _react.useRef.call(void 0, null);
   if (!clientRef.current) {
-    clientRef.current = new (0, _chunkKRGDHGTYjs.BehioStorefront)({
+    clientRef.current = new (0, _chunkDMTMGPUZjs.BehioStorefront)({
       apiKey,
       baseUrl,
       locale,
@@ -1078,6 +1078,12 @@ function useSubmitReview() {
 
 // src/react/hooks/use-returns.ts
 
+function useLookupReturnableOrder() {
+  const { client } = useBehio();
+  return _reactquery.useMutation.call(void 0, {
+    mutationFn: ({ orderNumber, email }) => unwrap(client.returns.lookupOrder(orderNumber, email))
+  });
+}
 function useSubmitReturn() {
   const { client } = useBehio();
   return _reactquery.useMutation.call(void 0, {
@@ -1126,12 +1132,21 @@ function useSubmitQuote() {
     mutationFn: (input) => unwrap(client.quotes.submit(input))
   });
 }
-function useQuoteStatus(quoteId) {
+function useQuoteStatus(quoteId, email) {
   const { client } = useBehio();
   return _reactquery.useQuery.call(void 0, {
     queryKey: ["behio", "quote-status", quoteId],
-    queryFn: () => unwrap(client.quotes.getStatus(quoteId)),
-    enabled: Boolean(quoteId)
+    queryFn: () => unwrap(client.quotes.getStatus(quoteId, email)),
+    enabled: Boolean(quoteId && email)
+  });
+}
+
+// src/react/hooks/use-back-in-stock.ts
+
+function useNotifyWhenAvailable() {
+  const { client } = useBehio();
+  return _reactquery.useMutation.call(void 0, {
+    mutationFn: ({ productId, email }) => unwrap(client.catalog.notifyWhenAvailable(productId, email))
   });
 }
 
@@ -1199,4 +1214,6 @@ function formatPrice(amount, currency, locale) {
 
 
 
-exports.BehioProvider = BehioProvider; exports.cookieStorage = cookieStorage; exports.createMemoryStorage = createMemoryStorage; exports.detectStorage = detectStorage; exports.formatPrice = formatPrice; exports.localStorageAdapter = localStorageAdapter; exports.memoryStorage = memoryStorage; exports.useAddressAutocomplete = useAddressAutocomplete; exports.useAddresses = useAddresses; exports.useAuth = useAuth; exports.useBehio = useBehio; exports.useBehioClient = useBehioClient; exports.useBundle = useBundle; exports.useBundles = useBundles; exports.useCart = useCart; exports.useCartCount = useCartCount; exports.useCategories = useCategories; exports.useCategory = useCategory; exports.useCheckout = useCheckout; exports.useCookieConsent = useCookieConsent; exports.useCrossSell = useCrossSell; exports.useCustomer = useCustomer; exports.useFeatured = useFeatured; exports.useFilters = useFilters; exports.useGiftCardBalance = useGiftCardBalance; exports.useIsInWishlist = useIsInWishlist; exports.useLabels = useLabels; exports.useOrder = useOrder; exports.useOrders = useOrders; exports.usePage = usePage; exports.usePages = usePages; exports.useProduct = useProduct; exports.useProductPromotions = useProductPromotions; exports.useProductReviews = useProductReviews; exports.useProducts = useProducts; exports.useQuoteStatus = useQuoteStatus; exports.useReturnStatus = useReturnStatus; exports.useSearch = useSearch; exports.useShopInfo = useShopInfo; exports.useShopSeo = useShopSeo; exports.useSubmitQuote = useSubmitQuote; exports.useSubmitReturn = useSubmitReturn; exports.useSubmitReview = useSubmitReview; exports.useWishlist = useWishlist;
+
+
+exports.BehioProvider = BehioProvider; exports.cookieStorage = cookieStorage; exports.createMemoryStorage = createMemoryStorage; exports.detectStorage = detectStorage; exports.formatPrice = formatPrice; exports.localStorageAdapter = localStorageAdapter; exports.memoryStorage = memoryStorage; exports.useAddressAutocomplete = useAddressAutocomplete; exports.useAddresses = useAddresses; exports.useAuth = useAuth; exports.useBehio = useBehio; exports.useBehioClient = useBehioClient; exports.useBundle = useBundle; exports.useBundles = useBundles; exports.useCart = useCart; exports.useCartCount = useCartCount; exports.useCategories = useCategories; exports.useCategory = useCategory; exports.useCheckout = useCheckout; exports.useCookieConsent = useCookieConsent; exports.useCrossSell = useCrossSell; exports.useCustomer = useCustomer; exports.useFeatured = useFeatured; exports.useFilters = useFilters; exports.useGiftCardBalance = useGiftCardBalance; exports.useIsInWishlist = useIsInWishlist; exports.useLabels = useLabels; exports.useLookupReturnableOrder = useLookupReturnableOrder; exports.useNotifyWhenAvailable = useNotifyWhenAvailable; exports.useOrder = useOrder; exports.useOrders = useOrders; exports.usePage = usePage; exports.usePages = usePages; exports.useProduct = useProduct; exports.useProductPromotions = useProductPromotions; exports.useProductReviews = useProductReviews; exports.useProducts = useProducts; exports.useQuoteStatus = useQuoteStatus; exports.useReturnStatus = useReturnStatus; exports.useSearch = useSearch; exports.useShopInfo = useShopInfo; exports.useShopSeo = useShopSeo; exports.useSubmitQuote = useSubmitQuote; exports.useSubmitReturn = useSubmitReturn; exports.useSubmitReview = useSubmitReview; exports.useWishlist = useWishlist;

package/dist/react.mjs

@@ -1,6 +1,6 @@
 import {
   BehioStorefront
-} from "./chunk-3GOQSB25.mjs";
+} from "./chunk-EZEZUV2B.mjs";
 
 // src/react/provider.tsx
 import { useRef, useEffect, useMemo } from "react";
@@ -1078,6 +1078,12 @@ function useSubmitReview() {
 
 // src/react/hooks/use-returns.ts
 import { useQuery as useQuery23, useMutation as useMutation9 } from "@tanstack/react-query";
+function useLookupReturnableOrder() {
+  const { client } = useBehio();
+  return useMutation9({
+    mutationFn: ({ orderNumber, email }) => unwrap(client.returns.lookupOrder(orderNumber, email))
+  });
+}
 function useSubmitReturn() {
   const { client } = useBehio();
   return useMutation9({
@@ -1126,12 +1132,21 @@ function useSubmitQuote() {
     mutationFn: (input) => unwrap(client.quotes.submit(input))
   });
 }
-function useQuoteStatus(quoteId) {
+function useQuoteStatus(quoteId, email) {
   const { client } = useBehio();
   return useQuery25({
     queryKey: ["behio", "quote-status", quoteId],
-    queryFn: () => unwrap(client.quotes.getStatus(quoteId)),
-    enabled: Boolean(quoteId)
+    queryFn: () => unwrap(client.quotes.getStatus(quoteId, email)),
+    enabled: Boolean(quoteId && email)
+  });
+}
+
+// src/react/hooks/use-back-in-stock.ts
+import { useMutation as useMutation12 } from "@tanstack/react-query";
+function useNotifyWhenAvailable() {
+  const { client } = useBehio();
+  return useMutation12({
+    mutationFn: ({ productId, email }) => unwrap(client.catalog.notifyWhenAvailable(productId, email))
   });
 }
 
@@ -1182,6 +1197,8 @@ export {
   useGiftCardBalance,
   useIsInWishlist,
   useLabels,
+  useLookupReturnableOrder,
+  useNotifyWhenAvailable,
   useOrder,
   useOrders,
   usePage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behio/storefront-sdk",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "TypeScript SDK for Behio Headless E-Shop — core client + React hooks",
   "author": "Behio",
   "license": "MIT",
@@ -17,6 +17,11 @@
       "types": "./dist/react.d.ts",
       "import": "./dist/react.mjs",
       "require": "./dist/react.js"
+    },
+    "./next": {
+      "types": "./dist/next.d.ts",
+      "import": "./dist/next.mjs",
+      "require": "./dist/next.js"
     }
   },
   "files": [