@fiado/type-kit 3.399.0 → 3.401.0

package/src/loanCredit/dtos/responses/LoanDeviceReleaseResult.ts

@@ -0,0 +1,10 @@
+import { LoanDeviceOperationResult } from '../LoanDeviceOperationResult';
+import { LoanDeviceMdmStatusEnum } from '../../enums/LoanDeviceMdmStatusEnum';
+
+/** Resultado por crédito de la liberación definitiva en lote. */
+export class LoanDeviceReleaseResult extends LoanDeviceOperationResult {
+    /** Estado nuestro del expediente después de intentar la liberación. */
+    mdmStatus: LoanDeviceMdmStatusEnum;
+
+    releasedAt?: string;
+}

package/src/loanCredit/index.ts

@@ -44,6 +44,8 @@ export { MdmDeviceStatusEnum } from '../mdm/enums/MdmDeviceStatusEnum';
 export { MdmOperationTypeEnum } from '../mdm/enums/MdmOperationTypeEnum';
 export { MdmProviderEnum } from '../mdm/enums/MdmProviderEnum';
 export { DeviceEnrollmentModeEnum } from '../mdm/enums/DeviceEnrollmentModeEnum';
+export { DeviceNotifyIntensityEnum } from '../mdm/enums/DeviceNotifyIntensityEnum';
+export { DeviceReleaseReasonEnum } from '../mdm/enums/DeviceReleaseReasonEnum';
 export { MdmError } from '../mdm/dtos/MdmError';
 export { DeviceLockScreenMessage } from '../mdm/dtos/DeviceLockScreenMessage';
 export { MdmLockModeEnum } from '../retailCatalog/enums/MdmLockModeEnum';
@@ -55,6 +57,9 @@ export * from './dtos/LoanDeviceOperationResult';
 export * from './dtos/LoanDeviceCreditRefItem';
 export * from './dtos/LoanDeviceEnrollItem';
 export * from './dtos/LoanDeviceManualLockItem';
+export * from './dtos/LoanDeviceUnlockItem';
+export * from './dtos/LoanDeviceNotifyItem';
+export * from './dtos/LoanDeviceReleaseItem';
 
 export * from './dtos/requests/LoanDeviceEnrollRequest';
 export * from './dtos/requests/LoanDeviceEnrollStatusRequest';
@@ -62,6 +67,8 @@ export * from './dtos/requests/LoanDeviceStatusRequest';
 export * from './dtos/requests/LoanDeviceLastSeenRequest';
 export * from './dtos/requests/LoanDeviceManualLockRequest';
 export * from './dtos/requests/LoanDeviceManualUnlockRequest';
+export * from './dtos/requests/LoanDeviceNotifyRequest';
+export * from './dtos/requests/LoanDeviceReleaseRequest';
 
 export * from './dtos/responses/LoanDeviceEnrollResult';
 export * from './dtos/responses/LoanDeviceEnrollResponse';
@@ -76,3 +83,9 @@ export * from './dtos/responses/LoanDeviceManualLockResponse';
 export * from './dtos/responses/LoanDevicePinUnlockResult';
 export * from './dtos/responses/LoanDeviceUnlockResult';
 export * from './dtos/responses/LoanDeviceManualUnlockResponse';
+export * from './dtos/responses/LoanDeviceNotifyResult';
+export * from './dtos/responses/LoanDeviceNotifyResponse';
+export * from './dtos/responses/LoanDeviceReleaseResult';
+export * from './dtos/responses/LoanDeviceReleaseResponse';
+
+export * from './validators/IsFutureIso8601DateTime';

package/src/loanCredit/validators/IsFutureIso8601DateTime.ts

@@ -0,0 +1,32 @@
+import { ValidatorConstraint, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+
+/** Datetime ISO-8601 completo: fecha, hora y zona (`Z` u offset). Rechaza el date-only. */
+const ISO_DATETIME_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,3})?)?(Z|[+-]\d{2}:\d{2})$/;
+
+/**
+ * Valida que el valor sea un datetime ISO-8601 con hora y zona, y posterior al momento actual.
+ *
+ * Por qué no alcanza `@IsISO8601()`:
+ * - acepta el date-only (`"2026-09-30"`), que no fija un instante y el proveedor MDM necesita uno;
+ * - acepta fechas pasadas, y un corte "hasta ayer" es un no-op silencioso.
+ *
+ * Uso típico:
+ * ```ts
+ *   @Validate(IsFutureIso8601DateTime)
+ *   unlockUntil?: string;
+ * ```
+ */
+@ValidatorConstraint({ name: 'isFutureIso8601DateTime', async: false })
+export class IsFutureIso8601DateTime implements ValidatorConstraintInterface {
+    validate(value: unknown, _args: ValidationArguments): boolean {
+        if (typeof value !== 'string' || !ISO_DATETIME_PATTERN.test(value)) {
+            return false;
+        }
+        const instant = Date.parse(value);
+        return !Number.isNaN(instant) && instant > Date.now();
+    }
+
+    defaultMessage(args: ValidationArguments): string {
+        return `${args.property} debe ser un datetime ISO-8601 con hora y zona, y posterior al momento actual`;
+    }
+}

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";