@fiado/type-kit 3.607.0 → 3.608.0

package/_test_/unit/retailIntegration/eventPayloadBounds.test.ts

@@ -42,7 +42,7 @@ const price = { basePrice: '4299.00', listPrice: null, effectiveFrom: '2026-08-1
 const product = {
     sku: 'SAM-A17-128-NEG', externalId: '9001', brand: 'Samsung', model: 'A17', color: 'Negro', capacity: '128 GB', description: null,
     category: 'PHONE', trackingMode: 'IMEI', tier: null, currencyId: 'MXN', price,
-    eligibleFinanciers: ['SUREKEEP'], mdmProvider: null, status: 'ACTIVE',
+    eligibleFinanciers: ['SUREKEEP'], mdmProvider: 'TRUSTONIC', mdmMode: 'SCHEDULED', status: 'ACTIVE',
 };
 const piece = { sku: 'SAM-A17-128-NEG', identifier: '356938035643809', storeId: '12', status: 'SOLD', reason: null };
 const movement = { movementType: 'SALE', storeId: '12', targetStoreId: null, pieces: [piece], stock: [] };

package/_test_/unit/retailIntegration/eventPayloads.test.ts

@@ -6,7 +6,8 @@ import { RetailUserEventPayload } from '../../../src/retailIntegration/dtos/Reta
 import { ProductEventPayload } from '../../../src/retailIntegration/dtos/ProductEventPayload';
 import { InventoryEventPayload } from '../../../src/retailIntegration/dtos/InventoryEventPayload';
 import { RETAIL_EVENT_PIECES_MAX } from '../../../src/retailIntegration/constants/retailIntegrationLimits';
-import { RetailProductTierEnum } from '../../../src/retailIntegration/enums';
+import { RetailMdmModeEnum, RetailProductTierEnum } from '../../../src/retailIntegration/enums';
+import { MdmLockModeEnum } from '../../../src/retailCatalog/enums/MdmLockModeEnum';
 import { ProductTierEnum } from '../../../src/retailCatalog/enums/ProductTierEnum';
 
 function paths(errors: ValidationError[], prefix = ''): string[] {
@@ -80,7 +81,7 @@ const product = {
     sku: 'SAM-A17-128-NEG', externalId: '9001', brand: 'Samsung', model: 'A17', color: 'Negro', capacity: '128 GB', description: null,
     category: 'PHONE', trackingMode: 'IMEI', tier: null, currencyId: 'MXN',
     price: { basePrice: '4299.00', listPrice: null, effectiveFrom: '2026-08-17T20:32:05Z' },
-    eligibleFinanciers: ['SUREKEEP'], mdmProvider: null, status: 'ACTIVE',
+    eligibleFinanciers: ['SUREKEEP'], mdmProvider: 'TRUSTONIC', mdmMode: 'SCHEDULED', status: 'ACTIVE',
 };
 
 const piece = { sku: 'SAM-A17-128-NEG', identifier: '356938035643809', storeId: '12', status: 'SOLD', reason: null };
@@ -91,10 +92,6 @@ describe('ProductEventPayload', () => {
         expect(await errorsOf(ProductEventPayload, product)).toEqual([]);
     });
 
-    it.each(['TRUSTONIC', 'DATACULTR', 'MOTOSAFE'])('acepta mdmProvider %s', async (mdmProvider) => {
-        expect(await errorsOf(ProductEventPayload, { ...product, mdmProvider })).toEqual([]);
-    });
-
     it.each([
         ['ausente', undefined],
         ['null', null],
@@ -130,10 +127,60 @@ describe('ProductEventPayload', () => {
         expect(Object.values(RetailProductTierEnum)).toEqual(Object.values(ProductTierEnum));
     });
 
+    it.each([
+        ['TRUSTONIC', 'SCHEDULED'],
+        ['TRUSTONIC', 'ONDEMAND'],
+        ['DATACULTR', 'SCHEDULED'],
+        ['DATACULTR', 'ONDEMAND'],
+        ['MOTOSAFE', 'ONDEMAND'],
+    ])('acepta un teléfono IMEI con mdmProvider %s y mdmMode %s', async (mdmProvider, mdmMode) => {
+        expect(await errorsOf(ProductEventPayload, { ...product, mdmProvider, mdmMode })).toEqual([]);
+    });
+
     it('rechaza un mdmProvider fuera del enum', async () => {
         expect(await errorsOf(ProductEventPayload, { ...product, mdmProvider: 'KNOX' })).toContain('mdmProvider');
     });
 
+    it('rechaza un teléfono IMEI sin mdmProvider', async () => {
+        expect(await errorsOf(ProductEventPayload, { ...product, mdmProvider: null, mdmMode: null })).toEqual(['mdmProvider']);
+        expect(await errorsOf(ProductEventPayload, { ...product, mdmProvider: undefined, mdmMode: null })).toEqual(['mdmProvider']);
+    });
+
+    it('rechaza MOTOSAFE con SCHEDULED', async () => {
+        expect(await errorsOf(ProductEventPayload, { ...product, mdmProvider: 'MOTOSAFE', mdmMode: 'SCHEDULED' })).toEqual(['mdmMode']);
+    });
+
+    it.each([
+        ['null', null],
+        ['ausente', undefined],
+        ['fuera del enum', 'ALWAYS'],
+        ['con guion bajo', 'ON_DEMAND'],
+    ])('rechaza mdmMode %s cuando hay mdmProvider', async (_case, mdmMode) => {
+        expect(await errorsOf(ProductEventPayload, { ...product, mdmMode })).toEqual(['mdmMode']);
+    });
+
+    it.each([
+        ['ACCESSORY', 'QUANTITY'],
+        ['SIM', 'SERIAL'],
+    ])('acepta un %s %s con mdmProvider y mdmMode en null', async (category, trackingMode) => {
+        expect(await errorsOf(ProductEventPayload, { ...product, category, trackingMode, mdmProvider: null, mdmMode: null })).toEqual([]);
+    });
+
+    it('un producto sin IMEI rechaza mdmProvider y mdmMode', async () => {
+        const accessory = { ...product, category: 'ACCESSORY', trackingMode: 'QUANTITY' };
+        expect(await errorsOf(ProductEventPayload, { ...accessory, mdmMode: null })).toEqual(['mdmProvider', 'mdmMode']);
+        expect(await errorsOf(ProductEventPayload, { ...accessory, mdmProvider: null })).toEqual(['mdmMode']);
+    });
+
+    it('al transformar, mdmMode ausente queda null', () => {
+        const { mdmMode: _mode, ...withoutMode } = product;
+        expect(plainToInstance(ProductEventPayload, withoutMode).mdmMode).toBeNull();
+    });
+
+    it('el modo de MDM de la integración trae los mismos valores que el de catálogo', () => {
+        expect(Object.values(RetailMdmModeEnum).sort()).toEqual(Object.values(MdmLockModeEnum).sort());
+    });
+
     it.each([
         ['sku', { sku: 'SAM_A17' }],
         ['price.basePrice', { price: { ...product.price, basePrice: '4299' } }],

package/_test_/unit/retailIntegration/retailSystemEnums.test.ts

@@ -4,6 +4,7 @@ import {
     RetailCurrencyEnum,
     RetailFinancierEnum,
     RetailLinePaymentTypeEnum,
+    RetailMdmModeEnum,
     RetailMdmProviderEnum,
     RetailPaymentFrequencyEnum,
     RetailPaymentMethodEnum,
@@ -29,6 +30,7 @@ describe('enums de los objetos del retailer', () => {
         [RetailCurrencyEnum, ['MXN', 'USD']],
         [RetailFinancierEnum, ['SUREKEEP', 'PAYJOY', 'CREDIYA', 'LESPAGO', 'INNOVA']],
         [RetailMdmProviderEnum, ['TRUSTONIC', 'DATACULTR', 'MOTOSAFE']],
+        [RetailMdmModeEnum, ['SCHEDULED', 'ONDEMAND']],
         [RetailProductStatusEnum, ['ACTIVE', 'INACTIVE', 'DISCONTINUED']],
         [RetailPieceStatusEnum, ['AVAILABLE', 'IN_TRANSIT', 'SOLD', 'DAMAGED']],
         [RetailPieceReasonEnum, ['WARRANTY', 'DAMAGED_RETURN', 'SHRINKAGE']],

package/bin/retailIntegration/dtos/ProductEventPayload.d.ts

@@ -1,4 +1,4 @@
-import type { RetailCurrency, RetailFinancier, RetailMdmProvider, RetailProductCategory, RetailProductStatus, RetailProductTier, RetailSystemProduct, RetailSystemProductPrice, RetailTrackingMode } from '../models/RetailSystemProduct';
+import type { RetailCurrency, RetailFinancier, RetailMdmMode, RetailMdmProvider, RetailProductCategory, RetailProductStatus, RetailProductTier, RetailSystemProduct, RetailSystemProductPrice, RetailTrackingMode } from '../models/RetailSystemProduct';
 /** Precio del producto en decimales string. */
 export declare class ProductEventPricePayload implements RetailSystemProductPrice {
     basePrice: string;
@@ -23,5 +23,7 @@ export declare class ProductEventPayload implements RetailSystemProduct {
     /** Opcional en el evento: ausente o `null` se vuelve la lista de todas las financieras. */
     eligibleFinanciers: RetailFinancier[];
     mdmProvider: RetailMdmProvider | null;
+    /** Opcional en el evento: ausente se vuelve `null`. */
+    mdmMode: RetailMdmMode | null;
     status: RetailProductStatus;
 }

package/bin/retailIntegration/dtos/ProductEventPayload.js

@@ -16,6 +16,7 @@ const retailIntegrationLimits_1 = require("../constants/retailIntegrationLimits"
 const enums_1 = require("../enums");
 const IsIsoDateTimeWithZone_1 = require("../validators/IsIsoDateTimeWithZone");
 const payloadValidators_1 = require("../validators/payloadValidators");
+const productValidators_1 = require("../validators/productValidators");
 /** Precio del producto en decimales string. */
 class ProductEventPricePayload {
 }
@@ -118,10 +119,15 @@ __decorate([
     __metadata("design:type", Array)
 ], ProductEventPayload.prototype, "eligibleFinanciers", void 0);
 __decorate([
-    (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
-    (0, class_validator_1.IsIn)(Object.values(enums_1.RetailMdmProviderEnum)),
+    (0, class_validator_1.Validate)(productValidators_1.MdmProviderMatchesTracking),
     __metadata("design:type", String)
 ], ProductEventPayload.prototype, "mdmProvider", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ?? null),
+    (0, class_validator_1.Validate)(productValidators_1.MdmModeMatchesProvider),
+    __metadata("design:type", String)
+], ProductEventPayload.prototype, "mdmMode", void 0);
 __decorate([
     (0, class_validator_1.IsIn)(Object.values(enums_1.RetailProductStatusEnum)),
     __metadata("design:type", String)

package/bin/retailIntegration/enums/RetailMdmModeEnum.d.ts

@@ -0,0 +1,5 @@
+/** Modo del candado MDM del equipo; mismos valores que `MdmLockModeEnum` de retailCatalog. */
+export declare enum RetailMdmModeEnum {
+    SCHEDULED = "SCHEDULED",
+    ONDEMAND = "ONDEMAND"
+}

package/bin/retailIntegration/enums/RetailMdmModeEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailMdmModeEnum = void 0;
+/** Modo del candado MDM del equipo; mismos valores que `MdmLockModeEnum` de retailCatalog. */
+var RetailMdmModeEnum;
+(function (RetailMdmModeEnum) {
+    RetailMdmModeEnum["SCHEDULED"] = "SCHEDULED";
+    RetailMdmModeEnum["ONDEMAND"] = "ONDEMAND";
+})(RetailMdmModeEnum || (exports.RetailMdmModeEnum = RetailMdmModeEnum = {}));

package/bin/retailIntegration/enums/index.d.ts

@@ -10,6 +10,7 @@ export * from './RetailProductTierEnum';
 export * from './RetailCurrencyEnum';
 export * from './RetailFinancierEnum';
 export * from './RetailMdmProviderEnum';
+export * from './RetailMdmModeEnum';
 export * from './RetailProductStatusEnum';
 export * from './RetailPieceStatusEnum';
 export * from './RetailPieceReasonEnum';

package/bin/retailIntegration/enums/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./RetailProductTierEnum"), exports);
 __exportStar(require("./RetailCurrencyEnum"), exports);
 __exportStar(require("./RetailFinancierEnum"), exports);
 __exportStar(require("./RetailMdmProviderEnum"), exports);
+__exportStar(require("./RetailMdmModeEnum"), exports);
 __exportStar(require("./RetailProductStatusEnum"), exports);
 __exportStar(require("./RetailPieceStatusEnum"), exports);
 __exportStar(require("./RetailPieceReasonEnum"), exports);

package/bin/retailIntegration/index.d.ts

@@ -5,6 +5,7 @@ export * from './validators/IsIsoDateTimeWithZone';
 export * from './validators/IsMovementsRangeValid';
 export * from './validators/IsCalendarDate';
 export * from './validators/saleValidators';
+export * from './validators/productValidators';
 export * from './dtos/RetailEventEnvelope';
 export * from './dtos/ReceiveStoreEventRequest';
 export * from './dtos/ReceiveRetailUserEventRequest';

package/bin/retailIntegration/index.js

@@ -21,6 +21,7 @@ __exportStar(require("./validators/IsIsoDateTimeWithZone"), exports);
 __exportStar(require("./validators/IsMovementsRangeValid"), exports);
 __exportStar(require("./validators/IsCalendarDate"), exports);
 __exportStar(require("./validators/saleValidators"), exports);
+__exportStar(require("./validators/productValidators"), exports);
 __exportStar(require("./dtos/RetailEventEnvelope"), exports);
 __exportStar(require("./dtos/ReceiveStoreEventRequest"), exports);
 __exportStar(require("./dtos/ReceiveRetailUserEventRequest"), exports);

package/bin/retailIntegration/models/RetailSystemProduct.d.ts

@@ -1,10 +1,11 @@
-import { RetailCurrencyEnum, RetailFinancierEnum, RetailMdmProviderEnum, RetailProductCategoryEnum, RetailProductStatusEnum, RetailProductTierEnum, RetailTrackingModeEnum } from '../enums';
+import { RetailCurrencyEnum, RetailFinancierEnum, RetailMdmModeEnum, RetailMdmProviderEnum, RetailProductCategoryEnum, RetailProductStatusEnum, RetailProductTierEnum, RetailTrackingModeEnum } from '../enums';
 export type RetailProductCategory = `${RetailProductCategoryEnum}`;
 export type RetailTrackingMode = `${RetailTrackingModeEnum}`;
 export type RetailProductTier = `${RetailProductTierEnum}`;
 export type RetailCurrency = `${RetailCurrencyEnum}`;
 export type RetailFinancier = `${RetailFinancierEnum}`;
 export type RetailMdmProvider = `${RetailMdmProviderEnum}`;
+export type RetailMdmMode = `${RetailMdmModeEnum}`;
 export type RetailProductStatus = `${RetailProductStatusEnum}`;
 /** Precios como decimal en string con dos decimales. */
 export interface RetailSystemProductPrice {
@@ -28,5 +29,7 @@ export interface RetailSystemProduct {
     price: RetailSystemProductPrice;
     eligibleFinanciers: RetailFinancier[];
     mdmProvider: RetailMdmProvider | null;
+    /** Modo del candado; obligatorio cuando hay `mdmProvider`. */
+    mdmMode?: RetailMdmMode | null;
     status: RetailProductStatus;
 }

package/bin/retailIntegration/validators/productValidators.d.ts

@@ -0,0 +1,13 @@
+import { ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+/** Un producto rastreado por IMEI lleva MDM. */
+export declare function requiresMdm(trackingMode: unknown): boolean;
+/** `mdmProvider`: obligatorio con `trackingMode` IMEI y `null` en los demás productos. */
+export declare class MdmProviderMatchesTracking implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}
+/** `mdmMode`: obligatorio con `mdmProvider` y `null` sin él; MOTOSAFE solo opera en ONDEMAND. */
+export declare class MdmModeMatchesProvider implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}

package/bin/retailIntegration/validators/productValidators.js

@@ -0,0 +1,49 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MdmModeMatchesProvider = exports.MdmProviderMatchesTracking = void 0;
+exports.requiresMdm = requiresMdm;
+const class_validator_1 = require("class-validator");
+const enums_1 = require("../enums");
+/** Un producto rastreado por IMEI lleva MDM. */
+function requiresMdm(trackingMode) {
+    return trackingMode === enums_1.RetailTrackingModeEnum.IMEI;
+}
+/** `mdmProvider`: obligatorio con `trackingMode` IMEI y `null` en los demás productos. */
+let MdmProviderMatchesTracking = class MdmProviderMatchesTracking {
+    validate(value, args) {
+        if (!requiresMdm(args.object.trackingMode))
+            return value === null;
+        return Object.values(enums_1.RetailMdmProviderEnum).includes(value);
+    }
+    defaultMessage() {
+        return 'mdmProvider es obligatorio con trackingMode IMEI y null en los demás productos';
+    }
+};
+exports.MdmProviderMatchesTracking = MdmProviderMatchesTracking;
+exports.MdmProviderMatchesTracking = MdmProviderMatchesTracking = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'mdmProviderMatchesTracking', async: false })
+], MdmProviderMatchesTracking);
+/** `mdmMode`: obligatorio con `mdmProvider` y `null` sin él; MOTOSAFE solo opera en ONDEMAND. */
+let MdmModeMatchesProvider = class MdmModeMatchesProvider {
+    validate(value, args) {
+        const provider = args.object.mdmProvider;
+        if (provider === null || provider === undefined)
+            return value === null;
+        if (provider === enums_1.RetailMdmProviderEnum.MOTOSAFE)
+            return value === enums_1.RetailMdmModeEnum.ONDEMAND;
+        return Object.values(enums_1.RetailMdmModeEnum).includes(value);
+    }
+    defaultMessage() {
+        return 'mdmMode es obligatorio con mdmProvider (MOTOSAFE solo ONDEMAND) y null sin él';
+    }
+};
+exports.MdmModeMatchesProvider = MdmModeMatchesProvider;
+exports.MdmModeMatchesProvider = MdmModeMatchesProvider = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'mdmModeMatchesProvider', async: false })
+], MdmModeMatchesProvider);

package/package.json

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

package/src/retailIntegration/dtos/ProductEventPayload.ts

@@ -11,7 +11,6 @@ import {
 import {
     RetailCurrencyEnum,
     RetailFinancierEnum,
-    RetailMdmProviderEnum,
     RetailProductCategoryEnum,
     RetailProductStatusEnum,
     RetailProductTierEnum,
@@ -20,6 +19,7 @@ import {
 import type {
     RetailCurrency,
     RetailFinancier,
+    RetailMdmMode,
     RetailMdmProvider,
     RetailProductCategory,
     RetailProductStatus,
@@ -30,6 +30,7 @@ import type {
 } from '../models/RetailSystemProduct';
 import { IsIsoDateTimeWithZone } from '../validators/IsIsoDateTimeWithZone';
 import { isNullOrValidated } from '../validators/payloadValidators';
+import { MdmModeMatchesProvider, MdmProviderMatchesTracking } from '../validators/productValidators';
 
 /** Precio del producto en decimales string. */
 export class ProductEventPricePayload implements RetailSystemProductPrice {
@@ -58,6 +59,9 @@ export class ProductEventPayload implements RetailSystemProduct {
     @Expose() @Transform(({ value }) => value ?? Object.values(RetailFinancierEnum))
     @IsOptional() @IsArray() @ArrayNotEmpty() @ArrayUnique() @ArrayMaxSize(RETAIL_ELIGIBLE_FINANCIERS_MAX) @IsIn(Object.values(RetailFinancierEnum), { each: true })
     eligibleFinanciers!: RetailFinancier[];
-    @ValidateIf(isNullOrValidated) @IsIn(Object.values(RetailMdmProviderEnum)) mdmProvider!: RetailMdmProvider | null;
+    @Validate(MdmProviderMatchesTracking) mdmProvider!: RetailMdmProvider | null;
+    /** Opcional en el evento: ausente se vuelve `null`. */
+    @Expose() @Transform(({ value }) => value ?? null)
+    @Validate(MdmModeMatchesProvider) mdmMode!: RetailMdmMode | null;
     @IsIn(Object.values(RetailProductStatusEnum)) status!: RetailProductStatus;
 }

package/src/retailIntegration/enums/RetailMdmModeEnum.ts

@@ -0,0 +1,5 @@
+/** Modo del candado MDM del equipo; mismos valores que `MdmLockModeEnum` de retailCatalog. */
+export enum RetailMdmModeEnum {
+    SCHEDULED = 'SCHEDULED',
+    ONDEMAND = 'ONDEMAND',
+}

package/src/retailIntegration/enums/index.ts

@@ -10,6 +10,7 @@ export * from './RetailProductTierEnum';
 export * from './RetailCurrencyEnum';
 export * from './RetailFinancierEnum';
 export * from './RetailMdmProviderEnum';
+export * from './RetailMdmModeEnum';
 export * from './RetailProductStatusEnum';
 export * from './RetailPieceStatusEnum';
 export * from './RetailPieceReasonEnum';

package/src/retailIntegration/index.ts

@@ -5,6 +5,7 @@ export * from './validators/IsIsoDateTimeWithZone';
 export * from './validators/IsMovementsRangeValid';
 export * from './validators/IsCalendarDate';
 export * from './validators/saleValidators';
+export * from './validators/productValidators';
 export * from './dtos/RetailEventEnvelope';
 export * from './dtos/ReceiveStoreEventRequest';
 export * from './dtos/ReceiveRetailUserEventRequest';

package/src/retailIntegration/models/RetailSystemProduct.ts

@@ -1,6 +1,7 @@
 import {
     RetailCurrencyEnum,
     RetailFinancierEnum,
+    RetailMdmModeEnum,
     RetailMdmProviderEnum,
     RetailProductCategoryEnum,
     RetailProductStatusEnum,
@@ -14,6 +15,7 @@ export type RetailProductTier = `${RetailProductTierEnum}`;
 export type RetailCurrency = `${RetailCurrencyEnum}`;
 export type RetailFinancier = `${RetailFinancierEnum}`;
 export type RetailMdmProvider = `${RetailMdmProviderEnum}`;
+export type RetailMdmMode = `${RetailMdmModeEnum}`;
 export type RetailProductStatus = `${RetailProductStatusEnum}`;
 
 /** Precios como decimal en string con dos decimales. */
@@ -39,5 +41,7 @@ export interface RetailSystemProduct {
     price: RetailSystemProductPrice;
     eligibleFinanciers: RetailFinancier[];
     mdmProvider: RetailMdmProvider | null;
+    /** Modo del candado; obligatorio cuando hay `mdmProvider`. */
+    mdmMode?: RetailMdmMode | null;
     status: RetailProductStatus;
 }

package/src/retailIntegration/validators/productValidators.ts

@@ -0,0 +1,35 @@
+import { ValidationArguments, ValidatorConstraint, ValidatorConstraintInterface } from 'class-validator';
+import { RetailMdmModeEnum, RetailMdmProviderEnum, RetailTrackingModeEnum } from '../enums';
+
+/** Un producto rastreado por IMEI lleva MDM. */
+export function requiresMdm(trackingMode: unknown): boolean {
+    return trackingMode === RetailTrackingModeEnum.IMEI;
+}
+
+/** `mdmProvider`: obligatorio con `trackingMode` IMEI y `null` en los demás productos. */
+@ValidatorConstraint({ name: 'mdmProviderMatchesTracking', async: false })
+export class MdmProviderMatchesTracking implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean {
+        if (!requiresMdm((args.object as { trackingMode?: unknown }).trackingMode)) return value === null;
+        return (Object.values(RetailMdmProviderEnum) as unknown[]).includes(value);
+    }
+
+    defaultMessage(): string {
+        return 'mdmProvider es obligatorio con trackingMode IMEI y null en los demás productos';
+    }
+}
+
+/** `mdmMode`: obligatorio con `mdmProvider` y `null` sin él; MOTOSAFE solo opera en ONDEMAND. */
+@ValidatorConstraint({ name: 'mdmModeMatchesProvider', async: false })
+export class MdmModeMatchesProvider implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean {
+        const provider = (args.object as { mdmProvider?: unknown }).mdmProvider;
+        if (provider === null || provider === undefined) return value === null;
+        if (provider === RetailMdmProviderEnum.MOTOSAFE) return value === RetailMdmModeEnum.ONDEMAND;
+        return (Object.values(RetailMdmModeEnum) as unknown[]).includes(value);
+    }
+
+    defaultMessage(): string {
+        return 'mdmMode es obligatorio con mdmProvider (MOTOSAFE solo ONDEMAND) y null sin él';
+    }
+}