@fiado/type-kit 3.213.0 → 3.215.0

package/bin/kyc/dtos/KycAddress.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Domicilio del INE ya normalizado por `places-business` (AWS Location), listo para que el consumidor
+ * arme su `AddressBase` local. Mapea el `AddressCandidate` de places a un shape con `@Expose`, porque
+ * el consumer parsea el evento con `excludeExtraneousValues` y descartaría todo campo sin exponer.
+ *
+ * Todos los campos son opcionales: el domicilio es best-effort (la OCR del INE + el geocoding pueden
+ * no resolver todo). ⚠️ PII: nunca loguear esta estructura.
+ */
+export declare class KycAddress {
+    /** Etiqueta completa legible (equivalente a Place.Label). */
+    label?: string;
+    street?: string;
+    /** Número exterior (Place.AddressNumber). */
+    addressNumber?: string;
+    neighborhood?: string;
+    municipality?: string;
+    /** Estado/provincia (Place.Region). */
+    region?: string;
+    postalCode?: string;
+    /** ISO3 del país (Place.Country). */
+    country?: string;
+    latitude?: number;
+    longitude?: number;
+}

package/bin/kyc/dtos/KycAddress.js

@@ -0,0 +1,85 @@
+"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.KycAddress = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Domicilio del INE ya normalizado por `places-business` (AWS Location), listo para que el consumidor
+ * arme su `AddressBase` local. Mapea el `AddressCandidate` de places a un shape con `@Expose`, porque
+ * el consumer parsea el evento con `excludeExtraneousValues` y descartaría todo campo sin exponer.
+ *
+ * Todos los campos son opcionales: el domicilio es best-effort (la OCR del INE + el geocoding pueden
+ * no resolver todo). ⚠️ PII: nunca loguear esta estructura.
+ */
+class KycAddress {
+}
+exports.KycAddress = KycAddress;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "label", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "street", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "addressNumber", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "neighborhood", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "municipality", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "region", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "postalCode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "country", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], KycAddress.prototype, "latitude", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], KycAddress.prototype, "longitude", void 0);

package/bin/kyc/events/KycVerificationChangedV1.d.ts

@@ -2,7 +2,7 @@ import { IdentificationDocumentStatus } from '../../identity/enums/Identificatio
 import { KycVerificationStatusEnum } from '../enums/KycVerificationStatusEnum';
 import { KycSubChecks } from '../dtos/KycSubChecks';
 import { KycPersonData } from '../dtos/responses/KycPersonData';
-import { AddressBase } from '../../address/dtos/AddressBase';
+import { KycAddress } from '../dtos/KycAddress';
 /**
  * Cambio terminal de una verificación KYC, tal como lo publica `kyc-metamap-webhook` directo en
  * `RetailKycInboundQueue` (el webhook manda un `SendMessage` cuando la verificación pasa a COMPLETED).
@@ -53,9 +53,11 @@ export declare class KycVerificationChangedV1 {
      */
     person?: KycPersonData;
     /**
-     * Domicilio del INE ya ESTRUCTURADO por `places-business` (paso 02e), listo para copiarse a
-     * `RetailCustomer.address` en el upsert. OPCIONAL y aditivo: el webhook lo puebla cuando la OCR trae
-     * domicilio y `places` resuelve; si no, el upsert corre sin dirección y se completa después. ⚠️ PII.
+     * Domicilio del INE ya normalizado por `places-business` (paso 02e). El webhook manda el resultado
+     * del geocoding (`KycAddress`); el CONSUMIDOR (wizard) arma con esto su `AddressBase` local, porque
+     * ese objeto lleva contexto de SureKeep (tenant, tipo) que el webhook no tiene. OPCIONAL y aditivo:
+     * si la OCR no trae domicilio o `places` no resuelve, viaja ausente y el upsert corre sin dirección.
+     * ⚠️ PII: nunca loguear.
      */
-    address?: AddressBase;
+    address?: KycAddress;
 }

package/bin/kyc/events/KycVerificationChangedV1.js

@@ -16,7 +16,7 @@ const IdentificationDocumentStatus_1 = require("../../identity/enums/Identificat
 const KycVerificationStatusEnum_1 = require("../enums/KycVerificationStatusEnum");
 const KycSubChecks_1 = require("../dtos/KycSubChecks");
 const KycPersonData_1 = require("../dtos/responses/KycPersonData");
-const AddressBase_1 = require("../../address/dtos/AddressBase");
+const KycAddress_1 = require("../dtos/KycAddress");
 /**
  * Cambio terminal de una verificación KYC, tal como lo publica `kyc-metamap-webhook` directo en
  * `RetailKycInboundQueue` (el webhook manda un `SendMessage` cuando la verificación pasa a COMPLETED).
@@ -95,6 +95,6 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.ValidateNested)(),
-    (0, class_transformer_1.Type)(() => AddressBase_1.AddressBase),
-    __metadata("design:type", AddressBase_1.AddressBase)
+    (0, class_transformer_1.Type)(() => KycAddress_1.KycAddress),
+    __metadata("design:type", KycAddress_1.KycAddress)
 ], KycVerificationChangedV1.prototype, "address", void 0);

package/bin/kyc/index.d.ts

@@ -2,6 +2,7 @@ export * from './enums/KycVerificationStatusEnum';
 export * from './enums/KycSubCheckStatusEnum';
 export * from './enums/KycWatchlistStatusEnum';
 export * from './dtos/KycSubChecks';
+export * from './dtos/KycAddress';
 export * from './dtos/responses/KycPersonData';
 export * from './dtos/responses/KycByDirectoryResponse';
 export * from './events/KycVerificationChangedV1';

package/bin/kyc/index.js

@@ -21,6 +21,8 @@ __exportStar(require("./enums/KycSubCheckStatusEnum"), exports);
 __exportStar(require("./enums/KycWatchlistStatusEnum"), exports);
 // Sub-pasos descompuestos (SureKeep F2)
 __exportStar(require("./dtos/KycSubChecks"), exports);
+// Domicilio del INE normalizado por places (SureKeep F2)
+__exportStar(require("./dtos/KycAddress"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/KycPersonData"), exports);
 __exportStar(require("./dtos/responses/KycByDirectoryResponse"), exports);

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/retailWizard/dtos/requests/RegisterDeviceRequest.js

@@ -0,0 +1,29 @@
+"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.RegisterDeviceRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * 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 RegisterDeviceRequest {
+}
+exports.RegisterDeviceRequest = RegisterDeviceRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/^\d{15}$/, { message: 'imei debe ser de 15 dígitos' }),
+    __metadata("design:type", String)
+], 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/retailWizard/dtos/requests/SignatureSignRequest.js

@@ -0,0 +1,29 @@
+"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.SignatureSignRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * 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 SignatureSignRequest {
+}
+exports.SignatureSignRequest = SignatureSignRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/^\d{4}$/, { message: 'otpCode debe ser de 4 dígitos' }),
+    __metadata("design:type", String)
+], 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 });