@misterhomer1992/miit-bot-payment 1.1.6 → 2.0.4

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

@@ -1,4 +1,5 @@
 import { NestedPathsAccess } from '../../types/utilities';
+type PaymentType = 'subscription' | 'token_pack' | 'subscription_upgrade';
 type PaymentEntity = {
     /** Auto-generated unique ID (document ID) */
     id?: string;
@@ -10,8 +11,10 @@ type PaymentEntity = {
     status: 'pending' | 'completed' | 'failed' | 'expired';
     /** The URL from Wayforpay that is sent to the user */
     paymentLink: string;
-    /** The plan the user is attempting to purchase */
+    /** The plan or pack ID the user is attempting to purchase */
     planId: string;
+    /** The type of payment (subscription or token_pack) */
+    paymentType: PaymentType;
     /** The amount to be charged */
     amount: number;
     /** Currency of the payment */
@@ -64,6 +67,13 @@ interface IPaymentRepository {
         hoursOld?: number;
     }): Promise<PaymentEntity[]>;
 }
+/**
+ * Result of signature validation.
+ */
+type SignatureValidationResult = {
+    isValid: boolean;
+    error?: string;
+};
 /**
  * Interface for payment service operations.
  * Defines the contract for business logic layer.
@@ -91,9 +101,18 @@ interface IPaymentService {
      * @returns Promise resolving to created PaymentEntity with ID
      */
     create(paymentData: Omit<PaymentEntity, 'id'>): Promise<PaymentEntity>;
+    /**
+     * Updates the status of a payment.
+     * @param params - Update parameters containing id and new status
+     */
+    updateStatus(params: {
+        id: string;
+        status: PaymentEntity['status'];
+    }): Promise<void>;
     /**
      * Updates specific fields of a payment.
      * @param params - Update parameters
+     * @deprecated Use updateStatus instead for status changes
      */
     changeStatus(params: {
         id: string;
@@ -123,6 +142,54 @@ interface IPaymentService {
         regularMode?: 'daily' | 'weekly' | 'monthly' | 'yearly';
         language?: string;
     }): Promise<PaymentEntity>;
+    /**
+     * Creates a payment intent for a token pack purchase.
+     * @param params - Payment intent parameters
+     * @returns Promise resolving to the created PaymentEntity with payment link
+     */
+    createTokenPackPaymentIntent(params: {
+        userId: string;
+        platform: string;
+        packId: string;
+        productName: string;
+        productPrice: number;
+        currency: 'UAH' | 'USD';
+        language?: string;
+        returnUrl?: string;
+    }): Promise<PaymentEntity>;
+    /**
+     * Validates the signature of payment callback data.
+     * @param callbackData - The callback data from the payment provider
+     * @returns Validation result indicating if signature is valid
+     */
+    validateSignature(callbackData: {
+        merchantAccount: string;
+        orderReference: string;
+        amount: number;
+        currency: string;
+        authCode: string;
+        cardPan: string;
+        transactionStatus: string;
+        reasonCode: string | number;
+        merchantSignature: string;
+    }): SignatureValidationResult;
+    /**
+     * Creates a payment intent for a subscription upgrade.
+     * @param params - Payment intent parameters
+     * @returns Promise resolving to the created PaymentEntity with payment link
+     */
+    createUpgradePaymentIntent(params: {
+        userId: string;
+        platform: string;
+        currentPlanId: string;
+        newPlanId: string;
+        productName: string;
+        upgradeCost: number;
+        currency: 'UAH' | 'USD';
+        regularMode?: 'daily' | 'monthly' | 'yearly';
+        regularCount?: number;
+        language?: string;
+    }): Promise<PaymentEntity>;
 }
-export type { PaymentEntity, PaymentFieldPath, IPaymentRepository, IPaymentService };
+export type { PaymentEntity, PaymentType, PaymentFieldPath, IPaymentRepository, IPaymentService, SignatureValidationResult };
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/modules/payments/utils.d.ts

@@ -1,10 +1,69 @@
-declare function createOrderReference({ userId, platform, planId, utcDate, }: {
+/**
+ * Payment type for order references
+ */
+type OrderReferencePaymentType = 'sub' | 'tkn' | 'upg';
+/**
+ * Parameters for creating a subscription order reference
+ */
+interface CreateSubscriptionOrderReferenceParams {
     userId: string;
     platform: string;
     planId: string;
     utcDate: string;
-}): string;
-export interface ParsedReferenceString {
+}
+/**
+ * Parameters for creating a token pack order reference
+ */
+interface CreateTokenPackOrderReferenceParams {
+    userId: string;
+    platform: string;
+    packId: string;
+    utcDate: string;
+}
+/**
+ * Parameters for creating an upgrade order reference
+ */
+interface CreateUpgradeOrderReferenceParams {
+    userId: string;
+    platform: string;
+    currentPlanId: string;
+    newPlanId: string;
+    utcDate: string;
+}
+/**
+ * Parsed upgrade order reference
+ */
+interface ParsedUpgradeOrderReference {
+    appName: string;
+    platform: string;
+    serviceType: string;
+    userId: string;
+    paymentType: 'upg';
+    currentPlanId: string;
+    newPlanId: string;
+    version: string;
+    timestamp: string;
+}
+/**
+ * Parsed order reference with payment type discrimination
+ */
+interface ParsedOrderReference {
+    appName: string;
+    platform: string;
+    serviceType: string;
+    userId: string;
+    /** Payment type: 'sub' for subscription, 'tkn' for token pack */
+    paymentType: OrderReferencePaymentType;
+    /** Plan ID for subscriptions, Pack ID for token packs */
+    itemId: string;
+    version: string;
+    timestamp: string;
+    chargeId?: string;
+}
+/**
+ * Legacy parsed reference string (backward compatibility)
+ */
+interface ParsedReferenceString {
     appName: string;
     platform: string;
     serviceType: string;
@@ -14,6 +73,93 @@ export interface ParsedReferenceString {
     timestamp: string;
     chargeId?: string;
 }
-declare function parseOrderReference(referenceString: string): ParsedReferenceString | null;
-export { createOrderReference, parseOrderReference };
+declare const ORDER_REFERENCE_VERSION = "v2";
+declare const ORDER_REFERENCE_APP_NAME = "miia";
+declare const ORDER_REFERENCE_SERVICE_TYPE = "bot";
+/**
+ * Creates a unique order reference for subscription payments.
+ * Format: miia_{platform}_bot_{userId}_sub_{planId}_v2_{utcDate}
+ *
+ * @param params - Parameters for generating the order reference
+ * @returns A unique order reference string
+ */
+declare function createSubscriptionOrderReference({ userId, platform, planId, utcDate, }: CreateSubscriptionOrderReferenceParams): string;
+/**
+ * Creates a unique order reference for token pack payments.
+ * Format: miia_{platform}_bot_{userId}_tkn_{packId}_v2_{utcDate}
+ *
+ * @param params - Parameters for generating the order reference
+ * @returns A unique order reference string
+ */
+declare function createTokenPackOrderReference({ userId, platform, packId, utcDate, }: CreateTokenPackOrderReferenceParams): string;
+/**
+ * Creates a unique order reference for subscription upgrade payments.
+ * Format: miia_{platform}_bot_{userId}_upg_{currentPlanId}_to_{newPlanId}_v2_{utcDate}
+ *
+ * @param params - Parameters for generating the order reference
+ * @returns A unique order reference string
+ */
+declare function createUpgradeOrderReference({ userId, platform, currentPlanId, newPlanId, utcDate, }: CreateUpgradeOrderReferenceParams): string;
+/**
+ * Checks if an order reference is for a subscription payment.
+ *
+ * @param orderReference - The order reference string to check
+ * @returns True if the order reference is for a subscription
+ */
+declare function isSubscriptionOrderReference(orderReference: string): boolean;
+/**
+ * Checks if an order reference is for a token pack payment.
+ *
+ * @param orderReference - The order reference string to check
+ * @returns True if the order reference is for a token pack
+ */
+declare function isTokenPackOrderReference(orderReference: string): boolean;
+/**
+ * Checks if an order reference is for a subscription upgrade payment.
+ *
+ * @param orderReference - The order reference string to check
+ * @returns True if the order reference is for an upgrade
+ */
+declare function isUpgradeOrderReference(orderReference: string): boolean;
+/**
+ * Parses an upgrade order reference to extract both plan IDs.
+ *
+ * @param orderReference - The order reference string to parse
+ * @returns Parsed upgrade reference with currentPlanId and newPlanId, or null if invalid
+ */
+declare function parseUpgradeOrderReference(orderReference: string): ParsedUpgradeOrderReference | null;
+/**
+ * Extracts the payment type from an order reference.
+ *
+ * @param orderReference - The order reference string
+ * @returns The payment type ('sub' or 'tkn'), or null if invalid
+ */
+declare function getOrderReferencePaymentType(orderReference: string): OrderReferencePaymentType | null;
+/**
+ * Extracts the item ID (plan ID or pack ID) from an order reference.
+ *
+ * @param orderReference - The order reference string
+ * @returns The item ID, or null if invalid
+ */
+declare function getOrderReferenceItemId(orderReference: string): string | null;
+/**
+ * Extracts the user ID from an order reference.
+ *
+ * @param orderReference - The order reference string
+ * @returns The user ID, or null if invalid
+ */
+declare function getOrderReferenceUserId(orderReference: string): string | null;
+/**
+ * Parses an order reference string into its components.
+ * Supports both v1 (legacy) and v2 (new) formats.
+ *
+ * v1 format: miia_{platform}_bot_{userId}_{planId}_v1_{timestamp}
+ * v2 format: miia_{platform}_bot_{userId}_{type}_{itemId}_v2_{timestamp}
+ *
+ * @param referenceString - The order reference string to parse
+ * @returns Parsed reference object or null if invalid
+ */
+declare function parseOrderReference(referenceString: string): (ParsedOrderReference | ParsedReferenceString) | null;
+export type { OrderReferencePaymentType, CreateSubscriptionOrderReferenceParams, CreateTokenPackOrderReferenceParams, CreateUpgradeOrderReferenceParams, ParsedOrderReference, ParsedReferenceString, ParsedUpgradeOrderReference, };
+export { ORDER_REFERENCE_VERSION, ORDER_REFERENCE_APP_NAME, ORDER_REFERENCE_SERVICE_TYPE, createSubscriptionOrderReference, createTokenPackOrderReference, createUpgradeOrderReference, isSubscriptionOrderReference, isTokenPackOrderReference, isUpgradeOrderReference, getOrderReferencePaymentType, getOrderReferenceItemId, getOrderReferenceUserId, parseUpgradeOrderReference, parseOrderReference, };
 //# sourceMappingURL=utils.d.ts.map

package/dist/modules/payments/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/payments/utils.ts"],"names":[],"mappings":"AAAA,iBAAS,oBAAoB,CAAC,EAC1B,MAAM,EACN,QAAQ,EACR,MAAM,EACN,OAAO,GACV,EAAE;IACC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAET;AAED,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iBAAS,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CA0BlF;AAED,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/payments/utils.ts"],"names":[],"mappings":"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"}

package/dist/modules/payments/utils.js

@@ -1,20 +1,264 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createOrderReference = createOrderReference;
+exports.ORDER_REFERENCE_SERVICE_TYPE = exports.ORDER_REFERENCE_APP_NAME = exports.ORDER_REFERENCE_VERSION = void 0;
+exports.createSubscriptionOrderReference = createSubscriptionOrderReference;
+exports.createTokenPackOrderReference = createTokenPackOrderReference;
+exports.createUpgradeOrderReference = createUpgradeOrderReference;
+exports.isSubscriptionOrderReference = isSubscriptionOrderReference;
+exports.isTokenPackOrderReference = isTokenPackOrderReference;
+exports.isUpgradeOrderReference = isUpgradeOrderReference;
+exports.getOrderReferencePaymentType = getOrderReferencePaymentType;
+exports.getOrderReferenceItemId = getOrderReferenceItemId;
+exports.getOrderReferenceUserId = getOrderReferenceUserId;
+exports.parseUpgradeOrderReference = parseUpgradeOrderReference;
 exports.parseOrderReference = parseOrderReference;
-function createOrderReference({ userId, platform, planId, utcDate, }) {
-    return `miia_${platform}_bot_${userId}_${planId}_v1_${utcDate}`;
+const ORDER_REFERENCE_VERSION = 'v2';
+exports.ORDER_REFERENCE_VERSION = ORDER_REFERENCE_VERSION;
+const ORDER_REFERENCE_APP_NAME = 'miia';
+exports.ORDER_REFERENCE_APP_NAME = ORDER_REFERENCE_APP_NAME;
+const ORDER_REFERENCE_SERVICE_TYPE = 'bot';
+exports.ORDER_REFERENCE_SERVICE_TYPE = ORDER_REFERENCE_SERVICE_TYPE;
+/**
+ * Creates a unique order reference for subscription payments.
+ * Format: miia_{platform}_bot_{userId}_sub_{planId}_v2_{utcDate}
+ *
+ * @param params - Parameters for generating the order reference
+ * @returns A unique order reference string
+ */
+function createSubscriptionOrderReference({ userId, platform, planId, utcDate, }) {
+    return `${ORDER_REFERENCE_APP_NAME}_${platform}_${ORDER_REFERENCE_SERVICE_TYPE}_${userId}_sub_${planId}_${ORDER_REFERENCE_VERSION}_${utcDate}`;
 }
+/**
+ * Creates a unique order reference for token pack payments.
+ * Format: miia_{platform}_bot_{userId}_tkn_{packId}_v2_{utcDate}
+ *
+ * @param params - Parameters for generating the order reference
+ * @returns A unique order reference string
+ */
+function createTokenPackOrderReference({ userId, platform, packId, utcDate, }) {
+    return `${ORDER_REFERENCE_APP_NAME}_${platform}_${ORDER_REFERENCE_SERVICE_TYPE}_${userId}_tkn_${packId}_${ORDER_REFERENCE_VERSION}_${utcDate}`;
+}
+/**
+ * Creates a unique order reference for subscription upgrade payments.
+ * Format: miia_{platform}_bot_{userId}_upg_{currentPlanId}_to_{newPlanId}_v2_{utcDate}
+ *
+ * @param params - Parameters for generating the order reference
+ * @returns A unique order reference string
+ */
+function createUpgradeOrderReference({ userId, platform, currentPlanId, newPlanId, utcDate, }) {
+    return `${ORDER_REFERENCE_APP_NAME}_${platform}_${ORDER_REFERENCE_SERVICE_TYPE}_${userId}_upg_${currentPlanId}_to_${newPlanId}_${ORDER_REFERENCE_VERSION}_${utcDate}`;
+}
+/**
+ * Checks if an order reference is for a subscription payment.
+ *
+ * @param orderReference - The order reference string to check
+ * @returns True if the order reference is for a subscription
+ */
+function isSubscriptionOrderReference(orderReference) {
+    const parsed = parseOrderReference(orderReference);
+    if (!parsed)
+        return false;
+    // v2 format with explicit type
+    if ('paymentType' in parsed && parsed.paymentType === 'sub') {
+        return true;
+    }
+    // v1 legacy format (all were subscriptions)
+    if (parsed.version === 'v1') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Checks if an order reference is for a token pack payment.
+ *
+ * @param orderReference - The order reference string to check
+ * @returns True if the order reference is for a token pack
+ */
+function isTokenPackOrderReference(orderReference) {
+    const parsed = parseOrderReference(orderReference);
+    if (!parsed)
+        return false;
+    return 'paymentType' in parsed && parsed.paymentType === 'tkn';
+}
+/**
+ * Checks if an order reference is for a subscription upgrade payment.
+ *
+ * @param orderReference - The order reference string to check
+ * @returns True if the order reference is for an upgrade
+ */
+function isUpgradeOrderReference(orderReference) {
+    const parsed = parseOrderReference(orderReference);
+    if (!parsed)
+        return false;
+    return 'paymentType' in parsed && parsed.paymentType === 'upg';
+}
+/**
+ * Parses an upgrade order reference to extract both plan IDs.
+ *
+ * @param orderReference - The order reference string to parse
+ * @returns Parsed upgrade reference with currentPlanId and newPlanId, or null if invalid
+ */
+function parseUpgradeOrderReference(orderReference) {
+    const parts = orderReference.split('_');
+    // Format: miia_{platform}_bot_{userId}_upg_{currentPlanId}_to_{newPlanId}_v2_{timestamp}
+    // Minimum parts: appName, platform, serviceType, userId, upg, currentPlanId, to, newPlanId, version, timestamp
+    if (parts.length < 10) {
+        return null;
+    }
+    const [appName, platform, serviceType, userId, paymentType] = parts;
+    if (paymentType !== 'upg') {
+        return null;
+    }
+    // Find the 'to' separator to extract plan IDs
+    const toIndex = parts.indexOf('to', 5);
+    if (toIndex === -1) {
+        return null;
+    }
+    // currentPlanId is between 'upg' (index 4) and 'to'
+    const currentPlanId = parts.slice(5, toIndex).join('_');
+    // newPlanId is between 'to' and version (which starts with 'v')
+    // Find the version index (starts with 'v' and is followed by a number)
+    let versionIndex = -1;
+    for (let i = toIndex + 1; i < parts.length; i++) {
+        if (parts[i].match(/^v\d+$/)) {
+            versionIndex = i;
+            break;
+        }
+    }
+    if (versionIndex === -1) {
+        return null;
+    }
+    const newPlanId = parts.slice(toIndex + 1, versionIndex).join('_');
+    const version = parts[versionIndex];
+    const timestamp = parts.slice(versionIndex + 1).join('_');
+    return {
+        appName,
+        platform,
+        serviceType,
+        userId,
+        paymentType: 'upg',
+        currentPlanId,
+        newPlanId,
+        version,
+        timestamp,
+    };
+}
+/**
+ * Extracts the payment type from an order reference.
+ *
+ * @param orderReference - The order reference string
+ * @returns The payment type ('sub' or 'tkn'), or null if invalid
+ */
+function getOrderReferencePaymentType(orderReference) {
+    const parsed = parseOrderReference(orderReference);
+    if (!parsed)
+        return null;
+    if ('paymentType' in parsed) {
+        return parsed.paymentType;
+    }
+    // v1 legacy format was always subscription
+    if (parsed.version === 'v1') {
+        return 'sub';
+    }
+    return null;
+}
+/**
+ * Extracts the item ID (plan ID or pack ID) from an order reference.
+ *
+ * @param orderReference - The order reference string
+ * @returns The item ID, or null if invalid
+ */
+function getOrderReferenceItemId(orderReference) {
+    const parsed = parseOrderReference(orderReference);
+    if (!parsed)
+        return null;
+    if ('itemId' in parsed) {
+        return parsed.itemId;
+    }
+    // v1 legacy format
+    if ('planId' in parsed) {
+        return parsed.planId;
+    }
+    return null;
+}
+/**
+ * Extracts the user ID from an order reference.
+ *
+ * @param orderReference - The order reference string
+ * @returns The user ID, or null if invalid
+ */
+function getOrderReferenceUserId(orderReference) {
+    const parsed = parseOrderReference(orderReference);
+    return parsed?.userId ?? null;
+}
+/**
+ * Parses an order reference string into its components.
+ * Supports both v1 (legacy) and v2 (new) formats.
+ *
+ * v1 format: miia_{platform}_bot_{userId}_{planId}_v1_{timestamp}
+ * v2 format: miia_{platform}_bot_{userId}_{type}_{itemId}_v2_{timestamp}
+ *
+ * @param referenceString - The order reference string to parse
+ * @returns Parsed reference object or null if invalid
+ */
 function parseOrderReference(referenceString) {
-    // `miia_${platform}_bot_${userId}_${planId}_v1_${formattedUtc}`;
-    const [appName, platform, serviceType, userId, planId, version, timestamp, chargeId] = referenceString.split('_');
+    const parts = referenceString.split('_');
+    // Minimum parts: appName, platform, serviceType, userId, planId/type, version, timestamp
+    if (parts.length < 7) {
+        return null;
+    }
+    const [appName, platform, serviceType, userId] = parts;
+    // Validate required fields
     if (typeof appName !== 'string' ||
         typeof platform !== 'string' ||
         typeof serviceType !== 'string' ||
-        typeof userId !== 'string' ||
-        typeof planId !== 'string' ||
-        typeof version !== 'string' ||
-        typeof timestamp !== 'string') {
+        typeof userId !== 'string') {
+        return null;
+    }
+    // Check for v2 format (has payment type indicator)
+    const potentialType = parts[4];
+    const isV2Format = potentialType === 'sub' || potentialType === 'tkn' || potentialType === 'upg';
+    // Handle upgrade references separately (they have a different structure)
+    if (potentialType === 'upg') {
+        const upgradeParsed = parseUpgradeOrderReference(referenceString);
+        if (upgradeParsed) {
+            return {
+                appName: upgradeParsed.appName,
+                platform: upgradeParsed.platform,
+                serviceType: upgradeParsed.serviceType,
+                userId: upgradeParsed.userId,
+                paymentType: 'upg',
+                itemId: upgradeParsed.newPlanId, // Use newPlanId as itemId for compatibility
+                version: upgradeParsed.version,
+                timestamp: upgradeParsed.timestamp,
+            };
+        }
+        return null;
+    }
+    if (isV2Format) {
+        // v2 format: miia_{platform}_bot_{userId}_{type}_{itemId}_v2_{timestamp}[_{chargeId}]
+        const [, , , , paymentType, itemId, version, timestamp, chargeId] = parts;
+        if (typeof paymentType !== 'string' ||
+            typeof itemId !== 'string' ||
+            typeof version !== 'string' ||
+            typeof timestamp !== 'string') {
+            return null;
+        }
+        return {
+            appName,
+            platform,
+            serviceType,
+            userId,
+            paymentType: paymentType,
+            itemId,
+            version,
+            timestamp,
+            chargeId,
+        };
+    }
+    // v1 legacy format: miia_{platform}_bot_{userId}_{planId}_v1_{timestamp}[_{chargeId}]
+    const [, , , , planId, version, timestamp, chargeId] = parts;
+    if (typeof planId !== 'string' || typeof version !== 'string' || typeof timestamp !== 'string') {
         return null;
     }
     return {

package/dist/modules/payments/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/modules/payments/utils.ts"],"names":[],"mappings":";;AAqDS,oDAAoB;AAAE,kDAAmB;AArDlD,SAAS,oBAAoB,CAAC,EAC1B,MAAM,EACN,QAAQ,EACR,MAAM,EACN,OAAO,GAMV;IACG,OAAO,QAAQ,QAAQ,QAAQ,MAAM,IAAI,MAAM,OAAO,OAAO,EAAE,CAAC;AACpE,CAAC;AAaD,SAAS,mBAAmB,CAAC,eAAuB;IAChD,iEAAiE;IACjE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAElH,IACI,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,QAAQ,KAAK,QAAQ;QAC5B,OAAO,WAAW,KAAK,QAAQ;QAC/B,OAAO,MAAM,KAAK,QAAQ;QAC1B,OAAO,MAAM,KAAK,QAAQ;QAC1B,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,SAAS,KAAK,QAAQ,EAC/B,CAAC;QACC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO;QACH,OAAO;QACP,QAAQ;QACR,WAAW;QACX,MAAM;QACN,MAAM;QACN,OAAO;QACP,SAAS;QACT,QAAQ;KACX,CAAC;AACN,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/modules/payments/utils.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,39 @@
+import { Logger } from '../logger/types';
+import type { IWayForPayService, GenerateSubscriptionPaymentParams, GenerateOneTimePaymentParams, PaymentUrlResult, SignatureVerificationResult, WayForPayCallbackData, WayForPayWebhookResponse } from './wayforpay.types';
+/**
+ * WayForPayService provides integration with the WayForPay payment provider.
+ * Supports both subscription (regular) and one-time payment flows.
+ */
+export declare class WayForPayService implements IWayForPayService {
+    private readonly logger;
+    private readonly merchantAccount;
+    private readonly merchantSecretKey;
+    private readonly merchantDomainName;
+    private readonly serviceUrl?;
+    constructor({ logger, merchantAccount, merchantSecretKey, merchantDomainName, serviceUrl, }: {
+        logger: Logger;
+        merchantAccount?: string;
+        merchantSecretKey?: string;
+        merchantDomainName?: string;
+        serviceUrl?: string;
+    });
+    /**
+     * Generates a payment URL for subscription (regular) payments.
+     */
+    generateSubscriptionPaymentUrl(params: GenerateSubscriptionPaymentParams): Promise<PaymentUrlResult | null>;
+    /**
+     * Generates a payment URL for one-time payments.
+     */
+    generateOneTimePaymentUrl(params: GenerateOneTimePaymentParams): Promise<PaymentUrlResult | null>;
+    /**
+     * Verifies the signature of a WayForPay webhook callback.
+     * The signature is calculated as HMAC_MD5 of concatenated values.
+     */
+    verifyCallbackSignature(callbackData: WayForPayCallbackData): SignatureVerificationResult;
+    /**
+     * Builds a response to send back to WayForPay after processing a webhook.
+     * WayForPay expects a signed response to confirm receipt.
+     */
+    buildWebhookResponse(orderReference: string, status: 'accept' | 'decline'): WayForPayWebhookResponse;
+}
+//# sourceMappingURL=wayforpay.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wayforpay.service.d.ts","sourceRoot":"","sources":["../../../src/modules/payments/wayforpay.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzC,OAAO,KAAK,EACR,iBAAiB,EACjB,iCAAiC,EACjC,4BAA4B,EAC5B,gBAAgB,EAChB,2BAA2B,EAC3B,qBAAqB,EACrB,wBAAwB,EAC3B,MAAM,mBAAmB,CAAC;AAS3B;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;gBAEzB,EACR,MAAM,EACN,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,GACb,EAAE;QACC,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB;IAQD;;OAEG;IACU,8BAA8B,CACvC,MAAM,EAAE,iCAAiC,GAC1C,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAwEnC;;OAEG;IACU,yBAAyB,CAAC,MAAM,EAAE,4BAA4B,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA2D9G;;;OAGG;IACI,uBAAuB,CAAC,YAAY,EAAE,qBAAqB,GAAG,2BAA2B;IAoEhG;;;OAGG;IACI,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,wBAAwB;CAc9G"}