@fiado/type-kit 3.652.0 → 3.654.0

package/_test_/unit/benefitCenter/benefitLeafProductPrice.test.ts

@@ -0,0 +1,35 @@
+import 'reflect-metadata';
+import { BenefitLeafProductPriceResponse } from '../../../src/benefitCenter';
+import { AmountTypeEnum } from '../../../src/servicePayment';
+
+describe('BenefitLeafProductPriceResponse', () => {
+  it('tiene la forma exacta del contrato', () => {
+    const ok = {
+      price: 120,
+      currency: 'MXN',
+      amountType: AmountTypeEnum.FIXED,
+      productEnabled: true,
+      leafEnabled: true,
+    } satisfies BenefitLeafProductPriceResponse;
+    expect(Object.keys(ok).sort()).toEqual(['amountType', 'currency', 'leafEnabled', 'price', 'productEnabled']);
+  });
+
+  it('rechaza amountType fuera del enum y campos faltantes', () => {
+    const badAmountType: BenefitLeafProductPriceResponse = {
+      price: 1,
+      currency: 'MXN',
+      // @ts-expect-error amountType debe ser AmountTypeEnum
+      amountType: 'OTRO',
+      productEnabled: true,
+      leafEnabled: true,
+    };
+    // @ts-expect-error falta leafEnabled
+    const missingLeafEnabled: BenefitLeafProductPriceResponse = {
+      price: 1,
+      currency: 'MXN',
+      amountType: AmountTypeEnum.VARIABLE,
+      productEnabled: true,
+    };
+    expect([badAmountType.price, missingLeafEnabled.price]).toEqual([1, 1]);
+  });
+});

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

@@ -45,6 +45,21 @@ describe('CatalogItemRequest', () => {
     expect(await props(asCatalog(override))).toContain(property);
   });
 
+  it('costCenterId es opcional: ausente, null o un texto de hasta 64', async () => {
+    expect(await validate(asCatalog())).toHaveLength(0);
+    expect(await validate(asCatalog({ costCenterId: null }))).toHaveLength(0);
+    expect(await validate(asCatalog({ costCenterId: 'CC-VENTA-CELULARES' }))).toHaveLength(0);
+    expect(asCatalog({ costCenterId: 'CC-1' }).costCenterId).toBe('CC-1');
+  });
+
+  it.each<[string, JsonValue]>([
+    ['vacío', ''],
+    ['> 64', 'c'.repeat(65)],
+    ['no texto', 5],
+  ])('rechaza costCenterId %s', async (_nombre, costCenterId) => {
+    expect(await props(asCatalog({ costCenterId }))).toContain('costCenterId');
+  });
+
   it('acepta costo 0 (recompensa gratuita para el aliado)', async () => {
     expect(await validate(asCatalog({ cost: { amount: 0, currency: 'MXN' } }))).toHaveLength(0);
   });

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

@@ -1,6 +1,6 @@
 import 'reflect-metadata';
 import { CurrencyId } from '../../../src/currency';
-import { CHARGES_EXPORT_MAX_ROWS, CHARGES_MONTH_PATTERN } from '../../../src/rewards';
+import { CHARGES_EXPORT_MAX_ROWS, CHARGES_MONTH_PATTERN, RewardChargeKindEnum } from '../../../src/rewards';
 import type { ChargeListResponse, ChargeRecord, ChargesExportQuery, ChargesQuery } from '../../../src/rewards';
 
 describe('contrato de cargos (D-C1)', () => {
@@ -18,4 +18,28 @@ describe('contrato de cargos (D-C1)', () => {
     expect([CHARGES_EXPORT_MAX_ROWS, list.items.length, q.month, e.partnerId]).toEqual([10000, 1, '2026-10', 'FIADO']);
     expect('source' in record).toBe(false);
   });
+
+  it('RewardChargeKindEnum con valores exactos', () => {
+    expect({ ...RewardChargeKindEnum }).toEqual({ GRANT: 'GRANT', PRICE_ADJUSTMENT: 'PRICE_ADJUSTMENT' });
+  });
+
+  it('ChargeRecord de ajuste a FIADO (monto con signo) compila y el normal sigue sin kind', () => {
+    const base = {
+      grantId: 'g', itemKey: 'a', grantedAt: 1, directoryId: 'd', catalogItemId: 'c', catalogItemName: 'Recarga', packageId: 'p',
+    };
+    const ajuste: ChargeRecord = {
+      ...base,
+      kind: RewardChargeKindEnum.PRICE_ADJUSTMENT,
+      cost: { amount: -20, currency: CurrencyId.MXN },
+      chargeTo: { partnerId: 'FIADO', partnerName: 'Fiado' },
+      adjustment: {
+        rechargeFolio: 'RW-g-i-M2', rechargeNumber: 2, carrierId: 'BAIT', chargedUnitPrice: 100, paidUnitPrice: 80,
+        originalChargeTo: { partnerId: 'ALIADO-1', partnerName: 'Aliado' },
+      },
+    };
+    const normal: ChargeRecord = { ...base, cost: { amount: 10, currency: CurrencyId.MXN }, chargeTo: { partnerId: 'FIADO', partnerName: 'Fiado' } };
+    expect(ajuste.cost.amount).toBe(-20);
+    expect(ajuste.adjustment?.originalChargeTo.partnerId).toBe('ALIADO-1');
+    expect('kind' in normal).toBe(false);
+  });
 });

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

@@ -3,6 +3,8 @@ import { plainToInstance } from 'class-transformer';
 import { validate } from 'class-validator';
 import {
   BackofficeGrantItemResponse,
+  MobileTopupContributionCarrier,
+  MobileTopupContributionResponse,
   MobileTopupConfigRequest,
   MobileTopupPlanResponse,
   MobileTopupPlanStatusEnum,
@@ -29,6 +31,11 @@ describe('rewards mobile topup', () => {
     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');
+    expect(RewardItemCodeEnum.CARRIER_NOT_AVAILABLE).toBe('CARRIER_NOT_AVAILABLE');
+    expect(RewardItemCodeEnum.TOPUP_PLAN_UNAVAILABLE).toBe('TOPUP_PLAN_UNAVAILABLE');
+    expect(Object.values(RewardItemCodeEnum)).toEqual(
+      expect.arrayContaining(['TOPUP_REJECTED', 'ITEM_DISMISSED', 'OUTCOME_UNKNOWN', 'AMOUNT_ABOVE_MAX', 'LIMIT_WAIT_EXPIRED']),
+    );
   });
 
   it('MobileTopupConfigRequest válido', async () => {
@@ -70,6 +77,20 @@ describe('rewards mobile topup', () => {
     expect(plan.pending).toBe(2);
   });
 
+  it('MobileTopupContributionResponse acepta carrier y unitPrice (opcionales)', () => {
+    const base = { grantId: 'g', itemKey: 'i', months: 3, sourceService: 's', sourceReference: 'r', addedAt: 1 };
+    const conSnapshot = {
+      ...base,
+      carrier: { carrierId: 'BAIT', label: 'Bait', moduleName: 'multicenter', benefitId: 'ben-3', leafId: 'l1', productId: '730', validityDays: 30 },
+      unitPrice: 100,
+    } satisfies MobileTopupContributionResponse;
+    const legacy = base satisfies MobileTopupContributionResponse;
+    const carrier: MobileTopupContributionCarrier = conSnapshot.carrier;
+    // @ts-expect-error unitPrice debe ser número
+    const invalido: MobileTopupContributionResponse = { ...base, unitPrice: '100' };
+    expect([conSnapshot.unitPrice, carrier.carrierId, 'carrier' in legacy, invalido.months]).toEqual([100, 'BAIT', false, 3]);
+  });
+
   it('BackofficeGrantItemResponse acepta type opcional', () => {
     const item = new BackofficeGrantItemResponse();
     item.type = 'MOBILE_TOPUP';

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

@@ -0,0 +1,104 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate, ValidationError } from 'class-validator';
+import {
+  MOBILE_TOPUP_CARRIER_ID_PATTERN,
+  MOBILE_TOPUP_DEFAULT_VALIDITY_DAYS,
+  MOBILE_TOPUP_MONTHS_MAX,
+  MOBILE_TOPUP_MONTHS_MIN,
+  MOBILE_TOPUP_VALIDITY_DAYS_MAX,
+  MobileTopupDependencyKeyEnum,
+  MobileTopupItemConfig,
+} from '../../../src/rewards';
+
+const carrier = {
+  carrierId: 'BAIT',
+  label: 'Bait',
+  moduleName: 'multicenter',
+  benefitId: 'ben-3',
+  leafId: 'l1',
+  productId: '730',
+  validityDays: 30,
+  enabled: true,
+};
+const base = { months: 3, carriers: [carrier] };
+
+const fields = (errors: ValidationError[]): string[] =>
+  errors.flatMap((e) => [e.property, ...fields(e.children ?? [])]);
+
+const check = async (plain: object): Promise<string[]> => fields(await validate(plainToInstance(MobileTopupItemConfig, plain)));
+const withCarrier = (patch: object) => ({ ...base, carriers: [{ ...carrier, ...patch }] });
+
+describe('MobileTopupItemConfig', () => {
+  it('config válida sin errores', async () => {
+    expect(await check(base)).toEqual([]);
+  });
+
+  it('sin validityDays aplica el default 30', async () => {
+    const { validityDays: _omit, ...sinValidez } = carrier;
+    const instance = plainToInstance(MobileTopupItemConfig, { ...base, carriers: [sinValidez] });
+    expect(fields(await validate(instance))).toEqual([]);
+    expect(instance.carriers[0].validityDays).toBe(30);
+  });
+
+  it.each([0, 100, 1.5])('months %s es inválido', async (months) => {
+    expect(await check({ ...base, months })).toContain('months');
+  });
+
+  it.each([1, 99])('months %s es válido', async (months) => {
+    expect(await check({ ...base, months })).toEqual([]);
+  });
+
+  it('carriers vacío o con carrierId repetido es inválido', async () => {
+    expect(await check({ ...base, carriers: [] })).toContain('carriers');
+    expect(await check({ ...base, carriers: [carrier, { ...carrier, label: 'Otro' }] })).toContain('carriers');
+  });
+
+  it.each(['bait', 'B', 'A'.repeat(21), 'TEL-CEL'])('carrierId %s es inválido', async (carrierId) => {
+    expect(await check(withCarrier({ carrierId }))).toContain('carrierId');
+  });
+
+  it.each(['TELCEL', 'AT_T'])('carrierId %s es válido', async (carrierId) => {
+    expect(await check(withCarrier({ carrierId }))).toEqual([]);
+  });
+
+  it.each([
+    ['leafId', ''],
+    ['productId', 'x'.repeat(65)],
+    ['label', ''],
+    ['benefitId', 'x'.repeat(65)],
+    ['moduleName', 'x'.repeat(65)],
+    ['leafId', 'x'.repeat(257)],
+  ])('%s inválido (%s)', async (prop, value) => {
+    expect(await check(withCarrier({ [prop]: value }))).toContain(prop);
+  });
+
+  it.each([0, -1, 30.5, 366])('validityDays %s es inválido', async (validityDays) => {
+    expect(await check(withCarrier({ validityDays }))).toContain('validityDays');
+  });
+
+  it('enabled no booleano es inválido', async () => {
+    expect(await check(withCarrier({ enabled: 'yes' }))).toContain('enabled');
+  });
+
+  describe('referencePrice (solo para mostrar; lo escribe rewards)', () => {
+    it('es opcional', async () => {
+      expect(await check(withCarrier({}))).toEqual([]);
+    });
+
+    it.each([0, 100, 120.5, 99.99])('referencePrice %s es válido', async (referencePrice) => {
+      expect(await check(withCarrier({ referencePrice }))).toEqual([]);
+    });
+
+    it.each([-1, 10.123, '100'])('referencePrice %s es inválido', async (referencePrice) => {
+      expect(await check(withCarrier({ referencePrice }))).toContain('referencePrice');
+    });
+  });
+
+  it('enum y constantes con valores exactos', () => {
+    expect({ ...MobileTopupDependencyKeyEnum }).toEqual({ PHONE: 'phone', CARRIER: 'carrier' });
+    expect([MOBILE_TOPUP_MONTHS_MIN, MOBILE_TOPUP_MONTHS_MAX]).toEqual([1, 99]);
+    expect([MOBILE_TOPUP_DEFAULT_VALIDITY_DAYS, MOBILE_TOPUP_VALIDITY_DAYS_MAX]).toEqual([30, 365]);
+    expect(MOBILE_TOPUP_CARRIER_ID_PATTERN.source).toBe('^[A-Z0-9_]{2,20}$');
+  });
+});

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 cinco códigos', () => {
+    it('RewardItemCodeEnum contiene los siete códigos', () => {
         expect(Object.values(RewardItemCodeEnum)).toEqual(
-            expect.arrayContaining(['AMOUNT_ABOVE_MAX', 'LIMIT_WAIT_EXPIRED', 'OUTCOME_UNKNOWN', 'TOPUP_REJECTED', 'ITEM_DISMISSED']),
+            expect.arrayContaining(['AMOUNT_ABOVE_MAX', 'LIMIT_WAIT_EXPIRED', 'OUTCOME_UNKNOWN', 'TOPUP_REJECTED', 'ITEM_DISMISSED', 'CARRIER_NOT_AVAILABLE', 'TOPUP_PLAN_UNAVAILABLE']),
         );
-        expect(Object.values(RewardItemCodeEnum)).toHaveLength(5);
+        expect(Object.values(RewardItemCodeEnum)).toHaveLength(7);
     });
 
     it('BackofficeGrantItemResponse acepta los campos de espera', () => {

package/bin/benefitCenter/dtos/BenefitLeafProductPriceResponse.d.ts

@@ -0,0 +1,14 @@
+import { AmountTypeEnum } from '../../servicePayment';
+/** Precio vigente (leído en vivo del conector) de un producto de un leaf de benefits. */
+export interface BenefitLeafProductPriceResponse {
+    /** Precio vigente del producto (MXN en recargas); 0 si el monto es VARIABLE. */
+    price: number;
+    /** Moneda del leaf (`ConnectorCatalogItem.currency`), ej. "MXN". */
+    currency: string;
+    /** Tipo de monto del producto; se devuelve tal cual, sin decidir. */
+    amountType: AmountTypeEnum;
+    /** `ProductItem.enabled`; ausente en el catálogo se interpreta como `true`. */
+    productEnabled: boolean;
+    /** `ConnectorCatalogItem.enabled` del leaf. */
+    leafEnabled: boolean;
+}

package/bin/benefitCenter/dtos/BenefitLeafProductPriceResponse.js

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

package/bin/benefitCenter/index.d.ts

@@ -56,6 +56,7 @@ export * from "./dtos/FavoriteUpdateRequest";
 export * from "./dtos/FavoriteReorderRequest";
 export * from "./dtos/BenefitPaymentRequest";
 export * from "./dtos/BenefitPaymentResponse";
+export * from "./dtos/BenefitLeafProductPriceResponse";
 export * from "./dtos/AuthorizeBenefitsMarketplaceTransactionRequest";
 export * from "./dtos/FavoriteUpsertContext";
 export * from "./dtos/BackofficeLeafUpdateRequest";

package/bin/benefitCenter/index.js

@@ -79,6 +79,7 @@ __exportStar(require("./dtos/FavoriteReorderRequest"), exports);
 //Phase 2 — Payments + favorite upsert context (v3.9.0)
 __exportStar(require("./dtos/BenefitPaymentRequest"), exports);
 __exportStar(require("./dtos/BenefitPaymentResponse"), exports);
+__exportStar(require("./dtos/BenefitLeafProductPriceResponse"), exports);
 __exportStar(require("./dtos/AuthorizeBenefitsMarketplaceTransactionRequest"), exports);
 __exportStar(require("./dtos/FavoriteUpsertContext"), exports);
 //Admin leaves in-place (v3.16.0)

package/bin/rewards/constants/MobileTopupLimits.d.ts

@@ -0,0 +1,10 @@
+/** Mínimo de meses (recargas) por ítem `MOBILE_TOPUP`. */
+export declare const MOBILE_TOPUP_MONTHS_MIN = 1;
+/** Máximo de meses (recargas) por ítem `MOBILE_TOPUP`. */
+export declare const MOBILE_TOPUP_MONTHS_MAX = 99;
+/** Vigencia en días de una recarga cuando el operador no la define. */
+export declare const MOBILE_TOPUP_DEFAULT_VALIDITY_DAYS = 30;
+/** Máximo de días de vigencia de una recarga por operador. */
+export declare const MOBILE_TOPUP_VALIDITY_DAYS_MAX = 365;
+/** Formato de la clave estable de un operador (`TELCEL`, `BAIT`, `AT_T`). */
+export declare const MOBILE_TOPUP_CARRIER_ID_PATTERN: RegExp;

package/bin/rewards/constants/MobileTopupLimits.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MOBILE_TOPUP_CARRIER_ID_PATTERN = exports.MOBILE_TOPUP_VALIDITY_DAYS_MAX = exports.MOBILE_TOPUP_DEFAULT_VALIDITY_DAYS = exports.MOBILE_TOPUP_MONTHS_MAX = exports.MOBILE_TOPUP_MONTHS_MIN = void 0;
+/** Mínimo de meses (recargas) por ítem `MOBILE_TOPUP`. */
+exports.MOBILE_TOPUP_MONTHS_MIN = 1;
+/** Máximo de meses (recargas) por ítem `MOBILE_TOPUP`. */
+exports.MOBILE_TOPUP_MONTHS_MAX = 99;
+/** Vigencia en días de una recarga cuando el operador no la define. */
+exports.MOBILE_TOPUP_DEFAULT_VALIDITY_DAYS = 30;
+/** Máximo de días de vigencia de una recarga por operador. */
+exports.MOBILE_TOPUP_VALIDITY_DAYS_MAX = 365;
+/** Formato de la clave estable de un operador (`TELCEL`, `BAIT`, `AT_T`). */
+exports.MOBILE_TOPUP_CARRIER_ID_PATTERN = /^[A-Z0-9_]{2,20}$/;

package/bin/rewards/dtos/MobileTopupCarrierConfig.d.ts

@@ -0,0 +1,17 @@
+/** Un operador de la recarga celular: identifica el plan en benefits (solo identificadores, nunca el precio de cobro). */
+export declare class MobileTopupCarrierConfig {
+    /** Clave estable del operador (ej. `TELCEL`, `BAIT`). */
+    carrierId: string;
+    /** Nombre para mostrar. */
+    label: string;
+    moduleName: string;
+    benefitId: string;
+    leafId: string;
+    productId: string;
+    /** Vigencia en días de cada recarga; por defecto 30. */
+    validityDays: number;
+    /** Si está apagado, no se ofrece ni se acepta como operador. */
+    enabled: boolean;
+    /** SOLO para mostrar el aviso de cambio de precio: lo escribe rewards en el servidor (el valor del cliente se ignora) y nunca se usa para cobrar ni pagar. */
+    referencePrice?: number;
+}

package/bin/rewards/dtos/MobileTopupCarrierConfig.js

@@ -0,0 +1,79 @@
+"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.MobileTopupCarrierConfig = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const MobileTopupLimits_1 = require("../constants/MobileTopupLimits");
+/** Un operador de la recarga celular: identifica el plan en benefits (solo identificadores, nunca el precio de cobro). */
+class MobileTopupCarrierConfig {
+}
+exports.MobileTopupCarrierConfig = MobileTopupCarrierConfig;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Matches)(MobileTopupLimits_1.MOBILE_TOPUP_CARRIER_ID_PATTERN),
+    __metadata("design:type", String)
+], MobileTopupCarrierConfig.prototype, "carrierId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(60),
+    __metadata("design:type", String)
+], MobileTopupCarrierConfig.prototype, "label", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], MobileTopupCarrierConfig.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)(64),
+    __metadata("design:type", String)
+], MobileTopupCarrierConfig.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)(256),
+    __metadata("design:type", String)
+], MobileTopupCarrierConfig.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)(64),
+    __metadata("design:type", String)
+], MobileTopupCarrierConfig.prototype, "productId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ?? MobileTopupLimits_1.MOBILE_TOPUP_DEFAULT_VALIDITY_DAYS),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(MobileTopupLimits_1.MOBILE_TOPUP_VALIDITY_DAYS_MAX),
+    __metadata("design:type", Number)
+], MobileTopupCarrierConfig.prototype, "validityDays", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], MobileTopupCarrierConfig.prototype, "enabled", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 2 }),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], MobileTopupCarrierConfig.prototype, "referencePrice", void 0);

package/bin/rewards/dtos/MobileTopupItemConfig.d.ts

@@ -0,0 +1,8 @@
+import { MobileTopupCarrierConfig } from './MobileTopupCarrierConfig';
+/** Config del ítem `MOBILE_TOPUP`: cuántas recargas mensuales da y con qué operadores. */
+export declare class MobileTopupItemConfig {
+    /** Cantidad de recargas mensuales (1–99). */
+    months: number;
+    /** Operadores del ítem; `carrierId` único. Que haya al menos uno habilitado lo valida rewards-business. */
+    carriers: MobileTopupCarrierConfig[];
+}

package/bin/rewards/dtos/MobileTopupItemConfig.js

@@ -0,0 +1,35 @@
+"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.MobileTopupItemConfig = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const MobileTopupLimits_1 = require("../constants/MobileTopupLimits");
+const MobileTopupCarrierConfig_1 = require("./MobileTopupCarrierConfig");
+/** Config del ítem `MOBILE_TOPUP`: cuántas recargas mensuales da y con qué operadores. */
+class MobileTopupItemConfig {
+}
+exports.MobileTopupItemConfig = MobileTopupItemConfig;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(MobileTopupLimits_1.MOBILE_TOPUP_MONTHS_MIN),
+    (0, class_validator_1.Max)(MobileTopupLimits_1.MOBILE_TOPUP_MONTHS_MAX),
+    __metadata("design:type", Number)
+], MobileTopupItemConfig.prototype, "months", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayUnique)((carrier) => carrier.carrierId),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => MobileTopupCarrierConfig_1.MobileTopupCarrierConfig),
+    __metadata("design:type", Array)
+], MobileTopupItemConfig.prototype, "carriers", void 0);

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

@@ -15,5 +15,10 @@ export declare class CatalogItemRequest {
     };
     cost: RewardCostInput;
     chargeTo: RewardChargeToInput;
+    /**
+     * Centro de costo con que el ledger imputa lo que esta recompensa paga (saldo, recarga). Viaja en cada
+     * `disburse`. Ausente o `null` = sin centro: el pago se asienta como `UNASSIGNED`.
+     */
+    costCenterId?: string | null;
     status: RewardStatusEnum;
 }

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

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CatalogItemRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const costCenter_1 = require("../../../transaction/constants/costCenter");
 const BackofficeLimits_1 = require("../../constants/BackofficeLimits");
 const RewardStatusEnum_1 = require("../../enums/RewardStatusEnum");
 const RewardChargeToInput_1 = require("./RewardChargeToInput");
@@ -63,6 +64,14 @@ __decorate([
     (0, class_transformer_1.Type)(() => RewardChargeToInput_1.RewardChargeToInput),
     __metadata("design:type", RewardChargeToInput_1.RewardChargeToInput)
 ], CatalogItemRequest.prototype, "chargeTo", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(costCenter_1.COST_CENTER_ID_MAX_LENGTH),
+    __metadata("design:type", String)
+], CatalogItemRequest.prototype, "costCenterId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsEnum)(RewardStatusEnum_1.RewardStatusEnum),

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

@@ -13,6 +13,8 @@ export declare class CatalogItemResponse {
     };
     cost: RewardCost;
     chargeTo: RewardChargeTo;
+    /** Centro de costo de lo que paga esta recompensa; ausente = `UNASSIGNED` en el ledger. */
+    costCenterId?: string;
     /** Solo lectura: las calcula el tipo a partir de `config`. */
     dependencies: RewardDependency[];
     status: RewardStatusEnum;

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

@@ -1,5 +1,7 @@
 import { RewardChargeTo } from '../RewardChargeTo';
 import { RewardCost } from '../RewardCost';
+import { RewardChargeKindEnum } from '../../enums/RewardChargeKindEnum';
+import { RewardChargeAdjustment } from './RewardChargeAdjustment';
 /** Un cargo = un ítem que quedó GRANTED, con el costo CONGELADO en la entrega (no el actual del catálogo). Sin `source` (R4 lo guarda, no se expone). */
 export declare class ChargeRecord {
     grantId: string;
@@ -14,4 +16,13 @@ export declare class ChargeRecord {
     cost: RewardCost;
     chargeTo: RewardChargeTo;
     externalRef?: Record<string, string>;
+    /**
+     * Tipo de registro; ausente ⇒ `GRANT`.
+     * En `PRICE_ADJUSTMENT`: `chargeTo = { partnerId: 'FIADO', partnerName }`, `cost.amount = round2(paidUnitPrice − chargedUnitPrice)`
+     * CON SIGNO (`+` a cargo de Fiado, `−` a favor), `cost.currency = MXN`, `grantedAt` = momento de la recarga (de ahí sale el mes UTC del libro)
+     * y `grantId`/`itemKey` = los del aporte. Un monto negativo es nuevo: sumas y export CSV deben tolerarlo.
+     */
+    kind?: RewardChargeKindEnum;
+    /** Detalle del ajuste; solo en registros `PRICE_ADJUSTMENT`. */
+    adjustment?: RewardChargeAdjustment;
 }

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

@@ -1,4 +1,7 @@
-/** Guarda la configuración de la recarga Bait (producto en Multicenter y precio mensual). */
+/**
+ * Guarda la configuración de la recarga Bait (producto en Multicenter y precio mensual).
+ * @deprecated Reemplazado por MobileTopupItemConfig; se borra en T8 cuando rewards-business y backoffice dejen de importarlo.
+ */
 export declare class MobileTopupConfigRequest {
     moduleName: string;
     benefitId: string;

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

@@ -12,7 +12,10 @@ 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). */
+/**
+ * Guarda la configuración de la recarga Bait (producto en Multicenter y precio mensual).
+ * @deprecated Reemplazado por MobileTopupItemConfig; se borra en T8 cuando rewards-business y backoffice dejen de importarlo.
+ */
 class MobileTopupConfigRequest {
 }
 exports.MobileTopupConfigRequest = MobileTopupConfigRequest;

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

@@ -1,3 +1,4 @@
+/** @deprecated Reemplazado por MobileTopupItemConfig; se borra en T8 cuando rewards-business y backoffice dejen de importarlos. */
 export interface MobileTopupConfigResponse {
     moduleName: string;
     benefitId: string;

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

@@ -0,0 +1,10 @@
+/** Snapshot del operador elegido al otorgar; el calendario se muestra aunque el operador luego se apague o elimine del ítem. */
+export interface MobileTopupContributionCarrier {
+    carrierId: string;
+    label: string;
+    moduleName: string;
+    benefitId: string;
+    leafId: string;
+    productId: string;
+    validityDays: number;
+}

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

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

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

@@ -1,3 +1,4 @@
+import { MobileTopupContributionCarrier } from './MobileTopupContributionCarrier';
 export interface MobileTopupContributionResponse {
     grantId: string;
     itemKey: string;
@@ -6,4 +7,10 @@ export interface MobileTopupContributionResponse {
     sourceReference: string;
     campaignId?: string;
     addedAt: number;
+    /** Snapshot del operador elegido al otorgar; solo falta en aportes legacy. */
+    carrier?: MobileTopupContributionCarrier;
+    /** Precio unitario cobrado al aliado (MXN, 2 decimales); no cambia nunca. Solo falta en aportes legacy. */
+    unitPrice?: number;
+    /** Centro de costo del ítem al otorgar; lo llevan todas las recargas del aporte. Ausente = `UNASSIGNED`. */
+    costCenterId?: string;
 }

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

@@ -0,0 +1,15 @@
+import { RewardChargeTo } from '../RewardChargeTo';
+/** Detalle de un ajuste de precio de una recarga: qué se cobró al aliado, qué se pagó y a quién se le cobró originalmente. */
+export declare class RewardChargeAdjustment {
+    /** Folio de la recarga que pagó la diferencia. */
+    rechargeFolio: string;
+    /** Número de la recarga dentro del aporte (1..months). */
+    rechargeNumber: number;
+    carrierId: string;
+    /** `unitPrice` del aporte: lo cobrado al aliado. */
+    chargedUnitPrice: number;
+    /** Precio vigente pagado en esa recarga. */
+    paidUnitPrice: number;
+    /** Aliado original del premio. */
+    originalChargeTo: RewardChargeTo;
+}

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RewardChargeAdjustment = void 0;
+/** Detalle de un ajuste de precio de una recarga: qué se cobró al aliado, qué se pagó y a quién se le cobró originalmente. */
+class RewardChargeAdjustment {
+}
+exports.RewardChargeAdjustment = RewardChargeAdjustment;

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

@@ -0,0 +1,7 @@
+/** Llaves de las dependencias de entrada de un ítem `MOBILE_TOPUP`. */
+export declare enum MobileTopupDependencyKeyEnum {
+    /** Número celular que recibe la recarga. */
+    PHONE = "phone",
+    /** Operador elegido (opciones = `carrierId` habilitados). */
+    CARRIER = "carrier"
+}

package/bin/rewards/enums/MobileTopupDependencyKeyEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MobileTopupDependencyKeyEnum = void 0;
+/** Llaves de las dependencias de entrada de un ítem `MOBILE_TOPUP`. */
+var MobileTopupDependencyKeyEnum;
+(function (MobileTopupDependencyKeyEnum) {
+    /** Número celular que recibe la recarga. */
+    MobileTopupDependencyKeyEnum["PHONE"] = "phone";
+    /** Operador elegido (opciones = `carrierId` habilitados). */
+    MobileTopupDependencyKeyEnum["CARRIER"] = "carrier";
+})(MobileTopupDependencyKeyEnum || (exports.MobileTopupDependencyKeyEnum = MobileTopupDependencyKeyEnum = {}));

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

@@ -0,0 +1,7 @@
+/** Tipo de registro del libro de cargos ("Entregas y costos"). */
+export declare enum RewardChargeKindEnum {
+    /** Cargo de un ítem entregado (es el valor implícito cuando `kind` no viene). */
+    GRANT = "GRANT",
+    /** Ajuste simétrico a cargo/favor de FIADO por diferencia de precio en una recarga. */
+    PRICE_ADJUSTMENT = "PRICE_ADJUSTMENT"
+}

package/bin/rewards/enums/RewardChargeKindEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RewardChargeKindEnum = void 0;
+/** Tipo de registro del libro de cargos ("Entregas y costos"). */
+var RewardChargeKindEnum;
+(function (RewardChargeKindEnum) {
+    /** Cargo de un ítem entregado (es el valor implícito cuando `kind` no viene). */
+    RewardChargeKindEnum["GRANT"] = "GRANT";
+    /** Ajuste simétrico a cargo/favor de FIADO por diferencia de precio en una recarga. */
+    RewardChargeKindEnum["PRICE_ADJUSTMENT"] = "PRICE_ADJUSTMENT";
+})(RewardChargeKindEnum || (exports.RewardChargeKindEnum = RewardChargeKindEnum = {}));

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

@@ -9,5 +9,9 @@ export declare enum RewardItemCodeEnum {
     /** 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"
+    ITEM_DISMISSED = "ITEM_DISMISSED",
+    /** El operador (`carrier`) es desconocido, está deshabilitado, o falta habiendo más de uno habilitado. */
+    CARRIER_NOT_AVAILABLE = "CARRIER_NOT_AVAILABLE",
+    /** El plan del operador está deshabilitado o no existe en benefits, no es `FIXED` o su precio es ≤ 0. */
+    TOPUP_PLAN_UNAVAILABLE = "TOPUP_PLAN_UNAVAILABLE"
 }

package/bin/rewards/enums/RewardItemCodeEnum.js

@@ -14,4 +14,8 @@ var RewardItemCodeEnum;
     RewardItemCodeEnum["TOPUP_REJECTED"] = "TOPUP_REJECTED";
     /** Un operador dio el ítem por fallido. */
     RewardItemCodeEnum["ITEM_DISMISSED"] = "ITEM_DISMISSED";
+    /** El operador (`carrier`) es desconocido, está deshabilitado, o falta habiendo más de uno habilitado. */
+    RewardItemCodeEnum["CARRIER_NOT_AVAILABLE"] = "CARRIER_NOT_AVAILABLE";
+    /** El plan del operador está deshabilitado o no existe en benefits, no es `FIXED` o su precio es ≤ 0. */
+    RewardItemCodeEnum["TOPUP_PLAN_UNAVAILABLE"] = "TOPUP_PLAN_UNAVAILABLE";
 })(RewardItemCodeEnum || (exports.RewardItemCodeEnum = RewardItemCodeEnum = {}));

package/bin/rewards/index.d.ts

@@ -14,11 +14,16 @@ export * from './enums/DeliveryTopDimensionEnum';
 export * from './enums/DeliveryTopByEnum';
 export * from './enums/MobileTopupPlanStatusEnum';
 export * from './enums/MobileTopupRechargeStatusEnum';
+export * from './enums/MobileTopupDependencyKeyEnum';
+export * from './enums/RewardChargeKindEnum';
 export * from './types/RewardInputs';
 export * from './dtos/RewardCost';
 export * from './dtos/RewardChargeTo';
 export * from './dtos/RewardDependency';
+export * from './dtos/MobileTopupCarrierConfig';
+export * from './dtos/MobileTopupItemConfig';
 export * from './constants/RewardsLimits';
+export * from './constants/MobileTopupLimits';
 export * from './validators/IsRewardTags';
 export * from './validators/IsRewardInputs';
 export * from './dtos/RewardSource';
@@ -50,6 +55,7 @@ export * from './dtos/backoffice/BackofficeGrantAttemptResponse';
 export * from './dtos/backoffice/BackofficeGrantItemResponse';
 export * from './dtos/backoffice/BackofficeGrantResponse';
 export * from './dtos/backoffice/GrantListResponse';
+export * from './dtos/backoffice/RewardChargeAdjustment';
 export * from './dtos/backoffice/ChargeRecord';
 export * from './dtos/backoffice/ChargeListResponse';
 export * from './dtos/backoffice/ChargesQuery';
@@ -60,6 +66,7 @@ export * from './dtos/backoffice/DeliveryMetricsPoint';
 export * from './dtos/backoffice/DeliveryTopEntry';
 export * from './dtos/backoffice/MobileTopupConfigRequest';
 export * from './dtos/backoffice/MobileTopupConfigResponse';
+export * from './dtos/backoffice/MobileTopupContributionCarrier';
 export * from './dtos/backoffice/MobileTopupContributionResponse';
 export * from './dtos/backoffice/MobileTopupRechargeResponse';
 export * from './dtos/backoffice/MobileTopupPlanResponse';

package/bin/rewards/index.js

@@ -31,14 +31,19 @@ __exportStar(require("./enums/DeliveryTopDimensionEnum"), exports);
 __exportStar(require("./enums/DeliveryTopByEnum"), exports);
 __exportStar(require("./enums/MobileTopupPlanStatusEnum"), exports);
 __exportStar(require("./enums/MobileTopupRechargeStatusEnum"), exports);
+__exportStar(require("./enums/MobileTopupDependencyKeyEnum"), exports);
+__exportStar(require("./enums/RewardChargeKindEnum"), exports);
 //Types
 __exportStar(require("./types/RewardInputs"), exports);
 //DTOs
 __exportStar(require("./dtos/RewardCost"), exports);
 __exportStar(require("./dtos/RewardChargeTo"), exports);
 __exportStar(require("./dtos/RewardDependency"), exports);
+__exportStar(require("./dtos/MobileTopupCarrierConfig"), exports);
+__exportStar(require("./dtos/MobileTopupItemConfig"), exports);
 //Constants
 __exportStar(require("./constants/RewardsLimits"), exports);
+__exportStar(require("./constants/MobileTopupLimits"), exports);
 //Validators
 __exportStar(require("./validators/IsRewardTags"), exports);
 __exportStar(require("./validators/IsRewardInputs"), exports);
@@ -75,6 +80,7 @@ __exportStar(require("./dtos/backoffice/BackofficeGrantAttemptResponse"), export
 __exportStar(require("./dtos/backoffice/BackofficeGrantItemResponse"), exports);
 __exportStar(require("./dtos/backoffice/BackofficeGrantResponse"), exports);
 __exportStar(require("./dtos/backoffice/GrantListResponse"), exports);
+__exportStar(require("./dtos/backoffice/RewardChargeAdjustment"), exports);
 __exportStar(require("./dtos/backoffice/ChargeRecord"), exports);
 __exportStar(require("./dtos/backoffice/ChargeListResponse"), exports);
 __exportStar(require("./dtos/backoffice/ChargesQuery"), exports);
@@ -85,6 +91,7 @@ __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/MobileTopupContributionCarrier"), exports);
 __exportStar(require("./dtos/backoffice/MobileTopupContributionResponse"), exports);
 __exportStar(require("./dtos/backoffice/MobileTopupRechargeResponse"), exports);
 __exportStar(require("./dtos/backoffice/MobileTopupPlanResponse"), exports);

package/package.json

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

package/src/benefitCenter/dtos/BenefitLeafProductPriceResponse.ts

@@ -0,0 +1,15 @@
+import { AmountTypeEnum } from '../../servicePayment';
+
+/** Precio vigente (leído en vivo del conector) de un producto de un leaf de benefits. */
+export interface BenefitLeafProductPriceResponse {
+    /** Precio vigente del producto (MXN en recargas); 0 si el monto es VARIABLE. */
+    price: number;
+    /** Moneda del leaf (`ConnectorCatalogItem.currency`), ej. "MXN". */
+    currency: string;
+    /** Tipo de monto del producto; se devuelve tal cual, sin decidir. */
+    amountType: AmountTypeEnum;
+    /** `ProductItem.enabled`; ausente en el catálogo se interpreta como `true`. */
+    productEnabled: boolean;
+    /** `ConnectorCatalogItem.enabled` del leaf. */
+    leafEnabled: boolean;
+}

package/src/benefitCenter/index.ts

@@ -64,6 +64,7 @@ export * from "./dtos/FavoriteReorderRequest";
 //Phase 2 — Payments + favorite upsert context (v3.9.0)
 export * from "./dtos/BenefitPaymentRequest";
 export * from "./dtos/BenefitPaymentResponse";
+export * from "./dtos/BenefitLeafProductPriceResponse";
 export * from "./dtos/AuthorizeBenefitsMarketplaceTransactionRequest";
 export * from "./dtos/FavoriteUpsertContext";
 //Admin leaves in-place (v3.16.0)

package/src/rewards/constants/MobileTopupLimits.ts

@@ -0,0 +1,10 @@
+/** Mínimo de meses (recargas) por ítem `MOBILE_TOPUP`. */
+export const MOBILE_TOPUP_MONTHS_MIN = 1;
+/** Máximo de meses (recargas) por ítem `MOBILE_TOPUP`. */
+export const MOBILE_TOPUP_MONTHS_MAX = 99;
+/** Vigencia en días de una recarga cuando el operador no la define. */
+export const MOBILE_TOPUP_DEFAULT_VALIDITY_DAYS = 30;
+/** Máximo de días de vigencia de una recarga por operador. */
+export const MOBILE_TOPUP_VALIDITY_DAYS_MAX = 365;
+/** Formato de la clave estable de un operador (`TELCEL`, `BAIT`, `AT_T`). */
+export const MOBILE_TOPUP_CARRIER_ID_PATTERN = /^[A-Z0-9_]{2,20}$/;

package/src/rewards/dtos/MobileTopupCarrierConfig.ts

@@ -0,0 +1,62 @@
+import { Expose, Transform } from 'class-transformer';
+import { IsBoolean, IsInt, IsNotEmpty, IsNumber, IsOptional, IsString, Matches, Max, MaxLength, Min } from 'class-validator';
+import { MOBILE_TOPUP_CARRIER_ID_PATTERN, MOBILE_TOPUP_DEFAULT_VALIDITY_DAYS, MOBILE_TOPUP_VALIDITY_DAYS_MAX } from '../constants/MobileTopupLimits';
+
+/** Un operador de la recarga celular: identifica el plan en benefits (solo identificadores, nunca el precio de cobro). */
+export class MobileTopupCarrierConfig {
+    /** Clave estable del operador (ej. `TELCEL`, `BAIT`). */
+    @Expose()
+    @Matches(MOBILE_TOPUP_CARRIER_ID_PATTERN)
+    carrierId: string;
+
+    /** Nombre para mostrar. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(60)
+    label: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    moduleName: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    benefitId: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(256)
+    leafId: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    productId: string;
+
+    /** Vigencia en días de cada recarga; por defecto 30. */
+    @Expose()
+    @Transform(({ value }) => value ?? MOBILE_TOPUP_DEFAULT_VALIDITY_DAYS)
+    @IsInt()
+    @Min(1)
+    @Max(MOBILE_TOPUP_VALIDITY_DAYS_MAX)
+    validityDays: number;
+
+    /** Si está apagado, no se ofrece ni se acepta como operador. */
+    @Expose()
+    @IsBoolean()
+    enabled: boolean;
+
+    /** SOLO para mostrar el aviso de cambio de precio: lo escribe rewards en el servidor (el valor del cliente se ignora) y nunca se usa para cobrar ni pagar. */
+    @Expose()
+    @IsOptional()
+    @IsNumber({ maxDecimalPlaces: 2 })
+    @Min(0)
+    referencePrice?: number;
+}

package/src/rewards/dtos/MobileTopupItemConfig.ts

@@ -0,0 +1,22 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMinSize, ArrayUnique, IsInt, Max, Min, ValidateNested } from 'class-validator';
+import { MOBILE_TOPUP_MONTHS_MAX, MOBILE_TOPUP_MONTHS_MIN } from '../constants/MobileTopupLimits';
+import { MobileTopupCarrierConfig } from './MobileTopupCarrierConfig';
+
+/** Config del ítem `MOBILE_TOPUP`: cuántas recargas mensuales da y con qué operadores. */
+export class MobileTopupItemConfig {
+    /** Cantidad de recargas mensuales (1–99). */
+    @Expose()
+    @IsInt()
+    @Min(MOBILE_TOPUP_MONTHS_MIN)
+    @Max(MOBILE_TOPUP_MONTHS_MAX)
+    months: number;
+
+    /** Operadores del ítem; `carrierId` único. Que haya al menos uno habilitado lo valida rewards-business. */
+    @Expose()
+    @ArrayMinSize(1)
+    @ArrayUnique((carrier: MobileTopupCarrierConfig) => carrier.carrierId)
+    @ValidateNested({ each: true })
+    @Type(() => MobileTopupCarrierConfig)
+    carriers: MobileTopupCarrierConfig[];
+}

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

@@ -1,6 +1,7 @@
 import { Expose, Type } from 'class-transformer';
-import { IsEnum, IsNotEmpty, IsObject, IsString, Matches, MaxLength, ValidateNested } from 'class-validator';
+import { IsEnum, IsNotEmpty, IsObject, IsOptional, IsString, Matches, MaxLength, ValidateNested } from 'class-validator';
 import { JsonValue } from '../../../common';
+import { COST_CENTER_ID_MAX_LENGTH } from '../../../transaction/constants/costCenter';
 import { REWARD_ID_PATTERN } from '../../constants/BackofficeLimits';
 import { RewardStatusEnum } from '../../enums/RewardStatusEnum';
 import { RewardChargeToInput } from './RewardChargeToInput';
@@ -46,6 +47,17 @@ export class CatalogItemRequest {
     @Type(() => RewardChargeToInput)
     chargeTo: RewardChargeToInput;
 
+    /**
+     * Centro de costo con que el ledger imputa lo que esta recompensa paga (saldo, recarga). Viaja en cada
+     * `disburse`. Ausente o `null` = sin centro: el pago se asienta como `UNASSIGNED`.
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(COST_CENTER_ID_MAX_LENGTH)
+    costCenterId?: string | null;
+
     @Expose()
     @IsEnum(RewardStatusEnum)
     status: RewardStatusEnum;

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

@@ -12,6 +12,8 @@ export class CatalogItemResponse {
     config: { [key: string]: JsonValue };
     cost: RewardCost;
     chargeTo: RewardChargeTo;
+    /** Centro de costo de lo que paga esta recompensa; ausente = `UNASSIGNED` en el ledger. */
+    costCenterId?: string;
     /** Solo lectura: las calcula el tipo a partir de `config`. */
     dependencies: RewardDependency[];
     status: RewardStatusEnum;

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

@@ -1,5 +1,7 @@
 import { RewardChargeTo } from '../RewardChargeTo';
 import { RewardCost } from '../RewardCost';
+import { RewardChargeKindEnum } from '../../enums/RewardChargeKindEnum';
+import { RewardChargeAdjustment } from './RewardChargeAdjustment';
 
 /** Un cargo = un ítem que quedó GRANTED, con el costo CONGELADO en la entrega (no el actual del catálogo). Sin `source` (R4 lo guarda, no se expone). */
 export class ChargeRecord {
@@ -15,4 +17,13 @@ export class ChargeRecord {
     cost: RewardCost;
     chargeTo: RewardChargeTo;
     externalRef?: Record<string, string>;
+    /**
+     * Tipo de registro; ausente ⇒ `GRANT`.
+     * En `PRICE_ADJUSTMENT`: `chargeTo = { partnerId: 'FIADO', partnerName }`, `cost.amount = round2(paidUnitPrice − chargedUnitPrice)`
+     * CON SIGNO (`+` a cargo de Fiado, `−` a favor), `cost.currency = MXN`, `grantedAt` = momento de la recarga (de ahí sale el mes UTC del libro)
+     * y `grantId`/`itemKey` = los del aporte. Un monto negativo es nuevo: sumas y export CSV deben tolerarlo.
+     */
+    kind?: RewardChargeKindEnum;
+    /** Detalle del ajuste; solo en registros `PRICE_ADJUSTMENT`. */
+    adjustment?: RewardChargeAdjustment;
 }

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

@@ -1,7 +1,10 @@
 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). */
+/**
+ * Guarda la configuración de la recarga Bait (producto en Multicenter y precio mensual).
+ * @deprecated Reemplazado por MobileTopupItemConfig; se borra en T8 cuando rewards-business y backoffice dejen de importarlo.
+ */
 export class MobileTopupConfigRequest {
     @Expose()
     @IsString()

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

@@ -1,3 +1,4 @@
+/** @deprecated Reemplazado por MobileTopupItemConfig; se borra en T8 cuando rewards-business y backoffice dejen de importarlos. */
 export interface MobileTopupConfigResponse {
     moduleName: string;
     benefitId: string;

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

@@ -0,0 +1,10 @@
+/** Snapshot del operador elegido al otorgar; el calendario se muestra aunque el operador luego se apague o elimine del ítem. */
+export interface MobileTopupContributionCarrier {
+    carrierId: string;
+    label: string;
+    moduleName: string;
+    benefitId: string;
+    leafId: string;
+    productId: string;
+    validityDays: number;
+}

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

@@ -1,3 +1,5 @@
+import { MobileTopupContributionCarrier } from './MobileTopupContributionCarrier';
+
 export interface MobileTopupContributionResponse {
     grantId: string;
     itemKey: string;
@@ -6,4 +8,10 @@ export interface MobileTopupContributionResponse {
     sourceReference: string;
     campaignId?: string;
     addedAt: number;
+    /** Snapshot del operador elegido al otorgar; solo falta en aportes legacy. */
+    carrier?: MobileTopupContributionCarrier;
+    /** Precio unitario cobrado al aliado (MXN, 2 decimales); no cambia nunca. Solo falta en aportes legacy. */
+    unitPrice?: number;
+    /** Centro de costo del ítem al otorgar; lo llevan todas las recargas del aporte. Ausente = `UNASSIGNED`. */
+    costCenterId?: string;
 }

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

@@ -0,0 +1,16 @@
+import { RewardChargeTo } from '../RewardChargeTo';
+
+/** Detalle de un ajuste de precio de una recarga: qué se cobró al aliado, qué se pagó y a quién se le cobró originalmente. */
+export class RewardChargeAdjustment {
+    /** Folio de la recarga que pagó la diferencia. */
+    rechargeFolio: string;
+    /** Número de la recarga dentro del aporte (1..months). */
+    rechargeNumber: number;
+    carrierId: string;
+    /** `unitPrice` del aporte: lo cobrado al aliado. */
+    chargedUnitPrice: number;
+    /** Precio vigente pagado en esa recarga. */
+    paidUnitPrice: number;
+    /** Aliado original del premio. */
+    originalChargeTo: RewardChargeTo;
+}

package/src/rewards/enums/MobileTopupDependencyKeyEnum.ts

@@ -0,0 +1,7 @@
+/** Llaves de las dependencias de entrada de un ítem `MOBILE_TOPUP`. */
+export enum MobileTopupDependencyKeyEnum {
+    /** Número celular que recibe la recarga. */
+    PHONE = 'phone',
+    /** Operador elegido (opciones = `carrierId` habilitados). */
+    CARRIER = 'carrier',
+}

package/src/rewards/enums/RewardChargeKindEnum.ts

@@ -0,0 +1,7 @@
+/** Tipo de registro del libro de cargos ("Entregas y costos"). */
+export enum RewardChargeKindEnum {
+    /** Cargo de un ítem entregado (es el valor implícito cuando `kind` no viene). */
+    GRANT = 'GRANT',
+    /** Ajuste simétrico a cargo/favor de FIADO por diferencia de precio en una recarga. */
+    PRICE_ADJUSTMENT = 'PRICE_ADJUSTMENT',
+}

package/src/rewards/enums/RewardItemCodeEnum.ts

@@ -10,4 +10,8 @@ export enum RewardItemCodeEnum {
     TOPUP_REJECTED = 'TOPUP_REJECTED',
     /** Un operador dio el ítem por fallido. */
     ITEM_DISMISSED = 'ITEM_DISMISSED',
+    /** El operador (`carrier`) es desconocido, está deshabilitado, o falta habiendo más de uno habilitado. */
+    CARRIER_NOT_AVAILABLE = 'CARRIER_NOT_AVAILABLE',
+    /** El plan del operador está deshabilitado o no existe en benefits, no es `FIXED` o su precio es ≤ 0. */
+    TOPUP_PLAN_UNAVAILABLE = 'TOPUP_PLAN_UNAVAILABLE',
 }

package/src/rewards/index.ts

@@ -15,6 +15,8 @@ export * from './enums/DeliveryTopDimensionEnum';
 export * from './enums/DeliveryTopByEnum';
 export * from './enums/MobileTopupPlanStatusEnum';
 export * from './enums/MobileTopupRechargeStatusEnum';
+export * from './enums/MobileTopupDependencyKeyEnum';
+export * from './enums/RewardChargeKindEnum';
 
 //Types
 export * from './types/RewardInputs';
@@ -23,9 +25,12 @@ export * from './types/RewardInputs';
 export * from './dtos/RewardCost';
 export * from './dtos/RewardChargeTo';
 export * from './dtos/RewardDependency';
+export * from './dtos/MobileTopupCarrierConfig';
+export * from './dtos/MobileTopupItemConfig';
 
 //Constants
 export * from './constants/RewardsLimits';
+export * from './constants/MobileTopupLimits';
 
 //Validators
 export * from './validators/IsRewardTags';
@@ -67,6 +72,7 @@ export * from './dtos/backoffice/BackofficeGrantAttemptResponse';
 export * from './dtos/backoffice/BackofficeGrantItemResponse';
 export * from './dtos/backoffice/BackofficeGrantResponse';
 export * from './dtos/backoffice/GrantListResponse';
+export * from './dtos/backoffice/RewardChargeAdjustment';
 export * from './dtos/backoffice/ChargeRecord';
 export * from './dtos/backoffice/ChargeListResponse';
 export * from './dtos/backoffice/ChargesQuery';
@@ -77,6 +83,7 @@ export * from './dtos/backoffice/DeliveryMetricsPoint';
 export * from './dtos/backoffice/DeliveryTopEntry';
 export * from './dtos/backoffice/MobileTopupConfigRequest';
 export * from './dtos/backoffice/MobileTopupConfigResponse';
+export * from './dtos/backoffice/MobileTopupContributionCarrier';
 export * from './dtos/backoffice/MobileTopupContributionResponse';
 export * from './dtos/backoffice/MobileTopupRechargeResponse';
 export * from './dtos/backoffice/MobileTopupPlanResponse';