@fiado/type-kit 3.656.0 → 3.658.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/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/onboarding/dtos/responses/OnboardingStepsResponse.d.ts

@@ -1,9 +1,6 @@
 import { Scope } from '../../../directory/enums/Scope';
 import { OnboardingStepIdEnum } from '../../enums/OnboardingStepIdEnum';
 import { OnboardingStepStatusEnum } from '../../enums/OnboardingStepStatusEnum';
-import { OnboardingAccountStatusEnum } from '../../enums/OnboardingAccountStatusEnum';
-import { OnboardingAccountReasonEnum } from '../../enums/OnboardingAccountReasonEnum';
-import { OnboardingAccountMessageKeyEnum } from '../../enums/OnboardingAccountMessageKeyEnum';
 import { OnboardingAccountStatusV2Enum } from '../../enums/OnboardingAccountStatusV2Enum';
 import { OnboardingAccountReasonV2Enum } from '../../enums/OnboardingAccountReasonV2Enum';
 import { OnboardingAccountMessageKeyV2Enum } from '../../enums/OnboardingAccountMessageKeyV2Enum';
@@ -19,37 +16,16 @@ export declare class OnboardingStepDto {
     status: OnboardingStepStatusEnum;
 }
 /**
- * El trámite de una cuenta, por lado. Es el único bloque que lleva motivo.
+ * El trámite de una cuenta, por lado, con el catálogo homologado. Es el único bloque que lleva motivo.
+ * Ver `OnboardingAccountStatusV2Enum`.
  */
-export declare class OnboardingAccountDto {
-    /** Scope de onboarding al que corresponde la cuenta: `fiado.on_us` o `fiado.on_mx`. */
-    scope: Scope;
-    status: OnboardingAccountStatusEnum;
-    /** `null` cuando no hay nada que explicar. */
-    reason: OnboardingAccountReasonEnum | null;
-    /**
-     * Clave del mensaje de Fido para ESTA cuenta. El consumidor la usa TAL CUAL para buscar el copy en
-     * Firebase Remote Config, sin componerla ni interpretar `status`/`reason`.
-     *
-     * NO es `status` y `reason` concatenados: es el nombre del mensaje del catálogo que ya existe en
-     * Remote Config, para que esa configuración no haya que reescribirla. Varias combinaciones caen a
-     * propósito en la misma clave — `REJECTED:BLACKLIST` y `REJECTED:DUPLICATE_USER` son las dos
-     * `CANNOT_OPEN`, porque a las dos personas se les dice lo mismo.
-     *
-     * Va **por cuenta** y no como valor global porque el estado es por cuenta: un usuario con las dos
-     * cuentas puede tener una rechazada y la otra en curso, y cada una necesita su propio mensaje.
-     *
-     * OJO con el catálogo viejo: tenía un segundo nivel indexado por país. Ese nivel ya no aplica — el
-     * mensaje depende del estado de la cuenta, no del país, y cada cuenta trae su clave.
-     */
-    key: OnboardingAccountMessageKeyEnum;
-}
-/** Cuenta con el catálogo homologado (v2). Ver `OnboardingAccountStatusV2Enum`. */
 export declare class OnboardingAccountV2Dto {
+    /** Scope de onboarding al que corresponde la cuenta: `fiado.on_us` o `fiado.on_mx`. */
     scope: Scope;
     status: OnboardingAccountStatusV2Enum;
     /** Con `IFRAME` es el link de IDology; en cualquier otro estado, un valor del enum. */
     reason: OnboardingAccountReasonV2Enum | string;
+    /** Clave del mensaje de Fido para ESTA cuenta: el consumidor la busca tal cual en Remote Config. */
     key: OnboardingAccountMessageKeyV2Enum;
 }
 /**
@@ -81,7 +57,5 @@ export declare class OnboardingStepsResponse {
      * esa cuenta: por diseño cinco de los siete pasos nunca se bloquean, así que un usuario rechazado
      * igual va a recibir pasos abiertos.
      */
-    accounts: OnboardingAccountDto[];
-    /** Catálogo homologado. Opcional mientras convive con `accounts` (v1). */
-    accountsV2?: OnboardingAccountV2Dto[];
+    accounts: OnboardingAccountV2Dto[];
 }

package/bin/onboarding/dtos/responses/OnboardingStepsResponse.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OnboardingStepsResponse = exports.OnboardingAccountV2Dto = exports.OnboardingAccountDto = exports.OnboardingStepDto = void 0;
+exports.OnboardingStepsResponse = exports.OnboardingAccountV2Dto = exports.OnboardingStepDto = void 0;
 /**
  * Un paso: `id` + `status` y nada más. Sin motivo, sin metadata y sin lado (DEC-012 de
  * onboarding-business).
@@ -12,12 +12,9 @@ class OnboardingStepDto {
 }
 exports.OnboardingStepDto = OnboardingStepDto;
 /**
- * El trámite de una cuenta, por lado. Es el único bloque que lleva motivo.
+ * El trámite de una cuenta, por lado, con el catálogo homologado. Es el único bloque que lleva motivo.
+ * Ver `OnboardingAccountStatusV2Enum`.
  */
-class OnboardingAccountDto {
-}
-exports.OnboardingAccountDto = OnboardingAccountDto;
-/** Cuenta con el catálogo homologado (v2). Ver `OnboardingAccountStatusV2Enum`. */
 class OnboardingAccountV2Dto {
 }
 exports.OnboardingAccountV2Dto = OnboardingAccountV2Dto;

package/bin/onboarding/enums/OnboardingAccountStatusV2Enum.d.ts

@@ -1,9 +1,7 @@
 /**
  * Estado del trámite de una cuenta — catálogo homologado (v2).
  *
- * Convive con `OnboardingAccountStatusEnum` (v1) mientras las apps publicadas sigan leyendo
- * `accounts`. El v2 viaja en `accountsV2`. Los estados ya no distinguen motivos: eso lo dice la
- * `key`. `IFRAME` es el único que pide acción inmediata en la app: abrir `reason` (un link).
+ * Es el que viaja en `accounts`. Los estados ya no distinguen motivos: eso lo dice la `key`. `IFRAME` es el único que pide acción inmediata en la app: abrir `reason` (un link).
  */
 export declare enum OnboardingAccountStatusV2Enum {
     OPEN = "OPEN",

package/bin/onboarding/enums/OnboardingAccountStatusV2Enum.js

@@ -4,9 +4,7 @@ exports.OnboardingAccountStatusV2Enum = void 0;
 /**
  * Estado del trámite de una cuenta — catálogo homologado (v2).
  *
- * Convive con `OnboardingAccountStatusEnum` (v1) mientras las apps publicadas sigan leyendo
- * `accounts`. El v2 viaja en `accountsV2`. Los estados ya no distinguen motivos: eso lo dice la
- * `key`. `IFRAME` es el único que pide acción inmediata en la app: abrir `reason` (un link).
+ * Es el que viaja en `accounts`. Los estados ya no distinguen motivos: eso lo dice la `key`. `IFRAME` es el único que pide acción inmediata en la app: abrir `reason` (un link).
  */
 var OnboardingAccountStatusV2Enum;
 (function (OnboardingAccountStatusV2Enum) {

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.656.0",
+  "version": "3.658.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/onboarding/dtos/responses/OnboardingStepsResponse.ts

@@ -1,9 +1,6 @@
 import { Scope } from '../../../directory/enums/Scope';
 import { OnboardingStepIdEnum } from '../../enums/OnboardingStepIdEnum';
 import { OnboardingStepStatusEnum } from '../../enums/OnboardingStepStatusEnum';
-import { OnboardingAccountStatusEnum } from '../../enums/OnboardingAccountStatusEnum';
-import { OnboardingAccountReasonEnum } from '../../enums/OnboardingAccountReasonEnum';
-import { OnboardingAccountMessageKeyEnum } from '../../enums/OnboardingAccountMessageKeyEnum';
 import { OnboardingAccountStatusV2Enum } from '../../enums/OnboardingAccountStatusV2Enum';
 import { OnboardingAccountReasonV2Enum } from '../../enums/OnboardingAccountReasonV2Enum';
 import { OnboardingAccountMessageKeyV2Enum } from '../../enums/OnboardingAccountMessageKeyV2Enum';
@@ -21,38 +18,16 @@ export class OnboardingStepDto {
 }
 
 /**
- * El trámite de una cuenta, por lado. Es el único bloque que lleva motivo.
+ * El trámite de una cuenta, por lado, con el catálogo homologado. Es el único bloque que lleva motivo.
+ * Ver `OnboardingAccountStatusV2Enum`.
  */
-export class OnboardingAccountDto {
-    /** Scope de onboarding al que corresponde la cuenta: `fiado.on_us` o `fiado.on_mx`. */
-    scope!: Scope;
-    status!: OnboardingAccountStatusEnum;
-    /** `null` cuando no hay nada que explicar. */
-    reason!: OnboardingAccountReasonEnum | null;
-    /**
-     * Clave del mensaje de Fido para ESTA cuenta. El consumidor la usa TAL CUAL para buscar el copy en
-     * Firebase Remote Config, sin componerla ni interpretar `status`/`reason`.
-     *
-     * NO es `status` y `reason` concatenados: es el nombre del mensaje del catálogo que ya existe en
-     * Remote Config, para que esa configuración no haya que reescribirla. Varias combinaciones caen a
-     * propósito en la misma clave — `REJECTED:BLACKLIST` y `REJECTED:DUPLICATE_USER` son las dos
-     * `CANNOT_OPEN`, porque a las dos personas se les dice lo mismo.
-     *
-     * Va **por cuenta** y no como valor global porque el estado es por cuenta: un usuario con las dos
-     * cuentas puede tener una rechazada y la otra en curso, y cada una necesita su propio mensaje.
-     *
-     * OJO con el catálogo viejo: tenía un segundo nivel indexado por país. Ese nivel ya no aplica — el
-     * mensaje depende del estado de la cuenta, no del país, y cada cuenta trae su clave.
-     */
-    key!: OnboardingAccountMessageKeyEnum;
-}
-
-/** Cuenta con el catálogo homologado (v2). Ver `OnboardingAccountStatusV2Enum`. */
 export class OnboardingAccountV2Dto {
+    /** Scope de onboarding al que corresponde la cuenta: `fiado.on_us` o `fiado.on_mx`. */
     scope!: Scope;
     status!: OnboardingAccountStatusV2Enum;
     /** Con `IFRAME` es el link de IDology; en cualquier otro estado, un valor del enum. */
     reason!: OnboardingAccountReasonV2Enum | string;
+    /** Clave del mensaje de Fido para ESTA cuenta: el consumidor la busca tal cual en Remote Config. */
     key!: OnboardingAccountMessageKeyV2Enum;
 }
 
@@ -86,8 +61,5 @@ export class OnboardingStepsResponse {
      * esa cuenta: por diseño cinco de los siete pasos nunca se bloquean, así que un usuario rechazado
      * igual va a recibir pasos abiertos.
      */
-    accounts!: OnboardingAccountDto[];
-
-    /** Catálogo homologado. Opcional mientras convive con `accounts` (v1). */
-    accountsV2?: OnboardingAccountV2Dto[];
+    accounts!: OnboardingAccountV2Dto[];
 }

package/src/onboarding/enums/OnboardingAccountStatusV2Enum.ts

@@ -1,9 +1,7 @@
 /**
  * Estado del trámite de una cuenta — catálogo homologado (v2).
  *
- * Convive con `OnboardingAccountStatusEnum` (v1) mientras las apps publicadas sigan leyendo
- * `accounts`. El v2 viaja en `accountsV2`. Los estados ya no distinguen motivos: eso lo dice la
- * `key`. `IFRAME` es el único que pide acción inmediata en la app: abrir `reason` (un link).
+ * Es el que viaja en `accounts`. Los estados ya no distinguen motivos: eso lo dice la `key`. `IFRAME` es el único que pide acción inmediata en la app: abrir `reason` (un link).
  */
 export enum OnboardingAccountStatusV2Enum {
     OPEN = "OPEN",

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. */