@fiado/type-kit 3.603.0 → 3.604.0

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

@@ -4,9 +4,11 @@ import { validateSync } from 'class-validator';
 import {
     GetRetailInventoryRequest,
     type GetRetailInventoryResponse,
+    type InvalidRetailInventoryMovement,
     ListRetailInventoryMovementsRequest,
     type ListRetailInventoryMovementsResponse,
     ReconciliationEntityEnum,
+    RetailEventRejectCodeEnum,
     ReconciliationPageMessage,
     ReconciliationTriggerEnum,
 } from '../../../src/retailIntegration';
@@ -61,6 +63,17 @@ describe('ListRetailInventoryMovementsRequest', () => {
             meta: { count: 1, nextToken: null },
         };
         expect(response.meta.nextToken).toBeNull();
+        expect(response.invalidItems).toBeUndefined();
+    });
+
+    it('la respuesta lista los movimientos inválidos con índice, eventId opcional y rutas', () => {
+        const invalid: InvalidRetailInventoryMovement[] = [
+            { index: 3, eventId: 'evt-4', code: RetailEventRejectCodeEnum.INVALID_PAYLOAD, invalidPaths: ['payload.storeId'] },
+            { index: 7, code: RetailEventRejectCodeEnum.INVALID_PAYLOAD, invalidPaths: ['eventId', 'occurredAt'] },
+        ];
+        const response: ListRetailInventoryMovementsResponse = { items: [], meta: { count: 0, nextToken: null }, invalidItems: invalid };
+        expect(response.invalidItems?.map((i) => i.index)).toEqual([3, 7]);
+        expect(response.invalidItems?.[1].eventId).toBeUndefined();
     });
 });
 

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

@@ -26,7 +26,7 @@ async function errorsOf(cls: new () => object, plain: object): Promise<string[]>
 const cashPayment = { method: 'CASH', amount: '400.00', cardLast4: null, authCode: null, speiTrackingKey: null, senderClabe: null } as const;
 const cardPayment = { method: 'CARD', amount: '200.00', cardLast4: '4242', authCode: 'A1B2C3', speiTrackingKey: null, senderClabe: null } as const;
 const wirePayment = {
-    method: 'WIRE', amount: '200.00', cardLast4: null, authCode: null, speiTrackingKey: '123456789012345678', senderClabe: '012180001234567897',
+    method: 'WIRE', amount: '200.00', cardLast4: null, authCode: null, speiTrackingKey: 'MBAN01002610160000123ABCD', senderClabe: '012180001234567897',
 } as const;
 
 // Literal tipado: prueba en compilación que la clase sigue aceptando objetos planos.
@@ -145,6 +145,11 @@ describe('RetailSystemSale.payments', () => {
         expect(await errorsOf(RetailSystemSale, { ...sale, payments: [cashPayment, { ...wirePayment, senderClabe: null }] })).toEqual([]);
     });
 
+    it('acepta speiTrackingKey de 1 a 30 alfanuméricos', async () => {
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments: [cashPayment, { ...wirePayment, speiTrackingKey: '7' }] })).toEqual([]);
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments: [cashPayment, { ...wirePayment, speiTrackingKey: 'A'.repeat(30) }] })).toEqual([]);
+    });
+
     it('acepta FIADO sin detalle', async () => {
         expect(await errorsOf(RetailSystemSale, { ...sale, payments: [{ ...cashPayment, method: 'FIADO', amount: '600.00' }] })).toEqual([]);
     });
@@ -182,7 +187,11 @@ describe('RetailSystemSale.payments', () => {
 
     it.each([
         ['speiTrackingKey', { speiTrackingKey: null }],
-        ['speiTrackingKey', { speiTrackingKey: '12345' }],
+        ['speiTrackingKey', { speiTrackingKey: '' }],
+        ['speiTrackingKey', { speiTrackingKey: 'A'.repeat(31) }],
+        ['speiTrackingKey', { speiTrackingKey: 'MBAN-0100-2610' }],
+        ['speiTrackingKey', { speiTrackingKey: 'MBAN 01002610' }],
+        ['senderClabe', { senderClabe: '01218000123456789A' }],
         ['senderClabe', { senderClabe: '0121' }],
         ['cardLast4', { cardLast4: '4242' }],
     ])('rechaza %s fuera de regla en WIRE', async (field, patch) => {

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

@@ -53,8 +53,9 @@ export declare const RETAIL_SALE_POSITIVE_DECIMAL_PATTERN: RegExp;
 export declare const RETAIL_SALE_ID_TEXT_PATTERN: RegExp;
 /** Últimos 4 dígitos de la tarjeta en un pago `CARD`. */
 export declare const RETAIL_CARD_LAST4_PATTERN: RegExp;
-/** Clave de rastreo SPEI y CLABE de un pago `WIRE`: 18 dígitos. */
+/** Clave de rastreo SPEI de un pago `WIRE`: alfanumérica de 1 a 30, como la define Banxico. */
 export declare const RETAIL_SPEI_TRACKING_KEY_PATTERN: RegExp;
+/** CLABE de la cuenta que envió un pago `WIRE`: 18 dígitos. */
 export declare const RETAIL_CLABE_PATTERN: RegExp;
 /** Tope del motivo de cancelación de una venta. */
 export declare const RETAIL_CANCEL_REASON_MAX_LENGTH = 200;

package/bin/retailIntegration/constants/retailIntegrationLimits.js

@@ -56,8 +56,9 @@ exports.RETAIL_SALE_POSITIVE_DECIMAL_PATTERN = /^(?=.*[1-9])\d{1,12}\.\d{2}$/;
 exports.RETAIL_SALE_ID_TEXT_PATTERN = /^(?=.*\S).{1,64}$/;
 /** Últimos 4 dígitos de la tarjeta en un pago `CARD`. */
 exports.RETAIL_CARD_LAST4_PATTERN = /^\d{4}$/;
-/** Clave de rastreo SPEI y CLABE de un pago `WIRE`: 18 dígitos. */
-exports.RETAIL_SPEI_TRACKING_KEY_PATTERN = /^\d{18}$/;
+/** Clave de rastreo SPEI de un pago `WIRE`: alfanumérica de 1 a 30, como la define Banxico. */
+exports.RETAIL_SPEI_TRACKING_KEY_PATTERN = /^[A-Za-z0-9]{1,30}$/;
+/** CLABE de la cuenta que envió un pago `WIRE`: 18 dígitos. */
 exports.RETAIL_CLABE_PATTERN = /^\d{18}$/;
 /** Tope del motivo de cancelación de una venta. */
 exports.RETAIL_CANCEL_REASON_MAX_LENGTH = 200;

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

@@ -1,3 +1,4 @@
+import { RetailEventRejectCodeEnum } from '../enums';
 import { RetailInventoryMeta, RetailPageMeta } from '../models/RetailPageMeta';
 import { RetailSystemInventoryMovement, RetailSystemPiece, RetailSystemStock } from '../models/RetailSystemInventory';
 import { RetailSystemProduct } from '../models/RetailSystemProduct';
@@ -19,10 +20,18 @@ export interface GetRetailInventoryResponse {
     stock: RetailSystemStock[];
     meta: RetailInventoryMeta;
 }
-/** `data` de `GET /private/retail/inventory/movements`. */
+/** Movimiento de la página que no cumple el sobre del webhook; catalog lo salta y lo cuenta. */
+export interface InvalidRetailInventoryMovement {
+    index: number;
+    eventId?: string;
+    code: RetailEventRejectCodeEnum.INVALID_PAYLOAD;
+    invalidPaths: string[];
+}
+/** `data` de `GET /private/retail/inventory/movements`; `invalidItems` lista los movimientos descartados. */
 export interface ListRetailInventoryMovementsResponse {
     items: RetailSystemInventoryMovement[];
     meta: RetailPageMeta;
+    invalidItems?: InvalidRetailInventoryMovement[];
 }
 /** `data` de `GET /private/retail/users`. */
 export interface ListRetailUsersResponse {

package/package.json

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

package/src/retailIntegration/constants/retailIntegrationLimits.ts

@@ -79,8 +79,10 @@ export const RETAIL_SALE_ID_TEXT_PATTERN = /^(?=.*\S).{1,64}$/;
 /** Últimos 4 dígitos de la tarjeta en un pago `CARD`. */
 export const RETAIL_CARD_LAST4_PATTERN = /^\d{4}$/;
 
-/** Clave de rastreo SPEI y CLABE de un pago `WIRE`: 18 dígitos. */
-export const RETAIL_SPEI_TRACKING_KEY_PATTERN = /^\d{18}$/;
+/** Clave de rastreo SPEI de un pago `WIRE`: alfanumérica de 1 a 30, como la define Banxico. */
+export const RETAIL_SPEI_TRACKING_KEY_PATTERN = /^[A-Za-z0-9]{1,30}$/;
+
+/** CLABE de la cuenta que envió un pago `WIRE`: 18 dígitos. */
 export const RETAIL_CLABE_PATTERN = /^\d{18}$/;
 
 /** Tope del motivo de cancelación de una venta. */

package/src/retailIntegration/dtos/RetailOutboundResponses.ts

@@ -1,3 +1,4 @@
+import { RetailEventRejectCodeEnum } from '../enums';
 import { RetailInventoryMeta, RetailPageMeta } from '../models/RetailPageMeta';
 import { RetailSystemInventoryMovement, RetailSystemPiece, RetailSystemStock } from '../models/RetailSystemInventory';
 import { RetailSystemProduct } from '../models/RetailSystemProduct';
@@ -23,10 +24,19 @@ export interface GetRetailInventoryResponse {
     meta: RetailInventoryMeta;
 }
 
-/** `data` de `GET /private/retail/inventory/movements`. */
+/** Movimiento de la página que no cumple el sobre del webhook; catalog lo salta y lo cuenta. */
+export interface InvalidRetailInventoryMovement {
+    index: number;
+    eventId?: string;
+    code: RetailEventRejectCodeEnum.INVALID_PAYLOAD;
+    invalidPaths: string[];
+}
+
+/** `data` de `GET /private/retail/inventory/movements`; `invalidItems` lista los movimientos descartados. */
 export interface ListRetailInventoryMovementsResponse {
     items: RetailSystemInventoryMovement[];
     meta: RetailPageMeta;
+    invalidItems?: InvalidRetailInventoryMovement[];
 }
 
 /** `data` de `GET /private/retail/users`. */