@misterhomer1992/miit-bot-payment 1.1.6 → 2.0.4

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

@@ -0,0 +1,99 @@
+import { Logger } from '../logger/types';
+import type { WayForPayCallbackData, IWayForPayService } from './wayforpay.types';
+import type { IPaymentService } from './types';
+import type { IInvoiceService } from '../invoice/types';
+import type { ISubscriptionService } from '../subscription/types';
+import type { ISubscriptionPlanService } from '../subscriptionPlan/types';
+import type { ITokenPackService } from '../tokenPack/types';
+import type { WebhookProcessingResult, IWebhookHandlerService } from './webhook.types';
+import type { TokenPackPlan } from '../token/types';
+import { GracePeriodConfig } from '../../config';
+/**
+ * WebhookHandlerService processes payment confirmation webhooks from WayForPay.
+ * It handles signature verification, payment status updates, subscription activation,
+ * and user token balance initialization.
+ */
+export declare class WebhookHandlerService implements IWebhookHandlerService {
+    private readonly logger;
+    private readonly wayForPayService;
+    private readonly paymentService;
+    private readonly invoiceService;
+    private readonly subscriptionService;
+    private readonly subscriptionPlanService;
+    private readonly tokenPackService;
+    private readonly tokenPackPlans;
+    private readonly gracePeriodConfig;
+    constructor({ logger, wayForPayService, paymentService, invoiceService, subscriptionService, subscriptionPlanService, tokenPackService, tokenPackPlans, gracePeriodConfig, }: {
+        logger: Logger;
+        wayForPayService?: IWayForPayService;
+        paymentService?: IPaymentService;
+        invoiceService?: IInvoiceService;
+        subscriptionService?: ISubscriptionService;
+        subscriptionPlanService?: ISubscriptionPlanService;
+        tokenPackService?: ITokenPackService;
+        tokenPackPlans?: TokenPackPlan[];
+        gracePeriodConfig?: GracePeriodConfig;
+    });
+    private loadGracePeriodConfig;
+    /**
+     * Processes a payment confirmation webhook from WayForPay.
+     * This method handles the complete webhook flow:
+     * 1. Verifies the signature to validate request authenticity
+     * 2. Creates an invoice record
+     * 3. Updates payment status
+     * 4. Activates subscription or renews existing one
+     * 5. Initializes user token balance based on plan
+     *
+     * @param callbackData - The callback data from WayForPay
+     * @returns Processing result with response to send back to WayForPay
+     */
+    processPaymentWebhook(callbackData: WayForPayCallbackData): Promise<WebhookProcessingResult>;
+    /**
+     * Processes an approved subscription payment.
+     * Creates invoice, updates payment status, activates subscription,
+     * and initializes token balance.
+     */
+    private processApprovedSubscriptionPayment;
+    /**
+     * Processes an approved token pack payment.
+     * Creates invoice, updates payment status, and adds tokens to user balance.
+     */
+    private processApprovedTokenPackPayment;
+    /**
+     * Processes an approved subscription upgrade payment.
+     * Updates subscription's planId, resets expiresAt, and adds new plan's tokens to existing balance.
+     */
+    private processApprovedUpgradePayment;
+    /**
+     * Activates a new subscription for the user.
+     */
+    private activateNewSubscription;
+    /**
+     * Renews an existing subscription by extending its expiration date.
+     */
+    private renewSubscription;
+    /**
+     * Initializes user token balance by creating a token pack.
+     */
+    private initializeTokenBalance;
+    /**
+     * Calculates the subscription expiration date based on the regular mode.
+     */
+    private calculateExpirationDate;
+    /**
+     * Handles failed or declined payments.
+     * For recurring subscription renewals, this triggers deactivation of the subscription.
+     */
+    private handleFailedPayment;
+    /**
+     * Checks if the payment callback is for a recurring renewal payment.
+     * WayForPay sets regularOn field for recurring payments.
+     */
+    private isRecurringRenewal;
+    /**
+     * Handles a failed recurring renewal by cancelling or deactivating the subscription.
+     * Respects grace period configuration before full deactivation.
+     */
+    private handleFailedRenewal;
+}
+//# sourceMappingURL=webhook.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.service.d.ts","sourceRoot":"","sources":["../../../src/modules/payments/webhook.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAoBzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAsB,MAAM,uBAAuB,CAAC;AACtF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAwB,iBAAiB,EAA+B,MAAM,cAAc,CAAC;AAEpG;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IACjD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAuB;IAC3D,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA2B;IACnE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IACjD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;gBAE1C,EACR,MAAM,EACN,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GACpB,EAAE;QACC,MAAM,EAAE,MAAM,CAAC;QACf,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;QACrC,cAAc,CAAC,EAAE,eAAe,CAAC;QACjC,cAAc,CAAC,EAAE,eAAe,CAAC;QACjC,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;QAC3C,uBAAuB,CAAC,EAAE,wBAAwB,CAAC;QACnD,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;QACrC,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;QACjC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;KACzC;IAYD,OAAO,CAAC,qBAAqB;IAS7B;;;;;;;;;;;OAWG;IACU,qBAAqB,CAAC,YAAY,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA0FzG;;;;OAIG;YACW,kCAAkC;IAiHhD;;;OAGG;YACW,+BAA+B;IAwF7C;;;OAGG;YACW,6BAA6B;IAoJ3C;;OAEG;YACW,uBAAuB;IA4BrC;;OAEG;YACW,iBAAiB;IAkC/B;;OAEG;YACW,sBAAsB;IA4BpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAkB/B;;;OAGG;YACW,mBAAmB;IA0BjC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;;OAGG;YACW,mBAAmB;CA8FpC"}