@fiado/type-kit 3.475.0 → 3.476.0

package/_test_/unit/retailCatalog/catalogDebt.test.ts

@@ -121,3 +121,20 @@ describe('InventoryMovementEntry — reason', () => {
     expect(base.reason).toBeUndefined();
   });
 });
+
+describe('InventoryMovementEntry — movementId', () => {
+  it('expone el id del MOV# y sigue válido sin él', () => {
+    const base: InventoryMovementEntry = {
+      storeId: 'ST-1',
+      sku: 'PH-A15',
+      type: InventoryMovementTypeEnum.ADJUSTMENT,
+      qty: 1,
+      identifier: null,
+      occurredAt: '2026-09-28T10:00:00.000Z',
+      createdBy: 'user-1',
+    };
+    const withId: InventoryMovementEntry = { ...base, movementId: 'MOV#01J9ZK' };
+    expect(withId.movementId).toBe('MOV#01J9ZK');
+    expect(base.movementId).toBeUndefined();
+  });
+});

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

@@ -43,7 +43,12 @@ 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(20);
+    expect(Object.keys(RetailPromotionsErrorCodeEnum)).toHaveLength(21);
+  });
+
+  it('promo de regalo y de venta mandadas en el campo equivocado son 422', () => {
+    expect(RetailPromotionsErrorCodeEnum.PROMOTION_KIND_MISMATCH).toBe('PROMOTION_KIND_MISMATCH');
+    expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.PROMOTION_KIND_MISMATCH).toBe(422);
   });
 
   it('promo o cupón de venta inexistentes son 404; sesión sin retailer o tienda es 403', () => {

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

@@ -72,16 +72,45 @@ describe('piezas del wizard', () => {
   it('apartar acepta null como «Ninguna» y valida versión entera y SKUs de regalo', async () => {
     expect(await errorPaths(HoldSalePromotionRequest, { promotionId: null, discountCode: null })).toHaveLength(0);
     expect(
-      await errorPaths(HoldSalePromotionRequest, { promotionId: 'p1', promotionVersion: 2, giftSkus: ['SKU-9'] }),
+      await errorPaths(HoldSalePromotionRequest, { promotionId: 'p1', promotionVersion: 2, saleGiftSkus: ['SKU-9'] }),
     ).toHaveLength(0);
     expect(
-      await errorPaths(HoldSalePromotionRequest, { promotionId: 'p1', promotionVersion: '2', giftSkus: [1] }),
-    ).toEqual(expect.arrayContaining(['promotionVersion', 'giftSkus']));
+      await errorPaths(HoldSalePromotionRequest, { promotionId: 'p1', promotionVersion: '2', saleGiftSkus: [1] }),
+    ).toEqual(expect.arrayContaining(['promotionVersion', 'saleGiftSkus']));
   });
 
   it('apartar pide versión cuando trae promo', async () => {
     expect(await errorPaths(HoldSalePromotionRequest, { promotionId: 'p1' })).toContain('promotionVersion');
   });
+
+  describe('gift (promo de regalo del teléfono)', () => {
+    const gift = { promotionId: 'g1', promotionVersion: 1, skus: ['SKU-1'] };
+
+    it('acepta la promo de regalo junto a la de venta, o null como sin regalo', async () => {
+      expect(
+        await errorPaths(HoldSalePromotionRequest, { gift, promotionId: 'p1', promotionVersion: 2 }),
+      ).toHaveLength(0);
+      expect(await errorPaths(HoldSalePromotionRequest, { gift, promotionId: null })).toHaveLength(0);
+      expect(await errorPaths(HoldSalePromotionRequest, { gift: null })).toHaveLength(0);
+    });
+
+    it('exige promotionId, versión desde 1 y al menos un sku no vacío', async () => {
+      const paths = await errorPaths(HoldSalePromotionRequest, {
+        gift: { promotionId: '', promotionVersion: 0, skus: [] },
+      });
+      expect(paths).toEqual(
+        expect.arrayContaining(['gift.promotionId', 'gift.promotionVersion', 'gift.skus']),
+      );
+      expect(await errorPaths(HoldSalePromotionRequest, { gift: { ...gift, skus: [''] } })).toContain('gift.skus');
+      expect(await errorPaths(HoldSalePromotionRequest, { gift: { ...gift, promotionVersion: 1.5 } })).toContain(
+        'gift.promotionVersion',
+      );
+    });
+
+    it('rechaza un gift que no es objeto', async () => {
+      expect(await errorPaths(HoldSalePromotionRequest, { gift: 'g1' })).toContain('gift');
+    });
+  });
 });
 
 describe('GetSaleCouponQuery', () => {

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

@@ -2,11 +2,13 @@ import 'reflect-metadata';
 import {
   EvaluatedSalePromotion,
   RetailPromotionsErrorCodeEnum,
+  SalePromotionKindEnum,
 } from '../../../src/retailPromotions/index';
 
 const basePromotion: EvaluatedSalePromotion = {
   promotionId: 'promo-1',
   version: 1,
+  kind: SalePromotionKindEnum.SALE,
   name: 'Regalo',
   customerText: 'Llévate un regalo',
   levers: [],

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

@@ -0,0 +1,46 @@
+import 'reflect-metadata';
+import {
+  EvaluatedSalePromotion,
+  SalePromotionKindEnum,
+  SalePromotionLeverEnum,
+  resolveSalePromotionKind,
+} from '../../../src/retailPromotions/index';
+
+describe('resolveSalePromotionKind', () => {
+  it('devuelve GIFT cuando la única palanca es el regalo', () => {
+    expect(resolveSalePromotionKind([SalePromotionLeverEnum.GIFT])).toBe(SalePromotionKindEnum.GIFT);
+  });
+
+  it('devuelve SALE cuando el regalo viene con otras palancas', () => {
+    expect(
+      resolveSalePromotionKind([SalePromotionLeverEnum.GIFT, SalePromotionLeverEnum.DEVICE_DISCOUNT]),
+    ).toBe(SalePromotionKindEnum.SALE);
+  });
+
+  it('devuelve SALE cuando no hay regalo', () => {
+    expect(resolveSalePromotionKind([SalePromotionLeverEnum.COUPON])).toBe(SalePromotionKindEnum.SALE);
+  });
+
+  it('devuelve SALE sin palancas', () => {
+    expect(resolveSalePromotionKind([])).toBe(SalePromotionKindEnum.SALE);
+  });
+});
+
+describe('EvaluatedSalePromotion.kind', () => {
+  it('lleva el tipo de promo', () => {
+    const promotion: EvaluatedSalePromotion = {
+      promotionId: 'g1',
+      version: 1,
+      kind: SalePromotionKindEnum.GIFT,
+      name: 'Regalo',
+      customerText: 'Llévate un regalo',
+      levers: [SalePromotionLeverEnum.GIFT],
+      lines: [],
+      totalDiscountCents: 0,
+      giftOptions: [],
+      giftChooseCount: 1,
+      afterSale: [],
+    };
+    expect(promotion.kind).toBe(SalePromotionKindEnum.GIFT);
+  });
+});

package/bin/retailCatalog/dtos/responses/GetInventorySkuResponse.d.ts

@@ -14,6 +14,8 @@ export interface InventoryMovementEntry {
     createdBy: string;
     /** Motivo guardado en el MOV#; ausente en los tipos que no llevan motivo. */
     reason?: InventoryMovementReasonEnum;
+    /** Id del MOV#, para ligar un ajuste con reversesMovementId. */
+    movementId?: string;
 }
 /** Pieza de una tienda; status AVAILABLE, SOLD o DAMAGED. */
 export interface InventoryPieceEntry {

package/bin/retailPromotions/constants/retailPromotionsErrorHttpStatus.js

@@ -22,6 +22,7 @@ exports.RETAIL_PROMOTIONS_ERROR_HTTP_STATUS = {
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.INVALID_DISCOUNT_CODE]: 422,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.SALE_PROMOTION_NOT_FOUND]: 404,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.SALE_COUPON_NOT_FOUND]: 404,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.PROMOTION_KIND_MISMATCH]: 422,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.MISSING_RETAILER_SCOPE]: 403,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.MISSING_STORE_SCOPE]: 403,
 };

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

@@ -0,0 +1,6 @@
+/** Promo de regalo del teléfono dentro del apartado, con los regalos que eligió el cliente. */
+export declare class HoldGiftPromotionInput {
+    promotionId: string;
+    promotionVersion: number;
+    skus: string[];
+}

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

@@ -0,0 +1,38 @@
+"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.HoldGiftPromotionInput = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Promo de regalo del teléfono dentro del apartado, con los regalos que eligió el cliente. */
+class HoldGiftPromotionInput {
+}
+exports.HoldGiftPromotionInput = HoldGiftPromotionInput;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], HoldGiftPromotionInput.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)
+], HoldGiftPromotionInput.prototype, "promotionVersion", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
+    __metadata("design:type", Array)
+], HoldGiftPromotionInput.prototype, "skus", void 0);

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

@@ -1,11 +1,21 @@
+import { HoldGiftPromotionInput } from './HoldGiftPromotionInput';
 /**
- * Body de publicHoldSalePromotion (PUT, `sessionId` en el path). `promotionId: null` = «Ninguna»;
- * un PUT distinto reemplaza el apartado anterior.
+ * 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.
  */
 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í.
+     */
+    gift?: HoldGiftPromotionInput | null;
+    /**
+     * Promo de venta; `null` = «Ninguna».
+     * El lambda rechaza con PROMOTION_KIND_MISMATCH una promo de solo regalo mandada aquí.
+     */
     promotionId?: string | null;
     promotionVersion?: number | null;
-    /** Regalos elegidos por el cliente, si la promo trae regalo. */
-    giftSkus?: string[] | null;
+    /** Regalo incluido en la promo de venta, solo si esa promo además trae otras palancas. */
+    saleGiftSkus?: string[] | null;
     discountCode?: string | null;
 }

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

@@ -12,13 +12,22 @@ 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 HoldGiftPromotionInput_1 = require("./HoldGiftPromotionInput");
 /**
- * Body de publicHoldSalePromotion (PUT, `sessionId` en el path). `promotionId: null` = «Ninguna»;
- * un PUT distinto reemplaza el apartado anterior.
+ * 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.
  */
 class HoldSalePromotionRequest {
 }
 exports.HoldSalePromotionRequest = HoldSalePromotionRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => HoldGiftPromotionInput_1.HoldGiftPromotionInput),
+    __metadata("design:type", HoldGiftPromotionInput_1.HoldGiftPromotionInput)
+], HoldSalePromotionRequest.prototype, "gift", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
@@ -38,7 +47,7 @@ __decorate([
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
-], HoldSalePromotionRequest.prototype, "giftSkus", void 0);
+], HoldSalePromotionRequest.prototype, "saleGiftSkus", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -4,6 +4,7 @@ import { EntitlementKindEnum } from '../../enums/EntitlementKindEnum';
 import { EntitlementStateEnum } from '../../enums/EntitlementStateEnum';
 import { RetailPromotionsErrorCodeEnum } from '../../enums/RetailPromotionsErrorCodeEnum';
 import { SaleCouponAvailabilityEnum } from '../../enums/SaleCouponAvailabilityEnum';
+import { SalePromotionKindEnum } from '../../enums/SalePromotionKindEnum';
 import { SalePromotionLeverEnum } from '../../enums/SalePromotionLeverEnum';
 import { DiscountValue } from '../DiscountValue';
 import { LinePromotionDiscount } from '../LinePromotionDiscount';
@@ -38,6 +39,8 @@ export interface AfterSaleBenefit {
 export interface EvaluatedSalePromotion {
     promotionId: string;
     version: number;
+    /** GIFT = solo regalo, se aparta por separado en `gift`; SALE = promo de venta. */
+    kind: SalePromotionKindEnum;
     name: string;
     customerText: string;
     levers: SalePromotionLeverEnum[];
@@ -61,13 +64,21 @@ export interface EvaluateSalePromotionsResponse {
     promotions: EvaluatedSalePromotion[];
     discountCode: EvaluatedDiscountCode | null;
 }
-/** Lo que quedó apartado y escrito en la sesión. */
+/** Promo de regalo del teléfono que quedó apartada. */
+export interface HeldGiftPromotion {
+    promotionId: string;
+    promotionVersion: number;
+    skus: 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;
+    gift: HeldGiftPromotion | null;
     promotionId: string | null;
     promotionVersion: number | null;
     discountCode: string | null;
-    giftSkus: string[];
+    /** Regalo incluido en la promo de venta; vacío si no trae. */
+    saleGiftSkus: string[];
     lines: LinePromotionDiscount[];
     totalDiscountCents: number;
 }

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

@@ -22,6 +22,8 @@ export declare enum RetailPromotionsErrorCodeEnum {
     INVALID_DISCOUNT_CODE = "INVALID_DISCOUNT_CODE",
     SALE_PROMOTION_NOT_FOUND = "SALE_PROMOTION_NOT_FOUND",
     SALE_COUPON_NOT_FOUND = "SALE_COUPON_NOT_FOUND",
+    /** Promo de solo regalo mandada como promo de venta, o promo de venta mandada en `gift`. */
+    PROMOTION_KIND_MISMATCH = "PROMOTION_KIND_MISMATCH",
     /** La sesión no trae retailer: no se puede acotar la consulta. */
     MISSING_RETAILER_SCOPE = "MISSING_RETAILER_SCOPE",
     /** La sesión no trae tienda: no se puede acotar la consulta. */

package/bin/retailPromotions/enums/RetailPromotionsErrorCodeEnum.js

@@ -26,6 +26,8 @@ var RetailPromotionsErrorCodeEnum;
     RetailPromotionsErrorCodeEnum["INVALID_DISCOUNT_CODE"] = "INVALID_DISCOUNT_CODE";
     RetailPromotionsErrorCodeEnum["SALE_PROMOTION_NOT_FOUND"] = "SALE_PROMOTION_NOT_FOUND";
     RetailPromotionsErrorCodeEnum["SALE_COUPON_NOT_FOUND"] = "SALE_COUPON_NOT_FOUND";
+    /** Promo de solo regalo mandada como promo de venta, o promo de venta mandada en `gift`. */
+    RetailPromotionsErrorCodeEnum["PROMOTION_KIND_MISMATCH"] = "PROMOTION_KIND_MISMATCH";
     /** La sesión no trae retailer: no se puede acotar la consulta. */
     RetailPromotionsErrorCodeEnum["MISSING_RETAILER_SCOPE"] = "MISSING_RETAILER_SCOPE";
     /** La sesión no trae tienda: no se puede acotar la consulta. */

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

@@ -0,0 +1,8 @@
+/**
+ * Tipo de promo en el apartado: GIFT solo trae regalo y va ligada al teléfono; SALE es cualquier otra.
+ * @enum {string}
+ */
+export declare enum SalePromotionKindEnum {
+    GIFT = "GIFT",
+    SALE = "SALE"
+}

package/bin/retailPromotions/enums/SalePromotionKindEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SalePromotionKindEnum = void 0;
+/**
+ * Tipo de promo en el apartado: GIFT solo trae regalo y va ligada al teléfono; SALE es cualquier otra.
+ * @enum {string}
+ */
+var SalePromotionKindEnum;
+(function (SalePromotionKindEnum) {
+    SalePromotionKindEnum["GIFT"] = "GIFT";
+    SalePromotionKindEnum["SALE"] = "SALE";
+})(SalePromotionKindEnum || (exports.SalePromotionKindEnum = SalePromotionKindEnum = {}));

package/bin/retailPromotions/helpers/resolveSalePromotionKind.d.ts

@@ -0,0 +1,4 @@
+import { SalePromotionKindEnum } from '../enums/SalePromotionKindEnum';
+import { SalePromotionLeverEnum } from '../enums/SalePromotionLeverEnum';
+/** GIFT si la única palanca de la promo es el regalo; SALE en cualquier otro caso. */
+export declare function resolveSalePromotionKind(levers: readonly SalePromotionLeverEnum[]): SalePromotionKindEnum;

package/bin/retailPromotions/helpers/resolveSalePromotionKind.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSalePromotionKind = resolveSalePromotionKind;
+const SalePromotionKindEnum_1 = require("../enums/SalePromotionKindEnum");
+const SalePromotionLeverEnum_1 = require("../enums/SalePromotionLeverEnum");
+/** GIFT si la única palanca de la promo es el regalo; SALE en cualquier otro caso. */
+function resolveSalePromotionKind(levers) {
+    const onlyGift = levers.length > 0 && levers.every((lever) => lever === SalePromotionLeverEnum_1.SalePromotionLeverEnum.GIFT);
+    return onlyGift ? SalePromotionKindEnum_1.SalePromotionKindEnum.GIFT : SalePromotionKindEnum_1.SalePromotionKindEnum.SALE;
+}

package/bin/retailPromotions/index.d.ts

@@ -16,11 +16,13 @@ export * from './enums/EntitlementStateEnum';
 export * from './enums/EntitlementKindEnum';
 export * from './enums/SaleCouponAvailabilityEnum';
 export * from './enums/RetailPromotionsErrorCodeEnum';
+export * from './enums/SalePromotionKindEnum';
 export * from './constants/retailPromotionsErrorHttpStatus';
 export * from './constants/salePromotionTransitions';
 export * from './constants/bonusPreMoney';
 export * from './helpers/resolveSalePromotionTransition';
 export * from './helpers/computeBudgetUsedBps';
+export * from './helpers/resolveSalePromotionKind';
 export * from './dtos/DiscountValue';
 export * from './dtos/SalePromotionLevers';
 export * from './dtos/SalePromotion';
@@ -40,6 +42,7 @@ export * from './dtos/requests/ListDiscountCodesQuery';
 export * from './dtos/requests/ChangeDiscountCodeStatusRequest';
 export * from './dtos/requests/ListStoreSalePromotionsQuery';
 export * from './dtos/requests/EvaluateSalePromotionsRequest';
+export * from './dtos/requests/HoldGiftPromotionInput';
 export * from './dtos/requests/HoldSalePromotionRequest';
 export * from './dtos/requests/GetSaleCouponQuery';
 export * from './dtos/responses/SalePromotionCrudResponses';

package/bin/retailPromotions/index.js

@@ -33,12 +33,14 @@ __exportStar(require("./enums/EntitlementStateEnum"), exports);
 __exportStar(require("./enums/EntitlementKindEnum"), exports);
 __exportStar(require("./enums/SaleCouponAvailabilityEnum"), exports);
 __exportStar(require("./enums/RetailPromotionsErrorCodeEnum"), exports);
+__exportStar(require("./enums/SalePromotionKindEnum"), exports);
 // Constantes y helpers puros
 __exportStar(require("./constants/retailPromotionsErrorHttpStatus"), exports);
 __exportStar(require("./constants/salePromotionTransitions"), exports);
 __exportStar(require("./constants/bonusPreMoney"), exports);
 __exportStar(require("./helpers/resolveSalePromotionTransition"), exports);
 __exportStar(require("./helpers/computeBudgetUsedBps"), exports);
+__exportStar(require("./helpers/resolveSalePromotionKind"), exports);
 // Entidades del dominio
 __exportStar(require("./dtos/DiscountValue"), exports);
 __exportStar(require("./dtos/SalePromotionLevers"), exports);
@@ -60,6 +62,7 @@ __exportStar(require("./dtos/requests/ListDiscountCodesQuery"), exports);
 __exportStar(require("./dtos/requests/ChangeDiscountCodeStatusRequest"), exports);
 __exportStar(require("./dtos/requests/ListStoreSalePromotionsQuery"), exports);
 __exportStar(require("./dtos/requests/EvaluateSalePromotionsRequest"), exports);
+__exportStar(require("./dtos/requests/HoldGiftPromotionInput"), exports);
 __exportStar(require("./dtos/requests/HoldSalePromotionRequest"), exports);
 __exportStar(require("./dtos/requests/GetSaleCouponQuery"), exports);
 // Response DTOs

package/package.json

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

package/src/retailCatalog/dtos/responses/GetInventorySkuResponse.ts

@@ -15,6 +15,8 @@ export interface InventoryMovementEntry {
     createdBy: string;
     /** Motivo guardado en el MOV#; ausente en los tipos que no llevan motivo. */
     reason?: InventoryMovementReasonEnum;
+    /** Id del MOV#, para ligar un ajuste con reversesMovementId. */
+    movementId?: string;
 }
 
 /** Pieza de una tienda; status AVAILABLE, SOLD o DAMAGED. */

package/src/retailPromotions/constants/retailPromotionsErrorHttpStatus.ts

@@ -20,6 +20,7 @@ export const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 403 | 404 |
     [C.INVALID_DISCOUNT_CODE]: 422,
     [C.SALE_PROMOTION_NOT_FOUND]: 404,
     [C.SALE_COUPON_NOT_FOUND]: 404,
+    [C.PROMOTION_KIND_MISMATCH]: 422,
     [C.MISSING_RETAILER_SCOPE]: 403,
     [C.MISSING_STORE_SCOPE]: 403,
 };

package/src/retailPromotions/dtos/requests/HoldGiftPromotionInput.ts

@@ -0,0 +1,22 @@
+import { Expose } from 'class-transformer';
+import { ArrayMinSize, IsArray, IsInt, IsNotEmpty, IsString, Min } from 'class-validator';
+
+/** Promo de regalo del teléfono dentro del apartado, con los regalos que eligió el cliente. */
+export class HoldGiftPromotionInput {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    promotionId!: string;
+
+    @Expose()
+    @IsInt()
+    @Min(1)
+    promotionVersion!: number;
+
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    skus!: string[];
+}

package/src/retailPromotions/dtos/requests/HoldSalePromotionRequest.ts

@@ -1,11 +1,27 @@
-import { Expose } from 'class-transformer';
-import { IsArray, IsInt, IsNotEmpty, IsOptional, IsString, ValidateIf } from 'class-validator';
+import { Expose, Type } from 'class-transformer';
+import { IsArray, IsInt, IsNotEmpty, IsObject, IsOptional, IsString, ValidateIf, ValidateNested } from 'class-validator';
+import { HoldGiftPromotionInput } from './HoldGiftPromotionInput';
 
 /**
- * Body de publicHoldSalePromotion (PUT, `sessionId` en el path). `promotionId: null` = «Ninguna»;
- * un PUT distinto reemplaza el apartado anterior.
+ * 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.
  */
 export 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í.
+     */
+    @Expose()
+    @IsOptional()
+    @IsObject()
+    @ValidateNested()
+    @Type(() => HoldGiftPromotionInput)
+    gift?: HoldGiftPromotionInput | null;
+
+    /**
+     * Promo de venta; `null` = «Ninguna».
+     * El lambda rechaza con PROMOTION_KIND_MISMATCH una promo de solo regalo mandada aquí.
+     */
     @Expose()
     @IsOptional()
     @IsString()
@@ -17,12 +33,12 @@ export class HoldSalePromotionRequest {
     @IsInt()
     promotionVersion?: number | null;
 
-    /** Regalos elegidos por el cliente, si la promo trae regalo. */
+    /** Regalo incluido en la promo de venta, solo si esa promo además trae otras palancas. */
     @Expose()
     @IsOptional()
     @IsArray()
     @IsString({ each: true })
-    giftSkus?: string[] | null;
+    saleGiftSkus?: string[] | null;
 
     @Expose()
     @IsOptional()

package/src/retailPromotions/dtos/responses/WizardSalePromotionResponses.ts

@@ -4,6 +4,7 @@ import { EntitlementKindEnum } from '../../enums/EntitlementKindEnum';
 import { EntitlementStateEnum } from '../../enums/EntitlementStateEnum';
 import { RetailPromotionsErrorCodeEnum } from '../../enums/RetailPromotionsErrorCodeEnum';
 import { SaleCouponAvailabilityEnum } from '../../enums/SaleCouponAvailabilityEnum';
+import { SalePromotionKindEnum } from '../../enums/SalePromotionKindEnum';
 import { SalePromotionLeverEnum } from '../../enums/SalePromotionLeverEnum';
 import { DiscountValue } from '../DiscountValue';
 import { LinePromotionDiscount } from '../LinePromotionDiscount';
@@ -43,6 +44,8 @@ export interface AfterSaleBenefit {
 export interface EvaluatedSalePromotion {
     promotionId: string;
     version: number;
+    /** GIFT = solo regalo, se aparta por separado en `gift`; SALE = promo de venta. */
+    kind: SalePromotionKindEnum;
     name: string;
     customerText: string;
     levers: SalePromotionLeverEnum[];
@@ -69,13 +72,22 @@ export interface EvaluateSalePromotionsResponse {
     discountCode: EvaluatedDiscountCode | null;
 }
 
-/** Lo que quedó apartado y escrito en la sesión. */
+/** Promo de regalo del teléfono que quedó apartada. */
+export interface HeldGiftPromotion {
+    promotionId: string;
+    promotionVersion: number;
+    skus: 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;
+    gift: HeldGiftPromotion | null;
     promotionId: string | null;
     promotionVersion: number | null;
     discountCode: string | null;
-    giftSkus: string[];
+    /** Regalo incluido en la promo de venta; vacío si no trae. */
+    saleGiftSkus: string[];
     lines: LinePromotionDiscount[];
     totalDiscountCents: number;
 }

package/src/retailPromotions/enums/RetailPromotionsErrorCodeEnum.ts

@@ -22,6 +22,8 @@ export enum RetailPromotionsErrorCodeEnum {
     INVALID_DISCOUNT_CODE = 'INVALID_DISCOUNT_CODE',
     SALE_PROMOTION_NOT_FOUND = 'SALE_PROMOTION_NOT_FOUND',
     SALE_COUPON_NOT_FOUND = 'SALE_COUPON_NOT_FOUND',
+    /** Promo de solo regalo mandada como promo de venta, o promo de venta mandada en `gift`. */
+    PROMOTION_KIND_MISMATCH = 'PROMOTION_KIND_MISMATCH',
     /** La sesión no trae retailer: no se puede acotar la consulta. */
     MISSING_RETAILER_SCOPE = 'MISSING_RETAILER_SCOPE',
     /** La sesión no trae tienda: no se puede acotar la consulta. */

package/src/retailPromotions/enums/SalePromotionKindEnum.ts

@@ -0,0 +1,8 @@
+/**
+ * Tipo de promo en el apartado: GIFT solo trae regalo y va ligada al teléfono; SALE es cualquier otra.
+ * @enum {string}
+ */
+export enum SalePromotionKindEnum {
+    GIFT = 'GIFT',
+    SALE = 'SALE',
+}

package/src/retailPromotions/helpers/resolveSalePromotionKind.ts

@@ -0,0 +1,8 @@
+import { SalePromotionKindEnum } from '../enums/SalePromotionKindEnum';
+import { SalePromotionLeverEnum } from '../enums/SalePromotionLeverEnum';
+
+/** GIFT si la única palanca de la promo es el regalo; SALE en cualquier otro caso. */
+export function resolveSalePromotionKind(levers: readonly SalePromotionLeverEnum[]): SalePromotionKindEnum {
+    const onlyGift = levers.length > 0 && levers.every((lever) => lever === SalePromotionLeverEnum.GIFT);
+    return onlyGift ? SalePromotionKindEnum.GIFT : SalePromotionKindEnum.SALE;
+}

package/src/retailPromotions/index.ts

@@ -17,6 +17,7 @@ export * from './enums/EntitlementStateEnum';
 export * from './enums/EntitlementKindEnum';
 export * from './enums/SaleCouponAvailabilityEnum';
 export * from './enums/RetailPromotionsErrorCodeEnum';
+export * from './enums/SalePromotionKindEnum';
 
 // Constantes y helpers puros
 export * from './constants/retailPromotionsErrorHttpStatus';
@@ -24,6 +25,7 @@ export * from './constants/salePromotionTransitions';
 export * from './constants/bonusPreMoney';
 export * from './helpers/resolveSalePromotionTransition';
 export * from './helpers/computeBudgetUsedBps';
+export * from './helpers/resolveSalePromotionKind';
 
 // Entidades del dominio
 export * from './dtos/DiscountValue';
@@ -47,6 +49,7 @@ export * from './dtos/requests/ListDiscountCodesQuery';
 export * from './dtos/requests/ChangeDiscountCodeStatusRequest';
 export * from './dtos/requests/ListStoreSalePromotionsQuery';
 export * from './dtos/requests/EvaluateSalePromotionsRequest';
+export * from './dtos/requests/HoldGiftPromotionInput';
 export * from './dtos/requests/HoldSalePromotionRequest';
 export * from './dtos/requests/GetSaleCouponQuery';