@fiado/type-kit 3.399.0 → 3.400.0

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

@@ -0,0 +1,83 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate, ValidationError } from 'class-validator';
+import { DeviceEnrollRequest } from '../../../../src/mdm/dtos/DeviceEnrollRequest';
+import { DeviceUnlockRequest } from '../../../../src/mdm/dtos/DeviceUnlockRequest';
+import { MdmErrorCodeEnum } from '../../../../src/mdm/enums/MdmErrorCodeEnum';
+import * as MdmBarrel from '../../../../src/mdm/index';
+import { MdmLockModeEnum } from '../../../../src/retailCatalog/enums/MdmLockModeEnum';
+
+/** ULID real del motor: así genera los creditId `loan-credit-business`. */
+const CREDIT_ID = '01M0B5D7FQA3T06K4REEVPRM33';
+
+/** True si el error de `property` trae ese constraint puntual (no solo "algo falló"). */
+const hasConstraint = (errors: ValidationError[], property: string, constraint: string): boolean =>
+    errors.some(e => e.property === property && Boolean(e.constraints?.[constraint]));
+
+/** Payload de enrolamiento tal como lo manda hoy un consumidor ya desplegado. */
+const validEnroll = {
+    imei: '351756051523999',
+    creditId: CREDIT_ID,
+    termMonths: 6,
+    operationReference: 'enroll-2026-09-01-0001',
+};
+
+const validUnlock = {
+    imei: '351756051523999',
+    operationReference: 'unlock-2026-09-01-0001',
+};
+
+describe('DeviceEnrollRequest.lockMode', () => {
+    it('valida sin lockMode: el consumidor de hoy no se rompe', async () => {
+        const dto = plainToInstance(DeviceEnrollRequest, validEnroll);
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+        expect(dto.lockMode).toBeUndefined();
+    });
+
+    it.each([MdmLockModeEnum.ONDEMAND, MdmLockModeEnum.SCHEDULED])('valida con lockMode %s', async lockMode => {
+        const dto = plainToInstance(DeviceEnrollRequest, { ...validEnroll, lockMode });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+        expect(dto.lockMode).toBe(lockMode);
+    });
+
+    it('falla si lockMode está fuera del enum', async () => {
+        const dto = plainToInstance(DeviceEnrollRequest, { ...validEnroll, lockMode: 'PREPAGO' });
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'lockMode', 'isEnum')).toBe(true);
+    });
+});
+
+describe('DeviceUnlockRequest.unlockUntil', () => {
+    it('valida sin unlockUntil: el consumidor de hoy no se rompe', async () => {
+        const dto = plainToInstance(DeviceUnlockRequest, validUnlock);
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+        expect(dto.unlockUntil).toBeUndefined();
+    });
+
+    it('valida con unlockUntil en ISO-8601', async () => {
+        const dto = plainToInstance(DeviceUnlockRequest, { ...validUnlock, unlockUntil: '2026-10-01T00:00:00.000Z' });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it('falla si unlockUntil no es ISO-8601', async () => {
+        const dto = plainToInstance(DeviceUnlockRequest, { ...validUnlock, unlockUntil: '01/10/2026' });
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'unlockUntil', 'isIso8601')).toBe(true);
+    });
+});
+
+describe('MdmErrorCodeEnum', () => {
+    it('expone el código de desbloqueo sin vigencia sobre un equipo SCHEDULED', () => {
+        expect(MdmErrorCodeEnum.UNLOCK_UNTIL_REQUIRED).toBe('UNLOCK_UNTIL_REQUIRED');
+    });
+});
+
+describe('barrel de mdm', () => {
+    it('reexporta MdmLockModeEnum sin duplicar el enum de retailCatalog', () => {
+        expect(MdmBarrel.MdmLockModeEnum).toBe(MdmLockModeEnum);
+    });
+});

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

@@ -1,3 +1,4 @@
+import { MdmLockModeEnum } from "../../retailCatalog/enums/MdmLockModeEnum";
 export declare class DeviceEnrollRequest {
     imei: string;
     imei2?: string;
@@ -5,5 +6,7 @@ export declare class DeviceEnrollRequest {
     model?: string;
     creditId: string;
     termMonths: number;
+    /** Cuándo se dispara el bloqueo del equipo; si se omite es ONDEMAND, que es el modo de hoy. */
+    lockMode?: MdmLockModeEnum;
     operationReference: string;
 }

package/bin/mdm/dtos/DeviceEnrollRequest.js

@@ -13,6 +13,7 @@ exports.DeviceEnrollRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const CreditIdPattern_1 = require("../../common/constants/CreditIdPattern");
+const MdmLockModeEnum_1 = require("../../retailCatalog/enums/MdmLockModeEnum");
 class DeviceEnrollRequest {
 }
 exports.DeviceEnrollRequest = DeviceEnrollRequest;
@@ -51,6 +52,12 @@ __decorate([
     (0, class_validator_1.IsPositive)(),
     __metadata("design:type", Number)
 ], DeviceEnrollRequest.prototype, "termMonths", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(MdmLockModeEnum_1.MdmLockModeEnum),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], DeviceEnrollRequest.prototype, "lockMode", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

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

@@ -1,4 +1,6 @@
 export declare class DeviceUnlockRequest {
     imei: string;
+    /** ISO-8601 de hasta cuándo vale el desbloqueo; solo aplica en modo SCHEDULED. */
+    unlockUntil?: string;
     operationReference: string;
 }

package/bin/mdm/dtos/DeviceUnlockRequest.js

@@ -21,6 +21,12 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], DeviceUnlockRequest.prototype, "imei", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsISO8601)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], DeviceUnlockRequest.prototype, "unlockUntil", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

package/bin/mdm/enums/MdmErrorCodeEnum.d.ts

@@ -3,6 +3,7 @@ export declare enum MdmErrorCodeEnum {
     DEVICE_NOT_FOUND = "DEVICE_NOT_FOUND",
     DEVICE_NOT_ENROLLED = "DEVICE_NOT_ENROLLED",
     INVALID_REQUEST = "INVALID_REQUEST",
+    UNLOCK_UNTIL_REQUIRED = "UNLOCK_UNTIL_REQUIRED",
     PROVIDER_ERROR = "PROVIDER_ERROR",
     PROVIDER_TIMEOUT = "PROVIDER_TIMEOUT",
     PROVIDER_RATE_LIMITED = "PROVIDER_RATE_LIMITED",

package/bin/mdm/enums/MdmErrorCodeEnum.js

@@ -7,6 +7,7 @@ var MdmErrorCodeEnum;
     MdmErrorCodeEnum["DEVICE_NOT_FOUND"] = "DEVICE_NOT_FOUND";
     MdmErrorCodeEnum["DEVICE_NOT_ENROLLED"] = "DEVICE_NOT_ENROLLED";
     MdmErrorCodeEnum["INVALID_REQUEST"] = "INVALID_REQUEST";
+    MdmErrorCodeEnum["UNLOCK_UNTIL_REQUIRED"] = "UNLOCK_UNTIL_REQUIRED";
     MdmErrorCodeEnum["PROVIDER_ERROR"] = "PROVIDER_ERROR";
     MdmErrorCodeEnum["PROVIDER_TIMEOUT"] = "PROVIDER_TIMEOUT";
     MdmErrorCodeEnum["PROVIDER_RATE_LIMITED"] = "PROVIDER_RATE_LIMITED";

package/bin/mdm/index.d.ts

@@ -45,3 +45,4 @@ export * from "./enums/MdmOperationStatusEnum";
 export * from "./enums/MdmErrorCodeEnum";
 export * from "./enums/MdmProviderEnum";
 export * from "./enums/MdmOperationTypeEnum";
+export { MdmLockModeEnum } from "../retailCatalog/enums/MdmLockModeEnum";

package/bin/mdm/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MdmLockModeEnum = void 0;
 // dtos
 __exportStar(require("./dtos/MdmError"), exports);
 __exportStar(require("./dtos/DeviceLockScreenMessage"), exports);
@@ -68,3 +69,6 @@ __exportStar(require("./enums/MdmOperationStatusEnum"), exports);
 __exportStar(require("./enums/MdmErrorCodeEnum"), exports);
 __exportStar(require("./enums/MdmProviderEnum"), exports);
 __exportStar(require("./enums/MdmOperationTypeEnum"), exports);
+// enums de otro dominio — el modo de bloqueo lo define el producto en el catálogo
+var MdmLockModeEnum_1 = require("../retailCatalog/enums/MdmLockModeEnum");
+Object.defineProperty(exports, "MdmLockModeEnum", { enumerable: true, get: function () { return MdmLockModeEnum_1.MdmLockModeEnum; } });

package/package.json

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

package/src/mdm/README.md

@@ -60,6 +60,22 @@ import { Mdm } from "@fiado/type-kit";
 | DeviceLastSeen | (incluido en Device Info) | Device Last Seen |
 | DeviceLog | ❌ Error: no expone | Device Log |
 
+## Modo de bloqueo (`MdmLockModeEnum`)
+
+El enum lo define el catálogo (`retailCatalog`), porque el modo es un atributo del producto que se
+congela al enrolar. El dominio `mdm` lo reexporta para no duplicarlo.
+
+| Modo | Qué significa | Cómo se comporta |
+|---|---|---|
+| `ONDEMAND` | El bloqueo se dispara bajo demanda | Solo se bloquea cuando se lo ordenan |
+| `SCHEDULED` | El bloqueo se dispara de forma programada | Se bloquea al vencer la vigencia; cada pago la corre |
+
+- `DeviceEnrollRequest.lockMode` — opcional; ausente equivale a `ONDEMAND`.
+- `DeviceUnlockRequest.unlockUntil` — opcional; ISO-8601 de hasta cuándo vale el desbloqueo. En
+  `ONDEMAND` no aplica y se ignora.
+- `MdmErrorCodeEnum.UNLOCK_UNTIL_REQUIRED` — un desbloqueo sin `unlockUntil` sobre un equipo
+  `SCHEDULED` se rechaza: mandarlo sin vigencia liberaría el equipo sin fecha de re-bloqueo.
+
 ## Eventos entrantes (solo Datacultr)
 
 - `DeviceEnrollmentCompletedEvent` — Enrollment Webhook

package/src/mdm/dtos/DeviceEnrollRequest.ts

@@ -1,6 +1,7 @@
 import { Expose } from "class-transformer";
-import { IsString, IsNotEmpty, IsOptional, IsNumber, IsPositive, Matches } from "class-validator";
+import { IsString, IsNotEmpty, IsOptional, IsNumber, IsPositive, Matches, IsEnum } from "class-validator";
 import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from "../../common/constants/CreditIdPattern";
+import { MdmLockModeEnum } from "../../retailCatalog/enums/MdmLockModeEnum";
 
 export class DeviceEnrollRequest {
     @Expose()
@@ -32,6 +33,12 @@ export class DeviceEnrollRequest {
     @IsPositive()
     termMonths: number;
 
+    /** Cuándo se dispara el bloqueo del equipo; si se omite es ONDEMAND, que es el modo de hoy. */
+    @Expose()
+    @IsEnum(MdmLockModeEnum)
+    @IsOptional()
+    lockMode?: MdmLockModeEnum;
+
     @Expose()
     @IsString()
     @IsNotEmpty()

package/src/mdm/dtos/DeviceUnlockRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from "class-transformer";
-import { IsString, IsNotEmpty } from "class-validator";
+import { IsString, IsNotEmpty, IsOptional, IsISO8601 } from "class-validator";
 
 export class DeviceUnlockRequest {
     @Expose()
@@ -7,6 +7,12 @@ export class DeviceUnlockRequest {
     @IsNotEmpty()
     imei: string;
 
+    /** ISO-8601 de hasta cuándo vale el desbloqueo; solo aplica en modo SCHEDULED. */
+    @Expose()
+    @IsISO8601()
+    @IsOptional()
+    unlockUntil?: string;
+
     @Expose()
     @IsString()
     @IsNotEmpty()

package/src/mdm/enums/MdmErrorCodeEnum.ts

@@ -3,6 +3,7 @@ export enum MdmErrorCodeEnum {
     DEVICE_NOT_FOUND = "DEVICE_NOT_FOUND",
     DEVICE_NOT_ENROLLED = "DEVICE_NOT_ENROLLED",
     INVALID_REQUEST = "INVALID_REQUEST",
+    UNLOCK_UNTIL_REQUIRED = "UNLOCK_UNTIL_REQUIRED",
     PROVIDER_ERROR = "PROVIDER_ERROR",
     PROVIDER_TIMEOUT = "PROVIDER_TIMEOUT",
     PROVIDER_RATE_LIMITED = "PROVIDER_RATE_LIMITED",

package/src/mdm/index.ts

@@ -58,3 +58,6 @@ export * from "./enums/MdmOperationStatusEnum";
 export * from "./enums/MdmErrorCodeEnum";
 export * from "./enums/MdmProviderEnum";
 export * from "./enums/MdmOperationTypeEnum";
+
+// enums de otro dominio — el modo de bloqueo lo define el producto en el catálogo
+export { MdmLockModeEnum } from "../retailCatalog/enums/MdmLockModeEnum";