@fiado/type-kit 3.607.0 → 3.609.0

package/bin/loanOfferings/index.js

@@ -33,6 +33,8 @@ __exportStar(require("./enums/SegmentStatusEnum"), exports);
 __exportStar(require("./enums/SegmentColorSlotEnum"), exports);
 __exportStar(require("./enums/SegmentFilterIdEnum"), exports);
 __exportStar(require("./enums/PrepaymentMinimumModeEnum"), exports);
+// Constantes
+__exportStar(require("./constants/promotionSkuBatch"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/CreditPlan"), exports);
 __exportStar(require("./dtos/PrepaymentMinimum"), exports);
@@ -64,6 +66,9 @@ __exportStar(require("./dtos/requests/ChangeSegmentStatusRequest"), exports);
 __exportStar(require("./dtos/requests/ResolveCustomerSegmentsRequest"), exports);
 __exportStar(require("./dtos/requests/ComputeAmortizationScheduleRequest"), exports);
 __exportStar(require("./dtos/requests/ListSegmentCatalogQuery"), exports);
+__exportStar(require("./dtos/requests/PromotionSkuInput"), exports);
+__exportStar(require("./dtos/requests/ListPromotedSkusRequest"), exports);
+__exportStar(require("./dtos/requests/ListSkuPromotionsRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/CreditPlanResponse"), exports);
 __exportStar(require("./dtos/responses/FinancierResponse"), exports);

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.609.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/loanCredit/dtos/requests/OriginateLoanCreditRequest.ts

@@ -8,6 +8,8 @@ import {
     Max,
     Min,
 } from 'class-validator';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 
 /**
@@ -106,4 +108,16 @@ export class OriginateLoanCreditRequest {
     @IsOptional()
     @IsString()
     productSku?: string;
+
+    /** Tipo del equipo: resuelve promociones acotadas por tipo. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductCategoryEnum)
+    productCategory?: ProductCategoryEnum;
+
+    /** Gama del equipo: resuelve promociones acotadas por gama. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductTierEnum)
+    productTier?: ProductTierEnum;
 }

package/src/loanOfferings/constants/promotionSkuBatch.ts

@@ -0,0 +1,2 @@
+/** Tope de SKUs por llamada a los lotes de promociones por SKU; el caller parte en bloques. */
+export const PROMOTION_SKU_BATCH_MAX_ITEMS = 100;

package/src/loanOfferings/dtos/requests/CreatePromotionRequest.ts

@@ -10,6 +10,8 @@ import {
     ValidateNested,
 } from 'class-validator';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 import { PromotionEffectInput } from './PromotionEffectInput';
 
 /**
@@ -49,6 +51,20 @@ export class CreatePromotionRequest {
     @IsString({ each: true })
     productSkus?: string[] | null;
 
+    /** Tipos de producto alcanzados; ausente o `null` = todos los tipos. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(ProductCategoryEnum, { each: true })
+    productCategories?: ProductCategoryEnum[] | null;
+
+    /** Gamas alcanzadas; ausente o `null` = todas las gamas. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(ProductTierEnum, { each: true })
+    tiers?: ProductTierEnum[] | null;
+
     /** Tiendas alcanzadas. `null` o ausente = todas. */
     @Expose()
     @IsOptional()

package/src/loanOfferings/dtos/requests/ListPromotedSkusRequest.ts

@@ -0,0 +1,32 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsEnum, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { PROMOTION_SKU_BATCH_MAX_ITEMS } from '../../constants/promotionSkuBatch';
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { PromotionSkuInput } from './PromotionSkuInput';
+
+/** Body de `POST /private/promotions/promoted-skus` (M2M): SKUs del lote con promoción viva para el badge; hasta 100 SKUs. */
+export class ListPromotedSkusRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+
+    /** Nivel del cliente si loan-scoring ya corrió. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(CreditPlanLevelEnum)
+    level?: CreditPlanLevelEnum;
+
+    /** Segmento del cliente si ya se resolvió. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    segmentId?: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayMaxSize(PROMOTION_SKU_BATCH_MAX_ITEMS)
+    @ValidateNested({ each: true })
+    @Type(() => PromotionSkuInput)
+    items!: PromotionSkuInput[];
+}

package/src/loanOfferings/dtos/requests/ListSkuPromotionsRequest.ts

@@ -0,0 +1,32 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsEnum, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { PROMOTION_SKU_BATCH_MAX_ITEMS } from '../../constants/promotionSkuBatch';
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { PromotionSkuInput } from './PromotionSkuInput';
+
+/** Body de `POST /private/promotions/by-sku` (M2M): promociones vivas de cada SKU del lote; hasta 100 SKUs. */
+export class ListSkuPromotionsRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+
+    /** Nivel del cliente si loan-scoring ya corrió. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(CreditPlanLevelEnum)
+    level?: CreditPlanLevelEnum;
+
+    /** Segmento del cliente si ya se resolvió. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    segmentId?: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayMaxSize(PROMOTION_SKU_BATCH_MAX_ITEMS)
+    @ValidateNested({ each: true })
+    @Type(() => PromotionSkuInput)
+    items!: PromotionSkuInput[];
+}

package/src/loanOfferings/dtos/requests/PromotionSkuInput.ts

@@ -0,0 +1,21 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString } from 'class-validator';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
+
+/** Un SKU con su tipo y gama; sin ellos no cumple un alcance por tipo o por gama. */
+export class PromotionSkuInput {
+    @Expose()
+    @IsString()
+    sku!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductCategoryEnum)
+    category?: ProductCategoryEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductTierEnum)
+    tier?: ProductTierEnum;
+}

package/src/loanOfferings/dtos/requests/SimulateCreditPlanRequest.ts

@@ -1,5 +1,8 @@
 import { Expose } from 'class-transformer';
-import { IsArray, IsInt, IsNumber, IsOptional, IsString, Max, Min } from 'class-validator';
+import { IsArray, IsEnum, IsInt, IsNumber, IsOptional, IsString, Max, Min } from 'class-validator';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
+
 
 /**
  * Body de POST /private/credit-plans/:planId/simulate y query de GET /credit-plans/:planId/simulator.
@@ -46,6 +49,18 @@ export class SimulateCreditPlanRequest {
     @IsString()
     productSku?: string;
 
+    /** Tipo del equipo. Sin él no se resuelven las promociones acotadas por tipo. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductCategoryEnum)
+    productCategory?: ProductCategoryEnum;
+
+    /** Gama del equipo. Sin ella no se resuelven las promociones acotadas por gama. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductTierEnum)
+    productTier?: ProductTierEnum;
+
     /**
      * Segmentos del cliente, los que devolvió `POST /private/segments/resolve`. Un arreglo vacío
      * declara que el cliente no está en ninguno; ausente declara que el caller no lo consultó.

package/src/loanOfferings/dtos/requests/UpdatePromotionRequest.ts

@@ -10,6 +10,8 @@ import {
     ValidateNested,
 } from 'class-validator';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 import { PromotionEffectInput } from './PromotionEffectInput';
 
 /**
@@ -52,6 +54,20 @@ export class UpdatePromotionRequest {
     @IsString({ each: true })
     productSkus?: string[] | null;
 
+    /** Tipos de producto alcanzados; ausente o `null` = todos los tipos. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(ProductCategoryEnum, { each: true })
+    productCategories?: ProductCategoryEnum[] | null;
+
+    /** Gamas alcanzadas; ausente o `null` = todas las gamas. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(ProductTierEnum, { each: true })
+    tiers?: ProductTierEnum[] | null;
+
     /** Tiendas alcanzadas. `null` o ausente = todas. */
     @Expose()
     @IsOptional()

package/src/loanOfferings/dtos/responses/PromotionResponse.ts

@@ -1,3 +1,5 @@
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { PromotionEffectKindEnum } from '../../enums/PromotionEffectKindEnum';
 import { PromotionPhaseEnum } from '../../enums/PromotionPhaseEnum';
@@ -22,6 +24,10 @@ export interface PromotionResponse {
     targetLevels: CreditPlanLevelEnum[];
     /** `null` = alcanza a todos los productos. */
     productSkus: string[] | null;
+    /** `null` = alcanza a todos los tipos de producto. */
+    productCategories: ProductCategoryEnum[] | null;
+    /** `null` = alcanza a todas las gamas. */
+    tiers: ProductTierEnum[] | null;
     /** `null` = alcanza a todas las tiendas. Dimensión «Tienda / canal» del alcance. */
     storeIds: string[] | null;
     validFrom: string | null;

package/src/loanOfferings/index.ts

@@ -18,6 +18,9 @@ export * from './enums/SegmentColorSlotEnum';
 export * from './enums/SegmentFilterIdEnum';
 export * from './enums/PrepaymentMinimumModeEnum';
 
+// Constantes
+export * from './constants/promotionSkuBatch';
+
 // Entity DTOs
 export * from './dtos/CreditPlan';
 export * from './dtos/PrepaymentMinimum';
@@ -50,6 +53,9 @@ export * from './dtos/requests/ChangeSegmentStatusRequest';
 export * from './dtos/requests/ResolveCustomerSegmentsRequest';
 export * from './dtos/requests/ComputeAmortizationScheduleRequest';
 export * from './dtos/requests/ListSegmentCatalogQuery';
+export * from './dtos/requests/PromotionSkuInput';
+export * from './dtos/requests/ListPromotedSkusRequest';
+export * from './dtos/requests/ListSkuPromotionsRequest';
 
 // Response DTOs
 export * from './dtos/responses/CreditPlanResponse';

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';
+    }
+}