@fiado/type-kit 3.605.0 → 3.606.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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.605.0",
+  "version": "3.606.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',