@fiado/type-kit 3.500.0 → 3.501.0

package/_test_/unit/retailPromotions/constants.test.ts

@@ -43,7 +43,7 @@ describe('catálogo de errores', () => {
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.CODE_NOT_FOUND).toBe(404);
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.DISCOUNT_AFTER_QUOTE).toBe(409);
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.CODE_NOT_OWNED).toBe(422);
-    expect(Object.keys(RetailPromotionsErrorCodeEnum)).toHaveLength(30);
+    expect(Object.keys(RetailPromotionsErrorCodeEnum)).toHaveLength(31);
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.SPLIT_FINANCING_DISABLED).toBe(409);
   });
 

package/_test_/unit/retailPromotions/evaluatedSalePromotion.test.ts

@@ -19,6 +19,8 @@ const basePromotion: EvaluatedSalePromotion = {
   giftChooseCount: null,
   afterSale: [],
   appliesTo: PromotionAppliesToEnum.SUREKEEP_ONLY,
+  stackable: false,
+  anchorBound: false,
 };
 
 describe('EvaluatedSalePromotion.blockedBy', () => {

package/_test_/unit/retailPromotions/resolveSalePromotionKind.test.ts

@@ -42,6 +42,8 @@ describe('EvaluatedSalePromotion.kind', () => {
       giftChooseCount: 1,
       afterSale: [],
       appliesTo: PromotionAppliesToEnum.SUREKEEP_ONLY,
+      stackable: false,
+      anchorBound: false,
     };
     expect(promotion.kind).toBe(SalePromotionKindEnum.GIFT);
   });

package/_test_/unit/retailPromotions/salePromotionConditions.test.ts

@@ -16,6 +16,8 @@ const storeItem: StoreSalePromotionItem = {
   levers: { gift: null, deviceDiscount: null, accessoryDiscount: null, coupon: null, walletBonus: null, extendedWarranty: null, airtime: null },
   scope: { storeIds: null, productCategories: null, tiers: null, skus: null },
   appliesTo: PromotionAppliesToEnum.ANY_FINANCIER,
+  stackable: false,
+  anchorBound: false,
 };
 
 const evaluated: EvaluatedSalePromotion = {
@@ -31,6 +33,8 @@ const evaluated: EvaluatedSalePromotion = {
   giftChooseCount: null,
   afterSale: [],
   appliesTo: PromotionAppliesToEnum.SUREKEEP_ONLY,
+  stackable: false,
+  anchorBound: false,
 };
 
 describe('SalePromotionConditions', () => {

package/_test_/unit/retailPromotions/stackablePromotions.test.ts

@@ -0,0 +1,238 @@
+import 'reflect-metadata';
+import { plainToInstance, type ClassConstructor } from 'class-transformer';
+import { validateSync, type ValidationError } from 'class-validator';
+import {
+  CreateSalePromotionRequest,
+  HoldPromotionInput,
+  HoldSalePromotionRequest,
+  LinePromotionAmount,
+  RETAIL_PROMOTIONS_ERROR_HTTP_STATUS,
+  RetailPromotionsErrorCodeEnum,
+  SalePromotionKindEnum,
+  SalePromotionRef,
+  UpdateSalePromotionRequest,
+  type HeldPromotion,
+  type HoldSalePromotionResponse,
+  type LinePromotionDiscount,
+} from '../../../src/retailPromotions/index';
+import {
+  ApplyLinePromotionRequest,
+  ApplySalePromotionRequest,
+  RetailPromotionInboundMessage,
+  RetailPromotionInboundMessageTypeEnum,
+  LinePromotionAmount as WizardLinePromotionAmount,
+  SalePromotionRef as WizardSalePromotionRef,
+  type WizardLinePromotionFields,
+} from '../../../src/retailWizard';
+
+function paths(errors: ValidationError[], prefix = ''): string[] {
+  return errors.flatMap((e) => {
+    const p = prefix ? `${prefix}.${e.property}` : e.property;
+    return e.children && e.children.length > 0 ? paths(e.children, p) : [p];
+  });
+}
+
+function errorsOf<T extends object>(cls: ClassConstructor<T>, payload: object): string[] {
+  return paths(validateSync(plainToInstance(cls, payload) as object));
+}
+
+const amount = { promotionId: 'P1', promotionVersion: 1, discountCents: 5000 };
+
+describe('stackable en el CRUD de promos', () => {
+  const create = { name: 'Promo', customerText: 'Texto', levers: {} };
+
+  it('acepta stackable booleano o ausente', () => {
+    expect(errorsOf(CreateSalePromotionRequest, { ...create, stackable: true })).not.toContain('stackable');
+    expect(errorsOf(CreateSalePromotionRequest, create)).not.toContain('stackable');
+    expect(errorsOf(UpdateSalePromotionRequest, { stackable: false })).toEqual([]);
+  });
+
+  it('rechaza stackable que no es booleano', () => {
+    expect(errorsOf(CreateSalePromotionRequest, { ...create, stackable: 'si' })).toContain('stackable');
+    expect(errorsOf(UpdateSalePromotionRequest, { stackable: 1 })).toContain('stackable');
+  });
+});
+
+describe('HoldSalePromotionRequest.promotions', () => {
+  const promotions = [
+    { promotionId: 'P1', promotionVersion: 2, lineIds: ['L1'], giftSkus: ['SKU-1'] },
+    { promotionId: 'P2', promotionVersion: 1 },
+  ];
+
+  it('acepta la lista nueva sola, con o sin código', () => {
+    expect(errorsOf(HoldSalePromotionRequest, { promotions })).toEqual([]);
+    expect(errorsOf(HoldSalePromotionRequest, { promotions, discountCode: 'BUENFIN' })).toEqual([]);
+  });
+
+  it('sigue aceptando la forma vieja sola', () => {
+    expect(
+      errorsOf(HoldSalePromotionRequest, {
+        gift: { promotionId: 'G1', promotionVersion: 1, skus: ['SKU-1'] },
+        promotionId: 'P1',
+        promotionVersion: 1,
+        saleGiftSkus: ['SKU-2'],
+      }),
+    ).toEqual([]);
+  });
+
+  it.each([
+    ['gift', { gift: { promotionId: 'G1', promotionVersion: 1, skus: ['SKU-1'] } }],
+    ['promotionId', { promotionId: 'P1', promotionVersion: 1 }],
+    ['saleGiftSkus', { saleGiftSkus: ['SKU-2'] }],
+  ])('rechaza mezclar promotions con %s', (_field, legacy) => {
+    expect(errorsOf(HoldSalePromotionRequest, { promotions, ...legacy })).toContain('promotions');
+  });
+
+  it('valida cada elemento anidado', () => {
+    const found = errorsOf(HoldSalePromotionRequest, {
+      promotions: [{ promotionId: '', promotionVersion: 0, lineIds: [''], giftSkus: 'SKU' }],
+    });
+    expect(found).toEqual(
+      expect.arrayContaining([
+        'promotions.0.promotionId',
+        'promotions.0.promotionVersion',
+        'promotions.0.lineIds',
+        'promotions.0.giftSkus',
+      ]),
+    );
+  });
+
+  it('HoldPromotionInput se valida solo', () => {
+    expect(errorsOf(HoldPromotionInput, { promotionId: 'P1', promotionVersion: 1 })).toEqual([]);
+  });
+});
+
+describe('promotionDiscounts por línea', () => {
+  it('ApplyLinePromotionRequest acepta la lista y el descuento del código', () => {
+    expect(
+      errorsOf(ApplyLinePromotionRequest, {
+        promotionId: 'P1',
+        promotionVersion: 1,
+        discountCents: 7000,
+        codeDiscountCents: 2000,
+        promotionDiscounts: [amount],
+      }),
+    ).toEqual([]);
+  });
+
+  it('ApplyLinePromotionRequest valida la lista anidada y el código negativo', () => {
+    const found = errorsOf(ApplyLinePromotionRequest, {
+      codeDiscountCents: -1,
+      promotionDiscounts: [{ promotionId: '', promotionVersion: 0, discountCents: -5 }],
+    });
+    expect(found).toEqual(
+      expect.arrayContaining([
+        'codeDiscountCents',
+        'promotionDiscounts.0.promotionId',
+        'promotionDiscounts.0.promotionVersion',
+        'promotionDiscounts.0.discountCents',
+      ]),
+    );
+  });
+
+  it('LinePromotionAmount es la misma clase en ambos módulos', () => {
+    expect(WizardLinePromotionAmount).toBe(LinePromotionAmount);
+    expect(errorsOf(LinePromotionAmount, amount)).toEqual([]);
+  });
+
+  it('las interfaces aceptan la lista por promo', () => {
+    const fields: WizardLinePromotionFields = { promotionDiscounts: [amount], codeDiscountCents: 0 };
+    const discount: LinePromotionDiscount = {
+      lineId: 'L1',
+      promotionId: 'P1',
+      promotionVersion: 1,
+      discountCode: null,
+      originalPriceCents: 10000,
+      discountCents: 5000,
+      finalPriceCents: 5000,
+      promotionDiscounts: [amount],
+      codeDiscountCents: 0,
+    };
+    expect(fields.promotionDiscounts).toEqual(discount.promotionDiscounts);
+  });
+});
+
+describe('salePromotions por venta', () => {
+  const ref = { promotionId: 'P1', promotionVersion: 1 };
+
+  it('ApplySalePromotionRequest acepta la lista y la valida anidada', () => {
+    const base = { salePromotionId: null, salePromotionVersion: null };
+    expect(errorsOf(ApplySalePromotionRequest, { ...base, salePromotions: [ref] })).toEqual([]);
+    expect(errorsOf(ApplySalePromotionRequest, { ...base, salePromotions: null })).toEqual([]);
+    expect(
+      errorsOf(ApplySalePromotionRequest, { ...base, salePromotions: [{ promotionId: '', promotionVersion: 0 }] }),
+    ).toEqual(expect.arrayContaining(['salePromotions.0.promotionId', 'salePromotions.0.promotionVersion']));
+  });
+
+  it('SalePromotionRef es la misma clase en ambos módulos', () => {
+    expect(WizardSalePromotionRef).toBe(SalePromotionRef);
+  });
+
+  it('RetailPromotionInboundMessage valida salePromotions y promotionDiscounts de la línea', () => {
+    const message = {
+      type: RetailPromotionInboundMessageTypeEnum.SALE_CONFIRMED,
+      tenantId: 'T',
+      retailerId: 'R',
+      storeId: 'S',
+      saleId: 'V',
+      sessionId: 'W',
+      customerId: 'C',
+      soldAt: '2026-10-06T00:00:00.000Z',
+      occurredAt: '2026-10-06T00:00:00.000Z',
+      salePromotions: [ref],
+      lines: [
+        {
+          lineId: 'L1',
+          sku: 'SKU',
+          qty: 1,
+          originalPriceCents: 10000,
+          identifiers: [],
+          promotionDiscounts: [amount],
+          codeDiscountCents: 0,
+        },
+      ],
+    };
+    expect(errorsOf(RetailPromotionInboundMessage, message)).toEqual([]);
+    const bad = {
+      ...message,
+      salePromotions: [{ promotionId: 'P1' }],
+      lines: [{ ...message.lines[0], promotionDiscounts: [{ ...amount, discountCents: 'x' }], codeDiscountCents: -1 }],
+    };
+    expect(errorsOf(RetailPromotionInboundMessage, bad)).toEqual(
+      expect.arrayContaining([
+        'salePromotions.0.promotionVersion',
+        'lines.0.promotionDiscounts.0.discountCents',
+        'lines.0.codeDiscountCents',
+      ]),
+    );
+  });
+});
+
+describe('respuesta del apartado y error nuevo', () => {
+  it('HoldSalePromotionResponse trae promotions sin quitar los campos viejos', () => {
+    const held: HeldPromotion = {
+      promotionId: 'P1',
+      promotionVersion: 1,
+      kind: SalePromotionKindEnum.SALE,
+      stackable: true,
+      lineIds: ['L1'],
+      giftSkus: [],
+    };
+    const response: HoldSalePromotionResponse = {
+      sessionId: 'W',
+      gift: null,
+      promotionId: null,
+      promotionVersion: null,
+      discountCode: null,
+      saleGiftSkus: [],
+      lines: [],
+      totalDiscountCents: 0,
+      promotions: [held],
+    };
+    expect(response.promotions).toHaveLength(1);
+  });
+
+  it('PROMOTION_NOT_STACKABLE responde 422', () => {
+    expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS[RetailPromotionsErrorCodeEnum.PROMOTION_NOT_STACKABLE]).toBe(422);
+  });
+});

package/bin/retailPromotions/constants/retailPromotionsErrorHttpStatus.js

@@ -34,4 +34,5 @@ exports.RETAIL_PROMOTIONS_ERROR_HTTP_STATUS = {
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.INVALID_NEXT_TOKEN]: 400,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.CATALOG_SKU_NOT_FOUND]: 404,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.SPLIT_FINANCING_DISABLED]: 409,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.PROMOTION_NOT_STACKABLE]: 422,
 };

package/bin/retailPromotions/dtos/LinePromotionAmount.d.ts

@@ -0,0 +1,6 @@
+/** Descuento que una promo le aplica a una línea; la suma de la lista + el código da el total. */
+export declare class LinePromotionAmount {
+    promotionId: string;
+    promotionVersion: number;
+    discountCents: number;
+}

package/bin/retailPromotions/dtos/LinePromotionAmount.js

@@ -0,0 +1,36 @@
+"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.LinePromotionAmount = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Descuento que una promo le aplica a una línea; la suma de la lista + el código da el total. */
+class LinePromotionAmount {
+}
+exports.LinePromotionAmount = LinePromotionAmount;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], LinePromotionAmount.prototype, "promotionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], LinePromotionAmount.prototype, "promotionVersion", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], LinePromotionAmount.prototype, "discountCents", void 0);

package/bin/retailPromotions/dtos/LinePromotionDiscount.d.ts

@@ -1,3 +1,4 @@
+import type { LinePromotionAmount } from './LinePromotionAmount';
 /** Desglose por línea de la sesión: qué promo o código la tocó y cuánto bajó. */
 export interface LinePromotionDiscount {
     lineId: string;
@@ -7,4 +8,7 @@ export interface LinePromotionDiscount {
     originalPriceCents: number;
     discountCents: number;
     finalPriceCents: number;
+    /** Descuento de cada promo en la línea; sin el campo, la de `promotionId` lleva todo menos el código. */
+    promotionDiscounts?: LinePromotionAmount[];
+    codeDiscountCents?: number;
 }

package/bin/retailPromotions/dtos/SalePromotion.d.ts

@@ -21,6 +21,8 @@ export interface SalePromotion {
     /** `null` = permanente. */
     validUntil: string | null;
     oncePerCustomer: boolean;
+    /** Si se puede sumar con otras promos en la misma línea. */
+    stackable: boolean;
     status: SalePromotionStatusEnum;
     /** Derivada; `null` cuando el estado no es `ACTIVE`. */
     phase: SalePromotionPhaseEnum | null;

package/bin/retailPromotions/dtos/SalePromotionRef.d.ts

@@ -0,0 +1,5 @@
+/** Promo de venta fijada en la sesión o en la venta, con su versión. */
+export declare class SalePromotionRef {
+    promotionId: string;
+    promotionVersion: number;
+}

package/bin/retailPromotions/dtos/SalePromotionRef.js

@@ -0,0 +1,30 @@
+"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.SalePromotionRef = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Promo de venta fijada en la sesión o en la venta, con su versión. */
+class SalePromotionRef {
+}
+exports.SalePromotionRef = SalePromotionRef;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SalePromotionRef.prototype, "promotionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], SalePromotionRef.prototype, "promotionVersion", void 0);

package/bin/retailPromotions/dtos/requests/CreateSalePromotionRequest.d.ts

@@ -16,4 +16,6 @@ export declare class CreateSalePromotionRequest {
     /** `null` = permanente. */
     validUntil?: string | null;
     oncePerCustomer?: boolean;
+    /** Si se puede sumar con otras promos en la misma línea. */
+    stackable?: boolean;
 }

package/bin/retailPromotions/dtos/requests/CreateSalePromotionRequest.js

@@ -81,3 +81,9 @@ __decorate([
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
 ], CreateSalePromotionRequest.prototype, "oncePerCustomer", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CreateSalePromotionRequest.prototype, "stackable", void 0);

package/bin/retailPromotions/dtos/requests/HoldPromotionInput.d.ts

@@ -0,0 +1,8 @@
+/** Promo apartada en la lista nueva: a qué líneas aplica y qué regalos eligió el cliente. */
+export declare class HoldPromotionInput {
+    promotionId: string;
+    promotionVersion: number;
+    /** Líneas que toca la promo; ausente = las que resuelva el lambda. */
+    lineIds?: string[];
+    giftSkus?: string[];
+}

package/bin/retailPromotions/dtos/requests/HoldPromotionInput.js

@@ -0,0 +1,46 @@
+"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.HoldPromotionInput = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Promo apartada en la lista nueva: a qué líneas aplica y qué regalos eligió el cliente. */
+class HoldPromotionInput {
+}
+exports.HoldPromotionInput = HoldPromotionInput;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], HoldPromotionInput.prototype, "promotionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], HoldPromotionInput.prototype, "promotionVersion", 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 }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
+    __metadata("design:type", Array)
+], HoldPromotionInput.prototype, "lineIds", 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 }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
+    __metadata("design:type", Array)
+], HoldPromotionInput.prototype, "giftSkus", void 0);

package/bin/retailPromotions/dtos/requests/HoldSalePromotionRequest.d.ts

@@ -1,4 +1,5 @@
 import { HoldGiftPromotionInput } from './HoldGiftPromotionInput';
+import { HoldPromotionInput } from './HoldPromotionInput';
 /**
  * Body de publicHoldSalePromotion (PUT, `sessionId` en el path): hasta una promo de regalo, una de venta
  * y un código. `null` en cada una = sin ella; un PUT distinto reemplaza el apartado anterior.
@@ -6,16 +7,21 @@ import { HoldGiftPromotionInput } from './HoldGiftPromotionInput';
 export declare class HoldSalePromotionRequest {
     /**
      * Promo de regalo del teléfono (su única palanca es el regalo).
-     * El lambda rechaza con PROMOTION_KIND_MISMATCH una promo de venta mandada aquí.
+     * @deprecated Usa `promotions`; no se combina con él.
      */
     gift?: HoldGiftPromotionInput | null;
     /**
      * Promo de venta; `null` = «Ninguna».
-     * El lambda rechaza con PROMOTION_KIND_MISMATCH una promo de solo regalo mandada aquí.
+     * @deprecated Usa `promotions`; no se combina con él.
      */
     promotionId?: string | null;
     promotionVersion?: number | null;
-    /** Regalo incluido en la promo de venta, solo si esa promo además trae otras palancas. */
+    /**
+     * Regalo incluido en la promo de venta, solo si esa promo además trae otras palancas.
+     * @deprecated Usa `giftSkus` en `promotions`.
+     */
     saleGiftSkus?: string[] | null;
     discountCode?: string | null;
+    /** Promos apartadas, cada una con sus líneas y regalos; excluyente con la forma vieja. */
+    promotions?: HoldPromotionInput[] | null;
 }

package/bin/retailPromotions/dtos/requests/HoldSalePromotionRequest.js

@@ -12,7 +12,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HoldSalePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const IsHoldModeExclusiveConstraint_1 = require("../../validators/IsHoldModeExclusiveConstraint");
 const HoldGiftPromotionInput_1 = require("./HoldGiftPromotionInput");
+const HoldPromotionInput_1 = require("./HoldPromotionInput");
 /**
  * Body de publicHoldSalePromotion (PUT, `sessionId` en el path): hasta una promo de regalo, una de venta
  * y un código. `null` en cada una = sin ella; un PUT distinto reemplaza el apartado anterior.
@@ -55,3 +57,12 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], HoldSalePromotionRequest.prototype, "discountCode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => HoldPromotionInput_1.HoldPromotionInput),
+    (0, class_validator_1.Validate)(IsHoldModeExclusiveConstraint_1.IsHoldModeExclusiveConstraint),
+    __metadata("design:type", Array)
+], HoldSalePromotionRequest.prototype, "promotions", void 0);

package/bin/retailPromotions/dtos/requests/UpdateSalePromotionRequest.d.ts

@@ -16,4 +16,6 @@ export declare class UpdateSalePromotionRequest {
     /** `null` = permanente. */
     validUntil?: string | null;
     oncePerCustomer?: boolean;
+    /** Si se puede sumar con otras promos en la misma línea. */
+    stackable?: boolean;
 }

package/bin/retailPromotions/dtos/requests/UpdateSalePromotionRequest.js

@@ -83,3 +83,9 @@ __decorate([
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
 ], UpdateSalePromotionRequest.prototype, "oncePerCustomer", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateSalePromotionRequest.prototype, "stackable", void 0);

package/bin/retailPromotions/dtos/responses/WizardSalePromotionResponses.d.ts

@@ -27,6 +27,10 @@ export interface StoreSalePromotionItem {
     scope: SalePromotionScope;
     /** SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = también contado o derivada. */
     appliesTo: PromotionAppliesToEnum;
+    /** Si se puede sumar con otras promos en la misma línea. */
+    stackable: boolean;
+    /** Ocupa el lugar de la línea ancla (teléfono o kit), aunque no la toque directo. */
+    anchorBound: boolean;
     conditions?: SalePromotionConditions;
     /** Si viene, todavía no se puede decidir para este cliente (ej. CUSTOMER_NOT_IDENTIFIED). */
     blockedBy?: RetailPromotionsErrorCodeEnum | null;
@@ -63,6 +67,10 @@ export interface EvaluatedSalePromotion {
     afterSale: AfterSaleBenefit[];
     /** SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = también contado o derivada. */
     appliesTo: PromotionAppliesToEnum;
+    /** Si se puede sumar con otras promos en la misma línea. */
+    stackable: boolean;
+    /** Ocupa el lugar de la línea ancla (teléfono o kit), aunque no la toque directo. */
+    anchorBound: boolean;
     conditions?: SalePromotionConditions;
     /** Si viene, la promo se muestra pero no se puede elegir; dice por qué (ej. CUSTOMER_NOT_IDENTIFIED). */
     blockedBy?: RetailPromotionsErrorCodeEnum | null;
@@ -85,6 +93,15 @@ export interface HeldGiftPromotion {
     promotionVersion: number;
     skus: string[];
 }
+/** Promo apartada en la lista nueva, con las líneas que toca y los regalos elegidos. */
+export interface HeldPromotion {
+    promotionId: string;
+    promotionVersion: number;
+    kind: SalePromotionKindEnum;
+    stackable: boolean;
+    lineIds: string[];
+    giftSkus: string[];
+}
 /** Lo que quedó apartado y escrito en la sesión: la promo de regalo, la de venta y el código. */
 export interface HoldSalePromotionResponse {
     sessionId: string;
@@ -96,6 +113,8 @@ export interface HoldSalePromotionResponse {
     saleGiftSkus: string[];
     lines: LinePromotionDiscount[];
     totalDiscountCents: number;
+    /** Todas las promos apartadas; los campos de arriba se conservan por compatibilidad. */
+    promotions: HeldPromotion[];
 }
 /** `released: false` = no había apartado; soltar es idempotente. */
 export interface ReleaseSalePromotionResponse {
@@ -127,6 +146,7 @@ export interface SaleAppliedPromotion {
     version: number;
     name: string;
     kind: SalePromotionKindEnum;
+    stackable?: boolean;
 }
 /** Cupón y «lo que se lleva» de una venta cerrada (publicGetSaleCoupon). */
 export interface GetSaleCouponResponse {

package/bin/retailPromotions/enums/RetailPromotionsErrorCodeEnum.d.ts

@@ -44,5 +44,7 @@ export declare enum RetailPromotionsErrorCodeEnum {
     /** El SKU no existe en el catálogo. */
     CATALOG_SKU_NOT_FOUND = "CATALOG_SKU_NOT_FOUND",
     /** Con el reparto apagado no se aplican palancas de precio ni código; los regalos sí. */
-    SPLIT_FINANCING_DISABLED = "SPLIT_FINANCING_DISABLED"
+    SPLIT_FINANCING_DISABLED = "SPLIT_FINANCING_DISABLED",
+    /** La promo no acumulable choca con otra en la misma línea. */
+    PROMOTION_NOT_STACKABLE = "PROMOTION_NOT_STACKABLE"
 }

package/bin/retailPromotions/enums/RetailPromotionsErrorCodeEnum.js

@@ -49,4 +49,6 @@ var RetailPromotionsErrorCodeEnum;
     RetailPromotionsErrorCodeEnum["CATALOG_SKU_NOT_FOUND"] = "CATALOG_SKU_NOT_FOUND";
     /** Con el reparto apagado no se aplican palancas de precio ni código; los regalos sí. */
     RetailPromotionsErrorCodeEnum["SPLIT_FINANCING_DISABLED"] = "SPLIT_FINANCING_DISABLED";
+    /** La promo no acumulable choca con otra en la misma línea. */
+    RetailPromotionsErrorCodeEnum["PROMOTION_NOT_STACKABLE"] = "PROMOTION_NOT_STACKABLE";
 })(RetailPromotionsErrorCodeEnum || (exports.RetailPromotionsErrorCodeEnum = RetailPromotionsErrorCodeEnum = {}));

package/bin/retailPromotions/index.d.ts

@@ -29,6 +29,9 @@ export * from './dtos/SalePromotion';
 export * from './dtos/SalePromotionLogEntry';
 export * from './dtos/DiscountCode';
 export * from './dtos/LinePromotionDiscount';
+export * from './dtos/LinePromotionAmount';
+export * from './dtos/SalePromotionRef';
+export * from './validators/IsHoldModeExclusiveConstraint';
 export * from './dtos/requests/DiscountValueInput';
 export * from './dtos/requests/SalePromotionLeversInput';
 export * from './dtos/requests/SalePromotionScopeInput';
@@ -43,6 +46,7 @@ export * from './dtos/requests/ChangeDiscountCodeStatusRequest';
 export * from './dtos/requests/ListStoreSalePromotionsQuery';
 export * from './dtos/requests/EvaluateSalePromotionsRequest';
 export * from './dtos/requests/HoldGiftPromotionInput';
+export * from './dtos/requests/HoldPromotionInput';
 export * from './dtos/requests/HoldSalePromotionRequest';
 export * from './dtos/requests/GetSaleCouponQuery';
 export * from './dtos/requests/SkuSalePromotionsQuery';