@fiado/type-kit 3.394.0 → 3.396.0

package/_test_/unit/loanCredit/creditAuditSnapshots.test.ts

@@ -0,0 +1,75 @@
+import 'reflect-metadata';
+import {
+  AppliedStorePolicySnapshot,
+  CandidatePlanSnapshot,
+  EffectiveTermsSnapshot,
+  LoanCreditResponse,
+} from '../../../src/loanCredit/index';
+import { FoldableTermEnum, PromotionEffectKindEnum } from '../../../src/loanOfferings/index';
+
+describe('snapshots de auditoría del crédito', () => {
+  it('congela la política especial con los términos que ganó', () => {
+    const policy: AppliedStorePolicySnapshot = {
+      policyId: 'POL#1',
+      name: 'Freno de riesgo Norte',
+      appliedTerms: [FoldableTermEnum.MAX_FINANCED_AMOUNT_CENTS],
+    };
+    expect(policy.appliedTerms[0]).toBe('maxFinancedAmountCents');
+  });
+
+  it('congela el plan candidato con su id y su código', () => {
+    const candidate: CandidatePlanSnapshot = { planId: 'PLAN#1', code: 'SK-12' };
+    expect(candidate.planId).toBe('PLAN#1');
+  });
+
+  it('admite un tope de enganche nulo: el plan puede no acotarlo', () => {
+    const terms: EffectiveTermsSnapshot = {
+      minDownPaymentPct: 0.1,
+      maxDownPaymentPct: null,
+      maxFinancedAmountCents: 2_500_000,
+    };
+    expect(terms.maxDownPaymentPct).toBeNull();
+  });
+});
+
+describe('LoanCreditResponse', () => {
+  it('deja la auditoría opcional y nullable: los créditos viejos no la tienen', () => {
+    const legacy: Pick<
+      LoanCreditResponse,
+      | 'appliedPromotions'
+      | 'appliedStorePolicies'
+      | 'candidatePlans'
+      | 'planVersionAtOrigination'
+      | 'segmentIdsAtQuote'
+      | 'effectiveTerms'
+    > = {
+      appliedPromotions: null,
+      appliedStorePolicies: null,
+      candidatePlans: null,
+      planVersionAtOrigination: null,
+      segmentIdsAtQuote: null,
+      effectiveTerms: null,
+    };
+    expect(Object.values(legacy).every((value) => value === null)).toBe(true);
+  });
+
+  it('convive con la promoción primaria singular, que no cambia', () => {
+    const audited: Pick<LoanCreditResponse, 'appliedPromotion' | 'appliedPromotions'> = {
+      appliedPromotion: {
+        promotionId: 'PROMO#1',
+        name: 'Buen Fin',
+        version: 2,
+        appliedEffects: [PromotionEffectKindEnum.DOWN_PAYMENT_DELTA],
+      },
+      appliedPromotions: [
+        {
+          promotionId: 'PROMO#1',
+          name: 'Buen Fin',
+          version: 2,
+          appliedEffects: [PromotionEffectKindEnum.DOWN_PAYMENT_DELTA],
+        },
+      ],
+    };
+    expect(audited.appliedPromotions?.[0].name).toBe(audited.appliedPromotion?.name);
+  });
+});

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

@@ -0,0 +1,70 @@
+import 'reflect-metadata';
+import {
+  AppliedStorePolicyResponse,
+  CandidatePlanResponse,
+  FoldableTermEnum,
+  PromotionEffectKindEnum,
+  SimulationResultResponse,
+} from '../../../src/loanOfferings/index';
+
+/** Los valores del enum son las claves literales de los términos que el motor pliega. */
+describe('FoldableTermEnum', () => {
+  it('expone exactamente los tres términos plegables con su clave literal', () => {
+    expect(Object.values(FoldableTermEnum).sort()).toEqual(
+      ['maxFinancedAmountCents', 'minDownPaymentPct', 'tnaAnnual'],
+    );
+  });
+});
+
+describe('auditoría de la simulación', () => {
+  it('tipa el plan candidato con su id y su código', () => {
+    const candidate: CandidatePlanResponse = { planId: 'PLAN#1', code: 'SK-12' };
+    expect(candidate.code).toBe('SK-12');
+  });
+
+  it('tipa la política aplicada con los términos que ganó', () => {
+    const policy: AppliedStorePolicyResponse = {
+      policyId: 'POL#1',
+      name: 'Freno de riesgo Norte',
+      appliedTerms: [FoldableTermEnum.TNA_ANNUAL, FoldableTermEnum.MIN_DOWN_PAYMENT_PCT],
+    };
+    expect(policy.appliedTerms).toHaveLength(2);
+  });
+
+  it('deja los tres bloques de auditoría opcionales y conviviendo con la promoción primaria', () => {
+    const minimal: Pick<SimulationResultResponse, 'appliedPromotion'> = { appliedPromotion: null };
+    expect(minimal.appliedPromotion).toBeNull();
+
+    const audited: Pick<
+      SimulationResultResponse,
+      'appliedPromotion' | 'appliedPromotions' | 'candidatePlans' | 'appliedStorePolicies'
+    > = {
+      appliedPromotion: {
+        promotionId: 'PROMO#1',
+        name: 'Buen Fin',
+        version: 2,
+        appliedEffects: [PromotionEffectKindEnum.TNA_OVERRIDE],
+      },
+      appliedPromotions: [
+        {
+          promotionId: 'PROMO#1',
+          name: 'Buen Fin',
+          version: 2,
+          appliedEffects: [PromotionEffectKindEnum.TNA_OVERRIDE],
+        },
+        {
+          promotionId: 'PROMO#2',
+          name: 'Bono tarjeta',
+          version: 1,
+          appliedEffects: [PromotionEffectKindEnum.PCF_BONUS],
+        },
+      ],
+      candidatePlans: [{ planId: 'PLAN#1', code: 'SK-12' }],
+      appliedStorePolicies: [
+        { policyId: 'POL#1', name: 'Freno Norte', appliedTerms: [FoldableTermEnum.TNA_ANNUAL] },
+      ],
+    };
+    expect(audited.appliedPromotions).toHaveLength(2);
+    expect(audited.appliedPromotion?.promotionId).toBe(audited.appliedPromotions?.[0].promotionId);
+  });
+});

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

@@ -110,8 +110,12 @@ describe('ChangeStorePolicyStatusRequest', () => {
   });
 
   it('rechaza un estado que no existe', async () => {
-    expect(await errorProperties({ status: 'ARCHIVED' }, ChangeStorePolicyStatusRequest)).toContain(
+    expect(await errorProperties({ status: 'CANCELLED' }, ChangeStorePolicyStatusRequest)).toContain(
       'status',
     );
   });
+
+  it('acepta ARCHIVED: es la baja lógica de la pantalla', async () => {
+    expect(await errorProperties({ status: 'ARCHIVED' }, ChangeStorePolicyStatusRequest)).toEqual([]);
+  });
 });

package/bin/loanCredit/dtos/AppliedStorePolicySnapshot.d.ts

@@ -0,0 +1,11 @@
+import { FoldableTermEnum } from '../../loanOfferings/enums/FoldableTermEnum';
+/**
+ * Política especial que ganó algún término de este crédito, congelada al cotizar. El catálogo de
+ * políticas es editable: sin esta copia, una edición posterior deja la cuota sin explicación.
+ */
+export interface AppliedStorePolicySnapshot {
+    policyId: string;
+    name: string;
+    /** Términos del plan que esta política ganó en el pliegue final. */
+    appliedTerms: FoldableTermEnum[];
+}

package/bin/loanCredit/dtos/AppliedStorePolicySnapshot.js

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

package/bin/loanCredit/dtos/CandidatePlanSnapshot.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `CreditPlan` que el motor consideró al cotizar este crédito, haya ganado algún término o no.
+ * Es lo que contesta por qué se cotizó con este plan y no con otro.
+ */
+export interface CandidatePlanSnapshot {
+    planId: string;
+    code: string;
+}

package/bin/loanCredit/dtos/CandidatePlanSnapshot.js

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

package/bin/loanCredit/dtos/EffectiveTermsSnapshot.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Cotas con las que se cotizó este crédito de verdad, ya pisadas por promociones y políticas.
+ * NO son las del plan: una promoción puede bajar el enganche mínimo o subir el techo de monto.
+ */
+export interface EffectiveTermsSnapshot {
+    /** 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;
+}

package/bin/loanCredit/dtos/EffectiveTermsSnapshot.js

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

package/bin/loanCredit/dtos/responses/LoanCreditResponse.d.ts

@@ -1,6 +1,9 @@
 import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
 import { AppliedPromotionSnapshot } from '../AppliedPromotionSnapshot';
+import { AppliedStorePolicySnapshot } from '../AppliedStorePolicySnapshot';
+import { CandidatePlanSnapshot } from '../CandidatePlanSnapshot';
+import { EffectiveTermsSnapshot } from '../EffectiveTermsSnapshot';
 /**
  * Response de los endpoints de LoanCredit (loan-credit-business). Montos en cents; TNA decimal.
  */
@@ -31,6 +34,21 @@ export interface LoanCreditResponse {
     clientLevelAtOrigination?: ClientLevelEnum;
     /** Promoción con la que se cotizó, o `null` si ninguna alcanzaba a esta venta. */
     appliedPromotion?: AppliedPromotionSnapshot | null;
+    /**
+     * TODAS las promociones aplicadas: `appliedPromotion` es la primaria y esto es la auditoría
+     * completa. Los términos de arriba YA las incluyen, no son un extra a sumar.
+     */
+    appliedPromotions?: AppliedPromotionSnapshot[] | null;
+    /** Políticas especiales que ganaron algún término: qué frenó o aflojó la cuota. */
+    appliedStorePolicies?: AppliedStorePolicySnapshot[] | null;
+    /** Los planes que compitieron: contesta por qué este plan y no otro. */
+    candidatePlans?: CandidatePlanSnapshot[] | null;
+    /** Edición del plan al originar: contesta con qué reglas se cotizó, aunque después se edite. */
+    planVersionAtOrigination?: number | null;
+    /** Segmentos del cliente al cotizar: contesta por qué le alcanzó esa promoción. */
+    segmentIdsAtQuote?: string[] | null;
+    /** Cotas con las que se cotizó de verdad, ya pisadas por promociones y políticas. */
+    effectiveTerms?: EffectiveTermsSnapshot | null;
     activatedAt?: string;
     voluntaryCancelDeadline?: string;
     firstDueDate?: string;

package/bin/loanCredit/index.d.ts

@@ -9,6 +9,9 @@ export * from './dtos/LoanInstallment';
 export * from './dtos/LoanContract';
 export * from './dtos/ActivationChecklist';
 export * from './dtos/AppliedPromotionSnapshot';
+export * from './dtos/AppliedStorePolicySnapshot';
+export * from './dtos/CandidatePlanSnapshot';
+export * from './dtos/EffectiveTermsSnapshot';
 export * from './dtos/requests/UpsertLoanBorrowerRequest';
 export * from './dtos/requests/OriginateLoanCreditRequest';
 export * from './dtos/requests/QuoteLoanCreditRequest';

package/bin/loanCredit/index.js

@@ -30,6 +30,9 @@ __exportStar(require("./dtos/LoanInstallment"), exports);
 __exportStar(require("./dtos/LoanContract"), exports);
 __exportStar(require("./dtos/ActivationChecklist"), exports);
 __exportStar(require("./dtos/AppliedPromotionSnapshot"), exports);
+__exportStar(require("./dtos/AppliedStorePolicySnapshot"), exports);
+__exportStar(require("./dtos/CandidatePlanSnapshot"), exports);
+__exportStar(require("./dtos/EffectiveTermsSnapshot"), exports);
 // Request DTOs
 __exportStar(require("./dtos/requests/UpsertLoanBorrowerRequest"), exports);
 __exportStar(require("./dtos/requests/OriginateLoanCreditRequest"), exports);

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

@@ -1,7 +1,8 @@
 import { PromotionStatusEnum } from '../../enums/PromotionStatusEnum';
 /**
- * Body de PUT /promotions/:promotionId/status — publicar, pausar, reanudar o vencer.
- * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`.
+ * Body de PUT /promotions/:promotionId/status — publicar, pausar, reanudar, vencer o archivar.
+ * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`, y
+ * `ARCHIVED` desde cualquier estado no terminal.
  * `reason` acompaña la pausa y queda en la bitácora.
  */
 export declare class ChangePromotionStatusRequest {

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

@@ -14,8 +14,9 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const PromotionStatusEnum_1 = require("../../enums/PromotionStatusEnum");
 /**
- * Body de PUT /promotions/:promotionId/status — publicar, pausar, reanudar o vencer.
- * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`.
+ * Body de PUT /promotions/:promotionId/status — publicar, pausar, reanudar, vencer o archivar.
+ * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`, y
+ * `ARCHIVED` desde cualquier estado no terminal.
  * `reason` acompaña la pausa y queda en la bitácora.
  */
 class ChangePromotionStatusRequest {

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

@@ -1,7 +1,8 @@
 import { StorePolicyStatusEnum } from '../../enums/StorePolicyStatusEnum';
 /**
- * Body de PUT /store-policies/:policyId/status — publicar, pausar, reanudar o vencer.
- * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`.
+ * Body de PUT /store-policies/:policyId/status — publicar, pausar, reanudar, vencer o archivar.
+ * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`, y
+ * `ARCHIVED` desde cualquier estado no terminal.
  * `reason` acompaña el cambio y queda en la bitácora.
  */
 export declare class ChangeStorePolicyStatusRequest {

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

@@ -14,8 +14,9 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const StorePolicyStatusEnum_1 = require("../../enums/StorePolicyStatusEnum");
 /**
- * Body de PUT /store-policies/:policyId/status — publicar, pausar, reanudar o vencer.
- * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`.
+ * Body de PUT /store-policies/:policyId/status — publicar, pausar, reanudar, vencer o archivar.
+ * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`, y
+ * `ARCHIVED` desde cualquier estado no terminal.
  * `reason` acompaña el cambio y queda en la bitácora.
  */
 class ChangeStorePolicyStatusRequest {

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

@@ -1,3 +1,4 @@
+import { FoldableTermEnum } from '../../enums/FoldableTermEnum';
 import { PromotionEffectKindEnum } from '../../enums/PromotionEffectKindEnum';
 import { PlanTermProvenance } from './StorePolicyResponse';
 /**
@@ -27,6 +28,24 @@ export interface AppliedPromotionResponse {
     /** Palancas del plan que la promoción pisó. */
     appliedEffects: PromotionEffectKindEnum[];
 }
+/**
+ * Una `CreditPlan` que el paso Base consideró para esta venta, haya ganado algún término o no.
+ * Es lo que contesta por qué ganó este plan y no otro.
+ */
+export interface CandidatePlanResponse {
+    planId: string;
+    code: string;
+}
+/**
+ * Política especial que ganó al menos un término de esta cotización. Las políticas en alcance que
+ * no ganaron nada no se reportan: no explican la cuota.
+ */
+export interface AppliedStorePolicyResponse {
+    policyId: string;
+    name: string;
+    /** Términos del plan que esta política ganó en el pliegue final. */
+    appliedTerms: FoldableTermEnum[];
+}
 /**
  * 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.
@@ -84,4 +103,18 @@ export interface SimulationResultResponse {
      * Las cotas efectivas de ESTA cotización. Ausente si el lambda todavía no las emite.
      */
     effectiveTerms?: EffectiveTermsResponse;
+    /**
+     * Todas las `CreditPlan` candidatas del paso Base. Ausente si el lambda todavía no lo emite.
+     */
+    candidatePlans?: CandidatePlanResponse[];
+    /**
+     * TODAS las promociones aplicadas: `appliedPromotion` es la primaria y esto es la auditoría
+     * completa. Los montos de arriba YA las incluyen, no son un extra a sumar. Ausente si el
+     * lambda todavía no lo emite.
+     */
+    appliedPromotions?: AppliedPromotionResponse[];
+    /**
+     * Políticas especiales que ganaron algún término. Ausente si el lambda todavía no lo emite.
+     */
+    appliedStorePolicies?: AppliedStorePolicyResponse[];
 }

package/bin/loanOfferings/enums/FoldableTermEnum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Términos del plan que el motor de cotización pliega capa por capa (plan base, promociones,
+ * políticas especiales). El valor es la clave literal del término en el contrato.
+ * @enum {string}
+ */
+export declare enum FoldableTermEnum {
+    MIN_DOWN_PAYMENT_PCT = "minDownPaymentPct",
+    TNA_ANNUAL = "tnaAnnual",
+    MAX_FINANCED_AMOUNT_CENTS = "maxFinancedAmountCents"
+}

package/bin/loanOfferings/enums/FoldableTermEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FoldableTermEnum = void 0;
+/**
+ * Términos del plan que el motor de cotización pliega capa por capa (plan base, promociones,
+ * políticas especiales). El valor es la clave literal del término en el contrato.
+ * @enum {string}
+ */
+var FoldableTermEnum;
+(function (FoldableTermEnum) {
+    FoldableTermEnum["MIN_DOWN_PAYMENT_PCT"] = "minDownPaymentPct";
+    FoldableTermEnum["TNA_ANNUAL"] = "tnaAnnual";
+    FoldableTermEnum["MAX_FINANCED_AMOUNT_CENTS"] = "maxFinancedAmountCents";
+})(FoldableTermEnum || (exports.FoldableTermEnum = FoldableTermEnum = {}));

package/bin/loanOfferings/enums/PromotionLogEventEnum.d.ts

@@ -8,5 +8,6 @@ export declare enum PromotionLogEventEnum {
     PAUSE = "PAUSE",
     RESUME = "RESUME",
     EXPIRE = "EXPIRE",
-    UPDATE = "UPDATE"
+    UPDATE = "UPDATE",
+    ARCHIVE = "ARCHIVE"
 }

package/bin/loanOfferings/enums/PromotionLogEventEnum.js

@@ -13,4 +13,5 @@ var PromotionLogEventEnum;
     PromotionLogEventEnum["RESUME"] = "RESUME";
     PromotionLogEventEnum["EXPIRE"] = "EXPIRE";
     PromotionLogEventEnum["UPDATE"] = "UPDATE";
+    PromotionLogEventEnum["ARCHIVE"] = "ARCHIVE";
 })(PromotionLogEventEnum || (exports.PromotionLogEventEnum = PromotionLogEventEnum = {}));

package/bin/loanOfferings/enums/PromotionStatusEnum.d.ts

@@ -1,12 +1,14 @@
 /**
  * Estado PERSISTIDO de una promoción del motor (portal-admin-sk-promociones).
- * `EXPIRED` es terminal. La «fase» que ve el operador (programada / activa / vencida) NO se guarda:
- * se deriva de las fechas — ver `PromotionPhaseEnum`.
+ * `EXPIRED` y `ARCHIVED` son terminales. La «fase» que ve el operador (programada / activa /
+ * vencida) NO se guarda: se deriva de las fechas — ver `PromotionPhaseEnum`.
  * @enum {string}
  */
 export declare enum PromotionStatusEnum {
     DRAFT = "DRAFT",
     PUBLISHED = "PUBLISHED",
     PAUSED = "PAUSED",
-    EXPIRED = "EXPIRED"
+    EXPIRED = "EXPIRED",
+    /** Baja lógica: la fila sigue en la tabla para los créditos que la referencian, y sale de toda lectura de operación. */
+    ARCHIVED = "ARCHIVED"
 }

package/bin/loanOfferings/enums/PromotionStatusEnum.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PromotionStatusEnum = void 0;
 /**
  * Estado PERSISTIDO de una promoción del motor (portal-admin-sk-promociones).
- * `EXPIRED` es terminal. La «fase» que ve el operador (programada / activa / vencida) NO se guarda:
- * se deriva de las fechas — ver `PromotionPhaseEnum`.
+ * `EXPIRED` y `ARCHIVED` son terminales. La «fase» que ve el operador (programada / activa /
+ * vencida) NO se guarda: se deriva de las fechas — ver `PromotionPhaseEnum`.
  * @enum {string}
  */
 var PromotionStatusEnum;
@@ -13,4 +13,6 @@ var PromotionStatusEnum;
     PromotionStatusEnum["PUBLISHED"] = "PUBLISHED";
     PromotionStatusEnum["PAUSED"] = "PAUSED";
     PromotionStatusEnum["EXPIRED"] = "EXPIRED";
+    /** Baja lógica: la fila sigue en la tabla para los créditos que la referencian, y sale de toda lectura de operación. */
+    PromotionStatusEnum["ARCHIVED"] = "ARCHIVED";
 })(PromotionStatusEnum || (exports.PromotionStatusEnum = PromotionStatusEnum = {}));

package/bin/loanOfferings/enums/StorePolicyStatusEnum.d.ts

@@ -1,11 +1,13 @@
 /**
- * Estado PERSISTIDO de una política especial de tienda. `EXPIRED` es terminal. La fase que ve el
- * operador NO se guarda: se deriva de las fechas — ver `StorePolicyPhaseEnum`.
+ * Estado PERSISTIDO de una política especial de tienda. `EXPIRED` y `ARCHIVED` son terminales. La
+ * fase que ve el operador NO se guarda: se deriva de las fechas — ver `StorePolicyPhaseEnum`.
  * @enum {string}
  */
 export declare enum StorePolicyStatusEnum {
     DRAFT = "DRAFT",
     PUBLISHED = "PUBLISHED",
     PAUSED = "PAUSED",
-    EXPIRED = "EXPIRED"
+    EXPIRED = "EXPIRED",
+    /** Baja lógica: la fila sigue en la tabla para la bitácora y las cotizaciones ya emitidas, y sale de toda lectura de operación. */
+    ARCHIVED = "ARCHIVED"
 }

package/bin/loanOfferings/enums/StorePolicyStatusEnum.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StorePolicyStatusEnum = void 0;
 /**
- * Estado PERSISTIDO de una política especial de tienda. `EXPIRED` es terminal. La fase que ve el
- * operador NO se guarda: se deriva de las fechas — ver `StorePolicyPhaseEnum`.
+ * Estado PERSISTIDO de una política especial de tienda. `EXPIRED` y `ARCHIVED` son terminales. La
+ * fase que ve el operador NO se guarda: se deriva de las fechas — ver `StorePolicyPhaseEnum`.
  * @enum {string}
  */
 var StorePolicyStatusEnum;
@@ -12,4 +12,6 @@ var StorePolicyStatusEnum;
     StorePolicyStatusEnum["PUBLISHED"] = "PUBLISHED";
     StorePolicyStatusEnum["PAUSED"] = "PAUSED";
     StorePolicyStatusEnum["EXPIRED"] = "EXPIRED";
+    /** Baja lógica: la fila sigue en la tabla para la bitácora y las cotizaciones ya emitidas, y sale de toda lectura de operación. */
+    StorePolicyStatusEnum["ARCHIVED"] = "ARCHIVED";
 })(StorePolicyStatusEnum || (exports.StorePolicyStatusEnum = StorePolicyStatusEnum = {}));

package/bin/loanOfferings/index.d.ts

@@ -6,6 +6,7 @@ export * from './enums/FinancierTypeEnum';
 export * from './enums/FinancierStatusEnum';
 export * from './enums/PromotionStatusEnum';
 export * from './enums/PromotionEffectKindEnum';
+export * from './enums/FoldableTermEnum';
 export * from './enums/PromotionBonusStatusEnum';
 export * from './enums/PromotionPhaseEnum';
 export * from './enums/PromotionLogEventEnum';

package/bin/loanOfferings/index.js

@@ -23,6 +23,7 @@ __exportStar(require("./enums/FinancierTypeEnum"), exports);
 __exportStar(require("./enums/FinancierStatusEnum"), exports);
 __exportStar(require("./enums/PromotionStatusEnum"), exports);
 __exportStar(require("./enums/PromotionEffectKindEnum"), exports);
+__exportStar(require("./enums/FoldableTermEnum"), exports);
 __exportStar(require("./enums/PromotionBonusStatusEnum"), exports);
 __exportStar(require("./enums/PromotionPhaseEnum"), exports);
 __exportStar(require("./enums/PromotionLogEventEnum"), exports);

package/package.json

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

package/src/loanCredit/dtos/AppliedStorePolicySnapshot.ts

@@ -0,0 +1,12 @@
+import { FoldableTermEnum } from '../../loanOfferings/enums/FoldableTermEnum';
+
+/**
+ * Política especial que ganó algún término de este crédito, congelada al cotizar. El catálogo de
+ * políticas es editable: sin esta copia, una edición posterior deja la cuota sin explicación.
+ */
+export interface AppliedStorePolicySnapshot {
+    policyId: string;
+    name: string;
+    /** Términos del plan que esta política ganó en el pliegue final. */
+    appliedTerms: FoldableTermEnum[];
+}

package/src/loanCredit/dtos/CandidatePlanSnapshot.ts

@@ -0,0 +1,8 @@
+/**
+ * `CreditPlan` que el motor consideró al cotizar este crédito, haya ganado algún término o no.
+ * Es lo que contesta por qué se cotizó con este plan y no con otro.
+ */
+export interface CandidatePlanSnapshot {
+    planId: string;
+    code: string;
+}

package/src/loanCredit/dtos/EffectiveTermsSnapshot.ts

@@ -0,0 +1,12 @@
+/**
+ * Cotas con las que se cotizó este crédito de verdad, ya pisadas por promociones y políticas.
+ * NO son las del plan: una promoción puede bajar el enganche mínimo o subir el techo de monto.
+ */
+export interface EffectiveTermsSnapshot {
+    /** 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;
+}

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

@@ -1,6 +1,9 @@
 import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
 import { AppliedPromotionSnapshot } from '../AppliedPromotionSnapshot';
+import { AppliedStorePolicySnapshot } from '../AppliedStorePolicySnapshot';
+import { CandidatePlanSnapshot } from '../CandidatePlanSnapshot';
+import { EffectiveTermsSnapshot } from '../EffectiveTermsSnapshot';
 
 /**
  * Response de los endpoints de LoanCredit (loan-credit-business). Montos en cents; TNA decimal.
@@ -32,6 +35,21 @@ export interface LoanCreditResponse {
     clientLevelAtOrigination?: ClientLevelEnum;
     /** Promoción con la que se cotizó, o `null` si ninguna alcanzaba a esta venta. */
     appliedPromotion?: AppliedPromotionSnapshot | null;
+    /**
+     * TODAS las promociones aplicadas: `appliedPromotion` es la primaria y esto es la auditoría
+     * completa. Los términos de arriba YA las incluyen, no son un extra a sumar.
+     */
+    appliedPromotions?: AppliedPromotionSnapshot[] | null;
+    /** Políticas especiales que ganaron algún término: qué frenó o aflojó la cuota. */
+    appliedStorePolicies?: AppliedStorePolicySnapshot[] | null;
+    /** Los planes que compitieron: contesta por qué este plan y no otro. */
+    candidatePlans?: CandidatePlanSnapshot[] | null;
+    /** Edición del plan al originar: contesta con qué reglas se cotizó, aunque después se edite. */
+    planVersionAtOrigination?: number | null;
+    /** Segmentos del cliente al cotizar: contesta por qué le alcanzó esa promoción. */
+    segmentIdsAtQuote?: string[] | null;
+    /** Cotas con las que se cotizó de verdad, ya pisadas por promociones y políticas. */
+    effectiveTerms?: EffectiveTermsSnapshot | null;
     activatedAt?: string;
     voluntaryCancelDeadline?: string;
     firstDueDate?: string;

package/src/loanCredit/index.ts

@@ -13,6 +13,9 @@ export * from './dtos/LoanInstallment';
 export * from './dtos/LoanContract';
 export * from './dtos/ActivationChecklist';
 export * from './dtos/AppliedPromotionSnapshot';
+export * from './dtos/AppliedStorePolicySnapshot';
+export * from './dtos/CandidatePlanSnapshot';
+export * from './dtos/EffectiveTermsSnapshot';
 
 // Request DTOs
 export * from './dtos/requests/UpsertLoanBorrowerRequest';

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

@@ -3,8 +3,9 @@ import { IsEnum, IsOptional, IsString } from 'class-validator';
 import { PromotionStatusEnum } from '../../enums/PromotionStatusEnum';
 
 /**
- * Body de PUT /promotions/:promotionId/status — publicar, pausar, reanudar o vencer.
- * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`.
+ * Body de PUT /promotions/:promotionId/status — publicar, pausar, reanudar, vencer o archivar.
+ * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`, y
+ * `ARCHIVED` desde cualquier estado no terminal.
  * `reason` acompaña la pausa y queda en la bitácora.
  */
 export class ChangePromotionStatusRequest {

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

@@ -3,8 +3,9 @@ import { IsEnum, IsOptional, IsString, MaxLength } from 'class-validator';
 import { StorePolicyStatusEnum } from '../../enums/StorePolicyStatusEnum';
 
 /**
- * Body de PUT /store-policies/:policyId/status — publicar, pausar, reanudar o vencer.
- * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`.
+ * Body de PUT /store-policies/:policyId/status — publicar, pausar, reanudar, vencer o archivar.
+ * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`, y
+ * `ARCHIVED` desde cualquier estado no terminal.
  * `reason` acompaña el cambio y queda en la bitácora.
  */
 export class ChangeStorePolicyStatusRequest {

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

@@ -1,3 +1,4 @@
+import { FoldableTermEnum } from '../../enums/FoldableTermEnum';
 import { PromotionEffectKindEnum } from '../../enums/PromotionEffectKindEnum';
 import { PlanTermProvenance } from './StorePolicyResponse';
 
@@ -30,6 +31,26 @@ export interface AppliedPromotionResponse {
     appliedEffects: PromotionEffectKindEnum[];
 }
 
+/**
+ * Una `CreditPlan` que el paso Base consideró para esta venta, haya ganado algún término o no.
+ * Es lo que contesta por qué ganó este plan y no otro.
+ */
+export interface CandidatePlanResponse {
+    planId: string;
+    code: string;
+}
+
+/**
+ * Política especial que ganó al menos un término de esta cotización. Las políticas en alcance que
+ * no ganaron nada no se reportan: no explican la cuota.
+ */
+export interface AppliedStorePolicyResponse {
+    policyId: string;
+    name: string;
+    /** Términos del plan que esta política ganó en el pliegue final. */
+    appliedTerms: FoldableTermEnum[];
+}
+
 /**
  * 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.
@@ -88,4 +109,18 @@ export interface SimulationResultResponse {
      * Las cotas efectivas de ESTA cotización. Ausente si el lambda todavía no las emite.
      */
     effectiveTerms?: EffectiveTermsResponse;
+    /**
+     * Todas las `CreditPlan` candidatas del paso Base. Ausente si el lambda todavía no lo emite.
+     */
+    candidatePlans?: CandidatePlanResponse[];
+    /**
+     * TODAS las promociones aplicadas: `appliedPromotion` es la primaria y esto es la auditoría
+     * completa. Los montos de arriba YA las incluyen, no son un extra a sumar. Ausente si el
+     * lambda todavía no lo emite.
+     */
+    appliedPromotions?: AppliedPromotionResponse[];
+    /**
+     * Políticas especiales que ganaron algún término. Ausente si el lambda todavía no lo emite.
+     */
+    appliedStorePolicies?: AppliedStorePolicyResponse[];
 }

package/src/loanOfferings/enums/FoldableTermEnum.ts

@@ -0,0 +1,10 @@
+/**
+ * Términos del plan que el motor de cotización pliega capa por capa (plan base, promociones,
+ * políticas especiales). El valor es la clave literal del término en el contrato.
+ * @enum {string}
+ */
+export enum FoldableTermEnum {
+    MIN_DOWN_PAYMENT_PCT = 'minDownPaymentPct',
+    TNA_ANNUAL = 'tnaAnnual',
+    MAX_FINANCED_AMOUNT_CENTS = 'maxFinancedAmountCents',
+}

package/src/loanOfferings/enums/PromotionLogEventEnum.ts

@@ -9,4 +9,5 @@ export enum PromotionLogEventEnum {
     RESUME = 'RESUME',
     EXPIRE = 'EXPIRE',
     UPDATE = 'UPDATE',
+    ARCHIVE = 'ARCHIVE',
 }

package/src/loanOfferings/enums/PromotionStatusEnum.ts

@@ -1,7 +1,7 @@
 /**
  * Estado PERSISTIDO de una promoción del motor (portal-admin-sk-promociones).
- * `EXPIRED` es terminal. La «fase» que ve el operador (programada / activa / vencida) NO se guarda:
- * se deriva de las fechas — ver `PromotionPhaseEnum`.
+ * `EXPIRED` y `ARCHIVED` son terminales. La «fase» que ve el operador (programada / activa /
+ * vencida) NO se guarda: se deriva de las fechas — ver `PromotionPhaseEnum`.
  * @enum {string}
  */
 export enum PromotionStatusEnum {
@@ -9,4 +9,6 @@ export enum PromotionStatusEnum {
     PUBLISHED = 'PUBLISHED',
     PAUSED = 'PAUSED',
     EXPIRED = 'EXPIRED',
+    /** Baja lógica: la fila sigue en la tabla para los créditos que la referencian, y sale de toda lectura de operación. */
+    ARCHIVED = 'ARCHIVED',
 }

package/src/loanOfferings/enums/StorePolicyStatusEnum.ts

@@ -1,6 +1,6 @@
 /**
- * Estado PERSISTIDO de una política especial de tienda. `EXPIRED` es terminal. La fase que ve el
- * operador NO se guarda: se deriva de las fechas — ver `StorePolicyPhaseEnum`.
+ * Estado PERSISTIDO de una política especial de tienda. `EXPIRED` y `ARCHIVED` son terminales. La
+ * fase que ve el operador NO se guarda: se deriva de las fechas — ver `StorePolicyPhaseEnum`.
  * @enum {string}
  */
 export enum StorePolicyStatusEnum {
@@ -8,4 +8,6 @@ export enum StorePolicyStatusEnum {
     PUBLISHED = 'PUBLISHED',
     PAUSED = 'PAUSED',
     EXPIRED = 'EXPIRED',
+    /** Baja lógica: la fila sigue en la tabla para la bitácora y las cotizaciones ya emitidas, y sale de toda lectura de operación. */
+    ARCHIVED = 'ARCHIVED',
 }

package/src/loanOfferings/index.ts

@@ -7,6 +7,7 @@ export * from './enums/FinancierTypeEnum';
 export * from './enums/FinancierStatusEnum';
 export * from './enums/PromotionStatusEnum';
 export * from './enums/PromotionEffectKindEnum';
+export * from './enums/FoldableTermEnum';
 export * from './enums/PromotionBonusStatusEnum';
 export * from './enums/PromotionPhaseEnum';
 export * from './enums/PromotionLogEventEnum';