@solvapay/react 2.1.1 → 2.2.0-preview-e3e546693c002c32f128d83bf6c5fe76ac182a79

package/dist/{shared-D0hmT1qU.d.cts → useUsage-CTgRBvFK.d.cts}

@@ -1,7 +1,7 @@
 import * as _solvapay_core from '@solvapay/core';
 import { TaxIdType, TaxBreakdown, PricingOptionLike, TaxBehavior } from '@solvapay/core';
 import * as _stripe_stripe_js from '@stripe/stripe-js';
-import { PaymentIntent } from '@stripe/stripe-js';
+import { PaymentIntent, Appearance } from '@stripe/stripe-js';
 import { AuthAdapter } from './adapters/auth.cjs';
 
 interface components {
@@ -614,6 +614,42 @@ interface components {
             /** @default 1 */
             units: number;
         };
+        CreditActivityEntryDto: {
+            /**
+             * Signed credit units on the USD peg (100 credits = 1 USD cent)
+             * @example -200
+             */
+            amount: number;
+            /**
+             * Running credit balance after this event
+             * @example 599800
+             */
+            balance: number;
+            /** @description Product display name when the event is product-scoped */
+            productName?: string;
+            /** @description Product reference when the event is product-scoped */
+            productRef?: string;
+            /** @description Machine-readable reason when the ledger stored one */
+            reason?: string;
+            /**
+             * ISO-8601 timestamp
+             * @example 2026-09-05T14:22:00.000Z
+             */
+            timestamp: string;
+            /**
+             * Ledger event type
+             * @enum {string}
+             */
+            type: 'USAGE' | 'TOPUP' | 'GRANT' | 'REFUND' | 'ADJUSTMENT';
+        };
+        CreditActivityResponseDto: {
+            entries: components['schemas']['CreditActivityEntryDto'][];
+            /**
+             * True when more events exist beyond this page
+             * @example false
+             */
+            hasMore: boolean;
+        };
         CreditDebitSkippedResponse: {
             /** @enum {number} */
             debited: false;
@@ -845,6 +881,10 @@ interface components {
             creditsPerUnit?: number;
             /** @description ISO 4217 currency code for credit fields */
             currency?: string;
+            /**
+             * The effective finite cap for this meter. Present only when the backend measured a finite cap.
+             */
+            limit?: number;
             /**
              * The meter name to use when tracking usage events
              * @example requests
@@ -869,6 +909,10 @@ interface components {
             throttled?: boolean;
             /** @description The customer was auto-upgraded to the target pricing to restore access — `onExceed: auto_upgrade` succeeded. */
             upgraded?: boolean;
+            /**
+             * Consumed usage units this period. Present only when the backend measured a finite cap.
+             */
+            used?: number;
             /**
              * Whether the customer is within their usage limits
              * @example true
@@ -1273,6 +1317,11 @@ interface components {
             stripeAccountId?: string;
         };
         SdkMerchantResponseDto: {
+            /**
+             * City from the legal entity address
+             * @example London
+             */
+            city?: string;
             /**
              * Company registration number (EIN, Companies House No, Org No)
              * @example HRB12345
@@ -1315,6 +1364,11 @@ interface components {
              * @example ACME INC
              */
             statementDescriptor?: string;
+            /**
+             * State, county, or region from the legal entity address. Free text — values like "Greater London" are valid.
+             * @example Greater London
+             */
+            stateOrCounty?: string;
             /**
              * Full set of currencies a customer may pay credit topups in, including the default currency. Omitted/single-entry means single-currency behavior.
              * @example [
@@ -1340,6 +1394,11 @@ interface components {
              * @example DE123456789
              */
             vatNumber?: string;
+            /**
+             * Merchant public website. Distinct from supportUrl so the same URL is not emitted twice.
+             * @example https://acme.com
+             */
+            websiteUrl?: string;
         };
         SdkPaymentIntentListItem: {
             /**
@@ -2261,6 +2320,43 @@ interface operations {
             };
         };
     };
+    CreditActivitySdkController_getActivity: {
+        parameters: {
+            query: {
+                customerRef: string;
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Account-wide credit ledger page. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['CreditActivityResponseDto'];
+                };
+            };
+            /** @description customerRef is required, or limit is invalid */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Customer not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     CustomerSdkController_getCustomerByQuery: {
         parameters: {
             query?: {
@@ -2908,6 +3004,8 @@ interface operations {
                         kind: 'card';
                         /** @example 4242 */
                         last4: string;
+                        /** @example true */
+                        reusable: boolean;
                     } | {
                         /** @enum {string} */
                         kind: 'none';
@@ -3748,6 +3846,19 @@ interface operations {
 
 /** SDK purchase row. Generated from the OpenAPI `SdkPurchaseResponse` schema. */
 type PurchaseInfo = components['schemas']['SdkPurchaseResponse'];
+/**
+ * Extended LimitResponse with SDK-added plan field.
+ *
+ * The backend `LimitResponse` now natively carries the `onExceed` outcome flags
+ * (`throttled` / `overage` / `needsTopUp` / `needsUpgrade` / `upgraded`, resolved
+ * by `decideLimit`), so they flow through from `generated.ts`. `throttled` /
+ * `overage` ride the allow path (`withinLimits: true`) so a protected handler
+ * can read them from `decision.limits` and degrade service or note overage; the
+ * others accompany a gate outcome.
+ */
+type LimitResponseWithPlan = components['schemas']['LimitResponse'] & {
+    plan: string;
+};
 type OneTimePurchaseInfo = components['schemas']['OneTimePurchaseInfo'];
 /**
  * Result from processing a payment intent.
@@ -3848,6 +3959,26 @@ type AutoRechargeInput = Omit<components['schemas']['PutAutoRechargeSdkDto'], 'c
 type SaveAutoRechargeInput = Omit<components['schemas']['PutAutoRechargeSdkDto'], 'customerRef' | 'customerEmail' | 'customerName'>;
 type AutoRechargeResponse = components['schemas']['AutoRechargeGetResponse'];
 type SaveAutoRechargeResponse = components['schemas']['SaveAutoRechargeResponse'];
+/**
+ * SDK-facing merchant identity (source: GET /v1/sdk/merchant).
+ */
+type SdkMerchantResponse = components['schemas']['SdkMerchantResponseDto'];
+type CreditActivityType = components['schemas']['CreditActivityEntryDto']['type'];
+/**
+ * One account-wide credit ledger row from `GET /v1/sdk/credits/activity`.
+ * Seven fields only — amounts are credit units, not money.
+ */
+type CreditActivityEntry = components['schemas']['CreditActivityEntryDto'];
+type CreditActivityResult = components['schemas']['CreditActivityResponseDto'];
+/**
+ * Settled `get_history` / `useHistory` payload. Charges are product-scoped
+ * purchases; credit activity is account-wide. History is not on bootstrap —
+ * `checkPurchaseCore` only returns `status === 'active'`.
+ */
+interface GetHistoryResult {
+    charges: PurchaseInfo[];
+    creditActivity: CreditActivityResult;
+}
 
 /**
  * Customer Helper (Core)
@@ -4014,7 +4145,7 @@ interface SolvaPayCopy {
         invalidThreshold: string;
         thresholdTooLow: string;
         minTopupAmount: string;
-        topupBelowThreshold: string;
+        deepDrawdownExplainer: string;
         invalidMaxMonthlySpend: string;
         maxMonthlySpendBelowTopup: string;
         maxMonthlySpendLabel: string;
@@ -4030,6 +4161,24 @@ interface SolvaPayCopy {
         taxDisclosure: string;
         statusFailed: string;
     };
+    autoRechargeView: {
+        heading: string;
+        description: string;
+        thresholdLabel: string;
+        topupLabel: string;
+        maxMonthlySpendLabel: string;
+        maxMonthlySpendPlaceholder: string;
+        explainer: string;
+        explainerNoEstimate: string;
+        footerCaption: string;
+        cancel: string;
+        turnOn: string;
+        save: string;
+        turnOff: string;
+        statusOn: string;
+        back: string;
+        setupUnexpected: string;
+    };
     activationFlow: {
         heading: string;
         activateButton: string;
@@ -4074,6 +4223,15 @@ interface SolvaPayCopy {
         validIndefinitely: string;
         /** "Started {date}" — purchase start-date line on `<CurrentPlanCard>`. */
         startedOn: string;
+        /**
+         * Field labels rendered above the otherwise bare values on
+         * `<CurrentPlanCard showFieldLabels>`. A price, a usage rate and a
+         * credit balance are all "a number with a currency" — without a
+         * label the customer cannot tell which one they are reading.
+         */
+        priceFieldLabel: string;
+        rateFieldLabel: string;
+        balanceFieldLabel: string;
         paymentMethod: string;
         paymentMethodExpires: string;
         noPaymentMethod: string;
@@ -4115,8 +4273,106 @@ interface SolvaPayCopy {
         noPlanBody: string;
         /** Inline CTA on the pay-as-you-go state that switches to the Plan tab. */
         seePlansButton: string;
+        /** E upgrade link. Change plan stays the header label. */
+        seePlans: string;
         /** Primary CTA on the no-plan state that switches to the Plan tab. */
         pickPlanButton: string;
+        /** CTA on a free active plan that opens checkout to pick a paid plan. */
+        upgradeButton: string;
+        /** CTA on a non-free active plan that opens checkout to switch plans. */
+        changePlanButton: string;
+        /** Eyebrow above the balance hero. */
+        creditBalance: string;
+        /** Primary top-up CTA on the account strip. */
+        addFunds: string;
+        autoRechargeOn: string;
+        autoRechargeOff: string;
+        turnOn: string;
+        /** On-state link that opens the dedicated auto-recharge view. */
+        manage: string;
+        /** Caption under auto-recharge off on a running credit plan (B). */
+        autoRechargeOffCaption: string;
+        /** Caption under auto-recharge off when calls are already failing (D). */
+        autoRechargeOffFixCaption: string;
+        /** Balance caption when the credit plan is at zero (D). */
+        callsFailingCaption: string;
+        activeProducts: string;
+        /** Caption under the balance when a merchant name is known. */
+        worksAcross: string;
+        /** Fullscreen identity footer. `{merchant}`. No verified suffix. */
+        soldBy: string;
+        /** Portal text link. The button adds the external-link glyph. */
+        fullHistory: string;
+        /** Portal text link. The button adds the external-link glyph. */
+        fullAccount: string;
+        creditActivityEyebrow: string;
+        chargesEyebrow: string;
+        creditActivityCaption: string;
+        creditActivityEmpty: string;
+        creditActivityFailed: string;
+        chargesEmpty: string;
+        chargesFailed: string;
+        eventColumn: string;
+        whenColumn: string;
+        creditsColumn: string;
+        balanceColumn: string;
+        chargeColumn: string;
+        dateColumn: string;
+        amountColumn: string;
+        /** E upgrade prompt. `{total}` `{unit}` `{interval}`. */
+        needMoreAllowance: string;
+        /** E upgrade caption under the See plans link. */
+        upgradePaygCaption: string;
+        /** StatusDot label on state A. */
+        noPlanStatus: string;
+        /** Caption under the product on state A. */
+        choosePlanCaption: string;
+        /** Eyebrow above the A ladder. */
+        plansEyebrow: string;
+        /** Eyebrow above the F ladder. */
+        carryOnEyebrow: string;
+        /** Caption under the A ladder. */
+        plansStartCaption: string;
+        /** Per-row CTA on state A. */
+        activatePlanButton: string;
+        /** Per-row CTA on state F. */
+        switchPlanButton: string;
+        /** Busy label on the clicked A/F ladder row. */
+        activatingPlanButton: string;
+        /** F headline. `{plan}` `{unit}`. */
+        usedUpTitle: string;
+        /** F body when a reset date is known. `{date}` `{days}`. */
+        usedUpBody: string;
+        /** F body when the period has not started. */
+        usedUpBodyNoDate: string;
+        /** F anti-trap when credits > 0. `{credits}` `{plan}`. */
+        antiTrapCredits: string;
+        /** F wait line. `{date}` `{plan}`. */
+        waitUntilReset: string;
+        /** StatusDot label on state H. */
+        notStartedStatus: string;
+        /** H headline. `{total}` `{unit}` `{interval}`. */
+        readyToClaim: string;
+        /** H caption under the headline. */
+        noCardCaption: string;
+        /** H primary CTA. Wires `activatePlan`. */
+        startFreePlan: string;
+        /** I body — calls succeed; no money figure. */
+        stillWorking: string;
+        /** I upgrade link. Change plan stays off. */
+        seeHigherLimit: string;
+        /** I used-of-allowance line. `{used}` `{total}` `{unit}`. */
+        usedOfAllowance: string;
+        /** J StatusDot. `{date}` is month + day. */
+        activeUntil: string;
+        /** J plan line. `{plan}` `{date}`. */
+        cancelledPlanLine: string;
+        /** J headline. `{days}`. */
+        daysLeftTitle: string;
+        /** J body. `{date}` is month + day. */
+        cancelledBody: string;
+        /** J secondary CTA. `{plan}`. */
+        reactivatePlan: string;
     };
     customerPortal: {
         launchButton: string;
@@ -4255,6 +4511,37 @@ interface SolvaPayCopy {
         topUpCta: string;
         upgradeCta: string;
         refreshCta: string;
+        /** FactBand eyebrows. */
+        remainingEyebrow: string;
+        renewsEyebrow: string;
+        resetsEyebrow: string;
+        creditsEyebrow: string;
+        usedEyebrow: string;
+        /** "{remaining} {unit}" — wide Remaining headline. */
+        remainingCalls: string;
+        /** "{remaining} of {total} {unit}" — compact Remaining value. */
+        remainingOfTotal: string;
+        /** "Of {total} this period." */
+        ofTotalThisPeriod: string;
+        /** "{used} of {total} {unit} used, {percent}%." */
+        usedOfTotalPercent: string;
+        warningThresholdHint: string;
+        lastCallHint: string;
+        afterFirstCall: string;
+        /** FactBand Renews/Resets caption. */
+        inDays: string;
+        notKnownYet: string;
+        creditsNotUsed: string;
+        creditsUntouched: string;
+        /** Fullscreen C credits caption. Widget C/E keep `creditsUntouched`. */
+        creditsDoNotSpend: string;
+        rateConfirmedAtCheckout: string;
+        fromCreditsPerCall: string;
+        creditsPerCall: string;
+        /** Accent pills: D / I / F. */
+        callsFailing: string;
+        overAllowance: string;
+        limitReached: string;
     };
 }
 /**
@@ -4304,6 +4591,18 @@ interface TransportLimitsResult {
     needsUpgrade?: boolean;
     /** The customer was auto-upgraded and access was restored. */
     upgraded?: boolean;
+    /**
+     * Consumed units this period. Present only when the backend measured
+     * a finite cap. Authoritative — do not reconstruct from
+     * `purchase.usage.used`.
+     */
+    used?: number;
+    /**
+     * The effective finite cap for this meter. Present only when the
+     * backend measured a finite cap. Authoritative — do not reconstruct
+     * as `used + remaining`.
+     */
+    limit?: number;
 }
 interface TransportCheckoutSessionResult {
     checkoutUrl: string;
@@ -4323,11 +4622,12 @@ interface TransportCustomerSessionResult {
 interface SolvaPayTransport {
     /**
      * Read tools. HTTP transports implement these via `GET /api/*` routes.
-     * MCP adapters omit them because the data is delivered on the
-     * bootstrap payload (see `BootstrapPayload.customer` / `merchant` /
-     * `product` / `plans` in `@solvapay/mcp`). Hooks consume these via
-     * module-level caches that the MCP host seeds at mount time, so the
-     * transport path is only exercised on HTTP.
+     * MCP adapters omit reads for data the bootstrap already holds
+     * (purchase, merchant, product, plans, payment method, balance,
+     * usage, limits) — `seedMcpCaches` hydrates those. That invariant is
+     * "do not refetch what bootstrap already has", not a blanket ban.
+     * `getHistory` is the exception: charge / credit activity is not on
+     * bootstrap (`checkPurchaseCore` is active-only).
      */
     checkPurchase?: () => Promise<CustomerPurchaseData>;
     getBalance?: () => Promise<TransportBalanceResult>;
@@ -4356,16 +4656,24 @@ interface SolvaPayTransport {
     /**
      * Optional: fetch the customer's runtime allowance for a (product, meter)
      * pair. HTTP transports implement via
-     * `GET /api/limits?productRef=…&meterName=…`. MCP adapters typically omit
-     * — the value lives on the bootstrap payload and refreshes via
-     * `refreshBootstrap()`. When undefined, `useLimits()` returns `null` for
-     * `remaining` / `withinLimits` with `loading: false` (graceful fallback,
-     * matching `useUsage`'s behaviour when `getUsage` is absent).
+     * `GET /api/limits?productRef=…&meterName=…`. MCP adapters omit the
+     * method — bootstrap seeds `limitsCache` and `useUsage` prefers the
+     * seeded snapshot. When undefined and nothing is seeded, `useLimits()`
+     * returns `null` for `remaining` / `withinLimits` with `loading: false`.
      */
     getLimits?: (params: {
         productRef: string;
         meterName?: string;
     }) => Promise<TransportLimitsResult>;
+    /**
+     * Product-scoped charges plus account-wide credit activity. Fetch on
+     * history-section mount, not app mount. HTTP: `GET /api/history`.
+     * MCP: `get_history` UI-only tool.
+     */
+    getHistory?: (params?: {
+        productRef?: string;
+        limit?: number;
+    }) => Promise<GetHistoryResult>;
     createPayment: (params: {
         planRef?: string;
         productRef?: string;
@@ -4409,6 +4717,10 @@ interface SolvaPayTransport {
         isBusiness: boolean;
         businessName?: string;
         country?: string;
+        customerCountry?: string;
+        customerName?: string;
+        customerState?: string;
+        customerPostalCode?: string;
         taxId?: string;
         taxIdType?: TaxIdType;
     }) => Promise<{
@@ -4451,40 +4763,10 @@ interface PaymentIntentResult {
     processorPaymentId?: string;
 }
 /**
- * Subset of merchant identity surfaced by `GET /v1/sdk/merchant`.
+ * 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;
-    /** Company registration number (EIN, Companies House No, Org No). */
-    companyNumber?: string;
-    /** Tax identification number (US: EIN). */
-    taxId?: string;
-    /** VAT identification number (UK/EU). */
-    vatNumber?: string;
-    defaultCurrency?: string;
-    /**
-     * Full set of currencies (including `defaultCurrency`) the customer may
-     * pay credit topups in. Surfaced only when the merchant enabled more than
-     * one — single-currency merchants leave this undefined and keep today's
-     * behavior. Drives the topup currency switcher in the PAYG amount step.
-     */
-    supportedTopupCurrencies?: string[];
-    statementDescriptor?: string;
-    logoUrl?: string;
-    /**
-     * Absolute URL to a square app icon / logomark. Preferred over
-     * `logoUrl` for avatar slots and chrome-strip icons that can't
-     * letterbox a landscape mark.
-     */
-    iconUrl?: string;
-}
+type Merchant = SdkMerchantResponse;
 interface UseMerchantReturn {
     merchant: Merchant | null;
     loading: boolean;
@@ -4583,6 +4865,12 @@ interface TopupFormProps {
     submitButtonText?: string;
     className?: string;
     buttonClassName?: string;
+    /**
+     * Stripe Elements appearance. When omitted, the form reads `--solvapay-*`
+     * tokens from the form root and builds a host-matched appearance. Pass
+     * `null` to restore Stripe's default theme.
+     */
+    appearance?: Appearance | null;
 }
 interface PurchaseStatus {
     loading: boolean;
@@ -4663,6 +4951,7 @@ interface SolvaPayProviderInitial {
     paymentMethod: PaymentMethodInfo | null;
     balance: CustomerBalanceResult | null;
     usage: GetUsageResult | null;
+    limits: LimitResponseWithPlan | null;
     merchant: Merchant;
     product: Product;
     plans: Plan[];
@@ -4692,6 +4981,7 @@ interface SolvaPayConfig {
         autoRecharge?: string;
         getUsage?: string;
         getLimits?: string;
+        getHistory?: string;
     };
     /**
      * Data-access transport. Replaces the default HTTP calls with any
@@ -4843,6 +5133,10 @@ interface SolvaPayContextValue {
         isBusiness: boolean;
         businessName?: string;
         country?: string;
+        customerCountry?: string;
+        customerName?: string;
+        customerState?: string;
+        customerPostalCode?: string;
         taxId?: string;
         taxIdType?: _solvapay_core.TaxIdType;
     }) => Promise<{
@@ -5134,6 +5428,12 @@ interface PaymentFormProps {
     requireTermsAcceptance?: boolean;
     /** Fired when business-details attach returns an updated tax breakdown. */
     onTaxChange?: (breakdown: _solvapay_core.TaxBreakdown) => void;
+    /**
+     * Stripe Elements appearance. When omitted, the form reads `--solvapay-*`
+     * tokens from the form root and builds a host-matched appearance. Pass
+     * `null` to restore Stripe's default theme.
+     */
+    appearance?: Appearance | null;
 }
 interface UseTopupAmountSelectorOptions {
     currency: string;
@@ -5171,16 +5471,17 @@ type CheckoutStep = 'plan' | 'amount' | 'payment' | 'success';
  *
  * Mirrors what the API actually sends: pricing lives in `options[]`, and
  * the only derived scalars on the wire are `type`, `price`, `currency`
- * and `requiresPayment`.
+ * and `requiresPayment`. Every field admits `null` because frozen plan
+ * snapshots send it explicitly; it is read as "absent" throughout.
  */
 interface BootstrapPlanLike {
-    reference?: string;
-    name?: string;
-    type?: string;
-    price?: number;
-    currency?: string;
-    requiresPayment?: boolean;
-    options?: PricingOptionLike[];
+    reference?: string | null;
+    name?: string | null;
+    type?: string | null;
+    price?: number | null;
+    currency?: string | null;
+    requiresPayment?: boolean | null;
+    options?: PricingOptionLike[] | null;
     pricingOptions?: Array<{
         currency: string;
         price: number;
@@ -5210,4 +5511,37 @@ type SuccessMeta = {
     nextRenewalLabel: string | null;
 };
 
-export { type components as $, type ActivationResult as A, type BalanceStatus as B, type CheckoutResult as C, type BootstrapPlanLike as D, type CheckoutStep as E, type CustomerPurchaseData as F, type MandateTemplate as G, type Merchant as H, type PaymentError as I, type PaymentIntentResult as J, type PaymentMethodInfo as K, type PaymentResult as L, type MandateContext as M, type PurchaseStatusValue as N, type SuccessMeta as O, type PaymentFormProps as P, type TopupPaymentResult as Q, type ReactivateResult as R, type SolvaPayProviderProps as S, type TopupFormProps as T, type UsePlansOptions as U, type TransportBalanceResult as V, type TransportCheckoutSessionResult as W, type TransportCustomerSessionResult as X, type TransportLimitsResult as Y, UnsupportedTransportMethodError as Z, type SolvaPayProviderInitial as _, type PrefillCustomer as a, type AutoRechargeInput as a0, type AutoRechargeDisplayBlock as a1, type Plan as b, type SaveAutoRechargeResponse as c, type PurchaseStatus as d, type SolvaPayContextValue as e, type UsePlansReturn as f, type UsePlanOptions as g, type UsePlanReturn as h, type UseProductReturn as i, type UseMerchantReturn as j, type SolvaPayCopy as k, type PurchaseStatusReturn as l, type CancelResult as m, type ActivatePlanResult as n, type UseTopupOptions as o, type UseTopupReturn as p, type UseTopupAmountSelectorOptions as q, type UseTopupAmountSelectorReturn as r, type UsePaymentMethodReturn as s, type AutoRechargeConfig as t, type SaveAutoRechargeInput as u, type SolvaPayTransport as v, type PartialSolvaPayCopy as w, type PurchaseInfo as x, type Product as y, type SolvaPayConfig as z };
+interface UseUsageReturn {
+    /** Raw usage snapshot (`null` when no usage-based plan is active). */
+    usage: UsageSnapshot | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+    /** 0-100, rounded to 2dp. `null` when total is unknown (unlimited/empty). */
+    percentUsed: number | null;
+    /** Plan is usage-based, `percentUsed >= 80`. */
+    isApproachingLimit: boolean;
+    /** Plan is usage-based, `percentUsed >= 100`. */
+    isAtLimit: boolean;
+    /**
+     * True when the backend reports no finite cap on this meter. Sourced
+     * from `useLimits().unlimited`, never inferred from a missing `total`
+     * — an unknown cap is not an absent one.
+     */
+    isUnlimited: boolean;
+    /** The meter reference (e.g. `'tokens'`). `null` when not usage-based. */
+    meterRef: string | null;
+}
+interface UsageSnapshot {
+    meterRef: string | null;
+    total: number | null;
+    used: number;
+    remaining: number | null;
+    percentUsed: number | null;
+    periodStart?: string;
+    periodEnd?: string;
+    purchaseRef?: string;
+}
+declare function useUsage(): UseUsageReturn;
+
+export { type UseUsageReturn as $, type ActivationResult as A, type BootstrapPlanLike as B, type CheckoutResult as C, type SolvaPayConfig as D, type CheckoutStep as E, type CustomerPurchaseData as F, type MandateTemplate as G, type Merchant as H, type PaymentError as I, type PaymentIntentResult as J, type PaymentMethodInfo as K, type PaymentResult as L, type MandateContext as M, type PurchaseStatusValue as N, type SuccessMeta as O, type PaymentFormProps as P, type TopupPaymentResult as Q, type ReactivateResult as R, type SolvaPayProviderProps as S, type TopupFormProps as T, type UsePlansOptions as U, type TransportBalanceResult as V, type TransportCheckoutSessionResult as W, type TransportCustomerSessionResult as X, type TransportLimitsResult as Y, UnsupportedTransportMethodError as Z, type UsageSnapshot as _, type PrefillCustomer as a, useUsage as a0, type SolvaPayProviderInitial as a1, type CreditActivityType as a2, type CreditActivityEntry as a3, type components as a4, type AutoRechargeInput as a5, type AutoRechargeDisplayBlock as a6, type Plan as b, type SaveAutoRechargeResponse as c, type PurchaseStatus as d, type SolvaPayContextValue as e, type UsePlansReturn as f, type UsePlanOptions as g, type UsePlanReturn as h, type UseProductReturn as i, type UseMerchantReturn as j, type SolvaPayCopy as k, type PurchaseStatusReturn as l, type CancelResult as m, type ActivatePlanResult as n, type UseTopupOptions as o, type UseTopupReturn as p, type BalanceStatus as q, type UseTopupAmountSelectorOptions as r, type UseTopupAmountSelectorReturn as s, type UsePaymentMethodReturn as t, type AutoRechargeConfig as u, type SaveAutoRechargeInput as v, type SolvaPayTransport as w, type PartialSolvaPayCopy as x, type PurchaseInfo as y, type Product as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvapay/react",
-  "version": "2.1.1",
+  "version": "2.2.0-preview-e3e546693c002c32f128d83bf6c5fe76ac182a79",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -57,7 +57,7 @@
     "directory": "packages/react"
   },
   "peerDependencies": {
-    "@solvapay/mcp-core": "^0.2.8 || ^0.3.0",
+    "@solvapay/mcp-core": "0.4.0-preview-e3e546693c002c32f128d83bf6c5fe76ac182a79",
     "react": "^18.2.0 || ^19.0.0",
     "react-dom": "^18.2.0 || ^19.0.0"
   },
@@ -69,7 +69,7 @@
   "dependencies": {
     "@stripe/react-stripe-js": "^6.0.0",
     "@stripe/stripe-js": "^9.0.0",
-    "@solvapay/core": "1.6.0"
+    "@solvapay/core": "1.6.0-preview-e3e546693c002c32f128d83bf6c5fe76ac182a79"
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",
@@ -85,8 +85,8 @@
     "react-dom": "^19.2.5",
     "typescript": "^5.9.3",
     "vitest": "^4.1.2",
-    "@solvapay/mcp-core": "0.3.4",
-    "@solvapay/server": "2.3.1",
+    "@solvapay/mcp-core": "0.4.0-preview-e3e546693c002c32f128d83bf6c5fe76ac182a79",
+    "@solvapay/server": "2.4.0-preview-e3e546693c002c32f128d83bf6c5fe76ac182a79",
     "@solvapay/test-utils": "0.0.0"
   },
   "scripts": {