@doujins/payments-ui 0.0.11 → 0.0.13

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-import React from 'react';
-import { StoreApi } from 'zustand';
-import { PublicKey } from '@solana/web3.js';
-import * as zustand_vanilla from 'zustand/vanilla';
+import React$1 from 'react';
+import * as _solana_wallet_adapter_base from '@solana/wallet-adapter-base';
 import * as _tanstack_react_query from '@tanstack/react-query';
+import { QueryClient } from '@tanstack/react-query';
+import { PublicKey } from '@solana/web3.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 type AuthTokenProvider = (() => string | null | undefined) | (() => Promise<string | null | undefined>) | null | undefined;
 interface PaymentUserDetails {
@@ -27,6 +28,12 @@ interface PaymentFeatureFlags {
     enableSolanaPay?: boolean;
     enableDirectWallet?: boolean;
 }
+interface PaymentSolanaConfig {
+    endpoint?: string;
+    network?: _solana_wallet_adapter_base.WalletAdapterNetwork;
+    autoConnect?: boolean;
+    wallets?: _solana_wallet_adapter_base.WalletAdapter[];
+}
 interface PaymentCallbacks {
     onStatusChange?: (payload: PaymentStatusPayload) => void;
     onSuccess?: (payload: PaymentSuccessPayload) => void;
@@ -53,7 +60,15 @@ interface PaymentConfig {
     callbacks?: PaymentCallbacks;
     collectJsKey?: string;
     solanaRpcUrl?: string;
+    solana?: PaymentSolanaConfig;
 }
+type NotificationStatus = 'default' | 'success' | 'info' | 'destructive';
+interface NotificationPayload {
+    title: string;
+    description?: string;
+    status?: NotificationStatus;
+}
+type NotificationHandler = (payload: NotificationPayload) => void;
 
 interface BillingDetails {
     firstName: string;
@@ -93,6 +108,41 @@ interface PaginatedPaymentMethods {
     total?: number;
     next_page?: number | null;
 }
+interface Payment {
+    id: string;
+    subscription_id?: string | null;
+    processor: string;
+    transaction_id: string;
+    amount: number;
+    currency: string;
+    purchased_at: string;
+    status?: string;
+    description?: string;
+}
+interface PaginatedPayments {
+    data: Payment[];
+    total_items: number;
+    limit?: number;
+    offset?: number;
+    page?: number;
+    page_size?: number;
+    total_pages?: number;
+}
+interface BillingAccessGrant {
+    kind: string;
+    entitlement: string;
+    subscription_id?: string | null;
+    processor?: string | null;
+    processor_subscription_id?: string | null;
+    source_type?: string | null;
+    source_id?: string | null;
+    start_at?: string | null;
+    end_at?: string | null;
+}
+interface BillingStatus {
+    is_premium: boolean;
+    access: BillingAccessGrant[];
+}
 
 interface GeneratePaymentRequest {
     price_id: string;
@@ -278,6 +328,40 @@ interface SubscriptionCheckoutPayload {
     billing: BillingDetails;
 }
 
+interface SolanaWallet {
+    id: string;
+    address: string;
+    is_verified: boolean;
+    verified_at?: string;
+    created_at: string;
+    updated_at?: string;
+    user_id?: string;
+}
+interface WalletListResponse {
+    wallets: SolanaWallet[];
+    count: number;
+}
+interface WalletChallengeResponse {
+    wallet: string;
+    message: string;
+    expires_at: number;
+    nonce: string;
+}
+interface VerifyWalletResponse {
+    verified: boolean;
+    wallet: string;
+    verified_at?: string;
+    linked_wallet?: SolanaWallet;
+}
+interface WalletConnectionState {
+    isConnected: boolean;
+    isConnecting: boolean;
+    publicKey: string | null;
+    wallets: SolanaWallet[];
+    isLoading: boolean;
+    error: string | null;
+}
+
 type RequestOptions = {
     params?: Record<string, string | number>;
     query?: Record<string, string | number | undefined>;
@@ -367,13 +451,32 @@ declare class SubscriptionService {
     constructor(api: ApiClient);
     subscribe(platform: PaymentPlatform, payload: NmiSubscribePayload | CCBillSubscribePayload): Promise<SubscriptionResponse>;
     generateFlexFormUrl(payload: GenerateFlexFormURLBodyParams): Promise<FlexFormResponse>;
+    getPaymentHistory(params?: {
+        limit?: number;
+        offset?: number;
+        type?: string;
+    }): Promise<PaginatedPayments>;
+    cancelSubscription(feedback?: string): Promise<{
+        message: string;
+        success: boolean;
+    }>;
     private serializePayload;
 }
 
+declare class SolanaWalletService {
+    private readonly api;
+    constructor(api: ApiClient);
+    list(): Promise<SolanaWallet[]>;
+    requestChallenge(wallet: string): Promise<WalletChallengeResponse>;
+    verify(wallet: string, signature: string, nonce?: string): Promise<VerifyWalletResponse>;
+    remove(wallet: string): Promise<void>;
+}
+
 interface PaymentServices {
     cardPayments: CardPaymentService;
     paymentMethods: PaymentMethodService;
     solanaPayments: SolanaPaymentService;
+    solanaWallets: SolanaWalletService;
     tokenCatalog: TokenCatalog;
     walletGateway: WalletGateway;
     subscriptions: SubscriptionService;
@@ -396,46 +499,14 @@ declare class PaymentApp {
     resolveAuthToken: () => Promise<string | null>;
 }
 
-type AsyncStatus = 'idle' | 'processing' | 'success' | 'error';
-type SolanaFlowState = 'selecting' | 'processing' | 'confirming' | 'success' | 'error';
-interface PaymentStoreState {
-    selectedMethodId: string | null;
-    solanaModalOpen: boolean;
-    savedPaymentStatus: AsyncStatus;
-    savedPaymentError: string | null;
-    newCardStatus: AsyncStatus;
-    newCardError: string | null;
-    solanaTab: 'wallet' | 'qr';
-    solanaStatus: SolanaFlowState;
-    solanaError: string | null;
-    solanaTransactionId: string | null;
-    solanaSelectedToken: string | null;
-    solanaTokenAmount: number;
-    setSelectedMethod: (methodId: string | null) => void;
-    setSolanaModalOpen: (open: boolean) => void;
-    setSolanaTab: (tab: 'wallet' | 'qr') => void;
-    setSolanaSelectedToken: (symbol: string) => void;
-    setSolanaTokenAmount: (amount: number) => void;
-    setSolanaTransactionId: (txId: string | null) => void;
-    startSavedPayment: () => void;
-    completeSavedPayment: () => void;
-    failSavedPayment: (error: string) => void;
-    resetSavedPayment: () => void;
-    startNewCardPayment: () => void;
-    completeNewCardPayment: () => void;
-    failNewCardPayment: (error: string) => void;
-    resetNewCardPayment: () => void;
-    startSolanaPayment: () => void;
-    confirmSolanaPayment: () => void;
-    completeSolanaPayment: (payload?: PaymentSuccessPayload) => void;
-    failSolanaPayment: (error: string) => void;
-    resetSolanaPayment: () => void;
-    resetAll: () => void;
-}
-interface PaymentStoreOptions {
-    callbacks?: PaymentCallbacks;
+declare class PaymentsRuntime {
+    readonly config: PaymentConfig;
+    readonly app: PaymentApp;
+    readonly services: PaymentServices;
+    readonly queryClient: QueryClient;
+    constructor(config: PaymentConfig);
 }
-declare const createPaymentStore: (options?: PaymentStoreOptions) => zustand_vanilla.StoreApi<PaymentStoreState>;
+declare const createPaymentsRuntime: (config: PaymentConfig) => PaymentsRuntime;
 
 interface PaymentContextValue {
     config: PaymentConfig;
@@ -443,15 +514,78 @@ interface PaymentContextValue {
     resolveAuthToken: () => Promise<string | null>;
     app: PaymentApp;
     services: PaymentServices;
-    store: StoreApi<PaymentStoreState>;
+    queryClient: PaymentsRuntime['queryClient'];
 }
 interface PaymentProviderProps {
     config: PaymentConfig;
-    children: React.ReactNode;
+    children: React$1.ReactNode;
+    runtime?: PaymentsRuntime;
 }
-declare const PaymentProvider: React.FC<PaymentProviderProps>;
+declare const PaymentProvider: React$1.FC<PaymentProviderProps>;
 declare const usePaymentContext: () => PaymentContextValue;
 
+interface SubscriptionCheckoutModalProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    priceId?: string | null;
+    usdAmount?: number;
+    planName?: string;
+    amountLabel?: string;
+    billingPeriodLabel?: string;
+    userEmail?: string | null;
+    provider?: string;
+    onSuccess?: () => void;
+    enableSolanaPay?: boolean;
+    onSolanaSuccess?: (result: SubmitPaymentResponse | string) => void;
+    onSolanaError?: (error: string) => void;
+    initialMode?: 'cards' | 'solana';
+}
+declare const SubscriptionCheckoutModal: React$1.FC<SubscriptionCheckoutModalProps>;
+
+interface SolanaPaymentViewProps {
+    priceId: string;
+    usdAmount: number;
+    onSuccess: (result: SubmitPaymentResponse | string) => void;
+    onError?: (error: string) => void;
+    onClose?: () => void;
+}
+declare const SolanaPaymentView: React$1.FC<SolanaPaymentViewProps>;
+
+interface SolanaPaymentSelectorProps extends SolanaPaymentViewProps {
+    isOpen: boolean;
+    onClose: () => void;
+}
+declare const SolanaPaymentSelector: React$1.FC<SolanaPaymentSelectorProps>;
+
+interface WalletModalProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}
+declare const WalletModal: React.FC<WalletModalProps>;
+
+type CheckoutOptions = Omit<SubscriptionCheckoutModalProps, 'open' | 'onOpenChange'>;
+type SolanaOptions = Omit<SolanaPaymentSelectorProps, 'isOpen' | 'onClose'>;
+type WalletOptions = Omit<WalletModalProps, 'open' | 'onOpenChange'>;
+interface PaymentsDialogContextValue {
+    checkout: {
+        open: (options: CheckoutOptions) => void;
+        close: () => void;
+        isOpen: boolean;
+    };
+    solana: {
+        open: (options: SolanaOptions) => void;
+        close: () => void;
+        isOpen: boolean;
+    };
+    wallet: {
+        open: (options?: WalletOptions) => void;
+        close: () => void;
+        isOpen: boolean;
+    };
+}
+declare const PaymentsDialogProvider: React$1.FC<React$1.PropsWithChildren>;
+declare const usePaymentDialogs: () => PaymentsDialogContextValue;
+
 interface CardDetailsFormProps {
     visible: boolean;
     onTokenize: (token: string, billing: BillingDetails) => void;
@@ -464,7 +598,7 @@ interface CardDetailsFormProps {
     onBillingChange?: (billing: BillingDetails) => void;
     submitDisabled?: boolean;
 }
-declare const CardDetailsForm: React.FC<CardDetailsFormProps>;
+declare const CardDetailsForm: React$1.FC<CardDetailsFormProps>;
 
 interface StoredPaymentMethodsProps {
     selectedMethodId?: string | null;
@@ -473,7 +607,7 @@ interface StoredPaymentMethodsProps {
     heading?: string;
     description?: string;
 }
-declare const StoredPaymentMethods: React.FC<StoredPaymentMethodsProps>;
+declare const StoredPaymentMethods: React$1.FC<StoredPaymentMethodsProps>;
 
 interface PaymentExperienceProps {
     priceId: string;
@@ -489,36 +623,66 @@ interface PaymentExperienceProps {
     enableNewCard?: boolean;
     enableStoredMethods?: boolean;
     enableSolanaPay?: boolean;
-    checkoutSummary?: React.ReactNode;
     onSolanaSuccess?: (result: SubmitPaymentResponse | string) => void;
     onSolanaError?: (error: string) => void;
+    initialMode?: 'cards' | 'solana';
 }
-declare const PaymentExperience: React.FC<PaymentExperienceProps>;
+declare const PaymentExperience: React$1.FC<PaymentExperienceProps>;
 
-interface SolanaPaymentSelectorProps {
-    isOpen: boolean;
-    priceId: string;
-    usdAmount: number;
-    onClose: () => void;
-    onError?: (error: string) => void;
-    onSuccess: (result: SubmitPaymentResponse | string) => void;
+interface BillingHistoryProps {
+    pageSize?: number;
+    initialPage?: number;
+    enableCancel?: boolean;
+    onNotify?: NotificationHandler;
 }
-declare const SolanaPaymentSelector: React.FC<SolanaPaymentSelectorProps>;
+declare const BillingHistory: React.FC<BillingHistoryProps>;
 
-interface SubscriptionCheckoutModalProps {
-    open: boolean;
-    onOpenChange: (open: boolean) => void;
-    priceId?: string | null;
-    usdAmount?: number;
-    planName?: string;
-    amountLabel?: string;
-    billingPeriodLabel?: string;
+interface CancelMembershipDialogProps {
+    minReasonLength?: number;
+    onCancelled?: () => void;
+    onNotify?: NotificationHandler;
+}
+declare const CancelMembershipDialog: React.FC<CancelMembershipDialogProps>;
+
+interface PaymentMethodsSectionProps {
+    isAuthenticated?: boolean;
     userEmail?: string | null;
     provider?: string;
-    onSuccess?: () => void;
-    enableSolanaPay?: boolean;
+    defaultCountry?: string;
+    collectPrefix?: string;
+    onNotify?: NotificationHandler;
+}
+declare const PaymentMethodsSection: React.FC<PaymentMethodsSectionProps>;
+
+interface SolanaWalletSectionProps {
+    onNotify?: NotificationHandler;
+    rpcUrl?: string;
+}
+declare const SolanaWalletSection: React.FC<SolanaWalletSectionProps>;
+
+declare const WalletManagement: (props: SolanaWalletSectionProps) => react_jsx_runtime.JSX.Element;
+
+interface WalletCardProps {
+    wallet: SolanaWallet;
+    isPrimary?: boolean;
+    isConnected?: boolean;
+    balance?: number | null;
+    onSetPrimary?: (walletId: string) => void;
+    onVerify?: (wallet: SolanaWallet) => void;
+    onDelete?: (walletId: string) => void;
+    isVerifying?: boolean;
+    isDeleting?: boolean;
+    notify?: NotificationHandler;
+}
+declare const WalletCard: React.FC<WalletCardProps>;
+
+declare const EmptyWalletState: React.FC;
+
+interface WalletDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
 }
-declare const SubscriptionCheckoutModal: React.FC<SubscriptionCheckoutModalProps>;
+declare const WalletDialog: React.FC<WalletDialogProps>;
 
 interface SubscriptionSuccessDialogProps {
     open: boolean;
@@ -527,7 +691,7 @@ interface SubscriptionSuccessDialogProps {
     billingPeriodLabel?: string;
     onClose: () => void;
 }
-declare const SubscriptionSuccessDialog: React.FC<SubscriptionSuccessDialogProps>;
+declare const SubscriptionSuccessDialog: React$1.FC<SubscriptionSuccessDialogProps>;
 
 declare const usePaymentMethods: () => {
     listQuery: _tanstack_react_query.UseQueryResult<PaginatedPaymentMethods, Error>;
@@ -628,10 +792,14 @@ declare const usePaymentStatus: (options?: PaymentStatusHookOptions) => {
     isPending: boolean;
 };
 
-declare const usePaymentStore: <T>(selector: (state: PaymentStoreState) => T) => T;
-
 declare const useSolanaService: () => SolanaPaymentService;
 
+declare const usePaymentNotifications: () => {
+    notifyStatus: (status: PaymentStatusPayload["status"], context?: Record<string, unknown>) => void;
+    notifySuccess: (payload?: PaymentSuccessPayload) => void;
+    notifyError: (error: string | Error) => void;
+};
+
 interface UseSolanaDirectPaymentOptions {
     priceId: string;
     tokenAmount: number;
@@ -723,4 +891,42 @@ declare const useAlternativePaymentProvider: () => {
     error: string | null;
 };
 
-export { type AsyncStatus, type AuthTokenProvider, type BillingDetails, type CCBillSubscribePayload, CardDetailsForm, type CardDetailsFormProps, CardPaymentService, type CardTokenizeResult, type CreatePaymentMethodPayload, type FlexFormResponse, type GenerateFlexFormParams, type GenerateFlexFormURLBodyParams, type GeneratePaymentRequest, type GeneratePaymentResponse, type ListParams, type NmiSubscribePayload, type PaginatedPaymentMethods, PaymentApp, type PaymentAppOptions, type PaymentCallbacks, type PaymentConfig, type PaymentContextValue, type PaymentEndpoints, type PaymentError, PaymentExperience, type PaymentExperienceProps, type PaymentFeatureFlags, type PaymentFetcher, type PaymentMethod, type PaymentMethodOption, PaymentMethodService, type PaymentPlatform, PaymentProvider, type PaymentProviderProps, type PaymentServices, type PaymentState, type PaymentStatusPayload, type PaymentStatusResponse, type PaymentStep, type PaymentStoreOptions, type PaymentStoreState, type PaymentSuccessPayload, type PaymentUserDetails, type SolanaFlowConfig, type SolanaFlowState, type SolanaPayQRCodeIntent, type SolanaPayStatusResponse, type SolanaPayTransaction, type SolanaPaymentMethod, SolanaPaymentSelector, SolanaPaymentService, StoredPaymentMethods, type StoredPaymentMethodsProps, type SubmitPaymentRequest, type SubmitPaymentResponse, type SubscribeWithCCBillParams, type SubscribeWithCardParams, type SubscribeWithSavedMethodParams, SubscriptionCheckoutModal, type SubscriptionCheckoutPayload, type SubscriptionResponse, SubscriptionService, SubscriptionSuccessDialog, type SupportedTokensResponse, type TokenBalance, TokenCatalog, type TokenCatalogOptions, type TokenInfo, type TransactionStatus, type WalletAccount, type WalletAdapterLike, WalletGateway, createPaymentStore, useAlternativePaymentProvider, useDirectWalletPayment, usePaymentContext, usePaymentMethodService, usePaymentMethods, usePaymentStatus, usePaymentStore, useSolanaDirectPayment, useSolanaQrPayment, useSolanaService, useSubscriptionActions, useSupportedTokens, useTokenBalance };
+interface UseWalletListOptions {
+    autoFetch?: boolean;
+}
+declare const useWalletList: (options?: UseWalletListOptions) => {
+    wallets: SolanaWallet[];
+    isLoading: boolean;
+    error: string | null;
+    fetchWallets: () => Promise<SolanaWallet[]>;
+    deleteWallet: (walletIdOrAddress: string) => Promise<void>;
+    addWallet: (wallet: SolanaWallet) => void;
+    updateWallet: (walletId: string, updates: Partial<SolanaWallet>) => void;
+    clearError: () => void;
+    findWalletByAddress: (address: string) => SolanaWallet | undefined;
+    getVerifiedWallets: () => SolanaWallet[];
+    hasVerifiedWallets: boolean;
+    totalWallets: number;
+};
+
+declare const useWalletVerification: () => {
+    signAndVerifyWallet: (walletAddress: string, message: string, nonce?: string) => Promise<VerifyWalletResponse>;
+    autoVerifyWallet: (walletAddress: string, message: string, nonce?: string) => Promise<VerifyWalletResponse | null>;
+    clearError: () => void;
+    resetVerification: () => void;
+    isVerifying: boolean;
+    isVerified: boolean;
+    error: string | null;
+};
+
+interface WalletConnectionResult extends WalletConnectionState {
+    walletName?: string;
+    walletIcon?: string;
+    connectWallet: () => Promise<void>;
+    disconnectWallet: () => Promise<void>;
+    connectWalletToBackend: (address: string) => Promise<WalletChallengeResponse>;
+    clearError: () => void;
+}
+declare const useWalletConnection: () => WalletConnectionResult;
+
+export { type AuthTokenProvider, type BillingAccessGrant, type BillingDetails, BillingHistory, type BillingHistoryProps, type BillingStatus, type CCBillSubscribePayload, CancelMembershipDialog, type CancelMembershipDialogProps, CardDetailsForm, type CardDetailsFormProps, CardPaymentService, type CardTokenizeResult, type CreatePaymentMethodPayload, EmptyWalletState, type FlexFormResponse, type GenerateFlexFormParams, type GenerateFlexFormURLBodyParams, type GeneratePaymentRequest, type GeneratePaymentResponse, type ListParams, type NmiSubscribePayload, type NotificationHandler, type NotificationPayload, type NotificationStatus, type PaginatedPaymentMethods, type PaginatedPayments, type Payment, PaymentApp, type PaymentAppOptions, type PaymentCallbacks, type PaymentConfig, type PaymentContextValue, type PaymentEndpoints, type PaymentError, PaymentExperience, type PaymentExperienceProps, type PaymentFeatureFlags, type PaymentFetcher, type PaymentMethod, type PaymentMethodOption, PaymentMethodService, PaymentMethodsSection, type PaymentMethodsSectionProps, type PaymentPlatform, PaymentProvider, type PaymentProviderProps, type PaymentServices, type PaymentSolanaConfig, type PaymentState, type PaymentStatusPayload, type PaymentStatusResponse, type PaymentStep, type PaymentSuccessPayload, type PaymentUserDetails, PaymentsDialogProvider, PaymentsRuntime, type SolanaFlowConfig, type SolanaPayQRCodeIntent, type SolanaPayStatusResponse, type SolanaPayTransaction, type SolanaPaymentMethod, SolanaPaymentSelector, type SolanaPaymentSelectorProps, SolanaPaymentService, SolanaPaymentView, type SolanaPaymentViewProps, type SolanaWallet, SolanaWalletSection, type SolanaWalletSectionProps, SolanaWalletService, StoredPaymentMethods, type StoredPaymentMethodsProps, type SubmitPaymentRequest, type SubmitPaymentResponse, type SubscribeWithCCBillParams, type SubscribeWithCardParams, type SubscribeWithSavedMethodParams, SubscriptionCheckoutModal, type SubscriptionCheckoutModalProps, type SubscriptionCheckoutPayload, type SubscriptionResponse, SubscriptionService, SubscriptionSuccessDialog, type SupportedTokensResponse, type TokenBalance, TokenCatalog, type TokenCatalogOptions, type TokenInfo, type TransactionStatus, type VerifyWalletResponse, type WalletAccount, type WalletAdapterLike, WalletCard, type WalletChallengeResponse, type WalletConnectionState, WalletDialog, type WalletDialogProps, WalletGateway, type WalletListResponse, WalletManagement, WalletModal, type WalletModalProps, createPaymentsRuntime, useAlternativePaymentProvider, useDirectWalletPayment, usePaymentContext, usePaymentDialogs, usePaymentMethodService, usePaymentMethods, usePaymentNotifications, usePaymentStatus, useSolanaDirectPayment, useSolanaQrPayment, useSolanaService, useSubscriptionActions, useSupportedTokens, useTokenBalance, useWalletConnection, useWalletList, useWalletVerification };