@fiado/type-kit 3.520.0 → 3.521.0

package/_test_/unit/mdm/dtos/mdmDeviceContract.test.ts

@@ -62,6 +62,28 @@ describe('DeviceEnrollRequest.lockMode', () => {
     });
 });
 
+describe('DeviceEnrollRequest.firstLockAt', () => {
+    it('valida sin firstLockAt: el consumidor de hoy no se rompe', async () => {
+        const dto = plainToInstance(DeviceEnrollRequest, validEnroll);
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+        expect(dto.firstLockAt).toBeUndefined();
+    });
+
+    it('valida con firstLockAt en ISO-8601', async () => {
+        const dto = plainToInstance(DeviceEnrollRequest, { ...validEnroll, firstLockAt: '2026-11-08T06:00:00.000Z' });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+        expect(dto.firstLockAt).toBe('2026-11-08T06:00:00.000Z');
+    });
+
+    it('falla si firstLockAt no es ISO-8601', async () => {
+        const dto = plainToInstance(DeviceEnrollRequest, { ...validEnroll, firstLockAt: '08/11/2026' });
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'firstLockAt', 'isIso8601')).toBe(true);
+    });
+});
+
 describe('DeviceUnlockRequest.unlockUntil', () => {
     it('valida sin unlockUntil: el consumidor de hoy no se rompe', async () => {
         const dto = plainToInstance(DeviceUnlockRequest, validUnlock);

package/_test_/unit/rewardsEligibility/metricsDtos.test.ts

@@ -1,5 +1,5 @@
 import { MetricsDimensionEnum } from '../../../src/rewardsEligibility/enums/MetricsDimensionEnum';
-import type { FailedConditionStatResponse } from '../../../src/rewardsEligibility/dtos/backoffice/FailedConditionStatResponse';
+import type { FailedConditionEvaluationResponse, FailedConditionStatResponse } from '../../../src/rewardsEligibility';
 import type { MetricsPointResponse } from '../../../src/rewardsEligibility/dtos/backoffice/MetricsPointResponse';
 import type { MetricsQuery } from '../../../src/rewardsEligibility/dtos/backoffice/MetricsQuery';
 
@@ -9,9 +9,15 @@ describe('DTOs de métricas (forma)', () => {
         expect(Object.keys(point)).toHaveLength(10);
     });
     it('ranking y query', () => {
-        const stat: FailedConditionStatResponse = { key: 'directory.accountAgeDays', label: 'Antigüedad de la cuenta', count: 7 };
+        const stat: FailedConditionStatResponse = { key: 'directory.accountAgeDays', label: 'Antigüedad de la cuenta', count: 7, evaluations: [] };
         const query: MetricsQuery = { dimension: MetricsDimensionEnum.CAMPAIGN, value: 'referidos-q4', from: '2026-10-01', to: '2026-10-08' };
         expect(stat.count).toBe(7);
         expect(query.dimension).toBe('CAMPAIGN');
     });
+
+    it('FailedConditionStatResponse trae evaluations ordenables por count (D-E1)', () => {
+        const evaluation: FailedConditionEvaluationResponse = { evaluationId: 'ev-1', evaluationName: 'Referidos', count: 7 };
+        const stat: FailedConditionStatResponse = { key: 'payments.amount', label: 'Monto', count: 9, evaluations: [evaluation] };
+        expect(stat.evaluations[0]).toEqual({ evaluationId: 'ev-1', evaluationName: 'Referidos', count: 7 });
+    });
 });

package/bin/mdm/dtos/DeviceEnrollRequest.d.ts

@@ -8,5 +8,7 @@ export declare class DeviceEnrollRequest {
     termMonths: number;
     /** Cuándo se dispara el bloqueo del equipo; si se omite es ONDEMAND, que es el modo de hoy. */
     lockMode?: MdmLockModeEnum;
+    /** ISO-8601 del primer bloqueo programado (primer vencimiento); lo usan proveedores que agendan el bloqueo al enrolar. */
+    firstLockAt?: string;
     operationReference: string;
 }

package/bin/mdm/dtos/DeviceEnrollRequest.js

@@ -58,6 +58,12 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", String)
 ], DeviceEnrollRequest.prototype, "lockMode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsISO8601)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], DeviceEnrollRequest.prototype, "firstLockAt", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

package/bin/rewardsEligibility/dtos/backoffice/FailedConditionEvaluationResponse.d.ts

@@ -0,0 +1,6 @@
+/** En qué evaluación falló una condición y cuántas veces (máximo 5 por condición, de mayor a menor). */
+export declare class FailedConditionEvaluationResponse {
+    evaluationId: string;
+    evaluationName: string;
+    count: number;
+}

package/bin/rewardsEligibility/dtos/backoffice/FailedConditionEvaluationResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FailedConditionEvaluationResponse = void 0;
+/** En qué evaluación falló una condición y cuántas veces (máximo 5 por condición, de mayor a menor). */
+class FailedConditionEvaluationResponse {
+}
+exports.FailedConditionEvaluationResponse = FailedConditionEvaluationResponse;

package/bin/rewardsEligibility/dtos/backoffice/FailedConditionStatResponse.d.ts

@@ -1,3 +1,4 @@
+import { FailedConditionEvaluationResponse } from './FailedConditionEvaluationResponse';
 /** Condición que más hace fallar la regla (`GET /metrics/failed-conditions`). */
 export declare class FailedConditionStatResponse {
     /** `{source}.{field}`. */
@@ -5,4 +6,6 @@ export declare class FailedConditionStatResponse {
     /** Etiqueta legible (del catálogo de reglas; si no está, la propia `key`). */
     label: string;
     count: number;
+    /** Evaluaciones donde falla esta condición, ordenadas por `count` descendente (máx. 5). */
+    evaluations: FailedConditionEvaluationResponse[];
 }

package/bin/rewardsEligibility/index.d.ts

@@ -66,4 +66,5 @@ export * from './dtos/backoffice/RunResultListResponse';
 export * from './dtos/backoffice/CreateRunResponse';
 export * from './dtos/backoffice/MetricsPointResponse';
 export * from './dtos/backoffice/FailedConditionStatResponse';
+export * from './dtos/backoffice/FailedConditionEvaluationResponse';
 export * from './dtos/backoffice/MetricsQuery';

package/bin/rewardsEligibility/index.js

@@ -88,4 +88,5 @@ __exportStar(require("./dtos/backoffice/RunResultListResponse"), exports);
 __exportStar(require("./dtos/backoffice/CreateRunResponse"), exports);
 __exportStar(require("./dtos/backoffice/MetricsPointResponse"), exports);
 __exportStar(require("./dtos/backoffice/FailedConditionStatResponse"), exports);
+__exportStar(require("./dtos/backoffice/FailedConditionEvaluationResponse"), exports);
 __exportStar(require("./dtos/backoffice/MetricsQuery"), exports);

package/package.json

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

package/src/mdm/dtos/DeviceEnrollRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from "class-transformer";
-import { IsString, IsNotEmpty, IsOptional, IsNumber, IsPositive, Matches, IsEnum } from "class-validator";
+import { IsString, IsNotEmpty, IsOptional, IsNumber, IsPositive, Matches, IsEnum, IsISO8601 } from "class-validator";
 import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from "../../common/constants/CreditIdPattern";
 import { MdmLockModeEnum } from "../../retailCatalog/enums/MdmLockModeEnum";
 
@@ -39,6 +39,12 @@ export class DeviceEnrollRequest {
     @IsOptional()
     lockMode?: MdmLockModeEnum;
 
+    /** ISO-8601 del primer bloqueo programado (primer vencimiento); lo usan proveedores que agendan el bloqueo al enrolar. */
+    @Expose()
+    @IsISO8601()
+    @IsOptional()
+    firstLockAt?: string;
+
     @Expose()
     @IsString()
     @IsNotEmpty()

package/src/rewardsEligibility/dtos/backoffice/FailedConditionEvaluationResponse.ts

@@ -0,0 +1,6 @@
+/** En qué evaluación falló una condición y cuántas veces (máximo 5 por condición, de mayor a menor). */
+export class FailedConditionEvaluationResponse {
+    evaluationId: string;
+    evaluationName: string;
+    count: number;
+}

package/src/rewardsEligibility/dtos/backoffice/FailedConditionStatResponse.ts

@@ -1,3 +1,5 @@
+import { FailedConditionEvaluationResponse } from './FailedConditionEvaluationResponse';
+
 /** Condición que más hace fallar la regla (`GET /metrics/failed-conditions`). */
 export class FailedConditionStatResponse {
     /** `{source}.{field}`. */
@@ -5,4 +7,6 @@ export class FailedConditionStatResponse {
     /** Etiqueta legible (del catálogo de reglas; si no está, la propia `key`). */
     label: string;
     count: number;
+    /** Evaluaciones donde falla esta condición, ordenadas por `count` descendente (máx. 5). */
+    evaluations: FailedConditionEvaluationResponse[];
 }

package/src/rewardsEligibility/index.ts

@@ -77,4 +77,5 @@ export * from './dtos/backoffice/RunResultListResponse';
 export * from './dtos/backoffice/CreateRunResponse';
 export * from './dtos/backoffice/MetricsPointResponse';
 export * from './dtos/backoffice/FailedConditionStatResponse';
+export * from './dtos/backoffice/FailedConditionEvaluationResponse';
 export * from './dtos/backoffice/MetricsQuery';