@boostengine/payments 1.0.0 → 1.1.1

package/dist/index.d.ts

@@ -1,150 +1,5 @@
-type GatewayName = 'razorpay' | 'cashfree' | 'phonepe' | 'paytm' | 'stripe' | 'cod';
-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 currency units (e.g. 1499.00 for INR, 25.00 for USD) */
-    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;
-}
-interface UnifiedOrderResult {
-    gateway: GatewayName;
-    orderId: string;
-    gatewayOrderId: string;
-    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;
-}
-interface UnifiedPaymentVerificationOptions {
-    gateway: GatewayName;
-    orderId: string;
-    paymentId?: string;
-    signature?: string;
-    rawPayload?: any;
-}
-interface UnifiedPaymentVerificationResult {
-    gateway: GatewayName;
-    isSuccessful: boolean;
-    paymentId: string;
-    orderId: string;
-    amount: number;
-    currency: string;
-    paymentMethod?: string;
-    rawResponse: any;
-}
-interface UnifiedRefundOptions {
-    gateway: GatewayName;
-    paymentId: string;
-    orderId?: string;
-    /** Partial or full refund amount in currency units */
-    amount?: number;
-    reason?: string;
-}
-interface UnifiedRefundResult {
-    gateway: GatewayName;
-    refundId: string;
-    paymentId: string;
-    amount: number;
-    status: 'SUCCESS' | 'PENDING' | 'FAILED';
-    rawResponse: any;
-}
-interface WebhookVerificationOptions {
-    gateway: GatewayName;
-    rawBody: string | Buffer;
-    headers: Record<string, string | string[] | undefined>;
-    webhookSecret?: string;
-}
-interface WebhookVerificationResult {
-    isValid: boolean;
-    event?: string;
-    gateway: GatewayName;
-    data?: any;
-    error?: string;
-}
-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;
-}
+import { G as GatewayName, U as UnifiedCreateOrderOptions, a as UnifiedOrderResult, b as UnifiedPaymentVerificationOptions, c as UnifiedPaymentVerificationResult, d as UnifiedRefundOptions, e as UnifiedRefundResult, W as WebhookVerificationOptions, f as WebhookVerificationResult, P as PaymentManagerOptions, R as RazorpayConfig, C as CashfreeConfig, g as PhonePeConfig, h as PaytmConfig, S as StripeConfig, i as CODConfig } from './types-D3bPaYhQ.js';
+export { B as BoostPaymentOpenOptions, j as CreateOrderOptions, k as GatewayConfigs, N as NormalizedWebhookEvent, l as PaymentOrderResult, m as RefundResult, n as SmartRoutingConfig, o as SupportedGateway, p as UnifiedCustomer, q as UnifiedOrderItem, V as VerificationResult, r as WebhookResult } from './types-D3bPaYhQ.js';
 
 declare abstract class BasePaymentAdapter {
     abstract readonly name: GatewayName;
@@ -221,6 +76,23 @@ declare class PaymentManager {
      * Verifies incoming webhook authenticity and decodes payload.
      */
     verifyWebhook(options: WebhookVerificationOptions): Promise<WebhookVerificationResult>;
+    /**
+     * Ready-made Next.js 13/14/15 App Router Route Handler Webhook Authenticator.
+     * Directly consumes the standard web Request object with raw stream body handling:
+     *
+     * ```typescript
+     * export async function POST(req: Request) {
+     *   const result = await payments.verifyNextJsWebhook(req, { gateway: 'razorpay' });
+     *   if (!result.isValid) return new Response('Invalid Signature', { status: 400 });
+     *   console.log('Event:', result.normalizedEvent, result.orderId);
+     *   return new Response('OK');
+     * }
+     * ```
+     */
+    verifyNextJsWebhook(request: Request | any, options: {
+        gateway: GatewayName;
+        webhookSecret?: string;
+    }): Promise<WebhookVerificationResult>;
 }
 /**
  * Factory function to instantiate a PaymentManager.
@@ -336,4 +208,4 @@ declare class CODAdapter extends BasePaymentAdapter {
     verifyWebhook(_options: WebhookVerificationOptions): Promise<WebhookVerificationResult>;
 }
 
-export { BasePaymentAdapter, CODAdapter, type CODConfig, CashfreeAdapter, type CashfreeConfig, type GatewayConfigs, type GatewayName, GatewayNotConfiguredError, PaymentError, PaymentManager, type PaymentManagerOptions, PaytmAdapter, type PaytmConfig, PhonePeAdapter, type PhonePeConfig, RazorpayAdapter, type RazorpayConfig, SignatureVerificationError, type SmartRoutingConfig, StripeAdapter, type StripeConfig, type UnifiedCreateOrderOptions, type UnifiedCustomer, type UnifiedOrderItem, type UnifiedOrderResult, type UnifiedPaymentVerificationOptions, type UnifiedPaymentVerificationResult, type UnifiedRefundOptions, type UnifiedRefundResult, type WebhookVerificationOptions, type WebhookVerificationResult, base64Decode, base64Encode, createPaymentManager, hmacSha256, safeCompare, sha256 };
+export { BasePaymentAdapter, CODAdapter, CODConfig, CashfreeAdapter, CashfreeConfig, GatewayName, GatewayNotConfiguredError, PaymentError, PaymentManager, PaymentManagerOptions, PaytmAdapter, PaytmConfig, PhonePeAdapter, PhonePeConfig, RazorpayAdapter, RazorpayConfig, SignatureVerificationError, StripeAdapter, StripeConfig, UnifiedCreateOrderOptions, UnifiedOrderResult, UnifiedPaymentVerificationOptions, UnifiedPaymentVerificationResult, UnifiedRefundOptions, UnifiedRefundResult, WebhookVerificationOptions, WebhookVerificationResult, base64Decode, base64Encode, createPaymentManager, hmacSha256, safeCompare, sha256 };

package/dist/index.mjs

@@ -172,6 +172,7 @@ var RazorpayAdapter = class extends BasePaymentAdapter {
       paymentId: payment.id,
       orderId: options.orderId,
       amount: payment.amount / 100,
+      // Normalized back to standard currency units
       currency: payment.currency,
       paymentMethod: payment.method,
       rawResponse: payment
@@ -196,6 +197,7 @@ var RazorpayAdapter = class extends BasePaymentAdapter {
       refundId: res.id,
       paymentId: options.paymentId,
       amount: res.amount / 100,
+      // Normalized to standard currency units
       status: res.status === "processed" ? "SUCCESS" : "PENDING",
       rawResponse: res
     };
@@ -205,32 +207,58 @@ var RazorpayAdapter = class extends BasePaymentAdapter {
     if (!secret) {
       return {
         isValid: false,
+        normalizedEvent: "UNKNOWN",
         gateway: "razorpay",
         error: "Razorpay webhookSecret is not configured."
       };
     }
     const signature = this.getHeader(options.headers, "x-razorpay-signature");
-    if (!signature || typeof signature !== "string") {
+    if (!signature) {
       return {
         isValid: false,
+        normalizedEvent: "UNKNOWN",
         gateway: "razorpay",
-        error: "Missing X-Razorpay-Signature header."
+        error: "Missing x-razorpay-signature header."
       };
     }
     const rawString = typeof options.rawBody === "string" ? options.rawBody : options.rawBody.toString("utf8");
     const expectedSignature = hmacSha256(rawString, secret);
     const isValid = safeCompare(expectedSignature, signature);
-    let parsedData;
+    let parsed;
     try {
-      parsedData = JSON.parse(rawString);
+      parsed = JSON.parse(rawString);
     } catch {
-      parsedData = null;
+      parsed = null;
     }
+    const rawEvent = parsed?.event || "";
+    let normalizedEvent = "UNKNOWN";
+    if (rawEvent === "order.paid" || rawEvent === "payment.captured" || rawEvent === "payment.authorized") {
+      normalizedEvent = "PAYMENT_SUCCESS";
+    } else if (rawEvent === "payment.failed") {
+      normalizedEvent = "PAYMENT_FAILED";
+    } else if (rawEvent === "refund.processed" || rawEvent === "refund.created") {
+      normalizedEvent = "REFUND_PROCESSED";
+    } else if (rawEvent === "refund.failed") {
+      normalizedEvent = "REFUND_FAILED";
+    } else if (rawEvent?.includes("dispute")) {
+      normalizedEvent = "DISPUTE_CREATED";
+    }
+    const paymentEntity = parsed?.payload?.payment?.entity;
+    const orderEntity = parsed?.payload?.order?.entity;
+    const orderId = orderEntity?.receipt || paymentEntity?.order_id || orderEntity?.id;
+    const paymentId = paymentEntity?.id;
+    const amount = paymentEntity?.amount ? paymentEntity.amount / 100 : orderEntity?.amount ? orderEntity.amount / 100 : void 0;
+    const currency = paymentEntity?.currency || orderEntity?.currency;
     return {
       isValid,
+      normalizedEvent,
+      rawEvent,
       gateway: "razorpay",
-      event: parsedData?.event,
-      data: parsedData?.payload
+      orderId,
+      paymentId,
+      amount,
+      currency,
+      data: parsed?.payload
     };
   }
 };
@@ -363,17 +391,41 @@ var CashfreeAdapter = class extends BasePaymentAdapter {
       ).toString("base64");
       isValid = safeCompare(expectedSignature, signature);
     }
-    let parsedData;
+    let parsed;
     try {
-      parsedData = JSON.parse(rawString);
+      parsed = JSON.parse(rawString);
     } catch {
-      parsedData = null;
+      parsed = null;
+    }
+    const rawEvent = parsed?.type || "";
+    let normalizedEvent = "UNKNOWN";
+    if (rawEvent === "PAYMENT_SUCCESS_WEBHOOK") {
+      normalizedEvent = "PAYMENT_SUCCESS";
+    } else if (rawEvent === "PAYMENT_FAILED_WEBHOOK" || rawEvent === "USER_DROPPED_WEBHOOK") {
+      normalizedEvent = "PAYMENT_FAILED";
+    } else if (rawEvent === "REFUND_STATUS_WEBHOOK") {
+      const refundStatus = parsed?.data?.refund?.refund_status;
+      normalizedEvent = refundStatus === "SUCCESS" ? "REFUND_PROCESSED" : "REFUND_FAILED";
+    } else if (rawEvent?.includes("DISPUTE")) {
+      normalizedEvent = "DISPUTE_CREATED";
     }
+    const orderData = parsed?.data?.order;
+    const paymentData = parsed?.data?.payment;
+    const refundData = parsed?.data?.refund;
+    const orderId = orderData?.order_id || refundData?.order_id;
+    const paymentId = paymentData ? String(paymentData.cf_payment_id) : refundData ? String(refundData.cf_payment_id) : void 0;
+    const amount = paymentData?.payment_amount ?? orderData?.order_amount ?? refundData?.refund_amount;
+    const currency = paymentData?.payment_currency || orderData?.order_currency;
     return {
       isValid,
+      normalizedEvent,
+      rawEvent,
       gateway: "cashfree",
-      event: parsedData?.type,
-      data: parsedData?.data
+      orderId,
+      paymentId,
+      amount,
+      currency,
+      data: parsed?.data
     };
   }
 };
@@ -499,17 +551,36 @@ var PhonePeAdapter = class extends BasePaymentAdapter {
     try {
       parsed = JSON.parse(rawString);
     } catch {
-      return { isValid: false, gateway: "phonepe", error: "Invalid JSON payload" };
+      return { isValid: false, normalizedEvent: "UNKNOWN", gateway: "phonepe", error: "Invalid JSON payload" };
     }
     if (!parsed.response) {
-      return { isValid: false, gateway: "phonepe", error: "Missing response field in PhonePe callback" };
+      return { isValid: false, normalizedEvent: "UNKNOWN", gateway: "phonepe", error: "Missing response field in PhonePe callback" };
+    }
+    let decoded = {};
+    try {
+      decoded = JSON.parse(base64Decode(parsed.response));
+    } catch {
+      return { isValid: false, normalizedEvent: "UNKNOWN", gateway: "phonepe", error: "Failed to decode base64 PhonePe response" };
     }
-    const decoded = JSON.parse(base64Decode(parsed.response));
-    decoded.code === "PAYMENT_SUCCESS";
+    const rawEvent = decoded.code || "";
+    let normalizedEvent = "UNKNOWN";
+    if (rawEvent === "PAYMENT_SUCCESS") {
+      normalizedEvent = "PAYMENT_SUCCESS";
+    } else if (rawEvent === "PAYMENT_ERROR" || rawEvent === "PAYMENT_DECLINED") {
+      normalizedEvent = "PAYMENT_FAILED";
+    }
+    const orderId = decoded.data?.merchantTransactionId;
+    const paymentId = decoded.data?.transactionId;
+    const amount = decoded.data?.amount ? decoded.data.amount / 100 : void 0;
     return {
       isValid: true,
+      normalizedEvent,
+      rawEvent,
       gateway: "phonepe",
-      event: decoded.code,
+      orderId,
+      paymentId,
+      amount,
+      currency: "INR",
       data: decoded.data
     };
   }
@@ -624,11 +695,21 @@ var PaytmAdapter = class extends BasePaymentAdapter {
       const params = new URLSearchParams(rawString);
       parsed = Object.fromEntries(params.entries());
     }
-    const isSuccess = parsed?.STATUS === "TXN_SUCCESS" || parsed?.resultInfo?.resultStatus === "TXN_SUCCESS";
+    const rawStatus = parsed?.STATUS || parsed?.resultInfo?.resultStatus;
+    const isSuccess = rawStatus === "TXN_SUCCESS";
+    const normalizedEvent = isSuccess ? "PAYMENT_SUCCESS" : "PAYMENT_FAILED";
+    const orderId = parsed?.ORDERID || parsed?.orderId;
+    const paymentId = parsed?.TXNID || parsed?.txnId;
+    const amount = parsed?.TXNAMOUNT ? parseFloat(parsed.TXNAMOUNT) : void 0;
     return {
       isValid: true,
+      normalizedEvent,
+      rawEvent: rawStatus,
       gateway: "paytm",
-      event: isSuccess ? "TXN_SUCCESS" : "TXN_FAILURE",
+      orderId,
+      paymentId,
+      amount,
+      currency: "INR",
       data: parsed
     };
   }
@@ -720,6 +801,7 @@ var StripeAdapter = class extends BasePaymentAdapter {
       refundId: res.id,
       paymentId: options.paymentId,
       amount: res.amount / 100,
+      // Normalized to standard currency units
       status: res.status === "succeeded" ? "SUCCESS" : "PENDING",
       rawResponse: res
     };
@@ -727,11 +809,11 @@ var StripeAdapter = class extends BasePaymentAdapter {
   async verifyWebhook(options) {
     const secret = options.webhookSecret || this.config.webhookSecret;
     if (!secret) {
-      return { isValid: false, gateway: "stripe", error: "Stripe webhookSecret is not configured." };
+      return { isValid: false, normalizedEvent: "UNKNOWN", gateway: "stripe", error: "Stripe webhookSecret is not configured." };
     }
     const sigHeader = this.getHeader(options.headers, "stripe-signature");
     if (!sigHeader || typeof sigHeader !== "string") {
-      return { isValid: false, gateway: "stripe", error: "Missing stripe-signature header." };
+      return { isValid: false, normalizedEvent: "UNKNOWN", gateway: "stripe", error: "Missing stripe-signature header." };
     }
     const parts = sigHeader.split(",");
     let timestamp = "";
@@ -751,11 +833,32 @@ var StripeAdapter = class extends BasePaymentAdapter {
     } catch {
       parsed = null;
     }
+    const rawEvent = parsed?.type || "";
+    let normalizedEvent = "UNKNOWN";
+    if (rawEvent === "checkout.session.completed" || rawEvent === "payment_intent.succeeded") {
+      normalizedEvent = "PAYMENT_SUCCESS";
+    } else if (rawEvent === "payment_intent.payment_failed") {
+      normalizedEvent = "PAYMENT_FAILED";
+    } else if (rawEvent === "charge.refunded") {
+      normalizedEvent = "REFUND_PROCESSED";
+    } else if (rawEvent?.includes("dispute")) {
+      normalizedEvent = "DISPUTE_CREATED";
+    }
+    const obj = parsed?.data?.object;
+    const orderId = obj?.client_reference_id || obj?.metadata?.order_id || obj?.id;
+    const paymentId = obj?.payment_intent || obj?.id;
+    const amount = obj?.amount_total ? obj.amount_total / 100 : obj?.amount ? obj.amount / 100 : void 0;
+    const currency = obj?.currency ? obj.currency.toUpperCase() : void 0;
     return {
       isValid,
+      normalizedEvent,
+      rawEvent,
       gateway: "stripe",
-      event: parsed?.type,
-      data: parsed?.data?.object
+      orderId,
+      paymentId,
+      amount,
+      currency,
+      data: obj
     };
   }
 };
@@ -824,8 +927,9 @@ var CODAdapter = class extends BasePaymentAdapter {
   async verifyWebhook(_options) {
     return {
       isValid: true,
+      normalizedEvent: "PAYMENT_SUCCESS",
+      rawEvent: "COD_ORDER",
       gateway: "cod",
-      event: "COD_ORDER",
       data: {}
     };
   }
@@ -956,6 +1060,60 @@ var PaymentManager = class {
     const adapter = this.getAdapter(options.gateway);
     return adapter.verifyWebhook(options);
   }
+  /**
+   * Ready-made Next.js 13/14/15 App Router Route Handler Webhook Authenticator.
+   * Directly consumes the standard web Request object with raw stream body handling:
+   *
+   * ```typescript
+   * export async function POST(req: Request) {
+   *   const result = await payments.verifyNextJsWebhook(req, { gateway: 'razorpay' });
+   *   if (!result.isValid) return new Response('Invalid Signature', { status: 400 });
+   *   console.log('Event:', result.normalizedEvent, result.orderId);
+   *   return new Response('OK');
+   * }
+   * ```
+   */
+  async verifyNextJsWebhook(request, options) {
+    try {
+      let rawBody = "";
+      if (typeof request.text === "function") {
+        rawBody = await request.text();
+      } else if (typeof request.body === "string") {
+        rawBody = request.body;
+      } else if (Buffer.isBuffer(request.body)) {
+        rawBody = request.body.toString("utf8");
+      }
+      const headers = {};
+      if (request.headers) {
+        if (typeof request.headers.forEach === "function") {
+          request.headers.forEach((val, key) => {
+            headers[key.toLowerCase()] = val;
+          });
+        } else if (typeof request.headers.entries === "function") {
+          for (const [key, val] of request.headers.entries()) {
+            headers[key.toLowerCase()] = val;
+          }
+        } else if (typeof request.headers === "object") {
+          Object.entries(request.headers).forEach(([k, v]) => {
+            headers[k.toLowerCase()] = Array.isArray(v) ? v[0] : v;
+          });
+        }
+      }
+      return this.verifyWebhook({
+        gateway: options.gateway,
+        rawBody,
+        headers,
+        webhookSecret: options.webhookSecret
+      });
+    } catch (err) {
+      return {
+        isValid: false,
+        normalizedEvent: "UNKNOWN",
+        gateway: options.gateway,
+        error: `Failed to process Next.js webhook: ${err.message}`
+      };
+    }
+  }
 };
 function createPaymentManager(options) {
   return new PaymentManager(options);