@fiado/type-kit 3.644.0 → 3.645.0

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);

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/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/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/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,6 @@ export declare class DisburseRequest {
     concept: string;
     /** Id del llamador para rastreo: asiento, crédito. */
     reference?: 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,10 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], DisburseRequest.prototype, "reference", 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/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",

package/bin/productCatalog/enums/ProductSubtypeEnum.js

@@ -80,6 +80,8 @@ var ProductSubtypeEnum;
     //REWARDS
     // Abono de recompensas de `rewards-business`.
     ProductSubtypeEnum["REWARD_MX"] = "REWARD_MX";
+    // Recarga Bait de recompensas de `rewards-business`.
+    ProductSubtypeEnum["REWARD_TOPUP_MX"] = "REWARD_TOPUP_MX";
     //STORE
     ProductSubtypeEnum["STORE_PHONE"] = "PHONE";
     // REFUND_PCF

package/bin/rewards/dtos/backoffice/BackofficeGrantItemResponse.d.ts

@@ -4,6 +4,8 @@ import { BackofficeGrantAttemptResponse } from './BackofficeGrantAttemptResponse
 export declare class BackofficeGrantItemResponse extends GrantItemResponse {
     /** Nombre de la recompensa congelada en la entrega. */
     name: string;
+    /** Tipo de recompensa congelado en la entrega (ej. `'MOBILE_TOPUP'`). */
+    type?: string;
     attempts: BackofficeGrantAttemptResponse[];
     /** Motivo de la espera por tope; solo cuando el ítem está en `WAITING_LIMIT`. */
     waitReason?: LimitWaitReasonEnum;

package/bin/rewards/dtos/backoffice/MobileTopupConfigRequest.d.ts

@@ -0,0 +1,10 @@
+/** Guarda la configuración de la recarga Bait (producto en Multicenter y precio mensual). */
+export declare class MobileTopupConfigRequest {
+    moduleName: string;
+    benefitId: string;
+    leafId: string;
+    productId: string;
+    monthlyPrice: number;
+    /** Candado optimista: versión que el operador vio al editar. */
+    expectedVersion?: number;
+}

package/bin/rewards/dtos/backoffice/MobileTopupConfigRequest.js

@@ -0,0 +1,59 @@
+"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.MobileTopupConfigRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Guarda la configuración de la recarga Bait (producto en Multicenter y precio mensual). */
+class MobileTopupConfigRequest {
+}
+exports.MobileTopupConfigRequest = MobileTopupConfigRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(100),
+    __metadata("design:type", String)
+], MobileTopupConfigRequest.prototype, "moduleName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(100),
+    __metadata("design:type", String)
+], MobileTopupConfigRequest.prototype, "benefitId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(100),
+    __metadata("design:type", String)
+], MobileTopupConfigRequest.prototype, "leafId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(100),
+    __metadata("design:type", String)
+], MobileTopupConfigRequest.prototype, "productId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 2 }),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], MobileTopupConfigRequest.prototype, "monthlyPrice", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], MobileTopupConfigRequest.prototype, "expectedVersion", void 0);

package/bin/rewards/dtos/backoffice/MobileTopupConfigResponse.d.ts

@@ -0,0 +1,15 @@
+export interface MobileTopupConfigResponse {
+    moduleName: string;
+    benefitId: string;
+    leafId: string;
+    productId: string;
+    monthlyPrice: number;
+    currency: 'MXN';
+    version: number;
+    updatedBy: string;
+    updatedAt: number;
+    /** Ítems del catálogo `MOBILE_TOPUP` recalculados al guardar. */
+    repricedItems?: number;
+    /** Ítems omitidos por conflicto de versión. */
+    skippedItems?: number;
+}

package/bin/rewards/dtos/backoffice/MobileTopupConfigResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/rewards/dtos/backoffice/MobileTopupContributionResponse.d.ts

@@ -0,0 +1,9 @@
+export interface MobileTopupContributionResponse {
+    grantId: string;
+    itemKey: string;
+    months: number;
+    sourceService: string;
+    sourceReference: string;
+    campaignId?: string;
+    addedAt: number;
+}

package/bin/rewards/dtos/backoffice/MobileTopupContributionResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/rewards/dtos/backoffice/MobileTopupPlanListResponse.d.ts

@@ -0,0 +1,5 @@
+import { MobileTopupPlanResponse } from './MobileTopupPlanResponse';
+export interface MobileTopupPlanListResponse {
+    items: MobileTopupPlanResponse[];
+    truncated: boolean;
+}

package/bin/rewards/dtos/backoffice/MobileTopupPlanListResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/rewards/dtos/backoffice/MobileTopupPlanResponse.d.ts

@@ -0,0 +1,22 @@
+import { MobileTopupPlanStatusEnum } from '../../enums/MobileTopupPlanStatusEnum';
+import { MobileTopupContributionResponse } from './MobileTopupContributionResponse';
+import { MobileTopupRechargeResponse } from './MobileTopupRechargeResponse';
+/** Calendario de recargas Bait de un número. */
+export interface MobileTopupPlanResponse {
+    phone: string;
+    status: MobileTopupPlanStatusEnum;
+    promised: number;
+    done: number;
+    pending: number;
+    nextDueAt?: number;
+    lastRechargeAt?: number;
+    lastFolio?: string;
+    failedAttempts: number;
+    lastError?: string;
+    closedUndelivered?: number;
+    closedBy?: string;
+    closedAt?: number;
+    contributions: MobileTopupContributionResponse[];
+    recharges?: MobileTopupRechargeResponse[];
+    updatedAt: number;
+}

package/bin/rewards/dtos/backoffice/MobileTopupPlanResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/rewards/dtos/backoffice/MobileTopupRechargeResponse.d.ts

@@ -0,0 +1,8 @@
+import { MobileTopupRechargeStatusEnum } from '../../enums/MobileTopupRechargeStatusEnum';
+export interface MobileTopupRechargeResponse {
+    folio: string;
+    rechargeNumber: number;
+    status: MobileTopupRechargeStatusEnum;
+    at: number;
+    summary?: string;
+}

package/bin/rewards/dtos/backoffice/MobileTopupRechargeResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/rewards/enums/MobileTopupPlanStatusEnum.d.ts

@@ -0,0 +1,6 @@
+/** Estado del calendario de recargas Bait de un número. */
+export declare enum MobileTopupPlanStatusEnum {
+    ACTIVE = "ACTIVE",
+    NEEDS_ATTENTION = "NEEDS_ATTENTION",
+    DONE = "DONE"
+}

package/bin/rewards/enums/MobileTopupPlanStatusEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MobileTopupPlanStatusEnum = void 0;
+/** Estado del calendario de recargas Bait de un número. */
+var MobileTopupPlanStatusEnum;
+(function (MobileTopupPlanStatusEnum) {
+    MobileTopupPlanStatusEnum["ACTIVE"] = "ACTIVE";
+    MobileTopupPlanStatusEnum["NEEDS_ATTENTION"] = "NEEDS_ATTENTION";
+    MobileTopupPlanStatusEnum["DONE"] = "DONE";
+})(MobileTopupPlanStatusEnum || (exports.MobileTopupPlanStatusEnum = MobileTopupPlanStatusEnum = {}));

package/bin/rewards/enums/MobileTopupRechargeStatusEnum.d.ts

@@ -0,0 +1,7 @@
+/** Resultado de una recarga mensual del calendario. */
+export declare enum MobileTopupRechargeStatusEnum {
+    PAID = "PAID",
+    REJECTED = "REJECTED",
+    UNCONFIRMED = "UNCONFIRMED",
+    NOT_DELIVERED = "NOT_DELIVERED"
+}

package/bin/rewards/enums/MobileTopupRechargeStatusEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MobileTopupRechargeStatusEnum = void 0;
+/** Resultado de una recarga mensual del calendario. */
+var MobileTopupRechargeStatusEnum;
+(function (MobileTopupRechargeStatusEnum) {
+    MobileTopupRechargeStatusEnum["PAID"] = "PAID";
+    MobileTopupRechargeStatusEnum["REJECTED"] = "REJECTED";
+    MobileTopupRechargeStatusEnum["UNCONFIRMED"] = "UNCONFIRMED";
+    MobileTopupRechargeStatusEnum["NOT_DELIVERED"] = "NOT_DELIVERED";
+})(MobileTopupRechargeStatusEnum || (exports.MobileTopupRechargeStatusEnum = MobileTopupRechargeStatusEnum = {}));

package/bin/rewards/enums/RewardItemCodeEnum.d.ts

@@ -5,5 +5,9 @@ export declare enum RewardItemCodeEnum {
     /** Venció la espera por tope (30 días desde `waitingSince`). */
     LIMIT_WAIT_EXPIRED = "LIMIT_WAIT_EXPIRED",
     /** Resultado desconocido agotado: no se puede asegurar si el abono ocurrió. */
-    OUTCOME_UNKNOWN = "OUTCOME_UNKNOWN"
+    OUTCOME_UNKNOWN = "OUTCOME_UNKNOWN",
+    /** Bait rechazó la recarga de forma permanente: queda en atención del operador. */
+    TOPUP_REJECTED = "TOPUP_REJECTED",
+    /** Un operador dio el ítem por fallido. */
+    ITEM_DISMISSED = "ITEM_DISMISSED"
 }

package/bin/rewards/enums/RewardItemCodeEnum.js

@@ -10,4 +10,8 @@ var RewardItemCodeEnum;
     RewardItemCodeEnum["LIMIT_WAIT_EXPIRED"] = "LIMIT_WAIT_EXPIRED";
     /** Resultado desconocido agotado: no se puede asegurar si el abono ocurrió. */
     RewardItemCodeEnum["OUTCOME_UNKNOWN"] = "OUTCOME_UNKNOWN";
+    /** Bait rechazó la recarga de forma permanente: queda en atención del operador. */
+    RewardItemCodeEnum["TOPUP_REJECTED"] = "TOPUP_REJECTED";
+    /** Un operador dio el ítem por fallido. */
+    RewardItemCodeEnum["ITEM_DISMISSED"] = "ITEM_DISMISSED";
 })(RewardItemCodeEnum || (exports.RewardItemCodeEnum = RewardItemCodeEnum = {}));

package/bin/rewards/index.d.ts

@@ -12,6 +12,8 @@ export * from './enums/RewardsErrorCodeEnum';
 export * from './enums/DeliveryDimensionEnum';
 export * from './enums/DeliveryTopDimensionEnum';
 export * from './enums/DeliveryTopByEnum';
+export * from './enums/MobileTopupPlanStatusEnum';
+export * from './enums/MobileTopupRechargeStatusEnum';
 export * from './types/RewardInputs';
 export * from './dtos/RewardCost';
 export * from './dtos/RewardChargeTo';
@@ -56,3 +58,9 @@ export * from './dtos/backoffice/DeliveryMetricsQuery';
 export * from './dtos/backoffice/DeliveryTopQuery';
 export * from './dtos/backoffice/DeliveryMetricsPoint';
 export * from './dtos/backoffice/DeliveryTopEntry';
+export * from './dtos/backoffice/MobileTopupConfigRequest';
+export * from './dtos/backoffice/MobileTopupConfigResponse';
+export * from './dtos/backoffice/MobileTopupContributionResponse';
+export * from './dtos/backoffice/MobileTopupRechargeResponse';
+export * from './dtos/backoffice/MobileTopupPlanResponse';
+export * from './dtos/backoffice/MobileTopupPlanListResponse';

package/bin/rewards/index.js

@@ -29,6 +29,8 @@ __exportStar(require("./enums/RewardsErrorCodeEnum"), exports);
 __exportStar(require("./enums/DeliveryDimensionEnum"), exports);
 __exportStar(require("./enums/DeliveryTopDimensionEnum"), exports);
 __exportStar(require("./enums/DeliveryTopByEnum"), exports);
+__exportStar(require("./enums/MobileTopupPlanStatusEnum"), exports);
+__exportStar(require("./enums/MobileTopupRechargeStatusEnum"), exports);
 //Types
 __exportStar(require("./types/RewardInputs"), exports);
 //DTOs
@@ -81,3 +83,9 @@ __exportStar(require("./dtos/backoffice/DeliveryMetricsQuery"), exports);
 __exportStar(require("./dtos/backoffice/DeliveryTopQuery"), exports);
 __exportStar(require("./dtos/backoffice/DeliveryMetricsPoint"), exports);
 __exportStar(require("./dtos/backoffice/DeliveryTopEntry"), exports);
+__exportStar(require("./dtos/backoffice/MobileTopupConfigRequest"), exports);
+__exportStar(require("./dtos/backoffice/MobileTopupConfigResponse"), exports);
+__exportStar(require("./dtos/backoffice/MobileTopupContributionResponse"), exports);
+__exportStar(require("./dtos/backoffice/MobileTopupRechargeResponse"), exports);
+__exportStar(require("./dtos/backoffice/MobileTopupPlanResponse"), exports);
+__exportStar(require("./dtos/backoffice/MobileTopupPlanListResponse"), exports);

package/bin/transactionProcessor/dtos/AuthorizeRewardTopupRequest.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pago de una recarga Bait de recompensa (`MEX_REWARD_TOPUP`). No toca ninguna wallet.
+ *
+ * `idempotencyKey` ≤ 60: el folio del proveedor admite 64 y se reservan 4 caracteres para el
+ * sufijo `-{k}` del folio por intento.
+ */
+export declare class AuthorizeRewardTopupRequest {
+    idempotencyKey: string;
+    /** Titular beneficiario de la recompensa. */
+    directoryId: string;
+    /** Celular MX normalizado a 10 dígitos. */
+    phone: string;
+    moduleName: string;
+    benefitId: string;
+    leafId: string;
+    productId: string;
+    /** En PESOS, no centavos. */
+    amount: number;
+    concept: string;
+}
+export default AuthorizeRewardTopupRequest;

package/bin/transactionProcessor/dtos/AuthorizeRewardTopupRequest.js

@@ -0,0 +1,74 @@
+"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.AuthorizeRewardTopupRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Pago de una recarga Bait de recompensa (`MEX_REWARD_TOPUP`). No toca ninguna wallet.
+ *
+ * `idempotencyKey` ≤ 60: el folio del proveedor admite 64 y se reservan 4 caracteres para el
+ * sufijo `-{k}` del folio por intento.
+ */
+class AuthorizeRewardTopupRequest {
+}
+exports.AuthorizeRewardTopupRequest = AuthorizeRewardTopupRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(60),
+    (0, class_validator_1.Matches)(/^[^#]+$/),
+    __metadata("design:type", String)
+], AuthorizeRewardTopupRequest.prototype, "idempotencyKey", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AuthorizeRewardTopupRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/^[0-9]{10}$/),
+    __metadata("design:type", String)
+], AuthorizeRewardTopupRequest.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)
+], AuthorizeRewardTopupRequest.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)
+], AuthorizeRewardTopupRequest.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)
+], AuthorizeRewardTopupRequest.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)
+], AuthorizeRewardTopupRequest.prototype, "productId", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 2 }),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], AuthorizeRewardTopupRequest.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], AuthorizeRewardTopupRequest.prototype, "concept", void 0);
+exports.default = AuthorizeRewardTopupRequest;

package/bin/transactionProcessor/enums/TransactionProcessorCodesEnum.d.ts

@@ -19,5 +19,13 @@ export declare enum TransactionProcessorCodesEnum {
     BLOCKED_SECRET_NUMBER = "BLOCKED_SECRET_NUMBER",
     PROVIDER_NOT_FOUND = "PROVIDER_NOT_FOUND",
     /** El request no cumple el contrato del DTO. Nada tocó saldo. */
-    INVALID_REQUEST = "INVALID_REQUEST"
+    INVALID_REQUEST = "INVALID_REQUEST",
+    /** Recarga de recompensa: el proveedor la rechazó de forma permanente (o se agotaron los intentos de folio). */
+    REWARD_TOPUP_PROVIDER_REJECTED = "REWARD_TOPUP_PROVIDER_REJECTED",
+    /** Recarga de recompensa: rechazo transitorio del proveedor; reintentable con la misma llave. */
+    REWARD_TOPUP_UNAVAILABLE = "REWARD_TOPUP_UNAVAILABLE",
+    /** Recarga de recompensa: resultado desconocido (timeout/PENDING); no se repaga. */
+    REWARD_TOPUP_OUTCOME_UNKNOWN = "REWARD_TOPUP_OUTCOME_UNKNOWN",
+    /** Recarga de recompensa: la llave de idempotencia sigue en vuelo. */
+    REWARD_TOPUP_IN_FLIGHT = "REWARD_TOPUP_IN_FLIGHT"
 }

package/bin/transactionProcessor/enums/TransactionProcessorCodesEnum.js

@@ -24,4 +24,12 @@ var TransactionProcessorCodesEnum;
     TransactionProcessorCodesEnum["PROVIDER_NOT_FOUND"] = "PROVIDER_NOT_FOUND";
     /** El request no cumple el contrato del DTO. Nada tocó saldo. */
     TransactionProcessorCodesEnum["INVALID_REQUEST"] = "INVALID_REQUEST";
+    /** Recarga de recompensa: el proveedor la rechazó de forma permanente (o se agotaron los intentos de folio). */
+    TransactionProcessorCodesEnum["REWARD_TOPUP_PROVIDER_REJECTED"] = "REWARD_TOPUP_PROVIDER_REJECTED";
+    /** Recarga de recompensa: rechazo transitorio del proveedor; reintentable con la misma llave. */
+    TransactionProcessorCodesEnum["REWARD_TOPUP_UNAVAILABLE"] = "REWARD_TOPUP_UNAVAILABLE";
+    /** Recarga de recompensa: resultado desconocido (timeout/PENDING); no se repaga. */
+    TransactionProcessorCodesEnum["REWARD_TOPUP_OUTCOME_UNKNOWN"] = "REWARD_TOPUP_OUTCOME_UNKNOWN";
+    /** Recarga de recompensa: la llave de idempotencia sigue en vuelo. */
+    TransactionProcessorCodesEnum["REWARD_TOPUP_IN_FLIGHT"] = "REWARD_TOPUP_IN_FLIGHT";
 })(TransactionProcessorCodesEnum || (exports.TransactionProcessorCodesEnum = TransactionProcessorCodesEnum = {}));

package/bin/transactionProcessor/index.d.ts

@@ -11,6 +11,7 @@ export * from './dtos/AuthorizeSpeiBankTransferNcRequest';
 export * from './dtos/AuthorizeCollectorTransactionRequest';
 export * from './dtos/AuthorizeDisputeTransactionRequest';
 export * from './dtos/AuthorizeBonusRequest';
+export * from './dtos/AuthorizeRewardTopupRequest';
 export * from './dtos/CardInfo';
 export * from './dtos/InstallmentsInfo';
 export * from './dtos/MerchantInfo';

package/bin/transactionProcessor/index.js

@@ -27,6 +27,7 @@ __exportStar(require("./dtos/AuthorizeSpeiBankTransferNcRequest"), exports);
 __exportStar(require("./dtos/AuthorizeCollectorTransactionRequest"), exports);
 __exportStar(require("./dtos/AuthorizeDisputeTransactionRequest"), exports);
 __exportStar(require("./dtos/AuthorizeBonusRequest"), exports);
+__exportStar(require("./dtos/AuthorizeRewardTopupRequest"), exports);
 __exportStar(require("./dtos/CardInfo"), exports);
 __exportStar(require("./dtos/InstallmentsInfo"), exports);
 __exportStar(require("./dtos/MerchantInfo"), exports);

package/package.json

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

package/src/collection/dtos/DisburseRequest.ts

@@ -1,6 +1,8 @@
-import { IsEnum, IsIn, IsNotEmpty, IsNumber, IsOptional, IsPositive, IsString, Matches, MaxLength } from 'class-validator';
+import { Type } from 'class-transformer';
+import { IsDefined, IsEnum, IsIn, IsNotEmpty, IsNumber, IsOptional, IsPositive, IsString, Matches, MaxLength, ValidateIf, ValidateNested } from 'class-validator';
 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 class DisburseRequest {
@@ -27,4 +29,11 @@ export class DisburseRequest {
 
     /** Id del llamador para rastreo: asiento, crédito. */
     @IsOptional() @IsString() reference?: string;
+
+    /** Datos de la recarga. Obligatorio si `disbursementType` es `MEX_REWARD_TOPUP`; en otros tipos se ignora. */
+    @ValidateIf((o: DisburseRequest) => o.disbursementType === DisbursementType.MEX_REWARD_TOPUP)
+    @IsDefined()
+    @ValidateNested()
+    @Type(() => DisburseTopupDetail)
+    topup?: DisburseTopupDetail;
 }

package/src/collection/dtos/DisburseTopupDetail.ts

@@ -0,0 +1,15 @@
+import { IsNotEmpty, IsString, Matches, MaxLength } from 'class-validator';
+
+/** Datos de la recarga Bait de una dispersión `MEX_REWARD_TOPUP`. */
+export class DisburseTopupDetail {
+    /** Celular MX normalizado a 10 dígitos. */
+    @IsString() @Matches(/^[0-9]{10}$/) phone!: string;
+
+    @IsString() @IsNotEmpty() @MaxLength(64) moduleName!: string;
+
+    @IsString() @IsNotEmpty() @MaxLength(64) benefitId!: string;
+
+    @IsString() @IsNotEmpty() @MaxLength(256) leafId!: string;
+
+    @IsString() @IsNotEmpty() @MaxLength(64) productId!: string;
+}

package/src/collection/enums/DisbursementType.ts

@@ -9,4 +9,6 @@ export enum DisbursementType {
     MEX_SELLER_COMMISSION = 'MEX_SELLER_COMMISSION',
     /** Abono de recompensas de `rewards-business`. */
     MEX_REWARD = 'MEX_REWARD',
+    /** Recarga Bait de recompensas de `rewards-business`. */
+    MEX_REWARD_TOPUP = 'MEX_REWARD_TOPUP',
 }

package/src/collection/index.ts

@@ -35,6 +35,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';
 

package/src/productCatalog/enums/ProductSubtypeEnum.ts

@@ -89,6 +89,8 @@ export enum ProductSubtypeEnum {
     //REWARDS
     // Abono de recompensas de `rewards-business`.
     REWARD_MX = "REWARD_MX",
+    // Recarga Bait de recompensas de `rewards-business`.
+    REWARD_TOPUP_MX = "REWARD_TOPUP_MX",
 
     //STORE
     STORE_PHONE = "PHONE",

package/src/rewards/dtos/backoffice/BackofficeGrantItemResponse.ts

@@ -5,6 +5,8 @@ import { BackofficeGrantAttemptResponse } from './BackofficeGrantAttemptResponse
 export class BackofficeGrantItemResponse extends GrantItemResponse {
     /** Nombre de la recompensa congelada en la entrega. */
     name: string;
+    /** Tipo de recompensa congelado en la entrega (ej. `'MOBILE_TOPUP'`). */
+    type?: string;
     attempts: BackofficeGrantAttemptResponse[];
     /** Motivo de la espera por tope; solo cuando el ítem está en `WAITING_LIMIT`. */
     waitReason?: LimitWaitReasonEnum;

package/src/rewards/dtos/backoffice/MobileTopupConfigRequest.ts

@@ -0,0 +1,41 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsNumber, IsOptional, IsPositive, IsString, MaxLength, Min } from 'class-validator';
+
+/** Guarda la configuración de la recarga Bait (producto en Multicenter y precio mensual). */
+export class MobileTopupConfigRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(100)
+    moduleName: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(100)
+    benefitId: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(100)
+    leafId: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(100)
+    productId: string;
+
+    @Expose()
+    @IsNumber({ maxDecimalPlaces: 2 })
+    @IsPositive()
+    monthlyPrice: number;
+
+    /** Candado optimista: versión que el operador vio al editar. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    expectedVersion?: number;
+}

package/src/rewards/dtos/backoffice/MobileTopupConfigResponse.ts

@@ -0,0 +1,15 @@
+export interface MobileTopupConfigResponse {
+    moduleName: string;
+    benefitId: string;
+    leafId: string;
+    productId: string;
+    monthlyPrice: number;
+    currency: 'MXN';
+    version: number;
+    updatedBy: string;
+    updatedAt: number;
+    /** Ítems del catálogo `MOBILE_TOPUP` recalculados al guardar. */
+    repricedItems?: number;
+    /** Ítems omitidos por conflicto de versión. */
+    skippedItems?: number;
+}

package/src/rewards/dtos/backoffice/MobileTopupContributionResponse.ts

@@ -0,0 +1,9 @@
+export interface MobileTopupContributionResponse {
+    grantId: string;
+    itemKey: string;
+    months: number;
+    sourceService: string;
+    sourceReference: string;
+    campaignId?: string;
+    addedAt: number;
+}

package/src/rewards/dtos/backoffice/MobileTopupPlanListResponse.ts

@@ -0,0 +1,6 @@
+import { MobileTopupPlanResponse } from './MobileTopupPlanResponse';
+
+export interface MobileTopupPlanListResponse {
+    items: MobileTopupPlanResponse[];
+    truncated: boolean;
+}

package/src/rewards/dtos/backoffice/MobileTopupPlanResponse.ts

@@ -0,0 +1,23 @@
+import { MobileTopupPlanStatusEnum } from '../../enums/MobileTopupPlanStatusEnum';
+import { MobileTopupContributionResponse } from './MobileTopupContributionResponse';
+import { MobileTopupRechargeResponse } from './MobileTopupRechargeResponse';
+
+/** Calendario de recargas Bait de un número. */
+export interface MobileTopupPlanResponse {
+    phone: string;
+    status: MobileTopupPlanStatusEnum;
+    promised: number;
+    done: number;
+    pending: number;
+    nextDueAt?: number;
+    lastRechargeAt?: number;
+    lastFolio?: string;
+    failedAttempts: number;
+    lastError?: string;
+    closedUndelivered?: number;
+    closedBy?: string;
+    closedAt?: number;
+    contributions: MobileTopupContributionResponse[];
+    recharges?: MobileTopupRechargeResponse[];
+    updatedAt: number;
+}

package/src/rewards/dtos/backoffice/MobileTopupRechargeResponse.ts

@@ -0,0 +1,9 @@
+import { MobileTopupRechargeStatusEnum } from '../../enums/MobileTopupRechargeStatusEnum';
+
+export interface MobileTopupRechargeResponse {
+    folio: string;
+    rechargeNumber: number;
+    status: MobileTopupRechargeStatusEnum;
+    at: number;
+    summary?: string;
+}

package/src/rewards/enums/MobileTopupPlanStatusEnum.ts

@@ -0,0 +1,6 @@
+/** Estado del calendario de recargas Bait de un número. */
+export enum MobileTopupPlanStatusEnum {
+    ACTIVE = 'ACTIVE',
+    NEEDS_ATTENTION = 'NEEDS_ATTENTION',
+    DONE = 'DONE',
+}

package/src/rewards/enums/MobileTopupRechargeStatusEnum.ts

@@ -0,0 +1,7 @@
+/** Resultado de una recarga mensual del calendario. */
+export enum MobileTopupRechargeStatusEnum {
+    PAID = 'PAID',
+    REJECTED = 'REJECTED',
+    UNCONFIRMED = 'UNCONFIRMED',
+    NOT_DELIVERED = 'NOT_DELIVERED',
+}

package/src/rewards/enums/RewardItemCodeEnum.ts

@@ -6,4 +6,8 @@ export enum RewardItemCodeEnum {
     LIMIT_WAIT_EXPIRED = 'LIMIT_WAIT_EXPIRED',
     /** Resultado desconocido agotado: no se puede asegurar si el abono ocurrió. */
     OUTCOME_UNKNOWN = 'OUTCOME_UNKNOWN',
+    /** Bait rechazó la recarga de forma permanente: queda en atención del operador. */
+    TOPUP_REJECTED = 'TOPUP_REJECTED',
+    /** Un operador dio el ítem por fallido. */
+    ITEM_DISMISSED = 'ITEM_DISMISSED',
 }

package/src/rewards/index.ts

@@ -13,6 +13,8 @@ export * from './enums/RewardsErrorCodeEnum';
 export * from './enums/DeliveryDimensionEnum';
 export * from './enums/DeliveryTopDimensionEnum';
 export * from './enums/DeliveryTopByEnum';
+export * from './enums/MobileTopupPlanStatusEnum';
+export * from './enums/MobileTopupRechargeStatusEnum';
 
 //Types
 export * from './types/RewardInputs';
@@ -73,3 +75,9 @@ export * from './dtos/backoffice/DeliveryMetricsQuery';
 export * from './dtos/backoffice/DeliveryTopQuery';
 export * from './dtos/backoffice/DeliveryMetricsPoint';
 export * from './dtos/backoffice/DeliveryTopEntry';
+export * from './dtos/backoffice/MobileTopupConfigRequest';
+export * from './dtos/backoffice/MobileTopupConfigResponse';
+export * from './dtos/backoffice/MobileTopupContributionResponse';
+export * from './dtos/backoffice/MobileTopupRechargeResponse';
+export * from './dtos/backoffice/MobileTopupPlanResponse';
+export * from './dtos/backoffice/MobileTopupPlanListResponse';

package/src/transactionProcessor/dtos/AuthorizeRewardTopupRequest.ts

@@ -0,0 +1,44 @@
+import { IsNotEmpty, IsNumber, IsPositive, IsString, Matches, MaxLength } from 'class-validator';
+
+/**
+ * Pago de una recarga Bait de recompensa (`MEX_REWARD_TOPUP`). No toca ninguna wallet.
+ *
+ * `idempotencyKey` ≤ 60: el folio del proveedor admite 64 y se reservan 4 caracteres para el
+ * sufijo `-{k}` del folio por intento.
+ */
+export class AuthorizeRewardTopupRequest {
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(60)
+    @Matches(/^[^#]+$/)
+    idempotencyKey: string;
+
+    /** Titular beneficiario de la recompensa. */
+    @IsString()
+    @IsNotEmpty()
+    directoryId: string;
+
+    /** Celular MX normalizado a 10 dígitos. */
+    @IsString()
+    @Matches(/^[0-9]{10}$/)
+    phone: string;
+
+    @IsString() @IsNotEmpty() @MaxLength(64) moduleName: string;
+
+    @IsString() @IsNotEmpty() @MaxLength(64) benefitId: string;
+
+    @IsString() @IsNotEmpty() @MaxLength(256) leafId: string;
+
+    @IsString() @IsNotEmpty() @MaxLength(64) productId: string;
+
+    /** En PESOS, no centavos. */
+    @IsNumber({ maxDecimalPlaces: 2 })
+    @IsPositive()
+    amount: number;
+
+    @IsString()
+    @MaxLength(120)
+    concept: string;
+}
+
+export default AuthorizeRewardTopupRequest;

package/src/transactionProcessor/enums/TransactionProcessorCodesEnum.ts

@@ -20,4 +20,12 @@ export enum TransactionProcessorCodesEnum {
     PROVIDER_NOT_FOUND = "PROVIDER_NOT_FOUND",
     /** El request no cumple el contrato del DTO. Nada tocó saldo. */
     INVALID_REQUEST = "INVALID_REQUEST",
+    /** Recarga de recompensa: el proveedor la rechazó de forma permanente (o se agotaron los intentos de folio). */
+    REWARD_TOPUP_PROVIDER_REJECTED = "REWARD_TOPUP_PROVIDER_REJECTED",
+    /** Recarga de recompensa: rechazo transitorio del proveedor; reintentable con la misma llave. */
+    REWARD_TOPUP_UNAVAILABLE = "REWARD_TOPUP_UNAVAILABLE",
+    /** Recarga de recompensa: resultado desconocido (timeout/PENDING); no se repaga. */
+    REWARD_TOPUP_OUTCOME_UNKNOWN = "REWARD_TOPUP_OUTCOME_UNKNOWN",
+    /** Recarga de recompensa: la llave de idempotencia sigue en vuelo. */
+    REWARD_TOPUP_IN_FLIGHT = "REWARD_TOPUP_IN_FLIGHT",
 }

package/src/transactionProcessor/index.ts

@@ -11,6 +11,7 @@ export * from './dtos/AuthorizeSpeiBankTransferNcRequest';
 export * from './dtos/AuthorizeCollectorTransactionRequest';
 export * from './dtos/AuthorizeDisputeTransactionRequest';
 export * from './dtos/AuthorizeBonusRequest';
+export * from './dtos/AuthorizeRewardTopupRequest';
 export * from './dtos/CardInfo';
 export * from './dtos/InstallmentsInfo';
 export * from './dtos/MerchantInfo';