@misterhomer1992/miit-bot-payment 1.1.7 → 2.0.4

package/dist/modules/payments/wayforpay.service.js

@@ -0,0 +1,217 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WayForPayService = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const moment_1 = __importDefault(require("moment"));
+const wayforpay_api_1 = require("@misterhomer1992/wayforpay-api");
+const utils_1 = require("../../utils");
+const utils_2 = require("./utils");
+const SIGNATURE_DELIMITER = ';';
+/**
+ * WayForPayService provides integration with the WayForPay payment provider.
+ * Supports both subscription (regular) and one-time payment flows.
+ */
+class WayForPayService {
+    constructor({ logger, merchantAccount, merchantSecretKey, merchantDomainName, serviceUrl, }) {
+        this.logger = logger;
+        this.merchantAccount = merchantAccount || process.env.WAYFORPAY_MERCHANT_ACCOUNT;
+        this.merchantSecretKey = merchantSecretKey || process.env.WAYFORPAY_MERCHANT_SECRET_KEY;
+        this.merchantDomainName = merchantDomainName || process.env.WAYFORPAY_MERCHANT_DOMAIN;
+        this.serviceUrl = serviceUrl || process.env.WAYFORPAY_SERVICE_URL;
+    }
+    /**
+     * Generates a payment URL for subscription (regular) payments.
+     */
+    async generateSubscriptionPaymentUrl(params) {
+        const { userId, platform, planId, productName, productPrice, currency, regularCount = 3, regularMode = 'daily', language = 'UA', dateNext, } = params;
+        try {
+            const orderDate = Date.now();
+            const formattedUtc = moment_1.default.utc().toISOString();
+            const orderReference = (0, utils_2.createSubscriptionOrderReference)({
+                userId,
+                platform,
+                planId,
+                utcDate: formattedUtc,
+            });
+            const response = (await (0, wayforpay_api_1.generateRegularPurchase)({
+                merchantAccount: this.merchantAccount,
+                merchantDomainName: this.merchantDomainName,
+                merchantSecretKey: this.merchantSecretKey,
+                orderDate,
+                orderReference,
+                productName: [productName],
+                productPrice: [productPrice],
+                currency: currency,
+                language: language,
+                serviceUrl: this.serviceUrl,
+                regularMode,
+                regularCount,
+                dateNext,
+            }));
+            if (!(0, utils_1.isObject)(response) || (0, utils_1.isBadOrEmptyString)(response.url)) {
+                this.logger.error({
+                    message: 'Invalid response from WayForPay generateRegularPurchase',
+                    payload: {
+                        orderReference,
+                        response: JSON.stringify(response),
+                    },
+                });
+                return null;
+            }
+            return {
+                url: response.url,
+                orderReference,
+            };
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in WayForPayService generateSubscriptionPaymentUrl',
+                payload: {
+                    userId,
+                    platform,
+                    planId,
+                    productName,
+                    productPrice,
+                    currency,
+                    error: JSON.stringify(error),
+                },
+            });
+            return null;
+        }
+    }
+    /**
+     * Generates a payment URL for one-time payments.
+     */
+    async generateOneTimePaymentUrl(params) {
+        const { userId, platform, productId, productName, productPrice, currency, language = 'UA', returnUrl } = params;
+        try {
+            const orderDate = Date.now();
+            const formattedUtc = moment_1.default.utc().toISOString();
+            const orderReference = (0, utils_2.createSubscriptionOrderReference)({
+                userId,
+                platform,
+                planId: productId,
+                utcDate: formattedUtc,
+            });
+            const response = (await (0, wayforpay_api_1.generatePurchase)({
+                merchantAccount: this.merchantAccount,
+                merchantDomainName: this.merchantDomainName,
+                merchantSecretKey: this.merchantSecretKey,
+                orderDate,
+                orderReference,
+                productName: [productName],
+                productPrice: [productPrice],
+                currency: currency,
+                language: language,
+                serviceUrl: this.serviceUrl,
+                returnUrl,
+            }));
+            if (!(0, utils_1.isObject)(response) || (0, utils_1.isBadOrEmptyString)(response.url)) {
+                this.logger.error({
+                    message: 'Invalid response from WayForPay generatePurchase',
+                    payload: {
+                        orderReference,
+                        response: JSON.stringify(response),
+                    },
+                });
+                return null;
+            }
+            return {
+                url: response.url,
+                orderReference,
+            };
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in WayForPayService generateOneTimePaymentUrl',
+                payload: {
+                    userId,
+                    platform,
+                    productId,
+                    productName,
+                    productPrice,
+                    currency,
+                    error: JSON.stringify(error),
+                },
+            });
+            return null;
+        }
+    }
+    /**
+     * Verifies the signature of a WayForPay webhook callback.
+     * The signature is calculated as HMAC_MD5 of concatenated values.
+     */
+    verifyCallbackSignature(callbackData) {
+        try {
+            const { merchantAccount, orderReference, amount, currency, authCode, cardPan, transactionStatus, reasonCode, merchantSignature, } = callbackData;
+            if (!merchantSignature) {
+                return {
+                    isValid: false,
+                    error: 'Missing merchant signature in callback data',
+                };
+            }
+            // WayForPay signature is calculated from these fields in this exact order
+            const signatureData = [
+                merchantAccount,
+                orderReference,
+                amount,
+                currency,
+                authCode,
+                cardPan,
+                transactionStatus,
+                reasonCode,
+            ];
+            const signatureString = signatureData.join(SIGNATURE_DELIMITER);
+            const calculatedSignature = crypto_1.default
+                .createHmac('md5', this.merchantSecretKey)
+                .update(signatureString)
+                .digest('hex');
+            const isValid = calculatedSignature.toLowerCase() === merchantSignature.toLowerCase();
+            if (!isValid) {
+                this.logger.warning({
+                    message: 'WayForPay signature verification failed',
+                    payload: {
+                        orderReference,
+                        expectedSignature: calculatedSignature,
+                        receivedSignature: merchantSignature,
+                    },
+                });
+            }
+            return { isValid };
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in WayForPayService verifyCallbackSignature',
+                payload: {
+                    orderReference: callbackData?.orderReference,
+                    error: JSON.stringify(error),
+                },
+            });
+            return {
+                isValid: false,
+                error: 'Error verifying signature',
+            };
+        }
+    }
+    /**
+     * Builds a response to send back to WayForPay after processing a webhook.
+     * WayForPay expects a signed response to confirm receipt.
+     */
+    buildWebhookResponse(orderReference, status) {
+        const time = Date.now();
+        const signatureData = [orderReference, status, time];
+        const signatureString = signatureData.join(SIGNATURE_DELIMITER);
+        const signature = crypto_1.default.createHmac('md5', this.merchantSecretKey).update(signatureString).digest('hex');
+        return {
+            orderReference,
+            status,
+            time,
+            signature,
+        };
+    }
+}
+exports.WayForPayService = WayForPayService;
+//# sourceMappingURL=wayforpay.service.js.map

package/dist/modules/payments/wayforpay.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wayforpay.service.js","sourceRoot":"","sources":["../../../src/modules/payments/wayforpay.service.ts"],"names":[],"mappings":"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"}

package/dist/modules/payments/wayforpay.types.d.ts

@@ -0,0 +1,115 @@
+import { Currency, ResponseReasonCode, ResponseTransactionStatus } from '@misterhomer1992/wayforpay-api';
+/**
+ * WayForPay webhook callback data structure.
+ * This is the data received from WayForPay when a payment status changes.
+ */
+type WayForPayCallbackData = {
+    merchantAccount: string;
+    orderReference: string;
+    merchantSignature: string;
+    amount: number;
+    currency: Currency;
+    authCode: string;
+    email: string;
+    phone: string;
+    createdDate: number;
+    processingDate: number;
+    cardPan: string;
+    cardType: string;
+    issuerBankCountry: string;
+    issuerBankName: string;
+    recToken: string;
+    transactionStatus: ResponseTransactionStatus;
+    reason: string;
+    reasonCode: ResponseReasonCode;
+    fee: number;
+    paymentSystem: string;
+    /** Regular payment specific fields */
+    regularOn?: string;
+    dateBegin?: string;
+    dateEnd?: string;
+};
+/**
+ * Parameters for generating a subscription (regular) payment URL.
+ */
+type GenerateSubscriptionPaymentParams = {
+    userId: string;
+    platform: string;
+    planId: string;
+    productName: string;
+    productPrice: number;
+    currency: Currency;
+    regularCount?: number;
+    regularMode?: 'daily' | 'weekly' | 'monthly' | 'yearly';
+    language?: 'EN' | 'UA';
+    dateNext?: string;
+};
+/**
+ * Parameters for generating a one-time payment URL.
+ */
+type GenerateOneTimePaymentParams = {
+    userId: string;
+    platform: string;
+    productId: string;
+    productName: string;
+    productPrice: number;
+    currency: Currency;
+    language?: 'EN' | 'UA';
+    returnUrl?: string;
+};
+/**
+ * Result of payment URL generation.
+ */
+type PaymentUrlResult = {
+    url: string;
+    orderReference: string;
+};
+/**
+ * Result of signature verification.
+ */
+type SignatureVerificationResult = {
+    isValid: boolean;
+    error?: string;
+};
+/**
+ * Response to send back to WayForPay after processing a webhook.
+ */
+type WayForPayWebhookResponse = {
+    orderReference: string;
+    status: 'accept' | 'decline';
+    time: number;
+    signature: string;
+};
+/**
+ * Interface for WayForPay service operations.
+ * Provides methods for payment URL generation and signature verification.
+ */
+interface IWayForPayService {
+    /**
+     * Generates a payment URL for subscription (regular) payments.
+     * @param params - Payment parameters
+     * @returns Promise resolving to payment URL and order reference
+     */
+    generateSubscriptionPaymentUrl(params: GenerateSubscriptionPaymentParams): Promise<PaymentUrlResult | null>;
+    /**
+     * Generates a payment URL for one-time payments.
+     * @param params - Payment parameters
+     * @returns Promise resolving to payment URL and order reference
+     */
+    generateOneTimePaymentUrl(params: GenerateOneTimePaymentParams): Promise<PaymentUrlResult | null>;
+    /**
+     * Verifies the signature of a WayForPay webhook callback.
+     * @param callbackData - The callback data received from WayForPay
+     * @returns Verification result indicating if signature is valid
+     */
+    verifyCallbackSignature(callbackData: WayForPayCallbackData): SignatureVerificationResult;
+    /**
+     * Builds a response to send back to WayForPay after processing a webhook.
+     * @param orderReference - The order reference from the callback
+     * @param status - Whether to accept or decline the transaction
+     * @returns Response object to send to WayForPay
+     */
+    buildWebhookResponse(orderReference: string, status: 'accept' | 'decline'): WayForPayWebhookResponse;
+}
+export type { WayForPayCallbackData, GenerateSubscriptionPaymentParams, GenerateOneTimePaymentParams, PaymentUrlResult, SignatureVerificationResult, WayForPayWebhookResponse, IWayForPayService, };
+//# sourceMappingURL=wayforpay.types.d.ts.map

package/dist/modules/payments/wayforpay.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wayforpay.types.d.ts","sourceRoot":"","sources":["../../../src/modules/payments/wayforpay.types.ts"],"names":[],"mappings":"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"}

package/dist/modules/payments/wayforpay.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=wayforpay.types.js.map

package/dist/modules/payments/wayforpay.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wayforpay.types.js","sourceRoot":"","sources":["../../../src/modules/payments/wayforpay.types.ts"],"names":[],"mappings":""}

package/dist/modules/payments/webhook.handler.d.ts

@@ -0,0 +1,98 @@
+import { Logger } from '../logger/types';
+import type { WayForPayCallbackData } from './wayforpay.types';
+import type { IWebhookHandlerService, WebhookProcessingResult } from './webhook.types';
+import type { TokenPackPlan } from '../token/types';
+/**
+ * Request object interface for webhook handling.
+ * Compatible with Express.js and similar frameworks.
+ */
+interface WebhookRequest {
+    body: unknown;
+}
+/**
+ * Response object interface for webhook handling.
+ * Compatible with Express.js and similar frameworks.
+ */
+interface WebhookResponse {
+    status(code: number): WebhookResponse;
+    json(data: unknown): void;
+}
+/**
+ * Configuration options for the webhook handler.
+ */
+interface WebhookHandlerConfig {
+    logger: Logger;
+    webhookService?: IWebhookHandlerService;
+    tokenPackPlans?: TokenPackPlan[];
+}
+/**
+ * WebhookHandler provides HTTP request handling for WayForPay payment callbacks.
+ * It validates incoming requests and delegates processing to the WebhookHandlerService.
+ *
+ * Usage with Express:
+ * ```typescript
+ * const handler = new WebhookHandler({ logger });
+ * app.post('/webhook/wayforpay', (req, res) => handler.handleRequest(req, res));
+ * ```
+ *
+ * Usage with Cloud Functions:
+ * ```typescript
+ * const handler = new WebhookHandler({ logger });
+ * export const webhookFunction = (req, res) => handler.handleRequest(req, res);
+ * ```
+ */
+export declare class WebhookHandler {
+    private readonly logger;
+    private readonly webhookService;
+    constructor(config: WebhookHandlerConfig);
+    /**
+     * Handles an incoming HTTP request from WayForPay.
+     * Validates the request body, processes the payment callback,
+     * and returns the appropriate response.
+     *
+     * @param req - The HTTP request object
+     * @param res - The HTTP response object
+     */
+    handleRequest(req: WebhookRequest, res: WebhookResponse): Promise<void>;
+    /**
+     * Processes callback data directly without HTTP request parsing.
+     * Useful for testing or when data is already parsed.
+     *
+     * @param callbackData - The parsed callback data from WayForPay
+     * @returns Processing result with response to send back to WayForPay
+     */
+    processCallback(callbackData: WayForPayCallbackData): Promise<WebhookProcessingResult>;
+    /**
+     * Parses and validates the webhook request body.
+     */
+    private parseRequestBody;
+    /**
+     * Sends the response back to WayForPay.
+     * WayForPay expects a 200 status with a signed response body.
+     */
+    private sendResponse;
+}
+/**
+ * Creates a webhook handler function for use with serverless platforms.
+ * Returns a function that can be directly used as a Cloud Function or Lambda handler.
+ *
+ * @param config - Configuration options for the webhook handler
+ * @returns An async function that handles webhook requests
+ *
+ * @example
+ * ```typescript
+ * // Firebase Cloud Functions
+ * import * as functions from 'firebase-functions';
+ * import { createWebhookHandler } from 'miit-bot-payment';
+ *
+ * const logger = { info: console.log, warning: console.warn, error: console.error };
+ * export const paymentWebhook = functions.https.onRequest(createWebhookHandler({ logger }));
+ * ```
+ */
+export declare function createWebhookHandler(config: WebhookHandlerConfig): (req: WebhookRequest, res: WebhookResponse) => Promise<void>;
+/**
+ * Type export for the webhook handler function signature.
+ */
+export type WebhookHandlerFunction = (req: WebhookRequest, res: WebhookResponse) => Promise<void>;
+export type { WebhookRequest, WebhookResponse, WebhookHandlerConfig };
+//# sourceMappingURL=webhook.handler.d.ts.map

package/dist/modules/payments/webhook.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.handler.d.ts","sourceRoot":"","sources":["../../../src/modules/payments/webhook.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;GAGG;AACH,UAAU,cAAc;IACpB,IAAI,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,UAAU,eAAe;IACrB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,UAAU,oBAAoB;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CACpC;AAWD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;gBAE5C,MAAM,EAAE,oBAAoB;IAUxC;;;;;;;OAOG;IACU,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BpF;;;;;;OAMG;IACU,eAAe,CAAC,YAAY,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAInG;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8CxB;;;OAGG;IACH,OAAO,CAAC,YAAY;CAcvB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,oBAAoB,GAC7B,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAG9D;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAElG,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/modules/payments/webhook.handler.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookHandler = void 0;
+exports.createWebhookHandler = createWebhookHandler;
+const webhook_service_1 = require("./webhook.service");
+/**
+ * WebhookHandler provides HTTP request handling for WayForPay payment callbacks.
+ * It validates incoming requests and delegates processing to the WebhookHandlerService.
+ *
+ * Usage with Express:
+ * ```typescript
+ * const handler = new WebhookHandler({ logger });
+ * app.post('/webhook/wayforpay', (req, res) => handler.handleRequest(req, res));
+ * ```
+ *
+ * Usage with Cloud Functions:
+ * ```typescript
+ * const handler = new WebhookHandler({ logger });
+ * export const webhookFunction = (req, res) => handler.handleRequest(req, res);
+ * ```
+ */
+class WebhookHandler {
+    constructor(config) {
+        this.logger = config.logger;
+        this.webhookService =
+            config.webhookService ||
+                new webhook_service_1.WebhookHandlerService({
+                    logger: config.logger,
+                    tokenPackPlans: config.tokenPackPlans,
+                });
+    }
+    /**
+     * Handles an incoming HTTP request from WayForPay.
+     * Validates the request body, processes the payment callback,
+     * and returns the appropriate response.
+     *
+     * @param req - The HTTP request object
+     * @param res - The HTTP response object
+     */
+    async handleRequest(req, res) {
+        this.logger.info({
+            message: 'Received WayForPay webhook request',
+            payload: {},
+        });
+        // Parse and validate the request body
+        const parseResult = this.parseRequestBody(req.body);
+        if (!parseResult.success || !parseResult.data) {
+            this.logger.warning({
+                message: 'Invalid webhook request body',
+                payload: { error: parseResult.error },
+            });
+            res.status(400).json({
+                error: parseResult.error || 'Invalid request body',
+            });
+            return;
+        }
+        const callbackData = parseResult.data;
+        // Process the webhook
+        const result = await this.webhookService.processPaymentWebhook(callbackData);
+        // Return the response to WayForPay
+        this.sendResponse(res, result);
+    }
+    /**
+     * Processes callback data directly without HTTP request parsing.
+     * Useful for testing or when data is already parsed.
+     *
+     * @param callbackData - The parsed callback data from WayForPay
+     * @returns Processing result with response to send back to WayForPay
+     */
+    async processCallback(callbackData) {
+        return this.webhookService.processPaymentWebhook(callbackData);
+    }
+    /**
+     * Parses and validates the webhook request body.
+     */
+    parseRequestBody(body) {
+        if (!body || typeof body !== 'object') {
+            return {
+                success: false,
+                error: 'Request body must be a JSON object',
+            };
+        }
+        const data = body;
+        // Validate required fields
+        const requiredFields = [
+            'merchantAccount',
+            'orderReference',
+            'merchantSignature',
+            'amount',
+            'currency',
+            'transactionStatus',
+        ];
+        const missingFields = requiredFields.filter((field) => data[field] === undefined || data[field] === null);
+        if (missingFields.length > 0) {
+            return {
+                success: false,
+                error: `Missing required fields: ${missingFields.join(', ')}`,
+            };
+        }
+        // Validate transaction status
+        const validStatuses = ['Approved', 'Declined', 'Expired', 'Pending', 'InProcessing', 'Refunded'];
+        if (!validStatuses.includes(data.transactionStatus)) {
+            return {
+                success: false,
+                error: `Invalid transaction status: ${data.transactionStatus}`,
+            };
+        }
+        return {
+            success: true,
+            data: data,
+        };
+    }
+    /**
+     * Sends the response back to WayForPay.
+     * WayForPay expects a 200 status with a signed response body.
+     */
+    sendResponse(res, result) {
+        // WayForPay expects a 200 status code even for declined transactions
+        // The accept/decline status is communicated in the response body
+        res.status(200).json(result.response);
+        this.logger.info({
+            message: 'Webhook response sent',
+            payload: {
+                success: result.success,
+                status: result.response.status,
+                orderReference: result.response.orderReference,
+            },
+        });
+    }
+}
+exports.WebhookHandler = WebhookHandler;
+/**
+ * Creates a webhook handler function for use with serverless platforms.
+ * Returns a function that can be directly used as a Cloud Function or Lambda handler.
+ *
+ * @param config - Configuration options for the webhook handler
+ * @returns An async function that handles webhook requests
+ *
+ * @example
+ * ```typescript
+ * // Firebase Cloud Functions
+ * import * as functions from 'firebase-functions';
+ * import { createWebhookHandler } from 'miit-bot-payment';
+ *
+ * const logger = { info: console.log, warning: console.warn, error: console.error };
+ * export const paymentWebhook = functions.https.onRequest(createWebhookHandler({ logger }));
+ * ```
+ */
+function createWebhookHandler(config) {
+    const handler = new WebhookHandler(config);
+    return (req, res) => handler.handleRequest(req, res);
+}
+//# sourceMappingURL=webhook.handler.js.map

package/dist/modules/payments/webhook.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.handler.js","sourceRoot":"","sources":["../../../src/modules/payments/webhook.handler.ts"],"names":[],"mappings":"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"}