@fiado/type-kit 3.501.0 → 3.503.0

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

@@ -112,6 +112,25 @@ describe('loanCredit — contrato del cobro en tienda', () => {
         expect(item.mechanism).toBeUndefined();
     });
 
+    it('el historial lista todas las cuotas que cubrió el pago, en orden', () => {
+        const item: LoanPaymentListItem = {
+            paymentId: 'P-2',
+            receipt: 'SK-TD-0123456789ac',
+            installmentNumber: 3,
+            installmentNumbers: [3, 4],
+            attemptId: 'IN_STORE#k2',
+            result: 'FULL' as never,
+            currency: 'MXN' as never,
+            collectedCents: 97_400,
+            appliedCents: 97_400,
+            overpaidCents: 0,
+            reservedCents: 0,
+            needsReview: false,
+            appliedAt: '2026-10-08T17:00:00.000Z',
+        };
+        expect(item.installmentNumbers).toEqual([3, 4]);
+    });
+
     it('la fila de Clientes trae el último pago con su lugar', () => {
         const row: CreditCustomerListItem = {
             retailCustomerId: 'RC-1',

package/_test_/unit/platformRbac/dtos/CreateTenantUserRequest.test.ts

@@ -0,0 +1,31 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { CreateTenantUserRequest } from '../../../../src/platformRbac/dtos/CreateTenantUserRequest';
+import { PermissionScope } from '../../../../src/platformRbac/enums/PermissionScope';
+
+const base = { email: 'u@x.mx', displayName: 'U', createdBy: 'lambda:retail-integration-connector' };
+const grant = { roleId: 'vendedor', scope: PermissionScope.LEVEL_3, scopeRef: '12' };
+
+async function props(plain: Record<string, unknown>): Promise<string[]> {
+    return (await validate(plainToInstance(CreateTenantUserRequest, plain))).map((e) => e.property).sort();
+}
+
+describe('CreateTenantUserRequest — rol todos o ninguno', () => {
+    it('con rol completo es válido; suppressInvitation con rol se rechaza (sin rol es lo único que lo admite)', async () => {
+        expect(await props({ ...base, ...grant })).toEqual([]);
+        expect(await props({ ...base, ...grant, suppressInvitation: true })).toEqual(['suppressInvitation']);
+        expect(await props({ ...base, ...grant, suppressInvitation: false })).toEqual(['suppressInvitation']);
+    });
+
+    it('sin rol exige suppressInvitation: true', async () => {
+        expect(await props({ ...base, suppressInvitation: true })).toEqual([]);
+        expect(await props(base)).toEqual(['suppressInvitation']);
+        expect(await props({ ...base, suppressInvitation: false })).toEqual(['suppressInvitation']);
+    });
+
+    it('rol a medias es inválido', async () => {
+        expect(await props({ ...base, roleId: 'vendedor', suppressInvitation: true })).toEqual(['scope', 'scopeRef', 'suppressInvitation']);
+        expect(await props({ ...base, scopeRef: '12', suppressInvitation: true })).toEqual(['roleId', 'scope']);
+    });
+});

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

@@ -10,6 +10,7 @@ import {
 
 const base = {
     tenantId: 'surekeep',
+    retailerId: '01KXPB422AFGZHQKHVM7E5YDBR',
     eventId: 'evt_01J8ZA1B2C3D4E5F6G7H8J9K0L',
     occurredAt: '2026-08-01T15:00:00Z',
     payload: { storeId: '12' },
@@ -40,4 +41,14 @@ describe('DTOs del contrato connector → destino', () => {
             }
         },
     );
+
+    it.each([ApplyStoreEventRequest, ApplyRetailUserEventRequest, ApplyProductEventRequest, ApplyInventoryEventRequest])(
+        '%p exige retailerId no vacío',
+        async (cls) => {
+            const eventType = { ApplyStoreEventRequest: 'StoreCreatedV1', ApplyRetailUserEventRequest: 'RetailUserCreatedV1', ApplyProductEventRequest: 'ProductCreatedV1', ApplyInventoryEventRequest: 'InventoryMovementV1' }[cls.name];
+            for (const retailerId of [undefined, '', '   ']) {
+                expect(await propertiesWithErrors(cls, { ...base, eventType, retailerId })).toEqual(['retailerId']);
+            }
+        },
+    );
 });

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

@@ -0,0 +1,124 @@
+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';
+
+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)));
+}
+
+export const store = {
+    storeId: '12', code: 'T12', name: 'Sucursal Centro', zoneId: 'SUR',
+    address: { address1: 'Av. Juárez', externalNumber: '120', internalNumber: null, neighborhood: 'Centro', city: 'Toluca', state: 'Estado de México', zipCode: '50000', country: 'MX', reference: null },
+    location: { lat: 19.2826, lng: -99.6557 }, phone: '7221234567', schedule: 'Lun a Dom 10:00 a 20:00', status: 'ACTIVE',
+};
+
+export const user = {
+    retailUserId: '431', displayName: 'Grecia Cruz Mendoza', email: 'gcruz@ejemplo.mx', phone: null,
+    homeStoreId: '12', zoneId: null, role: 'SELLER', status: 'ACTIVE',
+};
+
+describe('StoreEventPayload', () => {
+    it('acepta el ejemplo del contrato', async () => {
+        expect(await errorsOf(StoreEventPayload, store)).toEqual([]);
+    });
+
+    it('acepta nullables en null y location nula', async () => {
+        expect(await errorsOf(StoreEventPayload, { ...store, zoneId: null, schedule: null, location: { lat: null, lng: null } })).toEqual([]);
+    });
+
+    it.each([
+        ['storeId', { storeId: 'a/b' }],
+        ['code', { code: 'ABCDEFGHIJK' }],
+        ['zoneId', { zoneId: 'NOZONE-R1' }],
+        ['schedule', { schedule: undefined }],
+        ['status', { status: 'OPEN' }],
+        ['address.zipCode', { address: { ...store.address, zipCode: '1' } }],
+        ['address.reference', { address: { ...store.address, reference: undefined } }],
+        ['location.lat', { location: { lat: 91, lng: 0 } }],
+    ])('rechaza %s', async (path, over) => {
+        expect(await errorsOf(StoreEventPayload, { ...store, ...over })).toContain(path);
+    });
+
+    it('rechaza el payload parcial del ejemplo de StoreCreatedV1', async () => {
+        const partial = { storeId: '12', code: 'T12', name: 'Sucursal Centro', status: 'ACTIVE' };
+        expect((await errorsOf(StoreEventPayload, partial)).length).toBeGreaterThan(0);
+    });
+});
+
+describe('RetailUserEventPayload', () => {
+    it('acepta el ejemplo del contrato', async () => {
+        expect(await errorsOf(RetailUserEventPayload, user)).toEqual([]);
+    });
+
+    it.each([
+        ['retailUserId', { retailUserId: '' }],
+        ['email', { email: 'no-es-correo' }],
+        ['phone', { phone: undefined }],
+        ['role', { role: 'ADMIN' }],
+        ['status', { status: 'BLOCKED' }],
+        ['zoneId', { zoneId: 'NOZONE-X' }],
+    ])('rechaza %s', async (path, over) => {
+        expect(await errorsOf(RetailUserEventPayload, { ...user, ...over })).toContain(path);
+    });
+});
+
+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',
+};
+
+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: [{ sku: 'MICA-A17', storeId: '12', qty: 39 }] };
+
+describe('ProductEventPayload', () => {
+    it('acepta un producto completo', async () => {
+        expect(await errorsOf(ProductEventPayload, product)).toEqual([]);
+    });
+
+    it.each([
+        ['sku', { sku: 'SAM_A17' }],
+        ['price.basePrice', { price: { ...product.price, basePrice: '4299' } }],
+        ['price.effectiveFrom', { price: { ...product.price, effectiveFrom: '2026-08-17T20:32:05' } }],
+        ['eligibleFinanciers', { eligibleFinanciers: ['NADIE'] }],
+        ['tier', { tier: undefined }],
+    ])('rechaza %s', async (path, over) => {
+        expect(await errorsOf(ProductEventPayload, { ...product, ...over })).toContain(path);
+    });
+});
+
+describe('InventoryEventPayload', () => {
+    it('acepta el ejemplo del contrato', async () => {
+        expect(await errorsOf(InventoryEventPayload, movement)).toEqual([]);
+    });
+
+    it('TRANSFER_OUT exige targetStoreId y los demás lo exigen null', async () => {
+        expect(await errorsOf(InventoryEventPayload, { ...movement, movementType: 'TRANSFER_OUT' })).toContain('targetStoreId');
+        expect(await errorsOf(InventoryEventPayload, { ...movement, movementType: 'TRANSFER_OUT', targetStoreId: '14', pieces: [{ ...piece, status: 'IN_TRANSIT' }] })).toEqual([]);
+        expect(await errorsOf(InventoryEventPayload, { ...movement, targetStoreId: '14' })).toContain('targetStoreId');
+    });
+
+    it('DAMAGED exige reason y los demás lo exigen null', async () => {
+        expect(await errorsOf(InventoryEventPayload, { ...movement, pieces: [{ ...piece, status: 'DAMAGED' }] })).toContain('pieces.0.reason');
+        expect(await errorsOf(InventoryEventPayload, { ...movement, pieces: [{ ...piece, reason: 'SHRINKAGE' }] })).toContain('pieces.0.reason');
+    });
+
+    it('rechaza identifier repetido, (storeId, sku) repetido y qty negativa', async () => {
+        expect(await errorsOf(InventoryEventPayload, { ...movement, pieces: [piece, piece] })).toContain('pieces');
+        const s = { sku: 'MICA-A17', storeId: '12', qty: 1 };
+        expect(await errorsOf(InventoryEventPayload, { ...movement, stock: [s, s] })).toContain('stock');
+        expect(await errorsOf(InventoryEventPayload, { ...movement, stock: [{ ...s, qty: -1 }] })).toContain('stock.0.qty');
+    });
+});

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

@@ -0,0 +1,34 @@
+import 'reflect-metadata';
+import { IsArray, Validate, validate } from 'class-validator';
+import { HasUniqueKeys, isNullOrValidated } from '../../../src/retailIntegration/validators/payloadValidators';
+import { RETAIL_ENTITY_ID_PATTERN, RETAIL_ZONE_ID_PATTERN, RETAIL_DECIMAL_PATTERN } from '../../../src/retailIntegration/constants/retailIntegrationLimits';
+
+class Holder {
+    @IsArray()
+    @Validate(HasUniqueKeys, ['storeId', 'sku'])
+    items!: Array<{ storeId: string; sku: string }>;
+}
+
+describe('validadores de payload', () => {
+    it('HasUniqueKeys rechaza una llave repetida', async () => {
+        const ok = Object.assign(new Holder(), { items: [{ storeId: '1', sku: 'A' }, { storeId: '2', sku: 'A' }] });
+        const dup = Object.assign(new Holder(), { items: [{ storeId: '1', sku: 'A' }, { storeId: '1', sku: 'A' }] });
+        expect(await validate(ok)).toHaveLength(0);
+        expect((await validate(dup)).map((e) => e.property)).toEqual(['items']);
+    });
+
+    it('isNullOrValidated solo salta la validación con null, no con la llave ausente', () => {
+        expect(isNullOrValidated({}, null)).toBe(false);
+        expect(isNullOrValidated({}, undefined)).toBe(true);
+        expect(isNullOrValidated({}, 'x')).toBe(true);
+    });
+
+    it('patrones', () => {
+        expect(RETAIL_ENTITY_ID_PATTERN.test('12')).toBe(true);
+        expect(RETAIL_ENTITY_ID_PATTERN.test('a/b')).toBe(false);
+        expect(RETAIL_ZONE_ID_PATTERN.test('SUR')).toBe(true);
+        expect(RETAIL_ZONE_ID_PATTERN.test('NOZONE-R1')).toBe(false);
+        expect(RETAIL_DECIMAL_PATTERN.test('4299.00')).toBe(true);
+        expect(RETAIL_DECIMAL_PATTERN.test('4299.0')).toBe(false);
+    });
+});

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

@@ -1,4 +1,5 @@
 import 'reflect-metadata';
+import { RetailEventRejectCodeEnum, RetailMovementTypeEnum } from '../../../src/retailIntegration/enums';
 import {
     RetailCurrencyEnum,
     RetailFinancierEnum,
@@ -40,3 +41,20 @@ describe('enums de los objetos del retailer', () => {
         expect(Object.values(enumObject)).toEqual(values);
     });
 });
+
+describe('codes y movimientos de los eventos del retailer', () => {
+    it('un solo enum de REJECTED para los 4 endpoints', () => {
+        expect(Object.values(RetailEventRejectCodeEnum).sort()).toEqual(
+            [
+                'EMAIL_ALREADY_IN_USE', 'FUTURE_PRICE_NOT_SUPPORTED', 'IDENTIFIER_CONFLICT', 'INVALID_IMEI',
+                'INVALID_PAYLOAD', 'RETAIL_USER_RETAILER_MISMATCH', 'SKU_NOT_STOCKABLE', 'SKU_OWNED_BY_BACKOFFICE',
+                'STORE_CODE_TAKEN', 'STORE_NOT_IN_RETAILER', 'STORE_RETAILER_MISMATCH', 'TRACKING_MODE_MISMATCH',
+                'UNSUPPORTED_CURRENCY',
+            ].sort(),
+        );
+    });
+
+    it('los 7 movementType del contrato', () => {
+        expect(Object.values(RetailMovementTypeEnum)).toEqual(['ENTRY', 'SALE', 'RETURN', 'ADJUSTMENT', 'TRANSFER_OUT', 'TRANSFER_IN', 'TRANSFER_CANCEL']);
+    });
+});

package/_test_/unit/retailOrg/dtos/Store.test.ts

@@ -66,4 +66,10 @@ describe('Store', () => {
         const errors = await validate(dto);
         expect(errors.some(e => e.property === 'status')).toBe(true);
     });
+
+    it('acepta managedByIntegration booleano y rechaza otro tipo', async () => {
+        expect(await validate(plainToInstance(Store, { ...valid, managedByIntegration: true }))).toEqual([]);
+        const errors = await validate(plainToInstance(Store, { ...valid, managedByIntegration: 'sí' }));
+        expect(errors.some((e) => e.property === 'managedByIntegration')).toBe(true);
+    });
 });

package/bin/loanCredit/dtos/responses/LoanPaymentListItem.d.ts

@@ -11,6 +11,8 @@ export interface LoanPaymentListItem {
     /** Folio del pago — la referencia de conciliación. */
     receipt: string;
     installmentNumber: number;
+    /** Todas las cuotas que cubrió el pago, ascendente; ausente en abono, liquidación y filas viejas (usar `installmentNumber`). */
+    installmentNumbers?: number[];
     attemptId: string;
     /** Ausente en los pagos en tienda: ahí no hubo motor. */
     mechanism?: MechanismType;

package/bin/platformRbac/dtos/CreateTenantUserRequest.d.ts

@@ -6,16 +6,18 @@ import { PermissionScope } from '../enums/PermissionScope';
  * Consumido por el alta de usuario orquestada de SureKeep F1 (retail-org → RBAC → RetailUser) vía api-invoker.
  * - Usuario provisionado en estado INVITED (mitiga orphan si el paso siguiente en retail-org falla).
  * - Idempotente por identidad Cognito.
- * - `scope`/`scopeRef` = grant del rol (ej. LEVEL_3 + storeId para un vendedor de tienda).
+ * - `roleId`/`scope`/`scopeRef`: todos o ninguno; sin rol no hay invitación.
  * - `createdBy` = cognitoSub del admin real (audit + grantedBy del assignment).
  * - `customFields` = valores de los campos personalizados del tenant; si el correo ya tiene usuario, se fusionan.
  */
 export declare class CreateTenantUserRequest {
     email: string;
     displayName?: string;
-    roleId: string;
-    scope: PermissionScope;
-    scopeRef: string;
+    roleId?: string;
+    scope?: PermissionScope;
+    scopeRef?: string;
+    /** Solo en el alta sin rol: no se manda invitación hasta que alguien asigne el primer rol. */
+    suppressInvitation?: boolean;
     createdBy: string;
     customFields?: {
         [key: string]: string;

package/bin/platformRbac/dtos/CreateTenantUserRequest.js

@@ -14,6 +14,8 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const PermissionScope_1 = require("../enums/PermissionScope");
 const IsStringValueRecord_1 = require("../../common/validators/IsStringValueRecord");
+const SuppressInvitationRequiredWithoutRole_1 = require("../validators/SuppressInvitationRequiredWithoutRole");
+const hasAnyGrantField = (o) => o.roleId !== undefined || o.scope !== undefined || o.scopeRef !== undefined;
 /**
  * Body del POST /internal/tenants/{tenantId}/users (endpoint privado, VPC/ANONIMUS). `tenantId` viaja en el path.
  * Provisiona Cognito + SharedUser + RoleAssignment (rol + scopeRef) en RBAC — reusa UserProvisioningService.
@@ -21,7 +23,7 @@ const IsStringValueRecord_1 = require("../../common/validators/IsStringValueReco
  * Consumido por el alta de usuario orquestada de SureKeep F1 (retail-org → RBAC → RetailUser) vía api-invoker.
  * - Usuario provisionado en estado INVITED (mitiga orphan si el paso siguiente en retail-org falla).
  * - Idempotente por identidad Cognito.
- * - `scope`/`scopeRef` = grant del rol (ej. LEVEL_3 + storeId para un vendedor de tienda).
+ * - `roleId`/`scope`/`scopeRef`: todos o ninguno; sin rol no hay invitación.
  * - `createdBy` = cognitoSub del admin real (audit + grantedBy del assignment).
  * - `customFields` = valores de los campos personalizados del tenant; si el correo ya tiene usuario, se fusionan.
  */
@@ -42,21 +44,29 @@ __decorate([
 ], CreateTenantUserRequest.prototype, "displayName", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)(hasAnyGrantField),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], CreateTenantUserRequest.prototype, "roleId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)(hasAnyGrantField),
     (0, class_validator_1.IsEnum)(PermissionScope_1.PermissionScope),
     __metadata("design:type", String)
 ], CreateTenantUserRequest.prototype, "scope", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)(hasAnyGrantField),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], CreateTenantUserRequest.prototype, "scopeRef", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Validate)(SuppressInvitationRequiredWithoutRole_1.SuppressInvitationRequiredWithoutRole),
+    __metadata("design:type", Boolean)
+], CreateTenantUserRequest.prototype, "suppressInvitation", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

package/bin/platformRbac/validators/SuppressInvitationRequiredWithoutRole.d.ts

@@ -0,0 +1,6 @@
+import { ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+/** Sin rol el alta exige `suppressInvitation: true`; con rol no se admite, porque el alta con rol siempre invita. */
+export declare class SuppressInvitationRequiredWithoutRole implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}

package/bin/platformRbac/validators/SuppressInvitationRequiredWithoutRole.js

@@ -0,0 +1,24 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SuppressInvitationRequiredWithoutRole = void 0;
+const class_validator_1 = require("class-validator");
+/** Sin rol el alta exige `suppressInvitation: true`; con rol no se admite, porque el alta con rol siempre invita. */
+let SuppressInvitationRequiredWithoutRole = class SuppressInvitationRequiredWithoutRole {
+    validate(value, args) {
+        const hasRole = args.object.roleId !== undefined;
+        return hasRole ? value === undefined : value === true;
+    }
+    defaultMessage() {
+        return 'suppressInvitation: true va solo y siempre en el alta sin rol';
+    }
+};
+exports.SuppressInvitationRequiredWithoutRole = SuppressInvitationRequiredWithoutRole;
+exports.SuppressInvitationRequiredWithoutRole = SuppressInvitationRequiredWithoutRole = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'suppressInvitationRequiredWithoutRole', async: false })
+], SuppressInvitationRequiredWithoutRole);

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

@@ -5,3 +5,16 @@ export declare const RETAIL_LIST_LIMIT_MIN = 1;
 export declare const RETAIL_LIST_LIMIT_MAX = 200;
 /** Forma válida de un `tenantId`; también arma el nombre del secreto del retailer. */
 export declare const RETAIL_TENANT_ID_PATTERN: RegExp;
+/** Id de tienda, usuario o zona del retailer: llave de DynamoDB y BYOID de RBAC. */
+export declare const RETAIL_ENTITY_ID_PATTERN: RegExp;
+/** Zona del retailer; `NOZONE-` queda reservado para la zona centinela de Fiado. */
+export declare const RETAIL_ZONE_ID_PATTERN: RegExp;
+/** Código corto de tienda: de 1 a 10 caracteres. */
+export declare const RETAIL_STORE_CODE_MAX_LENGTH = 10;
+/** Código postal: de 4 a 10 caracteres. */
+export declare const RETAIL_ZIP_CODE_MIN_LENGTH = 4;
+export declare const RETAIL_ZIP_CODE_MAX_LENGTH = 10;
+/** SKU del catálogo del retailer. */
+export declare const RETAIL_SKU_PATTERN: RegExp;
+/** Decimal del contrato: string con dos decimales, nunca negativo. */
+export declare const RETAIL_DECIMAL_PATTERN: RegExp;

package/bin/retailIntegration/constants/retailIntegrationLimits.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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_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. */
@@ -8,3 +8,16 @@ exports.RETAIL_LIST_LIMIT_MIN = 1;
 exports.RETAIL_LIST_LIMIT_MAX = 200;
 /** Forma válida de un `tenantId`; también arma el nombre del secreto del retailer. */
 exports.RETAIL_TENANT_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+/** Id de tienda, usuario o zona del retailer: llave de DynamoDB y BYOID de RBAC. */
+exports.RETAIL_ENTITY_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+/** Zona del retailer; `NOZONE-` queda reservado para la zona centinela de Fiado. */
+exports.RETAIL_ZONE_ID_PATTERN = /^(?!NOZONE-)[A-Za-z0-9_-]{1,64}$/;
+/** Código corto de tienda: de 1 a 10 caracteres. */
+exports.RETAIL_STORE_CODE_MAX_LENGTH = 10;
+/** Código postal: de 4 a 10 caracteres. */
+exports.RETAIL_ZIP_CODE_MIN_LENGTH = 4;
+exports.RETAIL_ZIP_CODE_MAX_LENGTH = 10;
+/** SKU del catálogo del retailer. */
+exports.RETAIL_SKU_PATTERN = /^[A-Za-z0-9-]{1,64}$/;
+/** Decimal del contrato: string con dos decimales, nunca negativo. */
+exports.RETAIL_DECIMAL_PATTERN = /^\d+\.\d{2}$/;

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

@@ -6,18 +6,26 @@ import { RetailEventResult } from './RetailEventResult';
 /** Evento de tienda que el connector manda a retail-org-business, con el tenant de la credencial. */
 export declare class ApplyStoreEventRequest extends ReceiveStoreEventRequest {
     tenantId: string;
+    /** Retailer de la conexión; lo pone el connector, nunca viene del payload. */
+    retailerId: string;
 }
 /** Evento de usuario que el connector manda a retail-org-business, con el tenant de la credencial. */
 export declare class ApplyRetailUserEventRequest extends ReceiveRetailUserEventRequest {
     tenantId: string;
+    /** Retailer de la conexión; lo pone el connector, nunca viene del payload. */
+    retailerId: string;
 }
 /** Evento de producto que el connector manda a retail-catalog-business, con el tenant de la credencial. */
 export declare class ApplyProductEventRequest extends ReceiveProductEventRequest {
     tenantId: string;
+    /** Retailer de la conexión; lo pone el connector, nunca viene del payload. */
+    retailerId: string;
 }
 /** Evento de inventario que el connector manda a retail-catalog-business, con el tenant de la credencial. */
 export declare class ApplyInventoryEventRequest extends ReceiveInventoryEventRequest {
     tenantId: string;
+    /** Retailer de la conexión; lo pone el connector, nunca viene del payload. */
+    retailerId: string;
 }
 /** Cualquiera de los cuatro eventos que el connector manda a un destino. */
 export type ApplyRetailEventRequest = ApplyStoreEventRequest | ApplyRetailUserEventRequest | ApplyProductEventRequest | ApplyInventoryEventRequest;

package/bin/retailIntegration/dtos/ApplyRetailEventRequest.js

@@ -25,6 +25,11 @@ __decorate([
     (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_TENANT_ID_PATTERN),
     __metadata("design:type", String)
 ], ApplyStoreEventRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/\S/),
+    __metadata("design:type", String)
+], ApplyStoreEventRequest.prototype, "retailerId", void 0);
 /** Evento de usuario que el connector manda a retail-org-business, con el tenant de la credencial. */
 class ApplyRetailUserEventRequest extends ReceiveRetailUserEventRequest_1.ReceiveRetailUserEventRequest {
 }
@@ -34,6 +39,11 @@ __decorate([
     (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_TENANT_ID_PATTERN),
     __metadata("design:type", String)
 ], ApplyRetailUserEventRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/\S/),
+    __metadata("design:type", String)
+], ApplyRetailUserEventRequest.prototype, "retailerId", void 0);
 /** Evento de producto que el connector manda a retail-catalog-business, con el tenant de la credencial. */
 class ApplyProductEventRequest extends ReceiveProductEventRequest_1.ReceiveProductEventRequest {
 }
@@ -43,6 +53,11 @@ __decorate([
     (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_TENANT_ID_PATTERN),
     __metadata("design:type", String)
 ], ApplyProductEventRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/\S/),
+    __metadata("design:type", String)
+], ApplyProductEventRequest.prototype, "retailerId", void 0);
 /** Evento de inventario que el connector manda a retail-catalog-business, con el tenant de la credencial. */
 class ApplyInventoryEventRequest extends ReceiveInventoryEventRequest_1.ReceiveInventoryEventRequest {
 }
@@ -52,3 +67,8 @@ __decorate([
     (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_TENANT_ID_PATTERN),
     __metadata("design:type", String)
 ], ApplyInventoryEventRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/\S/),
+    __metadata("design:type", String)
+], ApplyInventoryEventRequest.prototype, "retailerId", void 0);

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

@@ -0,0 +1,25 @@
+import { RetailMovementTypeEnum } from '../enums';
+import type { RetailPieceReason, RetailPieceStatus, RetailSystemPiece, RetailSystemStock } from '../models/RetailSystemInventory';
+export type RetailMovementType = `${RetailMovementTypeEnum}`;
+/** Pieza con IMEI o serie, como quedó después del movimiento. */
+export declare class PieceEventPayload implements RetailSystemPiece {
+    sku: string;
+    identifier: string;
+    storeId: string;
+    status: RetailPieceStatus;
+    reason: RetailPieceReason | null;
+}
+/** Existencia de un SKU por cantidad, como quedó después del movimiento. */
+export declare class StockEventPayload implements RetailSystemStock {
+    sku: string;
+    storeId: string;
+    qty: number;
+}
+/** Payload de `InventoryMovementV1`. */
+export declare class InventoryEventPayload {
+    movementType: RetailMovementType;
+    storeId: string;
+    targetStoreId: string | null;
+    pieces: PieceEventPayload[];
+    stock: StockEventPayload[];
+}

package/bin/retailIntegration/dtos/InventoryEventPayload.js

@@ -0,0 +1,94 @@
+"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.InventoryEventPayload = exports.StockEventPayload = exports.PieceEventPayload = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const retailIntegrationLimits_1 = require("../constants/retailIntegrationLimits");
+const enums_1 = require("../enums");
+const payloadValidators_1 = require("../validators/payloadValidators");
+/** Pieza con IMEI o serie, como quedó después del movimiento. */
+class PieceEventPayload {
+}
+exports.PieceEventPayload = PieceEventPayload;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_SKU_PATTERN),
+    __metadata("design:type", String)
+], PieceEventPayload.prototype, "sku", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/\S/),
+    __metadata("design:type", String)
+], PieceEventPayload.prototype, "identifier", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_ENTITY_ID_PATTERN),
+    __metadata("design:type", String)
+], PieceEventPayload.prototype, "storeId", void 0);
+__decorate([
+    (0, class_validator_1.IsIn)(Object.values(enums_1.RetailPieceStatusEnum)),
+    __metadata("design:type", String)
+], PieceEventPayload.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.Validate)(payloadValidators_1.ReasonMatchesStatus),
+    __metadata("design:type", String)
+], PieceEventPayload.prototype, "reason", void 0);
+/** Existencia de un SKU por cantidad, como quedó después del movimiento. */
+class StockEventPayload {
+}
+exports.StockEventPayload = StockEventPayload;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_SKU_PATTERN),
+    __metadata("design:type", String)
+], StockEventPayload.prototype, "sku", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_ENTITY_ID_PATTERN),
+    __metadata("design:type", String)
+], StockEventPayload.prototype, "storeId", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], StockEventPayload.prototype, "qty", void 0);
+/** Payload de `InventoryMovementV1`. */
+class InventoryEventPayload {
+}
+exports.InventoryEventPayload = InventoryEventPayload;
+__decorate([
+    (0, class_validator_1.IsIn)(Object.values(enums_1.RetailMovementTypeEnum)),
+    __metadata("design:type", String)
+], InventoryEventPayload.prototype, "movementType", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_ENTITY_ID_PATTERN),
+    __metadata("design:type", String)
+], InventoryEventPayload.prototype, "storeId", void 0);
+__decorate([
+    (0, class_validator_1.Validate)(payloadValidators_1.TargetStoreMatchesMovement),
+    __metadata("design:type", String)
+], InventoryEventPayload.prototype, "targetStoreId", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => PieceEventPayload),
+    (0, class_validator_1.Validate)(payloadValidators_1.HasUniqueKeys, ['identifier']),
+    __metadata("design:type", Array)
+], InventoryEventPayload.prototype, "pieces", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => StockEventPayload),
+    (0, class_validator_1.Validate)(payloadValidators_1.HasUniqueKeys, ['storeId', 'sku']),
+    __metadata("design:type", Array)
+], InventoryEventPayload.prototype, "stock", void 0);