@fiado/type-kit 3.607.0 → 3.609.0

package/_test_/unit/loanCredit/dtos/originateLoanCreditRequest.test.ts

@@ -53,4 +53,13 @@ describe('OriginateLoanCreditRequest', () => {
 
         expect(errors.some((error) => error.property === 'sellerId')).toBe(true);
     });
+
+    it('acepta tipo y gama del equipo opcionales y rechaza valores fuera del enum', async () => {
+        const ok = await validateWhitelisted({ ...BASE, productCategory: 'PHONE', productTier: 'HIGH' });
+        expect(ok.errors).toEqual([]);
+        expect([ok.dto.productCategory, ok.dto.productTier]).toEqual(['PHONE', 'HIGH']);
+
+        const bad = await validateWhitelisted({ ...BASE, productCategory: 'CAR', productTier: 'ULTRA' });
+        expect(bad.errors.map((error) => error.property).sort()).toEqual(['productCategory', 'productTier']);
+    });
 });

package/_test_/unit/loanOfferings/promotionCategoryTierScope.test.ts

@@ -0,0 +1,89 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    CreatePromotionRequest,
+    ListPromotedSkusRequest,
+    ListSkuPromotionsRequest,
+    PROMOTION_SKU_BATCH_MAX_ITEMS,
+    SimulateCreditPlanRequest,
+    UpdatePromotionRequest,
+} from '../../../src/loanOfferings/index';
+import type { PromotionResponse } from '../../../src/loanOfferings/index';
+import { ProductCategoryEnum } from '../../../src/retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../src/retailCatalog/enums/ProductTierEnum';
+
+type DtoClass = new () => object;
+
+const errorsOf = async (dtoClass: DtoClass, body: object): Promise<string[]> =>
+    (await validate(plainToInstance(dtoClass, body, { excludeExtraneousValues: true }) as object)).map((e) => e.property);
+
+const createBase = {
+    name: 'Tasa preferente gama alta',
+    description: 'Baja la tasa en teléfonos de gama alta',
+    effect: { downPaymentDeltaPct: 0.05 },
+    segmentId: 'SEG_SILVER',
+    targetLevels: ['SILVER'],
+};
+
+describe('alcance por tipo y gama en promociones de crédito', () => {
+    it('Create acepta tipos y gamas del catálogo, y null como «todos»', async () => {
+        const dto = plainToInstance(CreatePromotionRequest, { ...createBase, productCategories: ['PHONE'], tiers: ['HIGH', 'PREMIUM'] }, { excludeExtraneousValues: true });
+        expect(await validate(dto)).toHaveLength(0);
+        expect(dto.productCategories).toEqual([ProductCategoryEnum.PHONE]);
+        expect(dto.tiers).toEqual([ProductTierEnum.HIGH, ProductTierEnum.PREMIUM]);
+        expect(await errorsOf(CreatePromotionRequest, { ...createBase, productCategories: null, tiers: null })).toEqual([]);
+    });
+
+    it.each([CreatePromotionRequest, UpdatePromotionRequest])('%p rechaza tipo o gama fuera del enum', async (dtoClass) => {
+        const body = dtoClass === CreatePromotionRequest ? createBase : {};
+        expect(await errorsOf(dtoClass, { ...body, productCategories: ['CAR'] })).toContain('productCategories');
+        expect(await errorsOf(dtoClass, { ...body, tiers: ['ULTRA'] })).toContain('tiers');
+        expect(await errorsOf(dtoClass, { ...body, tiers: 'HIGH' })).toContain('tiers');
+    });
+
+    it('Update acepta el parche solo con tipo y gama', async () => {
+        expect(await errorsOf(UpdatePromotionRequest, { productCategories: ['SIM', 'MODEM'], tiers: null })).toEqual([]);
+    });
+
+    it('la respuesta expone tipos y gamas con null como «todos»', () => {
+        const scope: Pick<PromotionResponse, 'productCategories' | 'tiers'> = { productCategories: null, tiers: [ProductTierEnum.LOW] };
+        expect(scope.tiers).toEqual(['LOW']);
+    });
+
+    it('el simulador recibe tipo y gama opcionales y valida el enum', async () => {
+        const base = { productPriceCents: 500000, downPaymentPct: 0.2, termWeeks: 26 };
+        expect(await errorsOf(SimulateCreditPlanRequest, base)).toEqual([]);
+        expect(await errorsOf(SimulateCreditPlanRequest, { ...base, productCategory: 'PHONE', productTier: 'MID' })).toEqual([]);
+        expect(await errorsOf(SimulateCreditPlanRequest, { ...base, productCategory: 'CAR' })).toContain('productCategory');
+        expect(await errorsOf(SimulateCreditPlanRequest, { ...base, productTier: 'ULTRA' })).toContain('productTier');
+    });
+});
+
+describe.each([ListPromotedSkusRequest, ListSkuPromotionsRequest])('%p (lote por SKU)', (dtoClass) => {
+    const valid = { storeId: 'st-1', items: [{ sku: 'SKU-1', category: 'PHONE', tier: 'MID' }] };
+
+    it('acepta tienda, nivel y segmento opcionales, y SKUs con tipo y gama opcionales', async () => {
+        expect(await errorsOf(dtoClass, valid)).toEqual([]);
+        expect(await errorsOf(dtoClass, { ...valid, level: 'GOLD', segmentId: 'SEG-1', items: [{ sku: 'SKU-2' }] })).toEqual([]);
+    });
+
+    it.each([
+        ['sin tienda', { ...valid, storeId: undefined }, 'storeId'],
+        ['tienda vacía', { ...valid, storeId: '' }, 'storeId'],
+        ['nivel fuera del enum', { ...valid, level: 'PLATINUM' }, 'level'],
+        ['sin items', { ...valid, items: undefined }, 'items'],
+        ['tipo fuera del enum', { ...valid, items: [{ sku: 'A', category: 'CAR' }] }, 'items'],
+        ['gama fuera del enum', { ...valid, items: [{ sku: 'A', tier: 'ULTRA' }] }, 'items'],
+        ['SKU no string', { ...valid, items: [{ sku: 7 }] }, 'items'],
+    ])('rechaza %s', async (_label, body, property) => {
+        expect(await errorsOf(dtoClass, body)).toContain(property);
+    });
+
+    it(`rechaza más de ${PROMOTION_SKU_BATCH_MAX_ITEMS} SKUs y acepta exactamente el tope`, async () => {
+        const items = (n: number) => Array.from({ length: n }, (_v, i) => ({ sku: `S${i}` }));
+        expect(PROMOTION_SKU_BATCH_MAX_ITEMS).toBe(100);
+        expect(await errorsOf(dtoClass, { ...valid, items: items(PROMOTION_SKU_BATCH_MAX_ITEMS) })).toEqual([]);
+        expect(await errorsOf(dtoClass, { ...valid, items: items(PROMOTION_SKU_BATCH_MAX_ITEMS + 1) })).toContain('items');
+    });
+});

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/loanCredit/dtos/requests/OriginateLoanCreditRequest.d.ts

@@ -1,3 +1,5 @@
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 /**
  * Body de `POST /private/credits/originate` (loan-credit-business — wizard, vía api-invoker).
@@ -40,4 +42,8 @@ export declare class OriginateLoanCreditRequest {
     sellerId?: string;
     /** SKU del equipo, por el mismo motivo que `storeId`: resuelve promociones acotadas por producto. */
     productSku?: string;
+    /** Tipo del equipo: resuelve promociones acotadas por tipo. */
+    productCategory?: ProductCategoryEnum;
+    /** Gama del equipo: resuelve promociones acotadas por gama. */
+    productTier?: ProductTierEnum;
 }

package/bin/loanCredit/dtos/requests/OriginateLoanCreditRequest.js

@@ -12,6 +12,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OriginateLoanCreditRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const ProductCategoryEnum_1 = require("../../../retailCatalog/enums/ProductCategoryEnum");
+const ProductTierEnum_1 = require("../../../retailCatalog/enums/ProductTierEnum");
 const ClientLevelEnum_1 = require("../../../loanScoring/enums/ClientLevelEnum");
 /**
  * Body de `POST /private/credits/originate` (loan-credit-business — wizard, vía api-invoker).
@@ -108,3 +110,15 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], OriginateLoanCreditRequest.prototype, "productSku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ProductCategoryEnum_1.ProductCategoryEnum),
+    __metadata("design:type", String)
+], OriginateLoanCreditRequest.prototype, "productCategory", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ProductTierEnum_1.ProductTierEnum),
+    __metadata("design:type", String)
+], OriginateLoanCreditRequest.prototype, "productTier", void 0);

package/bin/loanOfferings/constants/promotionSkuBatch.d.ts

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

package/bin/loanOfferings/constants/promotionSkuBatch.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROMOTION_SKU_BATCH_MAX_ITEMS = void 0;
+/** Tope de SKUs por llamada a los lotes de promociones por SKU; el caller parte en bloques. */
+exports.PROMOTION_SKU_BATCH_MAX_ITEMS = 100;

package/bin/loanOfferings/dtos/requests/CreatePromotionRequest.d.ts

@@ -1,4 +1,6 @@
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 import { PromotionEffectInput } from './PromotionEffectInput';
 /**
  * Body de POST /promotions — alta de una promoción del motor.
@@ -14,6 +16,10 @@ export declare class CreatePromotionRequest {
     targetLevels: CreditPlanLevelEnum[];
     /** SKUs alcanzados; ausente o `null` = todos los productos. */
     productSkus?: string[] | null;
+    /** Tipos de producto alcanzados; ausente o `null` = todos los tipos. */
+    productCategories?: ProductCategoryEnum[] | null;
+    /** Gamas alcanzadas; ausente o `null` = todas las gamas. */
+    tiers?: ProductTierEnum[] | null;
     /** Tiendas alcanzadas. `null` o ausente = todas. */
     storeIds?: string[] | null;
     validFrom?: string | null;

package/bin/loanOfferings/dtos/requests/CreatePromotionRequest.js

@@ -13,6 +13,8 @@ exports.CreatePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
+const ProductCategoryEnum_1 = require("../../../retailCatalog/enums/ProductCategoryEnum");
+const ProductTierEnum_1 = require("../../../retailCatalog/enums/ProductTierEnum");
 const PromotionEffectInput_1 = require("./PromotionEffectInput");
 /**
  * Body de POST /promotions — alta de una promoción del motor.
@@ -57,6 +59,20 @@ __decorate([
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
 ], CreatePromotionRequest.prototype, "productSkus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsEnum)(ProductCategoryEnum_1.ProductCategoryEnum, { each: true }),
+    __metadata("design:type", Array)
+], CreatePromotionRequest.prototype, "productCategories", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsEnum)(ProductTierEnum_1.ProductTierEnum, { each: true }),
+    __metadata("design:type", Array)
+], CreatePromotionRequest.prototype, "tiers", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/loanOfferings/dtos/requests/ListPromotedSkusRequest.d.ts

@@ -0,0 +1,11 @@
+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 declare class ListPromotedSkusRequest {
+    storeId: string;
+    /** Nivel del cliente si loan-scoring ya corrió. */
+    level?: CreditPlanLevelEnum;
+    /** Segmento del cliente si ya se resolvió. */
+    segmentId?: string;
+    items: PromotionSkuInput[];
+}

package/bin/loanOfferings/dtos/requests/ListPromotedSkusRequest.js

@@ -0,0 +1,47 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListPromotedSkusRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const promotionSkuBatch_1 = require("../../constants/promotionSkuBatch");
+const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
+const PromotionSkuInput_1 = require("./PromotionSkuInput");
+/** Body de `POST /private/promotions/promoted-skus` (M2M): SKUs del lote con promoción viva para el badge; hasta 100 SKUs. */
+class ListPromotedSkusRequest {
+}
+exports.ListPromotedSkusRequest = ListPromotedSkusRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ListPromotedSkusRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(CreditPlanLevelEnum_1.CreditPlanLevelEnum),
+    __metadata("design:type", String)
+], ListPromotedSkusRequest.prototype, "level", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ListPromotedSkusRequest.prototype, "segmentId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(promotionSkuBatch_1.PROMOTION_SKU_BATCH_MAX_ITEMS),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => PromotionSkuInput_1.PromotionSkuInput),
+    __metadata("design:type", Array)
+], ListPromotedSkusRequest.prototype, "items", void 0);

package/bin/loanOfferings/dtos/requests/ListSkuPromotionsRequest.d.ts

@@ -0,0 +1,11 @@
+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 declare class ListSkuPromotionsRequest {
+    storeId: string;
+    /** Nivel del cliente si loan-scoring ya corrió. */
+    level?: CreditPlanLevelEnum;
+    /** Segmento del cliente si ya se resolvió. */
+    segmentId?: string;
+    items: PromotionSkuInput[];
+}

package/bin/loanOfferings/dtos/requests/ListSkuPromotionsRequest.js

@@ -0,0 +1,47 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListSkuPromotionsRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const promotionSkuBatch_1 = require("../../constants/promotionSkuBatch");
+const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
+const PromotionSkuInput_1 = require("./PromotionSkuInput");
+/** Body de `POST /private/promotions/by-sku` (M2M): promociones vivas de cada SKU del lote; hasta 100 SKUs. */
+class ListSkuPromotionsRequest {
+}
+exports.ListSkuPromotionsRequest = ListSkuPromotionsRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ListSkuPromotionsRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(CreditPlanLevelEnum_1.CreditPlanLevelEnum),
+    __metadata("design:type", String)
+], ListSkuPromotionsRequest.prototype, "level", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ListSkuPromotionsRequest.prototype, "segmentId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(promotionSkuBatch_1.PROMOTION_SKU_BATCH_MAX_ITEMS),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => PromotionSkuInput_1.PromotionSkuInput),
+    __metadata("design:type", Array)
+], ListSkuPromotionsRequest.prototype, "items", void 0);

package/bin/loanOfferings/dtos/requests/PromotionSkuInput.d.ts

@@ -0,0 +1,8 @@
+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 declare class PromotionSkuInput {
+    sku: string;
+    category?: ProductCategoryEnum;
+    tier?: ProductTierEnum;
+}

package/bin/loanOfferings/dtos/requests/PromotionSkuInput.js

@@ -0,0 +1,37 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromotionSkuInput = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ProductCategoryEnum_1 = require("../../../retailCatalog/enums/ProductCategoryEnum");
+const ProductTierEnum_1 = require("../../../retailCatalog/enums/ProductTierEnum");
+/** Un SKU con su tipo y gama; sin ellos no cumple un alcance por tipo o por gama. */
+class PromotionSkuInput {
+}
+exports.PromotionSkuInput = PromotionSkuInput;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PromotionSkuInput.prototype, "sku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ProductCategoryEnum_1.ProductCategoryEnum),
+    __metadata("design:type", String)
+], PromotionSkuInput.prototype, "category", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ProductTierEnum_1.ProductTierEnum),
+    __metadata("design:type", String)
+], PromotionSkuInput.prototype, "tier", void 0);

package/bin/loanOfferings/dtos/requests/SimulateCreditPlanRequest.d.ts

@@ -1,3 +1,5 @@
+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.
  * Entradas del simulador de cuota (flow 06 §6.1.4). `productPriceCents` en cents; `downPaymentPct`
@@ -16,6 +18,10 @@ export declare class SimulateCreditPlanRequest {
     storeId?: string;
     /** SKU del equipo. Sin él no se resuelven las promociones acotadas por producto. */
     productSku?: string;
+    /** Tipo del equipo. Sin él no se resuelven las promociones acotadas por tipo. */
+    productCategory?: ProductCategoryEnum;
+    /** Gama del equipo. Sin ella no se resuelven las promociones acotadas por gama. */
+    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/bin/loanOfferings/dtos/requests/SimulateCreditPlanRequest.js

@@ -12,6 +12,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SimulateCreditPlanRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const ProductCategoryEnum_1 = require("../../../retailCatalog/enums/ProductCategoryEnum");
+const ProductTierEnum_1 = require("../../../retailCatalog/enums/ProductTierEnum");
 /**
  * Body de POST /private/credit-plans/:planId/simulate y query de GET /credit-plans/:planId/simulator.
  * Entradas del simulador de cuota (flow 06 §6.1.4). `productPriceCents` en cents; `downPaymentPct`
@@ -63,6 +65,18 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], SimulateCreditPlanRequest.prototype, "productSku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ProductCategoryEnum_1.ProductCategoryEnum),
+    __metadata("design:type", String)
+], SimulateCreditPlanRequest.prototype, "productCategory", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ProductTierEnum_1.ProductTierEnum),
+    __metadata("design:type", String)
+], SimulateCreditPlanRequest.prototype, "productTier", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/loanOfferings/dtos/requests/UpdatePromotionRequest.d.ts

@@ -1,4 +1,6 @@
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 import { PromotionEffectInput } from './PromotionEffectInput';
 /**
  * Body de PUT /promotions/:promotionId — edición parcial (todos los campos opcionales).
@@ -12,6 +14,10 @@ export declare class UpdatePromotionRequest {
     segmentId?: string;
     targetLevels?: CreditPlanLevelEnum[];
     productSkus?: string[] | null;
+    /** Tipos de producto alcanzados; ausente o `null` = todos los tipos. */
+    productCategories?: ProductCategoryEnum[] | null;
+    /** Gamas alcanzadas; ausente o `null` = todas las gamas. */
+    tiers?: ProductTierEnum[] | null;
     /** Tiendas alcanzadas. `null` o ausente = todas. */
     storeIds?: string[] | null;
     validFrom?: string | null;

package/bin/loanOfferings/dtos/requests/UpdatePromotionRequest.js

@@ -13,6 +13,8 @@ exports.UpdatePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
+const ProductCategoryEnum_1 = require("../../../retailCatalog/enums/ProductCategoryEnum");
+const ProductTierEnum_1 = require("../../../retailCatalog/enums/ProductTierEnum");
 const PromotionEffectInput_1 = require("./PromotionEffectInput");
 /**
  * Body de PUT /promotions/:promotionId — edición parcial (todos los campos opcionales).
@@ -62,6 +64,20 @@ __decorate([
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
 ], UpdatePromotionRequest.prototype, "productSkus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsEnum)(ProductCategoryEnum_1.ProductCategoryEnum, { each: true }),
+    __metadata("design:type", Array)
+], UpdatePromotionRequest.prototype, "productCategories", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsEnum)(ProductTierEnum_1.ProductTierEnum, { each: true }),
+    __metadata("design:type", Array)
+], UpdatePromotionRequest.prototype, "tiers", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/loanOfferings/dtos/responses/PromotionResponse.d.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';
@@ -21,6 +23,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/bin/loanOfferings/index.d.ts

@@ -16,6 +16,7 @@ export * from './enums/SegmentStatusEnum';
 export * from './enums/SegmentColorSlotEnum';
 export * from './enums/SegmentFilterIdEnum';
 export * from './enums/PrepaymentMinimumModeEnum';
+export * from './constants/promotionSkuBatch';
 export * from './dtos/CreditPlan';
 export * from './dtos/PrepaymentMinimum';
 export * from './dtos/Financier';
@@ -45,6 +46,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';
 export * from './dtos/responses/CreditPlanResponse';
 export * from './dtos/responses/FinancierResponse';
 export * from './dtos/responses/RetailerCreditPlanResponse';