@fiado/type-kit 3.476.0 → 3.478.0

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,12 @@ 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(21);
+    expect(Object.keys(RetailPromotionsErrorCodeEnum)).toHaveLength(28);
   });
 
   it('promo de regalo y de venta mandadas en el campo equivocado son 422', () => {
@@ -58,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/retailWizard/promotionM2mRequests.test.ts

@@ -83,6 +83,43 @@ describe('SetAnchorGiftsRequest', () => {
     expect(errorsOf(SetAnchorGiftsRequest, { ...ok, items: [{ sku: '' }] })).toContain('items.0.sku'));
   it('exige items como arreglo', () =>
     expect(errorsOf(SetAnchorGiftsRequest, { promotionId: null, promotionVersion: null })).toContain('items'));
+
+  describe('promo por item', () => {
+    const own = { sku: 'CASE-1', promotionId: 'promo-2', promotionVersion: 3 };
+
+    it('acepta un item sin promo propia (usa la de la raíz)', () => {
+      const req = plainToInstance(SetAnchorGiftsRequest, ok);
+      expect(validateSync(req)).toEqual([]);
+      expect(req.items[0].promotionId).toBeUndefined();
+      expect(req.items[0].promotionVersion).toBeUndefined();
+    });
+    it('acepta un item con promotionId y promotionVersion', () =>
+      expect(errorsOf(SetAnchorGiftsRequest, { ...ok, items: [own] })).toEqual([]));
+    it('exige promotionVersion si el item trae solo promotionId', () =>
+      expect(errorsOf(SetAnchorGiftsRequest, { ...ok, items: [{ sku: 'CASE-1', promotionId: 'promo-2' }] })).toContain(
+        'items.0.promotionVersion',
+      ));
+    it('exige promotionId si el item trae solo promotionVersion', () =>
+      expect(errorsOf(SetAnchorGiftsRequest, { ...ok, items: [{ sku: 'CASE-1', promotionVersion: 3 }] })).toContain(
+        'items.0.promotionId',
+      ));
+    it('rechaza la versión 0 en el item', () =>
+      expect(errorsOf(SetAnchorGiftsRequest, { ...ok, items: [{ ...own, promotionVersion: 0 }] })).toContain(
+        'items.0.promotionVersion',
+      ));
+    it('rechaza promotionId vacío en el item', () =>
+      expect(errorsOf(SetAnchorGiftsRequest, { ...ok, items: [{ ...own, promotionId: '' }] })).toContain(
+        'items.0.promotionId',
+      ));
+    it('acepta dos items de la misma ancla con promos distintas', () => {
+      const req = plainToInstance(SetAnchorGiftsRequest, {
+        ...ok,
+        items: [own, { sku: 'MICA-1', promotionId: 'promo-9', promotionVersion: 1 }],
+      });
+      expect(validateSync(req)).toEqual([]);
+      expect(req.items.map((i) => i.promotionId)).toEqual(['promo-2', 'promo-9']);
+    });
+  });
 });
 
 describe('ApplySalePromotionRequest', () => {

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,
@@ -25,4 +25,11 @@ exports.RETAIL_PROMOTIONS_ERROR_HTTP_STATUS = {
     [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/enums/RetailPromotionsErrorCodeEnum.d.ts

@@ -27,5 +27,18 @@ export declare enum RetailPromotionsErrorCodeEnum {
     /** 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

@@ -32,4 +32,17 @@ var RetailPromotionsErrorCodeEnum;
     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/retailWizard/dtos/requests/SetAnchorGiftsRequest.d.ts

@@ -1,6 +1,9 @@
 /** Un regalo del conjunto que queda ligado al ancla. */
 export declare class AnchorGiftItem {
     sku: string;
+    /** Promo propia de esta línea GIFT; va junto con `promotionVersion` y, si falta, se usa la de la raíz. */
+    promotionId?: string;
+    promotionVersion?: number;
 }
 /**
  * PUT /private/wizard/sessions/{id}/lines/{anchorLineId}/gifts (M2M de Promociones).

package/bin/retailWizard/dtos/requests/SetAnchorGiftsRequest.js

@@ -12,6 +12,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SetAnchorGiftsRequest = exports.AnchorGiftItem = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+/** Hay que validar la promo del item si vino cualquiera de sus dos campos. */
+function hasOwnPromotion(o) {
+    return o.promotionId !== undefined || o.promotionVersion !== undefined;
+}
 /** Un regalo del conjunto que queda ligado al ancla. */
 class AnchorGiftItem {
 }
@@ -22,6 +26,20 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], AnchorGiftItem.prototype, "sku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)(hasOwnPromotion),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AnchorGiftItem.prototype, "promotionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)(hasOwnPromotion),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], AnchorGiftItem.prototype, "promotionVersion", void 0);
 /** Hay que validar el campo si hay regalos o si vino con valor. */
 function mustValidate(o, value) {
     return (Array.isArray(o.items) && o.items.length > 0) || (value !== null && value !== undefined);

package/package.json

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

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,
@@ -23,4 +23,11 @@ export const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 403 | 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/enums/RetailPromotionsErrorCodeEnum.ts

@@ -28,4 +28,17 @@ export enum RetailPromotionsErrorCodeEnum {
     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/retailWizard/dtos/requests/SetAnchorGiftsRequest.ts

@@ -1,12 +1,30 @@
 import { Expose, Type } from 'class-transformer';
 import { IsArray, IsInt, IsNotEmpty, IsString, Min, ValidateIf, ValidateNested } from 'class-validator';
 
+/** Hay que validar la promo del item si vino cualquiera de sus dos campos. */
+function hasOwnPromotion(o: AnchorGiftItem): boolean {
+  return o.promotionId !== undefined || o.promotionVersion !== undefined;
+}
+
 /** Un regalo del conjunto que queda ligado al ancla. */
 export class AnchorGiftItem {
   @Expose()
   @IsString()
   @IsNotEmpty()
   sku!: string;
+
+  /** Promo propia de esta línea GIFT; va junto con `promotionVersion` y, si falta, se usa la de la raíz. */
+  @Expose()
+  @ValidateIf(hasOwnPromotion)
+  @IsString()
+  @IsNotEmpty()
+  promotionId?: string;
+
+  @Expose()
+  @ValidateIf(hasOwnPromotion)
+  @IsInt()
+  @Min(1)
+  promotionVersion?: number;
 }
 
 /** Hay que validar el campo si hay regalos o si vino con valor. */