@fiado/type-kit 3.19.0 → 3.20.1

package/src/mdm/dtos/DeviceLockScreenMessage.ts

@@ -0,0 +1,14 @@
+import { Expose } from "class-transformer";
+import { IsString, IsNotEmpty } from "class-validator";
+
+export class DeviceLockScreenMessage {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    title: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    content: string;
+}

package/src/mdm/dtos/DeviceLogEntry.ts

@@ -0,0 +1,5 @@
+export class DeviceLogEntry {
+    occurredAt: string;
+    action: string;
+    state: string;
+}

package/src/mdm/dtos/DeviceLogRequest.ts

@@ -0,0 +1,19 @@
+import { Expose } from "class-transformer";
+import { IsString, IsNotEmpty, IsISO8601, IsOptional } from "class-validator";
+
+export class DeviceLogRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    imei: string;
+
+    @Expose()
+    @IsISO8601()
+    @IsOptional()
+    from?: string;
+
+    @Expose()
+    @IsISO8601()
+    @IsOptional()
+    to?: string;
+}

package/src/mdm/dtos/DeviceLogResponse.ts

@@ -0,0 +1,10 @@
+import { MdmOperationStatusEnum } from "../enums/MdmOperationStatusEnum";
+import { DeviceLogEntry } from "./DeviceLogEntry";
+import { MdmError } from "./MdmError";
+
+export class DeviceLogResponse {
+    imei: string;
+    status: MdmOperationStatusEnum;
+    entries?: DeviceLogEntry[];
+    error?: MdmError;
+}

package/src/mdm/dtos/DeviceNotifyRequest.ts

@@ -0,0 +1,47 @@
+import { Expose } from "class-transformer";
+import { IsString, IsNotEmpty, IsEnum } from "class-validator";
+import { DeviceNotifyIntensityEnum } from "../enums/DeviceNotifyIntensityEnum";
+
+export class DeviceNotifyRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    imei: string;
+
+    @Expose()
+    @IsEnum(DeviceNotifyIntensityEnum)
+    intensity: DeviceNotifyIntensityEnum;
+
+    /**
+     * Código de notificación del catálogo (usado por Datacultr en su catálogo de mensajes
+     * predefinidos). Trustonic lo ignora porque exige texto crudo en `title + content`.
+     * Ver `trustonic-connector/docs/ARCHITECTURE.md` §7.6.
+     */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    notificationCode: string;
+
+    /**
+     * Título de la notificación. Usado por Trustonic (`notificationTitle`). Datacultr lo
+     * ignora — el texto del título vive en su catálogo indexado por `notificationCode`.
+     */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    title: string;
+
+    /**
+     * Cuerpo de la notificación. Usado por Trustonic (`notificationContent`). Datacultr lo
+     * ignora.
+     */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    content: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    operationReference: string;
+}

package/src/mdm/dtos/DeviceNotifyResponse.ts

@@ -0,0 +1,10 @@
+import { MdmOperationStatusEnum } from "../enums/MdmOperationStatusEnum";
+import { MdmError } from "./MdmError";
+
+export class DeviceNotifyResponse {
+    imei: string;
+    operationReference: string;
+    status: MdmOperationStatusEnum;
+    sentAt?: string;
+    error?: MdmError;
+}

package/src/mdm/dtos/DevicePinUnlockRequest.ts

@@ -0,0 +1,19 @@
+import { Expose } from "class-transformer";
+import { IsString, IsNotEmpty, IsOptional } from "class-validator";
+
+export class DevicePinUnlockRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    imei: string;
+
+    @Expose()
+    @IsString()
+    @IsOptional()
+    devicePasskey?: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    operationReference: string;
+}

package/src/mdm/dtos/DevicePinUnlockResponse.ts

@@ -0,0 +1,12 @@
+import { MdmOperationStatusEnum } from "../enums/MdmOperationStatusEnum";
+import { MdmError } from "./MdmError";
+
+export class DevicePinUnlockResponse {
+    imei: string;
+    operationReference: string;
+    status: MdmOperationStatusEnum;
+    pin?: string;
+    validitySeconds?: number;
+    generatedAt?: string;
+    error?: MdmError;
+}

package/src/mdm/dtos/DeviceReleaseCompletedEvent.ts

@@ -0,0 +1,6 @@
+export class DeviceReleaseCompletedEvent {
+    imei: string;
+    releasedAt: string;
+    successful: boolean;
+    provider: string;
+}

package/src/mdm/dtos/DeviceReleaseInitiateResponse.ts

@@ -0,0 +1,10 @@
+import { MdmOperationStatusEnum } from "../enums/MdmOperationStatusEnum";
+import { MdmError } from "./MdmError";
+
+export class DeviceReleaseInitiateResponse {
+    imei: string;
+    operationReference: string;
+    status: MdmOperationStatusEnum;
+    releasedAt?: string;
+    error?: MdmError;
+}

package/src/mdm/dtos/DeviceReleaseRequest.ts

@@ -0,0 +1,24 @@
+import { Expose } from "class-transformer";
+import { IsString, IsNotEmpty, IsEnum, IsOptional } from "class-validator";
+import { DeviceReleaseReasonEnum } from "../enums/DeviceReleaseReasonEnum";
+
+export class DeviceReleaseRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    imei: string;
+
+    @Expose()
+    @IsEnum(DeviceReleaseReasonEnum)
+    reason: DeviceReleaseReasonEnum;
+
+    @Expose()
+    @IsString()
+    @IsOptional()
+    comment?: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    operationReference: string;
+}

package/src/mdm/dtos/DeviceReleaseStatusRequest.ts

@@ -0,0 +1,14 @@
+import { Expose } from "class-transformer";
+import { IsString, IsNotEmpty } from "class-validator";
+
+export class DeviceReleaseStatusRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    imei: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    operationReference: string;
+}

package/src/mdm/dtos/DeviceReleaseStatusResponse.ts

@@ -0,0 +1,10 @@
+import { MdmOperationStatusEnum } from "../enums/MdmOperationStatusEnum";
+import { MdmError } from "./MdmError";
+
+export class DeviceReleaseStatusResponse {
+    imei: string;
+    operationReference: string;
+    status: MdmOperationStatusEnum;
+    releasedAt?: string;
+    error?: MdmError;
+}

package/src/mdm/dtos/DeviceRestrictAppsRequest.ts

@@ -0,0 +1,19 @@
+import { Expose } from "class-transformer";
+import { IsString, IsNotEmpty } from "class-validator";
+
+export class DeviceRestrictAppsRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    imei: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    restrictionCode: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    operationReference: string;
+}

package/src/mdm/dtos/DeviceRestrictAppsResponse.ts

@@ -0,0 +1,10 @@
+import { MdmOperationStatusEnum } from "../enums/MdmOperationStatusEnum";
+import { MdmError } from "./MdmError";
+
+export class DeviceRestrictAppsResponse {
+    imei: string;
+    operationReference: string;
+    status: MdmOperationStatusEnum;
+    appliedAt?: string;
+    error?: MdmError;
+}

package/src/mdm/dtos/DeviceServiceDeactivateInitiateResponse.ts

@@ -0,0 +1,9 @@
+import { MdmOperationStatusEnum } from "../enums/MdmOperationStatusEnum";
+import { MdmError } from "./MdmError";
+
+export class DeviceServiceDeactivateInitiateResponse {
+    imei: string;
+    operationReference: string;
+    status: MdmOperationStatusEnum;
+    error?: MdmError;
+}

package/src/mdm/dtos/DeviceServiceDeactivateRequest.ts

@@ -0,0 +1,19 @@
+import { Expose } from "class-transformer";
+import { IsString, IsNotEmpty, IsEnum } from "class-validator";
+import { DeviceServiceDeactivateReasonEnum } from "../enums/DeviceServiceDeactivateReasonEnum";
+
+export class DeviceServiceDeactivateRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    imei: string;
+
+    @Expose()
+    @IsEnum(DeviceServiceDeactivateReasonEnum)
+    reason: DeviceServiceDeactivateReasonEnum;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    operationReference: string;
+}

package/src/mdm/dtos/DeviceServiceDeactivateStatusRequest.ts

@@ -0,0 +1,14 @@
+import { Expose } from "class-transformer";
+import { IsString, IsNotEmpty } from "class-validator";
+
+export class DeviceServiceDeactivateStatusRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    imei: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    operationReference: string;
+}

package/src/mdm/dtos/DeviceServiceDeactivateStatusResponse.ts

@@ -0,0 +1,10 @@
+import { MdmOperationStatusEnum } from "../enums/MdmOperationStatusEnum";
+import { MdmError } from "./MdmError";
+
+export class DeviceServiceDeactivateStatusResponse {
+    imei: string;
+    operationReference: string;
+    status: MdmOperationStatusEnum;
+    deactivatedAt?: string;
+    error?: MdmError;
+}

package/src/mdm/dtos/DeviceStatusRequest.ts

@@ -0,0 +1,9 @@
+import { Expose } from "class-transformer";
+import { IsString, IsNotEmpty } from "class-validator";
+
+export class DeviceStatusRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    imei: string;
+}

package/src/mdm/dtos/DeviceStatusResponse.ts

@@ -0,0 +1,16 @@
+import { MdmDeviceStatusEnum } from "../enums/MdmDeviceStatusEnum";
+import { MdmOperationStatusEnum } from "../enums/MdmOperationStatusEnum";
+import { MdmError } from "./MdmError";
+
+export class DeviceStatusResponse {
+    imei: string;
+    status: MdmOperationStatusEnum;
+    deviceStatus?: MdmDeviceStatusEnum;
+    brand?: string;
+    model?: string;
+    marketName?: string;
+    lastSeenAt?: string;
+    lastTransition?: string;
+    enrolledAt?: string;
+    error?: MdmError;
+}

package/src/mdm/dtos/DeviceUnlockRequest.ts

@@ -0,0 +1,14 @@
+import { Expose } from "class-transformer";
+import { IsString, IsNotEmpty } from "class-validator";
+
+export class DeviceUnlockRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    imei: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    operationReference: string;
+}

package/src/mdm/dtos/DeviceUnlockResponse.ts

@@ -0,0 +1,10 @@
+import { MdmOperationStatusEnum } from "../enums/MdmOperationStatusEnum";
+import { MdmError } from "./MdmError";
+
+export class DeviceUnlockResponse {
+    imei: string;
+    operationReference: string;
+    status: MdmOperationStatusEnum;
+    unlockedAt?: string;
+    error?: MdmError;
+}

package/src/mdm/dtos/MdmError.ts

@@ -0,0 +1,7 @@
+import { MdmErrorCodeEnum } from "../enums/MdmErrorCodeEnum";
+
+export class MdmError {
+    code: MdmErrorCodeEnum;
+    message: string;
+    providerDetails?: string;
+}

package/src/mdm/enums/DeviceEnrollmentModeEnum.ts

@@ -0,0 +1,4 @@
+export enum DeviceEnrollmentModeEnum {
+    INITIATED_BY_API = "INITIATED_BY_API",
+    PENDING_FROM_DEVICE = "PENDING_FROM_DEVICE"
+}

package/src/mdm/enums/DeviceLockModeEnum.ts

@@ -0,0 +1,4 @@
+export enum DeviceLockModeEnum {
+    TEMPORARY = "TEMPORARY",
+    FIRM = "FIRM"
+}

package/src/mdm/enums/DeviceNotifyIntensityEnum.ts

@@ -0,0 +1,4 @@
+export enum DeviceNotifyIntensityEnum {
+    BANNER = "BANNER",
+    FULLSCREEN = "FULLSCREEN"
+}

package/src/mdm/enums/DeviceReleaseReasonEnum.ts

@@ -0,0 +1,5 @@
+export enum DeviceReleaseReasonEnum {
+    CREDIT_PAID_OFF = "CREDIT_PAID_OFF",
+    ACCOUNTING_WRITE_OFF = "ACCOUNTING_WRITE_OFF",
+    OTHER = "OTHER"
+}

package/src/mdm/enums/DeviceServiceDeactivateReasonEnum.ts

@@ -0,0 +1,5 @@
+export enum DeviceServiceDeactivateReasonEnum {
+    TENURE_END = "TENURE_END",
+    CASH_SALE = "CASH_SALE",
+    OTHER = "OTHER"
+}

package/src/mdm/enums/MdmDeviceStatusEnum.ts

@@ -0,0 +1,10 @@
+export enum MdmDeviceStatusEnum {
+    NOT_ENROLLED = "NOT_ENROLLED",
+    ENROLLMENT_PENDING = "ENROLLMENT_PENDING",
+    ACTIVE = "ACTIVE",
+    NOTIFIED = "NOTIFIED",
+    APPS_RESTRICTED = "APPS_RESTRICTED",
+    LOCKED = "LOCKED",
+    RELEASED = "RELEASED",
+    UNKNOWN = "UNKNOWN"
+}

package/src/mdm/enums/MdmErrorCodeEnum.ts

@@ -0,0 +1,17 @@
+export enum MdmErrorCodeEnum {
+    PROVIDER_NOT_SUPPORTED = "PROVIDER_NOT_SUPPORTED",
+    DEVICE_NOT_FOUND = "DEVICE_NOT_FOUND",
+    DEVICE_NOT_ENROLLED = "DEVICE_NOT_ENROLLED",
+    INVALID_REQUEST = "INVALID_REQUEST",
+    PROVIDER_ERROR = "PROVIDER_ERROR",
+    PROVIDER_TIMEOUT = "PROVIDER_TIMEOUT",
+    PROVIDER_RATE_LIMITED = "PROVIDER_RATE_LIMITED",
+    PROVIDER_TRANSIENT_ERROR = "PROVIDER_TRANSIENT_ERROR",
+    PROVIDER_UNREACHABLE = "PROVIDER_UNREACHABLE",
+    PROVIDER_CLIENT_ERROR = "PROVIDER_CLIENT_ERROR",
+    AUTH_FAILED = "AUTH_FAILED",
+    FORBIDDEN = "FORBIDDEN",
+    RESOURCE_NOT_FOUND = "RESOURCE_NOT_FOUND",
+    CONFLICT = "CONFLICT",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}

package/src/mdm/enums/MdmOperationStatusEnum.ts

@@ -0,0 +1,5 @@
+export enum MdmOperationStatusEnum {
+    SUCCESS = "SUCCESS",
+    PENDING = "PENDING",
+    ERROR = "ERROR"
+}

package/src/mdm/enums/MdmOperationTypeEnum.ts

@@ -0,0 +1,15 @@
+export enum MdmOperationTypeEnum {
+    STATUS = "STATUS",
+    LAST_SEEN = "LAST_SEEN",
+    PIN_UNLOCK = "PIN_UNLOCK",
+    LOCK = "LOCK",
+    UNLOCK = "UNLOCK",
+    NOTIFY = "NOTIFY",
+    ENROLL = "ENROLL",
+    RELEASE = "RELEASE",
+    ARCHIVE = "ARCHIVE",
+    DEACTIVATE = "DEACTIVATE",
+    RESTRICT_APPS = "RESTRICT_APPS",
+    AUTO_LOCK_SCHEDULE = "AUTO_LOCK_SCHEDULE",
+    LOG = "LOG"
+}

package/src/mdm/enums/MdmProviderEnum.ts

@@ -0,0 +1,4 @@
+export enum MdmProviderEnum {
+    TRUSTONIC = "TRUSTONIC",
+    DATACULTR = "DATACULTR"
+}

package/src/mdm/index.ts

@@ -0,0 +1,60 @@
+// dtos
+export * from "./dtos/MdmError";
+export * from "./dtos/DeviceLockScreenMessage";
+
+// dtos — bloque A (cobranza)
+export * from "./dtos/DeviceNotifyRequest";
+export * from "./dtos/DeviceNotifyResponse";
+export * from "./dtos/DeviceRestrictAppsRequest";
+export * from "./dtos/DeviceRestrictAppsResponse";
+export * from "./dtos/DeviceLockRequest";
+export * from "./dtos/DeviceLockResponse";
+export * from "./dtos/DeviceUnlockRequest";
+export * from "./dtos/DeviceUnlockResponse";
+export * from "./dtos/DevicePinUnlockRequest";
+export * from "./dtos/DevicePinUnlockResponse";
+
+// dtos — bloque B (consulta)
+export * from "./dtos/DeviceStatusRequest";
+export * from "./dtos/DeviceStatusResponse";
+
+// dtos — bloque C (ciclo de vida)
+export * from "./dtos/DeviceEnrollRequest";
+export * from "./dtos/DeviceEnrollInitiateResponse";
+export * from "./dtos/DeviceEnrollStatusRequest";
+export * from "./dtos/DeviceEnrollStatusResponse";
+export * from "./dtos/DeviceReleaseRequest";
+export * from "./dtos/DeviceReleaseInitiateResponse";
+export * from "./dtos/DeviceReleaseStatusRequest";
+export * from "./dtos/DeviceReleaseStatusResponse";
+export * from "./dtos/DeviceServiceDeactivateRequest";
+export * from "./dtos/DeviceServiceDeactivateInitiateResponse";
+export * from "./dtos/DeviceServiceDeactivateStatusRequest";
+export * from "./dtos/DeviceServiceDeactivateStatusResponse";
+export * from "./dtos/DeviceArchiveRequest";
+export * from "./dtos/DeviceArchiveResponse";
+
+// dtos — bloque D (datacultr-specific)
+export * from "./dtos/DeviceAutoLockScheduleRequest";
+export * from "./dtos/DeviceAutoLockScheduleResponse";
+export * from "./dtos/DeviceLastSeenRequest";
+export * from "./dtos/DeviceLastSeenResponse";
+export * from "./dtos/DeviceLogRequest";
+export * from "./dtos/DeviceLogResponse";
+export * from "./dtos/DeviceLogEntry";
+
+// dtos — eventos entrantes (webhooks de datacultr)
+export * from "./dtos/DeviceEnrollmentCompletedEvent";
+export * from "./dtos/DeviceReleaseCompletedEvent";
+
+// enums
+export * from "./enums/DeviceLockModeEnum";
+export * from "./enums/DeviceNotifyIntensityEnum";
+export * from "./enums/DeviceEnrollmentModeEnum";
+export * from "./enums/DeviceReleaseReasonEnum";
+export * from "./enums/DeviceServiceDeactivateReasonEnum";
+export * from "./enums/MdmDeviceStatusEnum";
+export * from "./enums/MdmOperationStatusEnum";
+export * from "./enums/MdmErrorCodeEnum";
+export * from "./enums/MdmProviderEnum";
+export * from "./enums/MdmOperationTypeEnum";