@hed-hog/finance 0.0.300 → 0.0.302

package/src/finance.contract-activated.subscriber.spec.ts

@@ -0,0 +1,392 @@
+/// <reference types="jest" />
+
+import { FinanceContractActivatedSubscriber } from './finance.contract-activated.subscriber';
+
+describe('FinanceContractActivatedSubscriber', () => {
+  let integrationApi: {
+    subscribeMany: jest.Mock;
+    findLinksBySource: jest.Mock;
+    createLink: jest.Mock;
+    publishEvent: jest.Mock;
+  };
+  let financeService: {
+    createAccountsReceivableTitle: jest.Mock;
+    createAccountsPayableTitle: jest.Mock;
+  };
+  let prisma: {
+    financial_title: {
+      findFirst: jest.Mock;
+    };
+    outbox_event: {
+      findMany: jest.Mock;
+    };
+  };
+  let subscriber: FinanceContractActivatedSubscriber;
+
+  beforeEach(() => {
+    integrationApi = {
+      subscribeMany: jest.fn(),
+      findLinksBySource: jest.fn(),
+      createLink: jest.fn().mockResolvedValue(undefined),
+      publishEvent: jest.fn().mockResolvedValue(undefined),
+    };
+
+    financeService = {
+      createAccountsReceivableTitle: jest.fn().mockResolvedValue({
+        id: '91',
+        parcelas: [
+          {
+            id: '501',
+            numero: 1,
+            vencimento: '2025-02-10T00:00:00.000Z',
+            valor: 1000,
+          },
+          {
+            id: '502',
+            numero: 2,
+            vencimento: '2025-03-10T00:00:00.000Z',
+            valor: 1000,
+          },
+          {
+            id: '503',
+            numero: 3,
+            vencimento: '2025-04-10T00:00:00.000Z',
+            valor: 1000,
+          },
+        ],
+      }),
+      createAccountsPayableTitle: jest.fn().mockResolvedValue({
+        id: '190',
+        parcelas: [
+          {
+            id: '801',
+            numero: 1,
+            vencimento: '2025-02-15T00:00:00.000Z',
+            valor: 450,
+          },
+        ],
+      }),
+    };
+
+    prisma = {
+      financial_title: {
+        findFirst: jest.fn().mockResolvedValue(null),
+      },
+      outbox_event: {
+        findMany: jest.fn().mockResolvedValue([]),
+      },
+    };
+
+    subscriber = new FinanceContractActivatedSubscriber(
+      integrationApi as any,
+      financeService as any,
+      prisma as any,
+    );
+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('registers handlers for contract signing and activation', () => {
+    subscriber.onModuleInit();
+
+    const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+
+    expect(subscriptions).toHaveLength(2);
+    expect(
+      subscriptions.map((entry: { eventName: string }) => entry.eventName),
+    ).toEqual(
+      expect.arrayContaining([
+        'operations.contract.signed',
+        'operations.contract.activated',
+      ]),
+    );
+  });
+
+  it('skips duplicate finance generation when a financial title link already exists', async () => {
+    subscriber.onModuleInit();
+
+    const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+    const activated = subscriptions.find(
+      (entry: { eventName: string }) =>
+        entry.eventName === 'operations.contract.activated',
+    );
+
+    integrationApi.findLinksBySource.mockResolvedValue([
+      {
+        targetModule: 'finance',
+        targetEntityType: 'financial_title',
+        targetEntityId: '91',
+      },
+    ]);
+
+    await activated.handler({
+      eventName: 'operations.contract.activated',
+      sourceModule: 'operations',
+      aggregateType: 'contract',
+      aggregateId: '77',
+      payload: {
+        contractId: 77,
+      },
+    });
+
+    expect(financeService.createAccountsReceivableTitle).not.toHaveBeenCalled();
+    expect(financeService.createAccountsPayableTitle).not.toHaveBeenCalled();
+    expect(integrationApi.createLink).not.toHaveBeenCalled();
+    expect(integrationApi.publishEvent).not.toHaveBeenCalled();
+  });
+
+  it('recovers an existing title when the finance record already exists but the integration link is missing', async () => {
+    subscriber.onModuleInit();
+
+    const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+    const activated = subscriptions.find(
+      (entry: { eventName: string }) =>
+        entry.eventName === 'operations.contract.activated',
+    );
+
+    integrationApi.findLinksBySource.mockResolvedValue([]);
+    prisma.financial_title.findFirst.mockResolvedValue({
+      id: 91,
+      financial_installment: [
+        {
+          id: 501,
+          installment_number: 1,
+          due_date: new Date('2025-02-10T00:00:00.000Z'),
+          amount_cents: 100000,
+        },
+      ],
+    });
+
+    await activated.handler({
+      eventName: 'operations.contract.activated',
+      sourceModule: 'operations',
+      aggregateType: 'contract',
+      aggregateId: '77',
+      payload: {
+        contractId: 77,
+        locale: 'en',
+        correlationId: 'contract:77',
+        activatedByUserId: 9,
+        contract: {
+          code: 'CTR-077',
+          name: 'Recovered Contract',
+          contractCategory: 'client',
+          contractType: 'service_agreement',
+          effectiveDate: '2025-02-01',
+          financialTerms: [
+            {
+              label: 'Recovered installment',
+              amount: 1000,
+              recurrence: 'one_time',
+            },
+          ],
+        },
+        receivable: {
+          personId: 5,
+          documentNumber: 'CTR-077',
+          description: 'Recovered Contract',
+        },
+      },
+    });
+
+    expect(financeService.createAccountsReceivableTitle).not.toHaveBeenCalled();
+    expect(integrationApi.createLink).toHaveBeenCalledWith(
+      expect.objectContaining({
+        targetEntityType: 'financial_title',
+        targetEntityId: '91',
+      }),
+    );
+  });
+
+  it('creates receivable titles, installment links and a finance success event', async () => {
+    subscriber.onModuleInit();
+
+    const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+    const signed = subscriptions.find(
+      (entry: { eventName: string }) =>
+        entry.eventName === 'operations.contract.signed',
+    );
+
+    integrationApi.findLinksBySource.mockResolvedValue([]);
+
+    await signed.handler({
+      eventName: 'operations.contract.signed',
+      sourceModule: 'operations',
+      aggregateType: 'contract',
+      aggregateId: '77',
+      payload: {
+        contractId: 77,
+        proposalId: 12,
+        locale: 'en',
+        correlationId: 'contract:77',
+        signedByUserId: 9,
+        contract: {
+          code: 'CTR-077',
+          name: 'Support Contract',
+          contractCategory: 'client',
+          contractType: 'service_agreement',
+          startDate: '2025-02-01',
+          endDate: '2025-04-30',
+          signedAt: '2025-02-01',
+          effectiveDate: '2025-02-01',
+          financialTerms: [
+            {
+              label: 'Monthly retainer',
+              amount: 1000,
+              recurrence: 'monthly',
+              dueDay: 10,
+            },
+          ],
+        },
+        receivable: {
+          personId: 5,
+          documentNumber: 'CTR-077',
+          description: 'Support Contract',
+        },
+      },
+    });
+
+    expect(financeService.createAccountsReceivableTitle).toHaveBeenCalledWith(
+      expect.objectContaining({
+        person_id: 5,
+        document_number: 'CTR-077',
+        total_amount: 3000,
+        installments: [
+          expect.objectContaining({
+            installment_number: 1,
+            due_date: '2025-02-10',
+            amount: 1000,
+          }),
+          expect.objectContaining({
+            installment_number: 2,
+            due_date: '2025-03-10',
+            amount: 1000,
+          }),
+          expect.objectContaining({
+            installment_number: 3,
+            due_date: '2025-04-10',
+            amount: 1000,
+          }),
+        ],
+      }),
+      'en',
+      9,
+    );
+    expect(financeService.createAccountsPayableTitle).not.toHaveBeenCalled();
+
+    expect(integrationApi.createLink).toHaveBeenCalledTimes(4);
+    expect(integrationApi.createLink).toHaveBeenNthCalledWith(
+      1,
+      expect.objectContaining({
+        sourceModule: 'operations',
+        sourceEntityType: 'contract',
+        sourceEntityId: '77',
+        targetModule: 'finance',
+        targetEntityType: 'financial_title',
+        targetEntityId: '91',
+        metadata: expect.objectContaining({
+          eventName: 'operations.contract.signed',
+          titleType: 'receivable',
+          source_module: 'operations',
+          source_entity: 'contract',
+          source_id: '77',
+          installmentCount: 3,
+        }),
+      }),
+    );
+    expect(integrationApi.createLink).toHaveBeenNthCalledWith(
+      2,
+      expect.objectContaining({
+        targetEntityType: 'financial_installment',
+        targetEntityId: '501',
+      }),
+    );
+    expect(integrationApi.createLink).toHaveBeenNthCalledWith(
+      3,
+      expect.objectContaining({
+        targetEntityType: 'financial_installment',
+        targetEntityId: '502',
+      }),
+    );
+    expect(integrationApi.createLink).toHaveBeenNthCalledWith(
+      4,
+      expect.objectContaining({
+        targetEntityType: 'financial_installment',
+        targetEntityId: '503',
+      }),
+    );
+
+    expect(integrationApi.publishEvent).toHaveBeenCalledWith(
+      expect.objectContaining({
+        eventName: 'finance.receivable.created_from_contract',
+        sourceModule: 'finance',
+        aggregateType: 'financial_title',
+        aggregateId: '91',
+        payload: expect.objectContaining({
+          proposalId: 12,
+          source_module: 'operations',
+          source_entity: 'contract',
+          source_id: '77',
+          triggerEvent: 'operations.contract.signed',
+          financialTitle: expect.objectContaining({
+            id: '91',
+            titleType: 'receivable',
+            installmentCount: 3,
+          }),
+        }),
+      }),
+    );
+  });
+
+  it('routes supplier contracts to accounts payable', async () => {
+    subscriber.onModuleInit();
+
+    const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+    const activated = subscriptions.find(
+      (entry: { eventName: string }) =>
+        entry.eventName === 'operations.contract.activated',
+    );
+
+    integrationApi.findLinksBySource.mockResolvedValue([]);
+
+    await activated.handler({
+      eventName: 'operations.contract.activated',
+      sourceModule: 'operations',
+      aggregateType: 'contract',
+      aggregateId: '88',
+      payload: {
+        contractId: 88,
+        locale: 'en',
+        activatedByUserId: 11,
+        contract: {
+          code: 'CTR-088',
+          contractCategory: 'supplier',
+          contractType: 'service_agreement',
+          effectiveDate: '2025-02-15',
+        },
+        receivable: {
+          personId: 14,
+          totalAmount: 450,
+          documentNumber: 'CTR-088',
+          description: 'Supplier onboarding',
+        },
+      },
+    });
+
+    expect(financeService.createAccountsPayableTitle).toHaveBeenCalledWith(
+      expect.objectContaining({
+        person_id: 14,
+        total_amount: 450,
+      }),
+      'en',
+      11,
+    );
+    expect(integrationApi.publishEvent).toHaveBeenCalledWith(
+      expect.objectContaining({
+        eventName: 'finance.payable.created_from_contract',
+      }),
+    );
+  });
+});