@fiado/type-kit 3.198.0 → 3.199.0

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

@@ -1,4 +1,4 @@
-import { ClientLevelEnum } from '../enums/ClientLevelEnum';
+import { ClientLevelEnum } from '../../loanScoring/enums/ClientLevelEnum';
 import { LoanBeneficiary } from './LoanBeneficiary';
 /**
  * LoanBorrower — el acreditado de la SOFOM (modelo-datos §5b · owner `loan-credit-business`).

package/bin/loanCredit/dtos/LoanBorrower.js

@@ -13,7 +13,7 @@ exports.LoanBorrower = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const regex_1 = require("../../helpers/constans/regex");
-const ClientLevelEnum_1 = require("../enums/ClientLevelEnum");
+const ClientLevelEnum_1 = require("../../loanScoring/enums/ClientLevelEnum");
 const LoanBeneficiary_1 = require("./LoanBeneficiary");
 /**
  * LoanBorrower — el acreditado de la SOFOM (modelo-datos §5b · owner `loan-credit-business`).

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

@@ -0,0 +1,27 @@
+import { ContractTypeEnum } from '../enums/ContractTypeEnum';
+/**
+ * LoanContract — documento del contrato de crédito con firma FES (modelo-datos §5b ·
+ * `<T>LoanContract_GT` · M2 §4.3-§4.4). Un registro por documento (3 por crédito — C4).
+ *
+ * Nace DRAFT en la originación (sin PDF); la firma FES genera el PDF, calcula su `sha256`,
+ * verifica el OTP y sella con NOM-151. Conservación documental: 10 años (NOM-151).
+ * `signedAt` ausente = draft sin firmar.
+ */
+export declare class LoanContract {
+    contractId: string;
+    creditId: string;
+    type: ContractTypeEnum;
+    /** Key del PDF en el bucket del tenant (`loan-{tenant}-{env}`). Ausente hasta generar (AS-09). */
+    pdfS3Key?: string;
+    /** Hash SHA-256 del PDF firmado (trazabilidad FES — M2 §4.4). Ausente hasta generar. */
+    sha256?: string;
+    /** El OTP de firma fue verificado (voluntad de firma — FES). */
+    otpVerified: boolean;
+    /** Sello de tiempo NOM-151 (TSA). Ausente hasta firmar (AS del TSA connector). */
+    nom151Timestamp?: string;
+    signedAt?: string;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/bin/loanCredit/dtos/LoanContract.js

@@ -0,0 +1,91 @@
+"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.LoanContract = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const regex_1 = require("../../helpers/constans/regex");
+const ContractTypeEnum_1 = require("../enums/ContractTypeEnum");
+/**
+ * LoanContract — documento del contrato de crédito con firma FES (modelo-datos §5b ·
+ * `<T>LoanContract_GT` · M2 §4.3-§4.4). Un registro por documento (3 por crédito — C4).
+ *
+ * Nace DRAFT en la originación (sin PDF); la firma FES genera el PDF, calcula su `sha256`,
+ * verifica el OTP y sella con NOM-151. Conservación documental: 10 años (NOM-151).
+ * `signedAt` ausente = draft sin firmar.
+ */
+class LoanContract {
+}
+exports.LoanContract = LoanContract;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], LoanContract.prototype, "contractId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], LoanContract.prototype, "creditId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(ContractTypeEnum_1.ContractTypeEnum),
+    __metadata("design:type", String)
+], LoanContract.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], LoanContract.prototype, "pdfS3Key", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], LoanContract.prototype, "sha256", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], LoanContract.prototype, "otpVerified", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], LoanContract.prototype, "nom151Timestamp", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Matches)(regex_1.regexIso8601),
+    __metadata("design:type", String)
+], LoanContract.prototype, "signedAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], LoanContract.prototype, "createdBy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], LoanContract.prototype, "updatedBy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Matches)(regex_1.regexIso8601),
+    __metadata("design:type", String)
+], LoanContract.prototype, "createdAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Matches)(regex_1.regexIso8601),
+    __metadata("design:type", String)
+], LoanContract.prototype, "updatedAt", void 0);

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

@@ -1,4 +1,4 @@
-import { ClientLevelEnum } from '../enums/ClientLevelEnum';
+import { ClientLevelEnum } from '../../loanScoring/enums/ClientLevelEnum';
 import { LoanCreditStatusEnum } from '../enums/LoanCreditStatusEnum';
 import { ActivationChecklist } from './ActivationChecklist';
 /**
@@ -30,6 +30,10 @@ export declare class LoanCredit {
     totalIvaCents: number;
     /** Total a pagar = capital + intereses + IVA. */
     totalToPayCents: number;
+    /** CAT decimal (`3.85` = 385%) — lo calcula el simulador de loan-offerings (C3/AS-01). */
+    catAnnual?: number;
+    /** Sesión del wizard que originó — clave de idempotencia del originate (AS-07). */
+    wizardSessionId?: string;
     /** IMEI del equipo financiado (se fija en el enrolamiento MDM). */
     imei?: string;
     activationChecklist: ActivationChecklist;

package/bin/loanCredit/dtos/LoanCredit.js

@@ -13,7 +13,7 @@ exports.LoanCredit = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const regex_1 = require("../../helpers/constans/regex");
-const ClientLevelEnum_1 = require("../enums/ClientLevelEnum");
+const ClientLevelEnum_1 = require("../../loanScoring/enums/ClientLevelEnum");
 const LoanCreditStatusEnum_1 = require("../enums/LoanCreditStatusEnum");
 const ActivationChecklist_1 = require("./ActivationChecklist");
 /**
@@ -102,6 +102,19 @@ __decorate([
     (0, class_validator_1.IsInt)(),
     __metadata("design:type", Number)
 ], LoanCredit.prototype, "totalToPayCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], LoanCredit.prototype, "catAnnual", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], LoanCredit.prototype, "wizardSessionId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -0,0 +1,21 @@
+/**
+ * Body de `POST /private/credits/:creditId/activate-check` (loan-credit-business — M2 §5).
+ * Marca condiciones del checklist de activación cumplidas (solo las que cambian, solo a `true`):
+ * `downPayment` la reporta el wizard al confirmar el enganche (paso 07); `imeiEnrolled` +
+ * `lockVerified` las dispara el paso 09 variante crédito (enrolamiento MDM vía la abstracción de
+ * proveedor). `contractSigned` NO se marca por acá — solo la firma FES (endpoint sign).
+ *
+ * Cuando las 4 condiciones quedan `true` en el mismo request → el crédito pasa a `ACTIVE`:
+ * vencimientos `activatedAt + n×7d` (domingo→lunes), `voluntaryCancelDeadline = +7d`, flag de
+ * cobro PCF configurado (C7 — solo flag, el débito real requiere adendum).
+ */
+export declare class ActivationCheckRequest {
+    /** Enganche confirmado (efectivo/débito inmediato; SPEI espera confirmación — M2 §5). */
+    downPayment?: boolean;
+    /** IMEI enrolado en MDM. Dispara el enroll vía `MdmConnectorRouter` si aún no se hizo. */
+    imeiEnrolled?: boolean;
+    /** Software de bloqueo verificado (el MDM reporta "activo"). */
+    lockVerified?: boolean;
+    /** IMEI del equipo (paso 09) si no se fijó en el originate. Luhn-validado por el motor. */
+    imei?: string;
+}

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

@@ -0,0 +1,52 @@
+"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.ActivationCheckRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body de `POST /private/credits/:creditId/activate-check` (loan-credit-business — M2 §5).
+ * Marca condiciones del checklist de activación cumplidas (solo las que cambian, solo a `true`):
+ * `downPayment` la reporta el wizard al confirmar el enganche (paso 07); `imeiEnrolled` +
+ * `lockVerified` las dispara el paso 09 variante crédito (enrolamiento MDM vía la abstracción de
+ * proveedor). `contractSigned` NO se marca por acá — solo la firma FES (endpoint sign).
+ *
+ * Cuando las 4 condiciones quedan `true` en el mismo request → el crédito pasa a `ACTIVE`:
+ * vencimientos `activatedAt + n×7d` (domingo→lunes), `voluntaryCancelDeadline = +7d`, flag de
+ * cobro PCF configurado (C7 — solo flag, el débito real requiere adendum).
+ */
+class ActivationCheckRequest {
+}
+exports.ActivationCheckRequest = ActivationCheckRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], ActivationCheckRequest.prototype, "downPayment", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], ActivationCheckRequest.prototype, "imeiEnrolled", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], ActivationCheckRequest.prototype, "lockVerified", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ActivationCheckRequest.prototype, "imei", void 0);

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

@@ -1,22 +1,25 @@
-import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 /**
- * Body de POST /credits (loan-credit-business). Origina el crédito en `PENDING_ACTIVATION` y genera
- * su plan de cuotas (amortización francesa + IVA 16% — M2 §3 / 05_MOTOR §4).
+ * Body de `POST /private/credits/originate` (loan-credit-business — wizard, vía api-invoker).
+ * Origina el crédito en `PENDING_ACTIVATION`: valida (M2 §4.2: sin otro crédito vivo, plan activo,
+ * IMEI libre), invoca el simulador de loan-offerings con `planId+termWeeks+precio+enganche` (la
+ * TNA y el CAT los resuelve el PLAN — el caller NO los manda) y persiste crédito + cuotas +
+ * contratos draft.
  *
- * Los términos financieros (`planId`, `termWeeks`, `tnaAnnual`) vienen de la cotización hecha con
- * loan-offerings; el motor recalcula la tabla internamente (la cotización es informativa, el plan
- * de cuotas del crédito lo genera y persiste este lambda).
+ * **Idempotente por `wizardSessionId`** (el wizard reintenta): mismo wizardSessionId → devuelve el
+ * crédito ya originado, no crea otro. El tenant viaja por query `?tenantId=` (convención privados).
  */
 export declare class OriginateLoanCreditRequest {
+    /** Sesión del wizard que origina — clave de idempotencia (AS-07). */
+    wizardSessionId: string;
     borrowerId: string;
     planId: string;
     termWeeks: number;
     equipmentPriceCents: number;
     downPaymentCents: number;
-    /** TNA decimal (`2.30` = 230%). */
-    tnaAnnual: number;
-    /** SCI del cliente al originar (snapshot). */
+    /** SCI del cliente al originar (snapshot de la evaluación del paso 05). */
     sciAtOrigination?: number;
     clientLevelAtOrigination?: ClientLevelEnum;
+    /** IMEI del equipo si ya se conoce (también puede fijarse en el paso 09 vía activate-check). */
     imei?: string;
 }

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

@@ -12,18 +12,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OriginateLoanCreditRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
-const ClientLevelEnum_1 = require("../../enums/ClientLevelEnum");
+const ClientLevelEnum_1 = require("../../../loanScoring/enums/ClientLevelEnum");
 /**
- * Body de POST /credits (loan-credit-business). Origina el crédito en `PENDING_ACTIVATION` y genera
- * su plan de cuotas (amortización francesa + IVA 16% — M2 §3 / 05_MOTOR §4).
+ * Body de `POST /private/credits/originate` (loan-credit-business — wizard, vía api-invoker).
+ * Origina el crédito en `PENDING_ACTIVATION`: valida (M2 §4.2: sin otro crédito vivo, plan activo,
+ * IMEI libre), invoca el simulador de loan-offerings con `planId+termWeeks+precio+enganche` (la
+ * TNA y el CAT los resuelve el PLAN — el caller NO los manda) y persiste crédito + cuotas +
+ * contratos draft.
  *
- * Los términos financieros (`planId`, `termWeeks`, `tnaAnnual`) vienen de la cotización hecha con
- * loan-offerings; el motor recalcula la tabla internamente (la cotización es informativa, el plan
- * de cuotas del crédito lo genera y persiste este lambda).
+ * **Idempotente por `wizardSessionId`** (el wizard reintenta): mismo wizardSessionId → devuelve el
+ * crédito ya originado, no crea otro. El tenant viaja por query `?tenantId=` (convención privados).
  */
 class OriginateLoanCreditRequest {
 }
 exports.OriginateLoanCreditRequest = OriginateLoanCreditRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], OriginateLoanCreditRequest.prototype, "wizardSessionId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
@@ -55,13 +63,6 @@ __decorate([
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
 ], OriginateLoanCreditRequest.prototype, "downPaymentCents", void 0);
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsNumber)(),
-    (0, class_validator_1.Min)(0),
-    (0, class_validator_1.Max)(10),
-    __metadata("design:type", Number)
-], OriginateLoanCreditRequest.prototype, "tnaAnnual", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -0,0 +1,11 @@
+/**
+ * Body de `POST /private/credits/:creditId/quote` (loan-credit-business — wizard paso 06).
+ * Re-cotiza el crédito en `PENDING_ACTIVATION` con términos nuevos (el cliente itera
+ * plazo/enganche en el cotizador) e invoca el simulador de loan-offerings; regenera las cuotas.
+ * Campos ausentes = conservar el valor actual del crédito. Rechaza si el crédito no está PENDING
+ * o si el contrato ya se firmó (los términos quedan congelados con la firma).
+ */
+export declare class QuoteLoanCreditRequest {
+    termWeeks?: number;
+    downPaymentCents?: number;
+}

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

@@ -0,0 +1,39 @@
+"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.QuoteLoanCreditRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body de `POST /private/credits/:creditId/quote` (loan-credit-business — wizard paso 06).
+ * Re-cotiza el crédito en `PENDING_ACTIVATION` con términos nuevos (el cliente itera
+ * plazo/enganche en el cotizador) e invoca el simulador de loan-offerings; regenera las cuotas.
+ * Campos ausentes = conservar el valor actual del crédito. Rechaza si el crédito no está PENDING
+ * o si el contrato ya se firmó (los términos quedan congelados con la firma).
+ */
+class QuoteLoanCreditRequest {
+}
+exports.QuoteLoanCreditRequest = QuoteLoanCreditRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(104),
+    __metadata("design:type", Number)
+], QuoteLoanCreditRequest.prototype, "termWeeks", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], QuoteLoanCreditRequest.prototype, "downPaymentCents", void 0);

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

@@ -0,0 +1,17 @@
+/**
+ * Body de `POST /private/credits/:creditId/sign` (loan-credit-business — wizard paso 08, firma FES
+ * M2 §4.4). Endpoint de DOS tiempos sobre el mismo contrato:
+ *
+ * 1. **SIN `otpCode`** → INICIA la firma: congela términos, genera los 3 PDFs (C4), calcula sus
+ *    sha256 y dispara el OTP dedicado de firma (4 dígitos, 5 min, vía messages-business — D5;
+ *    distinto al OTP del paso 01). Responde `otpSent: true`.
+ * 2. **CON `otpCode`** → VERIFICA el OTP y firma: marca los contratos `otpVerified` + `signedAt` +
+ *    NOM-151, y pone `activationChecklist.contractSigned = true`.
+ *
+ * Errores: `OTP_INVALID` · `OTP_EXPIRED` · `OTP_MAX_ATTEMPTS` · `CREDIT_NOT_PENDING`.
+ * (Semántica a ratificar con el contrato del wizard — AS-07.)
+ */
+export declare class SignLoanCreditRequest {
+    /** Código OTP de firma. Ausente = iniciar la firma (generar PDFs + enviar OTP). */
+    otpCode?: string;
+}

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

@@ -0,0 +1,37 @@
+"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.SignLoanCreditRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body de `POST /private/credits/:creditId/sign` (loan-credit-business — wizard paso 08, firma FES
+ * M2 §4.4). Endpoint de DOS tiempos sobre el mismo contrato:
+ *
+ * 1. **SIN `otpCode`** → INICIA la firma: congela términos, genera los 3 PDFs (C4), calcula sus
+ *    sha256 y dispara el OTP dedicado de firma (4 dígitos, 5 min, vía messages-business — D5;
+ *    distinto al OTP del paso 01). Responde `otpSent: true`.
+ * 2. **CON `otpCode`** → VERIFICA el OTP y firma: marca los contratos `otpVerified` + `signedAt` +
+ *    NOM-151, y pone `activationChecklist.contractSigned = true`.
+ *
+ * Errores: `OTP_INVALID` · `OTP_EXPIRED` · `OTP_MAX_ATTEMPTS` · `CREDIT_NOT_PENDING`.
+ * (Semántica a ratificar con el contrato del wizard — AS-07.)
+ */
+class SignLoanCreditRequest {
+}
+exports.SignLoanCreditRequest = SignLoanCreditRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(4, 4),
+    __metadata("design:type", String)
+], SignLoanCreditRequest.prototype, "otpCode", void 0);

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

@@ -1,4 +1,4 @@
-import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 import { LoanBeneficiary } from '../LoanBeneficiary';
 /**
  * Body de POST /borrowers y POST /private/borrowers (loan-credit-business).

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

@@ -12,7 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpsertLoanBorrowerRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
-const ClientLevelEnum_1 = require("../../enums/ClientLevelEnum");
+const ClientLevelEnum_1 = require("../../../loanScoring/enums/ClientLevelEnum");
 const LoanBeneficiary_1 = require("../LoanBeneficiary");
 /**
  * Body de POST /borrowers y POST /private/borrowers (loan-credit-business).

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

@@ -0,0 +1,10 @@
+import { LoanCreditResponse } from './LoanCreditResponse';
+/**
+ * Response de `POST /private/credits/:creditId/activate-check` (loan-credit-business — M2 §5):
+ * el crédito con el checklist actualizado. `missingItems` lista las condiciones que faltan
+ * (vacío cuando el crédito quedó `ACTIVE`).
+ */
+export interface ActivationCheckResponse {
+    credit: LoanCreditResponse;
+    missingItems: string[];
+}

package/bin/loanCredit/dtos/responses/ActivationCheckResponse.js

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

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

@@ -1,4 +1,4 @@
-import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 /**
  * Response de los endpoints de LoanBorrower (loan-credit-business). Interface plain (las salidas
  * solo se tipan, no se validan en runtime).

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

@@ -0,0 +1,16 @@
+import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+/**
+ * Response de un documento del contrato (loan-credit-business). `signedAt` ausente = draft.
+ */
+export interface LoanContractResponse {
+    contractId: string;
+    creditId: string;
+    type: ContractTypeEnum;
+    pdfS3Key?: string;
+    sha256?: string;
+    otpVerified: boolean;
+    nom151Timestamp?: string;
+    signedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/bin/loanCredit/dtos/responses/LoanContractResponse.js

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

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

@@ -1,4 +1,4 @@
-import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
 /**
  * Response de los endpoints de LoanCredit (loan-credit-business). Montos en cents; TNA decimal.

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

@@ -1,10 +1,13 @@
+import { LoanContractResponse } from './LoanContractResponse';
 import { LoanCreditResponse } from './LoanCreditResponse';
 import { LoanInstallmentResponse } from './LoanInstallmentResponse';
 /**
- * Response de POST /credits (loan-credit-business): el crédito recién originado en
- * `PENDING_ACTIVATION` + su plan de cuotas completo (las fechas se fijan al activar).
+ * Response de `POST /private/credits/originate` (loan-credit-business): el crédito recién
+ * originado en `PENDING_ACTIVATION` + su plan de cuotas (fechas ausentes hasta activar) + los 3
+ * contratos draft (C4 — se firman en el paso 08).
  */
 export interface OriginateLoanCreditResponse {
     credit: LoanCreditResponse;
     installments: LoanInstallmentResponse[];
+    contracts: LoanContractResponse[];
 }

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

@@ -0,0 +1,10 @@
+import { LoanCreditResponse } from './LoanCreditResponse';
+import { LoanInstallmentResponse } from './LoanInstallmentResponse';
+/**
+ * Response de `POST /private/credits/:creditId/quote` (loan-credit-business): el crédito con los
+ * términos re-cotizados + el plan de cuotas regenerado (fechas ausentes hasta activar).
+ */
+export interface QuoteLoanCreditResponse {
+    credit: LoanCreditResponse;
+    installments: LoanInstallmentResponse[];
+}

package/bin/loanCredit/dtos/responses/QuoteLoanCreditResponse.js

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

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

@@ -0,0 +1,20 @@
+import { LoanContractResponse } from './LoanContractResponse';
+/**
+ * Response de `POST /private/credits/:creditId/sign` (loan-credit-business — firma FES en 2
+ * tiempos): al INICIAR (`otpSent: true`, contratos con PDF+hash sin firmar); al VERIFICAR
+ * (`signed: true`, contratos firmados + checklist con `contractSigned = true`).
+ */
+export interface SignLoanCreditResponse {
+    creditId: string;
+    /** true cuando el request inició la firma y el OTP fue despachado. */
+    otpSent: boolean;
+    /** true cuando el OTP fue verificado y los contratos quedaron firmados. */
+    signed: boolean;
+    contracts: LoanContractResponse[];
+    activationChecklist: {
+        downPayment: boolean;
+        contractSigned: boolean;
+        imeiEnrolled: boolean;
+        lockVerified: boolean;
+    };
+}

package/bin/loanCredit/dtos/responses/SignLoanCreditResponse.js

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

package/bin/loanCredit/enums/ContractTypeEnum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tipo de documento del contrato de crédito (M2 §4.3 / C4 — 3 documentos):
+ * `CREDIT` = contrato de crédito celular (RECA 16145-439-038506/04-01076-0525) ·
+ * `PROMISSORY_NOTE` = pagaré (garantiza el crédito; mismo monto/tasa/plazo) ·
+ * `SIC_AUTHORIZATION` = autorización de consulta/reporte a Círculo de Crédito (Art. 28 LRSIC).
+ * @enum {string}
+ */
+export declare enum ContractTypeEnum {
+    CREDIT = "CREDIT",
+    PROMISSORY_NOTE = "PROMISSORY_NOTE",
+    SIC_AUTHORIZATION = "SIC_AUTHORIZATION"
+}

package/bin/loanCredit/enums/ContractTypeEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContractTypeEnum = void 0;
+/**
+ * Tipo de documento del contrato de crédito (M2 §4.3 / C4 — 3 documentos):
+ * `CREDIT` = contrato de crédito celular (RECA 16145-439-038506/04-01076-0525) ·
+ * `PROMISSORY_NOTE` = pagaré (garantiza el crédito; mismo monto/tasa/plazo) ·
+ * `SIC_AUTHORIZATION` = autorización de consulta/reporte a Círculo de Crédito (Art. 28 LRSIC).
+ * @enum {string}
+ */
+var ContractTypeEnum;
+(function (ContractTypeEnum) {
+    ContractTypeEnum["CREDIT"] = "CREDIT";
+    ContractTypeEnum["PROMISSORY_NOTE"] = "PROMISSORY_NOTE";
+    ContractTypeEnum["SIC_AUTHORIZATION"] = "SIC_AUTHORIZATION";
+})(ContractTypeEnum || (exports.ContractTypeEnum = ContractTypeEnum = {}));

package/bin/loanCredit/enums/LoanInstallmentStatusEnum.d.ts

@@ -1,11 +1,14 @@
 /**
- * Estado de una cuota semanal del crédito (M2 §6.1 / 05_MOTOR §5).
- * `RESTRUCTURED` (reestructurado) = la cuota dejó de aplicar por reestructura o cancelación.
+ * Estado de una cuota semanal del crédito (M2 §6.1: pendiente · pagado · pagado_adelantado ·
+ * vencido · reestructurado). `PAID_IN_ADVANCE` = pago adelantado (cubre cuota futura tal cual,
+ * sin recalcular tabla — M2 §3.7). `RESTRUCTURED` = la cuota dejó de aplicar por
+ * reestructura o cancelación.
  * @enum {string}
  */
 export declare enum LoanInstallmentStatusEnum {
     PENDING = "PENDING",
     PAID = "PAID",
+    PAID_IN_ADVANCE = "PAID_IN_ADVANCE",
     OVERDUE = "OVERDUE",
     RESTRUCTURED = "RESTRUCTURED"
 }