@ambushsoftworks/nestjs-payments-graphql 0.1.0

package/dist/services/customer.service.js

@@ -0,0 +1,63 @@
+"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 CustomerService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomerService = void 0;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("../constants");
+const gateway_registry_service_1 = require("../gateways/gateway-registry.service");
+let CustomerService = CustomerService_1 = class CustomerService {
+    constructor(customerRepo, gatewayRegistry) {
+        this.customerRepo = customerRepo;
+        this.gatewayRegistry = gatewayRegistry;
+        this.logger = new common_1.Logger(CustomerService_1.name);
+    }
+    async createOrLinkCustomer(divisionId, clientDetailsId, email, name, provider = 'stripe') {
+        const existing = await this.customerRepo.findByClientAndProvider(divisionId, clientDetailsId, provider);
+        if (existing)
+            return existing;
+        const gateway = this.gatewayRegistry.getRecurring(provider);
+        const { providerCustomerId } = await gateway.createOrRetrieveCustomer({
+            email,
+            name,
+            metadata: { divisionId, clientDetailsId },
+        });
+        return this.customerRepo.create({
+            divisionId,
+            clientDetailsId,
+            provider,
+            providerCustomerId,
+        });
+    }
+    async findCustomer(divisionId, clientDetailsId, provider = 'stripe') {
+        return this.customerRepo.findByClientAndProvider(divisionId, clientDetailsId, provider);
+    }
+    async createSetupSession(divisionId, clientDetailsId, email, name, successUrl, cancelUrl, provider = 'stripe') {
+        const customer = await this.createOrLinkCustomer(divisionId, clientDetailsId, email, name, provider);
+        const gateway = this.gatewayRegistry.getRecurring(provider);
+        return gateway.createSetupSession({
+            providerCustomerId: customer.providerCustomerId,
+            successUrl,
+            cancelUrl,
+            metadata: { divisionId, clientDetailsId },
+        });
+    }
+};
+exports.CustomerService = CustomerService;
+exports.CustomerService = CustomerService = CustomerService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(constants_1.PAYMENT_CUSTOMER_REPOSITORY)),
+    __metadata("design:paramtypes", [Object, gateway_registry_service_1.GatewayRegistryService])
+], CustomerService);
+//# sourceMappingURL=customer.service.js.map

package/dist/services/customer.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer.service.js","sourceRoot":"","sources":["../../src/services/customer.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAA4D;AAE5D,4CAA2D;AAE3D,mFAA8E;AAGvE,IAAM,eAAe,uBAArB,MAAM,eAAe;IAG1B,YAEE,YAAyD,EACxC,eAAuC;QADvC,iBAAY,GAAZ,YAAY,CAA4B;QACxC,oBAAe,GAAf,eAAe,CAAwB;QALzC,WAAM,GAAG,IAAI,eAAM,CAAC,iBAAe,CAAC,IAAI,CAAC,CAAC;IAMxD,CAAC;IASJ,KAAK,CAAC,oBAAoB,CACxB,UAAkB,EAClB,eAAuB,EACvB,KAAa,EACb,IAAa,EACb,WAAmB,QAAQ;QAG3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,uBAAuB,CAC9D,UAAU,EACV,eAAe,EACf,QAAQ,CACT,CAAC;QACF,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAG9B,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAG5D,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,OAAO,CAAC,wBAAwB,CAAC;YACpE,KAAK;YACL,IAAI;YACJ,QAAQ,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE;SAC1C,CAAC,CAAC;QAGH,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;YAC9B,UAAU;YACV,eAAe;YACf,QAAQ;YACR,kBAAkB;SACnB,CAAC,CAAC;IACL,CAAC;IAKD,KAAK,CAAC,YAAY,CAChB,UAAkB,EAClB,eAAuB,EACvB,WAAmB,QAAQ;QAE3B,OAAO,IAAI,CAAC,YAAY,CAAC,uBAAuB,CAC9C,UAAU,EACV,eAAe,EACf,QAAQ,CACT,CAAC;IACJ,CAAC;IAQD,KAAK,CAAC,kBAAkB,CACtB,UAAkB,EAClB,eAAuB,EACvB,KAAa,EACb,IAAwB,EACxB,UAAkB,EAClB,SAAiB,EACjB,WAAmB,QAAQ;QAG3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAC9C,UAAU,EACV,eAAe,EACf,KAAK,EACL,IAAI,EACJ,QAAQ,CACT,CAAC;QAGF,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC5D,OAAO,OAAO,CAAC,kBAAkB,CAAC;YAChC,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;YAC/C,UAAU;YACV,SAAS;YACT,QAAQ,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE;SAC1C,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAlGY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,mBAAU,GAAE;IAKR,WAAA,IAAA,eAAM,EAAC,uCAA2B,CAAC,CAAA;6CAEF,iDAAsB;GAN/C,eAAe,CAkG3B"}

package/dist/services/default-payment-email-templates.d.ts

@@ -0,0 +1,8 @@
+import type { IPaymentEmailTemplateRenderer, RenderedPaymentEmail, InvoiceEmailParams, ETransferEmailParams, PaymentConfirmationEmailParams, OverdueReminderEmailParams, RefundConfirmationEmailParams } from '../interfaces/payment-email.interfaces';
+export declare class DefaultPaymentEmailTemplateRenderer implements IPaymentEmailTemplateRenderer {
+    renderInvoiceNotification(params: InvoiceEmailParams): RenderedPaymentEmail;
+    renderETransferInstructions(params: ETransferEmailParams): RenderedPaymentEmail;
+    renderPaymentConfirmation(params: PaymentConfirmationEmailParams): RenderedPaymentEmail;
+    renderOverdueReminder(params: OverdueReminderEmailParams): RenderedPaymentEmail;
+    renderRefundConfirmation(params: RefundConfirmationEmailParams): RenderedPaymentEmail;
+}

package/dist/services/default-payment-email-templates.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultPaymentEmailTemplateRenderer = void 0;
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function formatAmount(amountCents, currency, locale) {
+    return new Intl.NumberFormat(locale ?? 'en-CA', {
+        style: 'currency',
+        currency,
+    }).format(amountCents / 100);
+}
+function formatDate(date, locale) {
+    return date.toLocaleDateString(locale ?? 'en-CA', {
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric',
+    });
+}
+function formatPaymentMethod(method) {
+    const labels = {
+        CREDIT_CARD: 'Credit Card',
+        DEBIT: 'Debit',
+        E_TRANSFER: 'e-Transfer',
+        BANK_TRANSFER: 'Bank Transfer',
+        CHEQUE: 'Cheque',
+        CASH: 'Cash',
+        OTHER: 'Other',
+    };
+    return labels[method] ?? method;
+}
+function wrapEmail(headerColor, headerTitle, bodyHtml, branding) {
+    const footer = branding.companyName
+        ? `${escapeHtml(branding.companyName)}${branding.supportEmail ? ` | ${escapeHtml(branding.supportEmail)}` : ''}`
+        : 'This is an automated message. Please do not reply directly to this email.';
+    return `
+    <div style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; max-width: 600px; margin: 0 auto; color: #333;">
+      <div style="background: ${headerColor}; color: white; padding: 24px; text-align: center;">
+        <h1 style="margin: 0; font-size: 24px;">${headerTitle}</h1>
+      </div>
+      <div style="padding: 24px; background: #fff;">
+        ${bodyHtml}
+      </div>
+      <div style="padding: 16px 24px; background: #f8f9fa; text-align: center; font-size: 12px; color: #6b7280;">
+        <p style="margin: 0;">${footer}</p>
+      </div>
+    </div>`;
+}
+function summaryTable(rows, bgColor, accentColor, borderColor) {
+    const border = borderColor ? `border: 1px solid ${borderColor};` : '';
+    const tableRows = rows
+        .map((row) => `<tr>
+          <td style="padding: 4px 0;"><strong>${row.label}</strong></td>
+          <td style="text-align: right;${row.highlight ? ` font-size: 18px; font-weight: bold; color: ${accentColor};` : ''}">${row.value}</td>
+        </tr>`)
+        .join('');
+    return `
+    <div style="background: ${bgColor}; border-radius: 8px; padding: 16px; margin: 20px 0; ${border}">
+      <table style="width: 100%;">
+        ${tableRows}
+      </table>
+    </div>`;
+}
+class DefaultPaymentEmailTemplateRenderer {
+    renderInvoiceNotification(params) {
+        const { invoice, clientName, branding } = params;
+        const locale = branding.locale;
+        const amount = formatAmount(invoice.total, invoice.currency, locale);
+        const dueDate = invoice.dueAt
+            ? formatDate(invoice.dueAt, locale)
+            : 'Upon receipt';
+        let lineItemsHtml = '';
+        if (invoice.lineItems && invoice.lineItems.length > 0) {
+            const rows = invoice.lineItems
+                .map((item) => `<tr>
+              <td style="padding: 8px 12px; border-bottom: 1px solid #eee;">${escapeHtml(item.description)}</td>
+              <td style="padding: 8px 12px; border-bottom: 1px solid #eee; text-align: center;">${item.quantity}</td>
+              <td style="padding: 8px 12px; border-bottom: 1px solid #eee; text-align: right;">${formatAmount(item.unitPrice, invoice.currency, locale)}</td>
+              <td style="padding: 8px 12px; border-bottom: 1px solid #eee; text-align: right;">${formatAmount(item.quantity * item.unitPrice, invoice.currency, locale)}</td>
+            </tr>`)
+                .join('');
+            lineItemsHtml = `
+        <table style="width: 100%; border-collapse: collapse; margin: 20px 0;">
+          <thead>
+            <tr style="background: #f8f9fa;">
+              <th style="padding: 8px 12px; text-align: left; border-bottom: 2px solid #dee2e6;">Description</th>
+              <th style="padding: 8px 12px; text-align: center; border-bottom: 2px solid #dee2e6;">Qty</th>
+              <th style="padding: 8px 12px; text-align: right; border-bottom: 2px solid #dee2e6;">Unit Price</th>
+              <th style="padding: 8px 12px; text-align: right; border-bottom: 2px solid #dee2e6;">Amount</th>
+            </tr>
+          </thead>
+          <tbody>${rows}</tbody>
+        </table>`;
+        }
+        const clientNoteHtml = invoice.clientNotes
+            ? `<div style="background: #fffbeb; border-left: 4px solid #f59e0b; padding: 12px 16px; margin: 20px 0;"><strong>Note:</strong> ${escapeHtml(invoice.clientNotes)}</div>`
+            : '';
+        const body = `
+      <p>Hello ${escapeHtml(clientName)},</p>
+      <p>A new invoice has been issued for your account.</p>
+      ${summaryTable([
+            {
+                label: 'Invoice Number:',
+                value: escapeHtml(invoice.invoiceNumber),
+            },
+            { label: 'Amount Due:', value: amount, highlight: true },
+            { label: 'Due Date:', value: dueDate },
+        ], '#f8f9fa', branding.primaryColor)}
+      ${lineItemsHtml}
+      ${clientNoteHtml}
+      <p style="margin-top: 24px;">You can view and pay this invoice by logging into your account.</p>`;
+        return {
+            subject: `Invoice ${invoice.invoiceNumber} — ${amount}`,
+            html: wrapEmail(branding.primaryColor, `Invoice ${escapeHtml(invoice.invoiceNumber)}`, body, branding),
+        };
+    }
+    renderETransferInstructions(params) {
+        const { invoice, instructions, clientName, branding } = params;
+        const locale = branding.locale;
+        const amount = formatAmount(invoice.total, invoice.currency, locale);
+        const securityHtml = instructions.securityAnswer
+            ? `
+        <tr>
+          <td style="padding: 4px 0;"><strong>Security Question:</strong></td>
+          <td style="text-align: right;">${escapeHtml(instructions.securityQuestion ?? 'What is the payment code?')}</td>
+        </tr>
+        <tr>
+          <td style="padding: 4px 0;"><strong>Security Answer:</strong></td>
+          <td style="text-align: right; font-weight: bold;">${escapeHtml(instructions.securityAnswer)}</td>
+        </tr>`
+            : `
+        <tr>
+          <td colspan="2" style="padding: 4px 0; font-style: italic; color: #6b7280;">Auto-deposit is enabled — no security answer required.</td>
+        </tr>`;
+        const body = `
+      <p>Hello ${escapeHtml(clientName)},</p>
+      <p>To pay invoice <strong>${escapeHtml(invoice.invoiceNumber)}</strong>, please send an Interac e-Transfer using the details below.</p>
+
+      <div style="background: #f0fdfa; border-radius: 8px; padding: 16px; margin: 20px 0; border: 1px solid #99f6e4;">
+        <table style="width: 100%;">
+          <tr>
+            <td style="padding: 4px 0;"><strong>Amount:</strong></td>
+            <td style="text-align: right; font-size: 18px; font-weight: bold; color: #0d9488;">${amount}</td>
+          </tr>
+          <tr>
+            <td style="padding: 4px 0;"><strong>Recipient Email:</strong></td>
+            <td style="text-align: right;">${escapeHtml(instructions.eTransferEmail)}</td>
+          </tr>
+          <tr>
+            <td style="padding: 4px 0;"><strong>Recipient Name:</strong></td>
+            <td style="text-align: right;">${escapeHtml(instructions.eTransferRecipient)}</td>
+          </tr>
+          <tr>
+            <td style="padding: 4px 0;"><strong>Reference Code:</strong></td>
+            <td style="text-align: right; font-family: monospace; font-weight: bold;">${escapeHtml(instructions.eTransferCode)}</td>
+          </tr>
+          ${securityHtml}
+        </table>
+      </div>
+
+      <p><strong>Important:</strong> Please include the reference code <strong>${escapeHtml(instructions.eTransferCode)}</strong> in the message field of your e-Transfer so we can match your payment to this invoice.</p>`;
+        return {
+            subject: `e-Transfer Instructions — Invoice ${invoice.invoiceNumber}`,
+            html: wrapEmail('#0d9488', 'e-Transfer Instructions', body, branding),
+        };
+    }
+    renderPaymentConfirmation(params) {
+        const { payment, invoice, clientName, branding } = params;
+        const locale = branding.locale;
+        const paymentAmount = formatAmount(payment.amount, payment.currency, locale);
+        const remainingBalance = formatAmount(Math.max(invoice.amountDue - payment.amount, 0), invoice.currency, locale);
+        const paymentDate = formatDate(payment.processedAt ?? payment.createdAt, locale);
+        const receiptHtml = payment.receiptUrl
+            ? `<p style="text-align: center; margin-top: 20px;"><a href="${escapeHtml(payment.receiptUrl)}" style="background: ${branding.primaryColor}; color: white; padding: 12px 24px; text-decoration: none; border-radius: 6px; display: inline-block;">View Receipt</a></p>`
+            : '';
+        const body = `
+      <p>Hello ${escapeHtml(clientName)},</p>
+      <p>We have received your payment. Thank you!</p>
+      ${summaryTable([
+            { label: 'Invoice:', value: escapeHtml(invoice.invoiceNumber) },
+            { label: 'Payment Amount:', value: paymentAmount, highlight: true },
+            { label: 'Payment Date:', value: paymentDate },
+            { label: 'Method:', value: formatPaymentMethod(payment.method) },
+            { label: 'Remaining Balance:', value: remainingBalance },
+        ], '#f0fdf4', '#059669')}
+      ${receiptHtml}`;
+        return {
+            subject: `Payment Received — Invoice ${invoice.invoiceNumber}`,
+            html: wrapEmail('#059669', 'Payment Received', body, branding),
+        };
+    }
+    renderOverdueReminder(params) {
+        const { invoice, clientName, branding } = params;
+        const locale = branding.locale;
+        const amount = formatAmount(invoice.amountDue, invoice.currency, locale);
+        const dueDate = invoice.dueAt ? formatDate(invoice.dueAt, locale) : 'N/A';
+        const body = `
+      <p>Hello ${escapeHtml(clientName)},</p>
+      <p>This is a reminder that the following invoice is now past due. Please arrange payment at your earliest convenience.</p>
+      ${summaryTable([
+            {
+                label: 'Invoice Number:',
+                value: escapeHtml(invoice.invoiceNumber),
+            },
+            { label: 'Amount Due:', value: amount, highlight: true },
+            { label: 'Original Due Date:', value: dueDate },
+        ], '#fef2f2', '#dc2626', '#fecaca')}
+      <p>You can view and pay this invoice by logging into your account.</p>
+      <p>If you have already made this payment, please disregard this notice.</p>`;
+        return {
+            subject: `Payment Overdue — Invoice ${invoice.invoiceNumber}`,
+            html: wrapEmail('#dc2626', 'Payment Overdue', body, branding),
+        };
+    }
+    renderRefundConfirmation(params) {
+        const { refund, payment, invoice, clientName, branding } = params;
+        const locale = branding.locale;
+        const refundAmount = formatAmount(refund.amount, refund.currency, locale);
+        const originalPayment = formatAmount(payment.amount, payment.currency, locale);
+        const refundDate = formatDate(refund.createdAt, locale);
+        const body = `
+      <p>Hello ${escapeHtml(clientName)},</p>
+      <p>A refund has been processed for your account.</p>
+      ${summaryTable([
+            { label: 'Invoice:', value: escapeHtml(invoice.invoiceNumber) },
+            { label: 'Refund Amount:', value: refundAmount, highlight: true },
+            { label: 'Original Payment:', value: originalPayment },
+            {
+                label: 'Payment Method:',
+                value: formatPaymentMethod(payment.method),
+            },
+            { label: 'Refund Date:', value: refundDate },
+            ...(refund.reason
+                ? [{ label: 'Reason:', value: escapeHtml(refund.reason) }]
+                : []),
+        ], '#fffbeb', '#d97706', '#fde68a')}
+      <p>The refund may take several business days to appear on your statement, depending on your payment provider.</p>`;
+        return {
+            subject: `Refund Processed — Invoice ${invoice.invoiceNumber}`,
+            html: wrapEmail('#d97706', 'Refund Processed', body, branding),
+        };
+    }
+}
+exports.DefaultPaymentEmailTemplateRenderer = DefaultPaymentEmailTemplateRenderer;
+//# sourceMappingURL=default-payment-email-templates.js.map

package/dist/services/default-payment-email-templates.js.map

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

package/dist/services/e-transfer.service.d.ts

@@ -0,0 +1,35 @@
+import type { IInvoiceRepository } from '../interfaces/invoice-repository.interface';
+export interface ETransferInstructions {
+    invoiceNumber: string;
+    amount: number;
+    currency: string;
+    eTransferCode: string;
+    eTransferEmail: string;
+    eTransferRecipient: string;
+    securityQuestion?: string;
+    securityAnswer?: string;
+    message: string;
+}
+export declare class ETransferService {
+    private readonly invoiceRepo;
+    private readonly codePrefix;
+    private readonly logger;
+    private static readonly MAX_RETRIES;
+    private static readonly CODE_LENGTH;
+    constructor(invoiceRepo: IInvoiceRepository, codePrefix: string);
+    generateAnswer(): string;
+    generateCode(): string;
+    assignCode(invoiceId: string, autoDeposit: boolean): Promise<{
+        code: string;
+        answer: string | null;
+    }>;
+    getInstructions(params: {
+        invoiceNumber: string;
+        amount: number;
+        currency: string;
+        eTransferCode: string;
+        eTransferEmail: string;
+        eTransferRecipient: string;
+        eTransferAnswer?: string | null;
+    }): ETransferInstructions;
+}

package/dist/services/e-transfer.service.js

@@ -0,0 +1,93 @@
+"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 ETransferService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ETransferService = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const constants_1 = require("../constants");
+const exceptions_1 = require("../exceptions");
+const CODE_CHARSET = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789';
+let ETransferService = ETransferService_1 = class ETransferService {
+    constructor(invoiceRepo, codePrefix) {
+        this.invoiceRepo = invoiceRepo;
+        this.codePrefix = codePrefix;
+        this.logger = new common_1.Logger(ETransferService_1.name);
+    }
+    generateAnswer() {
+        return String((0, crypto_1.randomInt)(1000, 10000));
+    }
+    generateCode() {
+        let code = '';
+        for (let i = 0; i < ETransferService_1.CODE_LENGTH; i++) {
+            code += CODE_CHARSET[(0, crypto_1.randomInt)(CODE_CHARSET.length)];
+        }
+        const prefix = this.codePrefix ? `${this.codePrefix}-` : '';
+        return `${prefix}${code.slice(0, 4)}-${code.slice(4)}`;
+    }
+    async assignCode(invoiceId, autoDeposit) {
+        for (let attempt = 0; attempt < ETransferService_1.MAX_RETRIES; attempt++) {
+            const code = this.generateCode();
+            const answer = autoDeposit ? null : this.generateAnswer();
+            try {
+                await this.invoiceRepo.update(invoiceId, {
+                    eTransferCode: code,
+                    eTransferAnswer: answer,
+                });
+                return { code, answer };
+            }
+            catch (error) {
+                if (error instanceof exceptions_1.UniqueConstraintViolationException) {
+                    this.logger.warn(`E-transfer code collision on attempt ${attempt + 1}: ${code}`);
+                    continue;
+                }
+                throw error;
+            }
+        }
+        throw new Error(`Failed to assign a unique e-transfer code after ${ETransferService_1.MAX_RETRIES} attempts`);
+    }
+    getInstructions(params) {
+        const formattedAmount = (params.amount / 100).toFixed(2);
+        let message = `Send an Interac e-Transfer for $${formattedAmount} ${params.currency} ` +
+            `to ${params.eTransferEmail} (${params.eTransferRecipient}). ` +
+            `In the message field, enter: ${params.eTransferCode}`;
+        const instructions = {
+            invoiceNumber: params.invoiceNumber,
+            amount: params.amount,
+            currency: params.currency,
+            eTransferCode: params.eTransferCode,
+            eTransferEmail: params.eTransferEmail,
+            eTransferRecipient: params.eTransferRecipient,
+            message: '',
+        };
+        if (params.eTransferAnswer) {
+            const question = 'What is the secure code?';
+            message += ` Use security question '${question}' with answer '${params.eTransferAnswer}'.`;
+            instructions.securityQuestion = question;
+            instructions.securityAnswer = params.eTransferAnswer;
+        }
+        instructions.message = message;
+        return instructions;
+    }
+};
+exports.ETransferService = ETransferService;
+ETransferService.MAX_RETRIES = 5;
+ETransferService.CODE_LENGTH = 8;
+exports.ETransferService = ETransferService = ETransferService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(constants_1.INVOICE_REPOSITORY)),
+    __param(1, (0, common_1.Inject)(constants_1.E_TRANSFER_CODE_PREFIX)),
+    __metadata("design:paramtypes", [Object, String])
+], ETransferService);
+//# sourceMappingURL=e-transfer.service.js.map

package/dist/services/e-transfer.service.js.map

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

package/dist/services/invoice-number.service.d.ts

@@ -0,0 +1,9 @@
+import type { IInvoiceRepository } from '../interfaces/invoice-repository.interface';
+export declare class InvoiceNumberService {
+    private readonly invoiceRepo;
+    private readonly logger;
+    private static readonly MAX_RETRIES;
+    constructor(invoiceRepo: IInvoiceRepository);
+    generate(_divisionId: string): Promise<string>;
+    private getNextSequence;
+}

package/dist/services/invoice-number.service.js

@@ -0,0 +1,56 @@
+"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 InvoiceNumberService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvoiceNumberService = void 0;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("../constants");
+const exceptions_1 = require("../exceptions");
+let InvoiceNumberService = InvoiceNumberService_1 = class InvoiceNumberService {
+    constructor(invoiceRepo) {
+        this.invoiceRepo = invoiceRepo;
+        this.logger = new common_1.Logger(InvoiceNumberService_1.name);
+    }
+    async generate(_divisionId) {
+        const year = new Date().getFullYear();
+        const prefix = `INV-${year}-`;
+        for (let attempt = 0; attempt < InvoiceNumberService_1.MAX_RETRIES; attempt++) {
+            const nextSequence = await this.getNextSequence(prefix);
+            const invoiceNumber = `${prefix}${String(nextSequence).padStart(5, '0')}`;
+            return invoiceNumber;
+        }
+        throw new exceptions_1.InvoiceNumberExhaustedException(`Failed to generate a unique invoice number after ${InvoiceNumberService_1.MAX_RETRIES} attempts`);
+    }
+    async getNextSequence(prefix) {
+        const maxNumber = await this.invoiceRepo.findMaxInvoiceNumber(prefix);
+        if (!maxNumber) {
+            return 1;
+        }
+        const sequencePart = maxNumber.slice(prefix.length);
+        const parsed = parseInt(sequencePart, 10);
+        if (isNaN(parsed)) {
+            this.logger.warn(`Could not parse sequence from invoice number "${maxNumber}", starting from 1`);
+            return 1;
+        }
+        return parsed + 1;
+    }
+};
+exports.InvoiceNumberService = InvoiceNumberService;
+InvoiceNumberService.MAX_RETRIES = 5;
+exports.InvoiceNumberService = InvoiceNumberService = InvoiceNumberService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(constants_1.INVOICE_REPOSITORY)),
+    __metadata("design:paramtypes", [Object])
+], InvoiceNumberService);
+//# sourceMappingURL=invoice-number.service.js.map

package/dist/services/invoice-number.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-number.service.js","sourceRoot":"","sources":["../../src/services/invoice-number.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAA4D;AAE5D,4CAAkD;AAClD,8CAAgE;AAezD,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAK/B,YAEE,WAAgD;QAA/B,gBAAW,GAAX,WAAW,CAAoB;QANjC,WAAM,GAAG,IAAI,eAAM,CAAC,sBAAoB,CAAC,IAAI,CAAC,CAAC;IAO7D,CAAC;IAcJ,KAAK,CAAC,QAAQ,CAAC,WAAmB;QAChC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,OAAO,IAAI,GAAG,CAAC;QAE9B,KACE,IAAI,OAAO,GAAG,CAAC,EACf,OAAO,GAAG,sBAAoB,CAAC,WAAW,EAC1C,OAAO,EAAE,EACT,CAAC;YACD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YACxD,MAAM,aAAa,GAAG,GAAG,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YAK1E,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,MAAM,IAAI,4CAA+B,CACvC,oDAAoD,sBAAoB,CAAC,WAAW,WAAW,CAChG,CAAC;IACJ,CAAC;IAMO,KAAK,CAAC,eAAe,CAAC,MAAc;QAC1C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAEtE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAE1C,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,iDAAiD,SAAS,oBAAoB,CAC/E,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QAED,OAAO,MAAM,GAAG,CAAC,CAAC;IACpB,CAAC;;AAnEU,oDAAoB;AAGP,gCAAW,GAAG,CAAC,AAAJ,CAAK;+BAH7B,oBAAoB;IADhC,IAAA,mBAAU,GAAE;IAOR,WAAA,IAAA,eAAM,EAAC,8BAAkB,CAAC,CAAA;;GANlB,oBAAoB,CAoEhC"}

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

@@ -0,0 +1,66 @@
+import { type OnModuleInit } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import type { IInvoiceRepository } from '../interfaces/invoice-repository.interface';
+import type { IPaymentConfigRepository } from '../interfaces/payment-config-repository.interface';
+import type { Invoice, InvoiceWithItems, InvoiceLineItem, InvoiceFilter, CreateLineItemData } from '../types';
+import { InvoiceNumberService } from './invoice-number.service';
+import { ETransferService } from './e-transfer.service';
+export interface CreateInvoiceInput {
+    clientDetailsId: string;
+    taxRate?: number;
+    currency?: string;
+    referenceType?: string;
+    referenceId?: string;
+    dueAt?: Date;
+    notes?: string;
+    clientNotes?: string;
+    metadata?: Record<string, unknown> | null;
+    recurringInvoiceId?: string;
+    lineItems?: Array<{
+        description: string;
+        quantity: number;
+        unitPrice: number;
+        sortOrder?: number;
+        isTaxable?: boolean;
+        referenceType?: string;
+        referenceId?: string;
+        metadata?: Record<string, unknown> | null;
+    }>;
+}
+export declare class InvoiceService implements OnModuleInit {
+    private readonly invoiceRepo;
+    private readonly configRepo;
+    private readonly defaultCurrency;
+    private readonly invoiceNumberService;
+    private readonly eTransferService;
+    private readonly moduleRef;
+    private readonly logger;
+    private paymentEmailService;
+    private static readonly MAX_CREATE_RETRIES;
+    constructor(invoiceRepo: IInvoiceRepository, configRepo: IPaymentConfigRepository, defaultCurrency: string, invoiceNumberService: InvoiceNumberService, eTransferService: ETransferService, moduleRef: ModuleRef);
+    onModuleInit(): void;
+    createInvoice(divisionId: string, input: CreateInvoiceInput, createdBy: string): Promise<InvoiceWithItems>;
+    addLineItem(invoiceId: string, input: Omit<CreateLineItemData, 'invoiceId'>): Promise<InvoiceLineItem>;
+    removeLineItem(invoiceId: string, lineItemId: string): Promise<void>;
+    sendInvoice(id: string, eTransferEnabled: boolean, eTransferAutoDeposit: boolean, eTransferConfig?: {
+        eTransferEmail: string;
+        eTransferRecipient: string;
+    }): Promise<Invoice>;
+    voidInvoice(id: string, reason?: string, voidedBy?: string): Promise<Invoice>;
+    updateInvoiceMetadata(invoiceId: string, metadata: Record<string, unknown> | null): Promise<Invoice>;
+    findInvoice(divisionId: string, id: string): Promise<InvoiceWithItems | null>;
+    findInvoices(divisionId: string, filter?: InvoiceFilter, skip?: number, take?: number): Promise<{
+        items: Invoice[];
+        totalCount: number;
+    }>;
+    findInvoicesByClientDetailsIds(clientDetailsIds: string[], skip?: number, take?: number): Promise<{
+        items: Invoice[];
+        totalCount: number;
+    }>;
+    findInvoiceById(id: string): Promise<InvoiceWithItems | null>;
+    findOverdueInvoices(now: Date): Promise<Invoice[]>;
+    markOverdue(ids: string[]): Promise<number>;
+    findByETransferCode(code: string): Promise<Invoice | null>;
+    private recalculateTotals;
+    private resolveTaxRate;
+}