@fiado/type-kit 3.435.0 → 3.437.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/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/remittance/dtos/RemittanceBackofficeCancelCloseResponse.d.ts

@@ -1,4 +1,5 @@
 import { RemittanceBackofficeTransaction } from "./RemittanceBackofficeTransaction";
+import { RemittanceCancelOutcomeEnum } from "../enums/RemittanceCancelOutcomeEnum";
 /** Resultado del cierre manual: la tx fresca y qué pasos se ejecutaron en esta llamada. */
 export declare class RemittanceBackofficeCancelCloseResponse {
     transaction: RemittanceBackofficeTransaction;
@@ -7,4 +8,8 @@ export declare class RemittanceBackofficeCancelCloseResponse {
     credited: boolean;
     /** true si la tx ya estaba en estado final y no se hizo nada. */
     alreadyProcessed: boolean;
+    /** Desenlace que quedó en UniTeller (puede diferir del elegido por ops). */
+    appliedOutcome?: RemittanceCancelOutcomeEnum;
+    /** true si UniTeller (o un reporte previo) cambió el desenlace elegido. */
+    corrected?: boolean;
 }

package/bin/remittance/dtos/RemittanceBackofficeTransaction.d.ts

@@ -58,6 +58,9 @@ export declare class RemittanceBackofficeTransaction {
     cancelClosedBy?: string;
     cancelClosedAt?: string;
     cancelCloseNote?: string;
+    /** Intentos fallidos del cierre automático (cron); tras el tope queda para revisión manual. */
+    cancelAutoCloseAttempts?: number;
+    cancelAutoCloseLastError?: string;
     smsAlertCount?: number;
     createdAt: string;
     updatedAt: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.435.0",
+  "version": "3.437.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/remittance/dtos/RemittanceBackofficeCancelCloseResponse.ts

@@ -1,4 +1,5 @@
 import { RemittanceBackofficeTransaction } from "./RemittanceBackofficeTransaction";
+import { RemittanceCancelOutcomeEnum } from "../enums/RemittanceCancelOutcomeEnum";
 
 /** Resultado del cierre manual: la tx fresca y qué pasos se ejecutaron en esta llamada. */
 export class RemittanceBackofficeCancelCloseResponse {
@@ -8,4 +9,8 @@ export class RemittanceBackofficeCancelCloseResponse {
     credited!: boolean;
     /** true si la tx ya estaba en estado final y no se hizo nada. */
     alreadyProcessed!: boolean;
+    /** Desenlace que quedó en UniTeller (puede diferir del elegido por ops). */
+    appliedOutcome?: RemittanceCancelOutcomeEnum;
+    /** true si UniTeller (o un reporte previo) cambió el desenlace elegido. */
+    corrected?: boolean;
 }

package/src/remittance/dtos/RemittanceBackofficeTransaction.ts

@@ -59,6 +59,9 @@ export class RemittanceBackofficeTransaction {
     cancelClosedBy?: string;
     cancelClosedAt?: string;
     cancelCloseNote?: string;
+    /** Intentos fallidos del cierre automático (cron); tras el tope queda para revisión manual. */
+    cancelAutoCloseAttempts?: number;
+    cancelAutoCloseLastError?: string;
     smsAlertCount?: number;
     createdAt!: string;
     updatedAt!: string;