@digilogiclabs/saas-factory-payments 0.1.0

package/dist/web/index.d.mts

@@ -0,0 +1,281 @@
+import React from 'react';
+import { Stripe, StripeElements } from '@stripe/stripe-js';
+
+interface CheckoutButtonProps {
+    priceId: string;
+    customerId?: string;
+    customerEmail?: string;
+    successUrl?: string;
+    cancelUrl?: string;
+    children: React.ReactNode;
+    className?: string;
+    disabled?: boolean;
+    allowPromotionCodes?: boolean;
+    billingAddressCollection?: 'auto' | 'required';
+    metadata?: Record<string, string>;
+    trialPeriodDays?: number;
+    onSuccess?: () => void;
+    onError?: (error: string) => void;
+    onLoading?: (loading: boolean) => void;
+}
+declare const CheckoutButton: React.FC<CheckoutButtonProps>;
+
+interface Subscription {
+    id: string;
+    customerId: string;
+    priceId: string;
+    status: 'active' | 'canceled' | 'past_due' | 'unpaid' | 'incomplete' | 'incomplete_expired' | 'trialing';
+    currentPeriodStart: Date;
+    currentPeriodEnd: Date;
+    cancelAtPeriodEnd: boolean;
+    trialEnd?: Date;
+    trialStart?: Date;
+    canceledAt?: Date;
+    endedAt?: Date;
+    metadata?: Record<string, string>;
+}
+
+interface Customer {
+    id: string;
+    email: string;
+    name?: string;
+    phone?: string;
+    stripeCustomerId?: string;
+    subscriptions: Subscription[];
+    defaultPaymentMethodId?: string;
+    metadata?: Record<string, string>;
+    created: Date;
+    updated: Date;
+}
+interface PaymentMethod {
+    id: string;
+    type: 'card' | 'bank_account' | 'sepa_debit' | 'ideal' | 'sofort';
+    card?: {
+        brand: string;
+        last4: string;
+        expMonth: number;
+        expYear: number;
+        country?: string;
+    };
+    bankAccount?: {
+        last4: string;
+        bankName?: string;
+        accountType?: string;
+    };
+    isDefault: boolean;
+    created: Date;
+}
+
+interface PaymentsConfig {
+    provider: 'stripe';
+    publishableKey: string;
+    secretKey?: string;
+    webhookSecret?: string;
+    environment: 'development' | 'production';
+    apiVersion?: string;
+}
+interface PricingPlan {
+    id: string;
+    name: string;
+    description?: string;
+    price: number;
+    currency: string;
+    interval: 'day' | 'week' | 'month' | 'year';
+    intervalCount?: number;
+    stripePriceId: string;
+    stripeProductId?: string;
+    features: string[];
+    popular?: boolean;
+    trialPeriodDays?: number;
+    metadata?: Record<string, string>;
+}
+interface CheckoutSessionParams {
+    priceId: string;
+    customerId?: string;
+    customerEmail?: string;
+    successUrl: string;
+    cancelUrl: string;
+    mode?: 'payment' | 'subscription' | 'setup';
+    allowPromotionCodes?: boolean;
+    billingAddressCollection?: 'auto' | 'required';
+    metadata?: Record<string, string>;
+    trialPeriodDays?: number;
+}
+
+interface PricingTableProps {
+    plans: PricingPlan[];
+    customerId?: string;
+    customerEmail?: string;
+    successUrl?: string;
+    cancelUrl?: string;
+    className?: string;
+    onPlanSelect?: (plan: PricingPlan) => void;
+    onCheckoutSuccess?: (plan: PricingPlan) => void;
+    onCheckoutError?: (plan: PricingPlan, error: string) => void;
+    showFeatures?: boolean;
+    showTrialInfo?: boolean;
+    layout?: 'grid' | 'list';
+    maxColumns?: number;
+}
+declare const PricingTable: React.FC<PricingTableProps>;
+
+interface PaymentFormProps {
+    clientSecret?: string;
+    customerId?: string;
+    customerEmail?: string;
+    amount?: number;
+    currency?: string;
+    description?: string;
+    metadata?: Record<string, string>;
+    onSuccess?: (paymentIntent: any) => void;
+    onError?: (error: string) => void;
+    onLoading?: (loading: boolean) => void;
+    className?: string;
+    showBillingDetails?: boolean;
+    elementType?: 'card' | 'payment';
+}
+declare const PaymentForm: React.FC<PaymentFormProps>;
+
+interface BillingPortalProps {
+    customerId: string;
+    returnUrl?: string;
+    children?: React.ReactNode;
+    className?: string;
+    onSuccess?: () => void;
+    onError?: (error: string) => void;
+    onLoading?: (loading: boolean) => void;
+}
+declare const BillingPortal: React.FC<BillingPortalProps>;
+
+interface StripeProviderProps {
+    children: React.ReactNode;
+    options?: {
+        fonts?: Array<{
+            cssSrc: string;
+        }>;
+        locale?: string;
+        apiVersion?: string;
+    };
+}
+declare const StripeProvider: React.FC<StripeProviderProps>;
+
+interface UseSubscriptionOptions {
+    customerId?: string;
+    subscriptionId?: string;
+    autoFetch?: boolean;
+    onError?: (error: string) => void;
+}
+interface UseSubscriptionReturn {
+    subscription: Subscription | null;
+    subscriptions: Subscription[];
+    loading: boolean;
+    error: string | null;
+    refetch: () => Promise<void>;
+    cancel: (subscriptionId?: string) => Promise<boolean>;
+    reactivate: (subscriptionId?: string) => Promise<boolean>;
+    updatePaymentMethod: (subscriptionId: string, paymentMethodId: string) => Promise<boolean>;
+}
+declare const useSubscription: (options?: UseSubscriptionOptions) => UseSubscriptionReturn;
+
+interface UseCheckoutOptions {
+    onSuccess?: (sessionId: string) => void;
+    onError?: (error: string) => void;
+    onLoading?: (loading: boolean) => void;
+}
+interface UseCheckoutReturn {
+    loading: boolean;
+    error: string | null;
+    createCheckoutSession: (params: CheckoutSessionParams) => Promise<string | null>;
+    redirectToCheckout: (params: CheckoutSessionParams) => Promise<boolean>;
+    createPaymentIntent: (params: {
+        amount: number;
+        currency: string;
+        customerId?: string;
+        description?: string;
+        metadata?: Record<string, string>;
+    }) => Promise<string | null>;
+}
+declare const useCheckout: (options?: UseCheckoutOptions) => UseCheckoutReturn;
+
+interface UseCustomerOptions {
+    customerId?: string;
+    autoFetch?: boolean;
+    onError?: (error: string) => void;
+}
+interface UseCustomerReturn {
+    customer: Customer | null;
+    paymentMethods: PaymentMethod[];
+    loading: boolean;
+    error: string | null;
+    refetch: () => Promise<void>;
+    createCustomer: (params: {
+        email: string;
+        name?: string;
+        phone?: string;
+        metadata?: Record<string, string>;
+    }) => Promise<Customer | null>;
+    updateCustomer: (params: {
+        email?: string;
+        name?: string;
+        phone?: string;
+        metadata?: Record<string, string>;
+    }) => Promise<boolean>;
+    deleteCustomer: () => Promise<boolean>;
+    fetchPaymentMethods: () => Promise<PaymentMethod[]>;
+    addPaymentMethod: (paymentMethodId: string) => Promise<boolean>;
+    removePaymentMethod: (paymentMethodId: string) => Promise<boolean>;
+    setDefaultPaymentMethod: (paymentMethodId: string) => Promise<boolean>;
+}
+declare const useCustomer: (options?: UseCustomerOptions) => UseCustomerReturn;
+
+declare const getStripe: (publishableKey: string) => Promise<Stripe | null>;
+declare const initializeStripe: (config: PaymentsConfig) => Promise<Stripe | null>;
+declare const createCheckoutSession: (params: {
+    priceId: string;
+    customerId?: string;
+    customerEmail?: string;
+    successUrl: string;
+    cancelUrl: string;
+    allowPromotionCodes?: boolean;
+    billingAddressCollection?: "auto" | "required";
+    metadata?: Record<string, string>;
+    trialPeriodDays?: number;
+}) => Promise<{
+    sessionId: string;
+} | {
+    error: string;
+}>;
+declare const createPaymentIntent: (params: {
+    amount: number;
+    currency: string;
+    customerId?: string;
+    description?: string;
+    metadata?: Record<string, string>;
+}) => Promise<{
+    clientSecret: string;
+} | {
+    error: string;
+}>;
+declare const createPortalSession: (params: {
+    customerId: string;
+    returnUrl: string;
+}) => Promise<{
+    url: string;
+} | {
+    error: string;
+}>;
+declare const confirmPayment: (stripe: Stripe, elements: StripeElements, clientSecret: string, options?: {
+    returnUrl?: string;
+    receiptEmail?: string;
+}) => Promise<{
+    success: boolean;
+    error?: string;
+    paymentIntent?: any;
+}>;
+declare const redirectToCheckout: (stripe: Stripe, sessionId: string) => Promise<{
+    success: boolean;
+    error?: string;
+}>;
+declare const formatStripeError: (error: any) => string;
+
+export { BillingPortal, CheckoutButton, PaymentForm, PricingTable, StripeProvider, confirmPayment, createCheckoutSession, createPaymentIntent, createPortalSession, formatStripeError, getStripe, initializeStripe, redirectToCheckout, useCheckout, useCustomer, useSubscription };

package/dist/web/index.d.ts

@@ -0,0 +1,281 @@
+import React from 'react';
+import { Stripe, StripeElements } from '@stripe/stripe-js';
+
+interface CheckoutButtonProps {
+    priceId: string;
+    customerId?: string;
+    customerEmail?: string;
+    successUrl?: string;
+    cancelUrl?: string;
+    children: React.ReactNode;
+    className?: string;
+    disabled?: boolean;
+    allowPromotionCodes?: boolean;
+    billingAddressCollection?: 'auto' | 'required';
+    metadata?: Record<string, string>;
+    trialPeriodDays?: number;
+    onSuccess?: () => void;
+    onError?: (error: string) => void;
+    onLoading?: (loading: boolean) => void;
+}
+declare const CheckoutButton: React.FC<CheckoutButtonProps>;
+
+interface Subscription {
+    id: string;
+    customerId: string;
+    priceId: string;
+    status: 'active' | 'canceled' | 'past_due' | 'unpaid' | 'incomplete' | 'incomplete_expired' | 'trialing';
+    currentPeriodStart: Date;
+    currentPeriodEnd: Date;
+    cancelAtPeriodEnd: boolean;
+    trialEnd?: Date;
+    trialStart?: Date;
+    canceledAt?: Date;
+    endedAt?: Date;
+    metadata?: Record<string, string>;
+}
+
+interface Customer {
+    id: string;
+    email: string;
+    name?: string;
+    phone?: string;
+    stripeCustomerId?: string;
+    subscriptions: Subscription[];
+    defaultPaymentMethodId?: string;
+    metadata?: Record<string, string>;
+    created: Date;
+    updated: Date;
+}
+interface PaymentMethod {
+    id: string;
+    type: 'card' | 'bank_account' | 'sepa_debit' | 'ideal' | 'sofort';
+    card?: {
+        brand: string;
+        last4: string;
+        expMonth: number;
+        expYear: number;
+        country?: string;
+    };
+    bankAccount?: {
+        last4: string;
+        bankName?: string;
+        accountType?: string;
+    };
+    isDefault: boolean;
+    created: Date;
+}
+
+interface PaymentsConfig {
+    provider: 'stripe';
+    publishableKey: string;
+    secretKey?: string;
+    webhookSecret?: string;
+    environment: 'development' | 'production';
+    apiVersion?: string;
+}
+interface PricingPlan {
+    id: string;
+    name: string;
+    description?: string;
+    price: number;
+    currency: string;
+    interval: 'day' | 'week' | 'month' | 'year';
+    intervalCount?: number;
+    stripePriceId: string;
+    stripeProductId?: string;
+    features: string[];
+    popular?: boolean;
+    trialPeriodDays?: number;
+    metadata?: Record<string, string>;
+}
+interface CheckoutSessionParams {
+    priceId: string;
+    customerId?: string;
+    customerEmail?: string;
+    successUrl: string;
+    cancelUrl: string;
+    mode?: 'payment' | 'subscription' | 'setup';
+    allowPromotionCodes?: boolean;
+    billingAddressCollection?: 'auto' | 'required';
+    metadata?: Record<string, string>;
+    trialPeriodDays?: number;
+}
+
+interface PricingTableProps {
+    plans: PricingPlan[];
+    customerId?: string;
+    customerEmail?: string;
+    successUrl?: string;
+    cancelUrl?: string;
+    className?: string;
+    onPlanSelect?: (plan: PricingPlan) => void;
+    onCheckoutSuccess?: (plan: PricingPlan) => void;
+    onCheckoutError?: (plan: PricingPlan, error: string) => void;
+    showFeatures?: boolean;
+    showTrialInfo?: boolean;
+    layout?: 'grid' | 'list';
+    maxColumns?: number;
+}
+declare const PricingTable: React.FC<PricingTableProps>;
+
+interface PaymentFormProps {
+    clientSecret?: string;
+    customerId?: string;
+    customerEmail?: string;
+    amount?: number;
+    currency?: string;
+    description?: string;
+    metadata?: Record<string, string>;
+    onSuccess?: (paymentIntent: any) => void;
+    onError?: (error: string) => void;
+    onLoading?: (loading: boolean) => void;
+    className?: string;
+    showBillingDetails?: boolean;
+    elementType?: 'card' | 'payment';
+}
+declare const PaymentForm: React.FC<PaymentFormProps>;
+
+interface BillingPortalProps {
+    customerId: string;
+    returnUrl?: string;
+    children?: React.ReactNode;
+    className?: string;
+    onSuccess?: () => void;
+    onError?: (error: string) => void;
+    onLoading?: (loading: boolean) => void;
+}
+declare const BillingPortal: React.FC<BillingPortalProps>;
+
+interface StripeProviderProps {
+    children: React.ReactNode;
+    options?: {
+        fonts?: Array<{
+            cssSrc: string;
+        }>;
+        locale?: string;
+        apiVersion?: string;
+    };
+}
+declare const StripeProvider: React.FC<StripeProviderProps>;
+
+interface UseSubscriptionOptions {
+    customerId?: string;
+    subscriptionId?: string;
+    autoFetch?: boolean;
+    onError?: (error: string) => void;
+}
+interface UseSubscriptionReturn {
+    subscription: Subscription | null;
+    subscriptions: Subscription[];
+    loading: boolean;
+    error: string | null;
+    refetch: () => Promise<void>;
+    cancel: (subscriptionId?: string) => Promise<boolean>;
+    reactivate: (subscriptionId?: string) => Promise<boolean>;
+    updatePaymentMethod: (subscriptionId: string, paymentMethodId: string) => Promise<boolean>;
+}
+declare const useSubscription: (options?: UseSubscriptionOptions) => UseSubscriptionReturn;
+
+interface UseCheckoutOptions {
+    onSuccess?: (sessionId: string) => void;
+    onError?: (error: string) => void;
+    onLoading?: (loading: boolean) => void;
+}
+interface UseCheckoutReturn {
+    loading: boolean;
+    error: string | null;
+    createCheckoutSession: (params: CheckoutSessionParams) => Promise<string | null>;
+    redirectToCheckout: (params: CheckoutSessionParams) => Promise<boolean>;
+    createPaymentIntent: (params: {
+        amount: number;
+        currency: string;
+        customerId?: string;
+        description?: string;
+        metadata?: Record<string, string>;
+    }) => Promise<string | null>;
+}
+declare const useCheckout: (options?: UseCheckoutOptions) => UseCheckoutReturn;
+
+interface UseCustomerOptions {
+    customerId?: string;
+    autoFetch?: boolean;
+    onError?: (error: string) => void;
+}
+interface UseCustomerReturn {
+    customer: Customer | null;
+    paymentMethods: PaymentMethod[];
+    loading: boolean;
+    error: string | null;
+    refetch: () => Promise<void>;
+    createCustomer: (params: {
+        email: string;
+        name?: string;
+        phone?: string;
+        metadata?: Record<string, string>;
+    }) => Promise<Customer | null>;
+    updateCustomer: (params: {
+        email?: string;
+        name?: string;
+        phone?: string;
+        metadata?: Record<string, string>;
+    }) => Promise<boolean>;
+    deleteCustomer: () => Promise<boolean>;
+    fetchPaymentMethods: () => Promise<PaymentMethod[]>;
+    addPaymentMethod: (paymentMethodId: string) => Promise<boolean>;
+    removePaymentMethod: (paymentMethodId: string) => Promise<boolean>;
+    setDefaultPaymentMethod: (paymentMethodId: string) => Promise<boolean>;
+}
+declare const useCustomer: (options?: UseCustomerOptions) => UseCustomerReturn;
+
+declare const getStripe: (publishableKey: string) => Promise<Stripe | null>;
+declare const initializeStripe: (config: PaymentsConfig) => Promise<Stripe | null>;
+declare const createCheckoutSession: (params: {
+    priceId: string;
+    customerId?: string;
+    customerEmail?: string;
+    successUrl: string;
+    cancelUrl: string;
+    allowPromotionCodes?: boolean;
+    billingAddressCollection?: "auto" | "required";
+    metadata?: Record<string, string>;
+    trialPeriodDays?: number;
+}) => Promise<{
+    sessionId: string;
+} | {
+    error: string;
+}>;
+declare const createPaymentIntent: (params: {
+    amount: number;
+    currency: string;
+    customerId?: string;
+    description?: string;
+    metadata?: Record<string, string>;
+}) => Promise<{
+    clientSecret: string;
+} | {
+    error: string;
+}>;
+declare const createPortalSession: (params: {
+    customerId: string;
+    returnUrl: string;
+}) => Promise<{
+    url: string;
+} | {
+    error: string;
+}>;
+declare const confirmPayment: (stripe: Stripe, elements: StripeElements, clientSecret: string, options?: {
+    returnUrl?: string;
+    receiptEmail?: string;
+}) => Promise<{
+    success: boolean;
+    error?: string;
+    paymentIntent?: any;
+}>;
+declare const redirectToCheckout: (stripe: Stripe, sessionId: string) => Promise<{
+    success: boolean;
+    error?: string;
+}>;
+declare const formatStripeError: (error: any) => string;
+
+export { BillingPortal, CheckoutButton, PaymentForm, PricingTable, StripeProvider, confirmPayment, createCheckoutSession, createPaymentIntent, createPortalSession, formatStripeError, getStripe, initializeStripe, redirectToCheckout, useCheckout, useCustomer, useSubscription };