@fiado/type-kit 3.650.0 → 3.651.0

package/_test_/unit/loanCredit/creditLifecycleEnums.test.ts

@@ -35,7 +35,7 @@ describe('ContractTypeEnum', () => {
 
 describe.each([
     ['LoanSettlementStatusEnum', LoanSettlementStatusEnum, ['PENDING']],
-    ['LoanAdHocChargeKindEnum', LoanAdHocChargeKindEnum, ['SETTLEMENT', 'RECOVERY', 'PREPAYMENT', 'ADVANCE']],
+    ['LoanAdHocChargeKindEnum', LoanAdHocChargeKindEnum, ['SETTLEMENT', 'RECOVERY', 'PREPAYMENT', 'ADVANCE', 'DUE']],
     ['WrittenOffRecoveryTypeEnum', WrittenOffRecoveryTypeEnum, ['OVERDUE', 'SETTLEMENT']],
     ['LoanRestructureStatusEnum', LoanRestructureStatusEnum, ['PROPOSED', 'APPROVED', 'REJECTED', 'PENDING_REGISTRATION', 'EXECUTED', 'CANCELLED']],
     ['LoanChargeKindEnum', LoanChargeKindEnum, ['INSTALLMENT', 'SETTLEMENT', 'RECOVERY', 'PREPAYMENT', 'ADVANCE']],

package/_test_/unit/loanCredit/customerPaymentDtos.test.ts

@@ -45,6 +45,31 @@ describe('loanCredit — opciones y resultado del pago del cliente', () => {
         expect(options.pendingCharge).toBeUndefined();
     });
 
+    it('en mora la siguiente cuota cobra lo exigible y trae su desglose', () => {
+        const blocked = { available: false, unavailableReason: LoanPaymentOptionUnavailableReasonEnum.CREDIT_NOT_CURRENT };
+        const options: LoanCustomerPaymentOptions = {
+            creditId: 'CR-1',
+            nextInstallment: {
+                available: true,
+                amountCents: 120_136,
+                mode: LoanNextInstallmentModeEnum.COLLECT_DUE,
+                installmentNumber: 4,
+                dueDate: '2026-11-02',
+                installments: [
+                    { installmentNumber: 4, dueDate: '2026-11-02', amountCents: 60_068 },
+                    { installmentNumber: 5, dueDate: '2026-11-09', amountCents: 60_068 },
+                ],
+                overdueCount: 1,
+            },
+            advance: blocked,
+            prepayment: blocked,
+            settlement: blocked,
+        };
+
+        expect(options.nextInstallment.installments?.map((one) => one.amountCents).reduce((a, b) => a + b, 0)).toBe(options.nextInstallment.amountCents);
+        expect(options.nextInstallment.overdueCount).toBe(1);
+    });
+
     it('un cargo en curso se informa con su tipo y su monto', () => {
         const blocked = { available: false, unavailableReason: LoanPaymentOptionUnavailableReasonEnum.PAYMENT_IN_PROGRESS };
         const options: LoanCustomerPaymentOptions = {

package/_test_/unit/retailLoan/paymentContract.test.ts

@@ -82,6 +82,30 @@ describe('CreateMyPaymentRequest', () => {
 });
 
 describe('retailLoan — opciones y respuesta del pago', () => {
+    it('en mora la siguiente cuota trae lo exigible en pesos y cuántas vencieron', () => {
+        const blocked = { available: false, unavailableReason: MyPaymentUnavailableReasonEnum.CREDIT_NOT_CURRENT };
+        const options: MyPaymentOptions = {
+            nextInstallment: {
+                available: true,
+                amount: 1201.36,
+                mode: MyNextInstallmentModeEnum.COLLECT_DUE,
+                installmentNumber: 4,
+                dueDate: '2026-11-02',
+                installments: [
+                    { installmentNumber: 4, dueDate: '2026-11-02', amount: 600.68 },
+                    { installmentNumber: 5, dueDate: '2026-11-09', amount: 600.68 },
+                ],
+                overdueCount: 1,
+            },
+            advance: blocked,
+            prepayment: blocked,
+            settlement: blocked,
+        };
+
+        expect(options.nextInstallment.installments).toHaveLength(2);
+        expect(options.nextInstallment.overdueCount).toBe(1);
+    });
+
     it('la liquidación trae su desglose y su ahorro en pesos', () => {
         const options: MyPaymentOptions = {
             nextInstallment: {

package/bin/loanCredit/dtos/responses/LoanCustomerPaymentOptions.d.ts

@@ -22,7 +22,7 @@ export interface LoanCustomerPaymentOptions {
     pendingCharge?: {
         kind: LoanAdHocChargeKindEnum;
         amountCents: number;
-        /** Solo en un adelanto: las cuotas que cubre. */
+        /** En un adelanto o en lo exigible (`DUE`): las cuotas que cubre. */
         installmentNumbers?: number[];
     };
     nextInstallment: LoanCustomerPaymentOption & {
@@ -30,6 +30,10 @@ export interface LoanCustomerPaymentOptions {
         installmentNumber?: number;
         /** `YYYY-MM-DD`. */
         dueDate?: string;
+        /** Solo con `COLLECT_DUE`: lo exigible (vencidas y la de hoy), de la más vieja a la más nueva; suma `amountCents`. */
+        installments?: LoanCustomerAdvanceInstallment[];
+        /** Solo con `COLLECT_DUE`: cuántas de `installments` ya vencieron. */
+        overdueCount?: number;
     };
     /** Varias cuotas. `installments` trae las `maxInstallments` que se pueden adelantar, en orden. */
     advance: LoanCustomerPaymentOption & {

package/bin/loanCredit/enums/LoanAdHocChargeKindEnum.d.ts

@@ -1,10 +1,12 @@
 /**
  * Tipo de cobro fuera del calendario. Hay un solo cargo pendiente por tipo.
+ * `DUE`: lo exigible (vencidas y la de hoy) que el cliente paga desde la app; sus cuotas se dan de baja en el motor.
  * @enum {string}
  */
 export declare enum LoanAdHocChargeKindEnum {
     SETTLEMENT = "SETTLEMENT",
     RECOVERY = "RECOVERY",
     PREPAYMENT = "PREPAYMENT",
-    ADVANCE = "ADVANCE"
+    ADVANCE = "ADVANCE",
+    DUE = "DUE"
 }

package/bin/loanCredit/enums/LoanAdHocChargeKindEnum.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LoanAdHocChargeKindEnum = void 0;
 /**
  * Tipo de cobro fuera del calendario. Hay un solo cargo pendiente por tipo.
+ * `DUE`: lo exigible (vencidas y la de hoy) que el cliente paga desde la app; sus cuotas se dan de baja en el motor.
  * @enum {string}
  */
 var LoanAdHocChargeKindEnum;
@@ -11,4 +12,5 @@ var LoanAdHocChargeKindEnum;
     LoanAdHocChargeKindEnum["RECOVERY"] = "RECOVERY";
     LoanAdHocChargeKindEnum["PREPAYMENT"] = "PREPAYMENT";
     LoanAdHocChargeKindEnum["ADVANCE"] = "ADVANCE";
+    LoanAdHocChargeKindEnum["DUE"] = "DUE";
 })(LoanAdHocChargeKindEnum || (exports.LoanAdHocChargeKindEnum = LoanAdHocChargeKindEnum = {}));

package/bin/retailLoan/dtos/MyPaymentOptions.d.ts

@@ -20,7 +20,7 @@ export interface MyPaymentOptions {
     pendingPayment?: {
         type: MyPaymentTypeEnum;
         amount: number;
-        /** Solo en varias cuotas: las cuotas que cubre. */
+        /** Solo en varias cuotas o en lo exigible: las cuotas que cubre. */
         installmentNumbers?: number[];
     };
     nextInstallment: MyPaymentOption & {
@@ -28,6 +28,10 @@ export interface MyPaymentOptions {
         installmentNumber?: number;
         /** `YYYY-MM-DD`. */
         dueDate?: string;
+        /** Solo con `COLLECT_DUE`: lo exigible (vencidas y la de hoy), de la más vieja a la más nueva; suma `amount`. */
+        installments?: MyAdvanceInstallment[];
+        /** Solo con `COLLECT_DUE`: cuántas de `installments` ya vencieron. */
+        overdueCount?: number;
     };
     /** Varias cuotas. `installments` trae las `maxInstallments` que se pueden adelantar, en orden. */
     advance: MyPaymentOption & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.650.0",
+  "version": "3.651.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

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

@@ -25,7 +25,7 @@ export interface LoanCustomerPaymentOptions {
     pendingCharge?: {
         kind: LoanAdHocChargeKindEnum;
         amountCents: number;
-        /** Solo en un adelanto: las cuotas que cubre. */
+        /** En un adelanto o en lo exigible (`DUE`): las cuotas que cubre. */
         installmentNumbers?: number[];
     };
     nextInstallment: LoanCustomerPaymentOption & {
@@ -33,6 +33,10 @@ export interface LoanCustomerPaymentOptions {
         installmentNumber?: number;
         /** `YYYY-MM-DD`. */
         dueDate?: string;
+        /** Solo con `COLLECT_DUE`: lo exigible (vencidas y la de hoy), de la más vieja a la más nueva; suma `amountCents`. */
+        installments?: LoanCustomerAdvanceInstallment[];
+        /** Solo con `COLLECT_DUE`: cuántas de `installments` ya vencieron. */
+        overdueCount?: number;
     };
     /** Varias cuotas. `installments` trae las `maxInstallments` que se pueden adelantar, en orden. */
     advance: LoanCustomerPaymentOption & {

package/src/loanCredit/enums/LoanAdHocChargeKindEnum.ts

@@ -1,5 +1,6 @@
 /**
  * Tipo de cobro fuera del calendario. Hay un solo cargo pendiente por tipo.
+ * `DUE`: lo exigible (vencidas y la de hoy) que el cliente paga desde la app; sus cuotas se dan de baja en el motor.
  * @enum {string}
  */
 export enum LoanAdHocChargeKindEnum {
@@ -7,4 +8,5 @@ export enum LoanAdHocChargeKindEnum {
     RECOVERY = 'RECOVERY',
     PREPAYMENT = 'PREPAYMENT',
     ADVANCE = 'ADVANCE',
+    DUE = 'DUE',
 }

package/src/retailLoan/dtos/MyPaymentOptions.ts

@@ -23,7 +23,7 @@ export interface MyPaymentOptions {
     pendingPayment?: {
         type: MyPaymentTypeEnum;
         amount: number;
-        /** Solo en varias cuotas: las cuotas que cubre. */
+        /** Solo en varias cuotas o en lo exigible: las cuotas que cubre. */
         installmentNumbers?: number[];
     };
     nextInstallment: MyPaymentOption & {
@@ -31,6 +31,10 @@ export interface MyPaymentOptions {
         installmentNumber?: number;
         /** `YYYY-MM-DD`. */
         dueDate?: string;
+        /** Solo con `COLLECT_DUE`: lo exigible (vencidas y la de hoy), de la más vieja a la más nueva; suma `amount`. */
+        installments?: MyAdvanceInstallment[];
+        /** Solo con `COLLECT_DUE`: cuántas de `installments` ya vencieron. */
+        overdueCount?: number;
     };
     /** Varias cuotas. `installments` trae las `maxInstallments` que se pueden adelantar, en orden. */
     advance: MyPaymentOption & {