@nevios/storefront-kit 1.3.0 → 1.4.0

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import * as React from 'react';
-import { StorefrontClient, Money, Product, ProductMedia, ProductVariant, CollectionDetail, ProductSort, Cart, AddLineInput, CartLine, Checkout, CreateCheckoutInput, SetAddressInput, ShippingQuote, PaymentMethod, OrderStatus, PaymentState, OrderPhase, PaymentInstructions, Customer, MagicLinkResult, ReorderResult } from '@nevios/storefront-js';
+import * as _nevios_storefront_js from '@nevios/storefront-js';
+import { StorefrontClient, Money, Product, ProductMedia, ProductVariant, CollectionDetail, ProductSort, SubscriptionPlan, Cart, AddLineInput, UpdateCartLineInput, CartLine, SubscriptionSelection, SubscriptionQuote, Checkout, CreateCheckoutInput, SetAddressInput, ShippingQuote, PaymentMethod, SubscriptionAcceptance, SubscriptionEnrollmentResult, SubscriptionPayment, OrderStatus, PaymentState, OrderPhase, PaymentInstructions, Customer, MagicLinkResult, ReorderResult, SubscriptionDetails, Subscription } from '@nevios/storefront-js';
 
 /**
  * NeviosProvider — puts a configured storefront client on React context so
@@ -71,6 +72,16 @@ declare function ThemeProvider({ theme, children, as: Tag, }: ThemeProviderProps
  * provider picks the category for the active locale via `Intl.PluralRules`.
  */
 declare const en: {
+    "subscriptions.purchaseOption": string;
+    "subscriptions.empty": string;
+    "subscriptions.status.active": string;
+    "subscriptions.status.paused": string;
+    "subscriptions.status.pending": string;
+    "subscriptions.status.cancelled": string;
+    "subscriptions.title": string;
+    "subscriptions.consent": string;
+    "subscriptions.eachDelivery": string;
+    "subscriptions.once": string;
     "common.free": string;
     "common.close": string;
     "common.loadingShort": string;
@@ -510,6 +521,16 @@ interface TagFilterProps {
 /** Toggleable tag chips. Multi-select; emits the selected list. */
 declare function TagFilter({ tags, selected, onChange }: TagFilterProps): React.ReactElement | null;
 
+/** Controlled PDP selector. Pass value to AddToCart.subscriptionPlanId.
+ * Plans and prices must come from client.subscriptions.plans(variantId). */
+declare function PurchaseOptions({ plans, value, onChange, disabled, locale }: {
+    plans: SubscriptionPlan[];
+    value: string | null;
+    onChange(planId: string | null): void;
+    disabled?: boolean;
+    locale?: string;
+}): React.ReactElement;
+
 /**
  * CartProvider + useCart — shared cart state for the whole app. The drawer, the
  * PDP add-to-cart, and a header cart count all read the same cart and re-render
@@ -527,8 +548,9 @@ interface CartState {
     loading: boolean;
     itemCount: number;
     addLine(input: AddLineInput): Promise<Cart>;
-    updateLine(lineId: string, quantity: number): Promise<Cart>;
+    updateLine(lineId: string, quantity: number | UpdateCartLineInput): Promise<Cart>;
     removeLine(lineId: string): Promise<Cart>;
+    clearSubscription(): Promise<Cart>;
     /** Re-fetch the cart from the server. */
     refresh(): Promise<void>;
 }
@@ -547,11 +569,12 @@ declare function useCart(): CartState;
 interface AddToCartProps {
     variant: ProductVariant | null;
     quantity?: number;
+    subscriptionPlanId?: string | null;
     /** Button label. Defaults to "Add to cart". */
     children?: React.ReactNode;
     onAdded?: () => void;
 }
-declare function AddToCart({ variant, quantity, children, onAdded, }: AddToCartProps): React.ReactElement;
+declare function AddToCart({ variant, quantity, subscriptionPlanId, children, onAdded, }: AddToCartProps): React.ReactElement;
 
 /**
  * CartLineItem — one cart row: thumbnail, title + variant, a quantity stepper,
@@ -615,8 +638,16 @@ type PayResult = {
 } | {
     kind: "order";
     checkout: Checkout;
+} | {
+    kind: "subscription";
+    subscription: SubscriptionEnrollmentResult;
+} | {
+    kind: "subscription_payment";
+    payment: SubscriptionPayment;
 };
 interface PayOptions {
+    /** Explicit acceptance of the currently displayed recurring quote. */
+    subscription?: SubscriptionAcceptance;
     /** Where the gateway returns the customer after paying. */
     returnUrl?: string;
     /** Where the gateway returns the customer on cancel. */
@@ -629,6 +660,9 @@ interface PayOptions {
     redirect?: boolean;
 }
 interface CheckoutState {
+    selectSubscription(selection: SubscriptionSelection): Promise<SubscriptionQuote>;
+    clearSubscription(): Promise<Checkout>;
+    reviewSubscription(): Promise<SubscriptionQuote>;
     checkout: Checkout | null;
     /** True while a checkout request is in flight. */
     loading: boolean;
@@ -678,6 +712,8 @@ declare function useCheckout(): CheckoutState;
 interface CheckoutFlowProps {
     /** If set and no checkout exists yet, create one from this cart token. */
     cartToken?: string;
+    /** Confirm with Stripe.js, then the flow refreshes the server payment state. */
+    onSubscriptionPayment?: (payment: SubscriptionPayment) => void | Promise<void>;
     /** Called when a (non-gateway) order is placed. Gateway flows redirect away
      *  before this fires. */
     onOrderPlaced?: (checkout: Checkout) => void;
@@ -690,7 +726,7 @@ interface CheckoutFlowProps {
     cancelUrl?: string;
     locale?: string;
 }
-declare function CheckoutFlow({ cartToken, onOrderPlaced, emptyState, renderConfirmation, returnUrl, cancelUrl, locale, }: CheckoutFlowProps): React.ReactElement;
+declare function CheckoutFlow({ cartToken, onSubscriptionPayment, onOrderPlaced, emptyState, renderConfirmation, returnUrl, cancelUrl, locale, }: CheckoutFlowProps): React.ReactElement;
 
 /**
  * AddressForm — collects email + shipping address (the checkout's first step).
@@ -731,7 +767,7 @@ declare function ShippingPicker({ title, submitLabel, onComplete, locale, }: Shi
  * one, and places the order. The category drives the final action:
  *   • gateway        → `pay()` starts the payment and redirects to the gateway
  *   • cod/bank/manual → `pay()` completes the order directly → `onOrderPlaced`
- * The storefront never embeds a gateway — paying a card means a redirect.
+ * Recurring Stripe payments use the merchant's Stripe.js callback.
  */
 
 interface PaymentSectionProps {
@@ -743,8 +779,10 @@ interface PaymentSectionProps {
     /** Called when a non-gateway order is placed (gateway flows redirect away). */
     onOrderPlaced?: (checkout: Checkout) => void;
     locale?: string;
+    /** Confirm the returned intent using your Stripe.js Payment Element. */
+    onSubscriptionPayment?: (payment: SubscriptionPayment) => void | Promise<void>;
 }
-declare function PaymentSection({ title, returnUrl, cancelUrl, onOrderPlaced, locale, }: PaymentSectionProps): React.ReactElement;
+declare function PaymentSection({ title, returnUrl, cancelUrl, onOrderPlaced, locale, onSubscriptionPayment, }: PaymentSectionProps): React.ReactElement;
 
 /**
  * OrderSummary — the checkout's running total: line items + the full breakdown
@@ -761,6 +799,14 @@ interface OrderSummaryProps {
 }
 declare function OrderSummary({ checkout: override, totalsOnly, locale, }: OrderSummaryProps): React.ReactElement | null;
 
+/** Displays the exact server quote. Never pre-check consent or calculate a discount. */
+declare function SubscriptionTerms({ quote, checked, onChange, locale }: {
+    quote: SubscriptionQuote;
+    checked: boolean;
+    onChange(checked: boolean): void;
+    locale?: string;
+}): React.ReactElement;
+
 interface OrderStatusState {
     order: OrderStatus | null;
     loading: boolean;
@@ -1051,6 +1097,68 @@ declare function ProfileEditor(): React.ReactElement | null;
 /** Email verification, session revocation and explicit account-closure confirmation. */
 declare function AccountSecurity(): React.ReactElement | null;
 
+/** Customer-only API plus reload-safe query state. Changing a saved account
+ * address never silently changes a recurring contract; preview/commit explicitly. */
+declare function useCustomerSubscriptions(): {
+    subscriptions: Subscription[];
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    api: {
+        plans(variantId: string, marketId?: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionPlan[]>;
+        select(checkoutToken: string, selection: _nevios_storefront_js.SubscriptionSelection, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionQuote>;
+        clear(checkoutToken: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<void>;
+        enroll(checkoutToken: string, selection: _nevios_storefront_js.SubscriptionEnrollment, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionEnrollmentResult>;
+        checkoutPayment(checkoutToken: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionPayment>;
+        list(opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription[]>;
+        get(id: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription>;
+        management(id: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<SubscriptionDetails>;
+        command: (id: string, body: _nevios_storefront_js.SubscriptionCommand, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        pause: (id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        resume: (id: string, expectedVersion: number, nextAt: string, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        skipNext: (id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        cancel: (id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        payment(id: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionPayment>;
+        previewChanges(id: string, changes: _nevios_storefront_js.SubscriptionChanges, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionChangeQuote>;
+        commitChanges(id: string, changes: _nevios_storefront_js.SubscriptionChanges, quote: _nevios_storefront_js.SubscriptionChangeQuote, consentEvidence: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription>;
+        confirmCard(id: string, setupIntentId: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription>;
+        replaceCard(id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionCardSetup>;
+    };
+};
+/** Unified upcoming/history/items view. Async results never survive a logout or
+ * switching customer/contract. Call refresh after an explicitly reviewed change. */
+declare function useCustomerSubscription(id: string | null): {
+    subscription: SubscriptionDetails | null;
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    api: {
+        plans(variantId: string, marketId?: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionPlan[]>;
+        select(checkoutToken: string, selection: _nevios_storefront_js.SubscriptionSelection, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionQuote>;
+        clear(checkoutToken: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<void>;
+        enroll(checkoutToken: string, selection: _nevios_storefront_js.SubscriptionEnrollment, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionEnrollmentResult>;
+        checkoutPayment(checkoutToken: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionPayment>;
+        list(opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription[]>;
+        get(id: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription>;
+        management(id: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<SubscriptionDetails>;
+        command: (id: string, body: _nevios_storefront_js.SubscriptionCommand, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        pause: (id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        resume: (id: string, expectedVersion: number, nextAt: string, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        skipNext: (id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        cancel: (id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        payment(id: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionPayment>;
+        previewChanges(id: string, changes: _nevios_storefront_js.SubscriptionChanges, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionChangeQuote>;
+        commitChanges(id: string, changes: _nevios_storefront_js.SubscriptionChanges, quote: _nevios_storefront_js.SubscriptionChangeQuote, consentEvidence: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription>;
+        confirmCard(id: string, setupIntentId: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription>;
+        replaceCard(id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionCardSetup>;
+    };
+};
+
+declare function SubscriptionList({ href, locale }: {
+    href(id: string): string;
+    locale?: string;
+}): React.ReactElement;
+
 /**
  * ProductJsonLd — schema.org/Product structured data for rich results (price,
  * availability, brand). Drop it in the PDP <head> (or anywhere; it's a script).
@@ -1127,4 +1235,4 @@ interface JsonLdProps {
 /** Render a JSON-LD `<script>` for the given (already-shaped) data object. */
 declare function JsonLd({ data }: JsonLdProps): React.ReactElement;
 
-export { AccountDashboard, type AccountDashboardProps, AccountProvider, AccountSecurity, type AccountState, AddToCart, type AddToCartProps, AddressBook, AddressForm, type AddressFormProps, AvailabilityFilter, type AvailabilityFilterProps, BackInStockForm, type BackInStockFormProps, type BreadcrumbItem, BreadcrumbJsonLd, type BreadcrumbJsonLdProps, CartDrawer, type CartDrawerProps, CartLineItem, type CartLineItemProps, CartProvider, type CartState, CartSummary, type CartSummaryProps, CheckoutFlow, type CheckoutFlowProps, CheckoutProvider, type CheckoutState, CollectionPage, type CollectionPageProps, I18nProvider, type I18nProviderProps, type I18nValue, JsonLd, type JsonLdProps, LoginForm, type LoginFormProps, type MarketOption, MarketSwitcher, type MarketSwitcherProps, type MessageKey, type Messages, NeviosProvider, type NeviosProviderProps, OrderConfirmation, type OrderConfirmationProps, OrderHistory, type OrderHistoryProps, OrderLines, OrderStatusPage, type OrderStatusPageProps, type OrderStatusState, OrderSummary, type OrderSummaryProps, OrderTotals, OrganizationJsonLd, type OrganizationJsonLdProps, type PayOptions, type PayResult, PaymentMethodPicker, type PaymentMethodPickerProps, PaymentPage, type PaymentPageProps, type PaymentPageState, PaymentSection, type PaymentSectionProps, PhaseTimeline, PriceMoney, type PriceMoneyProps, PriceRangeFilter, type PriceRangeFilterProps, ProductCard, type ProductCardProps, ProductDetailPage, type ProductDetailPageProps, ProductGallery, type ProductGalleryProps, ProductJsonLd, type ProductJsonLdProps, ProfileEditor, ShippingPicker, type ShippingPickerProps, SortSelect, type SortSelectProps, StatusBanner, StockBadge, type StockBadgeProps, type StorefrontTheme, type TFunction, type TVars, TagFilter, type TagFilterProps, ThemeProvider, type ThemeProviderProps, TransferInstructions, type TransferInstructionsProps, VariantPicker, type VariantPickerProps, type VerifyStatus, absoluteUrl, bundledMessages, cs, en, formatCents, formatMoney, isTerminal, serializeJsonLd, stripHtml, themeToCssVars, useAccount, useCart, useCheckout, useI18n, useMagicLinkVerify, useOrderStatus, usePayment, useStorefront, useStorefrontOptional, useT };
+export { AccountDashboard, type AccountDashboardProps, AccountProvider, AccountSecurity, type AccountState, AddToCart, type AddToCartProps, AddressBook, AddressForm, type AddressFormProps, AvailabilityFilter, type AvailabilityFilterProps, BackInStockForm, type BackInStockFormProps, type BreadcrumbItem, BreadcrumbJsonLd, type BreadcrumbJsonLdProps, CartDrawer, type CartDrawerProps, CartLineItem, type CartLineItemProps, CartProvider, type CartState, CartSummary, type CartSummaryProps, CheckoutFlow, type CheckoutFlowProps, CheckoutProvider, type CheckoutState, CollectionPage, type CollectionPageProps, I18nProvider, type I18nProviderProps, type I18nValue, JsonLd, type JsonLdProps, LoginForm, type LoginFormProps, type MarketOption, MarketSwitcher, type MarketSwitcherProps, type MessageKey, type Messages, NeviosProvider, type NeviosProviderProps, OrderConfirmation, type OrderConfirmationProps, OrderHistory, type OrderHistoryProps, OrderLines, OrderStatusPage, type OrderStatusPageProps, type OrderStatusState, OrderSummary, type OrderSummaryProps, OrderTotals, OrganizationJsonLd, type OrganizationJsonLdProps, type PayOptions, type PayResult, PaymentMethodPicker, type PaymentMethodPickerProps, PaymentPage, type PaymentPageProps, type PaymentPageState, PaymentSection, type PaymentSectionProps, PhaseTimeline, PriceMoney, type PriceMoneyProps, PriceRangeFilter, type PriceRangeFilterProps, ProductCard, type ProductCardProps, ProductDetailPage, type ProductDetailPageProps, ProductGallery, type ProductGalleryProps, ProductJsonLd, type ProductJsonLdProps, ProfileEditor, PurchaseOptions, ShippingPicker, type ShippingPickerProps, SortSelect, type SortSelectProps, StatusBanner, StockBadge, type StockBadgeProps, type StorefrontTheme, SubscriptionList, SubscriptionTerms, type TFunction, type TVars, TagFilter, type TagFilterProps, ThemeProvider, type ThemeProviderProps, TransferInstructions, type TransferInstructionsProps, VariantPicker, type VariantPickerProps, type VerifyStatus, absoluteUrl, bundledMessages, cs, en, formatCents, formatMoney, isTerminal, serializeJsonLd, stripHtml, themeToCssVars, useAccount, useCart, useCheckout, useCustomerSubscription, useCustomerSubscriptions, useI18n, useMagicLinkVerify, useOrderStatus, usePayment, useStorefront, useStorefrontOptional, useT };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as React from 'react';
-import { StorefrontClient, Money, Product, ProductMedia, ProductVariant, CollectionDetail, ProductSort, Cart, AddLineInput, CartLine, Checkout, CreateCheckoutInput, SetAddressInput, ShippingQuote, PaymentMethod, OrderStatus, PaymentState, OrderPhase, PaymentInstructions, Customer, MagicLinkResult, ReorderResult } from '@nevios/storefront-js';
+import * as _nevios_storefront_js from '@nevios/storefront-js';
+import { StorefrontClient, Money, Product, ProductMedia, ProductVariant, CollectionDetail, ProductSort, SubscriptionPlan, Cart, AddLineInput, UpdateCartLineInput, CartLine, SubscriptionSelection, SubscriptionQuote, Checkout, CreateCheckoutInput, SetAddressInput, ShippingQuote, PaymentMethod, SubscriptionAcceptance, SubscriptionEnrollmentResult, SubscriptionPayment, OrderStatus, PaymentState, OrderPhase, PaymentInstructions, Customer, MagicLinkResult, ReorderResult, SubscriptionDetails, Subscription } from '@nevios/storefront-js';
 
 /**
  * NeviosProvider — puts a configured storefront client on React context so
@@ -71,6 +72,16 @@ declare function ThemeProvider({ theme, children, as: Tag, }: ThemeProviderProps
  * provider picks the category for the active locale via `Intl.PluralRules`.
  */
 declare const en: {
+    "subscriptions.purchaseOption": string;
+    "subscriptions.empty": string;
+    "subscriptions.status.active": string;
+    "subscriptions.status.paused": string;
+    "subscriptions.status.pending": string;
+    "subscriptions.status.cancelled": string;
+    "subscriptions.title": string;
+    "subscriptions.consent": string;
+    "subscriptions.eachDelivery": string;
+    "subscriptions.once": string;
     "common.free": string;
     "common.close": string;
     "common.loadingShort": string;
@@ -510,6 +521,16 @@ interface TagFilterProps {
 /** Toggleable tag chips. Multi-select; emits the selected list. */
 declare function TagFilter({ tags, selected, onChange }: TagFilterProps): React.ReactElement | null;
 
+/** Controlled PDP selector. Pass value to AddToCart.subscriptionPlanId.
+ * Plans and prices must come from client.subscriptions.plans(variantId). */
+declare function PurchaseOptions({ plans, value, onChange, disabled, locale }: {
+    plans: SubscriptionPlan[];
+    value: string | null;
+    onChange(planId: string | null): void;
+    disabled?: boolean;
+    locale?: string;
+}): React.ReactElement;
+
 /**
  * CartProvider + useCart — shared cart state for the whole app. The drawer, the
  * PDP add-to-cart, and a header cart count all read the same cart and re-render
@@ -527,8 +548,9 @@ interface CartState {
     loading: boolean;
     itemCount: number;
     addLine(input: AddLineInput): Promise<Cart>;
-    updateLine(lineId: string, quantity: number): Promise<Cart>;
+    updateLine(lineId: string, quantity: number | UpdateCartLineInput): Promise<Cart>;
     removeLine(lineId: string): Promise<Cart>;
+    clearSubscription(): Promise<Cart>;
     /** Re-fetch the cart from the server. */
     refresh(): Promise<void>;
 }
@@ -547,11 +569,12 @@ declare function useCart(): CartState;
 interface AddToCartProps {
     variant: ProductVariant | null;
     quantity?: number;
+    subscriptionPlanId?: string | null;
     /** Button label. Defaults to "Add to cart". */
     children?: React.ReactNode;
     onAdded?: () => void;
 }
-declare function AddToCart({ variant, quantity, children, onAdded, }: AddToCartProps): React.ReactElement;
+declare function AddToCart({ variant, quantity, subscriptionPlanId, children, onAdded, }: AddToCartProps): React.ReactElement;
 
 /**
  * CartLineItem — one cart row: thumbnail, title + variant, a quantity stepper,
@@ -615,8 +638,16 @@ type PayResult = {
 } | {
     kind: "order";
     checkout: Checkout;
+} | {
+    kind: "subscription";
+    subscription: SubscriptionEnrollmentResult;
+} | {
+    kind: "subscription_payment";
+    payment: SubscriptionPayment;
 };
 interface PayOptions {
+    /** Explicit acceptance of the currently displayed recurring quote. */
+    subscription?: SubscriptionAcceptance;
     /** Where the gateway returns the customer after paying. */
     returnUrl?: string;
     /** Where the gateway returns the customer on cancel. */
@@ -629,6 +660,9 @@ interface PayOptions {
     redirect?: boolean;
 }
 interface CheckoutState {
+    selectSubscription(selection: SubscriptionSelection): Promise<SubscriptionQuote>;
+    clearSubscription(): Promise<Checkout>;
+    reviewSubscription(): Promise<SubscriptionQuote>;
     checkout: Checkout | null;
     /** True while a checkout request is in flight. */
     loading: boolean;
@@ -678,6 +712,8 @@ declare function useCheckout(): CheckoutState;
 interface CheckoutFlowProps {
     /** If set and no checkout exists yet, create one from this cart token. */
     cartToken?: string;
+    /** Confirm with Stripe.js, then the flow refreshes the server payment state. */
+    onSubscriptionPayment?: (payment: SubscriptionPayment) => void | Promise<void>;
     /** Called when a (non-gateway) order is placed. Gateway flows redirect away
      *  before this fires. */
     onOrderPlaced?: (checkout: Checkout) => void;
@@ -690,7 +726,7 @@ interface CheckoutFlowProps {
     cancelUrl?: string;
     locale?: string;
 }
-declare function CheckoutFlow({ cartToken, onOrderPlaced, emptyState, renderConfirmation, returnUrl, cancelUrl, locale, }: CheckoutFlowProps): React.ReactElement;
+declare function CheckoutFlow({ cartToken, onSubscriptionPayment, onOrderPlaced, emptyState, renderConfirmation, returnUrl, cancelUrl, locale, }: CheckoutFlowProps): React.ReactElement;
 
 /**
  * AddressForm — collects email + shipping address (the checkout's first step).
@@ -731,7 +767,7 @@ declare function ShippingPicker({ title, submitLabel, onComplete, locale, }: Shi
  * one, and places the order. The category drives the final action:
  *   • gateway        → `pay()` starts the payment and redirects to the gateway
  *   • cod/bank/manual → `pay()` completes the order directly → `onOrderPlaced`
- * The storefront never embeds a gateway — paying a card means a redirect.
+ * Recurring Stripe payments use the merchant's Stripe.js callback.
  */
 
 interface PaymentSectionProps {
@@ -743,8 +779,10 @@ interface PaymentSectionProps {
     /** Called when a non-gateway order is placed (gateway flows redirect away). */
     onOrderPlaced?: (checkout: Checkout) => void;
     locale?: string;
+    /** Confirm the returned intent using your Stripe.js Payment Element. */
+    onSubscriptionPayment?: (payment: SubscriptionPayment) => void | Promise<void>;
 }
-declare function PaymentSection({ title, returnUrl, cancelUrl, onOrderPlaced, locale, }: PaymentSectionProps): React.ReactElement;
+declare function PaymentSection({ title, returnUrl, cancelUrl, onOrderPlaced, locale, onSubscriptionPayment, }: PaymentSectionProps): React.ReactElement;
 
 /**
  * OrderSummary — the checkout's running total: line items + the full breakdown
@@ -761,6 +799,14 @@ interface OrderSummaryProps {
 }
 declare function OrderSummary({ checkout: override, totalsOnly, locale, }: OrderSummaryProps): React.ReactElement | null;
 
+/** Displays the exact server quote. Never pre-check consent or calculate a discount. */
+declare function SubscriptionTerms({ quote, checked, onChange, locale }: {
+    quote: SubscriptionQuote;
+    checked: boolean;
+    onChange(checked: boolean): void;
+    locale?: string;
+}): React.ReactElement;
+
 interface OrderStatusState {
     order: OrderStatus | null;
     loading: boolean;
@@ -1051,6 +1097,68 @@ declare function ProfileEditor(): React.ReactElement | null;
 /** Email verification, session revocation and explicit account-closure confirmation. */
 declare function AccountSecurity(): React.ReactElement | null;
 
+/** Customer-only API plus reload-safe query state. Changing a saved account
+ * address never silently changes a recurring contract; preview/commit explicitly. */
+declare function useCustomerSubscriptions(): {
+    subscriptions: Subscription[];
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    api: {
+        plans(variantId: string, marketId?: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionPlan[]>;
+        select(checkoutToken: string, selection: _nevios_storefront_js.SubscriptionSelection, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionQuote>;
+        clear(checkoutToken: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<void>;
+        enroll(checkoutToken: string, selection: _nevios_storefront_js.SubscriptionEnrollment, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionEnrollmentResult>;
+        checkoutPayment(checkoutToken: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionPayment>;
+        list(opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription[]>;
+        get(id: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription>;
+        management(id: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<SubscriptionDetails>;
+        command: (id: string, body: _nevios_storefront_js.SubscriptionCommand, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        pause: (id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        resume: (id: string, expectedVersion: number, nextAt: string, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        skipNext: (id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        cancel: (id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        payment(id: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionPayment>;
+        previewChanges(id: string, changes: _nevios_storefront_js.SubscriptionChanges, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionChangeQuote>;
+        commitChanges(id: string, changes: _nevios_storefront_js.SubscriptionChanges, quote: _nevios_storefront_js.SubscriptionChangeQuote, consentEvidence: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription>;
+        confirmCard(id: string, setupIntentId: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription>;
+        replaceCard(id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionCardSetup>;
+    };
+};
+/** Unified upcoming/history/items view. Async results never survive a logout or
+ * switching customer/contract. Call refresh after an explicitly reviewed change. */
+declare function useCustomerSubscription(id: string | null): {
+    subscription: SubscriptionDetails | null;
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    api: {
+        plans(variantId: string, marketId?: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionPlan[]>;
+        select(checkoutToken: string, selection: _nevios_storefront_js.SubscriptionSelection, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionQuote>;
+        clear(checkoutToken: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<void>;
+        enroll(checkoutToken: string, selection: _nevios_storefront_js.SubscriptionEnrollment, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionEnrollmentResult>;
+        checkoutPayment(checkoutToken: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionPayment>;
+        list(opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription[]>;
+        get(id: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription>;
+        management(id: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<SubscriptionDetails>;
+        command: (id: string, body: _nevios_storefront_js.SubscriptionCommand, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        pause: (id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        resume: (id: string, expectedVersion: number, nextAt: string, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        skipNext: (id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        cancel: (id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions) => Promise<Subscription>;
+        payment(id: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionPayment>;
+        previewChanges(id: string, changes: _nevios_storefront_js.SubscriptionChanges, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionChangeQuote>;
+        commitChanges(id: string, changes: _nevios_storefront_js.SubscriptionChanges, quote: _nevios_storefront_js.SubscriptionChangeQuote, consentEvidence: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription>;
+        confirmCard(id: string, setupIntentId: string, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<Subscription>;
+        replaceCard(id: string, expectedVersion: number, opts?: _nevios_storefront_js.SubscriptionCallOptions): Promise<_nevios_storefront_js.SubscriptionCardSetup>;
+    };
+};
+
+declare function SubscriptionList({ href, locale }: {
+    href(id: string): string;
+    locale?: string;
+}): React.ReactElement;
+
 /**
  * ProductJsonLd — schema.org/Product structured data for rich results (price,
  * availability, brand). Drop it in the PDP <head> (or anywhere; it's a script).
@@ -1127,4 +1235,4 @@ interface JsonLdProps {
 /** Render a JSON-LD `<script>` for the given (already-shaped) data object. */
 declare function JsonLd({ data }: JsonLdProps): React.ReactElement;
 
-export { AccountDashboard, type AccountDashboardProps, AccountProvider, AccountSecurity, type AccountState, AddToCart, type AddToCartProps, AddressBook, AddressForm, type AddressFormProps, AvailabilityFilter, type AvailabilityFilterProps, BackInStockForm, type BackInStockFormProps, type BreadcrumbItem, BreadcrumbJsonLd, type BreadcrumbJsonLdProps, CartDrawer, type CartDrawerProps, CartLineItem, type CartLineItemProps, CartProvider, type CartState, CartSummary, type CartSummaryProps, CheckoutFlow, type CheckoutFlowProps, CheckoutProvider, type CheckoutState, CollectionPage, type CollectionPageProps, I18nProvider, type I18nProviderProps, type I18nValue, JsonLd, type JsonLdProps, LoginForm, type LoginFormProps, type MarketOption, MarketSwitcher, type MarketSwitcherProps, type MessageKey, type Messages, NeviosProvider, type NeviosProviderProps, OrderConfirmation, type OrderConfirmationProps, OrderHistory, type OrderHistoryProps, OrderLines, OrderStatusPage, type OrderStatusPageProps, type OrderStatusState, OrderSummary, type OrderSummaryProps, OrderTotals, OrganizationJsonLd, type OrganizationJsonLdProps, type PayOptions, type PayResult, PaymentMethodPicker, type PaymentMethodPickerProps, PaymentPage, type PaymentPageProps, type PaymentPageState, PaymentSection, type PaymentSectionProps, PhaseTimeline, PriceMoney, type PriceMoneyProps, PriceRangeFilter, type PriceRangeFilterProps, ProductCard, type ProductCardProps, ProductDetailPage, type ProductDetailPageProps, ProductGallery, type ProductGalleryProps, ProductJsonLd, type ProductJsonLdProps, ProfileEditor, ShippingPicker, type ShippingPickerProps, SortSelect, type SortSelectProps, StatusBanner, StockBadge, type StockBadgeProps, type StorefrontTheme, type TFunction, type TVars, TagFilter, type TagFilterProps, ThemeProvider, type ThemeProviderProps, TransferInstructions, type TransferInstructionsProps, VariantPicker, type VariantPickerProps, type VerifyStatus, absoluteUrl, bundledMessages, cs, en, formatCents, formatMoney, isTerminal, serializeJsonLd, stripHtml, themeToCssVars, useAccount, useCart, useCheckout, useI18n, useMagicLinkVerify, useOrderStatus, usePayment, useStorefront, useStorefrontOptional, useT };
+export { AccountDashboard, type AccountDashboardProps, AccountProvider, AccountSecurity, type AccountState, AddToCart, type AddToCartProps, AddressBook, AddressForm, type AddressFormProps, AvailabilityFilter, type AvailabilityFilterProps, BackInStockForm, type BackInStockFormProps, type BreadcrumbItem, BreadcrumbJsonLd, type BreadcrumbJsonLdProps, CartDrawer, type CartDrawerProps, CartLineItem, type CartLineItemProps, CartProvider, type CartState, CartSummary, type CartSummaryProps, CheckoutFlow, type CheckoutFlowProps, CheckoutProvider, type CheckoutState, CollectionPage, type CollectionPageProps, I18nProvider, type I18nProviderProps, type I18nValue, JsonLd, type JsonLdProps, LoginForm, type LoginFormProps, type MarketOption, MarketSwitcher, type MarketSwitcherProps, type MessageKey, type Messages, NeviosProvider, type NeviosProviderProps, OrderConfirmation, type OrderConfirmationProps, OrderHistory, type OrderHistoryProps, OrderLines, OrderStatusPage, type OrderStatusPageProps, type OrderStatusState, OrderSummary, type OrderSummaryProps, OrderTotals, OrganizationJsonLd, type OrganizationJsonLdProps, type PayOptions, type PayResult, PaymentMethodPicker, type PaymentMethodPickerProps, PaymentPage, type PaymentPageProps, type PaymentPageState, PaymentSection, type PaymentSectionProps, PhaseTimeline, PriceMoney, type PriceMoneyProps, PriceRangeFilter, type PriceRangeFilterProps, ProductCard, type ProductCardProps, ProductDetailPage, type ProductDetailPageProps, ProductGallery, type ProductGalleryProps, ProductJsonLd, type ProductJsonLdProps, ProfileEditor, PurchaseOptions, ShippingPicker, type ShippingPickerProps, SortSelect, type SortSelectProps, StatusBanner, StockBadge, type StockBadgeProps, type StorefrontTheme, SubscriptionList, SubscriptionTerms, type TFunction, type TVars, TagFilter, type TagFilterProps, ThemeProvider, type ThemeProviderProps, TransferInstructions, type TransferInstructionsProps, VariantPicker, type VariantPickerProps, type VerifyStatus, absoluteUrl, bundledMessages, cs, en, formatCents, formatMoney, isTerminal, serializeJsonLd, stripHtml, themeToCssVars, useAccount, useCart, useCheckout, useCustomerSubscription, useCustomerSubscriptions, useI18n, useMagicLinkVerify, useOrderStatus, usePayment, useStorefront, useStorefrontOptional, useT };