@fiado/type-kit 3.650.0 → 3.652.0

package/_test_/unit/loanConfig/recentParameterChanges.test.ts

@@ -22,7 +22,12 @@ const validateQuery = (query: object) => {
 describe('ParameterTypeEnum', () => {
     it('incluye FEATURE_FLAG como el paramType 15', () => {
         expect(ParameterTypeEnum.FEATURE_FLAG).toBe('FEATURE_FLAG');
-        expect(Object.values(ParameterTypeEnum)).toHaveLength(15);
+        expect(Object.values(ParameterTypeEnum).indexOf(ParameterTypeEnum.FEATURE_FLAG)).toBe(14);
+    });
+
+    it('incluye LEGAL como el paramType 16', () => {
+        expect(ParameterTypeEnum.LEGAL).toBe('LEGAL');
+        expect(Object.values(ParameterTypeEnum)).toHaveLength(16);
     });
 });
 

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/contract.test.ts

@@ -7,11 +7,13 @@ import {
     MyDocumentStatusEnum,
     MyInstallment,
     MyInstallmentDisplayStatusEnum,
+    MyLegalDocument,
     MyPaymentFrequencyEnum,
     MyPaymentMethodEnum,
     MyPaymentPage,
 } from '../../../src/retailLoan/index';
 import { LoanCreditStatusEnum, LoanInstallmentStatusEnum } from '../../../src/loanCredit/index';
+import { ParameterTypeEnum } from '../../../src/loanConfig/index';
 import { CollectionResultStatus } from '../../../src/collection/enums/CollectionResultStatus';
 
 describe('retailLoan — contrato app ↔ retail-loan-business (I1)', () => {
@@ -25,6 +27,17 @@ describe('retailLoan — contrato app ↔ retail-loan-business (I1)', () => {
         expect(MyDocumentKindEnum.PAYMENT_RECEIPT).toBe('PAYMENT_RECEIPT');
     });
 
+    it('la lista de Legal sale de un parámetro LEGAL de loan-config', () => {
+        const doc: MyLegalDocument = {
+            id: 'privacy-notice',
+            title: 'Aviso de Privacidad SureKeep',
+            revisedAt: '2026-10-17',
+            url: 'https://develop.d1nwd14q1nl8b0.amplifyapp.com/docs/aviso-privacidad-surekeep.pdf',
+        };
+        expect(ParameterTypeEnum.LEGAL).toBe('LEGAL');
+        expect(doc.revisedAt).toBe('2026-10-17');
+    });
+
     it('el detalle del crédito va en pesos y con frecuencia semanal', () => {
         const detail: MyCreditDetail = {
             creditId: 'CR-1',

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/loanConfig/enums/ParameterTypeEnum.d.ts

@@ -1,5 +1,5 @@
 /**
- * Sub-tipos de parámetro operativo del SOFOM (M6 §8 = 13 + SCORING de §5 + FEATURE_FLAG = 15).
+ * Sub-tipos de parámetro operativo del SOFOM (M6 §8 = 13 + SCORING de §5 + FEATURE_FLAG + LEGAL = 16).
  * @enum {string}
  */
 export declare enum ParameterTypeEnum {
@@ -17,5 +17,7 @@ export declare enum ParameterTypeEnum {
     WIZARD = "WIZARD",
     INTEGRATIONS = "INTEGRATIONS",
     SCORING = "SCORING",
-    FEATURE_FLAG = "FEATURE_FLAG"
+    FEATURE_FLAG = "FEATURE_FLAG",
+    /** Documentos que la App muestra en la sección Legal del módulo. */
+    LEGAL = "LEGAL"
 }

package/bin/loanConfig/enums/ParameterTypeEnum.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ParameterTypeEnum = void 0;
 /**
- * Sub-tipos de parámetro operativo del SOFOM (M6 §8 = 13 + SCORING de §5 + FEATURE_FLAG = 15).
+ * Sub-tipos de parámetro operativo del SOFOM (M6 §8 = 13 + SCORING de §5 + FEATURE_FLAG + LEGAL = 16).
  * @enum {string}
  */
 var ParameterTypeEnum;
@@ -22,4 +22,6 @@ var ParameterTypeEnum;
     ParameterTypeEnum["INTEGRATIONS"] = "INTEGRATIONS";
     ParameterTypeEnum["SCORING"] = "SCORING";
     ParameterTypeEnum["FEATURE_FLAG"] = "FEATURE_FLAG";
+    /** Documentos que la App muestra en la sección Legal del módulo. */
+    ParameterTypeEnum["LEGAL"] = "LEGAL";
 })(ParameterTypeEnum || (exports.ParameterTypeEnum = ParameterTypeEnum = {}));

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/MyLegalDocument.d.ts

@@ -0,0 +1,9 @@
+/** Documento de la sección Legal del módulo: PDF estático público. */
+export interface MyLegalDocument {
+    id: string;
+    title: string;
+    /** Fecha de última revisión, `AAAA-MM-DD`. */
+    revisedAt: string;
+    /** URL pública del PDF. */
+    url: string;
+}

package/bin/retailLoan/dtos/MyLegalDocument.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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/bin/retailLoan/index.d.ts

@@ -10,6 +10,7 @@ export * from './dtos/MyInstallment';
 export * from './dtos/MyPayment';
 export * from './dtos/MyDocument';
 export * from './dtos/MyDocumentUrl';
+export * from './dtos/MyLegalDocument';
 export * from './enums/MyPaymentTypeEnum';
 export * from './enums/MyNextInstallmentModeEnum';
 export * from './enums/MyPaymentUnavailableReasonEnum';

package/bin/retailLoan/index.js

@@ -28,6 +28,7 @@ __exportStar(require("./dtos/MyInstallment"), exports);
 __exportStar(require("./dtos/MyPayment"), exports);
 __exportStar(require("./dtos/MyDocument"), exports);
 __exportStar(require("./dtos/MyDocumentUrl"), exports);
+__exportStar(require("./dtos/MyLegalDocument"), exports);
 // Pagos
 __exportStar(require("./enums/MyPaymentTypeEnum"), exports);
 __exportStar(require("./enums/MyNextInstallmentModeEnum"), exports);

package/package.json

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

package/src/loanConfig/enums/ParameterTypeEnum.ts

@@ -1,5 +1,5 @@
 /**
- * Sub-tipos de parámetro operativo del SOFOM (M6 §8 = 13 + SCORING de §5 + FEATURE_FLAG = 15).
+ * Sub-tipos de parámetro operativo del SOFOM (M6 §8 = 13 + SCORING de §5 + FEATURE_FLAG + LEGAL = 16).
  * @enum {string}
  */
 export enum ParameterTypeEnum {
@@ -18,4 +18,6 @@ export enum ParameterTypeEnum {
     INTEGRATIONS = 'INTEGRATIONS',
     SCORING = 'SCORING',
     FEATURE_FLAG = 'FEATURE_FLAG',
+    /** Documentos que la App muestra en la sección Legal del módulo. */
+    LEGAL = 'LEGAL',
 }

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/MyLegalDocument.ts

@@ -0,0 +1,9 @@
+/** Documento de la sección Legal del módulo: PDF estático público. */
+export interface MyLegalDocument {
+    id: string;
+    title: string;
+    /** Fecha de última revisión, `AAAA-MM-DD`. */
+    revisedAt: string;
+    /** URL pública del PDF. */
+    url: string;
+}

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 & {

package/src/retailLoan/index.ts

@@ -13,6 +13,7 @@ export * from './dtos/MyInstallment';
 export * from './dtos/MyPayment';
 export * from './dtos/MyDocument';
 export * from './dtos/MyDocumentUrl';
+export * from './dtos/MyLegalDocument';
 
 // Pagos
 export * from './enums/MyPaymentTypeEnum';