@fiado/type-kit 3.605.0 → 3.607.0

package/_test_/unit/retailIntegration/eventPayloadBounds.test.ts

@@ -42,7 +42,7 @@ const price = { basePrice: '4299.00', listPrice: null, effectiveFrom: '2026-08-1
 const product = {
     sku: 'SAM-A17-128-NEG', externalId: '9001', brand: 'Samsung', model: 'A17', color: 'Negro', capacity: '128 GB', description: null,
     category: 'PHONE', trackingMode: 'IMEI', tier: null, currencyId: 'MXN', price,
-    eligibleFinanciers: [], mdmProvider: null, status: 'ACTIVE',
+    eligibleFinanciers: ['SUREKEEP'], mdmProvider: null, status: 'ACTIVE',
 };
 const piece = { sku: 'SAM-A17-128-NEG', identifier: '356938035643809', storeId: '12', status: 'SOLD', reason: null };
 const movement = { movementType: 'SALE', storeId: '12', targetStoreId: null, pieces: [piece], stock: [] };
@@ -105,7 +105,7 @@ describe('ProductEventPayload: topes', () => {
         const atMax = {
             ...product, externalId: text(ID), brand: text(SHORT), model: text(SHORT), color: text(SHORT), capacity: text(SHORT), description: text(LONG),
             price: { ...price, basePrice: '999999999999.99', listPrice: '999999999999.99' },
-            eligibleFinanciers: Array.from({ length: RETAIL_ELIGIBLE_FINANCIERS_MAX }, () => 'SUREKEEP'),
+            eligibleFinanciers: ['SUREKEEP', 'PAYJOY', 'CREDIYA', 'LESPAGO', 'INNOVA'],
         };
         expect(await errorsOf(ProductEventPayload, atMax)).toEqual([]);
     });

package/_test_/unit/retailIntegration/eventPayloads.test.ts

@@ -6,6 +6,8 @@ import { RetailUserEventPayload } from '../../../src/retailIntegration/dtos/Reta
 import { ProductEventPayload } from '../../../src/retailIntegration/dtos/ProductEventPayload';
 import { InventoryEventPayload } from '../../../src/retailIntegration/dtos/InventoryEventPayload';
 import { RETAIL_EVENT_PIECES_MAX } from '../../../src/retailIntegration/constants/retailIntegrationLimits';
+import { RetailProductTierEnum } from '../../../src/retailIntegration/enums';
+import { ProductTierEnum } from '../../../src/retailCatalog/enums/ProductTierEnum';
 
 function paths(errors: ValidationError[], prefix = ''): string[] {
     return errors.flatMap((e) => {
@@ -78,7 +80,7 @@ const product = {
     sku: 'SAM-A17-128-NEG', externalId: '9001', brand: 'Samsung', model: 'A17', color: 'Negro', capacity: '128 GB', description: null,
     category: 'PHONE', trackingMode: 'IMEI', tier: null, currencyId: 'MXN',
     price: { basePrice: '4299.00', listPrice: null, effectiveFrom: '2026-08-17T20:32:05Z' },
-    eligibleFinanciers: [], mdmProvider: null, status: 'ACTIVE',
+    eligibleFinanciers: ['SUREKEEP'], mdmProvider: null, status: 'ACTIVE',
 };
 
 const piece = { sku: 'SAM-A17-128-NEG', identifier: '356938035643809', storeId: '12', status: 'SOLD', reason: null };
@@ -93,6 +95,41 @@ describe('ProductEventPayload', () => {
         expect(await errorsOf(ProductEventPayload, { ...product, mdmProvider })).toEqual([]);
     });
 
+    it.each([
+        ['ausente', undefined],
+        ['null', null],
+        ['de la gama', 'PREMIUM'],
+    ])('acepta tier %s', async (_case, tier) => {
+        expect(await errorsOf(ProductEventPayload, { ...product, tier })).toEqual([]);
+    });
+
+    it.each([
+        ['ausente', undefined],
+        ['null', null],
+        ['con financieras', ['SUREKEEP', 'PAYJOY']],
+    ])('acepta eligibleFinanciers %s', async (_case, eligibleFinanciers) => {
+        expect(await errorsOf(ProductEventPayload, { ...product, eligibleFinanciers })).toEqual([]);
+    });
+
+    it('al transformar, tier ausente queda null y eligibleFinanciers ausente o null queda con todas', () => {
+        const { tier: _tier, eligibleFinanciers: _financiers, ...withoutKeys } = product;
+        const all = ['SUREKEEP', 'PAYJOY', 'CREDIYA', 'LESPAGO', 'INNOVA'];
+        const fromAbsent = plainToInstance(ProductEventPayload, withoutKeys);
+        expect(fromAbsent.tier).toBeNull();
+        expect(fromAbsent.eligibleFinanciers).toEqual(all);
+        expect(plainToInstance(ProductEventPayload, { ...product, eligibleFinanciers: null }).eligibleFinanciers).toEqual(all);
+    });
+
+    it('al transformar, conserva tier y eligibleFinanciers cuando vienen', () => {
+        const dto = plainToInstance(ProductEventPayload, { ...product, tier: 'MID', eligibleFinanciers: ['PAYJOY'] });
+        expect(dto.tier).toBe('MID');
+        expect(dto.eligibleFinanciers).toEqual(['PAYJOY']);
+    });
+
+    it('la gama de la integración trae los mismos valores que la de catálogo', () => {
+        expect(Object.values(RetailProductTierEnum)).toEqual(Object.values(ProductTierEnum));
+    });
+
     it('rechaza un mdmProvider fuera del enum', async () => {
         expect(await errorsOf(ProductEventPayload, { ...product, mdmProvider: 'KNOX' })).toContain('mdmProvider');
     });
@@ -102,7 +139,11 @@ describe('ProductEventPayload', () => {
         ['price.basePrice', { price: { ...product.price, basePrice: '4299' } }],
         ['price.effectiveFrom', { price: { ...product.price, effectiveFrom: '2026-08-17T20:32:05' } }],
         ['eligibleFinanciers', { eligibleFinanciers: ['NADIE'] }],
-        ['tier', { tier: undefined }],
+        ['eligibleFinanciers', { eligibleFinanciers: [] }],
+        ['eligibleFinanciers', { eligibleFinanciers: ['SUREKEEP', 'SUREKEEP'] }],
+        ['eligibleFinanciers', { eligibleFinanciers: 'SUREKEEP' }],
+        ['tier', { tier: 'ULTRA' }],
+        ['tier', { tier: 'low' }],
         ['price.listPrice', { price: { basePrice: '4299.00', effectiveFrom: '2026-08-17T20:32:05Z' } }],
     ])('rechaza %s', async (path, over) => {
         expect(await errorsOf(ProductEventPayload, { ...product, ...over })).toContain(path);

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

@@ -45,6 +45,13 @@ describe('CreateDiscountCodeRequest', () => {
     });
     expect(paths).toEqual(expect.arrayContaining(['discount.percentBps', 'maxUses', 'appliesTo']));
   });
+
+  it('acepta paymentOptions como lista del catálogo o null, y rechaza otra cosa', async () => {
+    expect(await errorPaths(CreateDiscountCodeRequest, { ...base, paymentOptions: ['CASH', 'CARD'] })).toHaveLength(0);
+    expect(await errorPaths(CreateDiscountCodeRequest, { ...base, paymentOptions: null })).toHaveLength(0);
+    expect(await errorPaths(CreateDiscountCodeRequest, { ...base, paymentOptions: ['BITCOIN'] })).toEqual(['paymentOptions']);
+    expect(await errorPaths(CreateDiscountCodeRequest, { ...base, paymentOptions: 'CASH' })).toEqual(['paymentOptions']);
+  });
 });
 
 describe('ChangeDiscountCodeStatusRequest', () => {

package/bin/retailIntegration/dtos/ProductEventPayload.d.ts

@@ -16,9 +16,11 @@ export declare class ProductEventPayload implements RetailSystemProduct {
     description: string | null;
     category: RetailProductCategory;
     trackingMode: RetailTrackingMode;
+    /** Opcional en el evento: ausente se vuelve `null`. */
     tier: RetailProductTier | null;
     currencyId: RetailCurrency;
     price: ProductEventPricePayload;
+    /** Opcional en el evento: ausente o `null` se vuelve la lista de todas las financieras. */
     eligibleFinanciers: RetailFinancier[];
     mdmProvider: RetailMdmProvider | null;
     status: RetailProductStatus;

package/bin/retailIntegration/dtos/ProductEventPayload.js

@@ -89,7 +89,9 @@ __decorate([
     __metadata("design:type", String)
 ], ProductEventPayload.prototype, "trackingMode", void 0);
 __decorate([
-    (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ?? null),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsIn)(Object.values(enums_1.RetailProductTierEnum)),
     __metadata("design:type", String)
 ], ProductEventPayload.prototype, "tier", void 0);
@@ -105,7 +107,12 @@ __decorate([
     __metadata("design:type", ProductEventPricePayload)
 ], ProductEventPayload.prototype, "price", void 0);
 __decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ?? Object.values(enums_1.RetailFinancierEnum)),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.ArrayUnique)(),
     (0, class_validator_1.ArrayMaxSize)(retailIntegrationLimits_1.RETAIL_ELIGIBLE_FINANCIERS_MAX),
     (0, class_validator_1.IsIn)(Object.values(enums_1.RetailFinancierEnum), { each: true }),
     __metadata("design:type", Array)

package/bin/retailIntegration/enums/RetailProductTierEnum.d.ts

@@ -1,4 +1,4 @@
-/** Gama de un producto. */
+/** Gama de un producto; mismos valores que `ProductTierEnum` de retailCatalog. */
 export declare enum RetailProductTierEnum {
     LOW = "LOW",
     MID = "MID",

package/bin/retailIntegration/enums/RetailProductTierEnum.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RetailProductTierEnum = void 0;
-/** Gama de un producto. */
+/** Gama de un producto; mismos valores que `ProductTierEnum` de retailCatalog. */
 var RetailProductTierEnum;
 (function (RetailProductTierEnum) {
     RetailProductTierEnum["LOW"] = "LOW";

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

@@ -3,6 +3,7 @@ import { CouponStatusEnum } from '../enums/CouponStatusEnum';
 import { DiscountCodeOriginEnum } from '../enums/DiscountCodeOriginEnum';
 import { DiscountCodeStatusEnum } from '../enums/DiscountCodeStatusEnum';
 import { PromotionAppliesToEnum } from '../enums/PromotionAppliesToEnum';
+import { PromotionPaymentOptionEnum } from '../enums/PromotionPaymentOptionEnum';
 import { DiscountValue } from './DiscountValue';
 /**
  * Código de descuento de Admin VL o cupón emitido por una venta (según `origin`).
@@ -22,7 +23,10 @@ export interface DiscountCode {
     skus: string[] | null;
     storeIds: string[] | null;
     announceInStore: boolean;
+    /** @deprecated Usa `paymentOptions`. */
     appliesTo: PromotionAppliesToEnum;
+    /** Formas de pago con las que se canjea; `null` = cualquiera. El cupón hereda las de su promo. */
+    paymentOptions: PromotionPaymentOptionEnum[] | null;
     ownerCustomerId: string | null;
     issuedBySaleId: string | null;
     issuingStoreId: string | null;

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

@@ -1,4 +1,5 @@
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
+import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
 import { DiscountValueInput } from './DiscountValueInput';
 /** Body de publicCreateDiscountCode. Que el texto sea único entre los vigentes es `CODE_TEXT_TAKEN`. */
 export declare class CreateDiscountCodeRequest {
@@ -12,6 +13,8 @@ export declare class CreateDiscountCodeRequest {
     skus?: string[] | null;
     storeIds?: string[] | null;
     announceInStore?: boolean;
-    /** Ausente = `SUREKEEP_ONLY`. */
+    /** @deprecated Usa `paymentOptions`; solo se lee si `paymentOptions` no viene. Ausente = `SUREKEEP_ONLY`. */
     appliesTo?: PromotionAppliesToEnum;
+    /** Formas de pago con las que se canjea; `null` = cualquiera. Ausente = la que diga `appliesTo`. */
+    paymentOptions?: PromotionPaymentOptionEnum[] | null;
 }

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

@@ -13,6 +13,7 @@ exports.CreateDiscountCodeRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const PromotionAppliesToEnum_1 = require("../../enums/PromotionAppliesToEnum");
+const PromotionPaymentOptionEnum_1 = require("../../enums/PromotionPaymentOptionEnum");
 const DiscountValueInput_1 = require("./DiscountValueInput");
 /** Body de publicCreateDiscountCode. Que el texto sea único entre los vigentes es `CODE_TEXT_TAKEN`. */
 class CreateDiscountCodeRequest {
@@ -76,3 +77,10 @@ __decorate([
     (0, class_validator_1.IsEnum)(PromotionAppliesToEnum_1.PromotionAppliesToEnum),
     __metadata("design:type", String)
 ], CreateDiscountCodeRequest.prototype, "appliesTo", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsEnum)(PromotionPaymentOptionEnum_1.PromotionPaymentOptionEnum, { each: true }),
+    __metadata("design:type", Array)
+], CreateDiscountCodeRequest.prototype, "paymentOptions", void 0);

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

@@ -13,4 +13,6 @@ export interface PromotionPaymentNotEligibleDetails {
     promotionName: string;
     /** `PromotionPaymentOptionEnum` que acepta esa promo. */
     acceptedOptions: string;
+    /** Código apartado que no admite el medio; si solo falla el código, promotionName es su texto. */
+    discountCode?: string;
 }

package/package.json

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

package/src/retailIntegration/dtos/ProductEventPayload.ts

@@ -1,5 +1,5 @@
-import { Type } from 'class-transformer';
-import { ArrayMaxSize, IsArray, IsDefined, IsIn, IsObject, IsString, Matches, MaxLength, Validate, ValidateIf, ValidateNested } from 'class-validator';
+import { Expose, Transform, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsDefined, IsIn, IsObject, IsOptional, IsString, Matches, MaxLength, Validate, ValidateIf, ValidateNested } from 'class-validator';
 import {
     RETAIL_ELIGIBLE_FINANCIERS_MAX,
     RETAIL_EVENT_DECIMAL_PATTERN,
@@ -49,10 +49,15 @@ export class ProductEventPayload implements RetailSystemProduct {
     @ValidateIf(isNullOrValidated) @IsString() @MaxLength(RETAIL_LONG_TEXT_MAX_LENGTH) description!: string | null;
     @IsIn(Object.values(RetailProductCategoryEnum)) category!: RetailProductCategory;
     @IsIn(Object.values(RetailTrackingModeEnum)) trackingMode!: RetailTrackingMode;
-    @ValidateIf(isNullOrValidated) @IsIn(Object.values(RetailProductTierEnum)) tier!: RetailProductTier | null;
+    /** Opcional en el evento: ausente se vuelve `null`. */
+    @Expose() @Transform(({ value }) => value ?? null)
+    @IsOptional() @IsIn(Object.values(RetailProductTierEnum)) tier!: RetailProductTier | null;
     @IsIn(Object.values(RetailCurrencyEnum)) currencyId!: RetailCurrency;
     @IsDefined() @IsObject() @ValidateNested() @Type(() => ProductEventPricePayload) price!: ProductEventPricePayload;
-    @IsArray() @ArrayMaxSize(RETAIL_ELIGIBLE_FINANCIERS_MAX) @IsIn(Object.values(RetailFinancierEnum), { each: true }) eligibleFinanciers!: RetailFinancier[];
+    /** Opcional en el evento: ausente o `null` se vuelve la lista de todas las financieras. */
+    @Expose() @Transform(({ value }) => value ?? Object.values(RetailFinancierEnum))
+    @IsOptional() @IsArray() @ArrayNotEmpty() @ArrayUnique() @ArrayMaxSize(RETAIL_ELIGIBLE_FINANCIERS_MAX) @IsIn(Object.values(RetailFinancierEnum), { each: true })
+    eligibleFinanciers!: RetailFinancier[];
     @ValidateIf(isNullOrValidated) @IsIn(Object.values(RetailMdmProviderEnum)) mdmProvider!: RetailMdmProvider | null;
     @IsIn(Object.values(RetailProductStatusEnum)) status!: RetailProductStatus;
 }

package/src/retailIntegration/enums/RetailProductTierEnum.ts

@@ -1,4 +1,4 @@
-/** Gama de un producto. */
+/** Gama de un producto; mismos valores que `ProductTierEnum` de retailCatalog. */
 export enum RetailProductTierEnum {
     LOW = 'LOW',
     MID = 'MID',

package/src/retailPromotions/dtos/DiscountCode.ts

@@ -3,6 +3,7 @@ import { CouponStatusEnum } from '../enums/CouponStatusEnum';
 import { DiscountCodeOriginEnum } from '../enums/DiscountCodeOriginEnum';
 import { DiscountCodeStatusEnum } from '../enums/DiscountCodeStatusEnum';
 import { PromotionAppliesToEnum } from '../enums/PromotionAppliesToEnum';
+import { PromotionPaymentOptionEnum } from '../enums/PromotionPaymentOptionEnum';
 import { DiscountValue } from './DiscountValue';
 
 /**
@@ -23,7 +24,10 @@ export interface DiscountCode {
     skus: string[] | null;
     storeIds: string[] | null;
     announceInStore: boolean;
+    /** @deprecated Usa `paymentOptions`. */
     appliesTo: PromotionAppliesToEnum;
+    /** Formas de pago con las que se canjea; `null` = cualquiera. El cupón hereda las de su promo. */
+    paymentOptions: PromotionPaymentOptionEnum[] | null;
     ownerCustomerId: string | null;
     issuedBySaleId: string | null;
     issuingStoreId: string | null;

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

@@ -13,6 +13,7 @@ import {
     ValidateNested,
 } from 'class-validator';
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
+import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
 import { DiscountValueInput } from './DiscountValueInput';
 
 /** Body de publicCreateDiscountCode. Que el texto sea único entre los vigentes es `CODE_TEXT_TAKEN`. */
@@ -63,9 +64,16 @@ export class CreateDiscountCodeRequest {
     @IsBoolean()
     announceInStore?: boolean;
 
-    /** Ausente = `SUREKEEP_ONLY`. */
+    /** @deprecated Usa `paymentOptions`; solo se lee si `paymentOptions` no viene. Ausente = `SUREKEEP_ONLY`. */
     @Expose()
     @IsOptional()
     @IsEnum(PromotionAppliesToEnum)
     appliesTo?: PromotionAppliesToEnum;
+
+    /** Formas de pago con las que se canjea; `null` = cualquiera. Ausente = la que diga `appliesTo`. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(PromotionPaymentOptionEnum, { each: true })
+    paymentOptions?: PromotionPaymentOptionEnum[] | null;
 }

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

@@ -14,4 +14,6 @@ export interface PromotionPaymentNotEligibleDetails {
     promotionName: string;
     /** `PromotionPaymentOptionEnum` que acepta esa promo. */
     acceptedOptions: string;
+    /** Código apartado que no admite el medio; si solo falla el código, promotionName es su texto. */
+    discountCode?: string;
 }