@fiado/type-kit 3.495.0 → 3.496.0

package/_test_/unit/loanCredit/dtos/createSellerPaymentRequest.test.ts

@@ -0,0 +1,63 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { CreateSellerPaymentRequest } from '../../../../src/loanCredit/index';
+
+const errorPaths = async (body: object): Promise<string[]> => {
+    const dto = plainToInstance(CreateSellerPaymentRequest, body);
+    const errors = await validate(dto, { whitelist: true, forbidNonWhitelisted: false });
+    const pathsOf = (error: (typeof errors)[number], parent: string): string[] => {
+        const path = parent ? `${parent}.${error.property}` : error.property;
+        return [...(error.constraints ? [path] : []), ...(error.children ?? []).flatMap((child) => pathsOf(child, path))];
+    };
+    return errors.flatMap((error) => pathsOf(error, ''));
+};
+
+const BASE = {
+    type: 'NEXT_INSTALLMENT',
+    expectedAmountCents: 48_700,
+    method: 'CASH',
+    idempotencyKey: '7b0e3a52-6a0f-4f1f-9f43-6b4d5c1e2a10',
+};
+
+describe('CreateSellerPaymentRequest', () => {
+    it('acepta efectivo sin detalle', async () => {
+        expect(await errorPaths(BASE)).toEqual([]);
+    });
+
+    it('acepta tarjeta con últimos 4 y autorización', async () => {
+        expect(await errorPaths({ ...BASE, method: 'CARD', detail: { cardLast4: '4242', authCode: 'A1B2C3' } })).toEqual([]);
+    });
+
+    it('acepta SPEI con clave de rastreo de hasta 30', async () => {
+        expect(await errorPaths({ ...BASE, method: 'WIRE', detail: { speiTrackingKey: 'X'.repeat(30) } })).toEqual([]);
+    });
+
+    it('rechaza últimos 4 que no son 4 dígitos', async () => {
+        expect(await errorPaths({ ...BASE, method: 'CARD', detail: { cardLast4: '42a2', authCode: 'A1' } })).toEqual(['detail.cardLast4']);
+    });
+
+    it('rechaza clave de rastreo vacía o de más de 30', async () => {
+        expect(await errorPaths({ ...BASE, method: 'WIRE', detail: { speiTrackingKey: '' } })).toEqual(['detail.speiTrackingKey']);
+        expect(await errorPaths({ ...BASE, method: 'WIRE', detail: { speiTrackingKey: 'X'.repeat(31) } })).toEqual([
+            'detail.speiTrackingKey',
+        ]);
+    });
+
+    it('rechaza forma de pago, tipo, monto o llave inválidos', async () => {
+        expect(await errorPaths({ ...BASE, method: 'CHEQUE' })).toEqual(['method']);
+        expect(await errorPaths({ ...BASE, type: 'OTHER' })).toEqual(['type']);
+        expect(await errorPaths({ ...BASE, expectedAmountCents: 0 })).toEqual(['expectedAmountCents']);
+        expect(await errorPaths({ ...BASE, idempotencyKey: 'no-uuid' })).toEqual(['idempotencyKey']);
+    });
+
+    it('cuotas solo de 2 en adelante', async () => {
+        expect(await errorPaths({ ...BASE, type: 'ADVANCE', installmentCount: 1 })).toEqual(['installmentCount']);
+        expect(await errorPaths({ ...BASE, type: 'ADVANCE', installmentCount: 2 })).toEqual([]);
+    });
+
+    it('no declara CLABE: con whitelist se descarta y nunca llega al dominio', () => {
+        const dto = plainToInstance(CreateSellerPaymentRequest, { ...BASE, clabe: '012345678901234567' }, { excludeExtraneousValues: true });
+        expect(dto).not.toHaveProperty('clabe');
+    });
+});

package/_test_/unit/loanCredit/inStorePaymentDtos.test.ts

@@ -0,0 +1,141 @@
+import 'reflect-metadata';
+import type {
+    CreditCustomerListItem,
+    InStorePaymentListResponse,
+    LoanPaymentListItem,
+    SellerCreditLookupResult,
+    SellerPaymentOptions,
+    SellerPaymentResult,
+} from '../../../src/loanCredit/index';
+import {
+    CreditCustomerStateEnum,
+    InStorePaymentMethodEnum,
+    LoanCustomerPaymentTypeEnum,
+    LoanInstallmentStatusEnum,
+    LoanPaymentOriginEnum,
+} from '../../../src/loanCredit/index';
+
+describe.each([
+    ['InStorePaymentMethodEnum', InStorePaymentMethodEnum, ['CASH', 'CARD', 'WIRE']],
+    ['LoanPaymentOriginEnum', LoanPaymentOriginEnum, ['COLLECTION_ENGINE', 'IN_STORE']],
+    ['CreditCustomerStateEnum', CreditCustomerStateEnum, ['READ', 'NO_BORROWER', 'UNAVAILABLE']],
+])('%s', (_name, enumObject, values) => {
+    it('tiene exactamente los valores del contrato', () => {
+        expect(Object.values(enumObject).sort()).toEqual([...values].sort());
+    });
+    it('cada llave es igual a su valor', () => {
+        for (const [key, value] of Object.entries(enumObject)) {
+            expect(key).toBe(value);
+        }
+    });
+});
+
+describe('loanCredit — contrato del cobro en tienda', () => {
+    it('el resultado lleva folio, tienda, vendedor, siguiente cuota y equipo', () => {
+        const result: SellerPaymentResult = {
+            creditId: 'CR-1',
+            receipt: 'SK-TD-0123456789ab',
+            amountCents: 48_700,
+            type: LoanCustomerPaymentTypeEnum.NEXT_INSTALLMENT,
+            method: InStorePaymentMethodEnum.CASH,
+            appliedAt: '2026-10-08T17:00:00.000Z',
+            outstandingBalanceAfterCents: 400_000,
+            collectedAtStore: { id: 'ST-1', name: 'Tienda Limpia' },
+            collectedBySeller: { id: 'RU-1', name: 'Ana' },
+            nextInstallment: { installmentNumber: 4, dueDate: '2026-10-15', amountCents: 48_700, status: LoanInstallmentStatusEnum.PENDING },
+            credit: { creditId: 'CR-1', imei: '356789012345678', productBrand: 'Samsung', productModel: 'A15' },
+        };
+        expect(result.receipt.startsWith('SK-TD-')).toBe(true);
+    });
+
+    it('las opciones traen el resumen y cada tipo con su monto o rango', () => {
+        const options: SellerPaymentOptions = {
+            creditId: 'CR-1',
+            summary: { totalCents: 1_000_000, paidCents: 600_000, remainingCents: 400_000, nextInstallment: null },
+            nextInstallment: { available: true, amountCents: 97_400, installmentNumbers: [3, 4], overdueCount: 1 },
+            advance: { available: false, unavailableReason: 'CREDIT_NOT_CURRENT' as never },
+            prepayment: { available: false },
+            settlement: { available: true, amountCents: 380_000 },
+        };
+        expect(options.nextInstallment.installmentNumbers).toEqual([3, 4]);
+    });
+
+    it('la búsqueda responde lo mínimo, sin el identificador que no se buscó', () => {
+        const found: SellerCreditLookupResult = {
+            creditId: 'CR-1',
+            customerName: 'Juan P.',
+            productBrand: 'Samsung',
+            productModel: 'A15',
+            nextInstallment: null,
+        };
+        expect(found).not.toHaveProperty('imei');
+        expect(found).not.toHaveProperty('phone');
+    });
+
+    it('la conciliación pagina los cobros de una tienda', () => {
+        const page: InStorePaymentListResponse = {
+            items: [
+                {
+                    receipt: 'SK-TD-0123456789ab',
+                    creditId: 'CR-1',
+                    paymentId: '01J00000000000000000000000',
+                    chargeKind: 'INSTALLMENT' as never,
+                    amountCents: 48_700,
+                    method: InStorePaymentMethodEnum.CARD,
+                    collectedBySeller: { id: 'RU-1', name: 'Ana' },
+                    appliedAt: '2026-10-08T17:00:00.000Z',
+                },
+            ],
+        };
+        expect(page.nextToken).toBeUndefined();
+    });
+
+    it('el historial dice dónde, cómo y quién; mechanism es opcional', () => {
+        const item: LoanPaymentListItem = {
+            paymentId: 'P-1',
+            receipt: 'SK-TD-0123456789ab',
+            installmentNumber: 3,
+            attemptId: 'IN_STORE#k',
+            result: 'FULL' as never,
+            currency: 'MXN' as never,
+            collectedCents: 48_700,
+            appliedCents: 48_700,
+            overpaidCents: 0,
+            reservedCents: 0,
+            needsReview: false,
+            appliedAt: '2026-10-08T17:00:00.000Z',
+            origin: LoanPaymentOriginEnum.IN_STORE,
+            inStoreMethod: InStorePaymentMethodEnum.CASH,
+            collectedAtStore: { id: 'ST-1', name: 'Tienda Limpia' },
+            collectedBySeller: { id: 'RU-1', name: 'Ana' },
+        };
+        expect(item.mechanism).toBeUndefined();
+    });
+
+    it('la fila de Clientes trae el último pago con su lugar', () => {
+        const row: CreditCustomerListItem = {
+            retailCustomerId: 'RC-1',
+            fullName: null,
+            phone: null,
+            originStoreId: null,
+            segments: [],
+            segmentsRead: true,
+            credit: {
+                state: CreditCustomerStateEnum.READ,
+                clientLevel: null,
+                sciScore: null,
+                sciSource: null,
+                creditsCount: 1,
+                activeCreditsCount: 1,
+                settledCreditsCount: 0,
+                writtenOffCreditsCount: 0,
+                outstandingBalanceCents: 0,
+                arrearsDays: 0,
+                lastPaymentAt: '2026-10-08T17:00:00.000Z',
+                lastPayment: { at: '2026-10-08T17:00:00.000Z', origin: LoanPaymentOriginEnum.IN_STORE, storeId: 'ST-1', storeName: 'Tienda Limpia' },
+                activeCreditId: 'CR-1',
+            },
+        };
+        expect(row.credit.lastPayment?.storeName).toBe('Tienda Limpia');
+    });
+});

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

@@ -0,0 +1,43 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    ApplyInventoryEventRequest,
+    ApplyProductEventRequest,
+    ApplyRetailUserEventRequest,
+    ApplyStoreEventRequest,
+} from '../../../src/retailIntegration/dtos/ApplyRetailEventRequest';
+
+const base = {
+    tenantId: 'surekeep',
+    eventId: 'evt_01J8ZA1B2C3D4E5F6G7H8J9K0L',
+    occurredAt: '2026-08-01T15:00:00Z',
+    payload: { storeId: '12' },
+};
+
+async function propertiesWithErrors(cls: new () => object, plain: Record<string, unknown>): Promise<string[]> {
+    const errors = await validate(plainToInstance(cls, plain));
+    return errors.map((error) => error.property);
+}
+
+describe('DTOs del contrato connector → destino', () => {
+    it.each([
+        [ApplyStoreEventRequest, 'StoreCreatedV1', 'RetailUserCreatedV1'],
+        [ApplyRetailUserEventRequest, 'RetailUserTransferredV1', 'StoreCreatedV1'],
+        [ApplyProductEventRequest, 'ProductCreatedV1', 'InventoryMovementV1'],
+        [ApplyInventoryEventRequest, 'InventoryMovementV1', 'ProductUpdatedV1'],
+    ])('%p acepta %s y rechaza %s de otra ruta', async (cls, own, foreign) => {
+        expect(await propertiesWithErrors(cls, { ...base, eventType: own })).toEqual([]);
+        expect(await propertiesWithErrors(cls, { ...base, eventType: foreign })).toEqual(['eventType']);
+    });
+
+    it.each([ApplyStoreEventRequest, ApplyRetailUserEventRequest, ApplyProductEventRequest, ApplyInventoryEventRequest])(
+        '%p valida tenantId',
+        async (cls) => {
+            const eventType = { ApplyStoreEventRequest: 'StoreCreatedV1', ApplyRetailUserEventRequest: 'RetailUserCreatedV1', ApplyProductEventRequest: 'ProductCreatedV1', ApplyInventoryEventRequest: 'InventoryMovementV1' }[cls.name];
+            for (const tenantId of [undefined, '', 'sure/keep', 'a'.repeat(65)]) {
+                expect(await propertiesWithErrors(cls, { ...base, eventType, tenantId })).toEqual(['tenantId']);
+            }
+        },
+    );
+});

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

@@ -0,0 +1,85 @@
+import 'reflect-metadata';
+import { IsIsoDateTimeWithZone } from '../../../src/retailIntegration/validators/IsIsoDateTimeWithZone';
+import {
+    InventoryEventTypeEnum,
+    ProductEventTypeEnum,
+    RetailEventResultEnum,
+    RetailUserEventTypeEnum,
+    StoreEventTypeEnum,
+} from '../../../src/retailIntegration/enums';
+import {
+    RETAIL_EVENT_ID_MAX_LENGTH,
+    RETAIL_LIST_LIMIT_MAX,
+    RETAIL_LIST_LIMIT_MIN,
+    RETAIL_TENANT_ID_PATTERN,
+} from '../../../src/retailIntegration/constants/retailIntegrationLimits';
+
+describe('IsIsoDateTimeWithZone', () => {
+    const validator = new IsIsoDateTimeWithZone();
+
+    it.each([
+        '2026-08-17T20:32:05Z',
+        '2026-08-17T20:32:05.123Z',
+        '2026-08-17T20:32:05-06:00',
+        '2026-08-17T20:32:05+05:30',
+    ])('acepta %s', (value) => {
+        expect(validator.validate(value)).toBe(true);
+    });
+
+    it.each([
+        ['sin zona', '2026-08-17T20:32:05'],
+        ['solo fecha', '2026-08-17'],
+        ['sin segundos', '2026-08-17T20:32Z'],
+        ['mes inválido', '2026-13-01T00:00:00Z'],
+        ['hora inválida', '2026-08-17T25:00:00Z'],
+        ['31 de febrero', '2026-02-31T00:00:00Z'],
+        ['31 de abril', '2026-04-31T10:00:00-06:00'],
+        ['texto', 'ayer'],
+        ['vacío', ''],
+        ['espacios', '   '],
+    ])('rechaza %s', (_label, value) => {
+        expect(validator.validate(value)).toBe(false);
+    });
+
+    it.each([null, undefined, 1786998725000, {}, []])('rechaza tipos que no son string: %p', (value) => {
+        expect(validator.validate(value)).toBe(false);
+    });
+
+    it('explica el formato esperado en el mensaje', () => {
+        expect(validator.defaultMessage()).toContain('ISO-8601 con zona');
+    });
+});
+
+describe('enums de retailIntegration', () => {
+    it('los resultados son los de la doc', () => {
+        expect(Object.values(RetailEventResultEnum)).toEqual(['APPLIED', 'NOOP', 'REJECTED']);
+    });
+
+    it('los eventType por ruta son los de la doc', () => {
+        expect(Object.values(StoreEventTypeEnum)).toEqual(['StoreCreatedV1', 'StoreUpdatedV1', 'StoreStatusChangedV1']);
+        expect(Object.values(ProductEventTypeEnum)).toEqual(['ProductCreatedV1', 'ProductUpdatedV1', 'ProductStatusChangedV1']);
+        expect(Object.values(InventoryEventTypeEnum)).toEqual(['InventoryMovementV1']);
+        expect(Object.values(RetailUserEventTypeEnum)).toEqual([
+            'RetailUserCreatedV1',
+            'RetailUserUpdatedV1',
+            'RetailUserTransferredV1',
+            'RetailUserStatusChangedV1',
+        ]);
+    });
+});
+
+describe('límites de retailIntegration', () => {
+    it('fija los topes del contrato', () => {
+        expect(RETAIL_EVENT_ID_MAX_LENGTH).toBe(1024);
+        expect(RETAIL_LIST_LIMIT_MIN).toBe(1);
+        expect(RETAIL_LIST_LIMIT_MAX).toBe(200);
+    });
+
+    it('el patrón de tenantId acepta slugs y rechaza separadores de ruta', () => {
+        expect(RETAIL_TENANT_ID_PATTERN.test('surekeep')).toBe(true);
+        expect(RETAIL_TENANT_ID_PATTERN.test('tenant_2-a')).toBe(true);
+        expect(RETAIL_TENANT_ID_PATTERN.test('sure/keep')).toBe(false);
+        expect(RETAIL_TENANT_ID_PATTERN.test('')).toBe(false);
+        expect(RETAIL_TENANT_ID_PATTERN.test('a'.repeat(65))).toBe(false);
+    });
+});

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

@@ -0,0 +1,93 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { ReceiveStoreEventRequest } from '../../../src/retailIntegration/dtos/ReceiveStoreEventRequest';
+import { ReceiveRetailUserEventRequest } from '../../../src/retailIntegration/dtos/ReceiveRetailUserEventRequest';
+import { ReceiveProductEventRequest } from '../../../src/retailIntegration/dtos/ReceiveProductEventRequest';
+import { ReceiveInventoryEventRequest } from '../../../src/retailIntegration/dtos/ReceiveInventoryEventRequest';
+
+const base = {
+    eventId: 'evt_01J8ZA1B2C3D4E5F6G7H8J9K0L',
+    occurredAt: '2026-08-01T15:00:00Z',
+    payload: { storeId: '12', name: 'Sucursal Centro' },
+};
+
+async function propertiesWithErrors(cls: new () => object, plain: Record<string, unknown>): Promise<string[]> {
+    const errors = await validate(plainToInstance(cls, plain));
+    return errors.map((error) => error.property);
+}
+
+describe('DTOs de entrada de los webhooks', () => {
+    it.each([
+        [ReceiveStoreEventRequest, 'StoreStatusChangedV1'],
+        [ReceiveRetailUserEventRequest, 'RetailUserTransferredV1'],
+        [ReceiveProductEventRequest, 'ProductCreatedV1'],
+        [ReceiveInventoryEventRequest, 'InventoryMovementV1'],
+    ])('%p acepta un sobre válido con %s', async (cls, eventType) => {
+        expect(await propertiesWithErrors(cls, { ...base, eventType })).toEqual([]);
+    });
+
+    it.each([
+        [ReceiveStoreEventRequest, 'RetailUserCreatedV1'],
+        [ReceiveRetailUserEventRequest, 'StoreCreatedV1'],
+        [ReceiveProductEventRequest, 'InventoryMovementV1'],
+        [ReceiveInventoryEventRequest, 'ProductUpdatedV1'],
+    ])('%p rechaza el eventType %s de otra ruta', async (cls, eventType) => {
+        expect(await propertiesWithErrors(cls, { ...base, eventType })).toEqual(['eventType']);
+    });
+
+    describe('eventId', () => {
+        const valid = { ...base, eventType: 'StoreCreatedV1' };
+
+        it('acepta 1024 caracteres', async () => {
+            expect(await propertiesWithErrors(ReceiveStoreEventRequest, { ...valid, eventId: 'e'.repeat(1024) })).toEqual([]);
+        });
+
+        it.each([
+            ['ausente', undefined],
+            ['vacío', ''],
+            ['solo espacios', '   '],
+            ['número', 123],
+            ['1025 caracteres', 'e'.repeat(1025)],
+        ])('rechaza %s', async (_label, eventId) => {
+            expect(await propertiesWithErrors(ReceiveStoreEventRequest, { ...valid, eventId })).toEqual(['eventId']);
+        });
+    });
+
+    describe('occurredAt', () => {
+        const valid = { ...base, eventType: 'StoreCreatedV1' };
+
+        it.each([
+            ['sin zona', '2026-08-01T15:00:00'],
+            ['ausente', undefined],
+            ['texto', 'hoy'],
+        ])('rechaza %s', async (_label, occurredAt) => {
+            expect(await propertiesWithErrors(ReceiveStoreEventRequest, { ...valid, occurredAt })).toEqual(['occurredAt']);
+        });
+
+        it('acepta un offset', async () => {
+            expect(await propertiesWithErrors(ReceiveStoreEventRequest, { ...valid, occurredAt: '2026-08-01T09:00:00-06:00' })).toEqual([]);
+        });
+    });
+
+    describe('payload', () => {
+        const valid = { ...base, eventType: 'StoreCreatedV1' };
+
+        it.each([
+            ['ausente', undefined],
+            ['null', null],
+            ['arreglo', [1, 2]],
+            ['string', 'tienda'],
+        ])('rechaza %s', async (_label, payload) => {
+            expect(await propertiesWithErrors(ReceiveStoreEventRequest, { ...valid, payload })).toEqual(['payload']);
+        });
+
+        it('no valida el contenido del payload', async () => {
+            expect(await propertiesWithErrors(ReceiveStoreEventRequest, { ...valid, payload: { cualquierCosa: [1, { x: null }] } })).toEqual([]);
+        });
+    });
+
+    it('reporta todos los campos que faltan en un sobre vacío', async () => {
+        expect((await propertiesWithErrors(ReceiveStoreEventRequest, {})).sort()).toEqual(['eventId', 'eventType', 'occurredAt', 'payload']);
+    });
+});

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

@@ -0,0 +1,69 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    GetRetailInventoryRequest,
+    ListRetailCatalogRequest,
+    ListRetailStoresRequest,
+    ListRetailUsersRequest,
+    RegisterRetailSaleRequest,
+} from '../../../src/retailIntegration';
+import { RetailIntegration } from '../../../src';
+
+async function propertiesWithErrors(cls: new () => object, plain: Record<string, unknown>): Promise<string[]> {
+    const errors = await validate(plainToInstance(cls, plain));
+    return errors.map((error) => error.property);
+}
+
+describe('DTOs de salida hacia el retailer', () => {
+    describe.each([ListRetailStoresRequest, ListRetailCatalogRequest, ListRetailUsersRequest])('%p (paginada)', (cls) => {
+        it('acepta solo tenantId', async () => {
+            expect(await propertiesWithErrors(cls, { tenantId: 'surekeep' })).toEqual([]);
+        });
+
+        it('convierte limit de string a número', async () => {
+            const dto = plainToInstance(cls, { tenantId: 'surekeep', limit: '50' }) as { limit?: number };
+            expect(dto.limit).toBe(50);
+            expect(await validate(dto)).toEqual([]);
+        });
+
+        it.each(['0', '201', 'abc', '1.5', ''])('rechaza limit=%p', async (limit) => {
+            expect(await propertiesWithErrors(cls, { tenantId: 'surekeep', limit })).toEqual(['limit']);
+        });
+
+        it('acepta nextToken opaco y rechaza nextToken vacío', async () => {
+            expect(await propertiesWithErrors(cls, { tenantId: 'surekeep', nextToken: 'eyJpZCI6MTQwMH0' })).toEqual([]);
+            expect(await propertiesWithErrors(cls, { tenantId: 'surekeep', nextToken: '' })).toEqual(['nextToken']);
+        });
+    });
+
+    it.each([
+        ['ausente', undefined],
+        ['con diagonal', 'sure/keep'],
+        ['vacío', ''],
+    ])('rechaza tenantId %s', async (_label, tenantId) => {
+        expect(await propertiesWithErrors(ListRetailStoresRequest, { tenantId })).toEqual(['tenantId']);
+    });
+
+    it('inventario exige storeId', async () => {
+        expect(await propertiesWithErrors(GetRetailInventoryRequest, { tenantId: 'surekeep', storeId: '12' })).toEqual([]);
+        expect(await propertiesWithErrors(GetRetailInventoryRequest, { tenantId: 'surekeep' })).toEqual(['storeId']);
+        expect(await propertiesWithErrors(GetRetailInventoryRequest, { tenantId: 'surekeep', storeId: '  ' })).toEqual(['storeId']);
+    });
+
+    it('usuarios acepta storeId opcional', async () => {
+        expect(await propertiesWithErrors(ListRetailUsersRequest, { tenantId: 'surekeep', storeId: '12' })).toEqual([]);
+        expect(await propertiesWithErrors(ListRetailUsersRequest, { tenantId: 'surekeep', storeId: '' })).toEqual(['storeId']);
+    });
+
+    it('venta solo valida tenantId', async () => {
+        expect(await propertiesWithErrors(RegisterRetailSaleRequest, { tenantId: 'surekeep' })).toEqual([]);
+        expect(await propertiesWithErrors(RegisterRetailSaleRequest, {})).toEqual(['tenantId']);
+    });
+
+    it('el módulo se expone en la raíz como RetailIntegration', () => {
+        expect(RetailIntegration.ListRetailStoresRequest).toBe(ListRetailStoresRequest);
+        expect(RetailIntegration.ReceiveStoreEventRequest).toBeDefined();
+        expect(RetailIntegration.RetailEventResultEnum.APPLIED).toBe('APPLIED');
+    });
+});

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

@@ -0,0 +1,42 @@
+import 'reflect-metadata';
+import {
+    RetailCurrencyEnum,
+    RetailFinancierEnum,
+    RetailLinePaymentTypeEnum,
+    RetailMdmProviderEnum,
+    RetailPaymentMethodEnum,
+    RetailPieceReasonEnum,
+    RetailPieceStatusEnum,
+    RetailProductCategoryEnum,
+    RetailProductStatusEnum,
+    RetailProductTierEnum,
+    RetailSaleFinancierEnum,
+    RetailSaleTypeEnum,
+    RetailStoreStatusEnum,
+    RetailTrackingModeEnum,
+    RetailUserAccessStatusEnum,
+    RetailUserRoleEnum,
+} from '../../../src/retailIntegration';
+
+describe('enums de los objetos del retailer', () => {
+    it.each([
+        [RetailStoreStatusEnum, ['ACTIVE', 'SUSPENDED', 'INACTIVE']],
+        [RetailProductCategoryEnum, ['PHONE', 'MODEM', 'ACCESSORY', 'SIM']],
+        [RetailTrackingModeEnum, ['IMEI', 'SERIAL', 'QUANTITY']],
+        [RetailProductTierEnum, ['LOW', 'MID', 'HIGH', 'PREMIUM']],
+        [RetailCurrencyEnum, ['MXN', 'USD']],
+        [RetailFinancierEnum, ['SUREKEEP', 'PAYJOY', 'CREDIYA', 'LESPAGO', 'INNOVA']],
+        [RetailMdmProviderEnum, ['TRUSTONIC', 'DATACULTR']],
+        [RetailProductStatusEnum, ['ACTIVE', 'INACTIVE', 'DISCONTINUED']],
+        [RetailPieceStatusEnum, ['AVAILABLE', 'IN_TRANSIT', 'SOLD', 'DAMAGED']],
+        [RetailPieceReasonEnum, ['WARRANTY', 'DAMAGED_RETURN', 'SHRINKAGE']],
+        [RetailUserRoleEnum, ['SELLER', 'STORE_MANAGER', 'RETAILER_ADMIN', 'COLLECTION_AGENT']],
+        [RetailUserAccessStatusEnum, ['ACTIVE', 'SUSPENDED', 'INACTIVE']],
+        [RetailSaleTypeEnum, ['CASH', 'CREDIT', 'EXTERNAL_REFERRAL']],
+        [RetailSaleFinancierEnum, ['NONE', 'SUREKEEP', 'PAYJOY', 'CREDIYA', 'LESPAGO', 'INNOVA']],
+        [RetailPaymentMethodEnum, ['CASH', 'CARD', 'SPEI']],
+        [RetailLinePaymentTypeEnum, ['CASH', 'CREDIT']],
+    ])('%p trae exactamente los valores del contrato', (enumObject, values) => {
+        expect(Object.values(enumObject)).toEqual(values);
+    });
+});

package/bin/index.d.ts

@@ -98,6 +98,7 @@ export * as RetailCards from './retailCards';
 export * as RetailCustomer from './retailCustomer';
 export * as RetailWizard from './retailWizard';
 export * as RetailPromotions from './retailPromotions';
+export * as RetailIntegration from './retailIntegration';
 export * as DatalakeQuery from './datalakeQuery';
 export * as LoanConfig from './loanConfig';
 export * as Shortlink from './shortlink';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IssuanceBusiness = exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
 exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.WhatsappConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = void 0;
-exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = void 0;
+exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -166,6 +166,8 @@ exports.RetailWizard = __importStar(require("./retailWizard"));
 // RetailPromotions: DTOs/enums de retail-promotions-business (promos de venta, códigos de descuento y
 // cupones de VentasLuga). Porcentajes en puntos base, dinero en centavos.
 exports.RetailPromotions = __importStar(require("./retailPromotions"));
+// RetailIntegration: DTOs del retail-integration-connector (webhooks del retailer y salida hacia su sistema).
+exports.RetailIntegration = __importStar(require("./retailIntegration"));
 exports.DatalakeQuery = __importStar(require("./datalakeQuery"));
 // LoanConfig: DTOs/enums del lambda loan-config-business (comp 09 — parámetros operativos del SOFOM).
 exports.LoanConfig = __importStar(require("./loanConfig"));

package/bin/loanCredit/dtos/requests/CreateSellerPaymentRequest.d.ts

@@ -0,0 +1,15 @@
+import { InStorePaymentMethodEnum } from '../../enums/InStorePaymentMethodEnum';
+import { LoanCustomerPaymentTypeEnum } from '../../enums/LoanCustomerPaymentTypeEnum';
+import { InStorePaymentDetail } from './InStorePaymentDetail';
+/** Body de `POST /seller/credits/{creditId}/payments`: el vendedor anota un pago recibido en tienda. */
+export declare class CreateSellerPaymentRequest {
+    type: LoanCustomerPaymentTypeEnum;
+    /** El monto que vio el vendedor en las opciones; distinto al de hoy → 409 CUSTOMER_PAYMENT_AMOUNT_CHANGED. */
+    expectedAmountCents: number;
+    /** Solo ADVANCE: cuántas cuotas adelanta. */
+    installmentCount?: number;
+    method: InStorePaymentMethodEnum;
+    /** Tarjeta: `cardLast4` + `authCode`; SPEI: `speiTrackingKey`; efectivo: sin detalle. */
+    detail?: InStorePaymentDetail;
+    idempotencyKey: string;
+}

package/bin/loanCredit/dtos/requests/CreateSellerPaymentRequest.js

@@ -0,0 +1,56 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+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.CreateSellerPaymentRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const InStorePaymentMethodEnum_1 = require("../../enums/InStorePaymentMethodEnum");
+const LoanCustomerPaymentTypeEnum_1 = require("../../enums/LoanCustomerPaymentTypeEnum");
+const InStorePaymentDetail_1 = require("./InStorePaymentDetail");
+/** Body de `POST /seller/credits/{creditId}/payments`: el vendedor anota un pago recibido en tienda. */
+class CreateSellerPaymentRequest {
+}
+exports.CreateSellerPaymentRequest = CreateSellerPaymentRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(LoanCustomerPaymentTypeEnum_1.LoanCustomerPaymentTypeEnum),
+    __metadata("design:type", String)
+], CreateSellerPaymentRequest.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], CreateSellerPaymentRequest.prototype, "expectedAmountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(2),
+    __metadata("design:type", Number)
+], CreateSellerPaymentRequest.prototype, "installmentCount", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(InStorePaymentMethodEnum_1.InStorePaymentMethodEnum),
+    __metadata("design:type", String)
+], CreateSellerPaymentRequest.prototype, "method", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => InStorePaymentDetail_1.InStorePaymentDetail),
+    __metadata("design:type", InStorePaymentDetail_1.InStorePaymentDetail)
+], CreateSellerPaymentRequest.prototype, "detail", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], CreateSellerPaymentRequest.prototype, "idempotencyKey", void 0);

package/bin/loanCredit/dtos/requests/InStorePaymentDetail.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Dato de la forma de pago anotada en tienda; solo valida la forma, nunca lleva CLABE.
+ * Qué campo exige cada método lo decide loan-credit (400 INVALID_PAYMENT_DETAIL).
+ */
+export declare class InStorePaymentDetail {
+    /** Tarjeta: últimos 4 dígitos. */
+    cardLast4?: string;
+    /** Tarjeta: número de autorización del voucher. */
+    authCode?: string;
+    /** SPEI: clave de rastreo. */
+    speiTrackingKey?: string;
+}