@voyage_ai/v402-web-ts 0.1.1 → 0.1.3

package/dist/react/index.d.ts

@@ -29,6 +29,8 @@ interface UseWalletReturn {
     isConnecting: boolean;
     error: string | null;
     connect: (networkType: NetworkType) => Promise<void>;
+    switchNetwork: (networkType: NetworkType) => Promise<void>;
+    ensureNetwork: (networkType: NetworkType) => Promise<void>;
     disconnect: () => void;
     clearError: () => void;
 }
@@ -55,6 +57,38 @@ interface UseWalletReturn {
  */
 declare function useWallet(): UseWalletReturn;
 
+interface UsePageNetworkOptions {
+    /** 是否自动切换网络（默认 true） */
+    autoSwitch?: boolean;
+    /** 是否在组件挂载时立即切换（默认 true） */
+    switchOnMount?: boolean;
+}
+/**
+ * 页面级网络管理 Hook
+ *
+ * 用于确保页面始终连接到期望的网络
+ * 自动处理网络切换，保持其他网络的缓存不受影响
+ *
+ * @param expectedNetwork - 页面期望的网络类型（NetworkType，如 EVM、SVM）
+ * @param options - 配置选项
+ *
+ * @example
+ * ```tsx
+ * // EVM 页面
+ * function EvmPage() {
+ *   const { address, isConnecting } = usePageNetwork(NetworkType.EVM);
+ *   return <div>{isConnecting ? 'Connecting...' : address}</div>;
+ * }
+ *
+ * // SVM 页面
+ * function SvmPage() {
+ *   const { address, isConnecting } = usePageNetwork(NetworkType.SVM);
+ *   return <div>{isConnecting ? 'Connecting...' : address}</div>;
+ * }
+ * ```
+ */
+declare function usePageNetwork(expectedNetwork: NetworkType, options?: UsePageNetworkOptions): UseWalletReturn;
+
 /**
  * usePayment Hook
  *
@@ -143,6 +177,7 @@ interface UsePaymentInfoReturn {
  *
  * @param endpoint - API endpoint to fetch payment info from
  * @param merchantId - @see our website to apply
+ * @param additionalParams - Optional additional parameters to send with the request (default: {})
  *
  * @example
  * ```tsx
@@ -159,8 +194,20 @@ interface UsePaymentInfoReturn {
  *   );
  * }
  * ```
+ *
+ * @example
+ * ```tsx
+ * // With additional parameters
+ * function PaymentInfo() {
+ *   const { paymentInfo } = usePaymentInfo(
+ *     'merchant-id',
+ *     '/api/protected',
+ *     { userId: '123', customField: 'value' }
+ *   );
+ * }
+ * ```
  */
-declare function usePaymentInfo(merchantId: string, endpoint?: string): UsePaymentInfoReturn;
+declare function usePaymentInfo(merchantId: string, endpoint?: string, additionalParams?: Record<string, any>): UsePaymentInfoReturn;
 
 /**
  * WalletConnect Component
@@ -193,56 +240,19 @@ interface WalletConnectProps {
  */
 declare function WalletConnect({ supportedNetworks, className, onConnect, onDisconnect, }: WalletConnectProps): React.JSX.Element;
 
-/**
- * PaymentButton Component
- *
- * Pre-built payment button component with inline styles
- * Note: This is a simple wrapper. For complex payment flows,
- * use the SDK directly with usePayment hook for full control.
- */
-
-interface PaymentButtonProps {
-    endpoint: string;
-    className?: string;
-    disabled?: boolean;
-    onSuccess?: (result: any) => void;
-    onError?: (error: string) => void;
-    onStart?: () => void;
-    onFinish?: () => void;
-    children?: React.ReactNode;
+interface HeaderInfo {
+    title?: string;
+    subtitle?: string;
+    tooltipText?: string;
 }
-/**
- * Simple pre-built payment button
- *
- * For complex payment flows, use the SDK directly:
- *
- * @example
- * ```tsx
- * import { useWallet, usePayment } from '../react';
- * import { handleSvmPayment } from '@/app/sdk';
- *
- * function CustomPayment() {
- *   const { networkType } = useWallet();
- *   const { isProcessing, setIsProcessing, setResult, setError } = usePayment();
- *
- *   const handlePay = async () => {
- *     setIsProcessing(true);
- *     try {
- *       // Your custom logic before payment
- *       const response = await handleSvmPayment(...);
- *       const data = await response.json();
- *
- *       // Your custom logic after payment
- *       setResult(data);
- *     } catch (err) {
- *       setError(err.message);
- *     } finally {
- *       setIsProcessing(false);
- *     }
- *   };
- * }
- * ```
- */
-declare function PaymentButton({ endpoint, className, disabled, onSuccess, onError, onStart, onFinish, children, }: PaymentButtonProps): React.JSX.Element;
+interface V402CheckoutProps {
+    merchantId: string;
+    headerInfo?: HeaderInfo;
+    isModal?: boolean;
+    onPaymentComplete?: (response: any) => void;
+    additionalParams?: Record<string, any>;
+    expectedNetwork?: NetworkType;
+}
+declare function V402Checkout({ merchantId, headerInfo, isModal, onPaymentComplete, additionalParams, expectedNetwork, }: V402CheckoutProps): React.JSX.Element;
 
-export { PaymentButton, type PaymentButtonProps, type UsePaymentInfoReturn, type UsePaymentReturn, type UseWalletReturn, WalletConnect, type WalletConnectProps, usePayment, usePaymentInfo, useWallet };
+export { type UsePageNetworkOptions, type UsePaymentInfoReturn, type UsePaymentReturn, type UseWalletReturn, V402Checkout, type V402CheckoutProps, WalletConnect, type WalletConnectProps, usePageNetwork, usePayment, usePaymentInfo, useWallet };