@fiado/type-kit 3.584.0 → 3.586.0

package/_test_/unit/collection/disburseRequest.test.ts

@@ -26,6 +26,16 @@ describe('DisburseRequest', () => {
         expect(await invalidProperties(VALID)).toEqual([]);
     });
 
+    it('acepta disbursementType MEX_REWARD', async () => {
+        expect(await invalidProperties({ ...VALID, disbursementType: 'MEX_REWARD' })).toEqual([]);
+    });
+
+    it('acepta una idempotencyKey de 80 caracteres (sin límite de largo)', async () => {
+        const key = ('RW-' + 'a'.repeat(32) + '-' + 'k'.repeat(28) + '-12').padEnd(80, 'x');
+        expect(key).toHaveLength(80);
+        expect(await invalidProperties({ ...VALID, disbursementType: 'MEX_REWARD', idempotencyKey: key })).toEqual([]);
+    });
+
     it('reference es opcional', async () => {
         const { reference: _omit, ...withoutReference } = VALID;
         expect(await invalidProperties(withoutReference)).toEqual([]);

package/_test_/unit/collection/disbursementType.test.ts

@@ -3,8 +3,12 @@ import { Collection } from '../../../src/index';
 import { DisbursementType } from '../../../src/collection/index';
 
 describe('DisbursementType', () => {
-    it('trae los productos de bono y comisión de vendedor', () => {
-        expect(Object.values(DisbursementType)).toEqual(['MEX_BONUS', 'MEX_SELLER_COMMISSION']);
+    it('trae los productos de bono, comisión de vendedor y recompensa', () => {
+        expect(Object.values(DisbursementType)).toEqual(['MEX_BONUS', 'MEX_SELLER_COMMISSION', 'MEX_REWARD']);
+    });
+
+    it('MEX_REWARD vale MEX_REWARD', () => {
+        expect(DisbursementType.MEX_REWARD).toBe('MEX_REWARD');
     });
 
     it('cada clave es igual a su valor', () => {
@@ -16,5 +20,6 @@ describe('DisbursementType', () => {
     it('sale por el index raíz', () => {
         expect(Collection.DisbursementType.MEX_BONUS).toBe('MEX_BONUS');
         expect(Collection.DisbursementType.MEX_SELLER_COMMISSION).toBe('MEX_SELLER_COMMISSION');
+        expect(Collection.DisbursementType.MEX_REWARD).toBe('MEX_REWARD');
     });
 });

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

@@ -0,0 +1,24 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { UpdateTenantUserEmailRequest } from '../../../../src/platformRbac';
+
+function propsWithErrors(payload: object): string[] {
+    return validateSync(plainToInstance(UpdateTenantUserEmailRequest, payload)).map((e) => e.property);
+}
+
+describe('UpdateTenantUserEmailRequest', () => {
+    it('normaliza el correo a minúsculas sin espacios', () => {
+        const dto = plainToInstance(UpdateTenantUserEmailRequest, { email: '  Ana.Perez@Example.COM ', actedBy: 'retail-org-business' });
+        expect(dto.email).toBe('ana.perez@example.com');
+        expect(validateSync(dto)).toEqual([]);
+    });
+
+    it.each([undefined, '', 'no-es-correo', 42])('rechaza email=%p', (email) => {
+        expect(propsWithErrors({ email, actedBy: 'retail-org-business' })).toEqual(['email']);
+    });
+
+    it.each([undefined, '', 7])('rechaza actedBy=%p', (actedBy) => {
+        expect(propsWithErrors({ email: 'ana@example.com', actedBy })).toEqual(['actedBy']);
+    });
+});

package/_test_/unit/platformRbac/enums/__snapshots__/permissionBits.test.ts.snap

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://jestjs.io/docs/snapshot-testing
 
-exports[`PERMISSION_BIT_ORDER PERMS_VERSION es número estable 1`] = `2686516275`;
+exports[`PERMISSION_BIT_ORDER PERMS_VERSION es número estable 1`] = `1071810597`;
 
 exports[`PERMISSION_BIT_ORDER append-only: snapshot del ORDEN COMPLETO (rompe ante cualquier reorden/inserción) 1`] = `
 [
@@ -96,5 +96,6 @@ exports[`PERMISSION_BIT_ORDER append-only: snapshot del ORDEN COMPLETO (rompe an
   "platform.integration.key.revoke",
   "tenant.integration.diagnostic",
   "tenant.api_user.manage",
+  "platform.retail_integration.activate",
 ]
 `;

package/_test_/unit/platformRbac/enums/apiUserPermission.test.ts

@@ -5,7 +5,8 @@ describe('Permiso de administración de usuarios de API', () => {
         expect(Permission.TENANT_API_USER_MANAGE).toBe('tenant.api_user.manage');
     });
 
-    it('va al FINAL del orden de bits (append-only)', () => {
-        expect(PERMISSION_BIT_ORDER[PERMISSION_BIT_ORDER.length - 1]).toBe(Permission.TENANT_API_USER_MANAGE);
+    it('conserva su bit después de las integraciones M2M (append-only)', () => {
+        const index = PERMISSION_BIT_ORDER.indexOf(Permission.TENANT_API_USER_MANAGE);
+        expect(PERMISSION_BIT_ORDER[index - 1]).toBe(Permission.TENANT_INTEGRATION_DIAGNOSTIC);
     });
 });

package/_test_/unit/platformRbac/enums/retailIntegrationPermission.test.ts

@@ -0,0 +1,13 @@
+import { Permission, PERMISSION_BIT_ORDER } from '../../../../src/platformRbac/enums/Permission';
+
+describe('Permiso de activación de la integración retail', () => {
+    it('existe con la llave platform.retail_integration.activate (scope PLATFORM)', () => {
+        expect(Permission.PLATFORM_RETAIL_INTEGRATION_ACTIVATE).toBe('platform.retail_integration.activate');
+    });
+
+    it('va al FINAL del orden de bits, justo después de tenant.api_user.manage', () => {
+        const last = PERMISSION_BIT_ORDER.length - 1;
+        expect(PERMISSION_BIT_ORDER[last]).toBe(Permission.PLATFORM_RETAIL_INTEGRATION_ACTIVATE);
+        expect(PERMISSION_BIT_ORDER[last - 1]).toBe(Permission.TENANT_API_USER_MANAGE);
+    });
+});

package/_test_/unit/productCatalog/rewardEnums.test.ts

@@ -0,0 +1,19 @@
+import { ProductSubtypeEnum } from '../../../src/productCatalog/enums/ProductSubtypeEnum';
+import { ProductTypeEnum } from '../../../src/productCatalog/enums/ProductTypeEnum';
+
+describe('enums de recompensas del catálogo de productos', () => {
+    it('ProductSubtypeEnum.REWARD_MX vale "REWARD_MX"', () => {
+        expect(ProductSubtypeEnum.REWARD_MX).toBe('REWARD_MX');
+    });
+
+    it('ProductTypeEnum.REWARDS vale "REWARDS"', () => {
+        expect(ProductTypeEnum.REWARDS).toBe('REWARDS');
+    });
+
+    it('ningún otro miembro de ProductSubtypeEnum vale "REWARD_MX"', () => {
+        const colisiones = Object.entries(ProductSubtypeEnum).filter(
+            ([key, value]) => key !== 'REWARD_MX' && value === 'REWARD_MX',
+        );
+        expect(colisiones).toEqual([]);
+    });
+});

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

@@ -20,8 +20,8 @@ function propsWithErrors<T extends object>(cls: ClassConstructor<T>, payload: ob
 }
 
 describe('enums de la revisión', () => {
-  it('ReconciliationEntityEnum trae las cuatro entidades', () => {
-    expect(Object.values(ReconciliationEntityEnum)).toEqual(['STORES', 'USERS', 'CATALOG', 'INVENTORY']);
+  it('ReconciliationEntityEnum trae las cinco entidades', () => {
+    expect(Object.values(ReconciliationEntityEnum)).toEqual(['STORES', 'USERS', 'CATALOG', 'INVENTORY', 'MOVEMENTS']);
   });
 
   it('ReconciliationRunStatusEnum trae los cuatro estados de la corrida', () => {
@@ -29,7 +29,7 @@ describe('enums de la revisión', () => {
   });
 
   it('ReconciliationTriggerEnum distingue el reloj del botón', () => {
-    expect(Object.values(ReconciliationTriggerEnum)).toEqual(['SCHEDULED', 'MANUAL', 'ACTIVATION']);
+    expect(Object.values(ReconciliationTriggerEnum)).toEqual(['SCHEDULED', 'MANUAL', 'ACTIVATION', 'DISCREPANCY', 'DAILY']);
   });
 
   it('InactiveReasonEnum distingue la baja de la revisión de la del evento', () => {

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

@@ -0,0 +1,109 @@
+import 'reflect-metadata';
+import { plainToInstance, type ClassConstructor } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import {
+    GetRetailInventoryRequest,
+    type GetRetailInventoryResponse,
+    ListRetailInventoryMovementsRequest,
+    type ListRetailInventoryMovementsResponse,
+    ReconciliationEntityEnum,
+    ReconciliationPageMessage,
+    ReconciliationTriggerEnum,
+} from '../../../src/retailIntegration';
+
+function propsWithErrors<T extends object>(cls: ClassConstructor<T>, payload: object): string[] {
+    return validateSync(plainToInstance(cls, payload)).map((e) => e.property);
+}
+
+const tenant = { tenantId: 'surekeep', retailerId: 'ret-1' };
+
+describe('ListRetailInventoryMovementsRequest', () => {
+    const valid = { ...tenant, from: '2026-08-17T19:55:00Z', to: '2026-08-17T21:00:00Z' };
+
+    it('acepta el rango con y sin paginación', () => {
+        expect(propsWithErrors(ListRetailInventoryMovementsRequest, valid)).toEqual([]);
+        expect(propsWithErrors(ListRetailInventoryMovementsRequest, { ...valid, limit: '200', nextToken: 'abc', runId: 'run-1' })).toEqual([]);
+    });
+
+    it('acepta un rango de 7 días exactos', () => {
+        expect(propsWithErrors(ListRetailInventoryMovementsRequest, { ...tenant, from: '2026-08-10T00:00:00Z', to: '2026-08-17T00:00:00Z' })).toEqual([]);
+    });
+
+    it.each([
+        ['to igual a from', '2026-08-17T20:00:00Z', '2026-08-17T20:00:00Z'],
+        ['to antes de from', '2026-08-17T20:00:00Z', '2026-08-17T19:00:00Z'],
+        ['más de 7 días', '2026-08-10T00:00:00Z', '2026-08-17T00:00:01Z'],
+    ])('rechaza %s', (_label, from, to) => {
+        expect(propsWithErrors(ListRetailInventoryMovementsRequest, { ...tenant, from, to })).toEqual(['to']);
+    });
+
+    it.each(['from', 'to'])('rechaza sin %s o con fecha sin zona', (field) => {
+        const payload: Record<string, unknown> = { ...valid };
+        delete payload[field];
+        expect(propsWithErrors(ListRetailInventoryMovementsRequest, payload)).toContain(field);
+        expect(propsWithErrors(ListRetailInventoryMovementsRequest, { ...valid, [field]: '2026-08-17T20:00:00' })).toContain(field);
+    });
+
+    it.each(['0', '201'])('rechaza limit=%p', (limit) => {
+        expect(propsWithErrors(ListRetailInventoryMovementsRequest, { ...valid, limit })).toEqual(['limit']);
+    });
+
+    it('la respuesta trae items y meta de página', () => {
+        const response: ListRetailInventoryMovementsResponse = {
+            items: [
+                {
+                    eventId: 'evt-1',
+                    eventType: 'InventoryMovementV1',
+                    occurredAt: '2026-08-17T20:32:07Z',
+                    payload: { movementType: 'SALE', storeId: '12', targetStoreId: null, pieces: [], stock: [] },
+                },
+            ],
+            meta: { count: 1, nextToken: null },
+        };
+        expect(response.meta.nextToken).toBeNull();
+    });
+});
+
+describe('GetRetailInventoryRequest paginado', () => {
+    it('acepta limit y nextToken opcionales', () => {
+        expect(propsWithErrors(GetRetailInventoryRequest, { ...tenant, storeId: '12', limit: '50', nextToken: 'abc' })).toEqual([]);
+        expect(propsWithErrors(GetRetailInventoryRequest, { ...tenant, storeId: '12', limit: '0' })).toEqual(['limit']);
+    });
+
+    it('la respuesta admite meta.count y meta.nextToken', () => {
+        const response: GetRetailInventoryResponse = {
+            pieces: [],
+            stock: [],
+            meta: { storeId: '12', generatedAt: '2026-08-17T15:00:00Z', count: 0, nextToken: null },
+        };
+        expect(response.meta.count).toBe(0);
+    });
+});
+
+describe('enums de revisión para movimientos', () => {
+    it('ReconciliationEntityEnum suma MOVEMENTS', () => {
+        expect(ReconciliationEntityEnum.MOVEMENTS).toBe('MOVEMENTS');
+    });
+
+    it('ReconciliationTriggerEnum suma DISCREPANCY y DAILY', () => {
+        expect(ReconciliationTriggerEnum.DISCREPANCY).toBe('DISCREPANCY');
+        expect(ReconciliationTriggerEnum.DAILY).toBe('DAILY');
+    });
+});
+
+describe('ReconciliationPageMessage con cursor y rango', () => {
+    const base = { ...tenant, runId: 'run-1', pageIndex: 0 };
+
+    it('acepta nextToken en inventario y from/to en movimientos', () => {
+        expect(propsWithErrors(ReconciliationPageMessage, { ...base, entity: 'INVENTORY', storeId: '12', nextToken: 'abc' })).toEqual([]);
+        expect(
+            propsWithErrors(ReconciliationPageMessage, { ...base, entity: 'MOVEMENTS', from: '2026-08-17T19:55:00Z', to: '2026-08-17T21:00:00Z' }),
+        ).toEqual([]);
+    });
+
+    it('rechaza nextToken vacío y fechas sin zona', () => {
+        expect(propsWithErrors(ReconciliationPageMessage, { ...base, entity: 'INVENTORY', nextToken: '' })).toEqual(['nextToken']);
+        expect(propsWithErrors(ReconciliationPageMessage, { ...base, entity: 'MOVEMENTS', from: '2026-08-17' })).toEqual(['from']);
+        expect(propsWithErrors(ReconciliationPageMessage, { ...base, entity: 'MOVEMENTS', to: 'ayer' })).toEqual(['to']);
+    });
+});

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

@@ -0,0 +1,120 @@
+import 'reflect-metadata';
+import { plainToInstance, type ClassConstructor } from 'class-transformer';
+import { validateSync, type ValidationError } from 'class-validator';
+import {
+    RetailSystemErrorBody,
+    RetailSystemInventoryResponse,
+    RetailSystemMovementsResponse,
+    RetailSystemPageMeta,
+    RetailSystemPageResponse,
+    RetailSystemSaleResponse,
+} from '../../../src/retailIntegration';
+
+function errorPaths(errors: ValidationError[], prefix = ''): string[] {
+    return errors.flatMap((error) => {
+        const path = prefix ? `${prefix}.${error.property}` : error.property;
+        return error.children?.length ? errorPaths(error.children, path) : [path];
+    });
+}
+
+function pathsWithErrors<T extends object>(cls: ClassConstructor<T>, payload: object): string[] {
+    return errorPaths(validateSync(plainToInstance(cls, payload)));
+}
+
+const movement = {
+    eventId: 'evt_01J8ZE5M8Y2Q4R7T1V3W6X8Z1C',
+    eventType: 'InventoryMovementV1',
+    occurredAt: '2026-08-17T20:32:07Z',
+    payload: { movementType: 'SALE', storeId: '12', targetStoreId: null, pieces: [], stock: [] },
+};
+
+describe('RetailSystemPageMeta', () => {
+    it('acepta la última página y una intermedia', () => {
+        expect(pathsWithErrors(RetailSystemPageMeta, { count: 0, nextToken: null })).toEqual([]);
+        expect(pathsWithErrors(RetailSystemPageMeta, { count: 200, nextToken: 'eyJpZCI6MTQwMH0' })).toEqual([]);
+    });
+
+    it.each([-1, 1.5, '3', undefined])('rechaza count=%p', (count) => {
+        expect(pathsWithErrors(RetailSystemPageMeta, { count, nextToken: null })).toEqual(['count']);
+    });
+
+    it.each([undefined, 7, 'x'.repeat(2049)])('rechaza nextToken=%p', (nextToken) => {
+        expect(pathsWithErrors(RetailSystemPageMeta, { count: 1, nextToken })).toEqual(['nextToken']);
+    });
+});
+
+describe('RetailSystemPageResponse', () => {
+    it('acepta data con renglones crudos', () => {
+        expect(pathsWithErrors(RetailSystemPageResponse, { data: [{ any: 'row' }], meta: { count: 1, nextToken: null } })).toEqual([]);
+    });
+
+    it('rechaza data que no es arreglo y meta inválida', () => {
+        expect(pathsWithErrors(RetailSystemPageResponse, { data: {}, meta: { count: 1, nextToken: null } })).toEqual(['data']);
+        expect(pathsWithErrors(RetailSystemPageResponse, { data: [], meta: { count: -1, nextToken: null } })).toEqual(['meta.count']);
+        expect(pathsWithErrors(RetailSystemPageResponse, { data: [] })).toEqual(['meta']);
+    });
+});
+
+describe('RetailSystemInventoryResponse', () => {
+    const valid = {
+        data: { pieces: [{ sku: 'SAM-A17' }], stock: [] },
+        meta: { storeId: '12', generatedAt: '2026-08-17T15:00:00Z', count: 1, nextToken: null },
+    };
+
+    it('acepta una página del inventario', () => {
+        expect(pathsWithErrors(RetailSystemInventoryResponse, valid)).toEqual([]);
+    });
+
+    it('rechaza pieces o stock que no son arreglo', () => {
+        expect(pathsWithErrors(RetailSystemInventoryResponse, { ...valid, data: { pieces: null, stock: [] } })).toEqual(['data.pieces']);
+        expect(pathsWithErrors(RetailSystemInventoryResponse, { ...valid, data: { pieces: [] } })).toEqual(['data.stock']);
+    });
+
+    it.each([
+        ['storeId', 'tienda/12'],
+        ['generatedAt', '2026-08-17 15:00'],
+        ['count', -2],
+        ['nextToken', ''.padEnd(2049, 'a')],
+    ])('rechaza meta.%s inválido', (field, value) => {
+        expect(pathsWithErrors(RetailSystemInventoryResponse, { ...valid, meta: { ...valid.meta, [field]: value } })).toEqual([`meta.${field}`]);
+    });
+});
+
+describe('RetailSystemSaleResponse', () => {
+    it.each(['58812', 'SALE-12_a.b:c', 'a/b#ñ'])('acepta externalSaleId=%p', (externalSaleId) => {
+        expect(pathsWithErrors(RetailSystemSaleResponse, { externalSaleId })).toEqual([]);
+    });
+
+    it.each(['', 'con espacio', ' 58812', 'x'.repeat(65), 58812, undefined])('rechaza externalSaleId=%p', (externalSaleId) => {
+        expect(pathsWithErrors(RetailSystemSaleResponse, { externalSaleId })).toEqual(['externalSaleId']);
+    });
+});
+
+describe('RetailSystemErrorBody', () => {
+    it('acepta el error con y sin lineIndex', () => {
+        expect(pathsWithErrors(RetailSystemErrorBody, { code: 'IDENTIFIER_NOT_AVAILABLE', msg: 'texto', lineIndex: 1 })).toEqual([]);
+        expect(pathsWithErrors(RetailSystemErrorBody, { code: 'VALIDATION_ERROR' })).toEqual([]);
+    });
+
+    it('rechaza code ausente o largo y lineIndex fuera de rango', () => {
+        expect(pathsWithErrors(RetailSystemErrorBody, {})).toEqual(['code']);
+        expect(pathsWithErrors(RetailSystemErrorBody, { code: 'X'.repeat(65) })).toEqual(['code']);
+        expect(pathsWithErrors(RetailSystemErrorBody, { code: 'X', lineIndex: 1000 })).toEqual(['lineIndex']);
+        expect(pathsWithErrors(RetailSystemErrorBody, { code: 'X', lineIndex: -1 })).toEqual(['lineIndex']);
+    });
+});
+
+describe('RetailSystemMovementsResponse', () => {
+    it('acepta movimientos con el sobre del webhook', () => {
+        expect(pathsWithErrors(RetailSystemMovementsResponse, { data: [movement], meta: { count: 1, nextToken: null } })).toEqual([]);
+        expect(pathsWithErrors(RetailSystemMovementsResponse, { data: [], meta: { count: 0, nextToken: null } })).toEqual([]);
+    });
+
+    it('rechaza un movimiento con sobre inválido', () => {
+        const bad = { ...movement, eventType: 'StoreUpsertedV1', occurredAt: '2026-08-17' };
+        expect(pathsWithErrors(RetailSystemMovementsResponse, { data: [bad], meta: { count: 1, nextToken: null } }).sort()).toEqual([
+            'data.0.eventType',
+            'data.0.occurredAt',
+        ]);
+    });
+});

package/_test_/unit/rewards/enums.test.ts

@@ -29,7 +29,7 @@ describe('rewards: enums (los valores viajan por cola y por HTTP: no se renombra
   });
 
   it('GrantItemStatusEnum coincide con spec A 7.1', () => {
-    expect(Object.values(GrantItemStatusEnum).sort()).toEqual(['FAILED', 'GRANTED', 'PENDING', 'PROCESSING', 'SKIPPED']);
+    expect(Object.values(GrantItemStatusEnum).sort()).toEqual(['FAILED', 'GRANTED', 'PENDING', 'PROCESSING', 'SKIPPED', 'WAITING_LIMIT']);
   });
 
   it('ItemErrorCategoryEnum coincide con spec A §8', () => {

package/_test_/unit/rewards/waitingLimit.test.ts

@@ -0,0 +1,43 @@
+import 'reflect-metadata';
+import {
+    BackofficeGrantItemResponse,
+    GrantItemStatusEnum,
+    LimitWaitReasonEnum,
+    RewardItemCodeEnum,
+} from '../../../src/rewards/index';
+import { Rewards } from '../../../src/index';
+
+describe('espera por tope de nivel (WAITING_LIMIT)', () => {
+    it('GrantItemStatusEnum.WAITING_LIMIT vale WAITING_LIMIT', () => {
+        expect(GrantItemStatusEnum.WAITING_LIMIT).toBe('WAITING_LIMIT');
+    });
+
+    it('LimitWaitReasonEnum tiene exactamente los processorCode del spec', () => {
+        expect(LimitWaitReasonEnum.MONTHLY_AMOUNT_EXCEEDED).toBe('ACCOUNT_LEVEL_MAX_MONTHLY_AMOUNT_EXCEEDED');
+        expect(LimitWaitReasonEnum.AVAILABLE_BALANCE_EXCEEDED).toBe('ACCOUNT_LEVEL_MAX_AVAILABLE_BALANCE_EXCEEDED');
+        expect(Object.values(LimitWaitReasonEnum)).toHaveLength(2);
+    });
+
+    it('RewardItemCodeEnum contiene los tres códigos', () => {
+        expect(Object.values(RewardItemCodeEnum)).toEqual(
+            expect.arrayContaining(['AMOUNT_ABOVE_MAX', 'LIMIT_WAIT_EXPIRED', 'OUTCOME_UNKNOWN']),
+        );
+        expect(Object.values(RewardItemCodeEnum)).toHaveLength(3);
+    });
+
+    it('BackofficeGrantItemResponse acepta los campos de espera', () => {
+        const parcial = {
+            waitReason: LimitWaitReasonEnum.MONTHLY_AMOUNT_EXCEEDED,
+            retryNotBefore: 1_790_000_000_000,
+            waitingSince: 1_789_000_000_000,
+            limitRejections: 2,
+        } satisfies Partial<BackofficeGrantItemResponse>;
+        expect(parcial.limitRejections).toBe(2);
+    });
+
+    it('sale por el index raíz', () => {
+        expect(Rewards.GrantItemStatusEnum.WAITING_LIMIT).toBe('WAITING_LIMIT');
+        expect(Rewards.LimitWaitReasonEnum.AVAILABLE_BALANCE_EXCEEDED).toBeDefined();
+        expect(Rewards.RewardItemCodeEnum.OUTCOME_UNKNOWN).toBe('OUTCOME_UNKNOWN');
+    });
+});

package/bin/collection/enums/DisbursementType.d.ts

@@ -6,5 +6,7 @@ export declare enum DisbursementType {
     /** Bono. */
     MEX_BONUS = "MEX_BONUS",
     /** Comisión de vendedor. */
-    MEX_SELLER_COMMISSION = "MEX_SELLER_COMMISSION"
+    MEX_SELLER_COMMISSION = "MEX_SELLER_COMMISSION",
+    /** Abono de recompensas de `rewards-business`. */
+    MEX_REWARD = "MEX_REWARD"
 }

package/bin/collection/enums/DisbursementType.js

@@ -11,4 +11,6 @@ var DisbursementType;
     DisbursementType["MEX_BONUS"] = "MEX_BONUS";
     /** Comisión de vendedor. */
     DisbursementType["MEX_SELLER_COMMISSION"] = "MEX_SELLER_COMMISSION";
+    /** Abono de recompensas de `rewards-business`. */
+    DisbursementType["MEX_REWARD"] = "MEX_REWARD";
 })(DisbursementType || (exports.DisbursementType = DisbursementType = {}));

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

@@ -6,7 +6,8 @@ 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.
- * - `roleId`/`scope`/`scopeRef`: todos o ninguno; sin rol no hay invitación.
+ * - `roleId`/`scope`/`scopeRef`: todos o ninguno; sin rol exige `suppressInvitation: true`
+ *   y la invitación queda pendiente (`invitationPending`) hasta asignar el primer rol.
  * - `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.
  */

package/bin/platformRbac/dtos/CreateTenantUserRequest.js

@@ -23,7 +23,8 @@ const hasAnyGrantField = (o) => o.roleId !== undefined || o.scope !== undefined
  * 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.
- * - `roleId`/`scope`/`scopeRef`: todos o ninguno; sin rol no hay invitación.
+ * - `roleId`/`scope`/`scopeRef`: todos o ninguno; sin rol exige `suppressInvitation: true`
+ *   y la invitación queda pendiente (`invitationPending`) hasta asignar el primer rol.
  * - `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.
  */

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

@@ -0,0 +1,5 @@
+/** Body M2M que cambia el correo de un usuario del tenant; el correo se guarda en minúsculas. */
+export declare class UpdateTenantUserEmailRequest {
+    email: string;
+    actedBy: string;
+}

package/bin/platformRbac/dtos/UpdateTenantUserEmailRequest.js

@@ -0,0 +1,30 @@
+"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.UpdateTenantUserEmailRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Body M2M que cambia el correo de un usuario del tenant; el correo se guarda en minúsculas. */
+class UpdateTenantUserEmailRequest {
+}
+exports.UpdateTenantUserEmailRequest = UpdateTenantUserEmailRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.trim().toLowerCase() : value)),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], UpdateTenantUserEmailRequest.prototype, "email", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], UpdateTenantUserEmailRequest.prototype, "actedBy", void 0);

package/bin/platformRbac/enums/Permission.d.ts

@@ -120,7 +120,8 @@ export declare enum Permission {
     PLATFORM_INTEGRATION_KEY_ISSUE = "platform.integration.key.issue",
     PLATFORM_INTEGRATION_KEY_REVOKE = "platform.integration.key.revoke",
     TENANT_INTEGRATION_DIAGNOSTIC = "tenant.integration.diagnostic",
-    TENANT_API_USER_MANAGE = "tenant.api_user.manage"
+    TENANT_API_USER_MANAGE = "tenant.api_user.manage",
+    PLATFORM_RETAIL_INTEGRATION_ACTIVATE = "platform.retail_integration.activate"
 }
 /**
  * Orden CANÓNICO y APPEND-ONLY de los permisos para el bitset del token.

package/bin/platformRbac/enums/Permission.js

@@ -166,6 +166,8 @@ var Permission;
     Permission["TENANT_INTEGRATION_DIAGNOSTIC"] = "tenant.integration.diagnostic";
     // Alta, rotación de secreto y edición de IPs de usuarios de API; se exige además de tenant.user.create.
     Permission["TENANT_API_USER_MANAGE"] = "tenant.api_user.manage";
+    // Activa la integración de un retailer externo (Zentral); scope PLATFORM.
+    Permission["PLATFORM_RETAIL_INTEGRATION_ACTIVATE"] = "platform.retail_integration.activate";
 })(Permission || (exports.Permission = Permission = {}));
 /**
  * Orden CANÓNICO y APPEND-ONLY de los permisos para el bitset del token.
@@ -286,6 +288,7 @@ exports.PERMISSION_BIT_ORDER = [
     Permission.PLATFORM_INTEGRATION_KEY_REVOKE,
     Permission.TENANT_INTEGRATION_DIAGNOSTIC,
     Permission.TENANT_API_USER_MANAGE,
+    Permission.PLATFORM_RETAIL_INTEGRATION_ACTIVATE,
 ];
 function djb2(input) {
     let h = 5381;

package/bin/platformRbac/index.d.ts

@@ -73,6 +73,7 @@ export type { ListTenantUsersResponse } from './dtos/ListTenantUsersResponse';
 export type { TenantUserListItemResponse } from './dtos/TenantUserListItemResponse';
 export type { GetTenantUserResponse } from './dtos/GetTenantUserResponse';
 export * from './dtos/UpdateTenantUserRequest';
+export * from './dtos/UpdateTenantUserEmailRequest';
 export * from './dtos/DeleteTenantUserRequest';
 export * from './dtos/DisableTenantUserRequest';
 export * from './dtos/EnableTenantUserRequest';

package/bin/platformRbac/index.js

@@ -120,6 +120,7 @@ __exportStar(require("./dtos/UpdateIntegrationRequest"), exports);
 __exportStar(require("./dtos/UpdateLevelEntityRequest"), exports);
 __exportStar(require("./dtos/DeleteLevelEntityRequest"), exports);
 __exportStar(require("./dtos/UpdateTenantUserRequest"), exports);
+__exportStar(require("./dtos/UpdateTenantUserEmailRequest"), exports);
 __exportStar(require("./dtos/DeleteTenantUserRequest"), exports);
 __exportStar(require("./dtos/DisableTenantUserRequest"), exports);
 __exportStar(require("./dtos/EnableTenantUserRequest"), exports);

package/bin/productCatalog/enums/ProductSubtypeEnum.d.ts

@@ -60,6 +60,7 @@ export declare enum ProductSubtypeEnum {
     SP_CASH_IN_CASH_IN_OXXO = "CASH_IN_OXXO",
     SUREKEEP_BONUS_MX = "BONUS_MX",
     SUREKEEP_SELLER_COMMISSION_MX = "SELLER_COMMISSION_MX",
+    REWARD_MX = "REWARD_MX",
     STORE_PHONE = "PHONE",
     REFUND_PCF_DICTAMEN_PROCEDE = "DICTAMEN_PROCEDE",
     REFUND_PCF_AUTO_T2_SIN_2FA = "AUTO_T2_SIN_2FA",

package/bin/productCatalog/enums/ProductSubtypeEnum.js

@@ -77,6 +77,9 @@ var ProductSubtypeEnum;
     ProductSubtypeEnum["SUREKEEP_BONUS_MX"] = "BONUS_MX";
     // Comisión de vendedor de SureKeep abonada a la wallet.
     ProductSubtypeEnum["SUREKEEP_SELLER_COMMISSION_MX"] = "SELLER_COMMISSION_MX";
+    //REWARDS
+    // Abono de recompensas de `rewards-business`.
+    ProductSubtypeEnum["REWARD_MX"] = "REWARD_MX";
     //STORE
     ProductSubtypeEnum["STORE_PHONE"] = "PHONE";
     // REFUND_PCF

package/bin/productCatalog/enums/ProductTypeEnum.d.ts

@@ -63,5 +63,7 @@ export declare enum ProductTypeEnum {
      * Dispersión SPEI de liquidaciones de beneficios (money-transfer-connector).
      * Producto del catálogo para la orden STP que sale con `source=BENEFITS_SETTLEMENT`.
      */
-    MONEY_TRANSFER_SA = "MONEY_TRANSFER_SA"
+    MONEY_TRANSFER_SA = "MONEY_TRANSFER_SA",
+    /** Abono de recompensas de `rewards-business`. */
+    REWARDS = "REWARDS"
 }

package/bin/productCatalog/enums/ProductTypeEnum.js

@@ -68,4 +68,6 @@ var ProductTypeEnum;
      * Producto del catálogo para la orden STP que sale con `source=BENEFITS_SETTLEMENT`.
      */
     ProductTypeEnum["MONEY_TRANSFER_SA"] = "MONEY_TRANSFER_SA";
+    /** Abono de recompensas de `rewards-business`. */
+    ProductTypeEnum["REWARDS"] = "REWARDS";
 })(ProductTypeEnum || (exports.ProductTypeEnum = ProductTypeEnum = {}));

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

@@ -34,3 +34,14 @@ export declare const RETAIL_EVENT_STOCK_MAX = 200;
 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;
+/** Tope del `nextToken` opaco que devuelve Zentral. */
+export declare const RETAIL_NEXT_TOKEN_MAX_LENGTH = 2048;
+/** Id que asigna Zentral, como `externalSaleId`: no vacío, sin espacios y de a lo más 64. */
+export declare const RETAIL_EXTERNAL_ID_PATTERN: RegExp;
+/** Tope del `code` en el cuerpo de error de Zentral. */
+export declare const RETAIL_ERROR_CODE_MAX_LENGTH = 64;
+/** Rango de `lineIndex` en un error de línea de venta. */
+export declare const RETAIL_LINE_INDEX_MIN = 0;
+export declare const RETAIL_LINE_INDEX_MAX = 999;
+/** Rango máximo de `GET /inventory/movements`: 7 días en milisegundos. */
+export declare const RETAIL_MOVEMENTS_RANGE_MAX_MS: number;