@fiado/type-kit 3.482.0 → 3.484.0

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

@@ -0,0 +1,56 @@
+import 'reflect-metadata';
+import {
+  GetSaleCouponResponse,
+  SaleAppliedPromotion,
+  SaleCouponAvailabilityEnum,
+  SalePromotionKindEnum,
+} from '../../../src/retailPromotions/index';
+
+const gift: SaleAppliedPromotion = {
+  promotionId: 'promo-gift',
+  version: 2,
+  name: 'Regalo de mica',
+  kind: SalePromotionKindEnum.GIFT,
+};
+
+const sale: SaleAppliedPromotion = {
+  promotionId: 'promo-sale',
+  version: 1,
+  name: 'Descuento de temporada',
+  kind: SalePromotionKindEnum.SALE,
+};
+
+describe('GetSaleCouponResponse.appliedPromotions', () => {
+  it('lleva las promos de regalo y de venta con su versión y nombre', () => {
+    const response: GetSaleCouponResponse = {
+      saleId: 'sale-1',
+      availability: Object.values(SaleCouponAvailabilityEnum)[0],
+      coupon: null,
+      entitlements: [],
+      appliedPromotions: [gift, sale],
+    };
+
+    expect(response.appliedPromotions.map((p) => p.kind)).toEqual([
+      SalePromotionKindEnum.GIFT,
+      SalePromotionKindEnum.SALE,
+    ]);
+    expect(response.appliedPromotions[0]).toEqual({
+      promotionId: 'promo-gift',
+      version: 2,
+      name: 'Regalo de mica',
+      kind: SalePromotionKindEnum.GIFT,
+    });
+  });
+
+  it('acepta una venta sin promos aplicadas', () => {
+    const response: GetSaleCouponResponse = {
+      saleId: 'sale-2',
+      availability: Object.values(SaleCouponAvailabilityEnum)[0],
+      coupon: null,
+      entitlements: [],
+      appliedPromotions: [],
+    };
+
+    expect(response.appliedPromotions).toHaveLength(0);
+  });
+});

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

@@ -0,0 +1,49 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { SalePromotionLeversInput } from '../../../src/retailPromotions/index';
+
+/** Rutas de propiedad con error dentro de las palancas (`deviceDiscount.maxAmountCents`). */
+const errorPaths = async (levers: Record<string, unknown>): Promise<string[]> => {
+  const errors = await validate(plainToInstance(SalePromotionLeversInput, levers) as object);
+  const walk = (list: typeof errors, prefix: string): string[] =>
+    list.flatMap((e) => {
+      const path = prefix ? `${prefix}.${e.property}` : e.property;
+      return e.children && e.children.length > 0 ? walk(e.children, path) : [path];
+    });
+  return walk(errors, '');
+};
+
+describe('deviceDiscount', () => {
+  it('acepta % o $ con tope opcional', async () => {
+    expect(await errorPaths({ deviceDiscount: { type: 'PERCENTAGE', percentBps: 1500, maxAmountCents: 200000 } })).toHaveLength(0);
+    expect(await errorPaths({ deviceDiscount: { type: 'AMOUNT', amountCents: 50000 } })).toHaveLength(0);
+    expect(await errorPaths({ deviceDiscount: { type: 'AMOUNT', amountCents: 50000, maxAmountCents: null } })).toHaveLength(0);
+  });
+
+  it('rechaza porcentaje fuera de 1..10000, monto no positivo y tope no positivo', async () => {
+    expect(await errorPaths({ deviceDiscount: { type: 'PERCENTAGE', percentBps: 0 } })).toContain('deviceDiscount.percentBps');
+    expect(await errorPaths({ deviceDiscount: { type: 'PERCENTAGE', percentBps: 10001 } })).toContain('deviceDiscount.percentBps');
+    expect(await errorPaths({ deviceDiscount: { type: 'AMOUNT', amountCents: 0 } })).toContain('deviceDiscount.amountCents');
+    expect(await errorPaths({ deviceDiscount: { type: 'AMOUNT', amountCents: 100, maxAmountCents: 0 } })).toContain('deviceDiscount.maxAmountCents');
+  });
+});
+
+describe('accessoryDiscount', () => {
+  it('sin type se asume porcentaje, como las promos existentes', async () => {
+    expect(await errorPaths({ accessoryDiscount: { percentBps: 2000, maxAmountCents: 30000 } })).toHaveLength(0);
+    expect(await errorPaths({ accessoryDiscount: { maxAmountCents: 30000 } })).toContain('accessoryDiscount.percentBps');
+  });
+
+  it('acepta monto fijo con type AMOUNT y no exige percentBps', async () => {
+    expect(await errorPaths({ accessoryDiscount: { type: 'AMOUNT', amountCents: 10000 } })).toHaveLength(0);
+    expect(await errorPaths({ accessoryDiscount: { type: 'AMOUNT', percentBps: 1000 } })).toContain('accessoryDiscount.amountCents');
+  });
+
+  it('rechaza tipo desconocido, porcentaje fuera de rango, monto y tope no positivos', async () => {
+    expect(await errorPaths({ accessoryDiscount: { type: 'FREE', percentBps: 1000 } })).toContain('accessoryDiscount.type');
+    expect(await errorPaths({ accessoryDiscount: { type: 'PERCENTAGE', percentBps: 10001 } })).toContain('accessoryDiscount.percentBps');
+    expect(await errorPaths({ accessoryDiscount: { type: 'AMOUNT', amountCents: -5 } })).toContain('accessoryDiscount.amountCents');
+    expect(await errorPaths({ accessoryDiscount: { percentBps: 1000, maxAmountCents: 0 } })).toContain('accessoryDiscount.maxAmountCents');
+  });
+});

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

@@ -2,11 +2,18 @@ import { AccessorySubcategoryEnum } from '../../retailCatalog/enums/AccessorySub
 import { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
 import { CouponScopeEnum } from '../enums/CouponScopeEnum';
+import { DiscountTypeEnum } from '../enums/DiscountTypeEnum';
 import { GiftModeEnum } from '../enums/GiftModeEnum';
 import { DiscountValue } from './DiscountValue';
-/** Descuento en accesorios: % sobre los accesorios de la venta, con tope opcional en centavos. */
+/** Descuento del equipo en % o $, con tope opcional en centavos. */
+export interface DeviceDiscountLever extends DiscountValue {
+    maxAmountCents?: number | null;
+}
+/** Descuento en accesorios en % o $, con tope opcional en centavos; sin `type` es `PERCENTAGE`. */
 export interface AccessoryDiscountLever {
-    percentBps: number;
+    type?: DiscountTypeEnum | null;
+    amountCents?: number | null;
+    percentBps: number | null;
     maxAmountCents: number | null;
 }
 /** Regalo por lista (`skus`) o por gama (`accessorySubcategory` + `maxPriceCents`); el cliente elige `chooseCount`. */
@@ -37,7 +44,7 @@ export interface WalletBonusLever {
 }
 /** Las 7 palancas; una palanca ausente o `null` no se usa. */
 export interface SalePromotionLevers {
-    deviceDiscount: DiscountValue | null;
+    deviceDiscount: DeviceDiscountLever | null;
     accessoryDiscount: AccessoryDiscountLever | null;
     gift: GiftLever | null;
     coupon: CouponLever | null;

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

@@ -1,9 +1,20 @@
 import { AccessorySubcategoryEnum } from '../../../retailCatalog/enums/AccessorySubcategoryEnum';
 import { CouponScopeEnum } from '../../enums/CouponScopeEnum';
+import { DiscountTypeEnum } from '../../enums/DiscountTypeEnum';
 import { GiftModeEnum } from '../../enums/GiftModeEnum';
 import { DiscountValueInput } from './DiscountValueInput';
+/** Descuento del equipo: % (`percentBps` 1..10000) o $ (`amountCents` > 0), con tope opcional en centavos. */
+export declare class DeviceDiscountLeverInput {
+    type: DiscountTypeEnum;
+    amountCents?: number | null;
+    percentBps?: number | null;
+    maxAmountCents?: number | null;
+}
+/** Descuento en accesorios: igual que el del equipo, pero sin `type` se asume `PERCENTAGE`. */
 export declare class AccessoryDiscountLeverInput {
-    percentBps: number;
+    type?: DiscountTypeEnum | null;
+    amountCents?: number | null;
+    percentBps?: number | null;
     maxAmountCents?: number | null;
 }
 /** Regalo por lista exige `skus`; por gama exige `accessorySubcategory` y `maxPriceCents`. */
@@ -31,7 +42,7 @@ export declare class WalletBonusLeverInput {
 }
 /** Las 7 palancas en el body; que venga al menos una lo valida el lambda (422). */
 export declare class SalePromotionLeversInput {
-    deviceDiscount?: DiscountValueInput | null;
+    deviceDiscount?: DeviceDiscountLeverInput | null;
     accessoryDiscount?: AccessoryDiscountLeverInput | null;
     gift?: GiftLeverInput | null;
     coupon?: CouponLeverInput | null;

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

@@ -9,25 +9,75 @@ 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.SalePromotionLeversInput = exports.WalletBonusLeverInput = exports.ExtendedWarrantyLeverInput = exports.AirtimeLeverInput = exports.CouponLeverInput = exports.GiftLeverInput = exports.AccessoryDiscountLeverInput = void 0;
+exports.SalePromotionLeversInput = exports.WalletBonusLeverInput = exports.ExtendedWarrantyLeverInput = exports.AirtimeLeverInput = exports.CouponLeverInput = exports.GiftLeverInput = exports.AccessoryDiscountLeverInput = exports.DeviceDiscountLeverInput = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const AccessorySubcategoryEnum_1 = require("../../../retailCatalog/enums/AccessorySubcategoryEnum");
 const CouponScopeEnum_1 = require("../../enums/CouponScopeEnum");
+const DiscountTypeEnum_1 = require("../../enums/DiscountTypeEnum");
 const GiftModeEnum_1 = require("../../enums/GiftModeEnum");
 const DiscountValueInput_1 = require("./DiscountValueInput");
+/** Descuento del equipo: % (`percentBps` 1..10000) o $ (`amountCents` > 0), con tope opcional en centavos. */
+class DeviceDiscountLeverInput {
+}
+exports.DeviceDiscountLeverInput = DeviceDiscountLeverInput;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(DiscountTypeEnum_1.DiscountTypeEnum),
+    __metadata("design:type", String)
+], DeviceDiscountLeverInput.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.type === DiscountTypeEnum_1.DiscountTypeEnum.AMOUNT),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], DeviceDiscountLeverInput.prototype, "amountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.type === DiscountTypeEnum_1.DiscountTypeEnum.PERCENTAGE),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(10000),
+    __metadata("design:type", Number)
+], DeviceDiscountLeverInput.prototype, "percentBps", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], DeviceDiscountLeverInput.prototype, "maxAmountCents", void 0);
+/** Descuento en accesorios: igual que el del equipo, pero sin `type` se asume `PERCENTAGE`. */
 class AccessoryDiscountLeverInput {
 }
 exports.AccessoryDiscountLeverInput = AccessoryDiscountLeverInput;
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(DiscountTypeEnum_1.DiscountTypeEnum),
+    __metadata("design:type", String)
+], AccessoryDiscountLeverInput.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.type === DiscountTypeEnum_1.DiscountTypeEnum.AMOUNT),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], AccessoryDiscountLeverInput.prototype, "amountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.type !== DiscountTypeEnum_1.DiscountTypeEnum.AMOUNT),
     (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(10000),
     __metadata("design:type", Number)
 ], AccessoryDiscountLeverInput.prototype, "percentBps", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
     __metadata("design:type", Number)
 ], AccessoryDiscountLeverInput.prototype, "maxAmountCents", void 0);
 /** Regalo por lista exige `skus`; por gama exige `accessorySubcategory` y `maxPriceCents`. */
@@ -119,8 +169,8 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.ValidateNested)(),
-    (0, class_transformer_1.Type)(() => DiscountValueInput_1.DiscountValueInput),
-    __metadata("design:type", DiscountValueInput_1.DiscountValueInput)
+    (0, class_transformer_1.Type)(() => DeviceDiscountLeverInput),
+    __metadata("design:type", DeviceDiscountLeverInput)
 ], SalePromotionLeversInput.prototype, "deviceDiscount", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),

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

@@ -106,10 +106,19 @@ export interface SaleEntitlement {
     amountCents: number | null;
     quantity: number | null;
 }
+/** Promo que tomó una venta cerrada, con el nombre que tenía en esa versión. */
+export interface SaleAppliedPromotion {
+    promotionId: string;
+    version: number;
+    name: string;
+    kind: SalePromotionKindEnum;
+}
 /** Cupón y «lo que se lleva» de una venta cerrada (publicGetSaleCoupon). */
 export interface GetSaleCouponResponse {
     saleId: string;
     availability: SaleCouponAvailabilityEnum;
     coupon: SaleCoupon | null;
     entitlements: SaleEntitlement[];
+    /** Promos que aplicaron a la venta (regalo y venta), con su nombre en esa versión. */
+    appliedPromotions: SaleAppliedPromotion[];
 }

package/package.json

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

package/src/retailPromotions/dtos/SalePromotionLevers.ts

@@ -2,12 +2,20 @@ import { AccessorySubcategoryEnum } from '../../retailCatalog/enums/AccessorySub
 import { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
 import { CouponScopeEnum } from '../enums/CouponScopeEnum';
+import { DiscountTypeEnum } from '../enums/DiscountTypeEnum';
 import { GiftModeEnum } from '../enums/GiftModeEnum';
 import { DiscountValue } from './DiscountValue';
 
-/** Descuento en accesorios: % sobre los accesorios de la venta, con tope opcional en centavos. */
+/** Descuento del equipo en % o $, con tope opcional en centavos. */
+export interface DeviceDiscountLever extends DiscountValue {
+    maxAmountCents?: number | null;
+}
+
+/** Descuento en accesorios en % o $, con tope opcional en centavos; sin `type` es `PERCENTAGE`. */
 export interface AccessoryDiscountLever {
-    percentBps: number;
+    type?: DiscountTypeEnum | null;
+    amountCents?: number | null;
+    percentBps: number | null;
     maxAmountCents: number | null;
 }
 
@@ -44,7 +52,7 @@ export interface WalletBonusLever {
 
 /** Las 7 palancas; una palanca ausente o `null` no se usa. */
 export interface SalePromotionLevers {
-    deviceDiscount: DiscountValue | null;
+    deviceDiscount: DeviceDiscountLever | null;
     accessoryDiscount: AccessoryDiscountLever | null;
     gift: GiftLever | null;
     coupon: CouponLever | null;

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

@@ -5,23 +5,68 @@ import {
     IsEnum,
     IsInt,
     IsOptional,
+    Max,
+    Min,
     IsString,
     ValidateIf,
     ValidateNested,
 } from 'class-validator';
 import { AccessorySubcategoryEnum } from '../../../retailCatalog/enums/AccessorySubcategoryEnum';
 import { CouponScopeEnum } from '../../enums/CouponScopeEnum';
+import { DiscountTypeEnum } from '../../enums/DiscountTypeEnum';
 import { GiftModeEnum } from '../../enums/GiftModeEnum';
 import { DiscountValueInput } from './DiscountValueInput';
 
+/** Descuento del equipo: % (`percentBps` 1..10000) o $ (`amountCents` > 0), con tope opcional en centavos. */
+export class DeviceDiscountLeverInput {
+    @Expose()
+    @IsEnum(DiscountTypeEnum)
+    type!: DiscountTypeEnum;
+
+    @Expose()
+    @ValidateIf((o: DeviceDiscountLeverInput) => o.type === DiscountTypeEnum.AMOUNT)
+    @IsInt()
+    @Min(1)
+    amountCents?: number | null;
+
+    @Expose()
+    @ValidateIf((o: DeviceDiscountLeverInput) => o.type === DiscountTypeEnum.PERCENTAGE)
+    @IsInt()
+    @Min(1)
+    @Max(10000)
+    percentBps?: number | null;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    maxAmountCents?: number | null;
+}
+
+/** Descuento en accesorios: igual que el del equipo, pero sin `type` se asume `PERCENTAGE`. */
 export class AccessoryDiscountLeverInput {
     @Expose()
+    @IsOptional()
+    @IsEnum(DiscountTypeEnum)
+    type?: DiscountTypeEnum | null;
+
+    @Expose()
+    @ValidateIf((o: AccessoryDiscountLeverInput) => o.type === DiscountTypeEnum.AMOUNT)
+    @IsInt()
+    @Min(1)
+    amountCents?: number | null;
+
+    @Expose()
+    @ValidateIf((o: AccessoryDiscountLeverInput) => o.type !== DiscountTypeEnum.AMOUNT)
     @IsInt()
-    percentBps!: number;
+    @Min(1)
+    @Max(10000)
+    percentBps?: number | null;
 
     @Expose()
     @IsOptional()
     @IsInt()
+    @Min(1)
     maxAmountCents?: number | null;
 }
 
@@ -94,8 +139,8 @@ export class SalePromotionLeversInput {
     @Expose()
     @IsOptional()
     @ValidateNested()
-    @Type(() => DiscountValueInput)
-    deviceDiscount?: DiscountValueInput | null;
+    @Type(() => DeviceDiscountLeverInput)
+    deviceDiscount?: DeviceDiscountLeverInput | null;
 
     @Expose()
     @IsOptional()

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

@@ -120,10 +120,20 @@ export interface SaleEntitlement {
     quantity: number | null;
 }
 
+/** Promo que tomó una venta cerrada, con el nombre que tenía en esa versión. */
+export interface SaleAppliedPromotion {
+    promotionId: string;
+    version: number;
+    name: string;
+    kind: SalePromotionKindEnum;
+}
+
 /** Cupón y «lo que se lleva» de una venta cerrada (publicGetSaleCoupon). */
 export interface GetSaleCouponResponse {
     saleId: string;
     availability: SaleCouponAvailabilityEnum;
     coupon: SaleCoupon | null;
     entitlements: SaleEntitlement[];
+    /** Promos que aplicaron a la venta (regalo y venta), con su nombre en esa versión. */
+    appliedPromotions: SaleAppliedPromotion[];
 }