@fiado/type-kit 3.196.0 → 3.199.0

package/bin/loanScoring/dtos/ScoringDecision.d.ts

@@ -0,0 +1,29 @@
+import { ClientLevelEnum } from '../enums/ClientLevelEnum';
+import { ScoringDecisionEnum } from '../enums/ScoringDecisionEnum';
+import { ScoringProviderEnum } from '../enums/ScoringProviderEnum';
+import { SciBreakdown } from './SciBreakdown';
+import { ScoringOffer } from './ScoringOffer';
+/**
+ * Contrato AGNÓSTICO de salida del scoring (diagramas F2 §credito · patrón spec 12): todos los
+ * proveedores (Modelias decisión-directa, Círculo insumos+SCI M7, futuros) normalizan a esta forma.
+ * El consumidor (wizard paso 05, motor de crédito) NO sabe qué proveedor la produjo; el proveedor
+ * usado queda snapshoteado en la evaluación (`LoanSciEvaluation_GT`).
+ */
+export interface ScoringDecision {
+    provider: ScoringProviderEnum;
+    /** Score en la escala canónica SCI 0-100 (C2 resuelta: la escala es 0-100). */
+    sciTotal: number;
+    level: ClientLevelEnum;
+    decision: ScoringDecisionEnum;
+    /** Oferta pre-aprobada si el proveedor la entrega (Modelias); null en el camino Círculo+SCI. */
+    offer: ScoringOffer | null;
+    /**
+     * Thin-file (M7 §3 / INT4): el proveedor CONFIRMÓ que la persona no tiene historial en buró.
+     * Es un dato de negocio válido (capa 2 neutra o FIS) — NUNCA se confunde con un error del
+     * connector (ese camino lanza DomainError; antipatrón API_ADAPTER_SWALLOW).
+     */
+    thinFile: boolean;
+    breakdown: SciBreakdown;
+    /** Marcas/flags del proveedor (`marcas` de Modelias). Vacío si no aplica. */
+    flags: string[];
+}

package/bin/loanScoring/dtos/ScoringDecision.js

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

package/bin/loanScoring/dtos/ScoringOffer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Oferta pre-aprobada que acompaña una decisión de scoring (cuando el proveedor la entrega —
+ * Modelias la devuelve completa; el camino Círculo+SCI no produce oferta, el plan lo resuelve
+ * loan-offerings por nivel).
+ *
+ * ⚠️ Los valores numéricos se transportan TAL CUAL los entrega el proveedor (el contrato Modelias
+ * no confirma unidades de `linea_credito`/`enganche` — ver TD del módulo modelias). NO asumir cents.
+ */
+export interface ScoringOffer {
+    /** Línea de crédito aprobada (unidad según proveedor). */
+    creditLine: number | null;
+    /** Enganche requerido (unidad/base según proveedor). */
+    downPayment: number | null;
+    /** Plazos ofrecidos, en semanas. */
+    termsWeeks: number[];
+    /** Tasas por plazo (clave = plazo, valor = tasa decimal). */
+    rates: Record<string, number>;
+}

package/bin/loanScoring/dtos/ScoringOffer.js

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

package/bin/loanScoring/dtos/requests/EvaluateSciRequest.d.ts

@@ -0,0 +1,23 @@
+import { SciInternalHistoryInput } from './SciInternalHistoryInput';
+/**
+ * Body de `POST /private/scoring/evaluations` de loan-scoring-business (wizard paso 05 / motor de
+ * crédito, vía api-invoker). El proveedor NO se elige acá: lo resuelve el `ScoringProviderRouter`
+ * por configuración del tenant (spec 12). El tenant viaja por query `?tenantId=` (convención de
+ * los privados Fiado), no en este body.
+ */
+export declare class EvaluateSciRequest {
+    /** Acreditado a evaluar (`LoanBorrower`). La evaluación queda ligada a él en el historial. */
+    borrowerId: string;
+    /** CURP del solicitante (requerido por los proveedores de scoring). */
+    curp: string;
+    /** Celular del solicitante (requerido por Modelias). */
+    cellphone: string;
+    email?: string;
+    /**
+     * Resultado del gate anti-fraude (M7 §2 — KYC/Metamap, se ejecuta UNA vez en el paso 01/02
+     * del wizard). El caller lo declara: `false` → decisión REJECTED sin consultar proveedor.
+     */
+    antiFraudPassed: boolean;
+    /** Historial interno del acreditado (capa 3). Ausente = cliente nuevo (capa 2 pesa 100%). */
+    internalHistory?: SciInternalHistoryInput;
+}

package/bin/loanScoring/dtos/requests/EvaluateSciRequest.js

@@ -0,0 +1,54 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluateSciRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SciInternalHistoryInput_1 = require("./SciInternalHistoryInput");
+/**
+ * Body de `POST /private/scoring/evaluations` de loan-scoring-business (wizard paso 05 / motor de
+ * crédito, vía api-invoker). El proveedor NO se elige acá: lo resuelve el `ScoringProviderRouter`
+ * por configuración del tenant (spec 12). El tenant viaja por query `?tenantId=` (convención de
+ * los privados Fiado), no en este body.
+ */
+class EvaluateSciRequest {
+}
+exports.EvaluateSciRequest = EvaluateSciRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], EvaluateSciRequest.prototype, "borrowerId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], EvaluateSciRequest.prototype, "curp", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], EvaluateSciRequest.prototype, "cellphone", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], EvaluateSciRequest.prototype, "email", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], EvaluateSciRequest.prototype, "antiFraudPassed", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => SciInternalHistoryInput_1.SciInternalHistoryInput),
+    __metadata("design:type", SciInternalHistoryInput_1.SciInternalHistoryInput)
+], EvaluateSciRequest.prototype, "internalHistory", void 0);

package/bin/loanScoring/dtos/requests/SciInternalHistoryInput.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resumen del historial interno SureKeep del acreditado (M7 §4 — capa 3 del SCI). Lo aporta el
+ * caller (loan-credit-business es el dueño de cuotas/moras); ausente = cliente sin historial
+ * interno (la capa 2 pesa 100% — M7 §5).
+ */
+export declare class SciInternalHistoryInput {
+    /** % de cuotas pagadas a tiempo, 0-100 (peso 30%). */
+    pctOnTimeInstallments: number;
+    /** Días promedio de atraso (peso 20%). */
+    avgDelinquencyDays: number;
+    /** Episodios de mora (peso 20%). */
+    delinquencyEpisodes: number;
+    /** Reestructuras (peso 15%; máx 1 por crédito — M2). */
+    restructures: number;
+    /** Créditos completados sin mora (peso 10%). */
+    completedCredits: number;
+    /** Baja contable previa (peso 5% — penaliza fuerte). */
+    previousWriteOff: boolean;
+}

package/bin/loanScoring/dtos/requests/SciInternalHistoryInput.js

@@ -0,0 +1,51 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SciInternalHistoryInput = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Resumen del historial interno SureKeep del acreditado (M7 §4 — capa 3 del SCI). Lo aporta el
+ * caller (loan-credit-business es el dueño de cuotas/moras); ausente = cliente sin historial
+ * interno (la capa 2 pesa 100% — M7 §5).
+ */
+class SciInternalHistoryInput {
+}
+exports.SciInternalHistoryInput = SciInternalHistoryInput;
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], SciInternalHistoryInput.prototype, "pctOnTimeInstallments", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], SciInternalHistoryInput.prototype, "avgDelinquencyDays", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], SciInternalHistoryInput.prototype, "delinquencyEpisodes", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], SciInternalHistoryInput.prototype, "restructures", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], SciInternalHistoryInput.prototype, "completedCredits", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], SciInternalHistoryInput.prototype, "previousWriteOff", void 0);

package/bin/loanScoring/dtos/responses/EvaluateSciResponse.d.ts

@@ -0,0 +1,24 @@
+import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { ScoringDecisionEnum } from '../../enums/ScoringDecisionEnum';
+import { ScoringProviderEnum } from '../../enums/ScoringProviderEnum';
+import { SciBreakdown } from '../SciBreakdown';
+import { ScoringOffer } from '../ScoringOffer';
+/**
+ * Response de `POST /private/scoring/evaluations`: la `ScoringDecision` normalizada + la identidad
+ * del snapshot persistido en `LoanSciEvaluation_GT` (el motor de crédito guarda `evaluationId`
+ * como `sciAtOrigination`).
+ */
+export interface EvaluateSciResponse {
+    evaluationId: string;
+    borrowerId: string;
+    provider: ScoringProviderEnum;
+    /** Escala canónica SCI 0-100. */
+    sciTotal: number;
+    level: ClientLevelEnum;
+    decision: ScoringDecisionEnum;
+    offer: ScoringOffer | null;
+    thinFile: boolean;
+    breakdown: SciBreakdown;
+    flags: string[];
+    createdAt: string;
+}

package/bin/loanScoring/dtos/responses/EvaluateSciResponse.js

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

package/bin/loanScoring/dtos/responses/SciEvaluationResponse.d.ts

@@ -0,0 +1,28 @@
+import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { ScoringDecisionEnum } from '../../enums/ScoringDecisionEnum';
+import { ScoringProviderEnum } from '../../enums/ScoringProviderEnum';
+import { SciBreakdown } from '../SciBreakdown';
+import { ScoringOffer } from '../ScoringOffer';
+/**
+ * Detalle de una evaluación SCI snapshoteada en `LoanSciEvaluation_GT` (lecturas: detalle e
+ * historial por acreditado del backoffice, y GET privado del motor de crédito). Incluye la
+ * metadata de auditoría del snapshot.
+ */
+export interface SciEvaluationResponse {
+    evaluationId: string;
+    borrowerId: string;
+    provider: ScoringProviderEnum;
+    /** Escala canónica SCI 0-100. */
+    sciTotal: number;
+    level: ClientLevelEnum;
+    decision: ScoringDecisionEnum;
+    offer: ScoringOffer | null;
+    thinFile: boolean;
+    breakdown: SciBreakdown;
+    flags: string[];
+    version: number;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/bin/loanScoring/dtos/responses/SciEvaluationResponse.js

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

package/bin/loanScoring/enums/ClientLevelEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Nivel del cliente derivado del SCI (M7 §5: 0-20 no elegible · 21-60 bronce · 61-80 plata ·
+ * 81-100 oro). Valores en inglés alineados con `CreditPlanLevelEnum` de loanOfferings
+ * (BRONZE/SILVER/GOLD) — el plan de crédito se resuelve cruzando este nivel con el catálogo.
+ * `NOT_ELIGIBLE` no existe en el catálogo de planes: significa "no se ofrece crédito".
+ * @enum {string}
+ */
+export declare enum ClientLevelEnum {
+    NOT_ELIGIBLE = "NOT_ELIGIBLE",
+    BRONZE = "BRONZE",
+    SILVER = "SILVER",
+    GOLD = "GOLD"
+}

package/bin/loanScoring/enums/ClientLevelEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientLevelEnum = void 0;
+/**
+ * Nivel del cliente derivado del SCI (M7 §5: 0-20 no elegible · 21-60 bronce · 61-80 plata ·
+ * 81-100 oro). Valores en inglés alineados con `CreditPlanLevelEnum` de loanOfferings
+ * (BRONZE/SILVER/GOLD) — el plan de crédito se resuelve cruzando este nivel con el catálogo.
+ * `NOT_ELIGIBLE` no existe en el catálogo de planes: significa "no se ofrece crédito".
+ * @enum {string}
+ */
+var ClientLevelEnum;
+(function (ClientLevelEnum) {
+    ClientLevelEnum["NOT_ELIGIBLE"] = "NOT_ELIGIBLE";
+    ClientLevelEnum["BRONZE"] = "BRONZE";
+    ClientLevelEnum["SILVER"] = "SILVER";
+    ClientLevelEnum["GOLD"] = "GOLD";
+})(ClientLevelEnum || (exports.ClientLevelEnum = ClientLevelEnum = {}));

package/bin/loanScoring/enums/SciLayer2SourceEnum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Fuente de la capa 2 (buró) del SCI — M7 §3 + INT4 v2.0 (thin-file):
+ * `FICO` = historial pleno en Círculo · `FIS` = thin-file con Financial Inclusion Score
+ * (INT4 v2.0 supersede el "50 neutro" de M7 §3) · `NEUTRAL` = sin dato de buró (SCI base 50).
+ * @enum {string}
+ */
+export declare enum SciLayer2SourceEnum {
+    FICO = "FICO",
+    FIS = "FIS",
+    NEUTRAL = "NEUTRAL"
+}

package/bin/loanScoring/enums/SciLayer2SourceEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SciLayer2SourceEnum = void 0;
+/**
+ * Fuente de la capa 2 (buró) del SCI — M7 §3 + INT4 v2.0 (thin-file):
+ * `FICO` = historial pleno en Círculo · `FIS` = thin-file con Financial Inclusion Score
+ * (INT4 v2.0 supersede el "50 neutro" de M7 §3) · `NEUTRAL` = sin dato de buró (SCI base 50).
+ * @enum {string}
+ */
+var SciLayer2SourceEnum;
+(function (SciLayer2SourceEnum) {
+    SciLayer2SourceEnum["FICO"] = "FICO";
+    SciLayer2SourceEnum["FIS"] = "FIS";
+    SciLayer2SourceEnum["NEUTRAL"] = "NEUTRAL";
+})(SciLayer2SourceEnum || (exports.SciLayer2SourceEnum = SciLayer2SourceEnum = {}));

package/bin/loanScoring/enums/ScoringDecisionEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Decisión agnóstica del scoring (contrato `ScoringDecision`): el motor de crédito NO sabe qué
+ * proveedor la produjo (regla spec 12).
+ * - `APPROVED`: SCI dentro de un nivel elegible (o ACEPTADO directo de Modelias).
+ * - `REJECTED`: gate anti-fraude no pasó (M7 §2) o RECHAZADO directo del proveedor.
+ * - `NO_ELIGIBLE`: pasó el gate pero el SCI quedó bajo el piso (`SCORING/sci_min_eligible`,
+ *   rango 0-20 de M7 §5) — no se ofrece crédito SureKeep (se puede derivar a financiera externa).
+ * @enum {string}
+ */
+export declare enum ScoringDecisionEnum {
+    APPROVED = "APPROVED",
+    REJECTED = "REJECTED",
+    NO_ELIGIBLE = "NO_ELIGIBLE"
+}

package/bin/loanScoring/enums/ScoringDecisionEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScoringDecisionEnum = void 0;
+/**
+ * Decisión agnóstica del scoring (contrato `ScoringDecision`): el motor de crédito NO sabe qué
+ * proveedor la produjo (regla spec 12).
+ * - `APPROVED`: SCI dentro de un nivel elegible (o ACEPTADO directo de Modelias).
+ * - `REJECTED`: gate anti-fraude no pasó (M7 §2) o RECHAZADO directo del proveedor.
+ * - `NO_ELIGIBLE`: pasó el gate pero el SCI quedó bajo el piso (`SCORING/sci_min_eligible`,
+ *   rango 0-20 de M7 §5) — no se ofrece crédito SureKeep (se puede derivar a financiera externa).
+ * @enum {string}
+ */
+var ScoringDecisionEnum;
+(function (ScoringDecisionEnum) {
+    ScoringDecisionEnum["APPROVED"] = "APPROVED";
+    ScoringDecisionEnum["REJECTED"] = "REJECTED";
+    ScoringDecisionEnum["NO_ELIGIBLE"] = "NO_ELIGIBLE";
+})(ScoringDecisionEnum || (exports.ScoringDecisionEnum = ScoringDecisionEnum = {}));

package/bin/loanScoring/enums/ScoringProviderEnum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Proveedor de scoring soportado por el `ScoringProviderRouter` de loan-scoring-business
+ * (diagramas F2 §credito · patrón spec 12): la selección es configurable per-tenant y SOLO el
+ * router conoce el proveedor. Extensible: un proveedor nuevo = un valor nuevo + su adapter.
+ * @enum {string}
+ */
+export declare enum ScoringProviderEnum {
+    /** modelias-connector — devuelve la decisión COMPLETA (score, decisión, línea, enganche, plazos, tasas). */
+    MODELIAS = "MODELIAS",
+    /** Connector de CONSULTA a Círculo de Crédito — devuelve insumos crudos; el SCI (M7) se calcula local. */
+    CIRCULO = "CIRCULO"
+}

package/bin/loanScoring/enums/ScoringProviderEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScoringProviderEnum = void 0;
+/**
+ * Proveedor de scoring soportado por el `ScoringProviderRouter` de loan-scoring-business
+ * (diagramas F2 §credito · patrón spec 12): la selección es configurable per-tenant y SOLO el
+ * router conoce el proveedor. Extensible: un proveedor nuevo = un valor nuevo + su adapter.
+ * @enum {string}
+ */
+var ScoringProviderEnum;
+(function (ScoringProviderEnum) {
+    /** modelias-connector — devuelve la decisión COMPLETA (score, decisión, línea, enganche, plazos, tasas). */
+    ScoringProviderEnum["MODELIAS"] = "MODELIAS";
+    /** Connector de CONSULTA a Círculo de Crédito — devuelve insumos crudos; el SCI (M7) se calcula local. */
+    ScoringProviderEnum["CIRCULO"] = "CIRCULO";
+})(ScoringProviderEnum || (exports.ScoringProviderEnum = ScoringProviderEnum = {}));

package/bin/loanScoring/index.d.ts

@@ -0,0 +1,11 @@
+export * from './enums/ScoringProviderEnum';
+export * from './enums/ClientLevelEnum';
+export * from './enums/ScoringDecisionEnum';
+export * from './enums/SciLayer2SourceEnum';
+export * from './dtos/ScoringDecision';
+export * from './dtos/ScoringOffer';
+export * from './dtos/SciBreakdown';
+export * from './dtos/requests/EvaluateSciRequest';
+export * from './dtos/requests/SciInternalHistoryInput';
+export * from './dtos/responses/EvaluateSciResponse';
+export * from './dtos/responses/SciEvaluationResponse';

package/bin/loanScoring/index.js

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Enums
+__exportStar(require("./enums/ScoringProviderEnum"), exports);
+__exportStar(require("./enums/ClientLevelEnum"), exports);
+__exportStar(require("./enums/ScoringDecisionEnum"), exports);
+__exportStar(require("./enums/SciLayer2SourceEnum"), exports);
+// Contrato agnóstico + shapes compartidos
+__exportStar(require("./dtos/ScoringDecision"), exports);
+__exportStar(require("./dtos/ScoringOffer"), exports);
+__exportStar(require("./dtos/SciBreakdown"), exports);
+// Request DTOs
+__exportStar(require("./dtos/requests/EvaluateSciRequest"), exports);
+__exportStar(require("./dtos/requests/SciInternalHistoryInput"), exports);
+// Response DTOs
+__exportStar(require("./dtos/responses/EvaluateSciResponse"), exports);
+__exportStar(require("./dtos/responses/SciEvaluationResponse"), exports);

package/package.json

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

package/src/creditEngine/dtos/AnticipatedPaymentQuote.ts

@@ -0,0 +1,56 @@
+import { PaymentScheduleItemResponse } from "./PaymentScheduleItemResponse";
+
+/**
+ * Preview / cotizacion de un abono a capital (ANTICIPATED) antes de ejecutarlo.
+ *
+ * Reusa el mismo motor de recalculo que la ejecucion real
+ * (ScheduleRecalculationService.redistributeCapital) — no persiste nada.
+ *
+ * Regla de negocio: el abono acorta la cuota semanal, NO el plazo. El numero
+ * de cupones se mantiene igual; los PENDING se re-amortizan sobre el nuevo
+ * saldo, los PARTIAL se escalan proporcionalmente y los PAID quedan intactos.
+ */
+export class AnticipatedPaymentQuote {
+    creditId!: string;
+
+    /** Monto que el usuario propuso, capeado al outstanding real del credito. */
+    amountMxn!: number;
+
+    /** Estado actual (as-is) del credito, antes de aplicar el abono. */
+    current!: AnticipatedPaymentSummary;
+
+    /** Estado proyectado (as-if) despues de aplicar el abono. */
+    after!: AnticipatedPaymentSummary;
+
+    /** Diferencia entre `current` y `after` — cuanto ahorra el usuario. */
+    savings!: AnticipatedPaymentSavings;
+
+    /**
+     * Calendario completo proyectado (todos los cupones: PAID historicos,
+     * PARTIAL escalados, PENDING re-amortizados). Mismo shape que
+     * `GET /credit/{creditId}/schedule` para que el frontend renderice con
+     * el mismo componente.
+     */
+    newSchedule!: PaymentScheduleItemResponse[];
+
+    /** ISO timestamp de la cotizacion. */
+    quoteDate!: string;
+}
+
+export class AnticipatedPaymentSummary {
+    /** Cuota semanal vigente. */
+    weeklyPaymentMxn!: number;
+    /** Saldo insoluto (capital pendiente). */
+    outstandingMxn!: number;
+    /** Cupones que aun no estan PAID (incluye PARTIAL). */
+    remainingCoupons!: number;
+    /** Total pendiente a pagar (capital + interes + IVA de cupones no PAID). */
+    totalToPayMxn!: number;
+}
+
+export class AnticipatedPaymentSavings {
+    /** Reduccion en la cuota semanal (current - after). */
+    weeklyMxn!: number;
+    /** Reduccion total en intereses + IVA a pagar (current - after). */
+    totalInterestMxn!: number;
+}

package/src/creditEngine/index.ts

@@ -18,3 +18,4 @@ export * from './dtos/CreditSignatureResult';
 export * from './dtos/EarlyPaymentResult';
 export * from './dtos/OfferResult';
 export * from './dtos/SettlementQuote';
+export * from './dtos/AnticipatedPaymentQuote';

package/src/index.ts

@@ -123,5 +123,12 @@ export * as LoanOfferings from './loanOfferings';
 // LoanCollectorAssignment: DTOs/enums del lambda loan-collector-assignment-business (comp 08 — reglas de
 // asignación de cartera de cobranza + asignaciones crédito↔cobrador; SureKeep Fase 1 — pista Loan).
 export * as LoanCollectorAssignment from './loanCollectorAssignment';
+// LoanCredit: DTOs/enums del lambda loan-credit-business (comp 09 F2/F3 — motor de crédito SOFOM:
+// acreditado, crédito, plan de cuotas con amortización francesa + IVA 16%; SureKeep — pista Loan).
+export * as LoanCredit from './loanCredit';
+// LoanScoring: DTOs/enums del lambda loan-scoring-business (comp 08 F2 — SCI M7 de 3 capas +
+// ScoringProviderRouter configurable Modelias|Círculo con contrato agnóstico ScoringDecision;
+// SureKeep Fase 2 — pista Loan/SOFOM).
+export * as LoanScoring from './loanScoring';
 export * from './messaging';
 export * from './complaint';

package/src/loanCredit/dtos/ActivationChecklist.ts

@@ -0,0 +1,25 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean } from 'class-validator';
+
+/**
+ * Las 4 condiciones de activación del crédito (M2 §5 / 05_MOTOR §7). El crédito solo puede pasar a
+ * `ACTIVE` cuando las 4 son `true`. `downPayment`/`contractSigned` las marca la firma del contrato;
+ * `imeiEnrolled`/`lockVerified` las marca el enrolamiento MDM.
+ */
+export class ActivationChecklist {
+    @Expose()
+    @IsBoolean()
+    downPayment!: boolean;
+
+    @Expose()
+    @IsBoolean()
+    contractSigned!: boolean;
+
+    @Expose()
+    @IsBoolean()
+    imeiEnrolled!: boolean;
+
+    @Expose()
+    @IsBoolean()
+    lockVerified!: boolean;
+}

package/src/loanCredit/dtos/LoanBeneficiary.ts

@@ -0,0 +1,22 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
+
+/**
+ * Beneficiario declarado por el acreditado (modelo-datos §5b `LoanBorrower.beneficiary`).
+ */
+export class LoanBeneficiary {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    fullName!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    relationship?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    phone?: string;
+}

package/src/loanCredit/dtos/LoanBorrower.ts

@@ -0,0 +1,71 @@
+import { Expose, Type } from 'class-transformer';
+import {
+    IsInt,
+    IsEnum,
+    IsOptional,
+    IsString,
+    Matches,
+    Max,
+    Min,
+    ValidateNested,
+} from 'class-validator';
+import { regexIso8601 } from '../../helpers/constans/regex';
+import { ClientLevelEnum } from '../../loanScoring/enums/ClientLevelEnum';
+import { LoanBeneficiary } from './LoanBeneficiary';
+
+/**
+ * LoanBorrower — el acreditado de la SOFOM (modelo-datos §5b · owner `loan-credit-business`).
+ * Se hidrata desde el evento `CustomerKycVerifiedV1` de retail-customer (idempotente por
+ * `retailCustomerId`). `sciScore`/`clientLevel` los actualiza loan-scoring tras cada evaluación.
+ */
+export class LoanBorrower {
+    @Expose()
+    @IsString()
+    borrowerId!: string;
+
+    /** FK al comprador de retail (`RetailCustomer` — owner retail-customer-business). */
+    @Expose()
+    @IsString()
+    retailCustomerId!: string;
+
+    /** SCI vigente 0-100 (M7). Ausente hasta la primera evaluación. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    sciScore?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(ClientLevelEnum)
+    clientLevel?: ClientLevelEnum;
+
+    /** Score FICO/FIS del buró en la última consulta (Círculo de Crédito). */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    bureauScore?: number;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => LoanBeneficiary)
+    beneficiary?: LoanBeneficiary;
+
+    @Expose()
+    @IsString()
+    createdBy!: string;
+
+    @Expose()
+    @IsString()
+    updatedBy!: string;
+
+    @Expose()
+    @Matches(regexIso8601)
+    createdAt!: string;
+
+    @Expose()
+    @Matches(regexIso8601)
+    updatedAt!: string;
+}