feat(nestjs): migrate to NestJS

2026-02-16 04:40:32 +00:00 · 2025-04-07 11:51:24 +02:00
parent f068218a16
commit 55fcc908ef
3779 changed files with 631 additions and 195332 deletions
--- a/packages/server/src/modules/BankingTransactions/commands/CreateBankTransaction.service.ts
+++ b/packages/server/src/modules/BankingTransactions/commands/CreateBankTransaction.service.ts
@@ -0,0 +1,171 @@
+import { Inject, Injectable } from '@nestjs/common';
+import { pick } from 'lodash';
+import { Knex } from 'knex';
+import * as R from 'ramda';
+import * as composeAsync from 'async/compose';
+import { CASHFLOW_TRANSACTION_TYPE } from '../constants';
+import { transformCashflowTransactionType } from '../utils';
+import { CommandBankTransactionValidator } from './CommandCasflowValidator.service';
+import { BankTransactionAutoIncrement } from './BankTransactionAutoIncrement.service';
+import { UnitOfWork } from '@/modules/Tenancy/TenancyDB/UnitOfWork.service';
+import { EventEmitter2 } from '@nestjs/event-emitter';
+import { BranchTransactionDTOTransformer } from '@/modules/Branches/integrations/BranchTransactionDTOTransform';
+import { events } from '@/common/events/events';
+import { Account } from '@/modules/Accounts/models/Account.model';
+import { BankTransaction } from '../models/BankTransaction';
+import {
+  ICashflowNewCommandDTO,
+  ICommandCashflowCreatedPayload,
+  ICommandCashflowCreatingPayload,
+} from '../types/BankingTransactions.types';
+import { TenantModelProxy } from '@/modules/System/models/TenantBaseModel';
+import { CreateBankTransactionDto } from '../dtos/CreateBankTransaction.dto';
+
+@Injectable()
+export class CreateBankTransactionService {
+  constructor(
+    private validator: CommandBankTransactionValidator,
+    private uow: UnitOfWork,
+    private eventPublisher: EventEmitter2,
+    private autoIncrement: BankTransactionAutoIncrement,
+    private branchDTOTransform: BranchTransactionDTOTransformer,
+
+    @Inject(BankTransaction.name)
+    private bankTransactionModel: TenantModelProxy<typeof BankTransaction>,
+
+    @Inject(Account.name)
+    private accountModel: TenantModelProxy<typeof Account>,
+  ) {}
+
+  /**
+   * Authorize the cashflow creating transaction.
+   * @param {ICashflowNewCommandDTO} newCashflowTransactionDTO
+   */
+  public authorize = async (
+    newCashflowTransactionDTO: ICashflowNewCommandDTO,
+    creditAccount: Account,
+  ) => {
+    const transactionType = transformCashflowTransactionType(
+      newCashflowTransactionDTO.transactionType,
+    );
+    // Validates the cashflow transaction type.
+    this.validator.validateCashflowTransactionType(transactionType);
+
+    // Retrieve accounts of the cashflow lines object.
+    this.validator.validateCreditAccountWithCashflowType(
+      creditAccount,
+      transactionType as CASHFLOW_TRANSACTION_TYPE,
+    );
+  };
+
+  /**
+   * Transformes owner contribution DTO to cashflow transaction.
+   * @param {ICashflowNewCommandDTO} newCashflowTransactionDTO - New transaction DTO.
+   * @returns {ICashflowTransactionInput} - Cashflow transaction object.
+   */
+  private transformCashflowTransactionDTO = async (
+    newCashflowTransactionDTO: CreateBankTransactionDto,
+    cashflowAccount: Account,
+    userId: number,
+  ): Promise<BankTransaction> => {
+    const amount = newCashflowTransactionDTO.amount;
+
+    const fromDTO = pick(newCashflowTransactionDTO, [
+      'date',
+      'referenceNo',
+      'description',
+      'transactionType',
+      'exchangeRate',
+      'cashflowAccountId',
+      'creditAccountId',
+      'branchId',
+      'plaidTransactionId',
+      'uncategorizedTransactionId',
+    ]);
+    // Retreive the next invoice number.
+    const autoNextNumber = await this.autoIncrement.getNextTransactionNumber();
+
+    // Retrieve the transaction number.
+    const transactionNumber =
+      newCashflowTransactionDTO.transactionNumber || autoNextNumber;
+
+    const initialDTO = {
+      amount,
+      ...fromDTO,
+      transactionNumber,
+      currencyCode: cashflowAccount.currencyCode,
+      exchangeRate: fromDTO?.exchangeRate || 1,
+      transactionType: transformCashflowTransactionType(
+        fromDTO.transactionType,
+      ),
+      userId,
+      ...(newCashflowTransactionDTO.publish
+        ? {
+            publishedAt: new Date(),
+          }
+        : {}),
+    };
+    return composeAsync(this.branchDTOTransform.transformDTO<BankTransaction>)(
+      initialDTO,
+    ) as BankTransaction;
+  };
+
+  /**
+   * Owner contribution money in.
+   * @param {ICashflowOwnerContributionDTO} ownerContributionDTO
+   * @param {number} userId - User id.
+   * @returns {Promise<ICashflowTransaction>}
+   */
+  public newCashflowTransaction = async (
+    newTransactionDTO: ICashflowNewCommandDTO,
+    userId?: number,
+  ): Promise<BankTransaction> => {
+    // Retrieves the cashflow account or throw not found error.
+    const cashflowAccount = await this.accountModel()
+      .query()
+      .findById(newTransactionDTO.cashflowAccountId)
+      .throwIfNotFound();
+
+    // Retrieves the credit account or throw not found error.
+    const creditAccount = await this.accountModel()
+      .query()
+      .findById(newTransactionDTO.creditAccountId)
+      .throwIfNotFound();
+
+    // Authorize before creating cashflow transaction.
+    await this.authorize(newTransactionDTO, creditAccount);
+
+    // Transformes owner contribution DTO to cashflow transaction.
+    const cashflowTransactionObj = await this.transformCashflowTransactionDTO(
+      newTransactionDTO,
+      cashflowAccount,
+      userId,
+    );
+    // Creates a new cashflow transaction under UOW envirement.
+    return this.uow.withTransaction(async (trx: Knex.Transaction) => {
+      // Triggers `onCashflowTransactionCreate` event.
+      await this.eventPublisher.emitAsync(
+        events.cashflow.onTransactionCreating,
+        {
+          trx,
+          newTransactionDTO,
+        } as ICommandCashflowCreatingPayload,
+      );
+      // Inserts cashflow owner contribution transaction.
+      const cashflowTransaction = await this.bankTransactionModel()
+        .query(trx)
+        .upsertGraph(cashflowTransactionObj);
+
+      // Triggers `onCashflowTransactionCreated` event.
+      await this.eventPublisher.emitAsync(
+        events.cashflow.onTransactionCreated,
+        {
+          newTransactionDTO,
+          cashflowTransaction,
+          trx,
+        } as ICommandCashflowCreatedPayload,
+      );
+      return cashflowTransaction;
+    });
+  };
+}