@fiado/type-kit 3.610.0 → 3.612.0

package/src/gsfConnector/enums/GsfPaymentKindEnum.ts

@@ -0,0 +1,11 @@
+/** Para qué se aplicó un pago en el sistema de origen. */
+export enum GsfPaymentKindEnum {
+    /** Cuota del periodo. */
+    INSTALLMENT = 'INSTALLMENT',
+    /** Cuotas futuras cubiertas tal cual: la tabla no cambia. */
+    ADVANCE = 'ADVANCE',
+    /** Abono a capital: baja las cuotas restantes. */
+    PREPAYMENT = 'PREPAYMENT',
+    /** Liquidación del crédito. */
+    SETTLEMENT = 'SETTLEMENT',
+}

package/src/gsfConnector/enums/GsfPaymentPeriodicityEnum.ts

@@ -0,0 +1,6 @@
+/** Periodicidad de las cuotas del crédito. */
+export enum GsfPaymentPeriodicityEnum {
+    WEEKLY = 'WEEKLY',
+    BIWEEKLY = 'BIWEEKLY',
+    MONTHLY = 'MONTHLY',
+}

package/src/gsfConnector/index.ts

@@ -0,0 +1,24 @@
+// Enums
+export * from './enums/GsfOperationEnum';
+export * from './enums/GsfPaymentKindEnum';
+export * from './enums/GsfPaymentChannelEnum';
+export * from './enums/GsfPaymentPeriodicityEnum';
+
+// Constants
+export * from './constants/GsfPatterns';
+export * from './constants/GsfPaymentOperations';
+
+// Validators
+export * from './validators/IsGsfCalendarDate';
+export * from './validators/IsGsfPaymentKindForOperation';
+export * from './validators/IsGsfPrepaymentScheduleProvided';
+
+// DTOs del mensaje de GsfSyncQueue.fifo
+export * from './dtos/GsfAddress';
+export * from './dtos/GsfCustomer';
+export * from './dtos/GsfScheduleInstallment';
+export * from './dtos/GsfCreditTerms';
+export * from './dtos/GsfPayment';
+export * from './dtos/GsfExpectedState';
+export * from './dtos/GsfCreateCreditMessage';
+export * from './dtos/GsfPaymentMessage';

package/src/gsfConnector/validators/IsGsfCalendarDate.ts

@@ -0,0 +1,19 @@
+import { ValidatorConstraint, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+import { GSF_DATE_PATTERN } from '../constants/GsfPatterns';
+
+/** `YYYY-MM-DD` de un día que existe: rechaza `2026-02-30` o `2026-13-01`, que el patrón solo no detecta. */
+@ValidatorConstraint({ name: 'isGsfCalendarDate', async: false })
+export class IsGsfCalendarDate implements ValidatorConstraintInterface {
+    validate(value: unknown, _args: ValidationArguments): boolean {
+        if (typeof value !== 'string' || !GSF_DATE_PATTERN.test(value)) {
+            return false;
+        }
+        const [year, month, day] = value.split('-').map(Number);
+        const date = new Date(Date.UTC(year, month - 1, day));
+        return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
+    }
+
+    defaultMessage(args: ValidationArguments): string {
+        return `${args.property} debe ser una fecha YYYY-MM-DD que exista`;
+    }
+}

package/src/gsfConnector/validators/IsGsfPaymentKindForOperation.ts

@@ -0,0 +1,21 @@
+import { ValidatorConstraint, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+import { GSF_PAYMENT_KINDS_BY_OPERATION, GSF_PAYMENT_OPERATIONS, GsfPaymentOperation } from '../constants/GsfPaymentOperations';
+
+/** La clase del pago tiene que corresponder a la operación del mensaje: un abono solo viaja como abono. */
+@ValidatorConstraint({ name: 'isGsfPaymentKindForOperation', async: false })
+export class IsGsfPaymentKindForOperation implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean {
+        const operation = (args.object as { operation?: unknown }).operation;
+        // Sin operación válida el error ya lo marca `operation`. Se compara contra la lista para que
+        // `constructor` o `__proto__` no lean el prototipo del mapa.
+        if (!GSF_PAYMENT_OPERATIONS.includes(operation as GsfPaymentOperation)) {
+            return true;
+        }
+        const kind = (value as { kind?: unknown } | null | undefined)?.kind;
+        return GSF_PAYMENT_KINDS_BY_OPERATION[operation as GsfPaymentOperation].includes(kind as never);
+    }
+
+    defaultMessage(args: ValidationArguments): string {
+        return `${args.property}.kind no corresponde a la operación del mensaje`;
+    }
+}

package/src/gsfConnector/validators/IsGsfPrepaymentScheduleProvided.ts

@@ -0,0 +1,18 @@
+import { ValidatorConstraint, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+import { GsfOperationEnum } from '../enums/GsfOperationEnum';
+
+/** Un abono a capital trae la tabla recalculada: sin ella no hay contra qué comparar la reestructura de GSF. */
+@ValidatorConstraint({ name: 'isGsfPrepaymentScheduleProvided', async: false })
+export class IsGsfPrepaymentScheduleProvided implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean {
+        if ((args.object as { operation?: unknown }).operation !== GsfOperationEnum.APPLY_PREPAYMENT) {
+            return true;
+        }
+        const schedule = (value as { schedule?: unknown } | null | undefined)?.schedule;
+        return Array.isArray(schedule) && schedule.length > 0;
+    }
+
+    defaultMessage(args: ValidationArguments): string {
+        return `${args.property}.schedule es obligatorio en APPLY_PREPAYMENT`;
+    }
+}

package/src/index.ts

@@ -80,6 +80,7 @@ export * as AiEngine from './aiEngine';
 export * as Sentry from './sentry';
 export * as CreditStatements from './credit-statements';
 export * as CirculoCredito from './circuloCredito';
+export * as GsfConnector from './gsfConnector';
 export * as MilestoneBusiness from './milestone-business';
 export * as Mdm from './mdm';
 export * as MessagesConnector from './messagesConnector';

package/src/loanCredit/dtos/responses/LoanCustomerCreditDocument.ts

@@ -0,0 +1,10 @@
+import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+
+/** Documento del ciclo de vida de un crédito, visto por su acreditado. */
+export interface LoanCustomerCreditDocument {
+    documentType: ContractTypeEnum;
+    /** Llave del documento: el paymentId en un comprobante, el periodo `YYYY-MM` en un estado de cuenta. */
+    documentKey: string;
+    /** ISO-8601; `null` mientras el PDF no se haya generado. */
+    generatedAt: string | null;
+}

package/src/loanCredit/dtos/responses/LoanCustomerCreditDocumentUrl.ts

@@ -0,0 +1,10 @@
+import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+
+/** Enlace prefirmado y temporal del PDF de un documento del ciclo de vida. `expiresAt` en ISO-8601. */
+export interface LoanCustomerCreditDocumentUrl {
+    creditId: string;
+    documentType: ContractTypeEnum;
+    documentKey: string;
+    url: string;
+    expiresAt: string;
+}

package/src/loanCredit/index.ts

@@ -51,6 +51,8 @@ export * from './dtos/responses/LoanPaymentListItem';
 export * from './dtos/responses/LoanContractDownloadUrl';
 export * from './dtos/responses/LoanContractPreview';
 export * from './dtos/responses/LoanContractResponse';
+export * from './dtos/responses/LoanCustomerCreditDocument';
+export * from './dtos/responses/LoanCustomerCreditDocumentUrl';
 export * from './dtos/responses/OriginateLoanCreditResponse';
 export * from './dtos/responses/QuoteLoanCreditResponse';
 export * from './dtos/responses/SignLoanCreditResponse';

package/src/retailLoan/dtos/MyDocument.ts

@@ -5,7 +5,8 @@ import { MyDocumentStatusEnum } from '../enums/MyDocumentStatusEnum';
 
 /**
  * Un documento del crédito. `documentRef` sigue la convención del módulo de la app:
- * `doc-contract-<contractId>` para contratos y `doc-stmt-YYYY-MM` para estados de cuenta.
+ * `doc-contract-<contractId>` para contratos, `doc-stmt-YYYY-MM` para estados de cuenta y
+ * `doc-receipt-<paymentId>` para comprobantes de pago.
  */
 export interface MyDocument {
     documentRef: string;

package/src/retailLoan/enums/MyDocumentGroupIdEnum.ts

@@ -2,4 +2,5 @@
 export enum MyDocumentGroupIdEnum {
     CONTRACT = 'contract',
     MONTHLY = 'monthly',
+    PAYMENT_RECEIPTS = 'receipts',
 }

package/src/retailLoan/enums/MyDocumentKindEnum.ts

@@ -1,4 +1,5 @@
 export enum MyDocumentKindEnum {
     CONTRACT = 'CONTRACT',
     MONTHLY_STATEMENT = 'MONTHLY_STATEMENT',
+    PAYMENT_RECEIPT = 'PAYMENT_RECEIPT',
 }