@ambushsoftworks/nestjs-payments-graphql 0.1.0

package/dist/services/payment-plan.service.d.ts

@@ -0,0 +1,47 @@
+import type { IPaymentPlanRepository } from '../interfaces/payment-plan-repository.interface';
+import type { IInvoiceRepository } from '../interfaces/invoice-repository.interface';
+import type { ITransactionManager } from '../interfaces/transaction-manager.interface';
+import type { PaymentPlan, PaymentPlanInstallment, PaymentPlanFilter } from '../types';
+import { InvoiceService } from './invoice.service';
+export interface CreatePaymentPlanInput {
+    clientDetailsId: string;
+    totalAmount: number;
+    currency?: string;
+    name?: string;
+    description?: string;
+    referenceType?: string;
+    referenceId?: string;
+    installments: Array<{
+        amount: number;
+        dueAt?: Date;
+        sequenceOrder: number;
+    }>;
+}
+export interface PaymentPlanWithComputed extends PaymentPlan {
+    amountPaid: number;
+    amountRemaining: number;
+    installments: PaymentPlanInstallment[];
+}
+export declare class PaymentPlanService {
+    private readonly planRepo;
+    private readonly invoiceRepo;
+    private readonly transactionManager;
+    private readonly defaultCurrency;
+    private readonly invoiceService;
+    private readonly logger;
+    constructor(planRepo: IPaymentPlanRepository, invoiceRepo: IInvoiceRepository, transactionManager: ITransactionManager, defaultCurrency: string, invoiceService: InvoiceService);
+    createPaymentPlan(divisionId: string, input: CreatePaymentPlanInput, createdBy: string): Promise<PaymentPlanWithComputed>;
+    invoiceInstallment(divisionId: string, installmentId: string, createdBy: string): Promise<import("../types").Invoice>;
+    waiveInstallment(divisionId: string, installmentId: string, reason?: string): Promise<PaymentPlanInstallment>;
+    cancelPaymentPlan(divisionId: string, planId: string, reason?: string, cancelledBy?: string): Promise<PaymentPlan>;
+    findPaymentPlan(divisionId: string, id: string): Promise<PaymentPlanWithComputed | null>;
+    findPaymentPlans(divisionId: string, filter?: PaymentPlanFilter, skip?: number, take?: number): Promise<{
+        items: PaymentPlan[];
+        totalCount: number;
+    }>;
+    onInvoicePaid(invoiceId: string): Promise<void>;
+    markInstallmentOverdue(invoiceId: string): Promise<void>;
+    findInstallmentsByPlan(planId: string): Promise<PaymentPlanInstallment[]>;
+    private requirePaymentPlans;
+    private checkAndCompletePlan;
+}

package/dist/services/payment-plan.service.js

@@ -0,0 +1,264 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var PaymentPlanService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentPlanService = void 0;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("../constants");
+const exceptions_1 = require("../exceptions");
+const invoice_service_1 = require("./invoice.service");
+const TERMINAL_INSTALLMENT_STATUSES = new Set(['PAID', 'WAIVED', 'CANCELLED']);
+let PaymentPlanService = PaymentPlanService_1 = class PaymentPlanService {
+    constructor(planRepo, invoiceRepo, transactionManager, defaultCurrency, invoiceService) {
+        this.planRepo = planRepo;
+        this.invoiceRepo = invoiceRepo;
+        this.transactionManager = transactionManager;
+        this.defaultCurrency = defaultCurrency;
+        this.invoiceService = invoiceService;
+        this.logger = new common_1.Logger(PaymentPlanService_1.name);
+    }
+    async createPaymentPlan(divisionId, input, createdBy) {
+        const installmentSum = input.installments.reduce((sum, inst) => sum + inst.amount, 0);
+        if (installmentSum !== input.totalAmount) {
+            throw new exceptions_1.InvalidInvoiceStateException(`Installment amounts (${installmentSum}) do not sum to totalAmount (${input.totalAmount})`);
+        }
+        return this.transactionManager.runInTransaction(async (repos) => {
+            const planRepo = this.requirePaymentPlans(repos);
+            const plan = await planRepo.create({
+                divisionId,
+                clientDetailsId: input.clientDetailsId,
+                totalAmount: input.totalAmount,
+                currency: input.currency ?? this.defaultCurrency,
+                name: input.name,
+                description: input.description,
+                referenceType: input.referenceType,
+                referenceId: input.referenceId,
+                createdBy,
+            });
+            const installments = [];
+            for (const inst of input.installments) {
+                const installment = await planRepo.createInstallment({
+                    paymentPlanId: plan.id,
+                    sequenceOrder: inst.sequenceOrder,
+                    amount: inst.amount,
+                    dueAt: inst.dueAt,
+                });
+                installments.push(installment);
+            }
+            return {
+                ...plan,
+                amountPaid: 0,
+                amountRemaining: plan.totalAmount,
+                installments,
+            };
+        });
+    }
+    async invoiceInstallment(divisionId, installmentId, createdBy) {
+        const installment = await this.planRepo.findInstallmentById(installmentId);
+        if (!installment) {
+            throw new exceptions_1.InvalidInvoiceStateException(`Installment ${installmentId} not found`);
+        }
+        if (installment.invoiceId) {
+            this.logger.log(`Installment ${installmentId} already has invoice ${installment.invoiceId}, returning existing`);
+            const existing = await this.invoiceRepo.findById(installment.invoiceId);
+            if (existing)
+                return existing;
+        }
+        if (installment.status !== 'PENDING') {
+            throw new exceptions_1.InvalidInvoiceStateException(`Cannot invoice installment in "${installment.status}" status. Installment must be PENDING.`);
+        }
+        const plan = await this.planRepo.findById(installment.paymentPlanId);
+        if (!plan) {
+            throw new exceptions_1.InvalidInvoiceStateException(`Payment plan ${installment.paymentPlanId} not found`);
+        }
+        if (plan.divisionId !== divisionId) {
+            throw new exceptions_1.InvalidInvoiceStateException(`Payment plan does not belong to division ${divisionId}`);
+        }
+        const invoiceInput = {
+            clientDetailsId: plan.clientDetailsId,
+            currency: plan.currency,
+            referenceType: plan.referenceType ?? undefined,
+            referenceId: plan.referenceId ?? undefined,
+            dueAt: installment.dueAt ?? undefined,
+            lineItems: [
+                {
+                    description: plan.name
+                        ? `${plan.name} - Installment ${installment.sequenceOrder}`
+                        : `Payment Plan Installment ${installment.sequenceOrder}`,
+                    quantity: 1,
+                    unitPrice: installment.amount,
+                    isTaxable: false,
+                },
+            ],
+        };
+        const invoice = await this.invoiceService.createInvoice(divisionId, invoiceInput, createdBy);
+        await this.transactionManager.runInTransaction(async (repos) => {
+            const planRepo = this.requirePaymentPlans(repos);
+            await planRepo.updateInstallment(installment.id, {
+                status: 'INVOICED',
+                invoiceId: invoice.id,
+            });
+            await repos.invoices.update(invoice.id, {
+                paymentPlanId: plan.id,
+                installmentNumber: installment.sequenceOrder,
+            });
+        });
+        return invoice;
+    }
+    async waiveInstallment(divisionId, installmentId, reason) {
+        const installment = await this.planRepo.findInstallmentById(installmentId);
+        if (!installment) {
+            throw new exceptions_1.InvalidInvoiceStateException(`Installment ${installmentId} not found`);
+        }
+        if (installment.status !== 'PENDING') {
+            throw new exceptions_1.InvalidInvoiceStateException(`Cannot waive installment in "${installment.status}" status. Installment must be PENDING.`);
+        }
+        const plan = await this.planRepo.findById(installment.paymentPlanId);
+        if (!plan || plan.divisionId !== divisionId) {
+            throw new exceptions_1.InvalidInvoiceStateException(`Payment plan not found in division ${divisionId}`);
+        }
+        const updated = await this.planRepo.updateInstallment(installment.id, {
+            status: 'WAIVED',
+        });
+        if (reason) {
+            this.logger.log(`Installment ${installmentId} waived. Reason: ${reason}`);
+        }
+        await this.checkAndCompletePlan(installment.paymentPlanId);
+        return updated;
+    }
+    async cancelPaymentPlan(divisionId, planId, reason, cancelledBy) {
+        const plan = await this.planRepo.findById(planId);
+        if (!plan) {
+            throw new exceptions_1.InvalidInvoiceStateException(`Payment plan ${planId} not found`);
+        }
+        if (plan.divisionId !== divisionId) {
+            throw new exceptions_1.InvalidInvoiceStateException(`Payment plan does not belong to division ${divisionId}`);
+        }
+        if (plan.status !== 'ACTIVE') {
+            throw new exceptions_1.InvalidInvoiceStateException(`Cannot cancel payment plan in "${plan.status}" status. Plan must be ACTIVE.`);
+        }
+        return this.transactionManager.runInTransaction(async (repos) => {
+            const planRepo = this.requirePaymentPlans(repos);
+            const cancelledPlan = await planRepo.update(planId, {
+                status: 'CANCELLED',
+                cancelledBy: cancelledBy ?? null,
+                cancelledAt: new Date(),
+                cancelReason: reason ?? null,
+            });
+            const installments = await planRepo.findInstallmentsByPlan(planId);
+            for (const installment of installments) {
+                if (installment.status === 'PENDING') {
+                    await planRepo.updateInstallment(installment.id, {
+                        status: 'CANCELLED',
+                    });
+                }
+                if (installment.status === 'INVOICED' && installment.invoiceId) {
+                    try {
+                        await this.invoiceService.voidInvoice(installment.invoiceId, `Payment plan cancelled: ${reason ?? 'No reason provided'}`, cancelledBy);
+                        await planRepo.updateInstallment(installment.id, {
+                            status: 'CANCELLED',
+                        });
+                    }
+                    catch (error) {
+                        this.logger.warn(`Could not void invoice ${installment.invoiceId} during plan cancellation: ${error instanceof Error ? error.message : String(error)}`);
+                    }
+                }
+            }
+            return cancelledPlan;
+        });
+    }
+    async findPaymentPlan(divisionId, id) {
+        const plan = await this.planRepo.findById(id);
+        if (!plan || plan.divisionId !== divisionId) {
+            return null;
+        }
+        const installments = await this.planRepo.findInstallmentsByPlan(id);
+        const amountPaid = installments
+            .filter((i) => i.status === 'PAID')
+            .reduce((sum, i) => sum + i.amount, 0);
+        return {
+            ...plan,
+            amountPaid,
+            amountRemaining: plan.totalAmount - amountPaid,
+            installments,
+        };
+    }
+    async findPaymentPlans(divisionId, filter, skip, take) {
+        return this.planRepo.findByDivision(divisionId, filter, skip, take);
+    }
+    async onInvoicePaid(invoiceId) {
+        const installment = await this.planRepo.findInstallmentByInvoiceId(invoiceId);
+        if (!installment) {
+            return;
+        }
+        if (installment.status === 'PAID') {
+            return;
+        }
+        await this.planRepo.updateInstallment(installment.id, {
+            status: 'PAID',
+        });
+        await this.checkAndCompletePlan(installment.paymentPlanId);
+    }
+    async markInstallmentOverdue(invoiceId) {
+        const installment = await this.planRepo.findInstallmentByInvoiceId(invoiceId);
+        if (!installment)
+            return;
+        if (installment.status !== 'INVOICED')
+            return;
+        await this.planRepo.updateInstallment(installment.id, {
+            status: 'OVERDUE',
+        });
+        const allInstallments = await this.planRepo.findInstallmentsByPlan(installment.paymentPlanId);
+        const overdueCount = allInstallments.filter((i) => i.status === 'OVERDUE').length;
+        const OVERDUE_THRESHOLD = 2;
+        if (overdueCount >= OVERDUE_THRESHOLD) {
+            const plan = await this.planRepo.findById(installment.paymentPlanId);
+            if (plan && plan.status === 'ACTIVE') {
+                await this.planRepo.update(plan.id, { status: 'DEFAULTED' });
+                this.logger.warn(`Payment plan ${plan.id} defaulted — ${overdueCount} installments overdue`);
+            }
+        }
+    }
+    async findInstallmentsByPlan(planId) {
+        return this.planRepo.findInstallmentsByPlan(planId);
+    }
+    requirePaymentPlans(repos) {
+        if (!repos.paymentPlans) {
+            throw new Error('PaymentPlanService requires paymentPlans in TransactionRepositories, ' +
+                'but it was not provided by the transaction manager.');
+        }
+        return repos.paymentPlans;
+    }
+    async checkAndCompletePlan(planId) {
+        const installments = await this.planRepo.findInstallmentsByPlan(planId);
+        const allTerminal = installments.every((i) => TERMINAL_INSTALLMENT_STATUSES.has(i.status));
+        if (allTerminal && installments.length > 0) {
+            const plan = await this.planRepo.findById(planId);
+            if (plan && plan.status === 'ACTIVE') {
+                await this.planRepo.update(planId, { status: 'COMPLETED' });
+                this.logger.log(`Payment plan ${planId} completed — all installments are terminal`);
+            }
+        }
+    }
+};
+exports.PaymentPlanService = PaymentPlanService;
+exports.PaymentPlanService = PaymentPlanService = PaymentPlanService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(constants_1.PAYMENT_PLAN_REPOSITORY)),
+    __param(1, (0, common_1.Inject)(constants_1.INVOICE_REPOSITORY)),
+    __param(2, (0, common_1.Inject)(constants_1.TRANSACTION_MANAGER)),
+    __param(3, (0, common_1.Inject)(constants_1.DEFAULT_CURRENCY)),
+    __metadata("design:paramtypes", [Object, Object, Object, String, invoice_service_1.InvoiceService])
+], PaymentPlanService);
+//# sourceMappingURL=payment-plan.service.js.map

package/dist/services/payment-plan.service.js.map

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

package/dist/services/payment.service.d.ts

@@ -0,0 +1,65 @@
+import { type OnModuleInit } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import type { IInvoiceRepository } from '../interfaces/invoice-repository.interface';
+import type { IPaymentRepository } from '../interfaces/payment-repository.interface';
+import type { IWebhookIdempotencyRepository } from '../interfaces/webhook-idempotency-repository.interface';
+import type { ITransactionManager } from '../interfaces/transaction-manager.interface';
+import type { Payment, PaymentMethod, PaymentStatus } from '../types';
+import type { PaymentWebhookEvent } from '../gateways/payment-gateway.interface';
+import { GatewayRegistryService } from '../gateways/gateway-registry.service';
+export interface RecordManualPaymentInput {
+    invoiceId: string;
+    amount: number;
+    method: PaymentMethod;
+    currency?: string;
+    referenceNumber?: string;
+    notes?: string;
+    processedAt?: Date;
+    createdBy: string;
+    receivedBy?: string;
+}
+export interface CreatePendingPaymentInput {
+    invoiceId: string;
+    amount: number;
+    currency: string;
+    method: PaymentMethod;
+    provider: string;
+    providerPaymentId: string;
+    createdBy: string;
+}
+export declare class PaymentService implements OnModuleInit {
+    private readonly invoiceRepo;
+    private readonly paymentRepo;
+    private readonly webhookIdempotencyRepo;
+    private readonly transactionManager;
+    private readonly gatewayRegistry;
+    private readonly moduleRef;
+    private readonly logger;
+    private paymentEventListener;
+    private paymentEmailService;
+    private paymentPlanService;
+    constructor(invoiceRepo: IInvoiceRepository, paymentRepo: IPaymentRepository, webhookIdempotencyRepo: IWebhookIdempotencyRepository, transactionManager: ITransactionManager, gatewayRegistry: GatewayRegistryService, moduleRef: ModuleRef);
+    onModuleInit(): void;
+    recordManualPayment(input: RecordManualPaymentInput): Promise<Payment>;
+    createPendingPayment(input: CreatePendingPaymentInput): Promise<Payment>;
+    handlePaymentSucceeded(event: PaymentWebhookEvent): Promise<void>;
+    handlePaymentFailed(event: PaymentWebhookEvent): Promise<void>;
+    handlePaymentProcessing(event: PaymentWebhookEvent): Promise<void>;
+    reconcilePayment(paymentId: string): Promise<Payment>;
+    findStalePayments(statuses: PaymentStatus[], olderThan: Date): Promise<Payment[]>;
+    confirmPayment(paymentId: string): Promise<Payment>;
+    rejectPayment(paymentId: string, reason?: string): Promise<Payment>;
+    private buildEnrichedPaidEvent;
+    private mapLineItemEvents;
+    private validatePayable;
+    private validateAmount;
+    private applyPaymentToInvoice;
+    recordAutoChargePayment(input: {
+        invoiceId: string;
+        amount: number;
+        currency: string;
+        provider: string;
+        providerPaymentId: string;
+        receiptUrl?: string;
+    }): Promise<Payment>;
+}