@reevit/react 0.4.0 → 0.4.2

package/dist/index.d.mts

@@ -93,10 +93,16 @@ interface PaymentError {
 interface ReevitTheme {
     /** Primary brand color */
     primaryColor?: string;
+    /** Primary text color on brand surfaces */
+    primaryForegroundColor?: string;
     /** Background color */
     backgroundColor?: string;
+    /** Surface color for cards/panels */
+    surfaceColor?: string;
     /** Text color */
     textColor?: string;
+    /** Muted text color */
+    mutedTextColor?: string;
     /** Border radius for inputs and buttons */
     borderRadius?: string;
     /** Font family to use */
@@ -104,6 +110,12 @@ interface ReevitTheme {
     /** Whether to use dark mode */
     darkMode?: boolean;
 }
+interface CheckoutProviderOption {
+    provider: string;
+    name: string;
+    methods: PaymentMethod[];
+    countries?: string[];
+}
 interface MobileMoneyFormData {
     phone: string;
     network: MobileMoneyNetwork;
@@ -148,6 +160,10 @@ interface PaymentIntent {
     netAmount?: number;
     /** Additional metadata */
     metadata?: Record<string, unknown>;
+    /** Available PSPs for this checkout session */
+    availableProviders?: CheckoutProviderOption[];
+    /** Brand theme from checkout settings */
+    branding?: ReevitTheme;
 }
 
 interface ReevitContextValue {
@@ -195,7 +211,10 @@ declare function useReevit(options: UseReevitOptions): {
     selectedMethod: PaymentMethod | null;
     error: PaymentError | null;
     result: PaymentResult | null;
-    initialize: (method?: PaymentMethod) => Promise<void>;
+    initialize: (method?: PaymentMethod, options?: {
+        preferredProvider?: string;
+        allowedProviders?: string[];
+    }) => Promise<void>;
     selectMethod: (method: PaymentMethod) => void;
     processPayment: (paymentData: Record<string, unknown>) => Promise<void>;
     handlePspSuccess: (pspData: Record<string, unknown>) => Promise<void>;
@@ -258,6 +277,8 @@ declare function loadPaystackScript(): Promise<void>;
 declare function PaystackBridge({ publicKey, email, phone, amount, currency, reference, accessCode, metadata, channels, onSuccess, onError, onClose, autoStart, }: PaystackBridgeProps): react_jsx_runtime.JSX.Element;
 
 interface HubtelBridgeProps {
+    paymentId: string;
+    publicKey: string;
     merchantAccount: string | number;
     amount: number;
     currency?: string;
@@ -266,13 +287,16 @@ interface HubtelBridgeProps {
     phone?: string;
     description?: string;
     callbackUrl?: string;
+    /** Session token from server (recommended - credentials never exposed to client) */
+    hubtelSessionToken?: string;
+    /** Basic auth credential (legacy - credentials exposed to client, deprecated) */
     basicAuth?: string;
     onSuccess: (result: PaymentResult) => void;
     onError: (error: PaymentError) => void;
     onClose: () => void;
     autoStart?: boolean;
 }
-declare function HubtelBridge({ merchantAccount, amount, reference, phone, description, callbackUrl, basicAuth, onSuccess, onError, onClose, autoStart, }: HubtelBridgeProps): react_jsx_runtime.JSX.Element;
+declare function HubtelBridge({ paymentId, publicKey, merchantAccount, amount, reference, phone, description, callbackUrl, hubtelSessionToken, basicAuth, onSuccess, onError, onClose, autoStart, }: HubtelBridgeProps): react_jsx_runtime.JSX.Element;
 /**
  * Opens Hubtel checkout modal directly
  * Uses the @hubteljs/checkout npm package
@@ -552,6 +576,27 @@ interface PaymentIntentResponse {
     fee_currency: string;
     net_amount: number;
     reference?: string;
+    available_psps?: Array<{
+        provider: string;
+        name: string;
+        methods: string[];
+        countries?: string[];
+    }>;
+    branding?: Record<string, unknown>;
+}
+/**
+ * Response from creating a Hubtel session token.
+ * The token provides secure, short-lived access to Hubtel checkout without exposing credentials.
+ */
+interface HubtelSessionResponse {
+    /** Short-lived session token for Hubtel checkout */
+    token: string;
+    /** Hubtel merchant account number */
+    merchantAccount: string;
+    /** Token expiry time in seconds */
+    expiresInSeconds: number;
+    /** Unix timestamp when the token expires */
+    expiresAt: number;
 }
 interface PaymentDetailResponse {
     id: string;
@@ -600,7 +645,10 @@ declare class ReevitAPIClient {
     /**
      * Creates a payment intent
      */
-    createPaymentIntent(config: ReevitCheckoutConfig, method: PaymentMethod, country?: string): Promise<{
+    createPaymentIntent(config: ReevitCheckoutConfig, method: PaymentMethod, country?: string, options?: {
+        preferredProviders?: string[];
+        allowedProviders?: string[];
+    }): Promise<{
         data?: PaymentIntentResponse;
         error?: PaymentError;
     }>;
@@ -632,6 +680,18 @@ declare class ReevitAPIClient {
         data?: PaymentDetailResponse;
         error?: PaymentError;
     }>;
+    /**
+     * Creates a Hubtel session token for secure checkout.
+     * This endpoint generates a short-lived token that maps to Hubtel credentials server-side,
+     * avoiding exposure of sensitive credentials to the client.
+     *
+     * @param paymentId - The payment intent ID for Hubtel checkout
+     * @returns Hubtel session with token, merchant account, and expiry information
+     */
+    createHubtelSession(paymentId: string): Promise<{
+        data?: HubtelSessionResponse;
+        error?: PaymentError;
+    }>;
     /**
      * Maps SDK payment method to backend format
      */

package/dist/index.d.ts

@@ -93,10 +93,16 @@ interface PaymentError {
 interface ReevitTheme {
     /** Primary brand color */
     primaryColor?: string;
+    /** Primary text color on brand surfaces */
+    primaryForegroundColor?: string;
     /** Background color */
     backgroundColor?: string;
+    /** Surface color for cards/panels */
+    surfaceColor?: string;
     /** Text color */
     textColor?: string;
+    /** Muted text color */
+    mutedTextColor?: string;
     /** Border radius for inputs and buttons */
     borderRadius?: string;
     /** Font family to use */
@@ -104,6 +110,12 @@ interface ReevitTheme {
     /** Whether to use dark mode */
     darkMode?: boolean;
 }
+interface CheckoutProviderOption {
+    provider: string;
+    name: string;
+    methods: PaymentMethod[];
+    countries?: string[];
+}
 interface MobileMoneyFormData {
     phone: string;
     network: MobileMoneyNetwork;
@@ -148,6 +160,10 @@ interface PaymentIntent {
     netAmount?: number;
     /** Additional metadata */
     metadata?: Record<string, unknown>;
+    /** Available PSPs for this checkout session */
+    availableProviders?: CheckoutProviderOption[];
+    /** Brand theme from checkout settings */
+    branding?: ReevitTheme;
 }
 
 interface ReevitContextValue {
@@ -195,7 +211,10 @@ declare function useReevit(options: UseReevitOptions): {
     selectedMethod: PaymentMethod | null;
     error: PaymentError | null;
     result: PaymentResult | null;
-    initialize: (method?: PaymentMethod) => Promise<void>;
+    initialize: (method?: PaymentMethod, options?: {
+        preferredProvider?: string;
+        allowedProviders?: string[];
+    }) => Promise<void>;
     selectMethod: (method: PaymentMethod) => void;
     processPayment: (paymentData: Record<string, unknown>) => Promise<void>;
     handlePspSuccess: (pspData: Record<string, unknown>) => Promise<void>;
@@ -258,6 +277,8 @@ declare function loadPaystackScript(): Promise<void>;
 declare function PaystackBridge({ publicKey, email, phone, amount, currency, reference, accessCode, metadata, channels, onSuccess, onError, onClose, autoStart, }: PaystackBridgeProps): react_jsx_runtime.JSX.Element;
 
 interface HubtelBridgeProps {
+    paymentId: string;
+    publicKey: string;
     merchantAccount: string | number;
     amount: number;
     currency?: string;
@@ -266,13 +287,16 @@ interface HubtelBridgeProps {
     phone?: string;
     description?: string;
     callbackUrl?: string;
+    /** Session token from server (recommended - credentials never exposed to client) */
+    hubtelSessionToken?: string;
+    /** Basic auth credential (legacy - credentials exposed to client, deprecated) */
     basicAuth?: string;
     onSuccess: (result: PaymentResult) => void;
     onError: (error: PaymentError) => void;
     onClose: () => void;
     autoStart?: boolean;
 }
-declare function HubtelBridge({ merchantAccount, amount, reference, phone, description, callbackUrl, basicAuth, onSuccess, onError, onClose, autoStart, }: HubtelBridgeProps): react_jsx_runtime.JSX.Element;
+declare function HubtelBridge({ paymentId, publicKey, merchantAccount, amount, reference, phone, description, callbackUrl, hubtelSessionToken, basicAuth, onSuccess, onError, onClose, autoStart, }: HubtelBridgeProps): react_jsx_runtime.JSX.Element;
 /**
  * Opens Hubtel checkout modal directly
  * Uses the @hubteljs/checkout npm package
@@ -552,6 +576,27 @@ interface PaymentIntentResponse {
     fee_currency: string;
     net_amount: number;
     reference?: string;
+    available_psps?: Array<{
+        provider: string;
+        name: string;
+        methods: string[];
+        countries?: string[];
+    }>;
+    branding?: Record<string, unknown>;
+}
+/**
+ * Response from creating a Hubtel session token.
+ * The token provides secure, short-lived access to Hubtel checkout without exposing credentials.
+ */
+interface HubtelSessionResponse {
+    /** Short-lived session token for Hubtel checkout */
+    token: string;
+    /** Hubtel merchant account number */
+    merchantAccount: string;
+    /** Token expiry time in seconds */
+    expiresInSeconds: number;
+    /** Unix timestamp when the token expires */
+    expiresAt: number;
 }
 interface PaymentDetailResponse {
     id: string;
@@ -600,7 +645,10 @@ declare class ReevitAPIClient {
     /**
      * Creates a payment intent
      */
-    createPaymentIntent(config: ReevitCheckoutConfig, method: PaymentMethod, country?: string): Promise<{
+    createPaymentIntent(config: ReevitCheckoutConfig, method: PaymentMethod, country?: string, options?: {
+        preferredProviders?: string[];
+        allowedProviders?: string[];
+    }): Promise<{
         data?: PaymentIntentResponse;
         error?: PaymentError;
     }>;
@@ -632,6 +680,18 @@ declare class ReevitAPIClient {
         data?: PaymentDetailResponse;
         error?: PaymentError;
     }>;
+    /**
+     * Creates a Hubtel session token for secure checkout.
+     * This endpoint generates a short-lived token that maps to Hubtel credentials server-side,
+     * avoiding exposure of sensitive credentials to the client.
+     *
+     * @param paymentId - The payment intent ID for Hubtel checkout
+     * @returns Hubtel session with token, merchant account, and expiry information
+     */
+    createHubtelSession(paymentId: string): Promise<{
+        data?: HubtelSessionResponse;
+        error?: PaymentError;
+    }>;
     /**
      * Maps SDK payment method to backend format
      */