@fiado/type-kit 3.436.0 → 3.438.0

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

@@ -0,0 +1,91 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { ParameterTypeEnum } from '../../../src/loanConfig/enums/ParameterTypeEnum';
+import type { ParameterAuditEntry } from '../../../src/loanConfig/dtos/responses/ParameterAuditEntry';
+import type {
+    ListRecentParameterChangesResponse,
+    RecentParameterChange,
+} from '../../../src/loanConfig/dtos/responses/ListRecentParameterChangesResponse';
+import { ListRecentParameterChangesRequest } from '../../../src/loanConfig/dtos/requests/ListRecentParameterChangesRequest';
+import {
+    RECENT_PARAMETER_CHANGES_MAX_DAYS,
+    RECENT_PARAMETER_CHANGES_MAX_LIMIT,
+} from '../../../src/loanConfig/constants/RecentParameterChangesLimits';
+
+/** Igual que `validateRequest` del lambda: sin `@Expose` la propiedad se descarta. */
+const validateQuery = (query: object) => {
+    const dto = plainToInstance(ListRecentParameterChangesRequest, query, { excludeExtraneousValues: true });
+    return validate(dto, { whitelist: true, forbidNonWhitelisted: true }).then((errors) => ({ dto, errors }));
+};
+
+describe('ParameterTypeEnum', () => {
+    it('incluye FEATURE_FLAG como el paramType 15', () => {
+        expect(ParameterTypeEnum.FEATURE_FLAG).toBe('FEATURE_FLAG');
+        expect(Object.values(ParameterTypeEnum)).toHaveLength(15);
+    });
+});
+
+describe('ParameterAuditEntry', () => {
+    it('describe una fila del histórico sin ip', () => {
+        const entry: ParameterAuditEntry = {
+            at: '2026-09-15T18:30:00.000Z',
+            action: 'UPDATE',
+            fieldChanged: 'value',
+            oldValue: 'false',
+            newValue: 'true',
+            performedBy: 'sub-123',
+            reason: 'Piloto de bloqueo en tienda',
+        };
+        expect(Object.keys(entry)).not.toContain('ip');
+    });
+});
+
+describe('ListRecentParameterChangesRequest', () => {
+    it('acepta el query vacío: los defaults los pone el lambda', async () => {
+        const { dto, errors } = await validateQuery({});
+        expect(errors).toEqual([]);
+        expect(dto.days).toBeUndefined();
+        expect(dto.limit).toBeUndefined();
+    });
+
+    it('convierte days y limit que llegan como texto', async () => {
+        const { dto, errors } = await validateQuery({ days: '30', limit: '50' });
+        expect(errors).toEqual([]);
+        expect(dto.days).toBe(30);
+        expect(dto.limit).toBe(50);
+    });
+
+    it('los topes son 30 días y 50 filas', () => {
+        expect(RECENT_PARAMETER_CHANGES_MAX_DAYS).toBe(30);
+        expect(RECENT_PARAMETER_CHANGES_MAX_LIMIT).toBe(50);
+    });
+
+    it.each([['31'], ['0'], ['1.5'], ['abc']])('rechaza days=%s', async (days) => {
+        const { errors } = await validateQuery({ days });
+        expect(errors.some((error) => error.property === 'days')).toBe(true);
+    });
+
+    it.each([['51'], ['0'], ['-1'], ['x']])('rechaza limit=%s', async (limit) => {
+        const { errors } = await validateQuery({ limit });
+        expect(errors.some((error) => error.property === 'limit')).toBe(true);
+    });
+});
+
+describe('ListRecentParameterChangesResponse', () => {
+    it('cada cambio es una entrada del histórico más su paramType y key', () => {
+        const item: RecentParameterChange = {
+            at: '2026-09-15T18:30:00.000Z',
+            action: 'UPDATE',
+            fieldChanged: 'value',
+            oldValue: '300',
+            newValue: '240',
+            performedBy: 'sub-123',
+            reason: 'Ajuste del OTP del wizard',
+            paramType: ParameterTypeEnum.WIZARD,
+            key: 'otp_timeout_seconds',
+        };
+        const response: ListRecentParameterChangesResponse = { items: [item], totalInWindow: 7 };
+        expect(response.totalInWindow).toBeGreaterThanOrEqual(response.items.length);
+    });
+});

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

@@ -41,7 +41,14 @@ describe.each([
     [
         'PaymentReviewReasonEnum',
         PaymentReviewReasonEnum,
-        ['OVERPAYMENT', 'INSTALLMENT_CLOSED', 'CREDIT_NOT_COLLECTIBLE', 'LEGACY_INSTALLMENT_WITH_PAYMENT', 'UNCAPTURED_HOLD'],
+        [
+            'OVERPAYMENT',
+            'INSTALLMENT_CLOSED',
+            'CREDIT_NOT_COLLECTIBLE',
+            'LEGACY_INSTALLMENT_WITH_PAYMENT',
+            'UNCAPTURED_HOLD',
+            'AD_HOC_CHARGE_INCOMPLETE',
+        ],
     ],
     ['PaymentReviewActionEnum', PaymentReviewActionEnum, ['APPLY', 'REFUND', 'RECONCILE']],
     ['RefundDestinationEnum', RefundDestinationEnum, ['CUSTOMER_ACCOUNT', 'PCF_CLABE']],

package/_test_/unit/loanCredit/dtos/creditLifecycleRequests.test.ts

@@ -60,8 +60,12 @@ describe('BackofficeWriteOffCreditRequest', () => {
         expect(await errorPaths(BackofficeWriteOffCreditRequest, body)).toEqual([]);
     });
 
-    it('rechaza un motivo vacío y una confirmación que no es booleana', async () => {
-        const body = { reason: '', confirmations: { recoveryResourcesExhausted: 'yes' } };
+    it('deja pasar el motivo vacío para que el lambda responda WRITE_OFF_REASON_REQUIRED', async () => {
+        expect(await errorPaths(BackofficeWriteOffCreditRequest, { reason: '' })).toEqual([]);
+    });
+
+    it('rechaza un motivo que no es texto y una confirmación que no es booleana', async () => {
+        const body = { reason: 42, confirmations: { recoveryResourcesExhausted: 'yes' } };
 
         expect(await errorPaths(BackofficeWriteOffCreditRequest, body)).toEqual(
             expect.arrayContaining(['reason', 'confirmations.recoveryResourcesExhausted']),

package/bin/loanConfig/constants/RecentParameterChangesLimits.d.ts

@@ -0,0 +1,4 @@
+/** Días máximos que cubre el feed de cambios recientes, hoy incluido. */
+export declare const RECENT_PARAMETER_CHANGES_MAX_DAYS = 30;
+/** Filas máximas que devuelve el feed en una llamada. */
+export declare const RECENT_PARAMETER_CHANGES_MAX_LIMIT = 50;

package/bin/loanConfig/constants/RecentParameterChangesLimits.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECENT_PARAMETER_CHANGES_MAX_LIMIT = exports.RECENT_PARAMETER_CHANGES_MAX_DAYS = void 0;
+/** Días máximos que cubre el feed de cambios recientes, hoy incluido. */
+exports.RECENT_PARAMETER_CHANGES_MAX_DAYS = 30;
+/** Filas máximas que devuelve el feed en una llamada. */
+exports.RECENT_PARAMETER_CHANGES_MAX_LIMIT = 50;

package/bin/loanConfig/dtos/requests/ListRecentParameterChangesRequest.d.ts

@@ -0,0 +1,6 @@
+/** Query de `GET /public/parameters/audit/recent`. Sin valores, el lambda pone sus defaults. */
+export declare class ListRecentParameterChangesRequest {
+    /** Días hacia atrás que cubre la ventana, hoy incluido (días UTC). */
+    days?: number;
+    limit?: number;
+}

package/bin/loanConfig/dtos/requests/ListRecentParameterChangesRequest.js

@@ -0,0 +1,37 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListRecentParameterChangesRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const RecentParameterChangesLimits_1 = require("../../constants/RecentParameterChangesLimits");
+/** Query de `GET /public/parameters/audit/recent`. Sin valores, el lambda pone sus defaults. */
+class ListRecentParameterChangesRequest {
+}
+exports.ListRecentParameterChangesRequest = ListRecentParameterChangesRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(RecentParameterChangesLimits_1.RECENT_PARAMETER_CHANGES_MAX_DAYS),
+    __metadata("design:type", Number)
+], ListRecentParameterChangesRequest.prototype, "days", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(RecentParameterChangesLimits_1.RECENT_PARAMETER_CHANGES_MAX_LIMIT),
+    __metadata("design:type", Number)
+], ListRecentParameterChangesRequest.prototype, "limit", void 0);

package/bin/loanConfig/dtos/responses/ListRecentParameterChangesResponse.d.ts

@@ -0,0 +1,12 @@
+import { ParameterTypeEnum } from '../../enums/ParameterTypeEnum';
+import { ParameterAuditEntry } from './ParameterAuditEntry';
+/** Un cambio del feed: la entrada del histórico más la llave del parámetro que cambió. */
+export interface RecentParameterChange extends ParameterAuditEntry {
+    paramType: ParameterTypeEnum;
+    key: string;
+}
+/** Respuesta de `GET /public/parameters/audit/recent`. `totalInWindow` cuenta toda la ventana. */
+export interface ListRecentParameterChangesResponse {
+    items: RecentParameterChange[];
+    totalInWindow: number;
+}

package/bin/loanConfig/dtos/responses/ListRecentParameterChangesResponse.js

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

package/bin/loanConfig/dtos/responses/ParameterAuditEntry.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Una fila del histórico de un parámetro. Sin `ip`; `performedBy` puede traer el correo del actor
+ * y solo lo lee quien tiene `loan.parameter.audit`.
+ */
+export interface ParameterAuditEntry {
+    /** ISO del cambio. */
+    at: string;
+    action: 'CREATE' | 'UPDATE' | 'DELETE' | 'STATUS_CHANGE';
+    fieldChanged: string | null;
+    oldValue: string | null;
+    newValue: string | null;
+    performedBy: string;
+    reason: string | null;
+}

package/bin/loanConfig/dtos/responses/ParameterAuditEntry.js

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

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 = 14).
+ * Sub-tipos de parámetro operativo del SOFOM (M6 §8 = 13 + SCORING de §5 + FEATURE_FLAG = 15).
  * @enum {string}
  */
 export declare enum ParameterTypeEnum {
@@ -16,5 +16,6 @@ export declare enum ParameterTypeEnum {
     CROSS_BORDER = "CROSS_BORDER",
     WIZARD = "WIZARD",
     INTEGRATIONS = "INTEGRATIONS",
-    SCORING = "SCORING"
+    SCORING = "SCORING",
+    FEATURE_FLAG = "FEATURE_FLAG"
 }

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 = 14).
+ * Sub-tipos de parámetro operativo del SOFOM (M6 §8 = 13 + SCORING de §5 + FEATURE_FLAG = 15).
  * @enum {string}
  */
 var ParameterTypeEnum;
@@ -21,4 +21,5 @@ var ParameterTypeEnum;
     ParameterTypeEnum["WIZARD"] = "WIZARD";
     ParameterTypeEnum["INTEGRATIONS"] = "INTEGRATIONS";
     ParameterTypeEnum["SCORING"] = "SCORING";
+    ParameterTypeEnum["FEATURE_FLAG"] = "FEATURE_FLAG";
 })(ParameterTypeEnum || (exports.ParameterTypeEnum = ParameterTypeEnum = {}));

package/bin/loanConfig/index.d.ts

@@ -1,7 +1,11 @@
 export * from './enums/ParameterTypeEnum';
 export * from './enums/ParameterValueTypeEnum';
+export * from './constants/RecentParameterChangesLimits';
 export * from './dtos/Parameter';
 export * from './dtos/requests/UpdateParameterRequest';
 export * from './dtos/requests/BulkUpdateParametersRequest';
 export * from './dtos/requests/BulkGetParametersRequest';
+export * from './dtos/requests/ListRecentParameterChangesRequest';
 export * from './dtos/responses/ParameterResponse';
+export * from './dtos/responses/ParameterAuditEntry';
+export * from './dtos/responses/ListRecentParameterChangesResponse';

package/bin/loanConfig/index.js

@@ -16,11 +16,16 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./enums/ParameterTypeEnum"), exports);
 __exportStar(require("./enums/ParameterValueTypeEnum"), exports);
+// Constants
+__exportStar(require("./constants/RecentParameterChangesLimits"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/Parameter"), exports);
 // Request DTOs
 __exportStar(require("./dtos/requests/UpdateParameterRequest"), exports);
 __exportStar(require("./dtos/requests/BulkUpdateParametersRequest"), exports);
 __exportStar(require("./dtos/requests/BulkGetParametersRequest"), exports);
+__exportStar(require("./dtos/requests/ListRecentParameterChangesRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/ParameterResponse"), exports);
+__exportStar(require("./dtos/responses/ParameterAuditEntry"), exports);
+__exportStar(require("./dtos/responses/ListRecentParameterChangesResponse"), exports);

package/bin/loanCredit/dtos/requests/BackofficeWriteOffCreditRequest.js

@@ -21,7 +21,6 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MinLength)(1),
     __metadata("design:type", String)
 ], BackofficeWriteOffCreditRequest.prototype, "reason", void 0);
 __decorate([

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

@@ -12,5 +12,7 @@ export declare enum PaymentReviewReasonEnum {
     /** Cuota con abonos previos sin desglose. */
     LEGACY_INSTALLMENT_WITH_PAYMENT = "LEGACY_INSTALLMENT_WITH_PAYMENT",
     /** Lo retenido sin capturar. */
-    UNCAPTURED_HOLD = "UNCAPTURED_HOLD"
+    UNCAPTURED_HOLD = "UNCAPTURED_HOLD",
+    /** Cobro ad hoc PREPAYMENT, ADVANCE o RECOVERY que no fue completo. */
+    AD_HOC_CHARGE_INCOMPLETE = "AD_HOC_CHARGE_INCOMPLETE"
 }

package/bin/loanCredit/enums/PaymentReviewReasonEnum.js

@@ -17,4 +17,6 @@ var PaymentReviewReasonEnum;
     PaymentReviewReasonEnum["LEGACY_INSTALLMENT_WITH_PAYMENT"] = "LEGACY_INSTALLMENT_WITH_PAYMENT";
     /** Lo retenido sin capturar. */
     PaymentReviewReasonEnum["UNCAPTURED_HOLD"] = "UNCAPTURED_HOLD";
+    /** Cobro ad hoc PREPAYMENT, ADVANCE o RECOVERY que no fue completo. */
+    PaymentReviewReasonEnum["AD_HOC_CHARGE_INCOMPLETE"] = "AD_HOC_CHARGE_INCOMPLETE";
 })(PaymentReviewReasonEnum || (exports.PaymentReviewReasonEnum = PaymentReviewReasonEnum = {}));

package/package.json

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

package/src/loanConfig/constants/RecentParameterChangesLimits.ts

@@ -0,0 +1,5 @@
+/** Días máximos que cubre el feed de cambios recientes, hoy incluido. */
+export const RECENT_PARAMETER_CHANGES_MAX_DAYS = 30;
+
+/** Filas máximas que devuelve el feed en una llamada. */
+export const RECENT_PARAMETER_CHANGES_MAX_LIMIT = 50;

package/src/loanConfig/dtos/requests/ListRecentParameterChangesRequest.ts

@@ -0,0 +1,26 @@
+import { Expose, Type } from 'class-transformer';
+import { IsInt, IsOptional, Max, Min } from 'class-validator';
+import {
+    RECENT_PARAMETER_CHANGES_MAX_DAYS,
+    RECENT_PARAMETER_CHANGES_MAX_LIMIT,
+} from '../../constants/RecentParameterChangesLimits';
+
+/** Query de `GET /public/parameters/audit/recent`. Sin valores, el lambda pone sus defaults. */
+export class ListRecentParameterChangesRequest {
+    /** Días hacia atrás que cubre la ventana, hoy incluido (días UTC). */
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @Min(1)
+    @Max(RECENT_PARAMETER_CHANGES_MAX_DAYS)
+    days?: number;
+
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @Min(1)
+    @Max(RECENT_PARAMETER_CHANGES_MAX_LIMIT)
+    limit?: number;
+}

package/src/loanConfig/dtos/responses/ListRecentParameterChangesResponse.ts

@@ -0,0 +1,14 @@
+import { ParameterTypeEnum } from '../../enums/ParameterTypeEnum';
+import { ParameterAuditEntry } from './ParameterAuditEntry';
+
+/** Un cambio del feed: la entrada del histórico más la llave del parámetro que cambió. */
+export interface RecentParameterChange extends ParameterAuditEntry {
+    paramType: ParameterTypeEnum;
+    key: string;
+}
+
+/** Respuesta de `GET /public/parameters/audit/recent`. `totalInWindow` cuenta toda la ventana. */
+export interface ListRecentParameterChangesResponse {
+    items: RecentParameterChange[];
+    totalInWindow: number;
+}

package/src/loanConfig/dtos/responses/ParameterAuditEntry.ts

@@ -0,0 +1,14 @@
+/**
+ * Una fila del histórico de un parámetro. Sin `ip`; `performedBy` puede traer el correo del actor
+ * y solo lo lee quien tiene `loan.parameter.audit`.
+ */
+export interface ParameterAuditEntry {
+    /** ISO del cambio. */
+    at: string;
+    action: 'CREATE' | 'UPDATE' | 'DELETE' | 'STATUS_CHANGE';
+    fieldChanged: string | null;
+    oldValue: string | null;
+    newValue: string | null;
+    performedBy: string;
+    reason: string | null;
+}

package/src/loanConfig/enums/ParameterTypeEnum.ts

@@ -1,5 +1,5 @@
 /**
- * Sub-tipos de parámetro operativo del SOFOM (M6 §8 = 13 + SCORING de §5 = 14).
+ * Sub-tipos de parámetro operativo del SOFOM (M6 §8 = 13 + SCORING de §5 + FEATURE_FLAG = 15).
  * @enum {string}
  */
 export enum ParameterTypeEnum {
@@ -17,4 +17,5 @@ export enum ParameterTypeEnum {
     WIZARD = 'WIZARD',
     INTEGRATIONS = 'INTEGRATIONS',
     SCORING = 'SCORING',
+    FEATURE_FLAG = 'FEATURE_FLAG',
 }

package/src/loanConfig/index.ts

@@ -1,6 +1,9 @@
 export * from './enums/ParameterTypeEnum';
 export * from './enums/ParameterValueTypeEnum';
 
+// Constants
+export * from './constants/RecentParameterChangesLimits';
+
 // Entity DTOs
 export * from './dtos/Parameter';
 
@@ -8,6 +11,9 @@ export * from './dtos/Parameter';
 export * from './dtos/requests/UpdateParameterRequest';
 export * from './dtos/requests/BulkUpdateParametersRequest';
 export * from './dtos/requests/BulkGetParametersRequest';
+export * from './dtos/requests/ListRecentParameterChangesRequest';
 
 // Response DTOs
 export * from './dtos/responses/ParameterResponse';
+export * from './dtos/responses/ParameterAuditEntry';
+export * from './dtos/responses/ListRecentParameterChangesResponse';

package/src/loanCredit/dtos/requests/BackofficeWriteOffCreditRequest.ts

@@ -1,5 +1,5 @@
 import { Expose, Type } from 'class-transformer';
-import { IsOptional, IsString, MinLength, ValidateNested } from 'class-validator';
+import { IsOptional, IsString, ValidateNested } from 'class-validator';
 import { WriteOffConfirmations } from '../WriteOffConfirmations';
 
 /** Body de `POST /backoffice/credits/:creditId/write-off`. Los faltantes los responde el lambda con su code. */
@@ -8,7 +8,6 @@ export class BackofficeWriteOffCreditRequest {
     @Expose()
     @IsOptional()
     @IsString()
-    @MinLength(1)
     reason?: string;
 
     @Expose()

package/src/loanCredit/enums/PaymentReviewReasonEnum.ts

@@ -13,4 +13,6 @@ export enum PaymentReviewReasonEnum {
     LEGACY_INSTALLMENT_WITH_PAYMENT = 'LEGACY_INSTALLMENT_WITH_PAYMENT',
     /** Lo retenido sin capturar. */
     UNCAPTURED_HOLD = 'UNCAPTURED_HOLD',
+    /** Cobro ad hoc PREPAYMENT, ADVANCE o RECOVERY que no fue completo. */
+    AD_HOC_CHARGE_INCOMPLETE = 'AD_HOC_CHARGE_INCOMPLETE',
 }