@fiado/type-kit 3.653.0 → 3.655.0

package/_test_/unit/phoneSales/PhoneSalesCodeRedeemedEventDetail.test.ts

@@ -0,0 +1,33 @@
+import 'reflect-metadata';
+import { PHONE_SALES_EVENTS_SOURCE, PhoneSalesEventDetailTypeEnum, PhoneSalesCodeRedeemedEventDetail } from '../../../src/phoneSales';
+import { PhoneSales } from '../../../src';
+
+it('constantes del evento', () => {
+  expect(PHONE_SALES_EVENTS_SOURCE).toBe('fiado.phone-sales');
+  expect(PhoneSalesEventDetailTypeEnum.CODE_REDEEMED).toBe('PhoneSalesCodeRedeemed');
+  expect(PhoneSales.PHONE_SALES_EVENTS_SOURCE).toBe('fiado.phone-sales');
+});
+
+it('detail tiene la forma exacta del contrato', () => {
+  const detail = {
+    eventId: 'e1', occurredAt: '2026-11-05T12:00:00.000Z', saleId: 's1',
+    redeemer: { directoryId: 'd-redeemer' }, buyer: { directoryId: 'd-buyer' },
+    line: { phone: '5512345678', operatorId: 'at-t' },
+    sale: { variantId: 'v1', model: 'A15', storage: '128GB', color: 'Negro', currency: 'MXN', deliveryType: 'HOME', purchasedAt: '2026-11-05T11:00:00.000Z', amount: 4999 },
+  } satisfies PhoneSalesCodeRedeemedEventDetail;
+  expect(Object.keys(detail).sort()).toEqual(['buyer', 'eventId', 'line', 'occurredAt', 'redeemer', 'sale', 'saleId']);
+  expect(Object.keys(detail.sale).sort()).toEqual(['amount', 'color', 'currency', 'deliveryType', 'model', 'purchasedAt', 'storage', 'variantId']);
+});
+
+it('amount y currency son opcionales (ventas previas a DEC-011)', () => {
+  const sale = {
+    variantId: 'v1', model: 'A15', storage: '128GB', color: 'Negro', deliveryType: 'HOME', purchasedAt: '2026-11-05T11:00:00.000Z',
+  } satisfies PhoneSalesCodeRedeemedEventDetail['sale'];
+  expect(Object.keys(sale)).not.toContain('amount');
+});
+
+it('rechaza campos faltantes', () => {
+  // @ts-expect-error falta redeemer
+  const missing: PhoneSalesCodeRedeemedEventDetail = { eventId: 'e', occurredAt: 'x', saleId: 's', buyer: { directoryId: 'b' }, line: { phone: '1', operatorId: 'bait' }, sale: {} };
+  void missing;
+});

package/_test_/unit/phoneSales/RedeemSaleCodeRequestDto.test.ts

@@ -0,0 +1,34 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { RedeemSaleCodeRequestDto, SaleResponseDto } from '../../../src/phoneSales';
+
+const ok = { referenceCode: 'ABC123', linePhone: '55 1234 5678', lineOperatorId: 'at-t' };
+const props = async (plain: object) =>
+  (await validate(plainToInstance(RedeemSaleCodeRequestDto, plain))).map((e) => e.property);
+
+describe('RedeemSaleCodeRequestDto', () => {
+  it('válido: operador slug y teléfono string sin normalizar', async () => {
+    expect(await props(ok)).toEqual([]);
+  });
+  it.each(['Bait', 'a', 'x'.repeat(41), 'at_t', ''])('lineOperatorId %p inválido', async (lineOperatorId) => {
+    expect(await props({ ...ok, lineOperatorId })).toEqual(['lineOperatorId']);
+  });
+  it('linePhone no string inválido; ausente inválido', async () => {
+    expect(await props({ ...ok, linePhone: 5512345678 })).toEqual(['linePhone']);
+    expect(await props({ referenceCode: 'A', lineOperatorId: 'bait' })).toEqual(['linePhone']);
+  });
+  it('ya no exige newAccountDirectorId y la clase no lo declara', async () => {
+    expect(await props(ok)).toEqual([]);
+    expect('newAccountDirectorId' in new RedeemSaleCodeRequestDto()).toBe(false);
+  });
+});
+
+describe('SaleResponseDto.line', () => {
+  it('es opcional y acepta PhoneSalesLineDetail', () => {
+    const withLine: SaleResponseDto['line'] = { phone: '5512345678', operatorId: 'bait' };
+    const without: SaleResponseDto['line'] = undefined;
+    expect(withLine?.operatorId).toBe('bait');
+    expect(without).toBeUndefined();
+  });
+});

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/bin/phoneSales/RedeemSaleCodeRequestDto.d.ts

@@ -1,4 +1,7 @@
 export declare class RedeemSaleCodeRequestDto {
     referenceCode: string;
-    newAccountDirectorId: string;
+    /** Teléfono de la línea tal como lo escribe el usuario; la normalización a 10 dígitos la hace el backend. */
+    linePhone: string;
+    /** Slug del operador tal como lo da benefits (`bait`, `telcel`, `at-t`). */
+    lineOperatorId: string;
 }

package/bin/phoneSales/RedeemSaleCodeRequestDto.js

@@ -21,4 +21,8 @@ __decorate([
 __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
-], RedeemSaleCodeRequestDto.prototype, "newAccountDirectorId", void 0);
+], RedeemSaleCodeRequestDto.prototype, "linePhone", void 0);
+__decorate([
+    (0, class_validator_1.Matches)(/^[a-z0-9-]{2,40}$/),
+    __metadata("design:type", String)
+], RedeemSaleCodeRequestDto.prototype, "lineOperatorId", void 0);

package/bin/phoneSales/SaleResponseDto.d.ts

@@ -1,3 +1,4 @@
+import { PhoneSalesLineDetail } from './events/PhoneSalesCodeRedeemedEventDetail';
 import { CurrencyId } from '../currency';
 import { PickupDeliveryData, HomeDeliveryData } from './SaleDeliveryData';
 export declare class SaleResponseDto {
@@ -57,4 +58,6 @@ export declare class SaleResponseDto {
     chargedAmount: number | null;
     /** Moneda en la que se cobró `chargedAmount` — mismo motivo de nullability. */
     chargedCurrencyId: CurrencyId | null;
+    /** Línea declarada al canjear; ausente en ventas anteriores o sin canjear. */
+    line?: PhoneSalesLineDetail;
 }

package/bin/phoneSales/events/PhoneSalesCodeRedeemedEventDetail.d.ts

@@ -0,0 +1,40 @@
+export declare const PHONE_SALES_EVENTS_SOURCE = "fiado.phone-sales";
+export declare enum PhoneSalesEventDetailTypeEnum {
+    /** Un código de venta se canjeó con éxito. Solo lo publica quien ganó la escritura condicional del canje. */
+    CODE_REDEEMED = "PhoneSalesCodeRedeemed"
+}
+export declare class PhoneSalesEventParty {
+    directoryId: string;
+}
+export declare class PhoneSalesLineDetail {
+    /** 10 dígitos MX normalizados (sin +52, espacios ni guiones). */
+    phone: string;
+    /** Slug del operador tal como lo da benefits (`bait`, `telcel`, `at-t`). */
+    operatorId: string;
+}
+export declare class PhoneSalesSaleDetail {
+    variantId: string;
+    model: string;
+    storage: string;
+    color: string;
+    deliveryType: string;
+    /** ISO-8601 UTC de la compra. */
+    purchasedAt: string;
+    /** Se omite si la venta no lo tiene (ventas previas a DEC-011); nunca 0. */
+    amount?: number;
+    /** `USD` / `MXN`. Se omite si la venta no lo tiene; nunca vacío. */
+    currency?: string;
+}
+export declare class PhoneSalesCodeRedeemedEventDetail {
+    /** uuid generado al publicar. */
+    eventId: string;
+    /** ISO-8601 UTC del momento del canje. */
+    occurredAt: string;
+    saleId: string;
+    /** Quien canjea (sale del token). */
+    redeemer: PhoneSalesEventParty;
+    /** Quien compró (`buyerDirectorId`). */
+    buyer: PhoneSalesEventParty;
+    line: PhoneSalesLineDetail;
+    sale: PhoneSalesSaleDetail;
+}

package/bin/phoneSales/events/PhoneSalesCodeRedeemedEventDetail.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhoneSalesCodeRedeemedEventDetail = exports.PhoneSalesSaleDetail = exports.PhoneSalesLineDetail = exports.PhoneSalesEventParty = exports.PhoneSalesEventDetailTypeEnum = exports.PHONE_SALES_EVENTS_SOURCE = void 0;
+// Origen de los eventos de EventBridge que publica phone-sales (bus fiado-directory-events).
+exports.PHONE_SALES_EVENTS_SOURCE = 'fiado.phone-sales';
+var PhoneSalesEventDetailTypeEnum;
+(function (PhoneSalesEventDetailTypeEnum) {
+    /** Un código de venta se canjeó con éxito. Solo lo publica quien ganó la escritura condicional del canje. */
+    PhoneSalesEventDetailTypeEnum["CODE_REDEEMED"] = "PhoneSalesCodeRedeemed";
+})(PhoneSalesEventDetailTypeEnum || (exports.PhoneSalesEventDetailTypeEnum = PhoneSalesEventDetailTypeEnum = {}));
+class PhoneSalesEventParty {
+}
+exports.PhoneSalesEventParty = PhoneSalesEventParty;
+class PhoneSalesLineDetail {
+}
+exports.PhoneSalesLineDetail = PhoneSalesLineDetail;
+class PhoneSalesSaleDetail {
+}
+exports.PhoneSalesSaleDetail = PhoneSalesSaleDetail;
+// `detail` del evento PhoneSalesCodeRedeemed. El código canjeado NO viaja (funciona como secreto).
+class PhoneSalesCodeRedeemedEventDetail {
+}
+exports.PhoneSalesCodeRedeemedEventDetail = PhoneSalesCodeRedeemedEventDetail;

package/bin/phoneSales/index.d.ts

@@ -13,3 +13,4 @@ export * from './DeviceVariantPriceRequestDto';
 export * from './SetDeviceVariantPricesRequestDto';
 export * from './enums/DeviceImageContentTypeEnum';
 export * from './enums/DeviceVariantStatusEnum';
+export * from './events/PhoneSalesCodeRedeemedEventDetail';

package/bin/phoneSales/index.js

@@ -29,3 +29,4 @@ __exportStar(require("./DeviceVariantPriceRequestDto"), exports);
 __exportStar(require("./SetDeviceVariantPricesRequestDto"), exports);
 __exportStar(require("./enums/DeviceImageContentTypeEnum"), exports);
 __exportStar(require("./enums/DeviceVariantStatusEnum"), exports);
+__exportStar(require("./events/PhoneSalesCodeRedeemedEventDetail"), exports);

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/MobileTopupContributionResponse.d.ts

@@ -11,4 +11,6 @@ export interface MobileTopupContributionResponse {
     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/package.json

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

package/src/phoneSales/RedeemSaleCodeRequestDto.ts

@@ -1,9 +1,14 @@
-import { IsString } from 'class-validator';
+import { IsString, Matches } from 'class-validator';
 
 export class RedeemSaleCodeRequestDto {
   @IsString()
   referenceCode!: string;
 
+  /** Teléfono de la línea tal como lo escribe el usuario; la normalización a 10 dígitos la hace el backend. */
   @IsString()
-  newAccountDirectorId!: string;
+  linePhone!: string;
+
+  /** Slug del operador tal como lo da benefits (`bait`, `telcel`, `at-t`). */
+  @Matches(/^[a-z0-9-]{2,40}$/)
+  lineOperatorId!: string;
 }

package/src/phoneSales/SaleResponseDto.ts

@@ -1,3 +1,4 @@
+import { PhoneSalesLineDetail } from './events/PhoneSalesCodeRedeemedEventDetail';
 import { CurrencyId } from '../currency';
 import { PickupDeliveryData, HomeDeliveryData } from './SaleDeliveryData';
 
@@ -58,6 +59,8 @@ export class SaleResponseDto {
   chargedAmount!: number | null;
   /** Moneda en la que se cobró `chargedAmount` — mismo motivo de nullability. */
   chargedCurrencyId!: CurrencyId | null;
+  /** Línea declarada al canjear; ausente en ventas anteriores o sin canjear. */
+  line?: PhoneSalesLineDetail;
   // Nota (v1, 2026-08-03): `buyerDirectorId` (arriba) sigue siendo el ID crudo del comprador a
   // propósito. Se evaluó agregar `buyerName` resuelto server-side (vía servicio de directorios,
   // @fiado/api-invoker IDirectoriesApi) pero requería wiring de infra pendiente

package/src/phoneSales/events/PhoneSalesCodeRedeemedEventDetail.ts

@@ -0,0 +1,47 @@
+// Origen de los eventos de EventBridge que publica phone-sales (bus fiado-directory-events).
+export const PHONE_SALES_EVENTS_SOURCE = 'fiado.phone-sales';
+
+export enum PhoneSalesEventDetailTypeEnum {
+  /** Un código de venta se canjeó con éxito. Solo lo publica quien ganó la escritura condicional del canje. */
+  CODE_REDEEMED = 'PhoneSalesCodeRedeemed',
+}
+
+export class PhoneSalesEventParty {
+  directoryId!: string;
+}
+
+export class PhoneSalesLineDetail {
+  /** 10 dígitos MX normalizados (sin +52, espacios ni guiones). */
+  phone!: string;
+  /** Slug del operador tal como lo da benefits (`bait`, `telcel`, `at-t`). */
+  operatorId!: string;
+}
+
+export class PhoneSalesSaleDetail {
+  variantId!: string;
+  model!: string;
+  storage!: string;
+  color!: string;
+  deliveryType!: string;
+  /** ISO-8601 UTC de la compra. */
+  purchasedAt!: string;
+  /** Se omite si la venta no lo tiene (ventas previas a DEC-011); nunca 0. */
+  amount?: number;
+  /** `USD` / `MXN`. Se omite si la venta no lo tiene; nunca vacío. */
+  currency?: string;
+}
+
+// `detail` del evento PhoneSalesCodeRedeemed. El código canjeado NO viaja (funciona como secreto).
+export class PhoneSalesCodeRedeemedEventDetail {
+  /** uuid generado al publicar. */
+  eventId!: string;
+  /** ISO-8601 UTC del momento del canje. */
+  occurredAt!: string;
+  saleId!: string;
+  /** Quien canjea (sale del token). */
+  redeemer!: PhoneSalesEventParty;
+  /** Quien compró (`buyerDirectorId`). */
+  buyer!: PhoneSalesEventParty;
+  line!: PhoneSalesLineDetail;
+  sale!: PhoneSalesSaleDetail;
+}

package/src/phoneSales/index.ts

@@ -13,3 +13,4 @@ export * from './DeviceVariantPriceRequestDto';
 export * from './SetDeviceVariantPricesRequestDto';
 export * from './enums/DeviceImageContentTypeEnum';
 export * from './enums/DeviceVariantStatusEnum';
+export * from './events/PhoneSalesCodeRedeemedEventDetail';

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/MobileTopupContributionResponse.ts

@@ -12,4 +12,6 @@ export interface MobileTopupContributionResponse {
     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;
 }