@fiado/type-kit 3.608.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/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';

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.608.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';