@solvapay/react 1.0.8-preview.9 → 1.0.9

package/dist/CancelPlanButton-CieT9swn.d.cts

@@ -1,1102 +0,0 @@
-import React$1 from 'react';
-import { PaymentElement, CardElement } from '@stripe/react-stripe-js';
-import * as _stripe_stripe_js from '@stripe/stripe-js';
-import { PaymentIntent } from '@stripe/stripe-js';
-import { ActivatePlanResult, ProcessPaymentResult } from '@solvapay/server';
-import { AuthAdapter } from './adapters/auth.cjs';
-
-/**
- * Typed copy bundle surfaced through `<SolvaPayProvider config={{ copy }} />`.
- *
- * Every user-visible string in `@solvapay/react` routes through this bundle via
- * `useCopy()`. Values are either plain templates with `{placeholder}` tokens or
- * function-form resolvers (currently only used for mandate variants) that
- * receive a `MandateContext` and return the final string.
- */
-type MandateContext = {
-    merchant: {
-        legalName: string;
-        displayName?: string;
-        supportEmail?: string;
-        termsUrl?: string;
-        privacyUrl?: string;
-    };
-    plan?: {
-        name?: string;
-        interval?: string;
-        intervalCount?: number;
-        trialDays?: number;
-        measures?: string;
-        billingCycle?: string;
-    };
-    product?: {
-        name?: string;
-    };
-    amountFormatted: string;
-    trialDays?: number;
-};
-type MandateTemplate = string | ((ctx: MandateContext) => string);
-interface SolvaPayCopy {
-    mandate: {
-        recurring: MandateTemplate;
-        oneTime: MandateTemplate;
-        topup: MandateTemplate;
-        usageMetered: MandateTemplate;
-        freeTier: MandateTemplate;
-    };
-    cta: {
-        payNow: string;
-        topUp: string;
-        subscribe: string;
-        trialStart: string;
-        payAmount: string;
-        addAmount: string;
-        startUsing: string;
-        processing: string;
-    };
-    interval: {
-        day: string;
-        week: string;
-        month: string;
-        year: string;
-        every: string;
-        free: string;
-        trial: string;
-    };
-    terms: {
-        checkboxLabel: string;
-    };
-    customer: {
-        chargingTo: string;
-        emailLabel: string;
-        nameLabel: string;
-    };
-    balance: {
-        credits: string;
-        currencyEquivalent: string;
-    };
-    product: {
-        currentProductLabel: string;
-    };
-    topup: {
-        selectOrEnterAmount: string;
-        minAmount: string;
-        maxAmount: string;
-    };
-    activation: {
-        paymentRequired: string;
-        invalidConfiguration: string;
-        unexpectedResponse: string;
-        failed: string;
-    };
-    planSelector: {
-        heading: string;
-        currentBadge: string;
-        popularBadge: string;
-        freeBadge: string;
-        perIntervalShort: string;
-        continueButton: string;
-        backButton: string;
-        trialBadge: string;
-    };
-    amountPicker: {
-        selectAmountLabel: string;
-        customAmountLabel: string;
-        creditEstimateExact: string;
-        creditEstimateApprox: string;
-    };
-    activationFlow: {
-        heading: string;
-        activateButton: string;
-        activatingLabel: string;
-        topupHeading: string;
-        topupSubheading: string;
-        continueToPayment: string;
-        changeAmountButton: string;
-        retryingHeading: string;
-        retryingSubheading: string;
-        activatedHeading: string;
-        activatedSubheading: string;
-        tryAgainButton: string;
-        backButton: string;
-    };
-    cancelPlan: {
-        button: string;
-        buttonLoading: string;
-        confirmRecurring: string;
-        confirmUsageBased: string;
-    };
-    cancelledNotice: {
-        heading: string;
-        expiresLabel: string;
-        daysRemaining: string;
-        dayRemaining: string;
-        accessUntil: string;
-        accessEnded: string;
-        cancelledOn: string;
-        reactivateButton: string;
-        reactivateButtonLoading: string;
-    };
-    creditGate: {
-        lowBalanceHeading: string;
-        lowBalanceSubheading: string;
-        topUpCta: string;
-    };
-    errors: {
-        paymentInitFailed: string;
-        topupInitFailed: string;
-        configMissingPlanOrProduct: string;
-        configMissingAmount: string;
-        unknownError: string;
-        stripeUnavailable: string;
-        paymentIntentUnavailable: string;
-        cardElementMissing: string;
-        paymentUnexpected: string;
-        paymentProcessingFailed: string;
-        paymentRequires3ds: string;
-        paymentProcessingTimeout: string;
-        paymentStatusPrefix: string;
-    };
-}
-/**
- * Deep-partial type for consumer overrides — every nested key is optional so
- * integrators can override only the strings they care about.
- */
-type PartialSolvaPayCopy = {
-    [K in keyof SolvaPayCopy]?: Partial<SolvaPayCopy[K]>;
-};
-
-interface PurchaseInfo {
-    reference: string;
-    productName: string;
-    productRef?: string;
-    status: string;
-    startDate: string;
-    endDate?: string;
-    cancelledAt?: string;
-    cancellationReason?: string;
-    amount?: number;
-    currency?: string;
-    planType?: string;
-    isRecurring?: boolean;
-    nextBillingDate?: string;
-    billingCycle?: string;
-    planRef?: string;
-    planSnapshot?: {
-        reference?: string;
-        price?: number;
-        meterRef?: string;
-        limit?: number;
-        freeUnits?: number;
-        creditsPerUnit?: number;
-        planType?: string;
-        billingCycle?: string | null;
-        features?: Record<string, unknown> | null;
-    };
-    usage?: {
-        used: number;
-        overageUnits?: number;
-        overageCost?: number;
-        periodStart?: string;
-        periodEnd?: string;
-    };
-}
-interface CustomerPurchaseData {
-    customerRef?: string;
-    email?: string;
-    name?: string;
-    purchases: PurchaseInfo[];
-}
-interface PaymentIntentResult {
-    clientSecret: string;
-    publishableKey: string;
-    accountId?: string;
-    customerRef?: string;
-}
-/**
- * Subset of merchant identity surfaced by `GET /v1/sdk/merchant`.
- * Used by `<MandateText>` and customer-facing trust signals.
- */
-interface Merchant {
-    displayName: string;
-    legalName: string;
-    supportEmail?: string;
-    supportUrl?: string;
-    termsUrl?: string;
-    privacyUrl?: string;
-    country?: string;
-    defaultCurrency?: string;
-    statementDescriptor?: string;
-    logoUrl?: string;
-}
-interface UseMerchantReturn {
-    merchant: Merchant | null;
-    loading: boolean;
-    error: Error | null;
-    refetch: () => Promise<void>;
-}
-interface Product {
-    reference: string;
-    name?: string;
-    description?: string;
-    status?: string;
-    [key: string]: unknown;
-}
-interface UseProductReturn {
-    product: Product | null;
-    loading: boolean;
-    error: Error | null;
-    refetch: () => Promise<void>;
-}
-interface UsePlanOptions {
-    /** Plan reference (e.g. `'pln_premium'`). */
-    planRef?: string;
-    /**
-     * Optional product reference. When provided, the hook reuses the
-     * `usePlans` cache instead of fetching a dedicated plan endpoint.
-     */
-    productRef?: string;
-    /**
-     * Fetcher for plan lookup when `productRef` is not provided. Required in
-     * that mode so the hook stays dependency-free.
-     */
-    fetcher?: (productRef: string) => Promise<Plan[]>;
-}
-interface UsePlanReturn {
-    plan: Plan | null;
-    loading: boolean;
-    error: Error | null;
-    refetch: () => Promise<void>;
-}
-/**
- * Optional customer fields forwarded to payment-intent creation so the
- * backend customer record is authoritative. Read back via `useCustomer()`
- * after the intent is created.
- */
-interface PrefillCustomer {
-    name?: string;
-    email?: string;
-}
-interface TopupPaymentResult {
-    clientSecret: string;
-    publishableKey: string;
-    accountId?: string;
-    customerRef?: string;
-}
-interface UseTopupOptions {
-    amount: number;
-    currency?: string;
-}
-interface UseTopupReturn {
-    loading: boolean;
-    error: Error | null;
-    stripePromise: Promise<_stripe_stripe_js.Stripe | null> | null;
-    clientSecret: string | null;
-    startTopup: () => Promise<void>;
-    reset: () => void;
-}
-interface TopupFormProps {
-    amount: number;
-    currency?: string;
-    onSuccess?: (paymentIntent: PaymentIntent) => void;
-    onError?: (error: Error) => void;
-    returnUrl?: string;
-    submitButtonText?: string;
-    className?: string;
-    buttonClassName?: string;
-}
-interface PurchaseStatus {
-    loading: boolean;
-    /** True when data already exists but a background refetch is in progress */
-    isRefetching: boolean;
-    /** Last fetch error, or null if the most recent fetch succeeded */
-    error: Error | null;
-    customerRef?: string;
-    email?: string;
-    name?: string;
-    purchases: PurchaseInfo[];
-    hasProduct: (productName: string) => boolean;
-    /** @deprecated Use hasProduct instead */
-    hasPlan: (productName: string) => boolean;
-    /**
-     * 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
-     */
-    activePurchase: PurchaseInfo | null;
-    /**
-     * 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.
-     */
-    hasPaidPurchase: boolean;
-    /**
-     * Most recent active paid purchase (sorted by startDate)
-     * Returns purchase with status === 'active' and amount > 0.
-     * null if no active paid purchase exists
-     */
-    activePaidPurchase: PurchaseInfo | null;
-}
-/**
- * SolvaPay Provider Configuration
- * Sensible defaults for minimal code, but fully customizable
- */
-interface BalanceStatus {
-    loading: boolean;
-    credits: number | null;
-    displayCurrency: string | null;
-    creditsPerMinorUnit: number | null;
-    displayExchangeRate: number | null;
-    refetch: () => Promise<void>;
-    adjustBalance: (credits: number) => void;
-}
-interface SolvaPayConfig {
-    /**
-     * API route configuration
-     * Defaults to standard Next.js API routes
-     */
-    api?: {
-        checkPurchase?: string;
-        createPayment?: string;
-        processPayment?: string;
-        createTopupPayment?: string;
-        customerBalance?: string;
-        cancelRenewal?: string;
-        reactivateRenewal?: string;
-        activatePlan?: string;
-        listPlans?: string;
-        getMerchant?: string;
-        getProduct?: string;
-    };
-    /**
-     * BCP-47 locale tag (e.g. 'en', 'sv-SE'). Threaded through every SDK
-     * component, `Intl.NumberFormat`, and Stripe Elements. Defaults to the
-     * runtime default (typically 'en').
-     */
-    locale?: string;
-    /**
-     * Partial copy overrides. Keys not supplied fall back to the bundled English
-     * defaults — consumers only provide the strings they actually want to change.
-     */
-    copy?: PartialSolvaPayCopy;
-    /**
-     * Authentication configuration
-     * Uses adapter pattern for flexible auth provider support
-     */
-    auth?: {
-        /**
-         * Auth adapter instance
-         * Default: checks localStorage for 'auth_token' key
-         *
-         * @example
-         * ```tsx
-         * import { createSupabaseAuthAdapter } from '@solvapay/react-supabase';
-         *
-         * <SolvaPayProvider
-         *   config={{
-         *     auth: {
-         *       adapter: createSupabaseAuthAdapter({
-         *         supabaseUrl: process.env.NEXT_PUBLIC_SUPABASE_URL!,
-         *         supabaseAnonKey: process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
-         *       })
-         *     }
-         *   }}
-         * >
-         * ```
-         */
-        adapter?: AuthAdapter;
-        /**
-         * @deprecated Use `adapter` instead. Will be removed in a future version.
-         * Function to get auth token
-         */
-        getToken?: () => Promise<string | null>;
-        /**
-         * @deprecated Use `adapter` instead. Will be removed in a future version.
-         * Function to get user ID (for cache key)
-         */
-        getUserId?: () => Promise<string | null>;
-    };
-    /**
-     * Custom fetch implementation
-     * Default: uses global fetch
-     */
-    fetch?: typeof fetch;
-    /**
-     * Request headers to include in all API calls
-     * Default: empty
-     */
-    headers?: HeadersInit | (() => Promise<HeadersInit>);
-    /**
-     * Custom error handler
-     * Default: logs to console
-     */
-    onError?: (error: Error, context: string) => void;
-}
-interface CancelResult {
-    reference?: string;
-    status?: string;
-    cancelledAt?: string;
-    [key: string]: unknown;
-}
-interface ReactivateResult {
-    reference?: string;
-    status?: string;
-    [key: string]: unknown;
-}
-
-interface SolvaPayContextValue {
-    purchase: PurchaseStatus;
-    refetchPurchase: () => Promise<void>;
-    createPayment: (params: {
-        planRef?: string;
-        productRef?: string;
-        customer?: PrefillCustomer;
-    }) => Promise<PaymentIntentResult>;
-    processPayment?: (params: {
-        paymentIntentId: string;
-        productRef: string;
-        planRef?: string;
-    }) => Promise<ProcessPaymentResult>;
-    createTopupPayment: (params: {
-        amount: number;
-        currency?: string;
-    }) => Promise<TopupPaymentResult>;
-    cancelRenewal: (params: {
-        purchaseRef: string;
-        reason?: string;
-    }) => Promise<CancelResult>;
-    reactivateRenewal: (params: {
-        purchaseRef: string;
-    }) => Promise<ReactivateResult>;
-    activatePlan: (params: {
-        productRef: string;
-        planRef: string;
-    }) => Promise<ActivatePlanResult>;
-    customerRef?: string;
-    updateCustomerRef?: (newCustomerRef: string) => void;
-    balance: BalanceStatus;
-    /** @internal Provider config — used by SDK hooks, not part of public API */
-    _config?: SolvaPayConfig;
-}
-interface SolvaPayProviderProps {
-    /**
-     * Configuration object with sensible defaults
-     * If not provided, uses standard Next.js API routes
-     */
-    config?: SolvaPayConfig;
-    /**
-     * Custom API functions (override config defaults)
-     * Use only if you need custom logic beyond standard API routes
-     */
-    createPayment?: (params: {
-        planRef?: string;
-        productRef?: string;
-        customer?: PrefillCustomer;
-    }) => Promise<PaymentIntentResult>;
-    checkPurchase?: () => Promise<CustomerPurchaseData>;
-    processPayment?: (params: {
-        paymentIntentId: string;
-        productRef: string;
-        planRef?: string;
-    }) => Promise<ProcessPaymentResult>;
-    createTopupPayment?: (params: {
-        amount: number;
-        currency?: string;
-    }) => Promise<TopupPaymentResult>;
-    children: React.ReactNode;
-}
-/**
- * Error type for payment operations
- */
-interface PaymentError extends Error {
-    code?: string;
-    type?: string;
-}
-/**
- * Plan returned by the SolvaPay API.
- *
- * All fields are optional except `reference` so the type stays compatible
- * with partial JSON responses from custom fetcher functions.
- */
-interface Plan {
-    type?: 'recurring' | 'one-time' | 'usage-based';
-    reference: string;
-    name?: string;
-    description?: string;
-    price?: number;
-    currency?: string;
-    currencySymbol?: string;
-    freeUnits?: number;
-    setupFee?: number;
-    trialDays?: number;
-    billingCycle?: string;
-    billingModel?: 'pre-paid' | 'post-paid';
-    creditsPerUnit?: number;
-    measures?: string;
-    limit?: number;
-    rolloverUnusedUnits?: boolean;
-    limits?: Record<string, unknown>;
-    features?: Record<string, unknown> | string[];
-    requiresPayment?: boolean;
-    default?: boolean;
-    isActive?: boolean;
-    maxActiveUsers?: number;
-    accessExpiryDays?: number;
-    status?: string;
-    createdAt?: string;
-    updatedAt?: string;
-    interval?: string;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Options for usePlans hook
- */
-interface UsePlansOptions {
-    /**
-     * Fetcher function to retrieve plans
-     */
-    fetcher: (productRef: string) => Promise<Plan[]>;
-    /**
-     * Product reference to fetch plans for
-     */
-    productRef?: string;
-    /**
-     * Optional filter function to filter plans.
-     * Receives plan and its index (after sorting, if sortBy is provided).
-     */
-    filter?: (plan: Plan, index: number) => boolean;
-    /**
-     * Optional sort function to sort plans
-     */
-    sortBy?: (a: Plan, b: Plan) => number;
-    /**
-     * Auto-select first paid plan on load
-     */
-    autoSelectFirstPaid?: boolean;
-    /**
-     * Plan reference to select initially when plans load.
-     * Applied at most once when selectionReady is true.
-     * Takes priority over autoSelectFirstPaid.
-     */
-    initialPlanRef?: string;
-    /**
-     * When false, plans still fetch but auto-selection is deferred.
-     * When it transitions to true, one-shot initial selection fires.
-     * Defaults to true.
-     */
-    selectionReady?: boolean;
-}
-/**
- * Return type for usePlans hook
- */
-interface UsePlansReturn {
-    plans: Plan[];
-    loading: boolean;
-    error: Error | null;
-    selectedPlanIndex: number;
-    selectedPlan: Plan | null;
-    setSelectedPlanIndex: (index: number) => void;
-    selectPlan: (planRef: string) => void;
-    refetch: () => Promise<void>;
-    /** True after the one-shot initial selection has been applied */
-    isSelectionReady: boolean;
-}
-/**
- * Return type for usePurchaseStatus hook
- *
- * 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 PurchaseStatusReturn {
-    /**
-     * Most recent cancelled paid purchase (sorted by startDate)
-     * null if no cancelled paid purchase exists
-     */
-    cancelledPurchase: PurchaseInfo | null;
-    /**
-     * Whether to show cancelled purchase notice
-     * true if cancelledPurchase exists
-     */
-    shouldShowCancelledNotice: boolean;
-    /**
-     * Format a date string to locale format (e.g., "January 15, 2024")
-     * Returns null if dateString is not provided
-     */
-    formatDate: (dateString?: string) => string | null;
-    /**
-     * Calculate days until expiration date
-     * Returns null if endDate is not provided, otherwise returns days (0 or positive)
-     */
-    getDaysUntilExpiration: (endDate?: string) => number | null;
-}
-/**
- * Payment form props - simplified and minimal
- */
-/**
- * Discriminated checkout-completion result surfaced by `<PaymentForm>` and
- * `<CheckoutLayout>` via their `onResult` callback. Integrators handling
- * both paid and free plans should use `onResult` to get a single typed
- * callback; paid-only integrators keep using `onSuccess(paymentIntent)`.
- */
-type PaymentResult = {
-    kind: 'paid';
-    paymentIntent: PaymentIntent;
-};
-type ActivationResult = {
-    kind: 'activated';
-    result: ActivatePlanResult;
-};
-type CheckoutResult = PaymentResult | ActivationResult;
-interface PaymentFormProps {
-    /**
-     * Plan reference to checkout. When omitted, the SDK auto-resolves the plan from
-     * productRef (requires exactly one active plan or a default plan). Pass explicitly
-     * when the product has multiple plans without a default.
-     */
-    planRef?: string;
-    /**
-     * Product reference. Required when planRef is omitted (for plan resolution)
-     * and for processing payment after confirmation.
-     */
-    productRef?: string;
-    /**
-     * Callback when payment succeeds. Fires on paid flows only — preserved
-     * exactly for backwards compatibility. Free/activation flows do NOT fire
-     * `onSuccess`; use `onResult` to receive both paid and activated results.
-     */
-    onSuccess?: (paymentIntent: PaymentIntent) => void;
-    /**
-     * Unified callback fired on both paid and activated completions with a
-     * discriminated result. Safe to provide alongside `onSuccess` — for paid
-     * flows both fire (in order: `onSuccess` first, then `onResult`).
-     */
-    onResult?: (result: CheckoutResult) => void;
-    /**
-     * Override the default free-plan activation step. When provided, the form
-     * awaits this promise on submit and fires `onResult` when it resolves.
-     * When omitted, the default behavior calls `activatePlan` from context.
-     */
-    onFreePlan?: (plan: Plan) => Promise<unknown> | void;
-    /**
-     * Callback when payment fails
-     */
-    onError?: (error: Error) => void;
-    /**
-     * Return URL after payment completion. Defaults to current page URL if not provided.
-     */
-    returnUrl?: string;
-    /**
-     * Text for the submit button. Defaults to "Pay Now"
-     */
-    submitButtonText?: string;
-    /**
-     * Optional className for the form container
-     */
-    className?: string;
-    /**
-     * Optional className for the submit button
-     */
-    buttonClassName?: string;
-    /**
-     * Customer name/email to forward to backend PaymentIntent creation so the
-     * server-side customer record is authoritative. Echoed back via
-     * `useCustomer()` after the intent is created.
-     */
-    prefillCustomer?: PrefillCustomer;
-    /**
-     * When true, the default tree renders a terms/privacy checkbox and gates
-     * the submit button until it is ticked. No-op when custom `children` are
-     * passed — compose `<PaymentForm.TermsCheckbox />` yourself.
-     */
-    requireTermsAcceptance?: boolean;
-}
-interface UseTopupAmountSelectorOptions {
-    currency: string;
-    minAmount?: number;
-    maxAmount?: number;
-}
-interface UseTopupAmountSelectorReturn {
-    quickAmounts: number[];
-    selectedAmount: number | null;
-    customAmount: string;
-    resolvedAmount: number | null;
-    selectQuickAmount: (amount: number) => void;
-    setCustomAmount: (value: string) => void;
-    error: string | null;
-    validate: () => boolean;
-    reset: () => void;
-    currencySymbol: string;
-}
-type PurchaseStatusValue = 'pending' | 'active' | 'trialing' | 'past_due' | 'cancelled' | 'expired' | 'suspended' | 'refunded';
-
-/**
- * Default-tree shim over the `CheckoutSummary` primitive.
- *
- * Renders a product/plan/price line with optional trial + tax-note slots.
- * Full control (ordering, custom elements, Tailwind variants) is available
- * via the primitives at `@solvapay/react/primitives`.
- */
-
-type CheckoutSummaryProps = {
-    planRef?: string;
-    productRef?: string;
-    showTrial?: boolean;
-    showTaxNote?: boolean;
-    className?: string;
-};
-declare const CheckoutSummary: React$1.FC<CheckoutSummaryProps>;
-
-/**
- * Checkout "shape" — drives the mandate variant, the submit-button CTA, and
- * the button `aria-label` in lockstep so those three strings always agree.
- */
-type CheckoutVariant = 'recurring' | 'oneTime' | 'topup' | 'usageMetered' | 'freeTier';
-/**
- * Derive the variant from the plan's type + billing model. Unknown or missing
- * plans default to `'oneTime'`, which matches the canonical "Pay Now" UX.
- *
- * Free plans (`requiresPayment === false`) that are NOT usage-metered route
- * to the `'freeTier'` variant. Metered free/usage plans stay on
- * `'usageMetered'` because the mandate copy there already covers pay-as-you-go.
- */
-declare function deriveVariant(plan: Plan | null | undefined, mode?: 'topup'): CheckoutVariant;
-
-/**
- * MandateText leaf primitive.
- *
- * Renders SCA-compliant authorization copy derived from the resolved plan,
- * product, and merchant identity. Variant is derived from the plan type +
- * billing model and can be forced via the `variant` or `mode` props (use
- * `mode="topup"` inside `<TopupForm>` where there is no plan). All strings
- * resolve through the localized copy bundle so integrators can override
- * text without forking the component.
- */
-
-type MandateTextProps = {
-    planRef?: string;
-    productRef?: string;
-    variant?: CheckoutVariant;
-    mode?: 'topup';
-    amountMinor?: number;
-    currency?: string;
-    asChild?: boolean;
-} & Omit<React$1.HTMLAttributes<HTMLParagraphElement>, 'children'> & {
-    children?: React$1.ReactNode;
-};
-declare const MandateText: React$1.ForwardRefExoticComponent<{
-    planRef?: string;
-    productRef?: string;
-    variant?: CheckoutVariant;
-    mode?: "topup";
-    amountMinor?: number;
-    currency?: string;
-    asChild?: boolean;
-} & Omit<React$1.HTMLAttributes<HTMLParagraphElement>, "children"> & {
-    children?: React$1.ReactNode;
-} & React$1.RefAttributes<HTMLParagraphElement>>;
-
-/**
- * PaymentForm compound primitive.
- *
- * Unstyled, accessible building blocks for running the paid OR free checkout
- * step inside a <SolvaPayProvider>. `Root` detects paid vs free plans via
- * `usePlan`, wires Stripe Elements for paid plans, or falls through to
- * `useActivation` for free plans; both paths expose the same
- * `PaymentFormContext` so the same subcomponents compose identically in
- * either mode.
- *
- * Every leaf accepts `asChild` for Slot-style composition. The `SubmitButton`
- * emits `data-state=idle|processing|disabled` + `data-variant=paid|free|topup|activate`.
- */
-
-type SummaryProps = Omit<React$1.ComponentProps<typeof CheckoutSummary>, 'planRef' | 'productRef'>;
-type MandateTextPrimitiveProps = Omit<React$1.ComponentProps<typeof MandateText>, 'planRef' | 'productRef'>;
-type PaymentElementProps = {
-    options?: React$1.ComponentProps<typeof PaymentElement>['options'];
-};
-type CardElementProps = {
-    options?: React$1.ComponentProps<typeof CardElement>['options'];
-};
-declare const PaymentFormRoot: React$1.ForwardRefExoticComponent<PaymentFormProps & {
-    prefillCustomer?: PrefillCustomer;
-    requireTermsAcceptance?: boolean;
-    children?: React$1.ReactNode;
-} & React$1.RefAttributes<HTMLDivElement>>;
-declare const PaymentFormSummary: React$1.FC<SummaryProps>;
-declare const PaymentFormCustomerFields: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-    asChild?: boolean;
-    readOnly?: boolean;
-} & React$1.RefAttributes<HTMLDivElement>>;
-declare const PaymentFormPaymentElement: React$1.FC<PaymentElementProps>;
-declare const PaymentFormCardElement: React$1.FC<CardElementProps>;
-declare const PaymentFormMandateText: React$1.FC<MandateTextPrimitiveProps>;
-declare const PaymentFormTermsCheckbox: React$1.ForwardRefExoticComponent<React$1.LabelHTMLAttributes<HTMLLabelElement> & {
-    asChild?: boolean;
-    label?: React$1.ReactNode;
-} & React$1.RefAttributes<HTMLLabelElement>>;
-declare const PaymentFormSubmitButton: React$1.ForwardRefExoticComponent<React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLButtonElement>>;
-declare const PaymentFormLoading: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLDivElement>>;
-declare const PaymentFormError: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLDivElement>>;
-declare const PaymentForm: {
-    readonly Root: React$1.ForwardRefExoticComponent<PaymentFormProps & {
-        prefillCustomer?: PrefillCustomer;
-        requireTermsAcceptance?: boolean;
-        children?: React$1.ReactNode;
-    } & React$1.RefAttributes<HTMLDivElement>>;
-    readonly Summary: React$1.FC<SummaryProps>;
-    readonly CustomerFields: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-        asChild?: boolean;
-        readOnly?: boolean;
-    } & React$1.RefAttributes<HTMLDivElement>>;
-    readonly PaymentElement: React$1.FC<PaymentElementProps>;
-    readonly CardElement: React$1.FC<CardElementProps>;
-    readonly MandateText: React$1.FC<MandateTextPrimitiveProps>;
-    readonly TermsCheckbox: React$1.ForwardRefExoticComponent<React$1.LabelHTMLAttributes<HTMLLabelElement> & {
-        asChild?: boolean;
-        label?: React$1.ReactNode;
-    } & React$1.RefAttributes<HTMLLabelElement>>;
-    readonly SubmitButton: React$1.ForwardRefExoticComponent<React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLButtonElement>>;
-    readonly Loading: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLDivElement>>;
-    readonly Error: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLDivElement>>;
-};
-
-/**
- * ProductBadge compound primitive.
- *
- * Single leaf that renders the customer's current product name when an
- * active purchase exists. Emits `data-has-purchase` + `data-has-paid-purchase`
- * flags and forwards an `aria-label` derived from the copy bundle.
- * `PlanBadge` is an alias retained for backwards compatibility with older
- * integrations — both point at the same component.
- */
-
-declare const ProductBadge: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLElement>>;
-/** @deprecated Use `ProductBadge` instead. Kept as an alias for existing integrations. */
-declare const PlanBadge: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLElement>>;
-
-/**
- * PurchaseGate compound primitive.
- *
- * Controls access to gated content based on whether the customer has an
- * active purchase (optionally scoped to a product). `Root` exposes
- * `data-state=allowed|blocked|loading` and context-drives the
- * `Allowed`, `Blocked`, `Loading`, and `Error` subcomponents.
- */
-
-type GateState = 'allowed' | 'blocked' | 'loading';
-type PurchaseGateContextValue = {
-    state: GateState;
-    loading: boolean;
-    hasAccess: boolean;
-    error: Error | null;
-};
-declare const PurchaseGateRoot: React$1.ForwardRefExoticComponent<{
-    /** @deprecated Use `requireProduct`. */
-    requirePlan?: string;
-    requireProduct?: string;
-    asChild?: boolean;
-    children?: React$1.ReactNode;
-} & Omit<React$1.HTMLAttributes<HTMLDivElement>, "children"> & React$1.RefAttributes<HTMLDivElement>>;
-declare const PurchaseGateAllowed: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLDivElement>>;
-declare const PurchaseGateBlocked: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLDivElement>>;
-declare const PurchaseGateLoading: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLDivElement>>;
-declare const PurchaseGateError: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLDivElement>>;
-declare const PurchaseGate: {
-    readonly Root: React$1.ForwardRefExoticComponent<{
-        /** @deprecated Use `requireProduct`. */
-        requirePlan?: string;
-        requireProduct?: string;
-        asChild?: boolean;
-        children?: React$1.ReactNode;
-    } & Omit<React$1.HTMLAttributes<HTMLDivElement>, "children"> & React$1.RefAttributes<HTMLDivElement>>;
-    readonly Allowed: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLDivElement>>;
-    readonly Blocked: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLDivElement>>;
-    readonly Loading: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLDivElement>>;
-    readonly Error: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLDivElement>>;
-};
-declare function usePurchaseGate(): PurchaseGateContextValue;
-
-/**
- * BalanceBadge leaf primitive.
- *
- * Renders the customer's credit balance with an optional currency-equivalent
- * suffix. Emits `data-state=loading|zero|low|ok` plus a `data-credits`
- * attribute for CSS targeting. Low-balance threshold is configurable via the
- * `lowThreshold` prop (defaults to 10).
- */
-
-declare const BalanceBadge: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLSpanElement> & {
-    asChild?: boolean;
-    /** Hide the trailing " credits" label + currency equivalent. */
-    numberOnly?: boolean;
-    /** Balance threshold (inclusive) treated as `data-state="low"`. Defaults to 10. */
-    lowThreshold?: number;
-} & React$1.RefAttributes<HTMLSpanElement>>;
-
-/**
- * ActivationFlow compound primitive.
- *
- * Drives the usage-based plan activation state machine:
- *   summary → activating → (topup_required → selectAmount → topupPayment →
- *     retrying) → activated | error.
- *
- * `Root` exposes `data-state` set to the current step and publishes the
- * shared context consumed by leaves. Leaves render only during their
- * matching step:
- *  - `Summary` — `summary` | `activating`
- *  - `ActivateButton` — `summary` | `activating`
- *  - `AmountPicker` — `selectAmount`
- *  - `ContinueButton` — `selectAmount`
- *  - `Retrying` — `retrying`
- *  - `Activated` — `activated`
- *  - `Loading` — renders when plan is not yet resolved
- *  - `Error` — `error`
- */
-
-type ActivationFlowStep = 'summary' | 'activating' | 'selectAmount' | 'topupPayment' | 'retrying' | 'activated' | 'error';
-type ActivationFlowContextValue = {
-    step: ActivationFlowStep;
-    plan: Plan | null;
-    productRef: string;
-    planRef: string;
-    amountSelector: UseTopupAmountSelectorReturn;
-    amountCents: number;
-    currency: string;
-    activate: () => Promise<void>;
-    reset: () => void;
-    goToTopupPayment: () => void;
-    backToSelectAmount: () => void;
-    onTopupSuccess: () => Promise<void>;
-    error: string | null;
-    onError?: (error: Error) => void;
-};
-type AmountPickerMountProps = {
-    children?: React$1.ReactNode;
-};
-declare const ActivationFlowRoot: React$1.ForwardRefExoticComponent<{
-    productRef?: string;
-    /** Defaults to PlanSelectionContext selection when omitted. */
-    planRef?: string;
-    onSuccess?: (result: ActivationResult) => void;
-    onError?: (error: Error) => void;
-    retryDelayMs?: number;
-    retryBackoffMs?: number;
-    asChild?: boolean;
-    children?: React$1.ReactNode;
-} & Omit<React$1.HTMLAttributes<HTMLDivElement>, "children" | "onError"> & React$1.RefAttributes<HTMLDivElement>>;
-declare const ActivationFlowSummary: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLDivElement>>;
-declare const ActivationFlowActivateButton: React$1.ForwardRefExoticComponent<React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLButtonElement>>;
-declare const ActivationFlowAmountPicker: React$1.FC<AmountPickerMountProps>;
-declare const ActivationFlowContinueButton: React$1.ForwardRefExoticComponent<React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLButtonElement>>;
-declare const ActivationFlowRetrying: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLDivElement>>;
-declare const ActivationFlowActivated: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLDivElement>>;
-declare const ActivationFlowLoading: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLDivElement>>;
-declare const ActivationFlowError: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-    asChild?: boolean;
-} & React$1.RefAttributes<HTMLDivElement>>;
-declare const ActivationFlow: {
-    readonly Root: React$1.ForwardRefExoticComponent<{
-        productRef?: string;
-        /** Defaults to PlanSelectionContext selection when omitted. */
-        planRef?: string;
-        onSuccess?: (result: ActivationResult) => void;
-        onError?: (error: Error) => void;
-        retryDelayMs?: number;
-        retryBackoffMs?: number;
-        asChild?: boolean;
-        children?: React$1.ReactNode;
-    } & Omit<React$1.HTMLAttributes<HTMLDivElement>, "children" | "onError"> & React$1.RefAttributes<HTMLDivElement>>;
-    readonly Summary: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLDivElement>>;
-    readonly ActivateButton: React$1.ForwardRefExoticComponent<React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLButtonElement>>;
-    readonly AmountPicker: React$1.FC<AmountPickerMountProps>;
-    readonly ContinueButton: React$1.ForwardRefExoticComponent<React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLButtonElement>>;
-    readonly Retrying: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLDivElement>>;
-    readonly Activated: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLDivElement>>;
-    readonly Loading: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLDivElement>>;
-    readonly Error: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
-        asChild?: boolean;
-    } & React$1.RefAttributes<HTMLDivElement>>;
-};
-declare function useActivationFlow(): ActivationFlowContextValue;
-
-/**
- * CancelPlanButton leaf primitive.
- *
- * Cancels the active (or specified) purchase via `usePurchaseActions`.
- * Emits `data-state=idle|cancelling` and auto-derives the confirm dialog
- * copy from the plan type (`recurring` vs. `usage-based`) unless overridden
- * via the `confirm` prop (`false` to skip, string to replace).
- */
-
-declare const CancelPlanButton: React$1.ForwardRefExoticComponent<React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
-    asChild?: boolean;
-    /** Defaults to the active purchase from `usePurchase()`. */
-    purchaseRef?: string;
-    reason?: string;
-    /**
-     * Built-in confirm dialog. `true` (default) uses plan-type-aware copy;
-     * a string replaces the copy; `false` skips confirmation.
-     */
-    confirm?: boolean | string;
-    onCancelled?: () => void;
-    onError?: (error: Error) => void;
-} & React$1.RefAttributes<HTMLButtonElement>>;
-
-export { PurchaseGate as $, type ActivationResult as A, type BalanceStatus as B, type CheckoutResult as C, type PurchaseInfo as D, type CheckoutVariant as E, type Product as F, type ActivationFlowStep as G, BalanceBadge as H, CancelPlanButton as I, CheckoutSummary as J, type CheckoutSummaryProps as K, type CustomerPurchaseData as L, type MandateContext as M, type MandateTemplate as N, MandateText as O, type PaymentFormProps as P, type MandateTextProps as Q, type ReactivateResult as R, type SolvaPayProviderProps as S, type TopupFormProps as T, type UsePlansOptions as U, type Merchant as V, type PaymentError as W, type PaymentIntentResult as X, type PaymentResult as Y, PlanBadge as Z, ProductBadge as _, type PrefillCustomer as a, type PurchaseStatusValue as a0, type SolvaPayConfig as a1, type TopupPaymentResult as a2, deriveVariant as a3, ActivationFlow as a4, ActivationFlowActivateButton as a5, ActivationFlowActivated as a6, ActivationFlowAmountPicker as a7, ActivationFlowContinueButton as a8, ActivationFlowError as a9, ActivationFlowLoading as aa, ActivationFlowRetrying as ab, ActivationFlowRoot as ac, ActivationFlowSummary as ad, PaymentForm as ae, PaymentFormRoot as af, PurchaseGateAllowed as ag, PurchaseGateBlocked as ah, PurchaseGateError as ai, PurchaseGateLoading as aj, PurchaseGateRoot as ak, useActivationFlow as al, usePurchaseGate as am, PaymentFormSummary as b, PaymentFormCustomerFields as c, PaymentFormPaymentElement as d, PaymentFormCardElement as e, PaymentFormMandateText as f, PaymentFormTermsCheckbox as g, PaymentFormSubmitButton as h, PaymentFormLoading as i, PaymentFormError as j, type Plan as k, type PurchaseStatus as l, type SolvaPayContextValue as m, type UsePlansReturn as n, type UsePlanOptions as o, type UsePlanReturn as p, type UseProductReturn as q, type UseMerchantReturn as r, type SolvaPayCopy as s, type PurchaseStatusReturn as t, type CancelResult as u, type UseTopupOptions as v, type UseTopupReturn as w, type UseTopupAmountSelectorOptions as x, type UseTopupAmountSelectorReturn as y, type PartialSolvaPayCopy as z };