@behio/storefront-sdk 2.29.0 → 2.31.0

package/dist/react.d.mts

@@ -357,12 +357,14 @@ interface NewsletterSubscribeInput {
     source?: string;
     /** Honeypot: keep empty. A filled value is treated as a bot and ignored. */
     website?: string;
+    /** The consent wording shown to the visitor. Only its hash is stored, as proof. */
+    consentText?: string;
 }
 interface NewsletterSubscribeResult {
     success: boolean;
     /** Confirm the email before the subscription becomes active. */
     confirmationRequired?: boolean;
-    /** True when this email was already an active subscriber. */
+    /** Always false: the answer never reveals who is on the list. */
     alreadySubscribed: boolean;
 }
 interface NewsletterConfirmResult {
@@ -372,6 +374,8 @@ interface NewsletterConfirmResult {
 }
 interface NewsletterUnsubscribeResult {
     success: boolean;
+    /** True for a bare email: its owner gets a signed link, nothing has changed yet. */
+    confirmationRequired: boolean;
 }
 interface ShopSeo {
     robotsTxt?: string | null;
@@ -1681,6 +1685,8 @@ interface CheckoutInput {
     termsConsent?: boolean;
     gdprConsent?: boolean;
     newsletterOptIn?: boolean;
+    /** Wording of the newsletter checkbox as the customer saw it. Only its hash is stored, as proof of consent. */
+    newsletterConsentText?: string;
     /**
      * Consent to start delivering digital content (courses, downloads,
      * services) before the withdrawal period ends, which waives the right of
@@ -2553,7 +2559,35 @@ interface StorefrontFaqQuery {
     locale?: string;
 }
 /** Public definition of a form (`GET /forms/{slug}`). */
+interface StorefrontFormPlacement {
+    key: string;
+    mode: "inline" | "popup";
+    enabled: boolean;
+    delaySeconds: number;
+    dismissDays: number;
+    devices: "all" | "mobile" | "desktop";
+    /** Exact path or prefix ending in *. No regex. */
+    includePaths: string[];
+    excludePaths: string[];
+}
+interface StorefrontFormPresentation {
+    purpose: "general" | "newsletter";
+    content: {
+        eyebrow: string;
+        heading: string;
+        body: string;
+        imageUrl: string;
+        imageAlt: string;
+        dismissLabel: string;
+        backgroundColor: string;
+        accentColor: string;
+    };
+    placements: StorefrontFormPlacement[];
+}
 interface StorefrontForm {
+    /** Published content version. Requires the managed Forms API. */
+    revision: number;
+    presentation: StorefrontFormPresentation;
     slug: string;
     name: string;
     description: string | null;
@@ -2561,6 +2595,8 @@ interface StorefrontForm {
     settings: StorefrontFormSettings;
 }
 interface StorefrontFormSubmitInput {
+    revision?: number;
+    placement?: string;
     /** `{fieldKey: value}`; unknown keys are dropped server-side. */
     data: Record<string, unknown>;
     locale?: string;
@@ -2588,6 +2624,8 @@ interface StorefrontFormFile {
     type: string;
 }
 interface StorefrontFormSubmitResult {
+    confirmationRequired?: boolean;
+    alreadySubscribed?: boolean;
     ok: boolean;
     /** Id of the stored submission (null when the form does not store responses). */
     id: string | null;
@@ -4460,6 +4498,10 @@ declare class BookingsModule {
 declare class FormsModule {
     private client;
     constructor(client: BehioStorefront);
+    /** Only active, published placements. Internal delivery/CRM settings never leave the server. */
+    placements(): Promise<SdkResult<{
+        items: StorefrontForm[];
+    }>>;
     /** Public definition of one form (fields + settings). 404 for an unknown or inactive slug. */
     get(slug: string): Promise<SdkResult<StorefrontForm>>;
     /**
@@ -4659,8 +4701,8 @@ declare class ShippingModule {
 /**
  * First-party newsletter opt-in. Use for the footer signup block and the
  * checkout newsletter checkbox (render its default from
- * `ShopInfo.checkout.newsletterOptInDefault`). Subscribing is idempotent and
- * re-activates a previously unsubscribed email. Pass the hidden `website`
+ * `ShopInfo.checkout.newsletterOptInDefault`). Subscribing is idempotent and the
+ * answer never reveals who is on the list. Pass the hidden `website`
  * honeypot field straight through from your form: a filled value is silently
  * accepted but stored nowhere.
  */
@@ -4669,7 +4711,14 @@ declare class NewsletterModule {
     constructor(client: BehioStorefront);
     subscribe(input: NewsletterSubscribeInput): Promise<SdkResult<NewsletterSubscribeResult>>;
     confirm(token: string): Promise<SdkResult<NewsletterConfirmResult>>;
+    /**
+     * An address proves nothing, so this changes nothing yet: if the address is on
+     * the list, its owner receives a signed link. The answer is the same either way.
+     */
     unsubscribe(email: string): Promise<SdkResult<NewsletterUnsubscribeResult>>;
+    /** Unsubscribes at once with the signed token from a newsletter e-mail. */
+    unsubscribeWithToken(token: string): Promise<SdkResult<NewsletterUnsubscribeResult>>;
+    private requestUnsubscribe;
 }
 
 interface BehioContextValue {
@@ -5380,11 +5429,16 @@ declare function useAnalyticsEvents(): {
  * Subscribe an email to the shop newsletter (first-party opt-in, GAP-08).
  * Use for the footer signup block; the checkout opt-in checkbox goes through
  * the checkout input's `newsletterOptIn` instead. Subscribing is idempotent
- * and re-activates a previously unsubscribed email.
+ * and the answer never reveals who is on the list.
  */
 declare function useNewsletterSubscribe(): _tanstack_react_query.UseMutationResult<NewsletterSubscribeResult, Error, NewsletterSubscribeInput, unknown>;
-/** Unsubscribe an email from the shop newsletter (idempotent). */
-declare function useNewsletterUnsubscribe(): _tanstack_react_query.UseMutationResult<NewsletterUnsubscribeResult, Error, string, unknown>;
+/**
+ * Opt-out. An email only sends its owner a signed link; `{token}` from a
+ * newsletter e-mail unsubscribes at once.
+ */
+declare function useNewsletterUnsubscribe(): _tanstack_react_query.UseMutationResult<NewsletterUnsubscribeResult, Error, string | {
+    token: string;
+}, unknown>;
 /** Explicit confirmation only. Never call on page load or link prefetch. */
 declare function useNewsletterConfirm(): _tanstack_react_query.UseMutationResult<NewsletterConfirmResult, Error, string, unknown>;
 
@@ -5554,6 +5608,15 @@ declare function useSiteFormSubmit(slug: string): {
     error: SdkError | null;
     reset: () => void;
 };
+/** SSR initial data avoids fetching first-render configuration in an effect. */
+declare function useFormPlacements(options?: {
+    initialData?: {
+        items: StorefrontForm[];
+    };
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<{
+    items: StorefrontForm[];
+}>, Error>;
 
 interface UseBookingsOptions {
     enabled?: boolean;
@@ -6336,7 +6399,7 @@ declare function formatPrice(amount: number, currency: string, locale?: string,
  * Consent stays the script layer's job: this helper never loads anything, it
  * only talks to runtimes that already exist on the page.
  */
-type EcommerceEventName = "view_item" | "view_item_list" | "select_item" | "add_to_cart" | "remove_from_cart" | "view_cart" | "add_to_wishlist" | "view_promotion" | "select_promotion" | "begin_checkout" | "add_payment_info" | "add_shipping_info" | "search" | "generate_lead" | "purchase" | "variant_selected" | "newsletter_signup";
+type EcommerceEventName = "view_item" | "view_item_list" | "select_item" | "add_to_cart" | "remove_from_cart" | "view_cart" | "add_to_wishlist" | "view_promotion" | "select_promotion" | "begin_checkout" | "add_payment_info" | "add_shipping_info" | "search" | "generate_lead" | "purchase" | "variant_selected" | "newsletter_signup" | "newsletter_request" | "form_popup_view";
 type EcommerceItem = {
     item_id: string;
     item_name: string;
@@ -6424,4 +6487,19 @@ declare function revokeAnalyticsConsent(client: BehioStorefront): Promise<SdkRes
     success: boolean;
 }>>;
 
-export { type ActivePromotion, type AddToCartInput, type AnalyticsEventInput, type AuthTokens, BehioAnalyticsTracker, BehioApiError, BehioProvider, type BehioProviderProps, type Blog, type BlogPostDetail, type BlogPostListItem, type BlogPostsPage, type BlogPostsQuery, type BlogSettings, type BlogTag, type Booking, type BookingCategory, type BookingConfig, type BookingCreateInput, type BookingCreated, type BookingLocale, type BookingLocation, type BookingManageSlotsQuery, type BookingService, type BookingSlot, type BookingSlots, type BookingSlotsQuery, type BookingStaff, type BookingStatus, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CheckoutPaymentMethod, type CookieConsent, type CookieConsentInput, type CrossSellItem, CurrencySwitcher, type CurrencySwitcherProps, type CurrencySwitcherRenderProps, type CustomerAddress, type CustomerProfile, type EcommerceEventName, type EcommerceItem, type EcommercePayload, type Facet, type FacetRange, type FacetValue, type FacetsResponse, type FilterField, type FulfillmentStatus, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type Page, type PageAttachment, type PageDetail, type PaginatedResponse, type PaymentInstrument, type PaymentStatus, type PaymentSwift, type PersonalOffer, type ProductDetail, type ProductLabel, type ProductListItem, type ProductParameter, type ProductParameterGroup, type ProductParametersResponse, type ProductPrice, type ProductReview, type ProductReviewsResponse, type ProductVariant, type ProductsQuery, type QuoteRequest, type RegisterInput, type ReturnRequest, RichText, type RichTextProps, type ShopInfo, type ShopSeo, type SiteFormField, type SiteFormFieldOption, type SiteFormFieldType, type StorageAdapter, type StorefrontForm, type StorefrontFormFieldError, type StorefrontFormFieldErrorCode, type StorefrontFormSettings, type StorefrontFormSubmitInput, type StorefrontFormSubmitResult, StorefrontScripts, type StorefrontScriptsProps, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type SubmitWithdrawalInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseBlogPostOptions, type UseBlogPostsOptions, type UseBlogsOptions, type UseBookingsOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCertificateVerificationOptions, type UseCollectionOptions, type UseCourseCertificatesOptions, type UseCourseOptions, type UseCoursesOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFacetsOptions, type UseFaqOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseLessonCommentsOptions, type UseLessonNoteOptions, type UseLessonQuizOptions, type UseLessonTutorOptions, type UseLoyaltyOptions, type UseMenuOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UsePaymentMethodsOptions, type UsePersonalOffersOptions, type UseProductOptions, type UseProductParametersOptions, type UseProductsOptions, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingQuoteOptions, type UseShopInfoOptions, type UseShopScriptsOptions, type UseShopSeoOptions, type UseSiteFormOptions, type UseSubscriptionsOptions, type UseVisitorMessagesOptions, type VisitorMessage, type WishlistItem, type WithdrawalAcknowledgement, type WithdrawalWindow, cookieStorage, createMemoryStorage, detectStorage, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, localStorageAdapter, memoryStorage, revokeAnalyticsConsent, trackEcommerceEvent, useAddressAutocomplete, useAddresses, useAnalyticsEvents, useAuth, useBehio, useBehioClient, useBlogPost, useBlogPosts, useBlogs, useBookingConfig, useBookingSlots, useBundle, useBundles, useCancelBooking, useCart, useCartCount, useCategories, useCategory, useCertificateVerification, useCheckout, useCheckoutPreview, useCollection, useCollectionItem, useCookieConsent, useCourse, useCourseCertificates, useCourses, useCreateBooking, useCrossSell, useCurrency, useCustomer, useFacets, useFaqGroup, useFaqGroups, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLessonComments, useLessonNote, useLessonQuiz, useLessonTutor, useLookupReturnableOrder, useLoyalty, useManagedBooking, useManagedBookingSlots, useMenu, useNewsletterConfirm, useNewsletterSubscribe, useNewsletterUnsubscribe, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, usePaymentMethods, usePersonalOffers, usePickupPoints, useProduct, useProductGroup, useProductParameters, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useRescheduleBooking, useReturnStatus, useSearch, useShippingMethods, useShippingQuote, useShopInfo, useShopScripts, useShopSeo, useSiteForm, useSiteFormSubmit, useSubmitQuote, useSubmitReturn, useSubmitReview, useSubmitWithdrawal, useSubscriptions, useVisitorMessages, useWishlist };
+type FormPopupOffer = {
+    form: StorefrontForm;
+    placement: StorefrontFormPlacement;
+};
+/** One host in the shared shell. Preview never mounts it; no subscription occurs on a timer. */
+declare function useFormPopup({ forms, locales, pathname }: {
+    forms: StorefrontForm[];
+    locales: string[];
+    pathname: string;
+}): {
+    active: FormPopupOffer | null;
+    dialog: react.RefObject<HTMLDialogElement | null>;
+    dismiss: () => void;
+};
+
+export { type ActivePromotion, type AddToCartInput, type AnalyticsEventInput, type AuthTokens, BehioAnalyticsTracker, BehioApiError, BehioProvider, type BehioProviderProps, type Blog, type BlogPostDetail, type BlogPostListItem, type BlogPostsPage, type BlogPostsQuery, type BlogSettings, type BlogTag, type Booking, type BookingCategory, type BookingConfig, type BookingCreateInput, type BookingCreated, type BookingLocale, type BookingLocation, type BookingManageSlotsQuery, type BookingService, type BookingSlot, type BookingSlots, type BookingSlotsQuery, type BookingStaff, type BookingStatus, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CheckoutPaymentMethod, type CookieConsent, type CookieConsentInput, type CrossSellItem, CurrencySwitcher, type CurrencySwitcherProps, type CurrencySwitcherRenderProps, type CustomerAddress, type CustomerProfile, type EcommerceEventName, type EcommerceItem, type EcommercePayload, type Facet, type FacetRange, type FacetValue, type FacetsResponse, type FilterField, type FormPopupOffer, type FulfillmentStatus, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type Page, type PageAttachment, type PageDetail, type PaginatedResponse, type PaymentInstrument, type PaymentStatus, type PaymentSwift, type PersonalOffer, type ProductDetail, type ProductLabel, type ProductListItem, type ProductParameter, type ProductParameterGroup, type ProductParametersResponse, type ProductPrice, type ProductReview, type ProductReviewsResponse, type ProductVariant, type ProductsQuery, type QuoteRequest, type RegisterInput, type ReturnRequest, RichText, type RichTextProps, type ShopInfo, type ShopSeo, type SiteFormField, type SiteFormFieldOption, type SiteFormFieldType, type StorageAdapter, type StorefrontForm, type StorefrontFormFieldError, type StorefrontFormFieldErrorCode, type StorefrontFormSettings, type StorefrontFormSubmitInput, type StorefrontFormSubmitResult, StorefrontScripts, type StorefrontScriptsProps, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type SubmitWithdrawalInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseBlogPostOptions, type UseBlogPostsOptions, type UseBlogsOptions, type UseBookingsOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCertificateVerificationOptions, type UseCollectionOptions, type UseCourseCertificatesOptions, type UseCourseOptions, type UseCoursesOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFacetsOptions, type UseFaqOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseLessonCommentsOptions, type UseLessonNoteOptions, type UseLessonQuizOptions, type UseLessonTutorOptions, type UseLoyaltyOptions, type UseMenuOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UsePaymentMethodsOptions, type UsePersonalOffersOptions, type UseProductOptions, type UseProductParametersOptions, type UseProductsOptions, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingQuoteOptions, type UseShopInfoOptions, type UseShopScriptsOptions, type UseShopSeoOptions, type UseSiteFormOptions, type UseSubscriptionsOptions, type UseVisitorMessagesOptions, type VisitorMessage, type WishlistItem, type WithdrawalAcknowledgement, type WithdrawalWindow, cookieStorage, createMemoryStorage, detectStorage, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, localStorageAdapter, memoryStorage, revokeAnalyticsConsent, trackEcommerceEvent, useAddressAutocomplete, useAddresses, useAnalyticsEvents, useAuth, useBehio, useBehioClient, useBlogPost, useBlogPosts, useBlogs, useBookingConfig, useBookingSlots, useBundle, useBundles, useCancelBooking, useCart, useCartCount, useCategories, useCategory, useCertificateVerification, useCheckout, useCheckoutPreview, useCollection, useCollectionItem, useCookieConsent, useCourse, useCourseCertificates, useCourses, useCreateBooking, useCrossSell, useCurrency, useCustomer, useFacets, useFaqGroup, useFaqGroups, useFeatured, useFilters, useFormPlacements, useFormPopup, useGiftCardBalance, useIsInWishlist, useLabels, useLessonComments, useLessonNote, useLessonQuiz, useLessonTutor, useLookupReturnableOrder, useLoyalty, useManagedBooking, useManagedBookingSlots, useMenu, useNewsletterConfirm, useNewsletterSubscribe, useNewsletterUnsubscribe, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, usePaymentMethods, usePersonalOffers, usePickupPoints, useProduct, useProductGroup, useProductParameters, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useRescheduleBooking, useReturnStatus, useSearch, useShippingMethods, useShippingQuote, useShopInfo, useShopScripts, useShopSeo, useSiteForm, useSiteFormSubmit, useSubmitQuote, useSubmitReturn, useSubmitReview, useSubmitWithdrawal, useSubscriptions, useVisitorMessages, useWishlist };

package/dist/react.d.ts

@@ -357,12 +357,14 @@ interface NewsletterSubscribeInput {
     source?: string;
     /** Honeypot: keep empty. A filled value is treated as a bot and ignored. */
     website?: string;
+    /** The consent wording shown to the visitor. Only its hash is stored, as proof. */
+    consentText?: string;
 }
 interface NewsletterSubscribeResult {
     success: boolean;
     /** Confirm the email before the subscription becomes active. */
     confirmationRequired?: boolean;
-    /** True when this email was already an active subscriber. */
+    /** Always false: the answer never reveals who is on the list. */
     alreadySubscribed: boolean;
 }
 interface NewsletterConfirmResult {
@@ -372,6 +374,8 @@ interface NewsletterConfirmResult {
 }
 interface NewsletterUnsubscribeResult {
     success: boolean;
+    /** True for a bare email: its owner gets a signed link, nothing has changed yet. */
+    confirmationRequired: boolean;
 }
 interface ShopSeo {
     robotsTxt?: string | null;
@@ -1681,6 +1685,8 @@ interface CheckoutInput {
     termsConsent?: boolean;
     gdprConsent?: boolean;
     newsletterOptIn?: boolean;
+    /** Wording of the newsletter checkbox as the customer saw it. Only its hash is stored, as proof of consent. */
+    newsletterConsentText?: string;
     /**
      * Consent to start delivering digital content (courses, downloads,
      * services) before the withdrawal period ends, which waives the right of
@@ -2553,7 +2559,35 @@ interface StorefrontFaqQuery {
     locale?: string;
 }
 /** Public definition of a form (`GET /forms/{slug}`). */
+interface StorefrontFormPlacement {
+    key: string;
+    mode: "inline" | "popup";
+    enabled: boolean;
+    delaySeconds: number;
+    dismissDays: number;
+    devices: "all" | "mobile" | "desktop";
+    /** Exact path or prefix ending in *. No regex. */
+    includePaths: string[];
+    excludePaths: string[];
+}
+interface StorefrontFormPresentation {
+    purpose: "general" | "newsletter";
+    content: {
+        eyebrow: string;
+        heading: string;
+        body: string;
+        imageUrl: string;
+        imageAlt: string;
+        dismissLabel: string;
+        backgroundColor: string;
+        accentColor: string;
+    };
+    placements: StorefrontFormPlacement[];
+}
 interface StorefrontForm {
+    /** Published content version. Requires the managed Forms API. */
+    revision: number;
+    presentation: StorefrontFormPresentation;
     slug: string;
     name: string;
     description: string | null;
@@ -2561,6 +2595,8 @@ interface StorefrontForm {
     settings: StorefrontFormSettings;
 }
 interface StorefrontFormSubmitInput {
+    revision?: number;
+    placement?: string;
     /** `{fieldKey: value}`; unknown keys are dropped server-side. */
     data: Record<string, unknown>;
     locale?: string;
@@ -2588,6 +2624,8 @@ interface StorefrontFormFile {
     type: string;
 }
 interface StorefrontFormSubmitResult {
+    confirmationRequired?: boolean;
+    alreadySubscribed?: boolean;
     ok: boolean;
     /** Id of the stored submission (null when the form does not store responses). */
     id: string | null;
@@ -4460,6 +4498,10 @@ declare class BookingsModule {
 declare class FormsModule {
     private client;
     constructor(client: BehioStorefront);
+    /** Only active, published placements. Internal delivery/CRM settings never leave the server. */
+    placements(): Promise<SdkResult<{
+        items: StorefrontForm[];
+    }>>;
     /** Public definition of one form (fields + settings). 404 for an unknown or inactive slug. */
     get(slug: string): Promise<SdkResult<StorefrontForm>>;
     /**
@@ -4659,8 +4701,8 @@ declare class ShippingModule {
 /**
  * First-party newsletter opt-in. Use for the footer signup block and the
  * checkout newsletter checkbox (render its default from
- * `ShopInfo.checkout.newsletterOptInDefault`). Subscribing is idempotent and
- * re-activates a previously unsubscribed email. Pass the hidden `website`
+ * `ShopInfo.checkout.newsletterOptInDefault`). Subscribing is idempotent and the
+ * answer never reveals who is on the list. Pass the hidden `website`
  * honeypot field straight through from your form: a filled value is silently
  * accepted but stored nowhere.
  */
@@ -4669,7 +4711,14 @@ declare class NewsletterModule {
     constructor(client: BehioStorefront);
     subscribe(input: NewsletterSubscribeInput): Promise<SdkResult<NewsletterSubscribeResult>>;
     confirm(token: string): Promise<SdkResult<NewsletterConfirmResult>>;
+    /**
+     * An address proves nothing, so this changes nothing yet: if the address is on
+     * the list, its owner receives a signed link. The answer is the same either way.
+     */
     unsubscribe(email: string): Promise<SdkResult<NewsletterUnsubscribeResult>>;
+    /** Unsubscribes at once with the signed token from a newsletter e-mail. */
+    unsubscribeWithToken(token: string): Promise<SdkResult<NewsletterUnsubscribeResult>>;
+    private requestUnsubscribe;
 }
 
 interface BehioContextValue {
@@ -5380,11 +5429,16 @@ declare function useAnalyticsEvents(): {
  * Subscribe an email to the shop newsletter (first-party opt-in, GAP-08).
  * Use for the footer signup block; the checkout opt-in checkbox goes through
  * the checkout input's `newsletterOptIn` instead. Subscribing is idempotent
- * and re-activates a previously unsubscribed email.
+ * and the answer never reveals who is on the list.
  */
 declare function useNewsletterSubscribe(): _tanstack_react_query.UseMutationResult<NewsletterSubscribeResult, Error, NewsletterSubscribeInput, unknown>;
-/** Unsubscribe an email from the shop newsletter (idempotent). */
-declare function useNewsletterUnsubscribe(): _tanstack_react_query.UseMutationResult<NewsletterUnsubscribeResult, Error, string, unknown>;
+/**
+ * Opt-out. An email only sends its owner a signed link; `{token}` from a
+ * newsletter e-mail unsubscribes at once.
+ */
+declare function useNewsletterUnsubscribe(): _tanstack_react_query.UseMutationResult<NewsletterUnsubscribeResult, Error, string | {
+    token: string;
+}, unknown>;
 /** Explicit confirmation only. Never call on page load or link prefetch. */
 declare function useNewsletterConfirm(): _tanstack_react_query.UseMutationResult<NewsletterConfirmResult, Error, string, unknown>;
 
@@ -5554,6 +5608,15 @@ declare function useSiteFormSubmit(slug: string): {
     error: SdkError | null;
     reset: () => void;
 };
+/** SSR initial data avoids fetching first-render configuration in an effect. */
+declare function useFormPlacements(options?: {
+    initialData?: {
+        items: StorefrontForm[];
+    };
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<{
+    items: StorefrontForm[];
+}>, Error>;
 
 interface UseBookingsOptions {
     enabled?: boolean;
@@ -6336,7 +6399,7 @@ declare function formatPrice(amount: number, currency: string, locale?: string,
  * Consent stays the script layer's job: this helper never loads anything, it
  * only talks to runtimes that already exist on the page.
  */
-type EcommerceEventName = "view_item" | "view_item_list" | "select_item" | "add_to_cart" | "remove_from_cart" | "view_cart" | "add_to_wishlist" | "view_promotion" | "select_promotion" | "begin_checkout" | "add_payment_info" | "add_shipping_info" | "search" | "generate_lead" | "purchase" | "variant_selected" | "newsletter_signup";
+type EcommerceEventName = "view_item" | "view_item_list" | "select_item" | "add_to_cart" | "remove_from_cart" | "view_cart" | "add_to_wishlist" | "view_promotion" | "select_promotion" | "begin_checkout" | "add_payment_info" | "add_shipping_info" | "search" | "generate_lead" | "purchase" | "variant_selected" | "newsletter_signup" | "newsletter_request" | "form_popup_view";
 type EcommerceItem = {
     item_id: string;
     item_name: string;
@@ -6424,4 +6487,19 @@ declare function revokeAnalyticsConsent(client: BehioStorefront): Promise<SdkRes
     success: boolean;
 }>>;
 
-export { type ActivePromotion, type AddToCartInput, type AnalyticsEventInput, type AuthTokens, BehioAnalyticsTracker, BehioApiError, BehioProvider, type BehioProviderProps, type Blog, type BlogPostDetail, type BlogPostListItem, type BlogPostsPage, type BlogPostsQuery, type BlogSettings, type BlogTag, type Booking, type BookingCategory, type BookingConfig, type BookingCreateInput, type BookingCreated, type BookingLocale, type BookingLocation, type BookingManageSlotsQuery, type BookingService, type BookingSlot, type BookingSlots, type BookingSlotsQuery, type BookingStaff, type BookingStatus, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CheckoutPaymentMethod, type CookieConsent, type CookieConsentInput, type CrossSellItem, CurrencySwitcher, type CurrencySwitcherProps, type CurrencySwitcherRenderProps, type CustomerAddress, type CustomerProfile, type EcommerceEventName, type EcommerceItem, type EcommercePayload, type Facet, type FacetRange, type FacetValue, type FacetsResponse, type FilterField, type FulfillmentStatus, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type Page, type PageAttachment, type PageDetail, type PaginatedResponse, type PaymentInstrument, type PaymentStatus, type PaymentSwift, type PersonalOffer, type ProductDetail, type ProductLabel, type ProductListItem, type ProductParameter, type ProductParameterGroup, type ProductParametersResponse, type ProductPrice, type ProductReview, type ProductReviewsResponse, type ProductVariant, type ProductsQuery, type QuoteRequest, type RegisterInput, type ReturnRequest, RichText, type RichTextProps, type ShopInfo, type ShopSeo, type SiteFormField, type SiteFormFieldOption, type SiteFormFieldType, type StorageAdapter, type StorefrontForm, type StorefrontFormFieldError, type StorefrontFormFieldErrorCode, type StorefrontFormSettings, type StorefrontFormSubmitInput, type StorefrontFormSubmitResult, StorefrontScripts, type StorefrontScriptsProps, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type SubmitWithdrawalInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseBlogPostOptions, type UseBlogPostsOptions, type UseBlogsOptions, type UseBookingsOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCertificateVerificationOptions, type UseCollectionOptions, type UseCourseCertificatesOptions, type UseCourseOptions, type UseCoursesOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFacetsOptions, type UseFaqOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseLessonCommentsOptions, type UseLessonNoteOptions, type UseLessonQuizOptions, type UseLessonTutorOptions, type UseLoyaltyOptions, type UseMenuOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UsePaymentMethodsOptions, type UsePersonalOffersOptions, type UseProductOptions, type UseProductParametersOptions, type UseProductsOptions, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingQuoteOptions, type UseShopInfoOptions, type UseShopScriptsOptions, type UseShopSeoOptions, type UseSiteFormOptions, type UseSubscriptionsOptions, type UseVisitorMessagesOptions, type VisitorMessage, type WishlistItem, type WithdrawalAcknowledgement, type WithdrawalWindow, cookieStorage, createMemoryStorage, detectStorage, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, localStorageAdapter, memoryStorage, revokeAnalyticsConsent, trackEcommerceEvent, useAddressAutocomplete, useAddresses, useAnalyticsEvents, useAuth, useBehio, useBehioClient, useBlogPost, useBlogPosts, useBlogs, useBookingConfig, useBookingSlots, useBundle, useBundles, useCancelBooking, useCart, useCartCount, useCategories, useCategory, useCertificateVerification, useCheckout, useCheckoutPreview, useCollection, useCollectionItem, useCookieConsent, useCourse, useCourseCertificates, useCourses, useCreateBooking, useCrossSell, useCurrency, useCustomer, useFacets, useFaqGroup, useFaqGroups, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLessonComments, useLessonNote, useLessonQuiz, useLessonTutor, useLookupReturnableOrder, useLoyalty, useManagedBooking, useManagedBookingSlots, useMenu, useNewsletterConfirm, useNewsletterSubscribe, useNewsletterUnsubscribe, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, usePaymentMethods, usePersonalOffers, usePickupPoints, useProduct, useProductGroup, useProductParameters, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useRescheduleBooking, useReturnStatus, useSearch, useShippingMethods, useShippingQuote, useShopInfo, useShopScripts, useShopSeo, useSiteForm, useSiteFormSubmit, useSubmitQuote, useSubmitReturn, useSubmitReview, useSubmitWithdrawal, useSubscriptions, useVisitorMessages, useWishlist };
+type FormPopupOffer = {
+    form: StorefrontForm;
+    placement: StorefrontFormPlacement;
+};
+/** One host in the shared shell. Preview never mounts it; no subscription occurs on a timer. */
+declare function useFormPopup({ forms, locales, pathname }: {
+    forms: StorefrontForm[];
+    locales: string[];
+    pathname: string;
+}): {
+    active: FormPopupOffer | null;
+    dialog: react.RefObject<HTMLDialogElement | null>;
+    dismiss: () => void;
+};
+
+export { type ActivePromotion, type AddToCartInput, type AnalyticsEventInput, type AuthTokens, BehioAnalyticsTracker, BehioApiError, BehioProvider, type BehioProviderProps, type Blog, type BlogPostDetail, type BlogPostListItem, type BlogPostsPage, type BlogPostsQuery, type BlogSettings, type BlogTag, type Booking, type BookingCategory, type BookingConfig, type BookingCreateInput, type BookingCreated, type BookingLocale, type BookingLocation, type BookingManageSlotsQuery, type BookingService, type BookingSlot, type BookingSlots, type BookingSlotsQuery, type BookingStaff, type BookingStatus, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CheckoutPaymentMethod, type CookieConsent, type CookieConsentInput, type CrossSellItem, CurrencySwitcher, type CurrencySwitcherProps, type CurrencySwitcherRenderProps, type CustomerAddress, type CustomerProfile, type EcommerceEventName, type EcommerceItem, type EcommercePayload, type Facet, type FacetRange, type FacetValue, type FacetsResponse, type FilterField, type FormPopupOffer, type FulfillmentStatus, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type Page, type PageAttachment, type PageDetail, type PaginatedResponse, type PaymentInstrument, type PaymentStatus, type PaymentSwift, type PersonalOffer, type ProductDetail, type ProductLabel, type ProductListItem, type ProductParameter, type ProductParameterGroup, type ProductParametersResponse, type ProductPrice, type ProductReview, type ProductReviewsResponse, type ProductVariant, type ProductsQuery, type QuoteRequest, type RegisterInput, type ReturnRequest, RichText, type RichTextProps, type ShopInfo, type ShopSeo, type SiteFormField, type SiteFormFieldOption, type SiteFormFieldType, type StorageAdapter, type StorefrontForm, type StorefrontFormFieldError, type StorefrontFormFieldErrorCode, type StorefrontFormSettings, type StorefrontFormSubmitInput, type StorefrontFormSubmitResult, StorefrontScripts, type StorefrontScriptsProps, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type SubmitWithdrawalInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseBlogPostOptions, type UseBlogPostsOptions, type UseBlogsOptions, type UseBookingsOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCertificateVerificationOptions, type UseCollectionOptions, type UseCourseCertificatesOptions, type UseCourseOptions, type UseCoursesOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFacetsOptions, type UseFaqOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseLessonCommentsOptions, type UseLessonNoteOptions, type UseLessonQuizOptions, type UseLessonTutorOptions, type UseLoyaltyOptions, type UseMenuOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UsePaymentMethodsOptions, type UsePersonalOffersOptions, type UseProductOptions, type UseProductParametersOptions, type UseProductsOptions, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingQuoteOptions, type UseShopInfoOptions, type UseShopScriptsOptions, type UseShopSeoOptions, type UseSiteFormOptions, type UseSubscriptionsOptions, type UseVisitorMessagesOptions, type VisitorMessage, type WishlistItem, type WithdrawalAcknowledgement, type WithdrawalWindow, cookieStorage, createMemoryStorage, detectStorage, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, localStorageAdapter, memoryStorage, revokeAnalyticsConsent, trackEcommerceEvent, useAddressAutocomplete, useAddresses, useAnalyticsEvents, useAuth, useBehio, useBehioClient, useBlogPost, useBlogPosts, useBlogs, useBookingConfig, useBookingSlots, useBundle, useBundles, useCancelBooking, useCart, useCartCount, useCategories, useCategory, useCertificateVerification, useCheckout, useCheckoutPreview, useCollection, useCollectionItem, useCookieConsent, useCourse, useCourseCertificates, useCourses, useCreateBooking, useCrossSell, useCurrency, useCustomer, useFacets, useFaqGroup, useFaqGroups, useFeatured, useFilters, useFormPlacements, useFormPopup, useGiftCardBalance, useIsInWishlist, useLabels, useLessonComments, useLessonNote, useLessonQuiz, useLessonTutor, useLookupReturnableOrder, useLoyalty, useManagedBooking, useManagedBookingSlots, useMenu, useNewsletterConfirm, useNewsletterSubscribe, useNewsletterUnsubscribe, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, usePaymentMethods, usePersonalOffers, usePickupPoints, useProduct, useProductGroup, useProductParameters, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useRescheduleBooking, useReturnStatus, useSearch, useShippingMethods, useShippingQuote, useShopInfo, useShopScripts, useShopSeo, useSiteForm, useSiteFormSubmit, useSubmitQuote, useSubmitReturn, useSubmitReview, useSubmitWithdrawal, useSubscriptions, useVisitorMessages, useWishlist };