@boostengine/payments 1.0.0 → 1.1.0

package/dist/react.d.ts

@@ -0,0 +1,29 @@
+import { B as BoostPaymentOpenOptions } from './types-D3bPaYhQ.js';
+
+/**
+ * Dynamically loads an external script into the browser document.
+ */
+declare function loadScript(src: string): Promise<boolean>;
+/**
+ * Loads Razorpay Checkout JavaScript library.
+ */
+declare function loadRazorpay(): Promise<boolean>;
+/**
+ * Loads Cashfree JS SDK v3.
+ */
+declare function loadCashfree(): Promise<boolean>;
+/**
+ * Universal Checkout Launcher for Browser & React applications.
+ * Automatically loads the gateway script, opens modals, or redirects.
+ */
+declare function openPaymentModal(options: BoostPaymentOpenOptions): Promise<void>;
+/**
+ * React Hook for seamless payment checkout in Next.js / React.
+ */
+declare function useBoostPayment(): {
+    openPaymentModal: (options: BoostPaymentOpenOptions) => Promise<void>;
+    isProcessing: boolean;
+    error: string | null;
+};
+
+export { loadCashfree, loadRazorpay, loadScript, openPaymentModal, useBoostPayment };

package/dist/react.mjs

@@ -0,0 +1,167 @@
+'use client';
+import { useState, useCallback } from 'react';
+
+function loadScript(src) {
+  return new Promise((resolve) => {
+    if (typeof window === "undefined") {
+      return resolve(false);
+    }
+    if (document.querySelector(`script[src="${src}"]`)) {
+      return resolve(true);
+    }
+    const script = document.createElement("script");
+    script.src = src;
+    script.async = true;
+    script.onload = () => resolve(true);
+    script.onerror = () => resolve(false);
+    document.body.appendChild(script);
+  });
+}
+async function loadRazorpay() {
+  return loadScript("https://checkout.razorpay.com/v1/checkout.js");
+}
+async function loadCashfree() {
+  return loadScript("https://sdk.cashfree.com/js/v3/cashfree.js");
+}
+async function openPaymentModal(options) {
+  const { order, onSuccess, onFailure, onDismiss, name, description, image, themeColor, prefill } = options;
+  if (typeof window === "undefined") {
+    throw new Error("openPaymentModal can only be called in a browser environment.");
+  }
+  const gateway = order.gateway;
+  if (gateway === "razorpay") {
+    const loaded = await loadRazorpay();
+    if (!loaded) {
+      onFailure?.({ gateway: "razorpay", message: "Failed to load Razorpay checkout SDK." });
+      return;
+    }
+    const RazorpayConstructor = window.Razorpay;
+    if (!RazorpayConstructor) {
+      onFailure?.({ gateway: "razorpay", message: "Razorpay SDK is not available on window." });
+      return;
+    }
+    const rzpOptions = {
+      key: order.rawResponse?.key || order.rawResponse?.key_id,
+      amount: Math.round(order.amount * 100),
+      currency: order.currency,
+      name: name || "Order Checkout",
+      description: description || `Payment for order #${order.orderId}`,
+      image,
+      order_id: order.gatewayOrderId,
+      prefill: prefill || {},
+      theme: {
+        color: themeColor || "#3399cc"
+      },
+      handler: function(response) {
+        onSuccess({
+          gateway: "razorpay",
+          orderId: order.orderId,
+          paymentId: response.razorpay_payment_id,
+          signature: response.razorpay_signature,
+          rawResponse: response
+        });
+      },
+      modal: {
+        ondismiss: function() {
+          onDismiss?.();
+        }
+      }
+    };
+    const rzp = new RazorpayConstructor(rzpOptions);
+    rzp.on("payment.failed", function(resp) {
+      onFailure?.({
+        gateway: "razorpay",
+        message: resp.error?.description || "Payment was declined",
+        rawError: resp.error
+      });
+    });
+    rzp.open();
+    return;
+  }
+  if (gateway === "cashfree") {
+    if (order.paymentSessionId) {
+      const loaded = await loadCashfree();
+      if (!loaded) {
+        onFailure?.({ gateway: "cashfree", message: "Failed to load Cashfree SDK." });
+        return;
+      }
+      const CashfreeConstructor = window.Cashfree;
+      if (CashfreeConstructor) {
+        const isSandbox = order.paymentSessionId.includes("test") || order.rawResponse?.environment === "SANDBOX";
+        const cashfree = CashfreeConstructor({ mode: isSandbox ? "sandbox" : "production" });
+        cashfree.checkout({
+          paymentSessionId: order.paymentSessionId,
+          redirectTarget: "_self"
+        });
+        return;
+      }
+    }
+    if (order.redirectUrl) {
+      window.location.href = order.redirectUrl;
+      return;
+    }
+    onFailure?.({ gateway: "cashfree", message: "No payment session ID or redirect URL found for Cashfree order." });
+    return;
+  }
+  if (gateway === "phonepe" || gateway === "stripe" || gateway === "paytm") {
+    if (order.redirectUrl) {
+      window.location.href = order.redirectUrl;
+      return;
+    }
+    onFailure?.({ gateway, message: `No redirect URL returned for ${gateway} checkout.` });
+    return;
+  }
+  if (gateway === "cod") {
+    onSuccess({
+      gateway: "cod",
+      orderId: order.orderId,
+      paymentId: `COD_${order.orderId}`,
+      rawResponse: order.rawResponse
+    });
+    return;
+  }
+  onFailure?.({ gateway, message: `Unsupported checkout gateway: ${gateway}` });
+}
+function useBoostPayment() {
+  const [isProcessing, setIsProcessing] = useState(false);
+  const [error, setError] = useState(null);
+  const startPayment = useCallback(async (options) => {
+    setIsProcessing(true);
+    setError(null);
+    try {
+      await openPaymentModal({
+        ...options,
+        onSuccess: (res) => {
+          setIsProcessing(false);
+          options.onSuccess(res);
+        },
+        onFailure: (err) => {
+          setIsProcessing(false);
+          setError(err.message);
+          options.onFailure?.(err);
+        },
+        onDismiss: () => {
+          setIsProcessing(false);
+          options.onDismiss?.();
+        }
+      });
+    } catch (err) {
+      setIsProcessing(false);
+      setError(err.message);
+      options.onFailure?.({
+        gateway: options.order.gateway,
+        message: err.message || "Payment initiation failed",
+        rawError: err
+      });
+    }
+  }, []);
+  return {
+    openPaymentModal: startPayment,
+    isProcessing,
+    error
+  };
+}
+
+export { loadCashfree, loadRazorpay, loadScript, openPaymentModal, useBoostPayment };
+//# sourceMappingURL=react.mjs.map
+//# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/index.ts"],"names":[],"mappings":"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","file":"react.mjs","sourcesContent":["'use client';\n\nimport { useState, useCallback } from 'react';\nimport { BoostPaymentOpenOptions, GatewayName, UnifiedOrderResult } from '../types';\n\n/**\n * Dynamically loads an external script into the browser document.\n */\nexport function loadScript(src: string): Promise<boolean> {\n  return new Promise((resolve) => {\n    if (typeof window === 'undefined') {\n      return resolve(false);\n    }\n    if (document.querySelector(`script[src=\"${src}\"]`)) {\n      return resolve(true);\n    }\n    const script = document.createElement('script');\n    script.src = src;\n    script.async = true;\n    script.onload = () => resolve(true);\n    script.onerror = () => resolve(false);\n    document.body.appendChild(script);\n  });\n}\n\n/**\n * Loads Razorpay Checkout JavaScript library.\n */\nexport async function loadRazorpay(): Promise<boolean> {\n  return loadScript('https://checkout.razorpay.com/v1/checkout.js');\n}\n\n/**\n * Loads Cashfree JS SDK v3.\n */\nexport async function loadCashfree(): Promise<boolean> {\n  return loadScript('https://sdk.cashfree.com/js/v3/cashfree.js');\n}\n\n/**\n * Universal Checkout Launcher for Browser & React applications.\n * Automatically loads the gateway script, opens modals, or redirects.\n */\nexport async function openPaymentModal(options: BoostPaymentOpenOptions): Promise<void> {\n  const { order, onSuccess, onFailure, onDismiss, name, description, image, themeColor, prefill } = options;\n\n  if (typeof window === 'undefined') {\n    throw new Error('openPaymentModal can only be called in a browser environment.');\n  }\n\n  const gateway = order.gateway;\n\n  // 1. RAZORPAY MODAL\n  if (gateway === 'razorpay') {\n    const loaded = await loadRazorpay();\n    if (!loaded) {\n      onFailure?.({ gateway: 'razorpay', message: 'Failed to load Razorpay checkout SDK.' });\n      return;\n    }\n\n    const RazorpayConstructor = (window as any).Razorpay;\n    if (!RazorpayConstructor) {\n      onFailure?.({ gateway: 'razorpay', message: 'Razorpay SDK is not available on window.' });\n      return;\n    }\n\n    const rzpOptions = {\n      key: (order.rawResponse as any)?.key || (order.rawResponse as any)?.key_id,\n      amount: Math.round(order.amount * 100),\n      currency: order.currency,\n      name: name || 'Order Checkout',\n      description: description || `Payment for order #${order.orderId}`,\n      image: image,\n      order_id: order.gatewayOrderId,\n      prefill: prefill || {},\n      theme: {\n        color: themeColor || '#3399cc',\n      },\n      handler: function (response: any) {\n        onSuccess({\n          gateway: 'razorpay',\n          orderId: order.orderId,\n          paymentId: response.razorpay_payment_id,\n          signature: response.razorpay_signature,\n          rawResponse: response,\n        });\n      },\n      modal: {\n        ondismiss: function () {\n          onDismiss?.();\n        },\n      },\n    };\n\n    const rzp = new RazorpayConstructor(rzpOptions);\n    rzp.on('payment.failed', function (resp: any) {\n      onFailure?.({\n        gateway: 'razorpay',\n        message: resp.error?.description || 'Payment was declined',\n        rawError: resp.error,\n      });\n    });\n    rzp.open();\n    return;\n  }\n\n  // 2. CASHFREE DROPIN\n  if (gateway === 'cashfree') {\n    if (order.paymentSessionId) {\n      const loaded = await loadCashfree();\n      if (!loaded) {\n        onFailure?.({ gateway: 'cashfree', message: 'Failed to load Cashfree SDK.' });\n        return;\n      }\n\n      const CashfreeConstructor = (window as any).Cashfree;\n      if (CashfreeConstructor) {\n        const isSandbox = order.paymentSessionId.includes('test') || (order.rawResponse as any)?.environment === 'SANDBOX';\n        const cashfree = CashfreeConstructor({ mode: isSandbox ? 'sandbox' : 'production' });\n        cashfree.checkout({\n          paymentSessionId: order.paymentSessionId,\n          redirectTarget: '_self',\n        });\n        return;\n      }\n    }\n\n    if (order.redirectUrl) {\n      window.location.href = order.redirectUrl;\n      return;\n    }\n\n    onFailure?.({ gateway: 'cashfree', message: 'No payment session ID or redirect URL found for Cashfree order.' });\n    return;\n  }\n\n  // 3. PHONEPE / STRIPE / PAYTM REDIRECT\n  if (gateway === 'phonepe' || gateway === 'stripe' || gateway === 'paytm') {\n    if (order.redirectUrl) {\n      window.location.href = order.redirectUrl;\n      return;\n    }\n    onFailure?.({ gateway, message: `No redirect URL returned for ${gateway} checkout.` });\n    return;\n  }\n\n  // 4. CASH ON DELIVERY (COD)\n  if (gateway === 'cod') {\n    onSuccess({\n      gateway: 'cod',\n      orderId: order.orderId,\n      paymentId: `COD_${order.orderId}`,\n      rawResponse: order.rawResponse,\n    });\n    return;\n  }\n\n  onFailure?.({ gateway, message: `Unsupported checkout gateway: ${gateway}` });\n}\n\n/**\n * React Hook for seamless payment checkout in Next.js / React.\n */\nexport function useBoostPayment() {\n  const [isProcessing, setIsProcessing] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n\n  const startPayment = useCallback(async (options: BoostPaymentOpenOptions) => {\n    setIsProcessing(true);\n    setError(null);\n\n    try {\n      await openPaymentModal({\n        ...options,\n        onSuccess: (res) => {\n          setIsProcessing(false);\n          options.onSuccess(res);\n        },\n        onFailure: (err) => {\n          setIsProcessing(false);\n          setError(err.message);\n          options.onFailure?.(err);\n        },\n        onDismiss: () => {\n          setIsProcessing(false);\n          options.onDismiss?.();\n        },\n      });\n    } catch (err: any) {\n      setIsProcessing(false);\n      setError(err.message);\n      options.onFailure?.({\n        gateway: options.order.gateway,\n        message: err.message || 'Payment initiation failed',\n        rawError: err,\n      });\n    }\n  }, []);\n\n  return {\n    openPaymentModal: startPayment,\n    isProcessing,\n    error,\n  };\n}\n"]}

package/dist/types-D3bPaYhQ.d.mts

@@ -0,0 +1,194 @@
+type GatewayName = 'razorpay' | 'cashfree' | 'phonepe' | 'paytm' | 'stripe' | 'cod';
+type SupportedGateway = GatewayName;
+interface UnifiedCustomer {
+    id?: string;
+    name: string;
+    email: string;
+    phone: string;
+}
+interface UnifiedOrderItem {
+    name: string;
+    quantity: number;
+    price: number;
+    sku?: string;
+}
+interface UnifiedCreateOrderOptions {
+    /** Amount in standard human currency units (e.g. 1499.00 for INR, 25.00 for USD). Package handles subunit conversions internally! */
+    amount: number;
+    /** 3-letter ISO currency code (e.g. 'INR', 'USD', 'EUR') */
+    currency: string;
+    /** Merchant order or receipt reference ID */
+    receipt: string;
+    /** Customer details */
+    customer: UnifiedCustomer;
+    /** Line items */
+    items?: UnifiedOrderItem[];
+    /** Merchant notes/metadata */
+    notes?: Record<string, any>;
+    /** Customer return/redirect URL after payment */
+    redirectUrl?: string;
+    /** Server-to-server webhook callback URL */
+    callbackUrl?: string;
+    /** Explicitly override gateway for this transaction */
+    gateway?: GatewayName;
+}
+type CreateOrderOptions = UnifiedCreateOrderOptions;
+interface UnifiedOrderResult {
+    gateway: GatewayName;
+    orderId: string;
+    gatewayOrderId: string;
+    /** Amount in standard currency units (e.g. 1499.00) */
+    amount: number;
+    currency: string;
+    status: 'CREATED' | 'PENDING' | 'PAID' | 'FAILED';
+    /** Cashfree payment_session_id for Drop-in UI or SDK */
+    paymentSessionId?: string;
+    /** Redirect or hosted pay URL (PhonePe, Stripe, Cashfree) */
+    redirectUrl?: string;
+    /** Paytm checkout txnToken */
+    txnToken?: string;
+    /** Raw response object from gateway */
+    rawResponse: any;
+}
+type PaymentOrderResult = UnifiedOrderResult;
+interface UnifiedPaymentVerificationOptions {
+    gateway: GatewayName;
+    orderId: string;
+    paymentId?: string;
+    signature?: string;
+    rawPayload?: any;
+}
+interface UnifiedPaymentVerificationResult {
+    gateway: GatewayName;
+    isSuccessful: boolean;
+    paymentId: string;
+    orderId: string;
+    /** Amount in standard currency units (e.g. 1499.00) */
+    amount: number;
+    currency: string;
+    paymentMethod?: string;
+    rawResponse: any;
+}
+type VerificationResult = UnifiedPaymentVerificationResult;
+interface UnifiedRefundOptions {
+    gateway: GatewayName;
+    paymentId: string;
+    orderId?: string;
+    /** Partial or full refund amount in standard currency units */
+    amount?: number;
+    reason?: string;
+}
+interface UnifiedRefundResult {
+    gateway: GatewayName;
+    refundId: string;
+    paymentId: string;
+    /** Amount in standard currency units */
+    amount: number;
+    status: 'SUCCESS' | 'PENDING' | 'FAILED';
+    rawResponse: any;
+}
+type RefundResult = UnifiedRefundResult;
+type NormalizedWebhookEvent = 'PAYMENT_SUCCESS' | 'PAYMENT_FAILED' | 'REFUND_PROCESSED' | 'REFUND_FAILED' | 'DISPUTE_CREATED' | 'UNKNOWN';
+interface WebhookVerificationOptions {
+    gateway: GatewayName;
+    rawBody: string | Buffer;
+    headers: Record<string, string | string[] | undefined>;
+    webhookSecret?: string;
+}
+interface WebhookVerificationResult {
+    isValid: boolean;
+    /** Standardized event name across all payment gateways */
+    normalizedEvent: NormalizedWebhookEvent;
+    /** Original raw event name sent by the provider */
+    rawEvent?: string;
+    gateway: GatewayName;
+    orderId?: string;
+    paymentId?: string;
+    /** Amount in standard currency units (e.g. 1499.00) */
+    amount?: number;
+    currency?: string;
+    data?: any;
+    error?: string;
+}
+type WebhookResult = WebhookVerificationResult;
+interface RazorpayConfig {
+    keyId: string;
+    keySecret: string;
+    webhookSecret?: string;
+}
+interface CashfreeConfig {
+    appId: string;
+    secretKey: string;
+    env?: 'SANDBOX' | 'PRODUCTION';
+    apiVersion?: string;
+}
+interface PhonePeConfig {
+    merchantId: string;
+    saltKey: string;
+    saltIndex?: string;
+    env?: 'UAT' | 'PRODUCTION';
+}
+interface PaytmConfig {
+    mid: string;
+    merchantKey: string;
+    website?: string;
+    env?: 'STAGE' | 'PRODUCTION';
+}
+interface StripeConfig {
+    secretKey: string;
+    webhookSecret?: string;
+}
+interface CODConfig {
+    minOrderValue?: number;
+    maxOrderValue?: number;
+    extraFee?: number;
+    allowedPincodes?: string[];
+}
+interface GatewayConfigs {
+    razorpay?: RazorpayConfig;
+    cashfree?: CashfreeConfig;
+    phonepe?: PhonePeConfig;
+    paytm?: PaytmConfig;
+    stripe?: StripeConfig;
+    cod?: CODConfig;
+}
+interface SmartRoutingConfig {
+    /** Map currency to default gateway, e.g. { 'USD': 'stripe', 'INR': 'cashfree' } */
+    currencyMap?: Record<string, GatewayName>;
+    /** Automatic fallback order if primary gateway fails, e.g. ['razorpay', 'cashfree', 'phonepe'] */
+    fallbackChain?: GatewayName[];
+}
+interface PaymentManagerOptions {
+    defaultGateway?: GatewayName;
+    gateways: GatewayConfigs;
+    smartRouting?: SmartRoutingConfig;
+}
+interface BoostPaymentOpenOptions {
+    order: UnifiedOrderResult;
+    onSuccess: (response: {
+        gateway: GatewayName;
+        orderId: string;
+        paymentId?: string;
+        signature?: string;
+        rawResponse?: any;
+    }) => void;
+    onFailure?: (error: {
+        gateway: GatewayName;
+        message: string;
+        rawError?: any;
+    }) => void;
+    onDismiss?: () => void;
+    /** Store / brand name displayed in checkout modal */
+    name?: string;
+    description?: string;
+    image?: string;
+    themeColor?: string;
+    /** Prefill user details if available */
+    prefill?: {
+        name?: string;
+        email?: string;
+        contact?: string;
+    };
+}
+
+export type { BoostPaymentOpenOptions as B, CashfreeConfig as C, GatewayName as G, NormalizedWebhookEvent as N, PaymentManagerOptions as P, RazorpayConfig as R, StripeConfig as S, UnifiedCreateOrderOptions as U, VerificationResult as V, WebhookVerificationOptions as W, UnifiedOrderResult as a, UnifiedPaymentVerificationOptions as b, UnifiedPaymentVerificationResult as c, UnifiedRefundOptions as d, UnifiedRefundResult as e, WebhookVerificationResult as f, PhonePeConfig as g, PaytmConfig as h, CODConfig as i, CreateOrderOptions as j, GatewayConfigs as k, PaymentOrderResult as l, RefundResult as m, SmartRoutingConfig as n, SupportedGateway as o, UnifiedCustomer as p, UnifiedOrderItem as q, WebhookResult as r };

package/dist/types-D3bPaYhQ.d.ts

@@ -0,0 +1,194 @@
+type GatewayName = 'razorpay' | 'cashfree' | 'phonepe' | 'paytm' | 'stripe' | 'cod';
+type SupportedGateway = GatewayName;
+interface UnifiedCustomer {
+    id?: string;
+    name: string;
+    email: string;
+    phone: string;
+}
+interface UnifiedOrderItem {
+    name: string;
+    quantity: number;
+    price: number;
+    sku?: string;
+}
+interface UnifiedCreateOrderOptions {
+    /** Amount in standard human currency units (e.g. 1499.00 for INR, 25.00 for USD). Package handles subunit conversions internally! */
+    amount: number;
+    /** 3-letter ISO currency code (e.g. 'INR', 'USD', 'EUR') */
+    currency: string;
+    /** Merchant order or receipt reference ID */
+    receipt: string;
+    /** Customer details */
+    customer: UnifiedCustomer;
+    /** Line items */
+    items?: UnifiedOrderItem[];
+    /** Merchant notes/metadata */
+    notes?: Record<string, any>;
+    /** Customer return/redirect URL after payment */
+    redirectUrl?: string;
+    /** Server-to-server webhook callback URL */
+    callbackUrl?: string;
+    /** Explicitly override gateway for this transaction */
+    gateway?: GatewayName;
+}
+type CreateOrderOptions = UnifiedCreateOrderOptions;
+interface UnifiedOrderResult {
+    gateway: GatewayName;
+    orderId: string;
+    gatewayOrderId: string;
+    /** Amount in standard currency units (e.g. 1499.00) */
+    amount: number;
+    currency: string;
+    status: 'CREATED' | 'PENDING' | 'PAID' | 'FAILED';
+    /** Cashfree payment_session_id for Drop-in UI or SDK */
+    paymentSessionId?: string;
+    /** Redirect or hosted pay URL (PhonePe, Stripe, Cashfree) */
+    redirectUrl?: string;
+    /** Paytm checkout txnToken */
+    txnToken?: string;
+    /** Raw response object from gateway */
+    rawResponse: any;
+}
+type PaymentOrderResult = UnifiedOrderResult;
+interface UnifiedPaymentVerificationOptions {
+    gateway: GatewayName;
+    orderId: string;
+    paymentId?: string;
+    signature?: string;
+    rawPayload?: any;
+}
+interface UnifiedPaymentVerificationResult {
+    gateway: GatewayName;
+    isSuccessful: boolean;
+    paymentId: string;
+    orderId: string;
+    /** Amount in standard currency units (e.g. 1499.00) */
+    amount: number;
+    currency: string;
+    paymentMethod?: string;
+    rawResponse: any;
+}
+type VerificationResult = UnifiedPaymentVerificationResult;
+interface UnifiedRefundOptions {
+    gateway: GatewayName;
+    paymentId: string;
+    orderId?: string;
+    /** Partial or full refund amount in standard currency units */
+    amount?: number;
+    reason?: string;
+}
+interface UnifiedRefundResult {
+    gateway: GatewayName;
+    refundId: string;
+    paymentId: string;
+    /** Amount in standard currency units */
+    amount: number;
+    status: 'SUCCESS' | 'PENDING' | 'FAILED';
+    rawResponse: any;
+}
+type RefundResult = UnifiedRefundResult;
+type NormalizedWebhookEvent = 'PAYMENT_SUCCESS' | 'PAYMENT_FAILED' | 'REFUND_PROCESSED' | 'REFUND_FAILED' | 'DISPUTE_CREATED' | 'UNKNOWN';
+interface WebhookVerificationOptions {
+    gateway: GatewayName;
+    rawBody: string | Buffer;
+    headers: Record<string, string | string[] | undefined>;
+    webhookSecret?: string;
+}
+interface WebhookVerificationResult {
+    isValid: boolean;
+    /** Standardized event name across all payment gateways */
+    normalizedEvent: NormalizedWebhookEvent;
+    /** Original raw event name sent by the provider */
+    rawEvent?: string;
+    gateway: GatewayName;
+    orderId?: string;
+    paymentId?: string;
+    /** Amount in standard currency units (e.g. 1499.00) */
+    amount?: number;
+    currency?: string;
+    data?: any;
+    error?: string;
+}
+type WebhookResult = WebhookVerificationResult;
+interface RazorpayConfig {
+    keyId: string;
+    keySecret: string;
+    webhookSecret?: string;
+}
+interface CashfreeConfig {
+    appId: string;
+    secretKey: string;
+    env?: 'SANDBOX' | 'PRODUCTION';
+    apiVersion?: string;
+}
+interface PhonePeConfig {
+    merchantId: string;
+    saltKey: string;
+    saltIndex?: string;
+    env?: 'UAT' | 'PRODUCTION';
+}
+interface PaytmConfig {
+    mid: string;
+    merchantKey: string;
+    website?: string;
+    env?: 'STAGE' | 'PRODUCTION';
+}
+interface StripeConfig {
+    secretKey: string;
+    webhookSecret?: string;
+}
+interface CODConfig {
+    minOrderValue?: number;
+    maxOrderValue?: number;
+    extraFee?: number;
+    allowedPincodes?: string[];
+}
+interface GatewayConfigs {
+    razorpay?: RazorpayConfig;
+    cashfree?: CashfreeConfig;
+    phonepe?: PhonePeConfig;
+    paytm?: PaytmConfig;
+    stripe?: StripeConfig;
+    cod?: CODConfig;
+}
+interface SmartRoutingConfig {
+    /** Map currency to default gateway, e.g. { 'USD': 'stripe', 'INR': 'cashfree' } */
+    currencyMap?: Record<string, GatewayName>;
+    /** Automatic fallback order if primary gateway fails, e.g. ['razorpay', 'cashfree', 'phonepe'] */
+    fallbackChain?: GatewayName[];
+}
+interface PaymentManagerOptions {
+    defaultGateway?: GatewayName;
+    gateways: GatewayConfigs;
+    smartRouting?: SmartRoutingConfig;
+}
+interface BoostPaymentOpenOptions {
+    order: UnifiedOrderResult;
+    onSuccess: (response: {
+        gateway: GatewayName;
+        orderId: string;
+        paymentId?: string;
+        signature?: string;
+        rawResponse?: any;
+    }) => void;
+    onFailure?: (error: {
+        gateway: GatewayName;
+        message: string;
+        rawError?: any;
+    }) => void;
+    onDismiss?: () => void;
+    /** Store / brand name displayed in checkout modal */
+    name?: string;
+    description?: string;
+    image?: string;
+    themeColor?: string;
+    /** Prefill user details if available */
+    prefill?: {
+        name?: string;
+        email?: string;
+        contact?: string;
+    };
+}
+
+export type { BoostPaymentOpenOptions as B, CashfreeConfig as C, GatewayName as G, NormalizedWebhookEvent as N, PaymentManagerOptions as P, RazorpayConfig as R, StripeConfig as S, UnifiedCreateOrderOptions as U, VerificationResult as V, WebhookVerificationOptions as W, UnifiedOrderResult as a, UnifiedPaymentVerificationOptions as b, UnifiedPaymentVerificationResult as c, UnifiedRefundOptions as d, UnifiedRefundResult as e, WebhookVerificationResult as f, PhonePeConfig as g, PaytmConfig as h, CODConfig as i, CreateOrderOptions as j, GatewayConfigs as k, PaymentOrderResult as l, RefundResult as m, SmartRoutingConfig as n, SupportedGateway as o, UnifiedCustomer as p, UnifiedOrderItem as q, WebhookResult as r };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@boostengine/payments",
-  "version": "1.0.0",
-  "description": "Unified Multi-Gateway Payment Orchestration for Indian & Global eCommerce (Razorpay, Cashfree, PhonePe, Paytm, Stripe, COD) with smart routing, automatic fallbacks, and signature verification.",
+  "version": "1.1.0",
+  "description": "Unified Multi-Gateway Payment Orchestration for Indian & Global eCommerce (Razorpay, Cashfree, PhonePe, Paytm, Stripe, COD) with smart routing, automatic fallbacks, signature verification, and React checkout hooks.",
   "author": "Boost Engine <boostengine001@gmail.com>",
   "license": "MIT",
   "keywords": [
@@ -18,7 +18,9 @@
     "ecommerce",
     "checkout",
     "upi",
-    "smart-routing"
+    "smart-routing",
+    "nextjs-webhook",
+    "react-payments"
   ],
   "bin": {
     "boost-payments": "./bin/cli.cjs"
@@ -31,6 +33,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.mjs",
+      "require": "./dist/react.cjs"
     }
   },
   "files": [
@@ -43,8 +50,18 @@
     "test": "node test-suite.cjs",
     "prepublishOnly": "npm run build && npm test"
   },
+  "peerDependencies": {
+    "react": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/node": "^20.14.0",
+    "@types/react": "^18.3.0",
+    "react": "^18.3.1",
     "tsup": "^8.3.5",
     "typescript": "^5.6.3"
   }