@pandait.tech/payment-nuvei 0.1.1 → 0.2.1

package/dist/handlers/index.d.cts

@@ -1,4 +1,3 @@
-import { NextRequest, NextResponse } from 'next/server';
 import { Auth } from 'firebase-admin/auth';
 import { Firestore } from 'firebase-admin/firestore';
 
@@ -156,31 +155,7 @@ interface ChargeHandlerDeps {
  * validation, Nuvei debit call, 3DS/OTP handling, Firestore order updates, email
  * dispatch, and optional post-success side effects via `onPaymentSucceeded`.
  */
-declare function createChargeHandler(deps: ChargeHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    success: boolean;
-    transactionId: string;
-    authorizationCode: string | null;
-    orderId: string;
-    emailSent: boolean;
-}> | NextResponse<{
-    review: boolean;
-    orderId: string;
-    transactionId: string;
-}> | NextResponse<{
-    challenge: boolean;
-    challengeHtml: string;
-    isDeviceFingerprint: boolean;
-    orderId: string;
-    nuveiTransactionId: string;
-    statusDetail: number;
-}> | NextResponse<{
-    otpRequired: boolean;
-    orderId: string;
-    nuveiTransactionId: string;
-    statusDetail: number;
-}>>;
+declare function createChargeHandler(deps: ChargeHandlerDeps): (request: Request) => Promise<Response>;
 
 interface NuveiWebhookPayload {
     transaction: {
@@ -206,15 +181,15 @@ interface WebhookHandlerDeps {
     onPaymentSucceeded?: (order: MinimalOrder & {
         id: string;
     }) => Promise<void>;
-    /** Optional custom dev_reference handler. If the webhook's `transaction.dev_reference` matches a custom format (e.g. "pn_<id>" for Plan Novios), the consumer returns a NextResponse and the standard order flow is skipped. Return null to fall through to standard order processing. */
-    handleCustomDevReference?: (devReference: string, transaction: NuveiWebhookPayload["transaction"], payload: NuveiWebhookPayload) => Promise<NextResponse | null>;
+    /** Optional custom dev_reference handler. If the webhook's `transaction.dev_reference` matches a custom format (e.g. "pn_<id>" for Plan Novios), the consumer returns a Response and the standard order flow is skipped. Return null to fall through to standard order processing. */
+    handleCustomDevReference?: (devReference: string, transaction: NuveiWebhookPayload["transaction"], payload: NuveiWebhookPayload) => Promise<Response | null>;
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
 /**
  * Creates a Next.js App Router POST handler for the Nuvei webhook callback.
  * Reference: https://developers.paymentez.com/api/#webhook
  */
-declare function createWebhookHandler(deps: WebhookHandlerDeps): (request: NextRequest) => Promise<NextResponse<unknown>>;
+declare function createWebhookHandler(deps: WebhookHandlerDeps): (request: Request) => Promise<Response>;
 
 /** Dependencies the 3DS callback handler factory needs. */
 interface ThreeDSCallbackHandlerDeps {
@@ -224,15 +199,16 @@ interface ThreeDSCallbackHandlerDeps {
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
 /**
- * Creates a Next.js App Router route module for the 3DS callback endpoint.
- * Returns `{ POST, GET }` because the ACS may call either depending on bank/issuer.
+ * Creates the 3DS callback route handlers. Returns `{ POST, GET }` because the
+ * ACS may call either depending on bank/issuer.
  *
- * Usage:
- *   export const { POST, GET } = create3dsCallbackHandler({ firebase: { db } });
+ * Usage (Next.js):    export const { POST, GET } = create3dsCallbackHandler({ firebase: { db } });
+ * Usage (Functions):  const { POST } = create3dsCallbackHandler({ firebase: { db } });
+ *                     exports.threeDSCallback = onRequest({ cors: true }, toCloudFunction(POST));
  */
 declare function create3dsCallbackHandler(deps: ThreeDSCallbackHandlerDeps): {
-    POST: (request: NextRequest) => Promise<NextResponse<unknown>>;
-    GET: (request: NextRequest) => Promise<NextResponse<unknown>>;
+    POST: (request: Request) => Promise<Response>;
+    GET: (request: Request) => Promise<Response>;
 };
 
 /** Dependencies the 3DS complete handler factory needs. */
@@ -253,23 +229,7 @@ interface ThreeDSCompleteHandlerDeps {
  * Creates a Next.js App Router POST handler for the 3DS complete endpoint.
  * Called by the client after challenge completion to finalize the payment.
  */
-declare function create3dsCompleteHandler(deps: ThreeDSCompleteHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    success: boolean;
-    transactionId: unknown;
-    authorizationCode: {} | null;
-    orderId: string;
-}> | NextResponse<{
-    stillPending: boolean;
-}> | NextResponse<{
-    challenge: boolean;
-    challengeHtml: string;
-    isDeviceFingerprint: boolean;
-    orderId: string;
-    nuveiTransactionId: {};
-    statusDetail: number;
-}>>;
+declare function create3dsCompleteHandler(deps: ThreeDSCompleteHandlerDeps): (request: Request) => Promise<Response>;
 
 /** Dependencies the 3DS timeout handler factory needs. */
 interface ThreeDSTimeoutHandlerDeps {
@@ -281,13 +241,7 @@ interface ThreeDSTimeoutHandlerDeps {
     }) => string;
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
-declare function create3dsTimeoutHandler(deps: ThreeDSTimeoutHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    alreadyResolved: boolean;
-}> | NextResponse<{
-    ok: boolean;
-}>>;
+declare function create3dsTimeoutHandler(deps: ThreeDSTimeoutHandlerDeps): (request: Request) => Promise<Response>;
 
 /** Dependencies the refund handler factory needs. */
 interface RefundHandlerDeps {
@@ -298,12 +252,7 @@ interface RefundHandlerDeps {
     }) => Promise<void>;
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
-declare function createRefundHandler(deps: RefundHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    success: boolean;
-    detail: string;
-}>>;
+declare function createRefundHandler(deps: RefundHandlerDeps): (request: Request) => Promise<Response>;
 
 /** Dependencies the init-checkout handler factory needs. */
 interface InitCheckoutHandlerDeps {
@@ -319,12 +268,7 @@ interface InitCheckoutHandlerDeps {
     };
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
-declare function createInitCheckoutHandler(deps: InitCheckoutHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    reference: string;
-    checkoutUrl: string | undefined;
-}>>;
+declare function createInitCheckoutHandler(deps: InitCheckoutHandlerDeps): (request: Request) => Promise<Response>;
 
 /** Dependencies the cards handler factory needs. */
 interface CardsHandlerDeps {
@@ -341,26 +285,8 @@ interface CardsHandlerDeps {
  *   export const { GET, DELETE } = createCardsHandler({ firebase: { db, auth } });
  */
 declare function createCardsHandler(deps: CardsHandlerDeps): {
-    GET: (request: NextRequest) => Promise<NextResponse<{
-        error: string;
-    }> | NextResponse<{
-        cards: {
-            bin: string;
-            status: string;
-            token: string;
-            holder_name: string;
-            expiry_year: string;
-            expiry_month: string;
-            transaction_reference: string;
-            type: string;
-            number: string;
-        }[];
-    }>>;
-    DELETE: (request: NextRequest) => Promise<NextResponse<{
-        error: string;
-    }> | NextResponse<{
-        message: string;
-    }>>;
+    GET: (request: Request) => Promise<Response>;
+    DELETE: (request: Request) => Promise<Response>;
 };
 
 /** Dependencies the verify handler factory needs. */
@@ -370,17 +296,7 @@ interface VerifyHandlerDeps {
     enableVerifiedCardsTracking?: boolean;
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
-declare function createVerifyHandler(deps: VerifyHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    success: boolean;
-    transaction: {
-        status: string;
-        status_detail: number;
-        id: string;
-        message: string | null;
-    } | undefined;
-}>>;
+declare function createVerifyHandler(deps: VerifyHandlerDeps): (request: Request) => Promise<Response>;
 
 /** Dependencies the test-charge handler factory needs. */
 interface TestChargeHandlerDeps {
@@ -391,23 +307,20 @@ interface TestChargeHandlerDeps {
     defaultDescription?: string;
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
-declare function createTestChargeHandler(deps: TestChargeHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    success: boolean;
-    transaction: {
-        status: string;
-        current_status: string;
-        id: string;
-        message: string | null;
-        status_detail: number;
-        authorization_code: string | null;
-    };
-    card: {
-        bin: string;
-        type: string;
-        number: string;
-    } | undefined;
-}>>;
+declare function createTestChargeHandler(deps: TestChargeHandlerDeps): (request: Request) => Promise<Response>;
+
+interface NuveiProxyHandlerDeps {
+    logger?: Pick<Console, "log" | "error" | "warn">;
+}
+/**
+ * Creates a Web-standard POST handler that forwards `{ path, method, body }` to
+ * Nuvei's REST API, attaching the caller-supplied `x-nuvei-auth-token` as the
+ * `Auth-Token` header and selecting prod/stg from `x-nuvei-env`.
+ *
+ * Usage (Next.js):   export const POST = createNuveiProxyHandler();
+ * Usage (Functions): exports.nuveiProxy = onRequest({ cors: true },
+ *                      toCloudFunction(createNuveiProxyHandler()));
+ */
+declare function createNuveiProxyHandler(deps?: NuveiProxyHandlerDeps): (request: Request) => Promise<Response>;
 
-export { type CardsHandlerDeps, type ChargeHandlerDeps, type CustomOrderValidationResult, type EmailService, type FirebaseDeps, type FirestoreData, type GetPriceDisplayFn, type InitCheckoutHandlerDeps, type MinimalOrder, type PaymentConfirmationArgs, type PaymentFailedArgs, type PaymentPendingArgs, type RateLimitFn, type RefundHandlerDeps, type TestChargeHandlerDeps, type ThreeDSCallbackHandlerDeps, type ThreeDSCompleteHandlerDeps, type ThreeDSTimeoutHandlerDeps, type TurnstileFn, type ValidateCustomOrderFn, type VerifyHandlerDeps, type WebhookHandlerDeps, create3dsCallbackHandler, create3dsCompleteHandler, create3dsTimeoutHandler, createCardsHandler, createChargeHandler, createInitCheckoutHandler, createRefundHandler, createTestChargeHandler, createVerifyHandler, createWebhookHandler };
+export { type CardsHandlerDeps, type ChargeHandlerDeps, type CustomOrderValidationResult, type EmailService, type FirebaseDeps, type FirestoreData, type GetPriceDisplayFn, type InitCheckoutHandlerDeps, type MinimalOrder, type NuveiProxyHandlerDeps, type PaymentConfirmationArgs, type PaymentFailedArgs, type PaymentPendingArgs, type RateLimitFn, type RefundHandlerDeps, type TestChargeHandlerDeps, type ThreeDSCallbackHandlerDeps, type ThreeDSCompleteHandlerDeps, type ThreeDSTimeoutHandlerDeps, type TurnstileFn, type ValidateCustomOrderFn, type VerifyHandlerDeps, type WebhookHandlerDeps, create3dsCallbackHandler, create3dsCompleteHandler, create3dsTimeoutHandler, createCardsHandler, createChargeHandler, createInitCheckoutHandler, createNuveiProxyHandler, createRefundHandler, createTestChargeHandler, createVerifyHandler, createWebhookHandler };

package/dist/handlers/index.d.ts

@@ -1,4 +1,3 @@
-import { NextRequest, NextResponse } from 'next/server';
 import { Auth } from 'firebase-admin/auth';
 import { Firestore } from 'firebase-admin/firestore';
 
@@ -156,31 +155,7 @@ interface ChargeHandlerDeps {
  * validation, Nuvei debit call, 3DS/OTP handling, Firestore order updates, email
  * dispatch, and optional post-success side effects via `onPaymentSucceeded`.
  */
-declare function createChargeHandler(deps: ChargeHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    success: boolean;
-    transactionId: string;
-    authorizationCode: string | null;
-    orderId: string;
-    emailSent: boolean;
-}> | NextResponse<{
-    review: boolean;
-    orderId: string;
-    transactionId: string;
-}> | NextResponse<{
-    challenge: boolean;
-    challengeHtml: string;
-    isDeviceFingerprint: boolean;
-    orderId: string;
-    nuveiTransactionId: string;
-    statusDetail: number;
-}> | NextResponse<{
-    otpRequired: boolean;
-    orderId: string;
-    nuveiTransactionId: string;
-    statusDetail: number;
-}>>;
+declare function createChargeHandler(deps: ChargeHandlerDeps): (request: Request) => Promise<Response>;
 
 interface NuveiWebhookPayload {
     transaction: {
@@ -206,15 +181,15 @@ interface WebhookHandlerDeps {
     onPaymentSucceeded?: (order: MinimalOrder & {
         id: string;
     }) => Promise<void>;
-    /** Optional custom dev_reference handler. If the webhook's `transaction.dev_reference` matches a custom format (e.g. "pn_<id>" for Plan Novios), the consumer returns a NextResponse and the standard order flow is skipped. Return null to fall through to standard order processing. */
-    handleCustomDevReference?: (devReference: string, transaction: NuveiWebhookPayload["transaction"], payload: NuveiWebhookPayload) => Promise<NextResponse | null>;
+    /** Optional custom dev_reference handler. If the webhook's `transaction.dev_reference` matches a custom format (e.g. "pn_<id>" for Plan Novios), the consumer returns a Response and the standard order flow is skipped. Return null to fall through to standard order processing. */
+    handleCustomDevReference?: (devReference: string, transaction: NuveiWebhookPayload["transaction"], payload: NuveiWebhookPayload) => Promise<Response | null>;
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
 /**
  * Creates a Next.js App Router POST handler for the Nuvei webhook callback.
  * Reference: https://developers.paymentez.com/api/#webhook
  */
-declare function createWebhookHandler(deps: WebhookHandlerDeps): (request: NextRequest) => Promise<NextResponse<unknown>>;
+declare function createWebhookHandler(deps: WebhookHandlerDeps): (request: Request) => Promise<Response>;
 
 /** Dependencies the 3DS callback handler factory needs. */
 interface ThreeDSCallbackHandlerDeps {
@@ -224,15 +199,16 @@ interface ThreeDSCallbackHandlerDeps {
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
 /**
- * Creates a Next.js App Router route module for the 3DS callback endpoint.
- * Returns `{ POST, GET }` because the ACS may call either depending on bank/issuer.
+ * Creates the 3DS callback route handlers. Returns `{ POST, GET }` because the
+ * ACS may call either depending on bank/issuer.
  *
- * Usage:
- *   export const { POST, GET } = create3dsCallbackHandler({ firebase: { db } });
+ * Usage (Next.js):    export const { POST, GET } = create3dsCallbackHandler({ firebase: { db } });
+ * Usage (Functions):  const { POST } = create3dsCallbackHandler({ firebase: { db } });
+ *                     exports.threeDSCallback = onRequest({ cors: true }, toCloudFunction(POST));
  */
 declare function create3dsCallbackHandler(deps: ThreeDSCallbackHandlerDeps): {
-    POST: (request: NextRequest) => Promise<NextResponse<unknown>>;
-    GET: (request: NextRequest) => Promise<NextResponse<unknown>>;
+    POST: (request: Request) => Promise<Response>;
+    GET: (request: Request) => Promise<Response>;
 };
 
 /** Dependencies the 3DS complete handler factory needs. */
@@ -253,23 +229,7 @@ interface ThreeDSCompleteHandlerDeps {
  * Creates a Next.js App Router POST handler for the 3DS complete endpoint.
  * Called by the client after challenge completion to finalize the payment.
  */
-declare function create3dsCompleteHandler(deps: ThreeDSCompleteHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    success: boolean;
-    transactionId: unknown;
-    authorizationCode: {} | null;
-    orderId: string;
-}> | NextResponse<{
-    stillPending: boolean;
-}> | NextResponse<{
-    challenge: boolean;
-    challengeHtml: string;
-    isDeviceFingerprint: boolean;
-    orderId: string;
-    nuveiTransactionId: {};
-    statusDetail: number;
-}>>;
+declare function create3dsCompleteHandler(deps: ThreeDSCompleteHandlerDeps): (request: Request) => Promise<Response>;
 
 /** Dependencies the 3DS timeout handler factory needs. */
 interface ThreeDSTimeoutHandlerDeps {
@@ -281,13 +241,7 @@ interface ThreeDSTimeoutHandlerDeps {
     }) => string;
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
-declare function create3dsTimeoutHandler(deps: ThreeDSTimeoutHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    alreadyResolved: boolean;
-}> | NextResponse<{
-    ok: boolean;
-}>>;
+declare function create3dsTimeoutHandler(deps: ThreeDSTimeoutHandlerDeps): (request: Request) => Promise<Response>;
 
 /** Dependencies the refund handler factory needs. */
 interface RefundHandlerDeps {
@@ -298,12 +252,7 @@ interface RefundHandlerDeps {
     }) => Promise<void>;
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
-declare function createRefundHandler(deps: RefundHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    success: boolean;
-    detail: string;
-}>>;
+declare function createRefundHandler(deps: RefundHandlerDeps): (request: Request) => Promise<Response>;
 
 /** Dependencies the init-checkout handler factory needs. */
 interface InitCheckoutHandlerDeps {
@@ -319,12 +268,7 @@ interface InitCheckoutHandlerDeps {
     };
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
-declare function createInitCheckoutHandler(deps: InitCheckoutHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    reference: string;
-    checkoutUrl: string | undefined;
-}>>;
+declare function createInitCheckoutHandler(deps: InitCheckoutHandlerDeps): (request: Request) => Promise<Response>;
 
 /** Dependencies the cards handler factory needs. */
 interface CardsHandlerDeps {
@@ -341,26 +285,8 @@ interface CardsHandlerDeps {
  *   export const { GET, DELETE } = createCardsHandler({ firebase: { db, auth } });
  */
 declare function createCardsHandler(deps: CardsHandlerDeps): {
-    GET: (request: NextRequest) => Promise<NextResponse<{
-        error: string;
-    }> | NextResponse<{
-        cards: {
-            bin: string;
-            status: string;
-            token: string;
-            holder_name: string;
-            expiry_year: string;
-            expiry_month: string;
-            transaction_reference: string;
-            type: string;
-            number: string;
-        }[];
-    }>>;
-    DELETE: (request: NextRequest) => Promise<NextResponse<{
-        error: string;
-    }> | NextResponse<{
-        message: string;
-    }>>;
+    GET: (request: Request) => Promise<Response>;
+    DELETE: (request: Request) => Promise<Response>;
 };
 
 /** Dependencies the verify handler factory needs. */
@@ -370,17 +296,7 @@ interface VerifyHandlerDeps {
     enableVerifiedCardsTracking?: boolean;
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
-declare function createVerifyHandler(deps: VerifyHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    success: boolean;
-    transaction: {
-        status: string;
-        status_detail: number;
-        id: string;
-        message: string | null;
-    } | undefined;
-}>>;
+declare function createVerifyHandler(deps: VerifyHandlerDeps): (request: Request) => Promise<Response>;
 
 /** Dependencies the test-charge handler factory needs. */
 interface TestChargeHandlerDeps {
@@ -391,23 +307,20 @@ interface TestChargeHandlerDeps {
     defaultDescription?: string;
     logger?: Pick<Console, "log" | "error" | "warn">;
 }
-declare function createTestChargeHandler(deps: TestChargeHandlerDeps): (request: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    success: boolean;
-    transaction: {
-        status: string;
-        current_status: string;
-        id: string;
-        message: string | null;
-        status_detail: number;
-        authorization_code: string | null;
-    };
-    card: {
-        bin: string;
-        type: string;
-        number: string;
-    } | undefined;
-}>>;
+declare function createTestChargeHandler(deps: TestChargeHandlerDeps): (request: Request) => Promise<Response>;
+
+interface NuveiProxyHandlerDeps {
+    logger?: Pick<Console, "log" | "error" | "warn">;
+}
+/**
+ * Creates a Web-standard POST handler that forwards `{ path, method, body }` to
+ * Nuvei's REST API, attaching the caller-supplied `x-nuvei-auth-token` as the
+ * `Auth-Token` header and selecting prod/stg from `x-nuvei-env`.
+ *
+ * Usage (Next.js):   export const POST = createNuveiProxyHandler();
+ * Usage (Functions): exports.nuveiProxy = onRequest({ cors: true },
+ *                      toCloudFunction(createNuveiProxyHandler()));
+ */
+declare function createNuveiProxyHandler(deps?: NuveiProxyHandlerDeps): (request: Request) => Promise<Response>;
 
-export { type CardsHandlerDeps, type ChargeHandlerDeps, type CustomOrderValidationResult, type EmailService, type FirebaseDeps, type FirestoreData, type GetPriceDisplayFn, type InitCheckoutHandlerDeps, type MinimalOrder, type PaymentConfirmationArgs, type PaymentFailedArgs, type PaymentPendingArgs, type RateLimitFn, type RefundHandlerDeps, type TestChargeHandlerDeps, type ThreeDSCallbackHandlerDeps, type ThreeDSCompleteHandlerDeps, type ThreeDSTimeoutHandlerDeps, type TurnstileFn, type ValidateCustomOrderFn, type VerifyHandlerDeps, type WebhookHandlerDeps, create3dsCallbackHandler, create3dsCompleteHandler, create3dsTimeoutHandler, createCardsHandler, createChargeHandler, createInitCheckoutHandler, createRefundHandler, createTestChargeHandler, createVerifyHandler, createWebhookHandler };
+export { type CardsHandlerDeps, type ChargeHandlerDeps, type CustomOrderValidationResult, type EmailService, type FirebaseDeps, type FirestoreData, type GetPriceDisplayFn, type InitCheckoutHandlerDeps, type MinimalOrder, type NuveiProxyHandlerDeps, type PaymentConfirmationArgs, type PaymentFailedArgs, type PaymentPendingArgs, type RateLimitFn, type RefundHandlerDeps, type TestChargeHandlerDeps, type ThreeDSCallbackHandlerDeps, type ThreeDSCompleteHandlerDeps, type ThreeDSTimeoutHandlerDeps, type TurnstileFn, type ValidateCustomOrderFn, type VerifyHandlerDeps, type WebhookHandlerDeps, create3dsCallbackHandler, create3dsCompleteHandler, create3dsTimeoutHandler, createCardsHandler, createChargeHandler, createInitCheckoutHandler, createNuveiProxyHandler, createRefundHandler, createTestChargeHandler, createVerifyHandler, createWebhookHandler };