@fiado/type-kit 3.475.0 → 3.477.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/retailCatalog/storeCatalogItemSaga.test.ts

@@ -0,0 +1,18 @@
+import 'reflect-metadata';
+import * as RetailCatalog from '../../../src/retailCatalog';
+
+type SagaFields = Pick<RetailCatalog.StoreCatalogItem, 'sku' | 'listPriceCents' | 'salePriority'>;
+
+describe('StoreCatalogItem — campos de la venta saga', () => {
+  it('acepta listPriceCents y salePriority', () => {
+    const item: SagaFields = { sku: 'SKU-1', listPriceCents: 129900, salePriority: 80 };
+    expect(item.listPriceCents).toBe(129900);
+    expect(item.salePriority).toBe(80);
+  });
+
+  it('sigue válido sin listPriceCents ni salePriority', () => {
+    const item: SagaFields = { sku: 'SKU-1' };
+    expect(item.listPriceCents).toBeUndefined();
+    expect(item.salePriority).toBeUndefined();
+  });
+});

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

@@ -38,12 +38,17 @@ describe('resolveSalePromotionTransition', () => {
 describe('catálogo de errores', () => {
   it('cada code tiene su status del catálogo cerrado', () => {
     for (const code of Object.values(RetailPromotionsErrorCodeEnum)) {
-      expect([403, 404, 409, 422]).toContain(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS[code]);
+      expect([400, 403, 404, 409, 422, 502]).toContain(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS[code]);
     }
     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(28);
+  });
+
+  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', () => {
@@ -53,6 +58,19 @@ describe('catálogo de errores', () => {
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.MISSING_STORE_SCOPE).toBe(403);
   });
 
+  it.each([
+    ['SESSION_STILL_ACTIVE', 409],
+    ['WIZARD_SESSION_NOT_FOUND', 404],
+    ['UPSTREAM_UNAVAILABLE', 502],
+    ['MISSING_TENANT_SCOPE', 403],
+    ['PROMOTION_NOT_REVALIDATED', 409],
+    ['SALE_PROMOTION_HOLD_CONFLICT', 409],
+    ['INVALID_NEXT_TOKEN', 400],
+  ] as const)('%s es %i', (code, status) => {
+    expect(RetailPromotionsErrorCodeEnum[code]).toBe(code);
+    expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS[code]).toBe(status);
+  });
+
   it('promo y código con rangos, signo o palancas inválidos son 422', () => {
     expect(RetailPromotionsErrorCodeEnum.INVALID_SALE_PROMOTION).toBe('INVALID_SALE_PROMOTION');
     expect(RetailPromotionsErrorCodeEnum.INVALID_DISCOUNT_CODE).toBe('INVALID_DISCOUNT_CODE');

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/retailCatalog/dtos/responses/StoreCatalogItem.d.ts

@@ -36,6 +36,10 @@ export interface StoreCatalogItem {
     itemType?: ItemTypeEnum;
     /** Nombre visible para kits y servicios, que no tienen marca/modelo. */
     description?: string;
+    /** Precio de lista de respaldo para un regalo: el precio vigente o, si no hay, product.basePriceCents. */
+    listPriceCents?: number;
+    /** Prioridad de venta de 0 a 100; «Recomendados» ordena por ella. */
+    salePriority?: number;
 }
 /** Response de privateGetStoreStockCatalog. */
 export type GetStoreStockCatalogResponse = StoreCatalogItem[];

package/bin/retailPromotions/constants/retailPromotionsErrorHttpStatus.d.ts

@@ -1,3 +1,3 @@
 import { RetailPromotionsErrorCodeEnum as C } from '../enums/RetailPromotionsErrorCodeEnum';
-/** Status HTTP de cada code: 403 sesión sin alcance · 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
-export declare const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 403 | 404 | 409 | 422>>;
+/** Status HTTP de cada code: 400 request inválido · 403 sesión sin alcance · 404 no existe · 409 conflicto · 422 regla de negocio · 502 externo. */
+export declare const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 403 | 404 | 409 | 422 | 502>>;

package/bin/retailPromotions/constants/retailPromotionsErrorHttpStatus.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RETAIL_PROMOTIONS_ERROR_HTTP_STATUS = void 0;
 const RetailPromotionsErrorCodeEnum_1 = require("../enums/RetailPromotionsErrorCodeEnum");
-/** Status HTTP de cada code: 403 sesión sin alcance · 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
+/** Status HTTP de cada code: 400 request inválido · 403 sesión sin alcance · 404 no existe · 409 conflicto · 422 regla de negocio · 502 externo. */
 exports.RETAIL_PROMOTIONS_ERROR_HTTP_STATUS = {
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.INVALID_PROMOTION_TRANSITION]: 409,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.CODE_TEXT_TAKEN]: 409,
@@ -22,6 +22,14 @@ 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,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.SESSION_STILL_ACTIVE]: 409,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.WIZARD_SESSION_NOT_FOUND]: 404,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.UPSTREAM_UNAVAILABLE]: 502,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.MISSING_TENANT_SCOPE]: 403,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.PROMOTION_NOT_REVALIDATED]: 409,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.SALE_PROMOTION_HOLD_CONFLICT]: 409,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.INVALID_NEXT_TOKEN]: 400,
 };

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,8 +22,23 @@ 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. */
-    MISSING_STORE_SCOPE = "MISSING_STORE_SCOPE"
+    MISSING_STORE_SCOPE = "MISSING_STORE_SCOPE",
+    /** La sesión del wizard sigue abierta y no admite la operación. */
+    SESSION_STILL_ACTIVE = "SESSION_STILL_ACTIVE",
+    WIZARD_SESSION_NOT_FOUND = "WIZARD_SESSION_NOT_FOUND",
+    /** Un servicio externo falló o no respondió. */
+    UPSTREAM_UNAVAILABLE = "UPSTREAM_UNAVAILABLE",
+    /** La sesión no trae tenant: no se puede acotar la consulta. */
+    MISSING_TENANT_SCOPE = "MISSING_TENANT_SCOPE",
+    /** La promo no se revalidó antes de cobrar. */
+    PROMOTION_NOT_REVALIDATED = "PROMOTION_NOT_REVALIDATED",
+    /** Otra venta ya retiene la promo. */
+    SALE_PROMOTION_HOLD_CONFLICT = "SALE_PROMOTION_HOLD_CONFLICT",
+    /** El token de paginación no es válido. */
+    INVALID_NEXT_TOKEN = "INVALID_NEXT_TOKEN"
 }

package/bin/retailPromotions/enums/RetailPromotionsErrorCodeEnum.js

@@ -26,8 +26,23 @@ 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. */
     RetailPromotionsErrorCodeEnum["MISSING_STORE_SCOPE"] = "MISSING_STORE_SCOPE";
+    /** La sesión del wizard sigue abierta y no admite la operación. */
+    RetailPromotionsErrorCodeEnum["SESSION_STILL_ACTIVE"] = "SESSION_STILL_ACTIVE";
+    RetailPromotionsErrorCodeEnum["WIZARD_SESSION_NOT_FOUND"] = "WIZARD_SESSION_NOT_FOUND";
+    /** Un servicio externo falló o no respondió. */
+    RetailPromotionsErrorCodeEnum["UPSTREAM_UNAVAILABLE"] = "UPSTREAM_UNAVAILABLE";
+    /** La sesión no trae tenant: no se puede acotar la consulta. */
+    RetailPromotionsErrorCodeEnum["MISSING_TENANT_SCOPE"] = "MISSING_TENANT_SCOPE";
+    /** La promo no se revalidó antes de cobrar. */
+    RetailPromotionsErrorCodeEnum["PROMOTION_NOT_REVALIDATED"] = "PROMOTION_NOT_REVALIDATED";
+    /** Otra venta ya retiene la promo. */
+    RetailPromotionsErrorCodeEnum["SALE_PROMOTION_HOLD_CONFLICT"] = "SALE_PROMOTION_HOLD_CONFLICT";
+    /** El token de paginación no es válido. */
+    RetailPromotionsErrorCodeEnum["INVALID_NEXT_TOKEN"] = "INVALID_NEXT_TOKEN";
 })(RetailPromotionsErrorCodeEnum || (exports.RetailPromotionsErrorCodeEnum = RetailPromotionsErrorCodeEnum = {}));

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.477.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/retailCatalog/dtos/responses/StoreCatalogItem.ts

@@ -38,6 +38,10 @@ export interface StoreCatalogItem {
     itemType?: ItemTypeEnum;
     /** Nombre visible para kits y servicios, que no tienen marca/modelo. */
     description?: string;
+    /** Precio de lista de respaldo para un regalo: el precio vigente o, si no hay, product.basePriceCents. */
+    listPriceCents?: number;
+    /** Prioridad de venta de 0 a 100; «Recomendados» ordena por ella. */
+    salePriority?: number;
 }
 
 /** Response de privateGetStoreStockCatalog. */

package/src/retailPromotions/constants/retailPromotionsErrorHttpStatus.ts

@@ -1,7 +1,7 @@
 import { RetailPromotionsErrorCodeEnum as C } from '../enums/RetailPromotionsErrorCodeEnum';
 
-/** Status HTTP de cada code: 403 sesión sin alcance · 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
-export const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 403 | 404 | 409 | 422>> = {
+/** Status HTTP de cada code: 400 request inválido · 403 sesión sin alcance · 404 no existe · 409 conflicto · 422 regla de negocio · 502 externo. */
+export const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 403 | 404 | 409 | 422 | 502>> = {
     [C.INVALID_PROMOTION_TRANSITION]: 409,
     [C.CODE_TEXT_TAKEN]: 409,
     [C.PROMOTION_NOT_ACTIVE]: 409,
@@ -20,6 +20,14 @@ 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,
+    [C.SESSION_STILL_ACTIVE]: 409,
+    [C.WIZARD_SESSION_NOT_FOUND]: 404,
+    [C.UPSTREAM_UNAVAILABLE]: 502,
+    [C.MISSING_TENANT_SCOPE]: 403,
+    [C.PROMOTION_NOT_REVALIDATED]: 409,
+    [C.SALE_PROMOTION_HOLD_CONFLICT]: 409,
+    [C.INVALID_NEXT_TOKEN]: 400,
 };

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,8 +22,23 @@ 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. */
     MISSING_STORE_SCOPE = 'MISSING_STORE_SCOPE',
+    /** La sesión del wizard sigue abierta y no admite la operación. */
+    SESSION_STILL_ACTIVE = 'SESSION_STILL_ACTIVE',
+    WIZARD_SESSION_NOT_FOUND = 'WIZARD_SESSION_NOT_FOUND',
+    /** Un servicio externo falló o no respondió. */
+    UPSTREAM_UNAVAILABLE = 'UPSTREAM_UNAVAILABLE',
+    /** La sesión no trae tenant: no se puede acotar la consulta. */
+    MISSING_TENANT_SCOPE = 'MISSING_TENANT_SCOPE',
+    /** La promo no se revalidó antes de cobrar. */
+    PROMOTION_NOT_REVALIDATED = 'PROMOTION_NOT_REVALIDATED',
+    /** Otra venta ya retiene la promo. */
+    SALE_PROMOTION_HOLD_CONFLICT = 'SALE_PROMOTION_HOLD_CONFLICT',
+    /** El token de paginación no es válido. */
+    INVALID_NEXT_TOKEN = 'INVALID_NEXT_TOKEN',
 }

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';