@fiado/type-kit 3.213.0 → 3.214.0

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

@@ -0,0 +1,11 @@
+/**
+ * Body de PUT /credits/:creditId/checklist (loan-credit-business). Marca condiciones de activación
+ * cumplidas. Solo se mandan las que cambian; en F3 las marcarán los flujos de firma de contrato
+ * (`downPayment` + `contractSigned`) y de enrolamiento MDM (`imeiEnrolled` + `lockVerified`).
+ */
+export declare class UpdateActivationChecklistRequest {
+    downPayment?: boolean;
+    contractSigned?: boolean;
+    imeiEnrolled?: boolean;
+    lockVerified?: boolean;
+}

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

@@ -0,0 +1,46 @@
+"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.UpdateActivationChecklistRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body de PUT /credits/:creditId/checklist (loan-credit-business). Marca condiciones de activación
+ * cumplidas. Solo se mandan las que cambian; en F3 las marcarán los flujos de firma de contrato
+ * (`downPayment` + `contractSigned`) y de enrolamiento MDM (`imeiEnrolled` + `lockVerified`).
+ */
+class UpdateActivationChecklistRequest {
+}
+exports.UpdateActivationChecklistRequest = UpdateActivationChecklistRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateActivationChecklistRequest.prototype, "downPayment", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateActivationChecklistRequest.prototype, "contractSigned", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateActivationChecklistRequest.prototype, "imeiEnrolled", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateActivationChecklistRequest.prototype, "lockVerified", void 0);

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

@@ -0,0 +1,11 @@
+/**
+ * Nivel del cliente según su SCI (M7/05_MOTOR §3.2): 21-60 Bronce · 61-80 Plata · 81-100 Oro.
+ * Distinto de `CreditPlanLevelEnum` de loanOfferings (que además tiene `ALL` para planes):
+ * un CLIENTE nunca es `ALL`.
+ * @enum {string}
+ */
+export declare enum ClientLevelEnum {
+    BRONZE = "BRONZE",
+    SILVER = "SILVER",
+    GOLD = "GOLD"
+}

package/bin/loanCredit/enums/ClientLevelEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientLevelEnum = void 0;
+/**
+ * Nivel del cliente según su SCI (M7/05_MOTOR §3.2): 21-60 Bronce · 61-80 Plata · 81-100 Oro.
+ * Distinto de `CreditPlanLevelEnum` de loanOfferings (que además tiene `ALL` para planes):
+ * un CLIENTE nunca es `ALL`.
+ * @enum {string}
+ */
+var ClientLevelEnum;
+(function (ClientLevelEnum) {
+    ClientLevelEnum["BRONZE"] = "BRONZE";
+    ClientLevelEnum["SILVER"] = "SILVER";
+    ClientLevelEnum["GOLD"] = "GOLD";
+})(ClientLevelEnum || (exports.ClientLevelEnum = ClientLevelEnum = {}));

package/bin/retailWizard/dtos/WizardCreditSummary.d.ts

@@ -0,0 +1,26 @@
+import { ClientLevelEnum } from '../../loanScoring/enums/ClientLevelEnum';
+import { LoanCreditStatusEnum } from '../../loanCredit/enums/LoanCreditStatusEnum';
+/**
+ * Resumen financiero TRANSITORIO del crédito para las pantallas del wizard (06 cotización /
+ * 08 firma). Se arma en cada response desde `loan-credit GET|originate|quote` — NO se persiste
+ * en la sesión (regla punteros-no-datos del sub-objeto `loan`). Montos en cents; TNA decimal.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface WizardCreditSummary {
+    creditId: string;
+    status: LoanCreditStatusEnum;
+    planId: string;
+    termWeeks: number;
+    equipmentPriceCents: number;
+    downPaymentCents: number;
+    financedCapitalCents: number;
+    tnaAnnual: number;
+    /** Cuota semanal sin IVA (amortización francesa, constante). */
+    weeklyPaymentCents: number;
+    /** Cuota semanal con IVA — el número que ve el cliente. */
+    weeklyPaymentWithIvaCents: number;
+    totalInterestCents: number;
+    totalIvaCents: number;
+    totalToPayCents: number;
+    clientLevelAtOrigination?: ClientLevelEnum;
+}

package/bin/retailWizard/dtos/WizardCreditSummary.js

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

package/bin/retailWizard/dtos/WizardLoan.d.ts

@@ -0,0 +1,24 @@
+import { ClientLevelEnum } from '../../loanScoring/enums/ClientLevelEnum';
+/**
+ * Contexto de crédito de la sesión (`WizardSession.loan`) — pista SOFOM, pasos 04-09 del wizard.
+ *
+ * Guarda SOLO PUNTEROS al dominio loan-*: el detalle financiero (montos, cuota, checklist,
+ * estado) se lee de `loan-credit GET /private/credits/{creditId}`; la oferta/decisión del score
+ * de `loan-scoring GET /private/scoring/evaluations/{sciEvaluationId}`. Nunca denormalizar datos
+ * financieros acá (única excepción: `level`, para el chip de nivel sin refetch).
+ *
+ * `null` en ventas de contado/externa; se hidrata paso a paso solo en la venta a crédito.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export declare class WizardLoan {
+    /** Paso 04 — acreditado creado on-demand al elegir SureKeep (`POST /private/borrowers`). */
+    borrowerId: string;
+    /** Paso 05 — snapshot inmutable de la evaluación SCI (`POST /private/scoring/evaluate`). */
+    sciEvaluationId?: string;
+    /** Paso 05 — nivel denormalizado (display del chip de nivel; el snapshot es la fuente). */
+    level?: ClientLevelEnum;
+    /** Paso 06 — plan del catálogo SOFOM resuelto por nivel (loan-offerings). */
+    planId?: string;
+    /** Paso 06 — crédito originado en `PENDING_ACTIVATION` (`POST /private/credits/originate`). */
+    creditId?: string;
+}

package/bin/retailWizard/dtos/WizardLoan.js

@@ -0,0 +1,58 @@
+"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.WizardLoan = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ClientLevelEnum_1 = require("../../loanScoring/enums/ClientLevelEnum");
+/**
+ * Contexto de crédito de la sesión (`WizardSession.loan`) — pista SOFOM, pasos 04-09 del wizard.
+ *
+ * Guarda SOLO PUNTEROS al dominio loan-*: el detalle financiero (montos, cuota, checklist,
+ * estado) se lee de `loan-credit GET /private/credits/{creditId}`; la oferta/decisión del score
+ * de `loan-scoring GET /private/scoring/evaluations/{sciEvaluationId}`. Nunca denormalizar datos
+ * financieros acá (única excepción: `level`, para el chip de nivel sin refetch).
+ *
+ * `null` en ventas de contado/externa; se hidrata paso a paso solo en la venta a crédito.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+class WizardLoan {
+}
+exports.WizardLoan = WizardLoan;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], WizardLoan.prototype, "borrowerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], WizardLoan.prototype, "sciEvaluationId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ClientLevelEnum_1.ClientLevelEnum),
+    __metadata("design:type", String)
+], WizardLoan.prototype, "level", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], WizardLoan.prototype, "planId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], WizardLoan.prototype, "creditId", void 0);

package/bin/retailWizard/dtos/WizardSession.d.ts

@@ -5,6 +5,7 @@ import type { PaymentMethodEnum } from '../enums/PaymentMethodEnum';
 import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
 import type { OccupationEnum } from '../enums/OccupationEnum';
 import type { WizardConsents } from './WizardConsents';
+import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
 import type { WizardWelcome } from './WizardWelcome';
 /** Modalidad de captura del KYC (M1 §213-329). */
@@ -52,6 +53,8 @@ export interface WizardSession {
     folio: string | null;
     payment: WizardPayment | null;
     welcome: WizardWelcome | null;
+    /** Contexto de crédito (pista SOFOM, pasos 04-09): PUNTEROS al dominio loan-*. Null en contado/externa. */
+    loan: WizardLoan | null;
     saleId: string | null;
     /** Prospecto vinculado (si la sesión se reanudó desde un prospecto): se cierra al cerrar la venta (D-prospecto). */
     prospectId: string | null;

package/bin/retailWizard/dtos/requests/DownPaymentRequest.d.ts

@@ -0,0 +1,16 @@
+import { SalePaymentMethodEnum } from '../../enums/SalePaymentMethodEnum';
+import { SalePaymentDetail } from '../SalePaymentDetail';
+/**
+ * POST /wizard/sessions/:id/down-payment — cobro del ENGANCHE de la venta a crédito (paso 07,
+ * pista SOFOM). Endpoint propio, separado del cobro de contado (`/payment`): acá la regla dura es
+ * `amountCents == downPaymentCents` del crédito (`loan-credit GET /credits/{id}`), NO el precio
+ * full. Idempotente por sesión. El folio `SK-…-ENG-…` lo genera el server (no viaja en el body).
+ * Al confirmar, el wizard marca la condición 1 del checklist (`activate-check { downPayment }`).
+ * SPEI: el vendedor captura el comprobante (`speiTrackingKey`+`senderClabe`) y avanza.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export declare class DownPaymentRequest {
+    method: SalePaymentMethodEnum;
+    amountCents: number;
+    detail?: SalePaymentDetail;
+}

package/bin/retailWizard/dtos/requests/DownPaymentRequest.js

@@ -0,0 +1,46 @@
+"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.DownPaymentRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SalePaymentMethodEnum_1 = require("../../enums/SalePaymentMethodEnum");
+const SalePaymentDetail_1 = require("../SalePaymentDetail");
+/**
+ * POST /wizard/sessions/:id/down-payment — cobro del ENGANCHE de la venta a crédito (paso 07,
+ * pista SOFOM). Endpoint propio, separado del cobro de contado (`/payment`): acá la regla dura es
+ * `amountCents == downPaymentCents` del crédito (`loan-credit GET /credits/{id}`), NO el precio
+ * full. Idempotente por sesión. El folio `SK-…-ENG-…` lo genera el server (no viaja en el body).
+ * Al confirmar, el wizard marca la condición 1 del checklist (`activate-check { downPayment }`).
+ * SPEI: el vendedor captura el comprobante (`speiTrackingKey`+`senderClabe`) y avanza.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+class DownPaymentRequest {
+}
+exports.DownPaymentRequest = DownPaymentRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(SalePaymentMethodEnum_1.SalePaymentMethodEnum),
+    __metadata("design:type", String)
+], DownPaymentRequest.prototype, "method", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], DownPaymentRequest.prototype, "amountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => SalePaymentDetail_1.SalePaymentDetail),
+    (0, class_validator_1.ValidateNested)(),
+    __metadata("design:type", SalePaymentDetail_1.SalePaymentDetail)
+], DownPaymentRequest.prototype, "detail", void 0);

package/bin/retailWizard/dtos/requests/QuoteRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * POST /wizard/sessions/:id/quote — términos elegidos en el cotizador del paso 06 (slider de
+ * enganche + botones de plazo). El wizard valida contra los bounds del PLAN resuelto por nivel
+ * (`minDownPaymentPct`/`maxDownPaymentPct`/`termWeeksOptions`) y origina (o re-cotiza) el crédito
+ * en loan-credit. El precio del equipo NO viaja: es el ancla `reservedCashPriceCents` de la sesión.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export declare class QuoteRequest {
+    downPaymentCents: number;
+    termWeeks: number;
+}

package/bin/retailWizard/dtos/requests/QuoteRequest.js

@@ -0,0 +1,36 @@
+"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.QuoteRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * POST /wizard/sessions/:id/quote — términos elegidos en el cotizador del paso 06 (slider de
+ * enganche + botones de plazo). El wizard valida contra los bounds del PLAN resuelto por nivel
+ * (`minDownPaymentPct`/`maxDownPaymentPct`/`termWeeksOptions`) y origina (o re-cotiza) el crédito
+ * en loan-credit. El precio del equipo NO viaja: es el ancla `reservedCashPriceCents` de la sesión.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+class QuoteRequest {
+}
+exports.QuoteRequest = QuoteRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], QuoteRequest.prototype, "downPaymentCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], QuoteRequest.prototype, "termWeeks", void 0);

package/bin/retailWizard/dtos/requests/RegisterDeviceRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * POST /wizard/sessions/:id/device — registro del IMEI del equipo entregado (paso 09, variante
+ * crédito). El wizard valida el formato (15 dígitos); el Luhn y la unicidad (`IMEI_IN_USE`) los
+ * valida loan-credit en el `activate-check`, que además dispara el enrolamiento MDM (condiciones
+ * 3-4 del checklist). SureKeep Fase 2 — pista SOFOM.
+ */
+export declare class RegisterDeviceRequest {
+    imei: string;
+}

package/bin/{platformRbac/dtos/ResendOtpRequest.js → retailWizard/dtos/requests/RegisterDeviceRequest.js}

@@ -9,28 +9,21 @@ 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.ResendOtpRequest = void 0;
+exports.RegisterDeviceRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 /**
- * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
- * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
- * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
- * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
- * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
+ * POST /wizard/sessions/:id/device — registro del IMEI del equipo entregado (paso 09, variante
+ * crédito). El wizard valida el formato (15 dígitos); el Luhn y la unicidad (`IMEI_IN_USE`) los
+ * valida loan-credit en el `activate-check`, que además dispara el enrolamiento MDM (condiciones
+ * 3-4 del checklist). SureKeep Fase 2 — pista SOFOM.
  */
-class ResendOtpRequest {
+class RegisterDeviceRequest {
 }
-exports.ResendOtpRequest = ResendOtpRequest;
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsEmail)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", String)
-], ResendOtpRequest.prototype, "email", void 0);
+exports.RegisterDeviceRequest = RegisterDeviceRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Matches)(/^\d{15}$/, { message: 'imei debe ser de 15 dígitos' }),
     __metadata("design:type", String)
-], ResendOtpRequest.prototype, "tenantId", void 0);
+], RegisterDeviceRequest.prototype, "imei", void 0);

package/bin/retailWizard/dtos/requests/SignatureSignRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * POST /wizard/sessions/:id/signature/sign — firma FES tiempo 2 (paso 08): verifica el OTP de
+ * firma (4 dígitos — M2 §4.4) y firma los contratos en loan-credit (sha256 + `signedAt` +
+ * condición 2 del checklist). Errores: `OTP_INVALID` · `OTP_EXPIRED` · `OTP_MAX_ATTEMPTS`.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export declare class SignatureSignRequest {
+    otpCode: string;
+}

package/bin/{platformRbac/dtos/ResendSelfRegisterOtpRequest.js → retailWizard/dtos/requests/SignatureSignRequest.js}

@@ -9,28 +9,21 @@ 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.ResendSelfRegisterOtpRequest = void 0;
+exports.SignatureSignRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 /**
- * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
- * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
- * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
- * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
- * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
+ * POST /wizard/sessions/:id/signature/sign — firma FES tiempo 2 (paso 08): verifica el OTP de
+ * firma (4 dígitos — M2 §4.4) y firma los contratos en loan-credit (sha256 + `signedAt` +
+ * condición 2 del checklist). Errores: `OTP_INVALID` · `OTP_EXPIRED` · `OTP_MAX_ATTEMPTS`.
+ * SureKeep Fase 2 — pista SOFOM.
  */
-class ResendSelfRegisterOtpRequest {
+class SignatureSignRequest {
 }
-exports.ResendSelfRegisterOtpRequest = ResendSelfRegisterOtpRequest;
+exports.SignatureSignRequest = SignatureSignRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Matches)(/^\d{4}$/, { message: 'otpCode debe ser de 4 dígitos' }),
     __metadata("design:type", String)
-], ResendSelfRegisterOtpRequest.prototype, "tenantId", void 0);
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsEmail)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", String)
-], ResendSelfRegisterOtpRequest.prototype, "email", void 0);
+], SignatureSignRequest.prototype, "otpCode", void 0);

package/bin/retailWizard/dtos/responses/ContractPreviewResponse.d.ts

@@ -0,0 +1,12 @@
+import { WizardCreditSummary } from '../WizardCreditSummary';
+/**
+ * GET /wizard/sessions/:id/contract/preview — resumen previo a la firma FES (paso 08): el estado
+ * financiero del crédito (fuente: loan-credit) + las variables del template del contrato que el
+ * wizard armará para el sign tiempo-1 (`contractData`: nombre, CURP, domicilio… — PII TRANSITORIA,
+ * viaja solo en esta response, NO se persiste ni loggea). El PDF real lo genera el sign tiempo-1
+ * en loan-credit; este preview no llama a document-generator. SureKeep Fase 2 — pista SOFOM.
+ */
+export interface ContractPreviewResponse {
+    credit: WizardCreditSummary;
+    contractData: Record<string, string>;
+}

package/bin/retailWizard/dtos/responses/ContractPreviewResponse.js

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

package/bin/retailWizard/dtos/responses/DownPaymentResponse.d.ts

@@ -0,0 +1,14 @@
+import { ActivationChecklist } from '../../../loanCredit/dtos/ActivationChecklist';
+/**
+ * POST /wizard/sessions/:id/down-payment — confirmación del cobro del enganche (paso 07).
+ * `paymentId` = el folio de enganche `SK-…-ENG-…` (identificador natural del cobro en caja;
+ * concilia contra el depósito semanal del retailer). `checklist` refleja el estado post
+ * `activate-check { downPayment: true }` en loan-credit. SureKeep Fase 2 — pista SOFOM.
+ */
+export interface DownPaymentResponse {
+    paymentId: string;
+    folio: string;
+    /** ISO 8601 del registro del cobro en la sesión. */
+    registeredAt: string;
+    checklist: ActivationChecklist;
+}

package/bin/retailWizard/dtos/responses/DownPaymentResponse.js

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

package/bin/retailWizard/dtos/responses/QuoteResponse.d.ts

@@ -0,0 +1,23 @@
+import { WizardCreditSummary } from '../WizardCreditSummary';
+/** Bounds y parámetros del plan que gobiernan el cotizador (slider + plazos) del paso 06. */
+export interface QuotePlanBounds {
+    planId: string;
+    code: string;
+    /** Enganche mínimo como decimal sobre 1 (`0.40` = 40%). */
+    minDownPaymentPct: number;
+    /** Techo de enganche (decimal sobre 1); `null` = sin techo definido. */
+    maxDownPaymentPct: number | null;
+    termWeeksOptions: number[];
+    /** TNA decimal (`2.60` = 260%) — la tasa que manda es la del PLAN. */
+    tnaAnnual: number;
+    openingCommissionPct: number;
+}
+/**
+ * POST /wizard/sessions/:id/quote — respuesta del cotizador del paso 06: el plan resuelto por
+ * nivel + el snapshot financiero del crédito originado/re-cotizado (transitorio, NO se persiste
+ * en la sesión — la fuente es loan-credit). SureKeep Fase 2 — pista SOFOM.
+ */
+export interface QuoteResponse {
+    plan: QuotePlanBounds;
+    credit: WizardCreditSummary;
+}

package/bin/retailWizard/dtos/responses/QuoteResponse.js

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

package/bin/retailWizard/dtos/responses/RegisterDeviceResponse.d.ts

@@ -0,0 +1,14 @@
+import { LoanCreditStatusEnum } from '../../../loanCredit/enums/LoanCreditStatusEnum';
+import { ActivationChecklist } from '../../../loanCredit/dtos/ActivationChecklist';
+/**
+ * POST /wizard/sessions/:id/device — resultado del registro de IMEI + candado (paso 09).
+ * `active: true` cuando el checklist quedó 4/4 y el crédito pasó a `ACTIVE` (el front bloquea
+ * "Continuar a Bienvenida" hasta entonces; `missingItems` lista lo que falta).
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface RegisterDeviceResponse {
+    creditStatus: LoanCreditStatusEnum;
+    checklist: ActivationChecklist;
+    missingItems: string[];
+    active: boolean;
+}

package/bin/retailWizard/dtos/responses/RegisterDeviceResponse.js

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

package/bin/retailWizard/dtos/responses/ScoreConsultResponse.d.ts

@@ -0,0 +1,20 @@
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
+import { ScoringDecisionEnum } from '../../../loanScoring/enums/ScoringDecisionEnum';
+import { ScoringOffer } from '../../../loanScoring/dtos/ScoringOffer';
+/**
+ * POST /wizard/sessions/:id/score/consult — resultado de la evaluación SCI del paso 05.
+ *
+ * El wizard es idempotente por sesión: si la sesión ya tiene `loan.sciEvaluationId`, devuelve el
+ * snapshot existente (no re-evalúa — cada evaluate del motor genera un snapshot NUEVO).
+ * `REJECTED`/`NO_ELIGIBLE` no matan la venta: el front ofrece financiera externa o contado.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface ScoreConsultResponse {
+    /** Decisión normalizada del motor de scoring. */
+    status: ScoringDecisionEnum;
+    level: ClientLevelEnum;
+    /** Puntero al snapshot inmutable en loan-scoring (se persiste en `WizardSession.loan`). */
+    sciEvaluationId: string;
+    /** Oferta del proveedor (display del paso 05; la cotización del 06 usa el PLAN, no esto). */
+    offer: ScoringOffer | null;
+}

package/bin/retailWizard/dtos/responses/ScoreConsultResponse.js

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

package/bin/retailWizard/dtos/responses/ScoreResultResponse.d.ts

@@ -0,0 +1,14 @@
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
+import { ScoringDecisionEnum } from '../../../loanScoring/enums/ScoringDecisionEnum';
+import { ScoringOffer } from '../../../loanScoring/dtos/ScoringOffer';
+/**
+ * GET /wizard/sessions/:id/score/result — lectura del resultado del score del paso 05 (la tablet
+ * lee el snapshot ya persistido vía `loan.sciEvaluationId`; no dispara evaluación).
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface ScoreResultResponse {
+    status: ScoringDecisionEnum;
+    level: ClientLevelEnum;
+    sciEvaluationId: string;
+    offer: ScoringOffer | null;
+}

package/bin/retailWizard/dtos/responses/ScoreResultResponse.js

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

package/bin/retailWizard/dtos/responses/SessionFinanciersResponse.d.ts

@@ -0,0 +1,26 @@
+import { FinancierTypeEnum } from '../../../loanOfferings/enums/FinancierTypeEnum';
+/**
+ * Una opción de financiamiento del paso 04 (pantalla forma de pago): la unión de las financieras
+ * ACTIVE del catálogo SOFOM (`loan-offerings GET /private/financiers/active` — display + orden)
+ * con la elegibilidad del producto reservado (`eligibleFinanciers` del catálogo retail).
+ */
+export interface SessionFinancierOption {
+    code: string;
+    name: string;
+    /** Texto de display de la card (viene del catálogo SOFOM). */
+    label: string;
+    /** INTERNAL = SureKeep (pista crédito propia); EXTERNAL = derivación (PayJoy, CrediYa…). */
+    type: FinancierTypeEnum;
+    displayOrder: number;
+    /** Solo EXTERNAL: URL de derivación. */
+    externalRedirectUrl: string | null;
+    /** El producto reservado admite esta financiera (INTERNAL siempre elegible). */
+    eligible: boolean;
+}
+/**
+ * GET /wizard/sessions/:id/financiers — las opciones de financiamiento del paso 04 para la sesión
+ * (según su producto reservado). Ordenadas por `displayOrder`. SureKeep Fase 2 — pista SOFOM.
+ */
+export interface SessionFinanciersResponse {
+    financiers: SessionFinancierOption[];
+}

package/bin/retailWizard/dtos/responses/SessionFinanciersResponse.js

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

package/bin/retailWizard/dtos/responses/SignatureSendOtpResponse.d.ts

@@ -0,0 +1,10 @@
+/**
+ * POST /wizard/sessions/:id/signature/send-otp — firma FES tiempo 1 (paso 08): loan-credit
+ * congela términos, genera los PDFs y despacha el OTP dedicado de firma (4 dígitos, 5 min) al
+ * teléfono del cliente vía messages-business. SureKeep Fase 2 — pista SOFOM.
+ */
+export interface SignatureSendOtpResponse {
+    otpSent: boolean;
+    /** Teléfono destino enmascarado para la pantalla (`****1234`) — nunca el número completo. */
+    otpDestinationMasked: string;
+}

package/bin/retailWizard/dtos/responses/SignatureSendOtpResponse.js

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

package/bin/retailWizard/dtos/responses/SignatureSignResponse.d.ts

@@ -0,0 +1,10 @@
+import { ActivationChecklist } from '../../../loanCredit/dtos/ActivationChecklist';
+/**
+ * POST /wizard/sessions/:id/signature/sign — resultado de la firma FES tiempo 2 (paso 08).
+ * `signed: true` implica `checklist.contractSigned: true` (condición 2 de activación).
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface SignatureSignResponse {
+    signed: boolean;
+    checklist: ActivationChecklist;
+}

package/bin/retailWizard/dtos/responses/SignatureSignResponse.js

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