@solvapay/react 1.0.0-preview.19 → 1.0.0-preview.20

package/dist/index.d.ts

@@ -8,22 +8,35 @@ export { defaultAuthAdapter } from './adapters/auth.js';
  * TypeScript type definitions for @solvapay/react
  */
 
-interface SubscriptionInfo {
+interface PurchaseInfo {
     reference: string;
+    productName: string;
+    productReference: string;
     planName: string;
-    agentName: string;
     status: string;
     startDate: string;
     endDate?: string;
     cancelledAt?: string;
     cancellationReason?: string;
     amount?: number;
+    currency?: string;
+    planType?: string;
+    isRecurring?: boolean;
+    nextBillingDate?: string;
+    billingCycle?: string;
+    transactionId?: string;
+    usage?: {
+        used: number;
+        quota: number | null;
+        unit: string;
+        remaining: number | null;
+    };
 }
-interface CustomerSubscriptionData {
+interface CustomerPurchaseData {
     customerRef?: string;
     email?: string;
     name?: string;
-    subscriptions: SubscriptionInfo[];
+    purchases: PurchaseInfo[];
 }
 interface PaymentIntentResult {
     clientSecret: string;
@@ -31,31 +44,31 @@ interface PaymentIntentResult {
     accountId?: string;
     customerRef?: string;
 }
-interface SubscriptionStatus {
+interface PurchaseStatus {
     loading: boolean;
     customerRef?: string;
     email?: string;
     name?: string;
-    subscriptions: SubscriptionInfo[];
+    purchases: PurchaseInfo[];
     hasPlan: (planName: string) => boolean;
     /**
-     * Primary active subscription (paid or free) - most recent subscription with status === 'active'
-     * Backend keeps subscriptions as 'active' until expiration, even when cancelled.
-     * null if no active subscription exists
+     * Primary active purchase (paid or free) - most recent purchase with status === 'active'
+     * Backend keeps purchases as 'active' until expiration, even when cancelled.
+     * null if no active purchase exists
      */
-    activeSubscription: SubscriptionInfo | null;
+    activePurchase: PurchaseInfo | null;
     /**
-     * Check if user has any active paid subscription (amount > 0)
-     * Checks subscriptions with status === 'active'.
-     * Backend keeps subscriptions as 'active' until expiration, even when cancelled.
+     * Check if user has any active paid purchase (amount > 0)
+     * Checks purchases with status === 'active'.
+     * Backend keeps purchases as 'active' until expiration, even when cancelled.
      */
-    hasPaidSubscription: boolean;
+    hasPaidPurchase: boolean;
     /**
-     * Most recent active paid subscription (sorted by startDate)
-     * Returns subscription with status === 'active' and amount > 0.
-     * null if no active paid subscription exists
+     * Most recent active paid purchase (sorted by startDate)
+     * Returns purchase with status === 'active' and amount > 0.
+     * null if no active paid purchase exists
      */
-    activePaidSubscription: SubscriptionInfo | null;
+    activePaidPurchase: PurchaseInfo | null;
 }
 /**
  * SolvaPay Provider Configuration
@@ -67,7 +80,7 @@ interface SolvaPayConfig {
      * Defaults to standard Next.js API routes
      */
     api?: {
-        checkSubscription?: string;
+        checkPurchase?: string;
         createPayment?: string;
         processPayment?: string;
     };
@@ -125,15 +138,15 @@ interface SolvaPayConfig {
     onError?: (error: Error, context: string) => void;
 }
 interface SolvaPayContextValue {
-    subscription: SubscriptionStatus;
-    refetchSubscription: () => Promise<void>;
+    purchase: PurchaseStatus;
+    refetchPurchase: () => Promise<void>;
     createPayment: (params: {
         planRef: string;
-        agentRef?: string;
+        productRef?: string;
     }) => Promise<PaymentIntentResult>;
     processPayment?: (params: {
         paymentIntentId: string;
-        agentRef: string;
+        productRef: string;
         planRef?: string;
     }) => Promise<ProcessPaymentResult>;
     customerRef?: string;
@@ -151,33 +164,34 @@ interface SolvaPayProviderProps {
      */
     createPayment?: (params: {
         planRef: string;
-        agentRef?: string;
+        productRef?: string;
     }) => Promise<PaymentIntentResult>;
-    checkSubscription?: () => Promise<CustomerSubscriptionData>;
+    checkPurchase?: () => Promise<CustomerPurchaseData>;
     processPayment?: (params: {
         paymentIntentId: string;
-        agentRef: string;
+        productRef: string;
         planRef?: string;
     }) => Promise<ProcessPaymentResult>;
     children: React.ReactNode;
 }
 interface PlanBadgeProps {
     children?: (props: {
-        subscriptions: SubscriptionInfo[];
+        purchases: PurchaseInfo[];
         loading: boolean;
         displayPlan: string | null;
         shouldShow: boolean;
     }) => React.ReactNode;
     as?: React.ElementType;
     className?: string | ((props: {
-        subscriptions: SubscriptionInfo[];
+        purchases: PurchaseInfo[];
     }) => string);
 }
-interface SubscriptionGateProps {
+interface PurchaseGateProps {
     requirePlan?: string;
+    requireProduct?: string;
     children: (props: {
         hasAccess: boolean;
-        subscriptions: SubscriptionInfo[];
+        purchases: PurchaseInfo[];
         loading: boolean;
     }) => React.ReactNode;
 }
@@ -189,7 +203,7 @@ interface PaymentError extends Error {
     type?: string;
 }
 /**
- * Plan interface for subscription plans
+ * Plan interface for plans
  */
 interface Plan {
     reference: string;
@@ -209,11 +223,11 @@ interface UsePlansOptions {
     /**
      * Fetcher function to retrieve plans
      */
-    fetcher: (agentRef: string) => Promise<Plan[]>;
+    fetcher: (productRef: string) => Promise<Plan[]>;
     /**
-     * Agent reference to fetch plans for
+     * Product reference to fetch plans for
      */
-    agentRef?: string;
+    productRef?: string;
     /**
      * Optional filter function to filter plans
      */
@@ -245,13 +259,13 @@ interface UsePlansReturn {
  */
 interface PlanSelectorProps {
     /**
-     * Agent reference to fetch plans for
+     * Product reference to fetch plans for
      */
-    agentRef?: string;
+    productRef?: string;
     /**
      * Fetcher function to retrieve plans
      */
-    fetcher: (agentRef: string) => Promise<Plan[]>;
+    fetcher: (productRef: string) => Promise<Plan[]>;
     /**
      * Optional filter function
      */
@@ -268,27 +282,27 @@ interface PlanSelectorProps {
      * Render prop function
      */
     children: (props: UsePlansReturn & {
-        subscriptions: SubscriptionInfo[];
+        purchases: PurchaseInfo[];
         isPaidPlan: (planName: string) => boolean;
         isCurrentPlan: (planName: string) => boolean;
     }) => React.ReactNode;
 }
 /**
- * Return type for useSubscriptionStatus hook
+ * Return type for usePurchaseStatus hook
  *
- * Provides advanced subscription status helpers and utilities.
- * Focuses on cancelled subscription logic and date formatting.
- * For basic subscription data and paid status, use useSubscription() instead.
+ * Provides advanced purchase status helpers and utilities.
+ * Focuses on cancelled purchase logic and date formatting.
+ * For basic purchase data and paid status, use usePurchase() instead.
  */
-interface SubscriptionStatusReturn {
+interface PurchaseStatusReturn {
     /**
-     * Most recent cancelled paid subscription (sorted by startDate)
-     * null if no cancelled paid subscription exists
+     * Most recent cancelled paid purchase (sorted by startDate)
+     * null if no cancelled paid purchase exists
      */
-    cancelledSubscription: SubscriptionInfo | null;
+    cancelledPurchase: PurchaseInfo | null;
     /**
-     * Whether to show cancelled subscription notice
-     * true if cancelledSubscription exists
+     * Whether to show cancelled purchase notice
+     * true if cancelledPurchase exists
      */
     shouldShowCancelledNotice: boolean;
     /**
@@ -312,9 +326,9 @@ interface PaymentFormProps {
      */
     planRef: string;
     /**
-     * Agent reference. Required for processing payment after confirmation.
+     * Product reference. Required for processing payment after confirmation.
      */
-    agentRef?: string;
+    productRef?: string;
     /**
      * Callback when payment succeeds
      */
@@ -340,16 +354,17 @@ interface PaymentFormProps {
      */
     buttonClassName?: string;
 }
+type PurchaseStatusValue = 'pending' | 'active' | 'trialing' | 'past_due' | 'cancelled' | 'expired' | 'suspended' | 'refunded';
 
 /**
  * SolvaPay Provider - Headless Context Provider for React.
  *
- * Provides subscription state, payment methods, and customer data to child components
+ * Provides purchase state, payment methods, and customer data to child components
  * via React Context. This is the root component that must wrap your app to use
  * SolvaPay React hooks and components.
  *
  * Features:
- * - Automatic subscription status checking
+ * - Automatic purchase status checking
  * - Customer reference caching in localStorage
  * - Payment intent creation and processing
  * - Authentication adapter support (Supabase, custom, etc.)
@@ -358,7 +373,7 @@ interface PaymentFormProps {
  * @param props - Provider configuration
  * @param props.config - Configuration object for API routes and authentication
  * @param props.config.api - API route configuration (optional, uses defaults if not provided)
- * @param props.config.api.checkSubscription - Endpoint for checking subscription status (default: '/api/check-subscription')
+ * @param props.config.api.checkPurchase - Endpoint for checking purchase status (default: '/api/check-purchase')
  * @param props.config.api.createPayment - Endpoint for creating payment intents (default: '/api/create-payment-intent')
  * @param props.config.api.processPayment - Endpoint for processing payments (default: '/api/process-payment')
  * @param props.config.auth - Authentication configuration (optional)
@@ -384,7 +399,7 @@ interface PaymentFormProps {
  *     <SolvaPayProvider
  *       config={{
  *         api: {
- *           checkSubscription: '/custom/api/subscription',
+ *           checkPurchase: '/custom/api/purchase',
  *           createPayment: '/custom/api/payment'
  *         }
  *       }}
@@ -415,7 +430,7 @@ interface PaymentFormProps {
  * }
  * ```
  *
- * @see {@link useSubscription} for accessing subscription data
+ * @see {@link usePurchase} for accessing purchase data
  * @see {@link useCheckout} for payment checkout flow
  * @see {@link useSolvaPay} for accessing provider methods
  * @since 1.0.0
@@ -434,11 +449,11 @@ declare const SolvaPayProvider: React$1.FC<SolvaPayProviderProps>;
  * - Payment intent creation on mount
  * - Card input and validation
  * - Payment processing with error handling
- * - Automatic subscription refresh after payment
+ * - Automatic purchase refresh after payment
  *
  * @param props - Payment form configuration
- * @param props.planRef - Plan reference to subscribe to (required)
- * @param props.agentRef - Agent reference for usage tracking (required)
+ * @param props.planRef - Plan reference to purchase (required)
+ * @param props.productRef - Product reference for usage tracking
  * @param props.onSuccess - Callback when payment succeeds
  * @param props.onError - Callback when payment fails
  * @param props.returnUrl - Optional return URL after payment (for redirects)
@@ -457,7 +472,7 @@ declare const SolvaPayProvider: React$1.FC<SolvaPayProviderProps>;
  *   return (
  *     <PaymentForm
  *       planRef="pln_premium"
- *       agentRef="agt_myapi"
+ *       productRef="prd_myapi"
  *       onSuccess={() => {
  *         console.log('Payment successful!');
  *         router.push('/dashboard');
@@ -479,20 +494,20 @@ declare const PaymentForm: React$1.FC<PaymentFormProps>;
 /**
  * Headless Plan Badge Component
  *
- * Displays subscription status with complete styling control.
+ * Displays purchase status with complete styling control.
  * Supports render props, custom components, or className patterns.
  *
- * Prevents flickering by hiding the badge during initial load and when no subscription exists.
- * Shows the badge once loading completes AND an active subscription exists (paid or free).
+ * Prevents flickering by hiding the badge during initial load and when no purchase exists.
+ * Shows the badge once loading completes AND an active purchase exists (paid or free).
  * Badge only updates when the plan name actually changes (prevents unnecessary re-renders).
  *
- * Displays the primary active subscription (paid or free) to show current plan status.
+ * Displays the primary active purchase (paid or free) to show current plan status.
  *
  * @example
  * ```tsx
  * // Render prop pattern
  * <PlanBadge>
- *   {({ subscriptions, loading, displayPlan, shouldShow }) => (
+ *   {({ purchases, loading, displayPlan, shouldShow }) => (
  *     shouldShow ? (
  *       <div>{displayPlan}</div>
  *     ) : null
@@ -506,42 +521,42 @@ declare const PaymentForm: React$1.FC<PaymentFormProps>;
 declare const PlanBadge: React$1.FC<PlanBadgeProps>;
 
 /**
- * Headless Subscription Gate Component
+ * Headless Purchase Gate Component
  *
- * Controls access to content based on subscription status.
+ * Controls access to content based on purchase status.
  * Uses render props to give developers full control over locked/unlocked states.
  *
  * @example
  * ```tsx
- * <SubscriptionGate requirePlan="Pro Plan">
+ * <PurchaseGate requirePlan="Pro Plan">
  *   {({ hasAccess, loading }) => {
  *     if (loading) return <Skeleton />;
  *     if (!hasAccess) return <Paywall />;
  *     return <PremiumContent />;
  *   }}
- * </SubscriptionGate>
+ * </PurchaseGate>
  * ```
  */
-declare const SubscriptionGate: React$1.FC<SubscriptionGateProps>;
+declare const PurchaseGate: React$1.FC<PurchaseGateProps>;
 
 /**
  * Headless Plan Selector Component
  *
  * Provides plan selection logic with complete styling control via render props.
- * Integrates plan fetching, subscription status, and selection state management.
+ * Integrates plan fetching, purchase status, and selection state management.
  *
  * Features:
  * - Fetches and manages plans
  * - Tracks selected plan
  * - Provides helpers for checking if plan is current/paid
- * - Integrates with subscription context
+ * - Integrates with purchase context
  *
  * @example
  * ```tsx
  * <PlanSelector
- *   agentRef="agent_123"
- *   fetcher={async (agentRef) => {
- *     const res = await fetch(`/api/list-plans?agentRef=${agentRef}`);
+ *   productRef="prd_123"
+ *   fetcher={async (productRef) => {
+ *     const res = await fetch(`/api/list-plans?productRef=${productRef}`);
  *     const data = await res.json();
  *     return data.plans;
  *   }}
@@ -596,36 +611,36 @@ interface StripePaymentFormWrapperProps {
 declare const StripePaymentFormWrapper: React$1.FC<StripePaymentFormWrapperProps>;
 
 /**
- * Hook to get current subscription status and information.
+ * Hook to get current purchase status and information.
  *
- * Returns the current user's subscription status, including active
- * subscriptions, plan details, and payment information. Automatically
+ * Returns the current user's purchase status, including active
+ * purchases, plan details, and payment information. Automatically
  * syncs with the SolvaPay backend and handles loading and error states.
  *
- * @returns Subscription data and status
- * @returns subscriptions - Array of active subscriptions
- * @returns hasPaidSubscription - Whether user has any paid subscription
+ * @returns Purchase data and status
+ * @returns purchases - Array of active purchases
+ * @returns hasPaidPurchase - Whether user has any paid purchase
  * @returns isLoading - Loading state
- * @returns error - Error state if subscription check fails
- * @returns refetch - Function to manually refetch subscription data
+ * @returns error - Error state if purchase check fails
+ * @returns refetch - Function to manually refetch purchase data
  *
  * @example
  * ```tsx
- * import { useSubscription } from '@solvapay/react';
+ * import { usePurchase } from '@solvapay/react';
  *
  * function Dashboard() {
- *   const { subscriptions, hasPaidSubscription, isLoading, refetch } = useSubscription();
+ *   const { purchases, hasPaidPurchase, isLoading, refetch } = usePurchase();
  *
  *   if (isLoading) return <Spinner />;
  *
- *   if (!hasPaidSubscription) {
+ *   if (!hasPaidPurchase) {
  *     return <UpgradePrompt />;
  *   }
  *
  *   return (
  *     <div>
  *       <h2>Welcome, Premium User!</h2>
- *       <p>Active subscriptions: {subscriptions.length}</p>
+ *       <p>Active purchases: {purchases.length}</p>
  *       <button onClick={() => refetch()}>Refresh</button>
  *     </div>
  *   );
@@ -633,10 +648,10 @@ declare const StripePaymentFormWrapper: React$1.FC<StripePaymentFormWrapperProps
  * ```
  *
  * @see {@link SolvaPayProvider} for required context provider
- * @see {@link useSubscriptionStatus} for detailed status information
+ * @see {@link usePurchaseStatus} for detailed status information
  * @since 1.0.0
  */
-declare function useSubscription(): SubscriptionStatus & {
+declare function usePurchase(): PurchaseStatus & {
     refetch: () => Promise<void>;
 };
 
@@ -663,7 +678,7 @@ interface CustomerInfo {
 }
 /**
  * Hook to access customer information
- * Returns customer data (email, name, customerRef) separate from subscription data
+ * Returns customer data (email, name, customerRef) separate from purchase data
  *
  * @example
  * ```tsx
@@ -698,8 +713,9 @@ interface UseCheckoutReturn {
  * manages the checkout state including loading, errors, Stripe instance,
  * and client secret. Use this for programmatic checkout flows.
  *
- * @param planRef - Plan reference to subscribe to (required)
- * @param agentRef - Optional agent reference for usage tracking
+ * @param options - Checkout options
+ * @param options.planRef - Plan reference to purchase (required)
+ * @param options.productRef - Optional product reference for usage tracking
  * @returns Checkout state and methods
  * @returns loading - Whether checkout is in progress
  * @returns error - Error state if checkout fails
@@ -714,10 +730,10 @@ interface UseCheckoutReturn {
  * import { PaymentElement } from '@stripe/react-stripe-js';
  *
  * function CustomCheckout() {
- *   const { loading, error, stripePromise, clientSecret, startCheckout } = useCheckout(
- *     'pln_premium',
- *     'agt_myapi'
- *   );
+ *   const { loading, error, stripePromise, clientSecret, startCheckout } = useCheckout({
+ *     planRef: 'pln_premium',
+ *     productRef: 'prd_myapi',
+ *   });
  *
  *   useEffect(() => {
  *     startCheckout();
@@ -739,46 +755,49 @@ interface UseCheckoutReturn {
  * @see {@link SolvaPayProvider} for required context provider
  * @since 1.0.0
  */
-declare function useCheckout(planRef: string, agentRef?: string): UseCheckoutReturn;
+declare function useCheckout(options: {
+    planRef: string;
+    productRef?: string;
+}): UseCheckoutReturn;
 
 /**
  * Hook to access SolvaPay context and provider methods.
  *
  * This is the base hook that provides access to all SolvaPay functionality
- * including subscription data, payment methods, and customer information.
- * Other hooks like `useSubscription` and `useCheckout` use this internally.
+ * including purchase data, payment methods, and customer information.
+ * Other hooks like `usePurchase` and `useCheckout` use this internally.
  *
  * Must be used within a `SolvaPayProvider` component.
  *
  * @returns SolvaPay context value with all provider methods and state
- * @returns subscription - Subscription status and data
+ * @returns purchase - Purchase status and data
  * @returns createPayment - Function to create payment intents
  * @returns processPayment - Function to process payments
  * @returns customerRef - Current customer reference
- * @returns refetchSubscription - Function to refetch subscription data
+ * @returns refetchPurchase - Function to refetch purchase data
  *
  * @example
  * ```tsx
  * import { useSolvaPay } from '@solvapay/react';
  *
  * function CustomComponent() {
- *   const { subscription, createPayment, processPayment } = useSolvaPay();
+ *   const { purchase, createPayment, processPayment } = useSolvaPay();
  *
  *   const handlePayment = async () => {
  *     const intent = await createPayment({
  *       planRef: 'pln_premium',
- *       agentRef: 'agt_myapi'
+ *       productRef: 'prd_myapi'
  *     });
  *     // Process payment...
  *   };
  *
- *   return <div>Subscription status: {subscription.hasPaidSubscription ? 'Active' : 'None'}</div>;
+ *   return <div>Purchase status: {purchase.hasPaidPurchase ? 'Active' : 'None'}</div>;
  * }
  * ```
  *
  * @throws {Error} If used outside of SolvaPayProvider
  * @see {@link SolvaPayProvider} for required context provider
- * @see {@link useSubscription} for subscription-specific hook
+ * @see {@link usePurchase} for purchase-specific hook
  * @see {@link useCheckout} for checkout-specific hook
  * @since 1.0.0
  */
@@ -787,16 +806,16 @@ declare function useSolvaPay(): SolvaPayContextValue;
 /**
  * Hook to manage plan fetching and selection
  *
- * Provides a reusable way to fetch, filter, sort and select subscription plans.
+ * Provides a reusable way to fetch, filter, sort and select plans.
  * Handles loading and error states automatically.
- * Uses a global cache to prevent duplicate fetches when multiple components use the same agentRef.
+ * Uses a global cache to prevent duplicate fetches when multiple components use the same productRef.
  *
  * @example
  * ```tsx
  * const plans = usePlans({
- *   agentRef: 'agent_123',
- *   fetcher: async (agentRef) => {
- *     const res = await fetch(`/api/list-plans?agentRef=${agentRef}`);
+ *   productRef: 'prd_123',
+ *   fetcher: async (productRef) => {
+ *     const res = await fetch(`/api/list-plans?productRef=${productRef}`);
  *     const data = await res.json();
  *     return data.plans;
  *   },
@@ -812,78 +831,78 @@ declare function useSolvaPay(): SolvaPayContextValue;
 declare function usePlans(options: UsePlansOptions): UsePlansReturn;
 
 /**
- * Hook providing advanced status and helper functions for subscription management
+ * Hook providing advanced status and helper functions for purchase management
  *
- * Focuses on cancelled subscription logic and date formatting utilities.
- * For basic subscription data and paid status checks, use useSubscription() instead.
+ * Focuses on cancelled purchase logic and date formatting utilities.
+ * For basic purchase data and paid status checks, use usePurchase() instead.
  *
  * @example
  * ```tsx
- * const { cancelledSubscription, shouldShowCancelledNotice, formatDate, getDaysUntilExpiration } = useSubscriptionStatus();
+ * const { cancelledPurchase, shouldShowCancelledNotice, formatDate, getDaysUntilExpiration } = usePurchaseStatus();
  *
- * if (shouldShowCancelledNotice && cancelledSubscription) {
- *   const formattedDate = formatDate(cancelledSubscription.endDate);
- *   const daysLeft = getDaysUntilExpiration(cancelledSubscription.endDate);
+ * if (shouldShowCancelledNotice && cancelledPurchase) {
+ *   const formattedDate = formatDate(cancelledPurchase.endDate);
+ *   const daysLeft = getDaysUntilExpiration(cancelledPurchase.endDate);
  * }
  * ```
  */
-declare function useSubscriptionStatus(): SubscriptionStatusReturn;
+declare function usePurchaseStatus(): PurchaseStatusReturn;
 
 /**
- * Subscription utility functions
+ * Purchase utility functions
  *
- * Provides shared logic for filtering and prioritizing subscriptions
+ * Provides shared logic for filtering and prioritizing purchases
  */
 
 /**
- * Filter subscriptions to only include active ones
+ * Filter purchases to only include active ones
  *
  * Rules:
- * - Keep subscriptions with status === 'active'
- * - Filter out subscriptions with status === 'cancelled', 'expired', 'suspended', 'refunded', etc.
+ * - Keep purchases with status === 'active'
+ * - Filter out purchases with status === 'cancelled', 'expired', 'suspended', 'refunded', etc.
  *
- * Note: Backend now keeps subscriptions with status 'active' until expiration,
+ * Note: Backend now keeps purchases with status 'active' until expiration,
  * even when cancelled. Cancellation is tracked via cancelledAt field.
  */
-declare function filterSubscriptions(subscriptions: SubscriptionInfo[]): SubscriptionInfo[];
+declare function filterPurchases(purchases: PurchaseInfo[]): PurchaseInfo[];
 /**
- * Get active subscriptions
+ * Get active purchases
  *
- * Returns subscriptions with status === 'active'.
- * Note: Backend keeps subscriptions as 'active' until expiration, even when cancelled.
- * Use cancelledAt field to check if a subscription is cancelled.
+ * Returns purchases with status === 'active'.
+ * Note: Backend keeps purchases as 'active' until expiration, even when cancelled.
+ * Use cancelledAt field to check if a purchase is cancelled.
  */
-declare function getActiveSubscriptions(subscriptions: SubscriptionInfo[]): SubscriptionInfo[];
+declare function getActivePurchases(purchases: PurchaseInfo[]): PurchaseInfo[];
 /**
- * Get cancelled subscriptions with valid endDate (not expired)
+ * Get cancelled purchases with valid endDate (not expired)
  *
- * Returns subscriptions with cancelledAt set and status === 'active' that have a future endDate.
- * Backend keeps cancelled subscriptions as 'active' until expiration.
+ * Returns purchases with cancelledAt set and status === 'active' that have a future endDate.
+ * Backend keeps cancelled purchases as 'active' until expiration.
  */
-declare function getCancelledSubscriptionsWithEndDate(subscriptions: SubscriptionInfo[]): SubscriptionInfo[];
+declare function getCancelledPurchasesWithEndDate(purchases: PurchaseInfo[]): PurchaseInfo[];
 /**
- * Get the most recent subscription by startDate
+ * Get the most recent purchase by startDate
  */
-declare function getMostRecentSubscription(subscriptions: SubscriptionInfo[]): SubscriptionInfo | null;
+declare function getMostRecentPurchase(purchases: PurchaseInfo[]): PurchaseInfo | null;
 /**
- * Get the primary subscription to display
+ * Get the primary purchase to display
  *
  * Prioritization:
- * 1. Active subscriptions (most recent by startDate)
- * 2. null if no valid subscriptions
+ * 1. Active purchases (most recent by startDate)
+ * 2. null if no valid purchases
  *
- * Note: Backend keeps subscriptions as 'active' until expiration, so we only
- * need to check for active subscriptions. Cancelled subscriptions are still
+ * Note: Backend keeps purchases as 'active' until expiration, so we only
+ * need to check for active purchases. Cancelled purchases are still
  * active until their endDate.
  */
-declare function getPrimarySubscription(subscriptions: SubscriptionInfo[]): SubscriptionInfo | null;
+declare function getPrimaryPurchase(purchases: PurchaseInfo[]): PurchaseInfo | null;
 /**
- * Check if a subscription is paid
- * Uses subscription amount field: amount > 0 = paid, amount === 0 or undefined = free
+ * Check if a purchase is paid
+ * Uses purchase amount field: amount > 0 = paid, amount === 0 or undefined = free
  *
- * @param sub - Subscription to check
- * @returns true if subscription is paid (amount > 0)
+ * @param purchase - Purchase to check
+ * @returns true if purchase is paid (amount > 0)
  */
-declare function isPaidSubscription(sub: SubscriptionInfo): boolean;
+declare function isPaidPurchase(purchase: PurchaseInfo): boolean;
 
-export { AuthAdapter, type CustomerInfo, type CustomerSubscriptionData, type PaymentError, PaymentForm, type PaymentFormProps, type PaymentIntentResult, type Plan, PlanBadge, type PlanBadgeProps, PlanSelector, type PlanSelectorProps, type SolvaPayConfig, type SolvaPayContextValue, SolvaPayProvider, type SolvaPayProviderProps, Spinner, StripePaymentFormWrapper, SubscriptionGate, type SubscriptionGateProps, type SubscriptionInfo, type SubscriptionStatus, type SubscriptionStatusReturn, type UsePlansOptions, type UsePlansReturn, filterSubscriptions, getActiveSubscriptions, getCancelledSubscriptionsWithEndDate, getMostRecentSubscription, getPrimarySubscription, isPaidSubscription, useCheckout, useCustomer, usePlans, useSolvaPay, useSubscription, useSubscriptionStatus };
+export { AuthAdapter, type CustomerInfo, type CustomerPurchaseData, type PaymentError, PaymentForm, type PaymentFormProps, type PaymentIntentResult, type Plan, PlanBadge, type PlanBadgeProps, PlanSelector, type PlanSelectorProps, PurchaseGate, type PurchaseGateProps, type PurchaseInfo, type PurchaseStatus, type PurchaseStatusReturn, type PurchaseStatusValue, type SolvaPayConfig, type SolvaPayContextValue, SolvaPayProvider, type SolvaPayProviderProps, Spinner, StripePaymentFormWrapper, type UsePlansOptions, type UsePlansReturn, filterPurchases, getActivePurchases, getCancelledPurchasesWithEndDate, getMostRecentPurchase, getPrimaryPurchase, isPaidPurchase, useCheckout, useCustomer, usePlans, usePurchase, usePurchaseStatus, useSolvaPay };