@fiado/type-kit 3.614.0 → 3.616.0

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

@@ -62,4 +62,13 @@ describe('OriginateLoanCreditRequest', () => {
         const bad = await validateWhitelisted({ ...BASE, productCategory: 'CAR', productTier: 'ULTRA' });
         expect(bad.errors.map((error) => error.property).sort()).toEqual(['productCategory', 'productTier']);
     });
+
+    it('acepta la cadena opcional y rechaza la cadena vacía', async () => {
+        const ok = await validateWhitelisted({ ...BASE, retailerId: 'RT-1' });
+        expect(ok.errors).toEqual([]);
+        expect(ok.dto.retailerId).toBe('RT-1');
+
+        const bad = await validateWhitelisted({ ...BASE, retailerId: '' });
+        expect(bad.errors.map((error) => error.property)).toEqual(['retailerId']);
+    });
 });

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

@@ -0,0 +1,79 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    CreatePromotionRequest,
+    ListPromotedSkusRequest,
+    ListSkuPromotionsRequest,
+    PROMOTION_RETAILER_IDS_MAX_ITEMS,
+    SimulateCreditPlanRequest,
+    UpdatePromotionRequest,
+} from '../../../src/loanOfferings/index';
+import type { PromotionResponse } from '../../../src/loanOfferings/index';
+
+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 cadena',
+    description: 'Baja la tasa en una cadena',
+    effect: { downPaymentDeltaPct: 0.05 },
+    segmentId: 'SEG_SILVER',
+    targetLevels: ['SILVER'],
+};
+
+describe('alcance por cadena en promociones de crédito', () => {
+    it('Create acepta cadenas, null y lista vacía como «todas»', async () => {
+        const dto = plainToInstance(CreatePromotionRequest, { ...createBase, retailerIds: ['RT-1', 'RT-2'] }, { excludeExtraneousValues: true });
+        expect(await validate(dto)).toHaveLength(0);
+        expect(dto.retailerIds).toEqual(['RT-1', 'RT-2']);
+        expect(await errorsOf(CreatePromotionRequest, { ...createBase, retailerIds: null })).toEqual([]);
+        expect(await errorsOf(CreatePromotionRequest, { ...createBase, retailerIds: [] })).toEqual([]);
+    });
+
+    it.each([CreatePromotionRequest, UpdatePromotionRequest])('%p rechaza cadenas mal formadas', async (dtoClass) => {
+        const body = dtoClass === CreatePromotionRequest ? createBase : {};
+        const tooMany = Array.from({ length: PROMOTION_RETAILER_IDS_MAX_ITEMS + 1 }, (_v, i) => `RT-${i}`);
+        expect(await errorsOf(dtoClass, { ...body, retailerIds: 'RT-1' })).toContain('retailerIds');
+        expect(await errorsOf(dtoClass, { ...body, retailerIds: [7] })).toContain('retailerIds');
+        expect(await errorsOf(dtoClass, { ...body, retailerIds: [''] })).toContain('retailerIds');
+        expect(await errorsOf(dtoClass, { ...body, retailerIds: tooMany })).toContain('retailerIds');
+        expect(await errorsOf(dtoClass, { ...body, retailerIds: tooMany.slice(1) })).toEqual([]);
+    });
+
+    it('Update acepta el parche solo con cadenas', async () => {
+        expect(PROMOTION_RETAILER_IDS_MAX_ITEMS).toBe(50);
+        expect(await errorsOf(UpdatePromotionRequest, { retailerIds: ['RT-1'] })).toEqual([]);
+        expect(await errorsOf(UpdatePromotionRequest, { retailerIds: null })).toEqual([]);
+    });
+
+    it('la respuesta expone las cadenas con null como «todas»', () => {
+        const scope: Pick<PromotionResponse, 'retailerIds'> = { retailerIds: null };
+        expect(scope.retailerIds).toBeNull();
+    });
+
+    it('el simulador recibe la cadena opcional como string', async () => {
+        const base = { productPriceCents: 500000, downPaymentPct: 0.2, termWeeks: 26 };
+        const dto = plainToInstance(SimulateCreditPlanRequest, { ...base, retailerId: 'RT-1' }, { excludeExtraneousValues: true });
+        expect(await validate(dto)).toHaveLength(0);
+        expect(dto.retailerId).toBe('RT-1');
+        expect(await errorsOf(SimulateCreditPlanRequest, { ...base, retailerId: 7 })).toContain('retailerId');
+        expect(await errorsOf(SimulateCreditPlanRequest, { ...base, retailerId: '' })).toContain('retailerId');
+    });
+});
+
+describe.each([ListPromotedSkusRequest, ListSkuPromotionsRequest])('%p con cadena', (dtoClass) => {
+    const valid = { storeId: 'st-1', items: [{ sku: 'SKU-1' }] };
+
+    it('acepta la cadena opcional junto a la tienda', async () => {
+        expect(await errorsOf(dtoClass, valid)).toEqual([]);
+        expect(await errorsOf(dtoClass, { ...valid, retailerId: 'RT-1' })).toEqual([]);
+    });
+
+    it('rechaza la cadena vacía o no string', async () => {
+        expect(await errorsOf(dtoClass, { ...valid, retailerId: '' })).toContain('retailerId');
+        expect(await errorsOf(dtoClass, { ...valid, retailerId: 7 })).toContain('retailerId');
+    });
+});

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

@@ -207,7 +207,7 @@ describe('ChangeCohortStatusRequest, TestCohortRequest y ListCohortsQuery', () =
 });
 
 describe('Segmento con cohorts', () => {
-  it('el alta acepta cohortIds y descarta los filterIds viejos', async () => {
+  it('el alta acepta cohortIds y conserva filterIds como alias deprecado', async () => {
     const dto = toDto(CreateSegmentRequest, {
       name: 'VIP',
       colorSlot: SegmentColorSlotEnum.SLATE,
@@ -216,7 +216,15 @@ describe('Segmento con cohorts', () => {
     });
     expect(await validate(dto)).toHaveLength(0);
     expect(dto.cohortIds).toEqual(['COH-LEVEL-GOLD']);
-    expect('filterIds' in dto).toBe(false);
+    expect(dto.filterIds).toEqual(['levelGold']);
+  });
+
+  it('filterIds deprecado es opcional y exige textos en alta y edición', async () => {
+    expect(await errorProperties(CreateSegmentRequest, { name: 'X' })).toEqual([]);
+    expect(await errorProperties(CreateSegmentRequest, { name: 'X', filterIds: [1] })).toEqual(['filterIds']);
+    expect(toDto(UpdateSegmentRequest, { filterIds: ['levelGold'] }).filterIds).toEqual(['levelGold']);
+    expect(await errorProperties(UpdateSegmentRequest, { filterIds: [] })).toEqual([]);
+    expect(await errorProperties(UpdateSegmentRequest, { filterIds: 'levelGold' })).toEqual(['filterIds']);
   });
 
   it('limita los cohorts a 20 y exige textos', async () => {
@@ -277,6 +285,7 @@ describe('Responses de cohorts y segmentos', () => {
       description: null,
       colorSlot: SegmentColorSlotEnum.SLATE,
       cohortIds: [cohort.cohortId],
+      filterIds: [],
       memberIds: [],
       isDefault: false,
       status: SegmentStatusEnum.ACTIVE,

package/bin/loanCredit/dtos/requests/OriginateLoanCreditRequest.d.ts

@@ -46,4 +46,6 @@ export declare class OriginateLoanCreditRequest {
     productCategory?: ProductCategoryEnum;
     /** Gama del equipo: resuelve promociones acotadas por gama. */
     productTier?: ProductTierEnum;
+    /** Cadena de la tienda que vende; sin ella no se resuelven las promociones acotadas por cadena. */
+    retailerId?: string;
 }

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

@@ -122,3 +122,10 @@ __decorate([
     (0, class_validator_1.IsEnum)(ProductTierEnum_1.ProductTierEnum),
     __metadata("design:type", String)
 ], OriginateLoanCreditRequest.prototype, "productTier", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], OriginateLoanCreditRequest.prototype, "retailerId", void 0);

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

@@ -0,0 +1,2 @@
+/** Tope de cadenas por promoción de crédito. */
+export declare const PROMOTION_RETAILER_IDS_MAX_ITEMS = 50;

package/bin/loanOfferings/constants/promotionRetailerScope.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROMOTION_RETAILER_IDS_MAX_ITEMS = void 0;
+/** Tope de cadenas por promoción de crédito. */
+exports.PROMOTION_RETAILER_IDS_MAX_ITEMS = 50;

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

@@ -20,6 +20,8 @@ export declare class CreatePromotionRequest {
     productCategories?: ProductCategoryEnum[] | null;
     /** Gamas alcanzadas; ausente o `null` = todas las gamas. */
     tiers?: ProductTierEnum[] | null;
+    /** Cadenas alcanzadas; ausente, `null` o vacío = todas las cadenas. */
+    retailerIds?: string[] | null;
     /** Tiendas alcanzadas. `null` o ausente = todas. */
     storeIds?: string[] | null;
     validFrom?: string | null;

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

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreatePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const promotionRetailerScope_1 = require("../../constants/promotionRetailerScope");
 const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
 const ProductCategoryEnum_1 = require("../../../retailCatalog/enums/ProductCategoryEnum");
 const ProductTierEnum_1 = require("../../../retailCatalog/enums/ProductTierEnum");
@@ -73,6 +74,15 @@ __decorate([
     (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)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(promotionRetailerScope_1.PROMOTION_RETAILER_IDS_MAX_ITEMS),
+    (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
+    __metadata("design:type", Array)
+], CreatePromotionRequest.prototype, "retailerIds", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -15,6 +15,8 @@ export declare class CreateSegmentRequest {
      * dentro de cada cohort las condiciones se unen con Y.
      */
     cohortIds?: string[];
+    /** @deprecated Usar `cohortIds`; se conserva para los consumidores que aún no migran. */
+    filterIds?: string[];
     /**
      * Clientes agregados a mano por `retailCustomerId`. Ganan siempre, cumplan o no un cohort.
      * Un segmento puede nacer SOLO con esta lista, sin ningún cohort.

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

@@ -50,6 +50,13 @@ __decorate([
     (0, class_validator_1.ArrayMaxSize)(20),
     __metadata("design:type", Array)
 ], CreateSegmentRequest.prototype, "cohortIds", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CreateSegmentRequest.prototype, "filterIds", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -3,6 +3,8 @@ 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;
+    /** Cadena de la tienda; sin ella no se resuelven las promociones acotadas por cadena. */
+    retailerId?: string;
     /** Nivel del cliente si loan-scoring ya corrió. */
     level?: CreditPlanLevelEnum;
     /** Segmento del cliente si ya se resolvió. */

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

@@ -25,6 +25,13 @@ __decorate([
     (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.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ListPromotedSkusRequest.prototype, "retailerId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -3,6 +3,8 @@ 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;
+    /** Cadena de la tienda; sin ella no se resuelven las promociones acotadas por cadena. */
+    retailerId?: string;
     /** Nivel del cliente si loan-scoring ya corrió. */
     level?: CreditPlanLevelEnum;
     /** Segmento del cliente si ya se resolvió. */

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

@@ -25,6 +25,13 @@ __decorate([
     (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.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ListSkuPromotionsRequest.prototype, "retailerId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -22,6 +22,8 @@ export declare class SimulateCreditPlanRequest {
     productCategory?: ProductCategoryEnum;
     /** Gama del equipo. Sin ella no se resuelven las promociones acotadas por gama. */
     productTier?: ProductTierEnum;
+    /** Cadena de la tienda que cotiza; sin ella no se resuelven las promociones acotadas por cadena. */
+    retailerId?: string;
     /**
      * 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

@@ -77,6 +77,13 @@ __decorate([
     (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)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SimulateCreditPlanRequest.prototype, "retailerId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -18,6 +18,8 @@ export declare class UpdatePromotionRequest {
     productCategories?: ProductCategoryEnum[] | null;
     /** Gamas alcanzadas; ausente o `null` = todas las gamas. */
     tiers?: ProductTierEnum[] | null;
+    /** Cadenas alcanzadas; ausente, `null` o vacío = todas las cadenas. */
+    retailerIds?: string[] | null;
     /** Tiendas alcanzadas. `null` o ausente = todas. */
     storeIds?: string[] | null;
     validFrom?: string | null;

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

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdatePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const promotionRetailerScope_1 = require("../../constants/promotionRetailerScope");
 const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
 const ProductCategoryEnum_1 = require("../../../retailCatalog/enums/ProductCategoryEnum");
 const ProductTierEnum_1 = require("../../../retailCatalog/enums/ProductTierEnum");
@@ -78,6 +79,15 @@ __decorate([
     (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)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(promotionRetailerScope_1.PROMOTION_RETAILER_IDS_MAX_ITEMS),
+    (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
+    __metadata("design:type", Array)
+], UpdatePromotionRequest.prototype, "retailerIds", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -12,6 +12,8 @@ export declare class UpdateSegmentRequest {
     colorSlot?: SegmentColorSlotEnum;
     /** Reemplaza la lista entera; `[]` deja el segmento sin cohorts. */
     cohortIds?: string[];
+    /** @deprecated Usar `cohortIds`; se conserva para los consumidores que aún no migran. */
+    filterIds?: string[];
     /** Reemplaza la lista entera; `[]` saca a todos los agregados a mano. */
     memberIds?: string[];
     reason?: string;

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

@@ -52,6 +52,13 @@ __decorate([
     (0, class_validator_1.ArrayMaxSize)(20),
     __metadata("design:type", Array)
 ], UpdateSegmentRequest.prototype, "cohortIds", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], UpdateSegmentRequest.prototype, "filterIds", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/loanOfferings/dtos/responses/PromotionResponse.d.ts

@@ -27,6 +27,8 @@ export interface PromotionResponse {
     productCategories: ProductCategoryEnum[] | null;
     /** `null` = alcanza a todas las gamas. */
     tiers: ProductTierEnum[] | null;
+    /** `null` = alcanza a todas las cadenas. */
+    retailerIds: string[] | null;
     /** `null` = alcanza a todas las tiendas. Dimensión «Tienda / canal» del alcance. */
     storeIds: string[] | null;
     validFrom: string | null;

package/bin/loanOfferings/dtos/responses/SegmentResponse.d.ts

@@ -13,6 +13,8 @@ export interface SegmentResponse {
     colorSlot: SegmentColorSlotEnum;
     /** Cohorts del segmento. Vacío = no alcanza a nadie por regla. */
     cohortIds: string[];
+    /** @deprecated Mismo contenido que `cohortIds`; usar `cohortIds`. */
+    filterIds?: string[];
     /** `retailCustomerId` agregados a mano. Ganan aunque el cliente no cumpla ningún cohort. */
     memberIds: string[];
     /** El catch-all implícito. No acepta cohorts ni individuos, no se archiva y solo se renombra. */

package/bin/loanOfferings/index.d.ts

@@ -27,6 +27,7 @@ export * from './enums/SegmentMembershipReasonEnum';
 export * from './enums/SegmentationRecountTriggerEnum';
 export * from './enums/SegmentationRecountStatusEnum';
 export * from './constants/promotionSkuBatch';
+export * from './constants/promotionRetailerScope';
 export * from './dtos/CreditPlan';
 export * from './dtos/PrepaymentMinimum';
 export * from './dtos/Financier';

package/bin/loanOfferings/index.js

@@ -45,6 +45,7 @@ __exportStar(require("./enums/SegmentationRecountTriggerEnum"), exports);
 __exportStar(require("./enums/SegmentationRecountStatusEnum"), exports);
 // Constantes
 __exportStar(require("./constants/promotionSkuBatch"), exports);
+__exportStar(require("./constants/promotionRetailerScope"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/CreditPlan"), exports);
 __exportStar(require("./dtos/PrepaymentMinimum"), exports);

package/package.json

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

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

@@ -120,4 +120,11 @@ export class OriginateLoanCreditRequest {
     @IsOptional()
     @IsEnum(ProductTierEnum)
     productTier?: ProductTierEnum;
+
+    /** Cadena de la tienda que vende; sin ella no se resuelven las promociones acotadas por cadena. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    retailerId?: string;
 }

package/src/loanOfferings/constants/promotionRetailerScope.ts

@@ -0,0 +1,2 @@
+/** Tope de cadenas por promoción de crédito. */
+export const PROMOTION_RETAILER_IDS_MAX_ITEMS = 50;

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

@@ -1,14 +1,17 @@
 import { Expose, Type } from 'class-transformer';
 import {
+    ArrayMaxSize,
     ArrayNotEmpty,
     IsArray,
     IsEnum,
     IsInt,
     IsISO8601,
+    IsNotEmpty,
     IsOptional,
     IsString,
     ValidateNested,
 } from 'class-validator';
+import { PROMOTION_RETAILER_IDS_MAX_ITEMS } from '../../constants/promotionRetailerScope';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
@@ -65,6 +68,15 @@ export class CreatePromotionRequest {
     @IsEnum(ProductTierEnum, { each: true })
     tiers?: ProductTierEnum[] | null;
 
+    /** Cadenas alcanzadas; ausente, `null` o vacío = todas las cadenas. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(PROMOTION_RETAILER_IDS_MAX_ITEMS)
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    retailerIds?: string[] | null;
+
     /** Tiendas alcanzadas. `null` o ausente = todas. */
     @Expose()
     @IsOptional()

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

@@ -38,6 +38,13 @@ export class CreateSegmentRequest {
     @ArrayMaxSize(20)
     cohortIds?: string[];
 
+    /** @deprecated Usar `cohortIds`; se conserva para los consumidores que aún no migran. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    filterIds?: string[];
+
     /**
      * Clientes agregados a mano por `retailCustomerId`. Ganan siempre, cumplan o no un cohort.
      * Un segmento puede nacer SOLO con esta lista, sin ningún cohort.

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

@@ -11,6 +11,13 @@ export class ListPromotedSkusRequest {
     @IsNotEmpty()
     storeId!: string;
 
+    /** Cadena de la tienda; sin ella no se resuelven las promociones acotadas por cadena. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    retailerId?: string;
+
     /** Nivel del cliente si loan-scoring ya corrió. */
     @Expose()
     @IsOptional()

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

@@ -11,6 +11,13 @@ export class ListSkuPromotionsRequest {
     @IsNotEmpty()
     storeId!: string;
 
+    /** Cadena de la tienda; sin ella no se resuelven las promociones acotadas por cadena. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    retailerId?: string;
+
     /** Nivel del cliente si loan-scoring ya corrió. */
     @Expose()
     @IsOptional()

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

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsArray, IsEnum, IsInt, IsNumber, IsOptional, IsString, Max, Min } from 'class-validator';
+import { IsArray, IsEnum, IsInt, IsNotEmpty, IsNumber, IsOptional, IsString, Max, Min } from 'class-validator';
 import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 
@@ -61,6 +61,13 @@ export class SimulateCreditPlanRequest {
     @IsEnum(ProductTierEnum)
     productTier?: ProductTierEnum;
 
+    /** Cadena de la tienda que cotiza; sin ella no se resuelven las promociones acotadas por cadena. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    retailerId?: string;
+
     /**
      * 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

@@ -1,14 +1,17 @@
 import { Expose, Type } from 'class-transformer';
 import {
+    ArrayMaxSize,
     ArrayNotEmpty,
     IsArray,
     IsEnum,
     IsInt,
     IsISO8601,
+    IsNotEmpty,
     IsOptional,
     IsString,
     ValidateNested,
 } from 'class-validator';
+import { PROMOTION_RETAILER_IDS_MAX_ITEMS } from '../../constants/promotionRetailerScope';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
@@ -68,6 +71,15 @@ export class UpdatePromotionRequest {
     @IsEnum(ProductTierEnum, { each: true })
     tiers?: ProductTierEnum[] | null;
 
+    /** Cadenas alcanzadas; ausente, `null` o vacío = todas las cadenas. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(PROMOTION_RETAILER_IDS_MAX_ITEMS)
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    retailerIds?: string[] | null;
+
     /** Tiendas alcanzadas. `null` o ausente = todas. */
     @Expose()
     @IsOptional()

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

@@ -36,6 +36,13 @@ export class UpdateSegmentRequest {
     @ArrayMaxSize(20)
     cohortIds?: string[];
 
+    /** @deprecated Usar `cohortIds`; se conserva para los consumidores que aún no migran. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    filterIds?: string[];
+
     /** Reemplaza la lista entera; `[]` saca a todos los agregados a mano. */
     @Expose()
     @IsOptional()

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

@@ -28,6 +28,8 @@ export interface PromotionResponse {
     productCategories: ProductCategoryEnum[] | null;
     /** `null` = alcanza a todas las gamas. */
     tiers: ProductTierEnum[] | null;
+    /** `null` = alcanza a todas las cadenas. */
+    retailerIds: string[] | null;
     /** `null` = alcanza a todas las tiendas. Dimensión «Tienda / canal» del alcance. */
     storeIds: string[] | null;
     validFrom: string | null;

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

@@ -14,6 +14,8 @@ export interface SegmentResponse {
     colorSlot: SegmentColorSlotEnum;
     /** Cohorts del segmento. Vacío = no alcanza a nadie por regla. */
     cohortIds: string[];
+    /** @deprecated Mismo contenido que `cohortIds`; usar `cohortIds`. */
+    filterIds?: string[];
     /** `retailCustomerId` agregados a mano. Ganan aunque el cliente no cumpla ningún cohort. */
     memberIds: string[];
     /** El catch-all implícito. No acepta cohorts ni individuos, no se archiva y solo se renombra. */

package/src/loanOfferings/index.ts

@@ -30,6 +30,7 @@ export * from './enums/SegmentationRecountStatusEnum';
 
 // Constantes
 export * from './constants/promotionSkuBatch';
+export * from './constants/promotionRetailerScope';
 
 // Entity DTOs
 export * from './dtos/CreditPlan';