refactor: wip to nestjs

2026-02-19 06:10:31 +00:00 · 2024-12-25 00:43:55 +02:00
parent 336171081e
commit a6932d76f3
249 changed files with 21314 additions and 1616 deletions
--- a/packages/server-nest/src/modules/SaleReceipts/commands/CreateSaleReceipt.service.ts
+++ b/packages/server-nest/src/modules/SaleReceipts/commands/CreateSaleReceipt.service.ts
@@ -0,0 +1,105 @@
+import { Inject, Injectable } from '@nestjs/common';
+import { Knex } from 'knex';
+import {
+  ISaleReceiptCreatedPayload,
+  ISaleReceiptCreatingPayload,
+  ISaleReceiptDTO,
+} from '../types/SaleReceipts.types';
+import { SaleReceiptDTOTransformer } from './SaleReceiptDTOTransformer.service';
+import { SaleReceiptValidators } from './SaleReceiptValidators.service';
+import { ItemsEntriesService } from '@/modules/Items/ItemsEntries.service';
+import { EventEmitter2 } from '@nestjs/event-emitter';
+import { UnitOfWork } from '@/modules/Tenancy/TenancyDB/UnitOfWork.service';
+import { SaleReceipt } from '../models/SaleReceipt';
+import { Customer } from '@/modules/Customers/models/Customer';
+import { events } from '@/common/events/events';
+
+@Injectable()
+export class CreateSaleReceipt {
+  /**
+   * @param {ItemsEntriesService} itemsEntriesService - Items entries service.
+   * @param {EventEmitter2} eventPublisher - Event emitter.
+   * @param {UnitOfWork} uow - Unit of work.
+   * @param {SaleReceiptDTOTransformer} transformer - Sale receipt DTO transformer.
+   * @param {SaleReceiptValidators} validators - Sale receipt validators.
+   * @param {typeof SaleReceipt} saleReceiptModel - Sale receipt model.
+   * @param {typeof Customer} customerModel - Customer model.
+   */
+  constructor(
+    private readonly itemsEntriesService: ItemsEntriesService,
+    private readonly eventEmitter: EventEmitter2,
+    private readonly uow: UnitOfWork,
+    private readonly transformer: SaleReceiptDTOTransformer,
+    private readonly validators: SaleReceiptValidators,
+
+    @Inject(SaleReceipt.name)
+    private readonly saleReceiptModel: typeof SaleReceipt,
+
+    @Inject(Customer.name)
+    private readonly customerModel: typeof Customer,
+  ) {}
+
+  /**
+   * Creates a new sale receipt with associated entries.
+   * @async
+   * @param {ISaleReceiptDTO} saleReceiptDTO
+   * @return {Promise<ISaleReceipt>}
+   */
+  public async createSaleReceipt(
+    saleReceiptDTO: ISaleReceiptDTO,
+    trx?: Knex.Transaction,
+  ): Promise<SaleReceipt> {
+    // Retrieves the payment customer model.
+    const paymentCustomer = await this.customerModel
+      .query()
+      .findById(saleReceiptDTO.customerId)
+      .throwIfNotFound();
+
+    // Transform sale receipt DTO to model.
+    const saleReceiptObj = await this.transformer.transformDTOToModel(
+      saleReceiptDTO,
+      paymentCustomer,
+    );
+    // Validate receipt deposit account existence and type.
+    await this.validators.validateReceiptDepositAccountExistence(
+      saleReceiptDTO.depositAccountId,
+    );
+    // Validate items IDs existence on the storage.
+    await this.itemsEntriesService.validateItemsIdsExistance(
+      saleReceiptDTO.entries,
+    );
+    // Validate the sellable items.
+    await this.itemsEntriesService.validateNonSellableEntriesItems(
+      saleReceiptDTO.entries,
+    );
+    // Validate sale receipt number uniqueness.
+    if (saleReceiptDTO.receiptNumber) {
+      await this.validators.validateReceiptNumberUnique(
+        saleReceiptDTO.receiptNumber,
+      );
+    }
+    // Creates a sale receipt transaction and associated transactions under UOW env.
+    return this.uow.withTransaction(async (trx: Knex.Transaction) => {
+      // Triggers `onSaleReceiptCreating` event.
+      await this.eventEmitter.emitAsync(events.saleReceipt.onCreating, {
+        saleReceiptDTO,
+        trx,
+      } as ISaleReceiptCreatingPayload);
+
+      // Inserts the sale receipt graph to the storage.
+      const saleReceipt = await this.saleReceiptModel.query().upsertGraph({
+        ...saleReceiptObj,
+      });
+
+      // Triggers `onSaleReceiptCreated` event.
+      await this.eventEmitter.emitAsync(events.saleReceipt.onCreated, {
+        saleReceipt,
+        saleReceiptId: saleReceipt.id,
+        saleReceiptDTO,
+        trx,
+      } as ISaleReceiptCreatedPayload);
+
+      return saleReceipt;
+    }, trx);
+  }
+}