@fiado/type-kit 3.583.0 → 3.584.0

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

@@ -0,0 +1,147 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate, ValidationError } from 'class-validator';
+import { StoreEventPayload } from '../../../src/retailIntegration/dtos/StoreEventPayload';
+import { RetailUserEventPayload } from '../../../src/retailIntegration/dtos/RetailUserEventPayload';
+import { ProductEventPayload } from '../../../src/retailIntegration/dtos/ProductEventPayload';
+import { InventoryEventPayload } from '../../../src/retailIntegration/dtos/InventoryEventPayload';
+import {
+    RETAIL_ELIGIBLE_FINANCIERS_MAX,
+    RETAIL_EVENT_STOCK_MAX,
+    RETAIL_ID_TEXT_MAX_LENGTH,
+    RETAIL_LONG_TEXT_MAX_LENGTH,
+    RETAIL_SHORT_TEXT_MAX_LENGTH,
+} from '../../../src/retailIntegration/constants/retailIntegrationLimits';
+
+function paths(errors: ValidationError[], prefix = ''): string[] {
+    return errors.flatMap((e) => {
+        const p = prefix ? `${prefix}.${e.property}` : e.property;
+        return e.children && e.children.length > 0 ? paths(e.children, p) : [p];
+    });
+}
+
+async function errorsOf(cls: new () => object, plain: Record<string, unknown>): Promise<string[]> {
+    return paths(await validate(plainToInstance(cls, plain)));
+}
+
+const text = (n: number): string => 'a'.repeat(n);
+const SHORT = RETAIL_SHORT_TEXT_MAX_LENGTH;
+const LONG = RETAIL_LONG_TEXT_MAX_LENGTH;
+const ID = RETAIL_ID_TEXT_MAX_LENGTH;
+
+const address = { address1: 'Av. Juárez', externalNumber: '120', internalNumber: null, neighborhood: 'Centro', city: 'Toluca', state: 'Estado de México', zipCode: '50000', country: 'MX', reference: null };
+const store = {
+    storeId: '12', code: 'T12', name: 'Sucursal Centro', zoneId: 'SUR', address,
+    location: { lat: 19.2826, lng: -99.6557 }, phone: '7221234567', schedule: 'Lun a Dom 10:00 a 20:00', status: 'ACTIVE',
+};
+const user = {
+    retailUserId: '431', displayName: 'Grecia Cruz Mendoza', email: 'gcruz@ejemplo.mx', phone: null,
+    homeStoreId: '12', zoneId: null, role: 'SELLER', status: 'ACTIVE',
+};
+const price = { basePrice: '4299.00', listPrice: null, effectiveFrom: '2026-08-17T20:32:05Z' };
+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',
+};
+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: [] };
+
+describe('StoreEventPayload: topes', () => {
+    it('acepta textos justo en su tope', async () => {
+        const atMax = {
+            ...store, name: text(SHORT), phone: text(SHORT), schedule: text(SHORT),
+            address: { ...address, address1: text(SHORT), externalNumber: text(SHORT), internalNumber: text(SHORT), neighborhood: text(SHORT), city: text(SHORT), state: text(SHORT), country: text(SHORT), reference: text(LONG) },
+        };
+        expect(await errorsOf(StoreEventPayload, atMax)).toEqual([]);
+    });
+
+    it.each([
+        ['name', { name: text(SHORT + 1) }],
+        ['phone', { phone: text(SHORT + 1) }],
+        ['schedule', { schedule: text(SHORT + 1) }],
+        ['address.address1', { address: { ...address, address1: text(SHORT + 1) } }],
+        ['address.externalNumber', { address: { ...address, externalNumber: text(SHORT + 1) } }],
+        ['address.internalNumber', { address: { ...address, internalNumber: text(SHORT + 1) } }],
+        ['address.neighborhood', { address: { ...address, neighborhood: text(SHORT + 1) } }],
+        ['address.city', { address: { ...address, city: text(SHORT + 1) } }],
+        ['address.state', { address: { ...address, state: text(SHORT + 1) } }],
+        ['address.country', { address: { ...address, country: text(SHORT + 1) } }],
+        ['address.reference', { address: { ...address, reference: text(LONG + 1) } }],
+    ])('rechaza %s sobre su tope', async (path, over) => {
+        expect(await errorsOf(StoreEventPayload, { ...store, ...over })).toContain(path);
+    });
+
+    it.each([
+        ['address', 'Av. Juárez 120'],
+        ['address', [address]],
+        ['location', 'lat,lng'],
+        ['location', [19.2, -99.6]],
+    ])('rechaza %s que no es objeto', async (path, value) => {
+        const errors = await validate(plainToInstance(StoreEventPayload, { ...store, [path]: value }));
+        expect(errors.find((e) => e.property === path)?.constraints).toHaveProperty('isObject');
+    });
+});
+
+describe('RetailUserEventPayload: topes', () => {
+    it('acepta textos justo en su tope', async () => {
+        // IsEmail ya topa en 254, uno abajo de RETAIL_SHORT_TEXT_MAX_LENGTH.
+        const email = `${text(64)}@${'b'.repeat(63)}.${'c'.repeat(63)}.${'d'.repeat(58)}.mx`;
+        expect(email).toHaveLength(SHORT - 1);
+        expect(await errorsOf(RetailUserEventPayload, { ...user, displayName: text(SHORT), phone: text(SHORT), email })).toEqual([]);
+    });
+
+    it.each([
+        ['displayName', { displayName: text(SHORT + 1) }],
+        ['phone', { phone: text(SHORT + 1) }],
+        ['email', { email: `${text(SHORT)}@ejemplo.mx` }],
+    ])('rechaza %s sobre su tope', async (path, over) => {
+        expect(await errorsOf(RetailUserEventPayload, { ...user, ...over })).toContain(path);
+    });
+});
+
+describe('ProductEventPayload: topes', () => {
+    it('acepta textos, financieras y montos justo en su tope', async () => {
+        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'),
+        };
+        expect(await errorsOf(ProductEventPayload, atMax)).toEqual([]);
+    });
+
+    it.each([
+        ['externalId', { externalId: text(ID + 1) }],
+        ['brand', { brand: text(SHORT + 1) }],
+        ['model', { model: text(SHORT + 1) }],
+        ['color', { color: text(SHORT + 1) }],
+        ['capacity', { capacity: text(SHORT + 1) }],
+        ['description', { description: text(LONG + 1) }],
+        ['price.basePrice', { price: { ...price, basePrice: '1000000000000.00' } }],
+        ['price.listPrice', { price: { ...price, listPrice: '1000000000000.00' } }],
+        ['eligibleFinanciers', { eligibleFinanciers: Array.from({ length: RETAIL_ELIGIBLE_FINANCIERS_MAX + 1 }, () => 'SUREKEEP') }],
+    ])('rechaza %s', async (path, over) => {
+        expect(await errorsOf(ProductEventPayload, { ...product, ...over })).toContain(path);
+    });
+
+    it.each([['4299.00'], [[price]]])('rechaza price que no es objeto: %j', async (value) => {
+        const errors = await validate(plainToInstance(ProductEventPayload, { ...product, price: value }));
+        expect(errors.find((e) => e.property === 'price')?.constraints).toHaveProperty('isObject');
+    });
+});
+
+describe('InventoryEventPayload: topes', () => {
+    const stockOf = (n: number) => Array.from({ length: n }, (_, i) => ({ sku: `MICA-${String(i)}`, storeId: '12', qty: 1 }));
+
+    it('acepta identifier y stock justo en su tope', async () => {
+        expect(await errorsOf(InventoryEventPayload, { ...movement, pieces: [{ ...piece, identifier: text(SHORT) }], stock: stockOf(RETAIL_EVENT_STOCK_MAX) })).toEqual([]);
+    });
+
+    it('rechaza identifier sobre su tope', async () => {
+        expect(await errorsOf(InventoryEventPayload, { ...movement, pieces: [{ ...piece, identifier: text(SHORT + 1) }] })).toContain('pieces.0.identifier');
+    });
+
+    it('rechaza stock sobre su tope', async () => {
+        expect(await errorsOf(InventoryEventPayload, { ...movement, stock: stockOf(RETAIL_EVENT_STOCK_MAX + 1) })).toContain('stock');
+    });
+});

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

@@ -5,6 +5,7 @@ import { StoreEventPayload } from '../../../src/retailIntegration/dtos/StoreEven
 import { RetailUserEventPayload } from '../../../src/retailIntegration/dtos/RetailUserEventPayload';
 import { ProductEventPayload } from '../../../src/retailIntegration/dtos/ProductEventPayload';
 import { InventoryEventPayload } from '../../../src/retailIntegration/dtos/InventoryEventPayload';
+import { RETAIL_EVENT_PIECES_MAX } from '../../../src/retailIntegration/constants/retailIntegrationLimits';
 
 function paths(errors: ValidationError[], prefix = ''): string[] {
     return errors.flatMap((e) => {
@@ -130,4 +131,11 @@ describe('InventoryEventPayload', () => {
         expect(await errorsOf(InventoryEventPayload, { ...movement, stock: [s, s] })).toContain('stock');
         expect(await errorsOf(InventoryEventPayload, { ...movement, stock: [{ ...s, qty: -1 }] })).toContain('stock.0.qty');
     });
+
+    it('acepta hasta RETAIL_EVENT_PIECES_MAX piezas y rechaza una más', async () => {
+        const piecesOf = (n: number) => Array.from({ length: n }, (_, i) => ({ ...piece, identifier: `35693803564${String(i).padStart(4, '0')}` }));
+        expect(RETAIL_EVENT_PIECES_MAX).toBe(30);
+        expect(await errorsOf(InventoryEventPayload, { ...movement, pieces: piecesOf(RETAIL_EVENT_PIECES_MAX) })).toEqual([]);
+        expect(await errorsOf(InventoryEventPayload, { ...movement, pieces: piecesOf(RETAIL_EVENT_PIECES_MAX + 1) })).toContain('pieces');
+    });
 });

package/bin/retailIntegration/constants/retailIntegrationLimits.d.ts

@@ -20,3 +20,17 @@ export declare const RETAIL_SKU_PATTERN: RegExp;
 export declare const RETAIL_DECIMAL_PATTERN: RegExp;
 /** Tope de identificadores por consulta de inventario en vivo. */
 export declare const RETAIL_LIVE_CHECK_IDENTIFIERS_MAX = 50;
+/** Tope de piezas por evento `InventoryMovementV1`; más se rechaza con INVALID_PAYLOAD. */
+export declare const RETAIL_EVENT_PIECES_MAX = 30;
+/** Tope de ids y códigos libres del retailer, como `externalId`. */
+export declare const RETAIL_ID_TEXT_MAX_LENGTH = 64;
+/** Tope de textos cortos de los payloads: nombres, dirección, teléfono, marca, modelo, `identifier`. */
+export declare const RETAIL_SHORT_TEXT_MAX_LENGTH = 255;
+/** Tope de textos largos de los payloads: descripción y referencia. */
+export declare const RETAIL_LONG_TEXT_MAX_LENGTH = 1000;
+/** Tope de existencias por evento `InventoryMovementV1`. */
+export declare const RETAIL_EVENT_STOCK_MAX = 200;
+/** Tope de financieras elegibles por producto. */
+export declare const RETAIL_ELIGIBLE_FINANCIERS_MAX = 50;
+/** Decimal de los eventos del retailer: hasta 12 enteros y dos decimales, nunca negativo. */
+export declare const RETAIL_EVENT_DECIMAL_PATTERN: RegExp;

package/bin/retailIntegration/constants/retailIntegrationLimits.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RETAIL_LIVE_CHECK_IDENTIFIERS_MAX = exports.RETAIL_DECIMAL_PATTERN = exports.RETAIL_SKU_PATTERN = exports.RETAIL_ZIP_CODE_MAX_LENGTH = exports.RETAIL_ZIP_CODE_MIN_LENGTH = exports.RETAIL_STORE_CODE_MAX_LENGTH = exports.RETAIL_ZONE_ID_PATTERN = exports.RETAIL_ENTITY_ID_PATTERN = exports.RETAIL_TENANT_ID_PATTERN = exports.RETAIL_LIST_LIMIT_MAX = exports.RETAIL_LIST_LIMIT_MIN = exports.RETAIL_EVENT_ID_MAX_LENGTH = void 0;
+exports.RETAIL_EVENT_DECIMAL_PATTERN = exports.RETAIL_ELIGIBLE_FINANCIERS_MAX = exports.RETAIL_EVENT_STOCK_MAX = exports.RETAIL_LONG_TEXT_MAX_LENGTH = exports.RETAIL_SHORT_TEXT_MAX_LENGTH = exports.RETAIL_ID_TEXT_MAX_LENGTH = exports.RETAIL_EVENT_PIECES_MAX = exports.RETAIL_LIVE_CHECK_IDENTIFIERS_MAX = exports.RETAIL_DECIMAL_PATTERN = exports.RETAIL_SKU_PATTERN = exports.RETAIL_ZIP_CODE_MAX_LENGTH = exports.RETAIL_ZIP_CODE_MIN_LENGTH = exports.RETAIL_STORE_CODE_MAX_LENGTH = exports.RETAIL_ZONE_ID_PATTERN = exports.RETAIL_ENTITY_ID_PATTERN = exports.RETAIL_TENANT_ID_PATTERN = exports.RETAIL_LIST_LIMIT_MAX = exports.RETAIL_LIST_LIMIT_MIN = exports.RETAIL_EVENT_ID_MAX_LENGTH = void 0;
 /** Tope de `eventId`: el límite seguro de una llave de DynamoDB. */
 exports.RETAIL_EVENT_ID_MAX_LENGTH = 1024;
 /** Rango de `limit` en las listas paginadas del retailer. */
@@ -23,3 +23,17 @@ exports.RETAIL_SKU_PATTERN = /^(?=.{1,64}$)[A-Za-z0-9-]+(?: +[A-Za-z0-9-]+)*$/;
 exports.RETAIL_DECIMAL_PATTERN = /^\d+\.\d{2}$/;
 /** Tope de identificadores por consulta de inventario en vivo. */
 exports.RETAIL_LIVE_CHECK_IDENTIFIERS_MAX = 50;
+/** Tope de piezas por evento `InventoryMovementV1`; más se rechaza con INVALID_PAYLOAD. */
+exports.RETAIL_EVENT_PIECES_MAX = 30;
+/** Tope de ids y códigos libres del retailer, como `externalId`. */
+exports.RETAIL_ID_TEXT_MAX_LENGTH = 64;
+/** Tope de textos cortos de los payloads: nombres, dirección, teléfono, marca, modelo, `identifier`. */
+exports.RETAIL_SHORT_TEXT_MAX_LENGTH = 255;
+/** Tope de textos largos de los payloads: descripción y referencia. */
+exports.RETAIL_LONG_TEXT_MAX_LENGTH = 1000;
+/** Tope de existencias por evento `InventoryMovementV1`. */
+exports.RETAIL_EVENT_STOCK_MAX = 200;
+/** Tope de financieras elegibles por producto. */
+exports.RETAIL_ELIGIBLE_FINANCIERS_MAX = 50;
+/** Decimal de los eventos del retailer: hasta 12 enteros y dos decimales, nunca negativo. */
+exports.RETAIL_EVENT_DECIMAL_PATTERN = /^\d{1,12}\.\d{2}$/;

package/bin/retailIntegration/dtos/InventoryEventPayload.js

@@ -27,6 +27,7 @@ __decorate([
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], PieceEventPayload.prototype, "identifier", void 0);
 __decorate([
@@ -80,6 +81,7 @@ __decorate([
 ], InventoryEventPayload.prototype, "targetStoreId", void 0);
 __decorate([
     (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(retailIntegrationLimits_1.RETAIL_EVENT_PIECES_MAX),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => PieceEventPayload),
     (0, class_validator_1.Validate)(payloadValidators_1.HasUniqueKeys, ['identifier']),
@@ -87,6 +89,7 @@ __decorate([
 ], InventoryEventPayload.prototype, "pieces", void 0);
 __decorate([
     (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(retailIntegrationLimits_1.RETAIL_EVENT_STOCK_MAX),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => StockEventPayload),
     (0, class_validator_1.Validate)(payloadValidators_1.HasUniqueKeys, ['storeId', 'sku']),

package/bin/retailIntegration/dtos/ProductEventPayload.js

@@ -22,13 +22,13 @@ class ProductEventPricePayload {
 exports.ProductEventPricePayload = ProductEventPricePayload;
 __decorate([
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_DECIMAL_PATTERN),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_EVENT_DECIMAL_PATTERN),
     __metadata("design:type", String)
 ], ProductEventPricePayload.prototype, "basePrice", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_DECIMAL_PATTERN),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_EVENT_DECIMAL_PATTERN),
     __metadata("design:type", String)
 ], ProductEventPricePayload.prototype, "listPrice", void 0);
 __decorate([
@@ -47,31 +47,37 @@ __decorate([
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_ID_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], ProductEventPayload.prototype, "externalId", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], ProductEventPayload.prototype, "brand", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], ProductEventPayload.prototype, "model", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], ProductEventPayload.prototype, "color", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], ProductEventPayload.prototype, "capacity", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_LONG_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], ProductEventPayload.prototype, "description", void 0);
 __decorate([
@@ -93,12 +99,14 @@ __decorate([
 ], ProductEventPayload.prototype, "currencyId", void 0);
 __decorate([
     (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsObject)(),
     (0, class_validator_1.ValidateNested)(),
     (0, class_transformer_1.Type)(() => ProductEventPricePayload),
     __metadata("design:type", ProductEventPricePayload)
 ], ProductEventPayload.prototype, "price", void 0);
 __decorate([
     (0, class_validator_1.IsArray)(),
+    (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)
 ], ProductEventPayload.prototype, "eligibleFinanciers", void 0);

package/bin/retailIntegration/dtos/RetailUserEventPayload.js

@@ -26,15 +26,18 @@ __decorate([
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], RetailUserEventPayload.prototype, "displayName", void 0);
 __decorate([
     (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], RetailUserEventPayload.prototype, "email", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], RetailUserEventPayload.prototype, "phone", void 0);
 __decorate([

package/bin/retailIntegration/dtos/StoreEventPayload.js

@@ -24,31 +24,37 @@ exports.StoreEventAddressPayload = StoreEventAddressPayload;
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], StoreEventAddressPayload.prototype, "address1", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], StoreEventAddressPayload.prototype, "externalNumber", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], StoreEventAddressPayload.prototype, "internalNumber", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], StoreEventAddressPayload.prototype, "neighborhood", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], StoreEventAddressPayload.prototype, "city", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], StoreEventAddressPayload.prototype, "state", void 0);
 __decorate([
@@ -59,11 +65,13 @@ __decorate([
 __decorate([
     (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], StoreEventAddressPayload.prototype, "country", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_LONG_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], StoreEventAddressPayload.prototype, "reference", void 0);
 /** Coordenada de la tienda; `null` si no se informa. */
@@ -101,6 +109,7 @@ __decorate([
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], StoreEventPayload.prototype, "name", void 0);
 __decorate([
@@ -111,12 +120,14 @@ __decorate([
 ], StoreEventPayload.prototype, "zoneId", void 0);
 __decorate([
     (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsObject)(),
     (0, class_validator_1.ValidateNested)(),
     (0, class_transformer_1.Type)(() => StoreEventAddressPayload),
     __metadata("design:type", StoreEventAddressPayload)
 ], StoreEventPayload.prototype, "address", void 0);
 __decorate([
     (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsObject)(),
     (0, class_validator_1.ValidateNested)(),
     (0, class_transformer_1.Type)(() => StoreEventLocationPayload),
     __metadata("design:type", StoreEventLocationPayload)
@@ -124,11 +135,13 @@ __decorate([
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], StoreEventPayload.prototype, "phone", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], StoreEventPayload.prototype, "schedule", void 0);
 __decorate([

package/package.json

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

package/src/retailIntegration/constants/retailIntegrationLimits.ts

@@ -29,3 +29,24 @@ export const RETAIL_DECIMAL_PATTERN = /^\d+\.\d{2}$/;
 
 /** Tope de identificadores por consulta de inventario en vivo. */
 export const RETAIL_LIVE_CHECK_IDENTIFIERS_MAX = 50;
+
+/** Tope de piezas por evento `InventoryMovementV1`; más se rechaza con INVALID_PAYLOAD. */
+export const RETAIL_EVENT_PIECES_MAX = 30;
+
+/** Tope de ids y códigos libres del retailer, como `externalId`. */
+export const RETAIL_ID_TEXT_MAX_LENGTH = 64;
+
+/** Tope de textos cortos de los payloads: nombres, dirección, teléfono, marca, modelo, `identifier`. */
+export const RETAIL_SHORT_TEXT_MAX_LENGTH = 255;
+
+/** Tope de textos largos de los payloads: descripción y referencia. */
+export const RETAIL_LONG_TEXT_MAX_LENGTH = 1000;
+
+/** Tope de existencias por evento `InventoryMovementV1`. */
+export const RETAIL_EVENT_STOCK_MAX = 200;
+
+/** Tope de financieras elegibles por producto. */
+export const RETAIL_ELIGIBLE_FINANCIERS_MAX = 50;
+
+/** Decimal de los eventos del retailer: hasta 12 enteros y dos decimales, nunca negativo. */
+export const RETAIL_EVENT_DECIMAL_PATTERN = /^\d{1,12}\.\d{2}$/;

package/src/retailIntegration/dtos/InventoryEventPayload.ts

@@ -1,6 +1,12 @@
 import { Type } from 'class-transformer';
-import { IsArray, IsIn, IsInt, IsString, Matches, Min, Validate, ValidateNested } from 'class-validator';
-import { RETAIL_ENTITY_ID_PATTERN, RETAIL_SKU_PATTERN } from '../constants/retailIntegrationLimits';
+import { ArrayMaxSize, IsArray, IsIn, IsInt, IsString, Matches, MaxLength, Min, Validate, ValidateNested } from 'class-validator';
+import {
+    RETAIL_EVENT_PIECES_MAX,
+    RETAIL_ENTITY_ID_PATTERN,
+    RETAIL_EVENT_STOCK_MAX,
+    RETAIL_SHORT_TEXT_MAX_LENGTH,
+    RETAIL_SKU_PATTERN,
+} from '../constants/retailIntegrationLimits';
 import { RetailMovementTypeEnum, RetailPieceStatusEnum } from '../enums';
 import type { RetailPieceReason, RetailPieceStatus, RetailSystemPiece, RetailSystemStock } from '../models/RetailSystemInventory';
 import { HasUniqueKeys, ReasonMatchesStatus, TargetStoreMatchesMovement } from '../validators/payloadValidators';
@@ -10,7 +16,7 @@ export type RetailMovementType = `${RetailMovementTypeEnum}`;
 /** Pieza con IMEI o serie, como quedó después del movimiento. */
 export class PieceEventPayload implements RetailSystemPiece {
     @IsString() @Matches(RETAIL_SKU_PATTERN) sku!: string;
-    @IsString() @Matches(/\S/) identifier!: string;
+    @IsString() @Matches(/\S/) @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) identifier!: string;
     @IsString() @Matches(RETAIL_ENTITY_ID_PATTERN) storeId!: string;
     @IsIn(Object.values(RetailPieceStatusEnum)) status!: RetailPieceStatus;
     @Validate(ReasonMatchesStatus) reason!: RetailPieceReason | null;
@@ -28,6 +34,6 @@ export class InventoryEventPayload {
     @IsIn(Object.values(RetailMovementTypeEnum)) movementType!: RetailMovementType;
     @IsString() @Matches(RETAIL_ENTITY_ID_PATTERN) storeId!: string;
     @Validate(TargetStoreMatchesMovement) targetStoreId!: string | null;
-    @IsArray() @ValidateNested({ each: true }) @Type(() => PieceEventPayload) @Validate(HasUniqueKeys, ['identifier']) pieces!: PieceEventPayload[];
-    @IsArray() @ValidateNested({ each: true }) @Type(() => StockEventPayload) @Validate(HasUniqueKeys, ['storeId', 'sku']) stock!: StockEventPayload[];
+    @IsArray() @ArrayMaxSize(RETAIL_EVENT_PIECES_MAX) @ValidateNested({ each: true }) @Type(() => PieceEventPayload) @Validate(HasUniqueKeys, ['identifier']) pieces!: PieceEventPayload[];
+    @IsArray() @ArrayMaxSize(RETAIL_EVENT_STOCK_MAX) @ValidateNested({ each: true }) @Type(() => StockEventPayload) @Validate(HasUniqueKeys, ['storeId', 'sku']) stock!: StockEventPayload[];
 }

package/src/retailIntegration/dtos/ProductEventPayload.ts

@@ -1,6 +1,13 @@
 import { Type } from 'class-transformer';
-import { IsArray, IsDefined, IsIn, IsString, Matches, Validate, ValidateIf, ValidateNested } from 'class-validator';
-import { RETAIL_DECIMAL_PATTERN, RETAIL_SKU_PATTERN } from '../constants/retailIntegrationLimits';
+import { ArrayMaxSize, IsArray, IsDefined, IsIn, IsObject, IsString, Matches, MaxLength, Validate, ValidateIf, ValidateNested } from 'class-validator';
+import {
+    RETAIL_ELIGIBLE_FINANCIERS_MAX,
+    RETAIL_EVENT_DECIMAL_PATTERN,
+    RETAIL_ID_TEXT_MAX_LENGTH,
+    RETAIL_LONG_TEXT_MAX_LENGTH,
+    RETAIL_SHORT_TEXT_MAX_LENGTH,
+    RETAIL_SKU_PATTERN,
+} from '../constants/retailIntegrationLimits';
 import {
     RetailCurrencyEnum,
     RetailFinancierEnum,
@@ -26,26 +33,26 @@ import { isNullOrValidated } from '../validators/payloadValidators';
 
 /** Precio del producto en decimales string. */
 export class ProductEventPricePayload implements RetailSystemProductPrice {
-    @IsString() @Matches(RETAIL_DECIMAL_PATTERN) basePrice!: string;
-    @ValidateIf(isNullOrValidated) @IsString() @Matches(RETAIL_DECIMAL_PATTERN) listPrice!: string | null;
+    @IsString() @Matches(RETAIL_EVENT_DECIMAL_PATTERN) basePrice!: string;
+    @ValidateIf(isNullOrValidated) @IsString() @Matches(RETAIL_EVENT_DECIMAL_PATTERN) listPrice!: string | null;
     @Validate(IsIsoDateTimeWithZone) effectiveFrom!: string;
 }
 
 /** Payload de los eventos de producto: el producto completo. */
 export class ProductEventPayload implements RetailSystemProduct {
     @IsString() @Matches(RETAIL_SKU_PATTERN) sku!: string;
-    @IsString() @Matches(/\S/) externalId!: string;
-    @IsString() @Matches(/\S/) brand!: string;
-    @IsString() @Matches(/\S/) model!: string;
-    @ValidateIf(isNullOrValidated) @IsString() color!: string | null;
-    @ValidateIf(isNullOrValidated) @IsString() capacity!: string | null;
-    @ValidateIf(isNullOrValidated) @IsString() description!: string | null;
+    @IsString() @Matches(/\S/) @MaxLength(RETAIL_ID_TEXT_MAX_LENGTH) externalId!: string;
+    @IsString() @Matches(/\S/) @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) brand!: string;
+    @IsString() @Matches(/\S/) @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) model!: string;
+    @ValidateIf(isNullOrValidated) @IsString() @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) color!: string | null;
+    @ValidateIf(isNullOrValidated) @IsString() @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) capacity!: string | null;
+    @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;
     @IsIn(Object.values(RetailCurrencyEnum)) currencyId!: RetailCurrency;
-    @IsDefined() @ValidateNested() @Type(() => ProductEventPricePayload) price!: ProductEventPricePayload;
-    @IsArray() @IsIn(Object.values(RetailFinancierEnum), { each: true }) eligibleFinanciers!: RetailFinancier[];
+    @IsDefined() @IsObject() @ValidateNested() @Type(() => ProductEventPricePayload) price!: ProductEventPricePayload;
+    @IsArray() @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/dtos/RetailUserEventPayload.ts

@@ -1,5 +1,5 @@
-import { IsEmail, IsIn, IsString, Matches, ValidateIf } from 'class-validator';
-import { RETAIL_ENTITY_ID_PATTERN, RETAIL_ZONE_ID_PATTERN } from '../constants/retailIntegrationLimits';
+import { IsEmail, IsIn, IsString, Matches, MaxLength, ValidateIf } from 'class-validator';
+import { RETAIL_ENTITY_ID_PATTERN, RETAIL_SHORT_TEXT_MAX_LENGTH, RETAIL_ZONE_ID_PATTERN } from '../constants/retailIntegrationLimits';
 import { RetailUserAccessStatusEnum, RetailUserRoleEnum } from '../enums';
 import type { RetailSystemUser, RetailUserAccessStatus, RetailUserRole } from '../models/RetailSystemUser';
 import { isNullOrValidated } from '../validators/payloadValidators';
@@ -7,9 +7,9 @@ import { isNullOrValidated } from '../validators/payloadValidators';
 /** Payload de los cuatro eventos de usuario: el usuario completo. */
 export class RetailUserEventPayload implements RetailSystemUser {
     @IsString() @Matches(RETAIL_ENTITY_ID_PATTERN) retailUserId!: string;
-    @IsString() @Matches(/\S/) displayName!: string;
-    @IsEmail() email!: string;
-    @ValidateIf(isNullOrValidated) @IsString() phone!: string | null;
+    @IsString() @Matches(/\S/) @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) displayName!: string;
+    @IsEmail() @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) email!: string;
+    @ValidateIf(isNullOrValidated) @IsString() @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) phone!: string | null;
     @IsString() @Matches(RETAIL_ENTITY_ID_PATTERN) homeStoreId!: string;
     @ValidateIf(isNullOrValidated) @IsString() @Matches(RETAIL_ZONE_ID_PATTERN) zoneId!: string | null;
     @IsIn(Object.values(RetailUserRoleEnum)) role!: RetailUserRole;

package/src/retailIntegration/dtos/StoreEventPayload.ts

@@ -1,7 +1,9 @@
 import { Type } from 'class-transformer';
-import { IsDefined, IsIn, IsNumber, IsString, Length, Matches, Max, Min, ValidateIf, ValidateNested } from 'class-validator';
+import { IsDefined, IsIn, IsNumber, IsObject, IsString, Length, Matches, Max, MaxLength, Min, ValidateIf, ValidateNested } from 'class-validator';
 import {
     RETAIL_ENTITY_ID_PATTERN,
+    RETAIL_LONG_TEXT_MAX_LENGTH,
+    RETAIL_SHORT_TEXT_MAX_LENGTH,
     RETAIL_STORE_CODE_MAX_LENGTH,
     RETAIL_ZIP_CODE_MAX_LENGTH,
     RETAIL_ZIP_CODE_MIN_LENGTH,
@@ -16,15 +18,15 @@ const LNG_MAX = 180;
 
 /** Dirección de la tienda; los opcionales llegan como `null`, nunca se omiten. */
 export class StoreEventAddressPayload implements RetailSystemStoreAddress {
-    @IsString() @Matches(/\S/) address1!: string;
-    @ValidateIf(isNullOrValidated) @IsString() externalNumber!: string | null;
-    @ValidateIf(isNullOrValidated) @IsString() internalNumber!: string | null;
-    @ValidateIf(isNullOrValidated) @IsString() neighborhood!: string | null;
-    @IsString() @Matches(/\S/) city!: string;
-    @IsString() @Matches(/\S/) state!: string;
+    @IsString() @Matches(/\S/) @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) address1!: string;
+    @ValidateIf(isNullOrValidated) @IsString() @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) externalNumber!: string | null;
+    @ValidateIf(isNullOrValidated) @IsString() @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) internalNumber!: string | null;
+    @ValidateIf(isNullOrValidated) @IsString() @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) neighborhood!: string | null;
+    @IsString() @Matches(/\S/) @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) city!: string;
+    @IsString() @Matches(/\S/) @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) state!: string;
     @IsString() @Length(RETAIL_ZIP_CODE_MIN_LENGTH, RETAIL_ZIP_CODE_MAX_LENGTH) zipCode!: string;
-    @ValidateIf(isNullOrValidated) @IsString() country!: string | null;
-    @ValidateIf(isNullOrValidated) @IsString() reference!: string | null;
+    @ValidateIf(isNullOrValidated) @IsString() @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) country!: string | null;
+    @ValidateIf(isNullOrValidated) @IsString() @MaxLength(RETAIL_LONG_TEXT_MAX_LENGTH) reference!: string | null;
 }
 
 /** Coordenada de la tienda; `null` si no se informa. */
@@ -37,11 +39,11 @@ export class StoreEventLocationPayload implements RetailSystemStoreLocation {
 export class StoreEventPayload implements RetailSystemStore {
     @IsString() @Matches(RETAIL_ENTITY_ID_PATTERN) storeId!: string;
     @IsString() @Length(1, RETAIL_STORE_CODE_MAX_LENGTH) code!: string;
-    @IsString() @Matches(/\S/) name!: string;
+    @IsString() @Matches(/\S/) @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) name!: string;
     @ValidateIf(isNullOrValidated) @IsString() @Matches(RETAIL_ZONE_ID_PATTERN) zoneId!: string | null;
-    @IsDefined() @ValidateNested() @Type(() => StoreEventAddressPayload) address!: StoreEventAddressPayload;
-    @IsDefined() @ValidateNested() @Type(() => StoreEventLocationPayload) location!: StoreEventLocationPayload;
-    @IsString() @Matches(/\S/) phone!: string;
-    @ValidateIf(isNullOrValidated) @IsString() schedule!: string | null;
+    @IsDefined() @IsObject() @ValidateNested() @Type(() => StoreEventAddressPayload) address!: StoreEventAddressPayload;
+    @IsDefined() @IsObject() @ValidateNested() @Type(() => StoreEventLocationPayload) location!: StoreEventLocationPayload;
+    @IsString() @Matches(/\S/) @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) phone!: string;
+    @ValidateIf(isNullOrValidated) @IsString() @MaxLength(RETAIL_SHORT_TEXT_MAX_LENGTH) schedule!: string | null;
     @IsIn(Object.values(RetailStoreStatusEnum)) status!: RetailStoreStatus;
 }