@fiado/type-kit 3.527.0 → 3.529.0

package/_test_/unit/emailVerification/dtos/EmailSetTrustedRequest.test.ts

@@ -50,4 +50,20 @@ describe('EmailSetTrustedRequest', () => {
         const errors = await validate(dto);
         expect(errors.some(e => e.property === 'type')).toBe(true);
     });
+
+    it('acepta isPrincipal en true', async () => {
+        const dto = plainToInstance(EmailSetTrustedRequest, { ...valid, isPrincipal: true });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+        expect(dto.isPrincipal).toBe(true);
+    });
+
+    it('falla si isPrincipal no es booleano', async () => {
+        const dto = plainToInstance(EmailSetTrustedRequest, {
+            ...valid,
+            isPrincipal: 'si' as unknown as boolean,
+        });
+        const errors = await validate(dto);
+        expect(errors.some(e => e.property === 'isPrincipal')).toBe(true);
+    });
 });

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

@@ -0,0 +1,68 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { ValidationError, validate } from 'class-validator';
+import { SignLoanCreditRequest } from '../../../src/loanCredit/index';
+
+/** Rutas de las propiedades que fallan, con los anidados como `contractDetails.borrower.fullName`. */
+const pathsOf = (errors: ValidationError[], prefix = ''): string[] =>
+    errors.flatMap((error) => {
+        const path = prefix ? `${prefix}.${error.property}` : error.property;
+        return error.children?.length ? pathsOf(error.children, path) : [path];
+    });
+
+const errorsOf = async (body: Record<string, unknown>): Promise<string[]> =>
+    pathsOf(await validate(plainToInstance(SignLoanCreditRequest, body))).sort();
+
+const DETAILS = {
+    borrower: {
+        fullName: 'María Fernanda López Hernández',
+        curp: 'LOHM900215MMCPRR09',
+        address: 'Av. Ejemplo 123, Col. Centro, C.P. 50000, Toluca, Estado de México',
+        rfc: 'LOHM900215AB1',
+        occupation: 'Empleada',
+        monthlyIncome: '10,000 – 15,000',
+    },
+    device: { brand: 'Samsung', model: 'Galaxy A15', color: 'Negro', storage: '128 GB', imei: '356938035643809' },
+    provider: { legalName: 'Comercializadora de Ejemplo, S.A. de C.V.' },
+};
+
+describe('SignLoanCreditRequest', () => {
+    it('acepta el inicio de firma sin datos del contrato, como hasta ahora', async () => {
+        expect(await errorsOf({ contractData: { nombreAcreditado: 'María' } })).toEqual([]);
+    });
+
+    it('acepta los datos del contrato completos', async () => {
+        expect(await errorsOf({ contractDetails: DETAILS })).toEqual([]);
+    });
+
+    it('el proveedor es opcional: el motor lo resuelve con la tienda', async () => {
+        const { provider, ...withoutProvider } = DETAILS;
+        expect(provider).toBeDefined();
+        expect(await errorsOf({ contractDetails: withoutProvider })).toEqual([]);
+    });
+
+    it('exige acreditado y equipo cuando vienen los datos del contrato', async () => {
+        expect(await errorsOf({ contractDetails: {} })).toEqual(['contractDetails.borrower', 'contractDetails.device']);
+    });
+
+    it('exige nombre, CURP y domicilio del acreditado, y marca y modelo del equipo', async () => {
+        const details = { borrower: { rfc: 'LOHM900215AB1' }, device: { color: 'Negro' } };
+        expect(await errorsOf({ contractDetails: details })).toEqual([
+            'contractDetails.borrower.address',
+            'contractDetails.borrower.curp',
+            'contractDetails.borrower.fullName',
+            'contractDetails.device.brand',
+            'contractDetails.device.model',
+        ]);
+    });
+
+    it('rechaza un IMEI que no tiene 15 dígitos', async () => {
+        const details = { ...DETAILS, device: { ...DETAILS.device, imei: '35693803564380A' } };
+        expect(await errorsOf({ contractDetails: details })).toEqual(['contractDetails.device.imei']);
+    });
+
+    it('rechaza un texto más largo que el máximo', async () => {
+        const details = { ...DETAILS, provider: { legalName: 'x'.repeat(301) } };
+        expect(await errorsOf({ contractDetails: details })).toEqual(['contractDetails.provider.legalName']);
+    });
+});

package/_test_/unit/retailWizard/emailOtpRequests.test.ts

@@ -0,0 +1,53 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { SendEmailOtpRequest } from '../../../src/retailWizard/dtos/requests/SendEmailOtpRequest';
+import { VerifyEmailOtpRequest } from '../../../src/retailWizard/dtos/requests/VerifyEmailOtpRequest';
+import { EmailStateEnum } from '../../../src/retailWizard/enums/EmailStateEnum';
+import { EmailTypeEnum } from '../../../src/emailVerification/enums/EmailTypeEnum';
+import * as RetailWizard from '../../../src/retailWizard';
+
+function errorsOf<T extends object>(cls: new () => T, payload: Record<string, unknown>): string[] {
+  const dto = plainToInstance(cls, payload, { excludeExtraneousValues: true });
+  return validateSync(dto).map((e) => e.property);
+}
+
+describe('SendEmailOtpRequest', () => {
+  it('acepta correo y tipo válidos', () => {
+    expect(errorsOf(SendEmailOtpRequest, { email: 'cliente@correo.com', type: EmailTypeEnum.PERSONAL })).toEqual([]);
+  });
+
+  it('rechaza un correo mal formado', () => {
+    expect(errorsOf(SendEmailOtpRequest, { email: 'no-es-correo', type: EmailTypeEnum.PERSONAL })).toContain('email');
+  });
+
+  it('rechaza un tipo fuera del enum', () => {
+    expect(errorsOf(SendEmailOtpRequest, { email: 'cliente@correo.com', type: 'WORK' })).toContain('type');
+  });
+
+  it('exige el tipo', () => {
+    expect(errorsOf(SendEmailOtpRequest, { email: 'cliente@correo.com' })).toContain('type');
+  });
+});
+
+describe('VerifyEmailOtpRequest', () => {
+  it('acepta un código de 4 dígitos', () => {
+    expect(errorsOf(VerifyEmailOtpRequest, { code: '1234' })).toEqual([]);
+  });
+
+  it('rechaza un código vacío', () => {
+    expect(errorsOf(VerifyEmailOtpRequest, { code: '' })).toContain('code');
+  });
+});
+
+describe('EmailStateEnum', () => {
+  it('tiene los tres estados del correo de la sesión', () => {
+    expect(Object.values(EmailStateEnum)).toEqual(['EXISTING', 'CAPTURED', 'PENDING']);
+  });
+
+  it('se exporta desde el índice de retailWizard junto con los requests', () => {
+    expect(RetailWizard.EmailStateEnum).toBe(EmailStateEnum);
+    expect(RetailWizard.SendEmailOtpRequest).toBe(SendEmailOtpRequest);
+    expect(RetailWizard.VerifyEmailOtpRequest).toBe(VerifyEmailOtpRequest);
+  });
+});

package/_test_/unit/retailWizard/wizardSessionEmail.test.ts

@@ -0,0 +1,22 @@
+import type { WizardSession } from '../../../src/retailWizard/dtos/WizardSession';
+import { EmailStateEnum } from '../../../src/retailWizard/enums/EmailStateEnum';
+import { EmailTypeEnum } from '../../../src/emailVerification/enums/EmailTypeEnum';
+
+type SessionEmail = Pick<WizardSession, 'emailState' | 'emailType' | 'emailMasked' | 'email'>;
+
+describe('WizardSession — correo del paso 01', () => {
+  it('declara los cuatro campos del correo', () => {
+    const captured: SessionEmail = {
+      emailState: EmailStateEnum.CAPTURED,
+      emailType: EmailTypeEnum.PERSONAL,
+      emailMasked: 'ju•••••@gmail.com',
+      email: 'juan@gmail.com',
+    };
+    expect(captured.emailState).toBe('CAPTURED');
+  });
+
+  it('los cuatro son opcionales: una sesión vieja no los trae', () => {
+    const legacy: SessionEmail = {};
+    expect(legacy).toEqual({});
+  });
+});

package/bin/emailVerification/dtos/EmailSetTrustedRequest.d.ts

@@ -7,4 +7,6 @@ export declare class EmailSetTrustedRequest {
     directoryId: string;
     email: string;
     type: EmailTypeEnum;
+    /** En true, el correo queda como principal del directorio. Sin el campo, no cambia el principal. */
+    isPrincipal?: boolean;
 }

package/bin/emailVerification/dtos/EmailSetTrustedRequest.js

@@ -35,3 +35,9 @@ __decorate([
     (0, class_validator_1.IsEnum)(EmailTypeEnum_1.EmailTypeEnum),
     __metadata("design:type", String)
 ], EmailSetTrustedRequest.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], EmailSetTrustedRequest.prototype, "isPrincipal", void 0);

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

@@ -0,0 +1,42 @@
+/** Datos del acreditado tal como se imprimen en el contrato (Sección II.1). */
+export declare class LoanContractBorrowerDetails {
+    fullName: string;
+    curp: string;
+    /** Domicilio completo en una línea. */
+    address: string;
+    rfc?: string;
+    birthDate?: string;
+    /** Identificación oficial con la que se validó al acreditado (p. ej. INE). */
+    identification?: string;
+    phone?: string;
+    email?: string;
+    occupation?: string;
+    /** Ingresos mensuales declarados, ya formateados (monto o rango). */
+    monthlyIncome?: string;
+    fundsOrigin?: string;
+}
+/** Equipo celular que financia el crédito (Sección II.2). */
+export declare class LoanContractDeviceDetails {
+    brand: string;
+    model: string;
+    color?: string;
+    /** Capacidad de almacenamiento, ya formateada (p. ej. "128 GB"). */
+    storage?: string;
+    imei?: string;
+    serialNumber?: string;
+}
+/** Proveedor que vende el equipo y recibe el desembolso (Sección II.3). */
+export declare class LoanContractProviderDetails {
+    legalName: string;
+}
+/**
+ * Datos del contrato que el motor de crédito no guarda: los aporta el wizard al iniciar la firma
+ * y se imprimen en las plantillas de pdf-render-business. Son PII transitoria: no se persisten ni
+ * se loggean.
+ */
+export declare class LoanContractDetails {
+    borrower: LoanContractBorrowerDetails;
+    device: LoanContractDeviceDetails;
+    /** Si falta, el motor lo resuelve con la tienda del crédito. */
+    provider?: LoanContractProviderDetails;
+}

package/bin/loanCredit/dtos/LoanContractDetails.js

@@ -0,0 +1,187 @@
+"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.LoanContractDetails = exports.LoanContractProviderDetails = exports.LoanContractDeviceDetails = exports.LoanContractBorrowerDetails = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Largo máximo de un texto corto del contrato (RFC, ocupación, marca…). */
+const SHORT_TEXT = 120;
+/** Largo máximo de un texto largo del contrato (nombre, domicilio, razón social). */
+const LONG_TEXT = 300;
+/** IMEI: exactamente 15 dígitos. */
+const IMEI_PATTERN = /^\d{15}$/;
+/** Datos del acreditado tal como se imprimen en el contrato (Sección II.1). */
+class LoanContractBorrowerDetails {
+}
+exports.LoanContractBorrowerDetails = LoanContractBorrowerDetails;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(LONG_TEXT),
+    __metadata("design:type", String)
+], LoanContractBorrowerDetails.prototype, "fullName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(SHORT_TEXT),
+    __metadata("design:type", String)
+], LoanContractBorrowerDetails.prototype, "curp", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(LONG_TEXT),
+    __metadata("design:type", String)
+], LoanContractBorrowerDetails.prototype, "address", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(SHORT_TEXT),
+    __metadata("design:type", String)
+], LoanContractBorrowerDetails.prototype, "rfc", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(SHORT_TEXT),
+    __metadata("design:type", String)
+], LoanContractBorrowerDetails.prototype, "birthDate", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(SHORT_TEXT),
+    __metadata("design:type", String)
+], LoanContractBorrowerDetails.prototype, "identification", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(SHORT_TEXT),
+    __metadata("design:type", String)
+], LoanContractBorrowerDetails.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(LONG_TEXT),
+    __metadata("design:type", String)
+], LoanContractBorrowerDetails.prototype, "email", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(SHORT_TEXT),
+    __metadata("design:type", String)
+], LoanContractBorrowerDetails.prototype, "occupation", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(SHORT_TEXT),
+    __metadata("design:type", String)
+], LoanContractBorrowerDetails.prototype, "monthlyIncome", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(LONG_TEXT),
+    __metadata("design:type", String)
+], LoanContractBorrowerDetails.prototype, "fundsOrigin", void 0);
+/** Equipo celular que financia el crédito (Sección II.2). */
+class LoanContractDeviceDetails {
+}
+exports.LoanContractDeviceDetails = LoanContractDeviceDetails;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(SHORT_TEXT),
+    __metadata("design:type", String)
+], LoanContractDeviceDetails.prototype, "brand", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(SHORT_TEXT),
+    __metadata("design:type", String)
+], LoanContractDeviceDetails.prototype, "model", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(SHORT_TEXT),
+    __metadata("design:type", String)
+], LoanContractDeviceDetails.prototype, "color", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(SHORT_TEXT),
+    __metadata("design:type", String)
+], LoanContractDeviceDetails.prototype, "storage", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(IMEI_PATTERN, { message: 'imei admite solo 15 dígitos' }),
+    __metadata("design:type", String)
+], LoanContractDeviceDetails.prototype, "imei", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(SHORT_TEXT),
+    __metadata("design:type", String)
+], LoanContractDeviceDetails.prototype, "serialNumber", void 0);
+/** Proveedor que vende el equipo y recibe el desembolso (Sección II.3). */
+class LoanContractProviderDetails {
+}
+exports.LoanContractProviderDetails = LoanContractProviderDetails;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(LONG_TEXT),
+    __metadata("design:type", String)
+], LoanContractProviderDetails.prototype, "legalName", void 0);
+/**
+ * Datos del contrato que el motor de crédito no guarda: los aporta el wizard al iniciar la firma
+ * y se imprimen en las plantillas de pdf-render-business. Son PII transitoria: no se persisten ni
+ * se loggean.
+ */
+class LoanContractDetails {
+}
+exports.LoanContractDetails = LoanContractDetails;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => LoanContractBorrowerDetails),
+    __metadata("design:type", LoanContractBorrowerDetails)
+], LoanContractDetails.prototype, "borrower", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => LoanContractDeviceDetails),
+    __metadata("design:type", LoanContractDeviceDetails)
+], LoanContractDetails.prototype, "device", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => LoanContractProviderDetails),
+    __metadata("design:type", LoanContractProviderDetails)
+], LoanContractDetails.prototype, "provider", void 0);

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

@@ -1,3 +1,4 @@
+import { LoanContractDetails } from '../LoanContractDetails';
 /**
  * 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:
@@ -27,6 +28,12 @@ export declare class SignLoanCreditRequest {
      * pagos, tasa) y las pasa a document-generator. NO se persisten ni loggean (silo PII-zero).
      */
     contractData?: Record<string, string>;
+    /**
+     * SOLO en el inicio de firma (tiempo 1): datos del acreditado, del equipo y del proveedor que
+     * imprimen las plantillas de pdf-render-business. Los aporta el WIZARD; mismas reglas de PII
+     * que `contractData`.
+     */
+    contractDetails?: LoanContractDetails;
     /**
      * SOLO en el inicio de firma (tiempo 1) con el OTP REAL: el teléfono destino del SMS (E.164).
      * PII TRANSITORIA: el motor la pasa a messages-business y NO la persiste ni loggea (silo

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

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SignLoanCreditRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const LoanContractDetails_1 = require("../LoanContractDetails");
 /**
  * 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:
@@ -47,6 +48,13 @@ __decorate([
     (0, class_validator_1.IsObject)(),
     __metadata("design:type", Object)
 ], SignLoanCreditRequest.prototype, "contractData", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => LoanContractDetails_1.LoanContractDetails),
+    __metadata("design:type", LoanContractDetails_1.LoanContractDetails)
+], SignLoanCreditRequest.prototype, "contractDetails", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/loanCredit/index.d.ts

@@ -8,6 +8,7 @@ export * from './dtos/LoanCredit';
 export * from './dtos/LoanInstallment';
 export * from './dtos/InstallmentPaidEvent';
 export * from './dtos/LoanContract';
+export * from './dtos/LoanContractDetails';
 export * from './dtos/ActivationChecklist';
 export * from './dtos/AppliedPromotionSnapshot';
 export * from './dtos/AppliedStorePolicySnapshot';

package/bin/loanCredit/index.js

@@ -29,6 +29,7 @@ __exportStar(require("./dtos/LoanCredit"), exports);
 __exportStar(require("./dtos/LoanInstallment"), exports);
 __exportStar(require("./dtos/InstallmentPaidEvent"), exports);
 __exportStar(require("./dtos/LoanContract"), exports);
+__exportStar(require("./dtos/LoanContractDetails"), exports);
 __exportStar(require("./dtos/ActivationChecklist"), exports);
 __exportStar(require("./dtos/AppliedPromotionSnapshot"), exports);
 __exportStar(require("./dtos/AppliedStorePolicySnapshot"), exports);

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

@@ -15,6 +15,8 @@ import type { WizardReservedLine } from './WizardReservedLine';
 import type { WizardResumeTarget } from './WizardResumeTarget';
 import type { WizardWelcome } from './WizardWelcome';
 import type { WizardCreditPromotionBonus } from './WizardCreditPromotionBonus';
+import type { EmailStateEnum } from '../enums/EmailStateEnum';
+import type { EmailTypeEnum } from '../../emailVerification/enums/EmailTypeEnum';
 /** Modalidad de captura del KYC (M1 §213-329). */
 export type KycModality = 'CUSTOMER_LINK' | 'STORE_DEVICE' | 'MANUAL';
 /** Estado de la apertura de cuenta async (D35) — espejo de `RetailCustomer.accountStatus`. */
@@ -64,6 +66,14 @@ export interface WizardSession {
      */
     resumeTarget?: WizardResumeTarget | null;
     consents: WizardConsents | null;
+    /** Estado del correo del cliente en el paso 01. Ausente en sesiones anteriores al correo. */
+    emailState?: EmailStateEnum;
+    /** Tipo del correo: personal o corporativo. */
+    emailType?: EmailTypeEnum;
+    /** Correo enmascarado (`ju•••••@gmail.com`); viaja siempre que la sesión tenga correo. */
+    emailMasked?: string;
+    /** Correo completo: solo con `emailState` CAPTURED, porque lo tecleó el vendedor. */
+    email?: string;
     /** Espejo del estado KYC (fuente = customer). */
     kycStatus: string | null;
     kycModality: KycModality | null;

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

@@ -0,0 +1,6 @@
+import { EmailTypeEnum } from '../../../emailVerification/enums/EmailTypeEnum';
+/** POST /wizard/sessions/:id/email/otp/send — manda el código al correo que capturó el vendedor. */
+export declare class SendEmailOtpRequest {
+    email: string;
+    type: EmailTypeEnum;
+}

package/bin/retailWizard/dtos/requests/SendEmailOtpRequest.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.SendEmailOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const EmailTypeEnum_1 = require("../../../emailVerification/enums/EmailTypeEnum");
+/** POST /wizard/sessions/:id/email/otp/send — manda el código al correo que capturó el vendedor. */
+class SendEmailOtpRequest {
+}
+exports.SendEmailOtpRequest = SendEmailOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], SendEmailOtpRequest.prototype, "email", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(EmailTypeEnum_1.EmailTypeEnum),
+    __metadata("design:type", String)
+], SendEmailOtpRequest.prototype, "type", void 0);

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

@@ -0,0 +1,4 @@
+/** POST /wizard/sessions/:id/email/otp/verify — verifica el código que llegó al correo. */
+export declare class VerifyEmailOtpRequest {
+    code: string;
+}

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

@@ -0,0 +1,24 @@
+"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.VerifyEmailOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** POST /wizard/sessions/:id/email/otp/verify — verifica el código que llegó al correo. */
+class VerifyEmailOtpRequest {
+}
+exports.VerifyEmailOtpRequest = VerifyEmailOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(4, 8),
+    __metadata("design:type", String)
+], VerifyEmailOtpRequest.prototype, "code", void 0);

package/bin/retailWizard/enums/EmailStateEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Correo de la sesión del wizard: EXISTING = ya verificado en contacts; CAPTURED = lo tecleó el
+ * vendedor y se verificó con OTP; PENDING = falta capturarlo o verificarlo.
+ */
+export declare enum EmailStateEnum {
+    EXISTING = "EXISTING",
+    CAPTURED = "CAPTURED",
+    PENDING = "PENDING"
+}

package/bin/retailWizard/enums/EmailStateEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailStateEnum = void 0;
+/**
+ * Correo de la sesión del wizard: EXISTING = ya verificado en contacts; CAPTURED = lo tecleó el
+ * vendedor y se verificó con OTP; PENDING = falta capturarlo o verificarlo.
+ */
+var EmailStateEnum;
+(function (EmailStateEnum) {
+    EmailStateEnum["EXISTING"] = "EXISTING";
+    EmailStateEnum["CAPTURED"] = "CAPTURED";
+    EmailStateEnum["PENDING"] = "PENDING";
+})(EmailStateEnum || (exports.EmailStateEnum = EmailStateEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -26,6 +26,7 @@ export * from './enums/BlockedCategoryEnum';
 export * from './enums/WizardLineStatusEnum';
 export * from './enums/LinePaymentTypeEnum';
 export * from './enums/WizardLineRoleEnum';
+export * from './enums/EmailStateEnum';
 export * from './dtos/WizardConsents';
 export * from './dtos/WizardPayment';
 export * from './dtos/WizardProduct';
@@ -90,6 +91,8 @@ export * from './dtos/requests/SignatureSignRequest';
 export * from './dtos/requests/RegisterDeviceRequest';
 export * from './dtos/requests/CompleteSaleRequest';
 export * from './dtos/requests/SuggestIdentifiersQuery';
+export * from './dtos/requests/SendEmailOtpRequest';
+export * from './dtos/requests/VerifyEmailOtpRequest';
 export * from './dtos/responses/KycPrepareResponse';
 export * from './dtos/responses/ProofOfAddressPrepareResponse';
 export * from './dtos/responses/SessionFinanciersResponse';

package/bin/retailWizard/index.js

@@ -45,6 +45,7 @@ __exportStar(require("./enums/BlockedCategoryEnum"), exports);
 __exportStar(require("./enums/WizardLineStatusEnum"), exports);
 __exportStar(require("./enums/LinePaymentTypeEnum"), exports);
 __exportStar(require("./enums/WizardLineRoleEnum"), exports);
+__exportStar(require("./enums/EmailStateEnum"), exports);
 // DTOs anidados
 __exportStar(require("./dtos/WizardConsents"), exports);
 __exportStar(require("./dtos/WizardPayment"), exports);
@@ -115,6 +116,8 @@ __exportStar(require("./dtos/requests/SignatureSignRequest"), exports);
 __exportStar(require("./dtos/requests/RegisterDeviceRequest"), exports);
 __exportStar(require("./dtos/requests/CompleteSaleRequest"), exports);
 __exportStar(require("./dtos/requests/SuggestIdentifiersQuery"), exports);
+__exportStar(require("./dtos/requests/SendEmailOtpRequest"), exports);
+__exportStar(require("./dtos/requests/VerifyEmailOtpRequest"), exports);
 // Response DTOs (output tipado por endpoint)
 __exportStar(require("./dtos/responses/KycPrepareResponse"), exports);
 __exportStar(require("./dtos/responses/ProofOfAddressPrepareResponse"), exports);

package/package.json

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

package/src/emailVerification/dtos/EmailSetTrustedRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsEmail, IsEnum, IsString } from 'class-validator';
+import { IsBoolean, IsEmail, IsEnum, IsOptional, IsString } from 'class-validator';
 import { EmailTypeEnum } from '../enums/EmailTypeEnum';
 
 /**
@@ -18,4 +18,10 @@ export class EmailSetTrustedRequest {
     @Expose()
     @IsEnum(EmailTypeEnum)
     type!: EmailTypeEnum;
+
+    /** En true, el correo queda como principal del directorio. Sin el campo, no cambia el principal. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    isPrincipal?: boolean;
 }

package/src/loanCredit/dtos/LoanContractDetails.ts

@@ -0,0 +1,156 @@
+import { Expose, Type } from 'class-transformer';
+import { IsDefined, IsNotEmpty, IsOptional, IsString, Matches, MaxLength, ValidateNested } from 'class-validator';
+
+/** Largo máximo de un texto corto del contrato (RFC, ocupación, marca…). */
+const SHORT_TEXT = 120;
+/** Largo máximo de un texto largo del contrato (nombre, domicilio, razón social). */
+const LONG_TEXT = 300;
+/** IMEI: exactamente 15 dígitos. */
+const IMEI_PATTERN = /^\d{15}$/;
+
+/** Datos del acreditado tal como se imprimen en el contrato (Sección II.1). */
+export class LoanContractBorrowerDetails {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(LONG_TEXT)
+    fullName: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(SHORT_TEXT)
+    curp: string;
+
+    /** Domicilio completo en una línea. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(LONG_TEXT)
+    address: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(SHORT_TEXT)
+    rfc?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(SHORT_TEXT)
+    birthDate?: string;
+
+    /** Identificación oficial con la que se validó al acreditado (p. ej. INE). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(SHORT_TEXT)
+    identification?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(SHORT_TEXT)
+    phone?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(LONG_TEXT)
+    email?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(SHORT_TEXT)
+    occupation?: string;
+
+    /** Ingresos mensuales declarados, ya formateados (monto o rango). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(SHORT_TEXT)
+    monthlyIncome?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(LONG_TEXT)
+    fundsOrigin?: string;
+}
+
+/** Equipo celular que financia el crédito (Sección II.2). */
+export class LoanContractDeviceDetails {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(SHORT_TEXT)
+    brand: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(SHORT_TEXT)
+    model: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(SHORT_TEXT)
+    color?: string;
+
+    /** Capacidad de almacenamiento, ya formateada (p. ej. "128 GB"). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(SHORT_TEXT)
+    storage?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Matches(IMEI_PATTERN, { message: 'imei admite solo 15 dígitos' })
+    imei?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(SHORT_TEXT)
+    serialNumber?: string;
+}
+
+/** Proveedor que vende el equipo y recibe el desembolso (Sección II.3). */
+export class LoanContractProviderDetails {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(LONG_TEXT)
+    legalName: string;
+}
+
+/**
+ * Datos del contrato que el motor de crédito no guarda: los aporta el wizard al iniciar la firma
+ * y se imprimen en las plantillas de pdf-render-business. Son PII transitoria: no se persisten ni
+ * se loggean.
+ */
+export class LoanContractDetails {
+    @Expose()
+    @IsDefined()
+    @ValidateNested()
+    @Type(() => LoanContractBorrowerDetails)
+    borrower: LoanContractBorrowerDetails;
+
+    @Expose()
+    @IsDefined()
+    @ValidateNested()
+    @Type(() => LoanContractDeviceDetails)
+    device: LoanContractDeviceDetails;
+
+    /** Si falta, el motor lo resuelve con la tienda del crédito. */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => LoanContractProviderDetails)
+    provider?: LoanContractProviderDetails;
+}

package/src/loanCredit/dtos/requests/SignLoanCreditRequest.ts

@@ -1,5 +1,6 @@
-import { Expose } from 'class-transformer';
-import { IsObject, IsOptional, IsString, Length } from 'class-validator';
+import { Expose, Type } from 'class-transformer';
+import { IsObject, IsOptional, IsString, Length, ValidateNested } from 'class-validator';
+import { LoanContractDetails } from '../LoanContractDetails';
 
 /**
  * Body de `POST /private/credits/:creditId/sign` (loan-credit-business — wizard paso 08, firma FES
@@ -43,6 +44,17 @@ export class SignLoanCreditRequest {
     @IsObject()
     contractData?: Record<string, string>;
 
+    /**
+     * SOLO en el inicio de firma (tiempo 1): datos del acreditado, del equipo y del proveedor que
+     * imprimen las plantillas de pdf-render-business. Los aporta el WIZARD; mismas reglas de PII
+     * que `contractData`.
+     */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => LoanContractDetails)
+    contractDetails?: LoanContractDetails;
+
     /**
      * SOLO en el inicio de firma (tiempo 1) con el OTP REAL: el teléfono destino del SMS (E.164).
      * PII TRANSITORIA: el motor la pasa a messages-business y NO la persiste ni loggea (silo

package/src/loanCredit/index.ts

@@ -12,6 +12,7 @@ export * from './dtos/LoanCredit';
 export * from './dtos/LoanInstallment';
 export * from './dtos/InstallmentPaidEvent';
 export * from './dtos/LoanContract';
+export * from './dtos/LoanContractDetails';
 export * from './dtos/ActivationChecklist';
 export * from './dtos/AppliedPromotionSnapshot';
 export * from './dtos/AppliedStorePolicySnapshot';

package/src/retailWizard/dtos/WizardSession.ts

@@ -15,6 +15,8 @@ import type { WizardReservedLine } from './WizardReservedLine';
 import type { WizardResumeTarget } from './WizardResumeTarget';
 import type { WizardWelcome } from './WizardWelcome';
 import type { WizardCreditPromotionBonus } from './WizardCreditPromotionBonus';
+import type { EmailStateEnum } from '../enums/EmailStateEnum';
+import type { EmailTypeEnum } from '../../emailVerification/enums/EmailTypeEnum';
 
 /** Modalidad de captura del KYC (M1 §213-329). */
 export type KycModality = 'CUSTOMER_LINK' | 'STORE_DEVICE' | 'MANUAL';
@@ -68,6 +70,14 @@ export interface WizardSession {
    */
   resumeTarget?: WizardResumeTarget | null;
   consents: WizardConsents | null;
+  /** Estado del correo del cliente en el paso 01. Ausente en sesiones anteriores al correo. */
+  emailState?: EmailStateEnum;
+  /** Tipo del correo: personal o corporativo. */
+  emailType?: EmailTypeEnum;
+  /** Correo enmascarado (`ju•••••@gmail.com`); viaja siempre que la sesión tenga correo. */
+  emailMasked?: string;
+  /** Correo completo: solo con `emailState` CAPTURED, porque lo tecleó el vendedor. */
+  email?: string;
   /** Espejo del estado KYC (fuente = customer). */
   kycStatus: string | null;
   kycModality: KycModality | null;

package/src/retailWizard/dtos/requests/SendEmailOtpRequest.ts

@@ -0,0 +1,14 @@
+import { Expose } from 'class-transformer';
+import { IsEmail, IsEnum } from 'class-validator';
+import { EmailTypeEnum } from '../../../emailVerification/enums/EmailTypeEnum';
+
+/** POST /wizard/sessions/:id/email/otp/send — manda el código al correo que capturó el vendedor. */
+export class SendEmailOtpRequest {
+  @Expose()
+  @IsEmail()
+  email!: string;
+
+  @Expose()
+  @IsEnum(EmailTypeEnum)
+  type!: EmailTypeEnum;
+}

package/src/retailWizard/dtos/requests/VerifyEmailOtpRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsString, Length } from 'class-validator';
+
+/** POST /wizard/sessions/:id/email/otp/verify — verifica el código que llegó al correo. */
+export class VerifyEmailOtpRequest {
+  @Expose()
+  @IsString()
+  @Length(4, 8)
+  code!: string;
+}

package/src/retailWizard/enums/EmailStateEnum.ts

@@ -0,0 +1,9 @@
+/**
+ * Correo de la sesión del wizard: EXISTING = ya verificado en contacts; CAPTURED = lo tecleó el
+ * vendedor y se verificó con OTP; PENDING = falta capturarlo o verificarlo.
+ */
+export enum EmailStateEnum {
+    EXISTING = 'EXISTING',
+    CAPTURED = 'CAPTURED',
+    PENDING = 'PENDING',
+}

package/src/retailWizard/index.ts

@@ -29,6 +29,7 @@ export * from './enums/BlockedCategoryEnum';
 export * from './enums/WizardLineStatusEnum';
 export * from './enums/LinePaymentTypeEnum';
 export * from './enums/WizardLineRoleEnum';
+export * from './enums/EmailStateEnum';
 
 // DTOs anidados
 export * from './dtos/WizardConsents';
@@ -101,6 +102,8 @@ export * from './dtos/requests/SignatureSignRequest';
 export * from './dtos/requests/RegisterDeviceRequest';
 export * from './dtos/requests/CompleteSaleRequest';
 export * from './dtos/requests/SuggestIdentifiersQuery';
+export * from './dtos/requests/SendEmailOtpRequest';
+export * from './dtos/requests/VerifyEmailOtpRequest';
 
 // Response DTOs (output tipado por endpoint)
 export * from './dtos/responses/KycPrepareResponse';