@fiado/type-kit 3.657.0 → 3.659.0

package/_test_/unit/loanOfferings/downPaymentBase.test.ts

@@ -0,0 +1,48 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { OriginateLoanCreditRequest } from '../../../src/loanCredit/dtos/requests/OriginateLoanCreditRequest';
+import { QuoteLoanCreditRequest } from '../../../src/loanCredit/dtos/requests/QuoteLoanCreditRequest';
+import { SimulateCreditPlanRequest } from '../../../src/loanOfferings/dtos/requests/SimulateCreditPlanRequest';
+
+type DtoClass = new () => object;
+
+const CASES: Array<[string, DtoClass, object]> = [
+    ['SimulateCreditPlanRequest', SimulateCreditPlanRequest, { productPriceCents: 1210000, downPaymentPct: 0.25, termWeeks: 52 }],
+    [
+        'OriginateLoanCreditRequest',
+        OriginateLoanCreditRequest,
+        {
+            wizardSessionId: 'WS-1',
+            borrowerId: 'B-1',
+            planId: 'PLAN-1',
+            termWeeks: 52,
+            equipmentPriceCents: 1210000,
+            downPaymentCents: 300000,
+            storeId: 'ST-1',
+        },
+    ],
+    ['QuoteLoanCreditRequest', QuoteLoanCreditRequest, { termWeeks: 52 }],
+];
+
+const parse = (dtoClass: DtoClass, body: object) => plainToInstance(dtoClass, body, { excludeExtraneousValues: true });
+
+const invalidProperties = async (dtoClass: DtoClass, body: object): Promise<string[]> =>
+    (await validate(parse(dtoClass, body))).map((error) => error.property);
+
+describe.each(CASES)('%s con downPaymentBaseCents', (_name, dtoClass, base) => {
+    it('sigue siendo válido sin el campo', async () => {
+        expect(await invalidProperties(dtoClass, base)).toEqual([]);
+    });
+
+    it('acepta y conserva un entero positivo', async () => {
+        const body = { ...base, downPaymentBaseCents: 1000000 };
+
+        expect(await invalidProperties(dtoClass, body)).toEqual([]);
+        expect(parse(dtoClass, body)).toHaveProperty('downPaymentBaseCents', 1000000);
+    });
+
+    it.each([0, -1, 10.5, '1000000'])('rechaza %p', async (value) => {
+        expect(await invalidProperties(dtoClass, { ...base, downPaymentBaseCents: value })).toContain('downPaymentBaseCents');
+    });
+});

package/_test_/unit/retailOrg/dtos/RetailUser.test.ts

@@ -107,6 +107,7 @@ describe('RetailUser — wallet PCF', () => {
             pcfAccountId: null,
             walletLinkMethod: null,
             walletClabeLast4: null,
+            walletPhoneLast4: null,
             walletLinkedAt: null,
             walletLinkedBy: null,
         };
@@ -124,6 +125,17 @@ describe('RetailUser — wallet PCF', () => {
         expect(errors.some(e => e.property === 'walletClabeLast4')).toBe(true);
     });
 
+    it('valida la wallet vinculada por teléfono con sus últimos 4', async () => {
+        const byPhone = { ...linked, walletLinkMethod: RetailUserWalletLinkMethodEnum.PHONE, walletClabeLast4: null, walletPhoneLast4: '9900' };
+        const errors = await validate(plainToInstance(RetailUser, byPhone));
+        expect(errors).toEqual([]);
+    });
+
+    it('falla si walletPhoneLast4 trae el teléfono completo', async () => {
+        const errors = await validate(plainToInstance(RetailUser, { ...linked, walletPhoneLast4: '5512345678' }));
+        expect(errors.some(e => e.property === 'walletPhoneLast4')).toBe(true);
+    });
+
     it('falla si walletLinkedAt no es ISO 8601', async () => {
         const errors = await validate(plainToInstance(RetailUser, { ...linked, walletLinkedAt: '20/10/2026' }));
         expect(errors.some(e => e.property === 'walletLinkedAt')).toBe(true);

package/bin/loanCredit/dtos/requests/OriginateLoanCreditRequest.d.ts

@@ -20,6 +20,8 @@ export declare class OriginateLoanCreditRequest {
     /** Precio del equipo en centavos; el techo es técnico, no de negocio (L-027). */
     equipmentPriceCents: number;
     downPaymentCents: number;
+    /** Base sobre la que se calcula el enganche mínimo; sin él, se usa el precio. */
+    downPaymentBaseCents?: number;
     /**
      * Id de la evaluación SCI del paso 05 (snapshot inmutable en loan-scoring). Si viene, el
      * motor LEE el snapshot (getSciEvaluation), valida la decisión (REJECTED → 422

package/bin/loanCredit/dtos/requests/OriginateLoanCreditRequest.js

@@ -69,6 +69,13 @@ __decorate([
     (0, class_validator_1.Max)(LoanInputLimits_1.LOAN_AMOUNT_MAX_CENTS),
     __metadata("design:type", Number)
 ], OriginateLoanCreditRequest.prototype, "downPaymentCents", 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)
+], OriginateLoanCreditRequest.prototype, "downPaymentBaseCents", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/loanCredit/dtos/requests/QuoteLoanCreditRequest.d.ts

@@ -8,4 +8,6 @@
 export declare class QuoteLoanCreditRequest {
     termWeeks?: number;
     downPaymentCents?: number;
+    /** Base sobre la que se calcula el enganche mínimo; sin él, se usa el precio. */
+    downPaymentBaseCents?: number;
 }

package/bin/loanCredit/dtos/requests/QuoteLoanCreditRequest.js

@@ -37,3 +37,10 @@ __decorate([
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
 ], QuoteLoanCreditRequest.prototype, "downPaymentCents", 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)
+], QuoteLoanCreditRequest.prototype, "downPaymentBaseCents", void 0);

package/bin/loanOfferings/dtos/requests/SimulateCreditPlanRequest.d.ts

@@ -12,6 +12,8 @@ import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 export declare class SimulateCreditPlanRequest {
     productPriceCents: number;
     downPaymentPct: number;
+    /** Base sobre la que se calcula el enganche mínimo; sin él, se usa el precio. */
+    downPaymentBaseCents?: number;
     termWeeks: number;
     customerSciScore?: number;
     /** Tienda donde se vende. Sin él no se resuelven las promociones acotadas por tienda. */

package/bin/loanOfferings/dtos/requests/SimulateCreditPlanRequest.js

@@ -40,6 +40,13 @@ __decorate([
     (0, class_validator_1.Max)(1),
     __metadata("design:type", Number)
 ], SimulateCreditPlanRequest.prototype, "downPaymentPct", 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)
+], SimulateCreditPlanRequest.prototype, "downPaymentBaseCents", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsInt)(),

package/bin/retailOrg/dtos/RetailUser.d.ts

@@ -37,6 +37,8 @@ export declare class RetailUser {
     walletLinkMethod?: RetailUserWalletLinkMethodEnum | null;
     /** Últimos 4 dígitos de la CLABE; la CLABE completa no se guarda. */
     walletClabeLast4?: string | null;
+    /** Últimos 4 dígitos del teléfono con que se buscó la wallet; el teléfono completo no se guarda. */
+    walletPhoneLast4?: string | null;
     /** Cuándo se vinculó (ISO). */
     walletLinkedAt?: string | null;
     /** Quién la vinculó: el actorId del usuario del back office. */

package/bin/retailOrg/dtos/RetailUser.js

@@ -115,6 +115,13 @@ __decorate([
     (0, class_validator_1.Matches)(/^\d{4}$/, { message: 'walletClabeLast4 debe tener 4 dígitos' }),
     __metadata("design:type", String)
 ], RetailUser.prototype, "walletClabeLast4", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/^\d{4}$/, { message: 'walletPhoneLast4 debe tener 4 dígitos' }),
+    __metadata("design:type", String)
+], RetailUser.prototype, "walletPhoneLast4", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/retailWizard/dtos/WizardFinancingPreview.d.ts

@@ -5,7 +5,7 @@ export interface WizardFinancingPreviewLine {
 }
 /** Reparto provisional de la sesión; se calcula al leer y no se persiste. */
 export interface WizardFinancingPreview {
-    /** Tope de extras financiables: floor(30% × ancla neta). */
+    /** Tope de extras: mínimo entre 30% del financiable de la ancla y lo que falte para el crédito máximo. */
     capCents: number;
     lines: WizardFinancingPreviewLine[];
 }

package/bin/retailWizard/dtos/WizardSession.d.ts

@@ -129,6 +129,8 @@ export interface WizardSession {
     financedLineId?: string | null;
     /** Reparto provisional mientras haya líneas; se calcula al leer, no se persiste. */
     financingPreview?: WizardFinancingPreview | null;
+    /** Financiable de la ancla (neto − enganche mínimo); `null` si las cotas no están resueltas. */
+    anchorFinanceableCents?: number | null;
     /** Marca de la saga: todas las piezas rastreadas de las líneas vivas quedaron HELD. */
     piecesHeldAt?: string | null;
     /** Promo de venta que fijó Promociones; `null` = ninguna. */

package/package.json

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

package/src/loanCredit/dtos/requests/OriginateLoanCreditRequest.ts

@@ -62,6 +62,13 @@ export class OriginateLoanCreditRequest {
     @Max(LOAN_AMOUNT_MAX_CENTS)
     downPaymentCents!: number;
 
+    /** Base sobre la que se calcula el enganche mínimo; sin él, se usa el precio. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    downPaymentBaseCents?: number;
+
     /**
      * Id de la evaluación SCI del paso 05 (snapshot inmutable en loan-scoring). Si viene, el
      * motor LEE el snapshot (getSciEvaluation), valida la decisión (REJECTED → 422

package/src/loanCredit/dtos/requests/QuoteLoanCreditRequest.ts

@@ -21,4 +21,11 @@ export class QuoteLoanCreditRequest {
     @IsInt()
     @Min(0)
     downPaymentCents?: number;
+
+    /** Base sobre la que se calcula el enganche mínimo; sin él, se usa el precio. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    downPaymentBaseCents?: number;
 }

package/src/loanOfferings/dtos/requests/SimulateCreditPlanRequest.ts

@@ -26,6 +26,13 @@ export class SimulateCreditPlanRequest {
     @Max(1)
     downPaymentPct!: number;
 
+    /** Base sobre la que se calcula el enganche mínimo; sin él, se usa el precio. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    downPaymentBaseCents?: number;
+
     @Expose()
     @IsInt()
     @Min(1)

package/src/retailOrg/dtos/RetailUser.ts

@@ -100,6 +100,13 @@ export class RetailUser {
     @Matches(/^\d{4}$/, { message: 'walletClabeLast4 debe tener 4 dígitos' })
     walletClabeLast4?: string | null;
 
+    /** Últimos 4 dígitos del teléfono con que se buscó la wallet; el teléfono completo no se guarda. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Matches(/^\d{4}$/, { message: 'walletPhoneLast4 debe tener 4 dígitos' })
+    walletPhoneLast4?: string | null;
+
     /** Cuándo se vinculó (ISO). */
     @Expose()
     @IsOptional()

package/src/retailWizard/dtos/WizardFinancingPreview.ts

@@ -6,7 +6,7 @@ export interface WizardFinancingPreviewLine {
 
 /** Reparto provisional de la sesión; se calcula al leer y no se persiste. */
 export interface WizardFinancingPreview {
-    /** Tope de extras financiables: floor(30% × ancla neta). */
+    /** Tope de extras: mínimo entre 30% del financiable de la ancla y lo que falte para el crédito máximo. */
     capCents: number;
     lines: WizardFinancingPreviewLine[];
 }

package/src/retailWizard/dtos/WizardSession.ts

@@ -133,6 +133,8 @@ export interface WizardSession {
   financedLineId?: string | null;
   /** Reparto provisional mientras haya líneas; se calcula al leer, no se persiste. */
   financingPreview?: WizardFinancingPreview | null;
+  /** Financiable de la ancla (neto − enganche mínimo); `null` si las cotas no están resueltas. */
+  anchorFinanceableCents?: number | null;
   /** Marca de la saga: todas las piezas rastreadas de las líneas vivas quedaron HELD. */
   piecesHeldAt?: string | null;
   /** Promo de venta que fijó Promociones; `null` = ninguna. */