@fiado/type-kit 3.644.0 → 3.646.0

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

@@ -31,3 +31,18 @@ describe('AuthorizeCollectionMovementRequest.tenantId', () => {
         expect(await invalidProperties({ ...VALID, tenantId: 42 })).toEqual(['tenantId']);
     });
 });
+
+describe('AuthorizeCollectionMovementRequest.costCenterId', () => {
+    it('es opcional', async () => {
+        expect(await invalidProperties(VALID)).toEqual([]);
+    });
+
+    it('acepta el centro de costo del producto', async () => {
+        expect(await invalidProperties({ ...VALID, costCenterId: 'SK-COBRANZA' })).toEqual([]);
+    });
+
+    it('rechaza costCenterId vacío o no string', async () => {
+        expect(await invalidProperties({ ...VALID, costCenterId: '' })).toEqual(['costCenterId']);
+        expect(await invalidProperties({ ...VALID, costCenterId: 42 })).toEqual(['costCenterId']);
+    });
+});

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

@@ -0,0 +1,54 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { CollectionProductConfigDto, UpsertProductConfigRequest } from '../../../src/collection/index';
+import { AuthorizeBonusRequest } from '../../../src/transactionProcessor/index';
+
+async function invalidProperties<T extends object>(cls: new () => T, body: Record<string, unknown>): Promise<string[]> {
+    return (await validate(plainToInstance(cls, body) as object)).map((e) => e.property);
+}
+
+const UPSERT = {
+    sources: [{ order: 1, wallet: 'MXN', currency: 'MXN', mechanism: 'MXN_DIRECT', provider: 'wallet' }],
+    allowPartial: false,
+    retryPolicy: { maxAttempts: 3, backoffSeconds: 60 },
+    reportTargets: [],
+};
+
+const CONFIG = {
+    ...UPSERT,
+    tenantId: 'surekeep',
+    productId: 'loan',
+    version: 1,
+    createdBy: 'system',
+    updatedBy: 'system',
+};
+
+const BONUS = {
+    idempotencyKey: 'bonus-1',
+    productCatalogId: 'cat-1',
+    amount: 50,
+    directoryId: 'dir-1',
+    concept: 'Bono SureKeep',
+};
+
+describe.each([
+    ['CollectionProductConfigDto', CollectionProductConfigDto, CONFIG],
+    ['UpsertProductConfigRequest', UpsertProductConfigRequest, UPSERT],
+    ['AuthorizeBonusRequest', AuthorizeBonusRequest, BONUS],
+] as const)('%s.costCenterId', (_name, cls, valid) => {
+    const klass = cls as unknown as new () => object;
+
+    it('es opcional', async () => {
+        expect(await invalidProperties(klass, valid)).toEqual([]);
+    });
+
+    it('acepta un centro de costo', async () => {
+        expect(await invalidProperties(klass, { ...valid, costCenterId: 'SK-COBRANZA' })).toEqual([]);
+    });
+
+    it('rechaza vacío o no string', async () => {
+        expect(await invalidProperties(klass, { ...valid, costCenterId: '' })).toEqual(['costCenterId']);
+        expect(await invalidProperties(klass, { ...valid, costCenterId: 3 })).toEqual(['costCenterId']);
+    });
+});

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

@@ -88,6 +88,36 @@ describe('DisburseRequest', () => {
         );
     });
 
+    describe('topup (MEX_REWARD_TOPUP)', () => {
+        const TOPUP_OK = { phone: '5512345678', moduleName: 'multicenter', benefitId: 'b1', leafId: 'l1', productId: 'p1' };
+        const TOPUP_TYPE = { ...VALID, disbursementType: 'MEX_REWARD_TOPUP' };
+
+        it('acepta MEX_REWARD_TOPUP con topup válido', async () => {
+            expect(await invalidProperties({ ...TOPUP_TYPE, topup: TOPUP_OK })).toEqual([]);
+        });
+
+        it('exige topup con MEX_REWARD_TOPUP', async () => {
+            expect(await invalidProperties(TOPUP_TYPE)).toContain('topup');
+        });
+
+        it.each(['551234567', '55123456789', '55123abc78', '+525512345678'])('rechaza phone %s', async (phone) => {
+            expect(await invalidProperties({ ...TOPUP_TYPE, topup: { ...TOPUP_OK, phone } })).toContain('topup');
+        });
+
+        it('rechaza leafId vacío', async () => {
+            expect(await invalidProperties({ ...TOPUP_TYPE, topup: { ...TOPUP_OK, leafId: '' } })).toContain('topup');
+        });
+
+        it('no exige topup a otros tipos y lo ignora si viene', async () => {
+            expect(await invalidProperties(VALID)).toEqual([]);
+            expect(await invalidProperties({ ...VALID, topup: TOPUP_OK })).toEqual([]);
+        });
+
+        it('acepta idempotencyKey de 64 caracteres (el límite de 60 lo aplica el processor)', async () => {
+            expect(await invalidProperties({ ...TOPUP_TYPE, topup: TOPUP_OK, idempotencyKey: 'k'.repeat(64) })).toEqual([]);
+        });
+    });
+
     it('sale por el index raíz', () => {
         expect(new Collection.DisburseRequest()).toBeInstanceOf(DisburseRequest);
         expect(new Collection.DisburseResponse()).toBeInstanceOf(DisburseResponse);
@@ -100,3 +130,18 @@ describe('DisburseResponse', () => {
         expect(await validate(plainToInstance(DisburseResponse, { transactionId: null }) as object)).toHaveLength(0);
     });
 });
+
+describe('DisburseRequest.costCenterId', () => {
+    it('es opcional', async () => {
+        expect(await invalidProperties(VALID)).toEqual([]);
+    });
+
+    it('acepta el centro de costo de quien dispersa', async () => {
+        expect(await invalidProperties({ ...VALID, costCenterId: 'SK-BONOS' })).toEqual([]);
+    });
+
+    it('rechaza vacío o no string', async () => {
+        expect(await invalidProperties({ ...VALID, costCenterId: '' })).toEqual(['costCenterId']);
+        expect(await invalidProperties({ ...VALID, costCenterId: 9 })).toEqual(['costCenterId']);
+    });
+});

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

@@ -4,13 +4,18 @@ import { DisbursementType } from '../../../src/collection/index';
 
 describe('DisbursementType', () => {
     it('trae los productos de bono, comisión de vendedor y recompensa', () => {
-        expect(Object.values(DisbursementType)).toEqual(['MEX_BONUS', 'MEX_SELLER_COMMISSION', 'MEX_REWARD']);
+        expect(Object.values(DisbursementType)).toEqual(['MEX_BONUS', 'MEX_SELLER_COMMISSION', 'MEX_REWARD', 'MEX_REWARD_TOPUP']);
     });
 
     it('MEX_REWARD vale MEX_REWARD', () => {
         expect(DisbursementType.MEX_REWARD).toBe('MEX_REWARD');
     });
 
+    it('MEX_REWARD_TOPUP vale MEX_REWARD_TOPUP', () => {
+        expect(DisbursementType.MEX_REWARD_TOPUP).toBe('MEX_REWARD_TOPUP');
+        expect(Object.values(DisbursementType)).toEqual(expect.arrayContaining(['MEX_BONUS', 'MEX_SELLER_COMMISSION', 'MEX_REWARD', 'MEX_REWARD_TOPUP']));
+    });
+
     it('cada clave es igual a su valor', () => {
         for (const [key, value] of Object.entries(DisbursementType)) {
             expect(key).toBe(value);
@@ -21,5 +26,6 @@ describe('DisbursementType', () => {
         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');
+        expect(Collection.DisbursementType.MEX_REWARD_TOPUP).toBe('MEX_REWARD_TOPUP');
     });
 });

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

@@ -0,0 +1,16 @@
+import { ProductSubtypeEnum } from '../../../src/productCatalog/enums/ProductSubtypeEnum';
+
+describe('ProductSubtypeEnum recarga de recompensa', () => {
+    it('REWARD_TOPUP_MX vale "REWARD_TOPUP_MX"', () => {
+        expect(ProductSubtypeEnum.REWARD_TOPUP_MX).toBe('REWARD_TOPUP_MX');
+    });
+
+    it('ningún otro miembro vale "REWARD_TOPUP_MX"', () => {
+        const others = Object.entries(ProductSubtypeEnum).filter(([key, value]) => value === 'REWARD_TOPUP_MX' && key !== 'REWARD_TOPUP_MX');
+        expect(others).toEqual([]);
+    });
+
+    it('REWARD_MX no cambia', () => {
+        expect(ProductSubtypeEnum.REWARD_MX).toBe('REWARD_MX');
+    });
+});

package/_test_/unit/reconciliation/reconciliationRequests.test.ts

@@ -206,6 +206,21 @@ describe('feed genérico de los dueños', () => {
         );
     });
 
+    it('costCenterIds es opcional y llega como csv del query', () => {
+        const base = { tenantId: 'surekeep', from: '2026-10-19T06:00:00.000Z', to: '2026-10-26T05:59:59.999Z' };
+        expect(errorsOf(PrivateListReconciliationFeedQuery, base)).toEqual([]);
+        expect(errorsOf(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: 'SK-COBRANZA, SK-BONOS' })).toEqual([]);
+        const dto = plainToInstance(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: 'SK-COBRANZA, SK-BONOS' }, { excludeExtraneousValues: true });
+        expect(dto.costCenterIds).toEqual(['SK-COBRANZA', 'SK-BONOS']);
+        expect(errorsOf(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: ['SK-COBRANZA'] })).toEqual([]);
+    });
+
+    it('costCenterIds rechaza elementos vacíos', () => {
+        const base = { tenantId: 'surekeep', from: '2026-10-19T06:00:00.000Z', to: '2026-10-26T05:59:59.999Z' };
+        expect(errorsOf(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: 'SK-COBRANZA,' })).toContain('costCenterIds');
+        expect(errorsOf(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: '' })).toContain('costCenterIds');
+    });
+
     it('el registro por recordId pide tenant y el servicio que llama; el actor es opcional', () => {
         expect(errorsOf(PrivateGetReconciliationFeedRecordQuery, { tenantId: 'surekeep', author: 'reconciliation-engine-business' })).toEqual(
             [],

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

@@ -0,0 +1,78 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+  BackofficeGrantItemResponse,
+  MobileTopupConfigRequest,
+  MobileTopupPlanResponse,
+  MobileTopupPlanStatusEnum,
+  MobileTopupRechargeStatusEnum,
+  RewardItemCodeEnum,
+} from '../../../src/rewards';
+
+const valid = { moduleName: 'm', benefitId: 'b', leafId: 'l', productId: 'p', monthlyPrice: 99.5 };
+
+describe('rewards mobile topup', () => {
+  it('enums con valores exactos', () => {
+    expect({ ...MobileTopupPlanStatusEnum }).toEqual({ ACTIVE: 'ACTIVE', NEEDS_ATTENTION: 'NEEDS_ATTENTION', DONE: 'DONE' });
+    expect({ ...MobileTopupRechargeStatusEnum }).toEqual({
+      PAID: 'PAID',
+      REJECTED: 'REJECTED',
+      UNCONFIRMED: 'UNCONFIRMED',
+      NOT_DELIVERED: 'NOT_DELIVERED',
+    });
+  });
+
+  it('RewardItemCodeEnum conserva los previos y agrega los nuevos', () => {
+    expect(RewardItemCodeEnum.TOPUP_REJECTED).toBe('TOPUP_REJECTED');
+    expect(RewardItemCodeEnum.ITEM_DISMISSED).toBe('ITEM_DISMISSED');
+    expect(RewardItemCodeEnum.AMOUNT_ABOVE_MAX).toBe('AMOUNT_ABOVE_MAX');
+    expect(RewardItemCodeEnum.LIMIT_WAIT_EXPIRED).toBe('LIMIT_WAIT_EXPIRED');
+    expect(RewardItemCodeEnum.OUTCOME_UNKNOWN).toBe('OUTCOME_UNKNOWN');
+  });
+
+  it('MobileTopupConfigRequest válido', async () => {
+    expect(await validate(plainToInstance(MobileTopupConfigRequest, valid))).toHaveLength(0);
+    expect(await validate(plainToInstance(MobileTopupConfigRequest, { ...valid, expectedVersion: 3 }))).toHaveLength(0);
+  });
+
+  it.each([
+    ['monthlyPrice 0', { monthlyPrice: 0 }],
+    ['monthlyPrice -1', { monthlyPrice: -1 }],
+    ['monthlyPrice 10.123', { monthlyPrice: 10.123 }],
+    ['moduleName vacío', { moduleName: '' }],
+    ['productId 101 chars', { productId: 'x'.repeat(101) }],
+    ['expectedVersion 0', { expectedVersion: 0 }],
+  ])('MobileTopupConfigRequest inválido: %s', async (_n, patch) => {
+    const errors = await validate(plainToInstance(MobileTopupConfigRequest, { ...valid, ...patch }));
+    expect(errors.length).toBeGreaterThanOrEqual(1);
+  });
+
+  it('MobileTopupPlanResponse completo compila', () => {
+    const plan = {
+      phone: '5512345678',
+      status: MobileTopupPlanStatusEnum.ACTIVE,
+      promised: 3,
+      done: 1,
+      pending: 2,
+      nextDueAt: 1,
+      lastRechargeAt: 1,
+      lastFolio: 'RW-g-i-M1',
+      failedAttempts: 0,
+      lastError: 'x',
+      closedUndelivered: 0,
+      closedBy: 'op',
+      closedAt: 1,
+      contributions: [{ grantId: 'g', itemKey: 'i', months: 3, sourceService: 's', sourceReference: 'r', campaignId: 'c', addedAt: 1 }],
+      recharges: [{ folio: 'RW-g-i-M1', rechargeNumber: 1, status: MobileTopupRechargeStatusEnum.PAID, at: 1, summary: 's' }],
+      updatedAt: 1,
+    } satisfies MobileTopupPlanResponse;
+    expect(plan.pending).toBe(2);
+  });
+
+  it('BackofficeGrantItemResponse acepta type opcional', () => {
+    const item = new BackofficeGrantItemResponse();
+    item.type = 'MOBILE_TOPUP';
+    expect(item.type).toBe('MOBILE_TOPUP');
+  });
+});

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

@@ -18,11 +18,11 @@ describe('espera por tope de nivel (WAITING_LIMIT)', () => {
         expect(Object.values(LimitWaitReasonEnum)).toHaveLength(2);
     });
 
-    it('RewardItemCodeEnum contiene los tres códigos', () => {
+    it('RewardItemCodeEnum contiene los cinco códigos', () => {
         expect(Object.values(RewardItemCodeEnum)).toEqual(
-            expect.arrayContaining(['AMOUNT_ABOVE_MAX', 'LIMIT_WAIT_EXPIRED', 'OUTCOME_UNKNOWN']),
+            expect.arrayContaining(['AMOUNT_ABOVE_MAX', 'LIMIT_WAIT_EXPIRED', 'OUTCOME_UNKNOWN', 'TOPUP_REJECTED', 'ITEM_DISMISSED']),
         );
-        expect(Object.values(RewardItemCodeEnum)).toHaveLength(3);
+        expect(Object.values(RewardItemCodeEnum)).toHaveLength(5);
     });
 
     it('BackofficeGrantItemResponse acepta los campos de espera', () => {

package/_test_/unit/transaction/transactionCreateRequestM8.test.ts

@@ -1,27 +1,42 @@
 import 'reflect-metadata';
 import { plainToInstance } from 'class-transformer';
 import { validateSync } from 'class-validator';
-import { TransactionCreateRequest } from '../../../src/transaction';
+import { TransactionCreateRequest, UNASSIGNED_COST_CENTER_ID } from '../../../src/transaction';
 
 function errorPropsOf(payload: Record<string, unknown>): string[] {
     return validateSync(plainToInstance(TransactionCreateRequest, payload)).map((e) => e.property);
 }
 
-describe('TransactionCreateRequest · executionId y tenant SOFOM', () => {
+describe('TransactionCreateRequest · executionId y centro de costo', () => {
     it('ambos son opcionales', () => {
         const props = errorPropsOf({});
         expect(props).not.toContain('executionId');
-        expect(props).not.toContain('sofomTenantId');
+        expect(props).not.toContain('costCenterId');
     });
 
     it('acepta strings no vacíos', () => {
-        const props = errorPropsOf({ executionId: 'exec-1', sofomTenantId: 'surekeep' });
+        const props = errorPropsOf({ executionId: 'exec-1', costCenterId: 'SK-COBRANZA' });
         expect(props).not.toContain('executionId');
-        expect(props).not.toContain('sofomTenantId');
+        expect(props).not.toContain('costCenterId');
+    });
+
+    it('acepta el centro de costo sin asignar', () => {
+        expect(errorPropsOf({ costCenterId: UNASSIGNED_COST_CENTER_ID })).not.toContain('costCenterId');
     });
 
     it('rechaza tipos que no son string o vacíos', () => {
         expect(errorPropsOf({ executionId: 12 })).toContain('executionId');
-        expect(errorPropsOf({ sofomTenantId: '' })).toContain('sofomTenantId');
+        expect(errorPropsOf({ costCenterId: '' })).toContain('costCenterId');
+        expect(errorPropsOf({ costCenterId: 7 })).toContain('costCenterId');
+    });
+
+    it('ya no declara el tenant SOFOM', () => {
+        expect(errorPropsOf({ sofomTenantId: '' })).not.toContain('sofomTenantId');
+    });
+});
+
+describe('UNASSIGNED_COST_CENTER_ID', () => {
+    it('es UNASSIGNED', () => {
+        expect(UNASSIGNED_COST_CENTER_ID).toBe('UNASSIGNED');
     });
 });

package/_test_/unit/transactionProcessor/authorizeRewardTopupRequest.test.ts

@@ -0,0 +1,59 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { TransactionProcessor } from '../../../src/index';
+import { AuthorizeRewardTopupRequest } from '../../../src/transactionProcessor/index';
+
+const VALID = {
+    idempotencyKey: 'RW-' + 'a'.repeat(32) + '-bait3m-M1',
+    directoryId: 'dir-1',
+    phone: '5512345678',
+    moduleName: 'multicenter',
+    benefitId: 'b1',
+    leafId: 'l1',
+    productId: 'p1',
+    amount: 15,
+    concept: 'Recarga Bait de recompensa',
+};
+
+async function invalidProperties(body: Record<string, unknown>): Promise<string[]> {
+    const dto = plainToInstance(AuthorizeRewardTopupRequest, body);
+    return (await validate(dto as object)).map((e) => e.property);
+}
+
+describe('AuthorizeRewardTopupRequest', () => {
+    it('acepta un request válido', async () => {
+        expect(await invalidProperties(VALID)).toEqual([]);
+        expect(VALID.idempotencyKey.length).toBeLessThanOrEqual(60);
+    });
+
+    it('acepta idempotencyKey de exactamente 60 y rechaza 61', async () => {
+        expect(await invalidProperties({ ...VALID, idempotencyKey: 'k'.repeat(60) })).toEqual([]);
+        expect(await invalidProperties({ ...VALID, idempotencyKey: 'k'.repeat(61) })).toContain('idempotencyKey');
+    });
+
+    it('rechaza idempotencyKey con #', async () => {
+        expect(await invalidProperties({ ...VALID, idempotencyKey: 'RW-a#b' })).toContain('idempotencyKey');
+    });
+
+    it.each([0, -1, 10.005])('rechaza amount %s', async (amount) => {
+        expect(await invalidProperties({ ...VALID, amount })).toContain('amount');
+    });
+
+    it('acepta amount 15 y 15.5', async () => {
+        expect(await invalidProperties({ ...VALID, amount: 15 })).not.toContain('amount');
+        expect(await invalidProperties({ ...VALID, amount: 15.5 })).not.toContain('amount');
+    });
+
+    it('rechaza phone de 9 dígitos', async () => {
+        expect(await invalidProperties({ ...VALID, phone: '551234567' })).toContain('phone');
+    });
+
+    it('rechaza concept de 121', async () => {
+        expect(await invalidProperties({ ...VALID, concept: 'c'.repeat(121) })).toContain('concept');
+    });
+
+    it('sale por el index raíz', () => {
+        expect(new TransactionProcessor.AuthorizeRewardTopupRequest()).toBeInstanceOf(AuthorizeRewardTopupRequest);
+    });
+});

package/_test_/unit/transactionProcessor/rewardTopupCodes.test.ts

@@ -0,0 +1,17 @@
+import { TransactionProcessorCodesEnum } from '../../../src/transactionProcessor/enums/TransactionProcessorCodesEnum';
+
+describe('TransactionProcessorCodesEnum recarga de recompensa', () => {
+    it.each([
+        'REWARD_TOPUP_PROVIDER_REJECTED',
+        'REWARD_TOPUP_UNAVAILABLE',
+        'REWARD_TOPUP_OUTCOME_UNKNOWN',
+        'REWARD_TOPUP_IN_FLIGHT',
+    ] as const)('%s vale su propio nombre', (code) => {
+        expect(TransactionProcessorCodesEnum[code]).toBe(code);
+    });
+
+    it('INVALID_REQUEST y TRANSACTION_APPROVED no cambian', () => {
+        expect(TransactionProcessorCodesEnum.INVALID_REQUEST).toBe('INVALID_REQUEST');
+        expect(TransactionProcessorCodesEnum.TRANSACTION_APPROVED).toBe('TRANSACTION_APPROVED');
+    });
+});

package/bin/collection/dtos/AuthorizeCollectionMovementRequest.d.ts

@@ -11,7 +11,16 @@ export declare class AuthorizeCollectionMovementRequest {
     intentId?: string;
     chargeId?: string;
     holdTxId?: string;
+    /**
+     * Tenant SOFOM del intento de cobro. Se conserva por compatibilidad con transaction-processor; el
+     * ledger ya no lo usa: la pertenencia contable del movimiento viaja en `costCenterId`.
+     */
     tenantId?: string;
+    /**
+     * Centro de costo del producto cobrado, tomado de su configuración en el motor. El processor lo
+     * escribe en la transacción del ledger; ausente, queda como `UNASSIGNED`.
+     */
+    costCenterId?: string;
     /**
      * Tarifa con la que se registra el cobro. Presente, el movimiento deja además una transacción
      * Fiado: asiento contable, historial visible para el cliente y comisión declarada. Ausente, el

package/bin/collection/dtos/AuthorizeCollectionMovementRequest.js

@@ -63,6 +63,12 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], AuthorizeCollectionMovementRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementRequest.prototype, "costCenterId", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.ValidateNested)(),

package/bin/collection/dtos/CollectionProductConfigDto.d.ts

@@ -17,6 +17,8 @@ export declare class CollectionProductConfigDto {
     allowPartial: boolean;
     retryPolicy: RetryPolicyDto;
     reportTargets: string[];
+    /** Centro de costo con el que el ledger registra los cobros de este producto. */
+    costCenterId?: string;
     createdBy: string;
     updatedBy: string;
 }

package/bin/collection/dtos/CollectionProductConfigDto.js

@@ -58,6 +58,12 @@ __decorate([
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
 ], CollectionProductConfigDto.prototype, "reportTargets", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CollectionProductConfigDto.prototype, "costCenterId", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/collection/dtos/DisburseRequest.d.ts

@@ -1,5 +1,6 @@
 import { CurrencyId } from '../../currency/enums/CurrencyId';
 import { DisbursementType } from '../enums/DisbursementType';
+import { DisburseTopupDetail } from './DisburseTopupDetail';
 /** Dispersión síncrona: el motor deposita `amount` pesos al titular por el riel de `disbursementType`. */
 export declare class DisburseRequest {
     tenantId: string;
@@ -17,4 +18,11 @@ export declare class DisburseRequest {
     concept: string;
     /** Id del llamador para rastreo: asiento, crédito. */
     reference?: string;
+    /**
+     * Centro de costo de la dispersión, tomado de la configuración de quien dispersa. El motor lo
+     * reenvía al processor en `AuthorizeBonusRequest.costCenterId`; ausente, el ledger escribe `UNASSIGNED`.
+     */
+    costCenterId?: string;
+    /** Datos de la recarga. Obligatorio si `disbursementType` es `MEX_REWARD_TOPUP`; en otros tipos se ignora. */
+    topup?: DisburseTopupDetail;
 }

package/bin/collection/dtos/DisburseRequest.js

@@ -10,9 +10,11 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DisburseRequest = void 0;
+const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const CurrencyId_1 = require("../../currency/enums/CurrencyId");
 const DisbursementType_1 = require("../enums/DisbursementType");
+const DisburseTopupDetail_1 = require("./DisburseTopupDetail");
 /** Dispersión síncrona: el motor deposita `amount` pesos al titular por el riel de `disbursementType`. */
 class DisburseRequest {
 }
@@ -62,3 +64,16 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], DisburseRequest.prototype, "reference", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], DisburseRequest.prototype, "costCenterId", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)((o) => o.disbursementType === DisbursementType_1.DisbursementType.MEX_REWARD_TOPUP),
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => DisburseTopupDetail_1.DisburseTopupDetail),
+    __metadata("design:type", DisburseTopupDetail_1.DisburseTopupDetail)
+], DisburseRequest.prototype, "topup", void 0);

package/bin/collection/dtos/DisburseTopupDetail.d.ts

@@ -0,0 +1,9 @@
+/** Datos de la recarga Bait de una dispersión `MEX_REWARD_TOPUP`. */
+export declare class DisburseTopupDetail {
+    /** Celular MX normalizado a 10 dígitos. */
+    phone: string;
+    moduleName: string;
+    benefitId: string;
+    leafId: string;
+    productId: string;
+}

package/bin/collection/dtos/DisburseTopupDetail.js

@@ -0,0 +1,46 @@
+"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.DisburseTopupDetail = void 0;
+const class_validator_1 = require("class-validator");
+/** Datos de la recarga Bait de una dispersión `MEX_REWARD_TOPUP`. */
+class DisburseTopupDetail {
+}
+exports.DisburseTopupDetail = DisburseTopupDetail;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/^[0-9]{10}$/),
+    __metadata("design:type", String)
+], DisburseTopupDetail.prototype, "phone", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], DisburseTopupDetail.prototype, "moduleName", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], DisburseTopupDetail.prototype, "benefitId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(256),
+    __metadata("design:type", String)
+], DisburseTopupDetail.prototype, "leafId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], DisburseTopupDetail.prototype, "productId", void 0);

package/bin/collection/dtos/UpsertProductConfigRequest.d.ts

@@ -9,4 +9,6 @@ export declare class UpsertProductConfigRequest {
     allowPartial: boolean;
     retryPolicy: RetryPolicyDto;
     reportTargets: string[];
+    /** Centro de costo con el que el ledger registra los cobros de este producto. */
+    costCenterId?: string;
 }

package/bin/collection/dtos/UpsertProductConfigRequest.js

@@ -41,3 +41,9 @@ __decorate([
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
 ], UpsertProductConfigRequest.prototype, "reportTargets", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], UpsertProductConfigRequest.prototype, "costCenterId", void 0);

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

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

package/bin/collection/enums/DisbursementType.js

@@ -13,4 +13,6 @@ var DisbursementType;
     DisbursementType["MEX_SELLER_COMMISSION"] = "MEX_SELLER_COMMISSION";
     /** Abono de recompensas de `rewards-business`. */
     DisbursementType["MEX_REWARD"] = "MEX_REWARD";
+    /** Recarga Bait de recompensas de `rewards-business`. */
+    DisbursementType["MEX_REWARD_TOPUP"] = "MEX_REWARD_TOPUP";
 })(DisbursementType || (exports.DisbursementType = DisbursementType = {}));

package/bin/collection/index.d.ts

@@ -30,6 +30,7 @@ export * from './dtos/RegisterCollectibleResponse';
 export * from './dtos/CollectionPricingDto';
 export * from './dtos/ResolvePendingChargesRequest';
 export * from './dtos/MoneyInEvent';
+export * from './dtos/DisburseTopupDetail';
 export * from './dtos/DisburseRequest';
 export * from './dtos/DisburseResponse';
 export * from './dtos/CollectionIntentSummaryDto';

package/bin/collection/index.js

@@ -49,6 +49,7 @@ __exportStar(require("./dtos/RegisterCollectibleResponse"), exports);
 __exportStar(require("./dtos/CollectionPricingDto"), exports);
 __exportStar(require("./dtos/ResolvePendingChargesRequest"), exports);
 __exportStar(require("./dtos/MoneyInEvent"), exports);
+__exportStar(require("./dtos/DisburseTopupDetail"), exports);
 __exportStar(require("./dtos/DisburseRequest"), exports);
 __exportStar(require("./dtos/DisburseResponse"), exports);
 // DTOs — backoffice de monitoreo

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

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