@fiado/type-kit 3.377.0 → 3.378.0

package/bin/loanOfferings/dtos/responses/SimulationResultResponse.d.ts

@@ -27,6 +27,21 @@ export interface AppliedPromotionResponse {
     /** Palancas del plan que la promoción pisó. */
     appliedEffects: PromotionEffectKindEnum[];
 }
+/**
+ * Cotas con las que se cotizó de verdad, ya pisadas por la promoción y las políticas. NO son las
+ * del plan: una promoción puede bajar el enganche mínimo o subir el techo de monto.
+ *
+ * El wizard dibuja el control del enganche con estas, no con las del plan. Sin ellas el vendedor
+ * ve un mínimo que el motor ya no exige, y la palanca de enganche queda inalcanzable.
+ */
+export interface EffectiveTermsResponse {
+    /** Enganche mínimo exigible, en decimal sobre 1 (`0.10` = 10%). */
+    minDownPaymentPct: number;
+    /** Tope de enganche, o `null` si el plan no lo acota. */
+    maxDownPaymentPct: number | null;
+    /** Techo de capital financiable. */
+    maxFinancedAmountCents: number;
+}
 /**
  * Resultado del simulador de cuota (POST /private/credit-plans/:planId/simulate,
  * GET /credit-plans/:planId/simulator). Amortización francesa + IVA 16% + comisión de apertura + CAT.
@@ -65,4 +80,8 @@ export interface SimulationResultResponse {
      * alcanzó la venta, y ausente si el lambda todavía no lo emite.
      */
     provenance?: PlanTermProvenance;
+    /**
+     * Las cotas efectivas de ESTA cotización. Ausente si el lambda todavía no las emite.
+     */
+    effectiveTerms?: EffectiveTermsResponse;
 }

package/bin/loanOfferings/dtos/responses/StorePolicyResponse.d.ts

@@ -6,6 +6,9 @@ export type PlanTermLayer = 'PLAN' | 'EASING' | 'PROMOTION' | 'HARDENING';
 /**
  * Cadena de capas que tocaron cada término, no una capa única: una palanca puede registrarse como
  * aplicada y quedar pisada después. Va vacío (`{}`) si ninguna política alcanzó la venta.
+ *
+ * NO es la auditoría completa del cálculo: con una promoción aplicada y cero políticas va vacío
+ * igual. Una promoción se audita por `appliedPromotion`, que es su canal propio.
  */
 export type PlanTermProvenance = Record<string, PlanTermLayer[]>;
 /** Palancas que ENDURECEN. Se pliegan con `max` sobre pisos y `min` sobre techos. */

package/package.json

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

package/src/loanOfferings/dtos/responses/SimulationResultResponse.ts

@@ -30,6 +30,22 @@ export interface AppliedPromotionResponse {
     appliedEffects: PromotionEffectKindEnum[];
 }
 
+/**
+ * Cotas con las que se cotizó de verdad, ya pisadas por la promoción y las políticas. NO son las
+ * del plan: una promoción puede bajar el enganche mínimo o subir el techo de monto.
+ *
+ * El wizard dibuja el control del enganche con estas, no con las del plan. Sin ellas el vendedor
+ * ve un mínimo que el motor ya no exige, y la palanca de enganche queda inalcanzable.
+ */
+export interface EffectiveTermsResponse {
+    /** Enganche mínimo exigible, en decimal sobre 1 (`0.10` = 10%). */
+    minDownPaymentPct: number;
+    /** Tope de enganche, o `null` si el plan no lo acota. */
+    maxDownPaymentPct: number | null;
+    /** Techo de capital financiable. */
+    maxFinancedAmountCents: number;
+}
+
 /**
  * Resultado del simulador de cuota (POST /private/credit-plans/:planId/simulate,
  * GET /credit-plans/:planId/simulator). Amortización francesa + IVA 16% + comisión de apertura + CAT.
@@ -68,4 +84,8 @@ export interface SimulationResultResponse {
      * alcanzó la venta, y ausente si el lambda todavía no lo emite.
      */
     provenance?: PlanTermProvenance;
+    /**
+     * Las cotas efectivas de ESTA cotización. Ausente si el lambda todavía no las emite.
+     */
+    effectiveTerms?: EffectiveTermsResponse;
 }

package/src/loanOfferings/dtos/responses/StorePolicyResponse.ts

@@ -8,6 +8,9 @@ export type PlanTermLayer = 'PLAN' | 'EASING' | 'PROMOTION' | 'HARDENING';
 /**
  * Cadena de capas que tocaron cada término, no una capa única: una palanca puede registrarse como
  * aplicada y quedar pisada después. Va vacío (`{}`) si ninguna política alcanzó la venta.
+ *
+ * NO es la auditoría completa del cálculo: con una promoción aplicada y cero políticas va vacío
+ * igual. Una promoción se audita por `appliedPromotion`, que es su canal propio.
  */
 export type PlanTermProvenance = Record<string, PlanTermLayer[]>;