@solvapay/react 1.0.8-preview.5 → 1.0.8-preview.7

package/dist/src/hooks/useSolvaPay.js

@@ -0,0 +1,52 @@
+import { useContext } from 'react';
+import { SolvaPayContext } from '../SolvaPayProvider';
+/**
+ * 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.
+ *
+ * Must be used within a `SolvaPayProvider` component.
+ *
+ * @returns SolvaPay context value with all provider methods and state
+ * @returns subscription - Subscription 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
+ *
+ * @example
+ * ```tsx
+ * import { useSolvaPay } from '@solvapay/react';
+ *
+ * function CustomComponent() {
+ *   const { subscription, createPayment, processPayment } = useSolvaPay();
+ *
+ *   const handlePayment = async () => {
+ *     const intent = await createPayment({
+ *       planRef: 'pln_premium',
+ *       agentRef: 'agt_myapi'
+ *     });
+ *     // Process payment...
+ *   };
+ *
+ *   return <div>Subscription status: {subscription.hasPaidSubscription ? '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 useCheckout} for checkout-specific hook
+ * @since 1.0.0
+ */
+export function useSolvaPay() {
+    const context = useContext(SolvaPayContext);
+    if (!context) {
+        throw new Error('useSolvaPay must be used within a SolvaPayProvider. ' +
+            'Wrap your component tree with <SolvaPayProvider> to use this hook.');
+    }
+    return context;
+}
+//# sourceMappingURL=useSolvaPay.js.map

package/dist/src/hooks/useSolvaPay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSolvaPay.js","sourceRoot":"","sources":["../../../src/hooks/useSolvaPay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAGrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAA;IAE3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,sDAAsD;YACpD,oEAAoE,CACvE,CAAA;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/src/hooks/useSubscription.d.ts

@@ -0,0 +1,46 @@
+import type { SubscriptionStatus } from '../types';
+/**
+ * Hook to get current subscription status and information.
+ *
+ * Returns the current user's subscription status, including active
+ * subscriptions, 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 isLoading - Loading state
+ * @returns error - Error state if subscription check fails
+ * @returns refetch - Function to manually refetch subscription data
+ *
+ * @example
+ * ```tsx
+ * import { useSubscription } from '@solvapay/react';
+ *
+ * function Dashboard() {
+ *   const { subscriptions, hasPaidSubscription, isLoading, refetch } = useSubscription();
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   if (!hasPaidSubscription) {
+ *     return <UpgradePrompt />;
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       <h2>Welcome, Premium User!</h2>
+ *       <p>Active subscriptions: {subscriptions.length}</p>
+ *       <button onClick={() => refetch()}>Refresh</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @see {@link SolvaPayProvider} for required context provider
+ * @see {@link useSubscriptionStatus} for detailed status information
+ * @since 1.0.0
+ */
+export declare function useSubscription(): SubscriptionStatus & {
+    refetch: () => Promise<void>;
+};
+//# sourceMappingURL=useSubscription.d.ts.map

package/dist/src/hooks/useSubscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubscription.d.ts","sourceRoot":"","sources":["../../../src/hooks/useSubscription.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,eAAe,IAAI,kBAAkB,GAAG;IAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAOvF"}

package/dist/src/hooks/useSubscription.js

@@ -0,0 +1,50 @@
+import { useSolvaPay } from './useSolvaPay';
+/**
+ * Hook to get current subscription status and information.
+ *
+ * Returns the current user's subscription status, including active
+ * subscriptions, 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 isLoading - Loading state
+ * @returns error - Error state if subscription check fails
+ * @returns refetch - Function to manually refetch subscription data
+ *
+ * @example
+ * ```tsx
+ * import { useSubscription } from '@solvapay/react';
+ *
+ * function Dashboard() {
+ *   const { subscriptions, hasPaidSubscription, isLoading, refetch } = useSubscription();
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   if (!hasPaidSubscription) {
+ *     return <UpgradePrompt />;
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       <h2>Welcome, Premium User!</h2>
+ *       <p>Active subscriptions: {subscriptions.length}</p>
+ *       <button onClick={() => refetch()}>Refresh</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @see {@link SolvaPayProvider} for required context provider
+ * @see {@link useSubscriptionStatus} for detailed status information
+ * @since 1.0.0
+ */
+export function useSubscription() {
+    const { subscription, refetchSubscription } = useSolvaPay();
+    return {
+        ...subscription,
+        refetch: refetchSubscription,
+    };
+}
+//# sourceMappingURL=useSubscription.js.map

package/dist/src/hooks/useSubscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubscription.js","sourceRoot":"","sources":["../../../src/hooks/useSubscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAG3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,EAAE,YAAY,EAAE,mBAAmB,EAAE,GAAG,WAAW,EAAE,CAAA;IAE3D,OAAO;QACL,GAAG,YAAY;QACf,OAAO,EAAE,mBAAmB;KAC7B,CAAA;AACH,CAAC"}

package/dist/src/hooks/useSubscriptionStatus.d.ts

@@ -0,0 +1,19 @@
+import type { SubscriptionStatusReturn } from '../types';
+/**
+ * Hook providing advanced status and helper functions for subscription management
+ *
+ * Focuses on cancelled subscription logic and date formatting utilities.
+ * For basic subscription data and paid status checks, use useSubscription() instead.
+ *
+ * @example
+ * ```tsx
+ * const { cancelledSubscription, shouldShowCancelledNotice, formatDate, getDaysUntilExpiration } = useSubscriptionStatus();
+ *
+ * if (shouldShowCancelledNotice && cancelledSubscription) {
+ *   const formattedDate = formatDate(cancelledSubscription.endDate);
+ *   const daysLeft = getDaysUntilExpiration(cancelledSubscription.endDate);
+ * }
+ * ```
+ */
+export declare function useSubscriptionStatus(): SubscriptionStatusReturn;
+//# sourceMappingURL=useSubscriptionStatus.d.ts.map

package/dist/src/hooks/useSubscriptionStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubscriptionStatus.d.ts","sourceRoot":"","sources":["../../../src/hooks/useSubscriptionStatus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,wBAAwB,EAAE,MAAM,UAAU,CAAA;AAG1E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,IAAI,wBAAwB,CAyDhE"}

package/dist/src/hooks/useSubscriptionStatus.js

@@ -0,0 +1,68 @@
+import { useMemo, useCallback } from 'react';
+import { useSubscription } from './useSubscription';
+/**
+ * Hook providing advanced status and helper functions for subscription management
+ *
+ * Focuses on cancelled subscription logic and date formatting utilities.
+ * For basic subscription data and paid status checks, use useSubscription() instead.
+ *
+ * @example
+ * ```tsx
+ * const { cancelledSubscription, shouldShowCancelledNotice, formatDate, getDaysUntilExpiration } = useSubscriptionStatus();
+ *
+ * if (shouldShowCancelledNotice && cancelledSubscription) {
+ *   const formattedDate = formatDate(cancelledSubscription.endDate);
+ *   const daysLeft = getDaysUntilExpiration(cancelledSubscription.endDate);
+ * }
+ * ```
+ */
+export function useSubscriptionStatus() {
+    const { subscriptions } = useSubscription();
+    // Helper to check if a subscription is paid
+    // Only uses amount field: amount > 0 = paid, amount === 0 or undefined = free
+    const isPaidSubscription = useCallback((sub) => {
+        return (sub.amount ?? 0) > 0;
+    }, []);
+    // Memoize subscription calculations for cancelled subscriptions
+    // Backend keeps cancelled subscriptions as 'active' until expiration, tracked via cancelledAt
+    const subscriptionData = useMemo(() => {
+        const cancelledPaidSubscriptions = subscriptions.filter(sub => {
+            const subAny = sub; // Type assertion to access optional properties
+            // Look for subscriptions with cancelledAt set and status === 'active'
+            return sub.status === 'active' && subAny.cancelledAt && isPaidSubscription(sub);
+        });
+        const cancelledSubscription = cancelledPaidSubscriptions.sort((a, b) => new Date(b.startDate).getTime() - new Date(a.startDate).getTime())[0] || null;
+        const shouldShowCancelledNotice = !!cancelledSubscription;
+        return {
+            cancelledSubscription,
+            shouldShowCancelledNotice,
+        };
+    }, [subscriptions, isPaidSubscription]);
+    // Format date helper
+    const formatDate = useCallback((dateString) => {
+        if (!dateString)
+            return null;
+        return new Date(dateString).toLocaleDateString('en-US', {
+            year: 'numeric',
+            month: 'long',
+            day: 'numeric',
+        });
+    }, []);
+    // Calculate days until expiration
+    const getDaysUntilExpiration = useCallback((endDate) => {
+        if (!endDate)
+            return null;
+        const now = new Date();
+        const expiration = new Date(endDate);
+        const diffTime = expiration.getTime() - now.getTime();
+        const diffDays = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
+        return diffDays > 0 ? diffDays : 0;
+    }, []);
+    return {
+        cancelledSubscription: subscriptionData.cancelledSubscription,
+        shouldShowCancelledNotice: subscriptionData.shouldShowCancelledNotice,
+        formatDate,
+        getDaysUntilExpiration,
+    };
+}
+//# sourceMappingURL=useSubscriptionStatus.js.map

package/dist/src/hooks/useSubscriptionStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubscriptionStatus.js","sourceRoot":"","sources":["../../../src/hooks/useSubscriptionStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,EAAE,aAAa,EAAE,GAAG,eAAe,EAAE,CAAA;IAE3C,4CAA4C;IAC5C,8EAA8E;IAC9E,MAAM,kBAAkB,GAAG,WAAW,CAAC,CAAC,GAAqB,EAAW,EAAE;QACxE,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,gEAAgE;IAChE,8FAA8F;IAC9F,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,EAAE;QACpC,MAAM,0BAA0B,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;YAC5D,MAAM,MAAM,GAAG,GAAU,CAAA,CAAC,+CAA+C;YACzE,sEAAsE;YACtE,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAA;QACjF,CAAC,CAAC,CAAA;QAEF,MAAM,qBAAqB,GACzB,0BAA0B,CAAC,IAAI,CAC7B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAC5E,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;QAEd,MAAM,yBAAyB,GAAG,CAAC,CAAC,qBAAqB,CAAA;QAEzD,OAAO;YACL,qBAAqB;YACrB,yBAAyB;SAC1B,CAAA;IACH,CAAC,EAAE,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC,CAAA;IAEvC,qBAAqB;IACrB,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,UAAmB,EAAiB,EAAE;QACpE,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAA;QAC5B,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE;YACtD,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,MAAM;YACb,GAAG,EAAE,SAAS;SACf,CAAC,CAAA;IACJ,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,kCAAkC;IAClC,MAAM,sBAAsB,GAAG,WAAW,CAAC,CAAC,OAAgB,EAAiB,EAAE;QAC7E,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAA;QACzB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;QACtB,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAA;QACpC,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAA;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;QAC5D,OAAO,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IACpC,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO;QACL,qBAAqB,EAAE,gBAAgB,CAAC,qBAAqB;QAC7D,yBAAyB,EAAE,gBAAgB,CAAC,yBAAyB;QACrE,UAAU;QACV,sBAAsB;KACvB,CAAA;AACH,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @solvapay/react - Payment components for SolvaPay
+ *
+ * Provides headless React components and hooks for handling payment flows.
+ */
+export { SolvaPayProvider } from './SolvaPayProvider';
+export { PaymentForm } from './PaymentForm';
+export { PlanBadge } from './components/PlanBadge';
+export { SubscriptionGate } from './components/SubscriptionGate';
+export { PlanSelector } from './components/PlanSelector';
+export { Spinner } from './components/Spinner';
+export { StripePaymentFormWrapper } from './components/StripePaymentFormWrapper';
+export { useSubscription } from './hooks/useSubscription';
+export { useCustomer } from './hooks/useCustomer';
+export { useCheckout } from './hooks/useCheckout';
+export { useSolvaPay } from './hooks/useSolvaPay';
+export { usePlans } from './hooks/usePlans';
+export { useSubscriptionStatus } from './hooks/useSubscriptionStatus';
+export type { SolvaPayConfig, SolvaPayProviderProps, SolvaPayContextValue, SubscriptionStatus, SubscriptionInfo, CustomerSubscriptionData, PaymentIntentResult, PlanBadgeProps, SubscriptionGateProps, PlanSelectorProps, PaymentFormProps, PaymentError, Plan, UsePlansOptions, UsePlansReturn, SubscriptionStatusReturn, } from './types';
+export type { CustomerInfo } from './hooks/useCustomer';
+export type { AuthAdapter } from './adapters/auth';
+export { defaultAuthAdapter } from './adapters/auth';
+export { filterSubscriptions, getActiveSubscriptions, getCancelledSubscriptionsWithEndDate, getMostRecentSubscription, getPrimarySubscription, isPaidSubscription, } from './utils/subscriptions';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAG3C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAGhF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAGrE,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,IAAI,EACJ,eAAe,EACf,cAAc,EACd,wBAAwB,GACzB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGvD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGpD,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oCAAoC,EACpC,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,26 @@
+/**
+ * @solvapay/react - Payment components for SolvaPay
+ *
+ * Provides headless React components and hooks for handling payment flows.
+ */
+// Core Provider
+export { SolvaPayProvider } from './SolvaPayProvider';
+// Payment Form
+export { PaymentForm } from './PaymentForm';
+// Headless Components
+export { PlanBadge } from './components/PlanBadge';
+export { SubscriptionGate } from './components/SubscriptionGate';
+export { PlanSelector } from './components/PlanSelector';
+export { Spinner } from './components/Spinner';
+export { StripePaymentFormWrapper } from './components/StripePaymentFormWrapper';
+// Hooks
+export { useSubscription } from './hooks/useSubscription';
+export { useCustomer } from './hooks/useCustomer';
+export { useCheckout } from './hooks/useCheckout';
+export { useSolvaPay } from './hooks/useSolvaPay';
+export { usePlans } from './hooks/usePlans';
+export { useSubscriptionStatus } from './hooks/useSubscriptionStatus';
+export { defaultAuthAdapter } from './adapters/auth';
+// Utilities
+export { filterSubscriptions, getActiveSubscriptions, getCancelledSubscriptionsWithEndDate, getMostRecentSubscription, getPrimarySubscription, isPaidSubscription, } from './utils/subscriptions';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,sBAAsB;AACtB,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAEhF,QAAQ;AACR,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAyBrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEpD,YAAY;AACZ,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oCAAoC,EACpC,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA"}

package/dist/src/types/index.d.ts

@@ -0,0 +1,339 @@
+/**
+ * TypeScript type definitions for @solvapay/react
+ */
+import type { PaymentIntent } from '@stripe/stripe-js';
+import type { ProcessPaymentResult } from '@solvapay/server';
+import type { AuthAdapter } from '../adapters/auth';
+export interface SubscriptionInfo {
+    reference: string;
+    planName: string;
+    agentName: string;
+    status: string;
+    startDate: string;
+    endDate?: string;
+    cancelledAt?: string;
+    cancellationReason?: string;
+    amount?: number;
+}
+export interface CustomerSubscriptionData {
+    customerRef?: string;
+    email?: string;
+    name?: string;
+    subscriptions: SubscriptionInfo[];
+}
+export interface PaymentIntentResult {
+    clientSecret: string;
+    publishableKey: string;
+    accountId?: string;
+    customerRef?: string;
+}
+export interface SubscriptionStatus {
+    loading: boolean;
+    customerRef?: string;
+    email?: string;
+    name?: string;
+    subscriptions: SubscriptionInfo[];
+    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
+     */
+    activeSubscription: SubscriptionInfo | 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.
+     */
+    hasPaidSubscription: boolean;
+    /**
+     * Most recent active paid subscription (sorted by startDate)
+     * Returns subscription with status === 'active' and amount > 0.
+     * null if no active paid subscription exists
+     */
+    activePaidSubscription: SubscriptionInfo | null;
+}
+/**
+ * SolvaPay Provider Configuration
+ * Sensible defaults for minimal code, but fully customizable
+ */
+export interface SolvaPayConfig {
+    /**
+     * API route configuration
+     * Defaults to standard Next.js API routes
+     */
+    api?: {
+        checkSubscription?: string;
+        createPayment?: string;
+        processPayment?: string;
+    };
+    /**
+     * 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;
+}
+export interface SolvaPayContextValue {
+    subscription: SubscriptionStatus;
+    refetchSubscription: () => Promise<void>;
+    createPayment: (params: {
+        planRef: string;
+        agentRef?: string;
+    }) => Promise<PaymentIntentResult>;
+    processPayment?: (params: {
+        paymentIntentId: string;
+        agentRef: string;
+        planRef?: string;
+    }) => Promise<ProcessPaymentResult>;
+    customerRef?: string;
+    updateCustomerRef?: (newCustomerRef: string) => void;
+}
+export 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;
+        agentRef?: string;
+    }) => Promise<PaymentIntentResult>;
+    checkSubscription?: () => Promise<CustomerSubscriptionData>;
+    processPayment?: (params: {
+        paymentIntentId: string;
+        agentRef: string;
+        planRef?: string;
+    }) => Promise<ProcessPaymentResult>;
+    children: React.ReactNode;
+}
+export interface PlanBadgeProps {
+    children?: (props: {
+        subscriptions: SubscriptionInfo[];
+        loading: boolean;
+        displayPlan: string | null;
+        shouldShow: boolean;
+    }) => React.ReactNode;
+    as?: React.ElementType;
+    className?: string | ((props: {
+        subscriptions: SubscriptionInfo[];
+    }) => string);
+}
+export interface SubscriptionGateProps {
+    requirePlan?: string;
+    children: (props: {
+        hasAccess: boolean;
+        subscriptions: SubscriptionInfo[];
+        loading: boolean;
+    }) => React.ReactNode;
+}
+/**
+ * Error type for payment operations
+ */
+export interface PaymentError extends Error {
+    code?: string;
+    type?: string;
+}
+/**
+ * Plan interface for subscription plans
+ */
+export interface Plan {
+    reference: string;
+    name: string;
+    description?: string;
+    price?: number;
+    currency?: string;
+    interval?: string;
+    features?: string[];
+    isFreeTier?: boolean;
+    metadata?: Record<string, any>;
+}
+/**
+ * Options for usePlans hook
+ */
+export interface UsePlansOptions {
+    /**
+     * Fetcher function to retrieve plans
+     */
+    fetcher: (agentRef: string) => Promise<Plan[]>;
+    /**
+     * Agent reference to fetch plans for
+     */
+    agentRef?: string;
+    /**
+     * Optional filter function to filter plans
+     */
+    filter?: (plan: Plan) => boolean;
+    /**
+     * Optional sort function to sort plans
+     */
+    sortBy?: (a: Plan, b: Plan) => number;
+    /**
+     * Auto-select first paid plan on load
+     */
+    autoSelectFirstPaid?: boolean;
+}
+/**
+ * Return type for usePlans hook
+ */
+export 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>;
+}
+/**
+ * Props for headless PlanSelector component
+ */
+export interface PlanSelectorProps {
+    /**
+     * Agent reference to fetch plans for
+     */
+    agentRef?: string;
+    /**
+     * Fetcher function to retrieve plans
+     */
+    fetcher: (agentRef: string) => Promise<Plan[]>;
+    /**
+     * Optional filter function
+     */
+    filter?: (plan: Plan) => boolean;
+    /**
+     * Optional sort function
+     */
+    sortBy?: (a: Plan, b: Plan) => number;
+    /**
+     * Auto-select first paid plan on load
+     */
+    autoSelectFirstPaid?: boolean;
+    /**
+     * Render prop function
+     */
+    children: (props: UsePlansReturn & {
+        subscriptions: SubscriptionInfo[];
+        isPaidPlan: (planName: string) => boolean;
+        isCurrentPlan: (planName: string) => boolean;
+    }) => React.ReactNode;
+}
+/**
+ * Return type for useSubscriptionStatus 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.
+ */
+export interface SubscriptionStatusReturn {
+    /**
+     * Most recent cancelled paid subscription (sorted by startDate)
+     * null if no cancelled paid subscription exists
+     */
+    cancelledSubscription: SubscriptionInfo | null;
+    /**
+     * Whether to show cancelled subscription notice
+     * true if cancelledSubscription 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
+ */
+export interface PaymentFormProps {
+    /**
+     * Plan reference to checkout. PaymentForm handles the entire checkout flow internally
+     * including Stripe initialization and payment intent creation.
+     */
+    planRef: string;
+    /**
+     * Agent reference. Required for processing payment after confirmation.
+     */
+    agentRef?: string;
+    /**
+     * Callback when payment succeeds
+     */
+    onSuccess?: (paymentIntent: PaymentIntent) => 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;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"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"}