@fiado/type-kit 3.654.0 → 3.656.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/bin/loanCredit/dtos/responses/LoanCustomerDocument.d.ts

@@ -0,0 +1,5 @@
+import { LoanCustomerCreditDocument } from './LoanCustomerCreditDocument';
+/** Documento del ciclo de vida de cualquiera de los créditos del acreditado, con el crédito en el que está guardado. */
+export interface LoanCustomerDocument extends LoanCustomerCreditDocument {
+    creditId: string;
+}

package/bin/loanCredit/dtos/responses/LoanCustomerDocument.js

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

package/bin/loanCredit/index.d.ts

@@ -43,6 +43,7 @@ export * from './dtos/responses/LoanContractDownloadUrl';
 export * from './dtos/responses/LoanContractPreview';
 export * from './dtos/responses/LoanContractResponse';
 export * from './dtos/responses/LoanCustomerCreditDocument';
+export * from './dtos/responses/LoanCustomerDocument';
 export * from './dtos/responses/LoanCustomerCreditDocumentUrl';
 export * from './dtos/responses/OriginateLoanCreditResponse';
 export * from './dtos/responses/QuoteLoanCreditResponse';

package/bin/loanCredit/index.js

@@ -67,6 +67,7 @@ __exportStar(require("./dtos/responses/LoanContractDownloadUrl"), exports);
 __exportStar(require("./dtos/responses/LoanContractPreview"), exports);
 __exportStar(require("./dtos/responses/LoanContractResponse"), exports);
 __exportStar(require("./dtos/responses/LoanCustomerCreditDocument"), exports);
+__exportStar(require("./dtos/responses/LoanCustomerDocument"), exports);
 __exportStar(require("./dtos/responses/LoanCustomerCreditDocumentUrl"), exports);
 __exportStar(require("./dtos/responses/OriginateLoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/QuoteLoanCreditResponse"), exports);

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/package.json

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

package/src/loanCredit/dtos/responses/LoanCustomerDocument.ts

@@ -0,0 +1,6 @@
+import { LoanCustomerCreditDocument } from './LoanCustomerCreditDocument';
+
+/** Documento del ciclo de vida de cualquiera de los créditos del acreditado, con el crédito en el que está guardado. */
+export interface LoanCustomerDocument extends LoanCustomerCreditDocument {
+    creditId: string;
+}

package/src/loanCredit/index.ts

@@ -52,6 +52,7 @@ export * from './dtos/responses/LoanContractDownloadUrl';
 export * from './dtos/responses/LoanContractPreview';
 export * from './dtos/responses/LoanContractResponse';
 export * from './dtos/responses/LoanCustomerCreditDocument';
+export * from './dtos/responses/LoanCustomerDocument';
 export * from './dtos/responses/LoanCustomerCreditDocumentUrl';
 export * from './dtos/responses/OriginateLoanCreditResponse';
 export * from './dtos/responses/QuoteLoanCreditResponse';

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