@fiado/type-kit 3.526.0 → 3.528.0

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/pdfRender/pdfRenderDtos.test.ts

@@ -77,10 +77,10 @@ describe('pdfRender includeContent', () => {
 
 describe('pdfRender referenceId', () => {
     it('accepts the owner id and folder fields, and rejects unsafe segments', async () => {
-        const template = { enterprise: 'SUREKEEP', documentType: 'CREDITO_CONTRATO' };
+        const template = { enterprise: 'SUREKEEP', documentType: 'CREDIT_CONTRACT' };
         expect(await errorsOf(RenderDocumentRequest, { template, data: {}, referenceId: '01JX9KAB12' })).toEqual([]);
         expect(await errorsOf(RenderDocumentRequest, { template, data: {}, referenceId: '../x' })).toEqual(['referenceId']);
-        expect(await errorsOf(GeneratePdfRequest, { html: '<p/>', enterprise: 'SUREKEEP', documentType: 'CREDITO_RESUMEN', referenceId: 'abc' })).toEqual([]);
+        expect(await errorsOf(GeneratePdfRequest, { html: '<p/>', enterprise: 'SUREKEEP', documentType: 'CREDIT_SUMMARY', referenceId: 'abc' })).toEqual([]);
         expect(await errorsOf(MergePdfsRequest, { pdfs: ['JVBERi0='], enterprise: 'A/B' })).toEqual(['enterprise']);
     });
 });

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/pdfRender/dtos/GeneratePdfRequest.d.ts

@@ -5,7 +5,7 @@ export declare class GeneratePdfRequest {
     includeContent?: boolean;
     /** Empresa (tenant) dueña del documento; sin ella se guarda en una carpeta común. */
     enterprise?: string;
-    /** Tipo de documento (carpeta en S3), p. ej. CREDITO_CONTRATO. */
+    /** Tipo de documento (carpeta en S3), p. ej. CREDIT_CONTRACT. */
     documentType?: string;
     /**
      * Id de la entidad dueña del documento (crédito, cliente...). Forma parte de la llave en S3, igual

package/bin/pdfRender/dtos/MergePdfsRequest.d.ts

@@ -5,7 +5,7 @@ export declare class MergePdfsRequest {
     includeContent?: boolean;
     /** Empresa (tenant) dueña del documento; sin ella se guarda en una carpeta común. */
     enterprise?: string;
-    /** Tipo de documento (carpeta en S3), p. ej. CREDITO_CONTRATO. */
+    /** Tipo de documento (carpeta en S3), p. ej. CREDIT_CONTRACT. */
     documentType?: string;
     /**
      * Id de la entidad dueña del documento (crédito, cliente...). Forma parte de la llave en S3, igual

package/bin/pdfRender/dtos/PdfDocumentResponse.d.ts

@@ -1,7 +1,8 @@
 /**
  * Documento PDF generado y guardado por pdf-render-business.
- * `key` es la ubicación del documento por convención ({EMPRESA}/{TIPO}/{aaaa}/{mm}/{uuid}.pdf) y
- * es lo que se guarda para pedir una URL nueva con GET /documents/url?key=... cuando venza la actual.
+ * `key` es la ubicación del documento en el bucket de contratos, por convención
+ * {EMPRESA}/{TIPO}/{referenceId}/{uuid}.pdf (o {EMPRESA}/{PARTNER}/{CATEGORIA}/{referenceId}/{TIPO}/{uuid}.pdf),
+ * y es lo que se guarda para pedir una URL nueva con GET /documents/url?key=... cuando venza la actual.
  */
 export declare class PdfDocumentResponse {
     key: string;

package/bin/pdfRender/dtos/PdfDocumentResponse.js

@@ -3,8 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PdfDocumentResponse = void 0;
 /**
  * Documento PDF generado y guardado por pdf-render-business.
- * `key` es la ubicación del documento por convención ({EMPRESA}/{TIPO}/{aaaa}/{mm}/{uuid}.pdf) y
- * es lo que se guarda para pedir una URL nueva con GET /documents/url?key=... cuando venza la actual.
+ * `key` es la ubicación del documento en el bucket de contratos, por convención
+ * {EMPRESA}/{TIPO}/{referenceId}/{uuid}.pdf (o {EMPRESA}/{PARTNER}/{CATEGORIA}/{referenceId}/{TIPO}/{uuid}.pdf),
+ * y es lo que se guarda para pedir una URL nueva con GET /documents/url?key=... cuando venza la actual.
  */
 class PdfDocumentResponse {
 }

package/package.json

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

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/pdfRender/dtos/GeneratePdfRequest.ts

@@ -13,7 +13,7 @@ export class GeneratePdfRequest {
     @IsOptional() @IsString() @Matches(/^[A-Za-z0-9_-]{1,64}$/)
     enterprise?: string;
 
-    /** Tipo de documento (carpeta en S3), p. ej. CREDITO_CONTRATO. */
+    /** Tipo de documento (carpeta en S3), p. ej. CREDIT_CONTRACT. */
     @IsOptional() @IsString() @Matches(/^[A-Za-z0-9_-]{1,64}$/)
     documentType?: string;
 

package/src/pdfRender/dtos/MergePdfsRequest.ts

@@ -13,7 +13,7 @@ export class MergePdfsRequest {
     @IsOptional() @IsString() @Matches(/^[A-Za-z0-9_-]{1,64}$/)
     enterprise?: string;
 
-    /** Tipo de documento (carpeta en S3), p. ej. CREDITO_CONTRATO. */
+    /** Tipo de documento (carpeta en S3), p. ej. CREDIT_CONTRACT. */
     @IsOptional() @IsString() @Matches(/^[A-Za-z0-9_-]{1,64}$/)
     documentType?: string;
 

package/src/pdfRender/dtos/PdfDocumentResponse.ts

@@ -1,7 +1,8 @@
 /**
  * Documento PDF generado y guardado por pdf-render-business.
- * `key` es la ubicación del documento por convención ({EMPRESA}/{TIPO}/{aaaa}/{mm}/{uuid}.pdf) y
- * es lo que se guarda para pedir una URL nueva con GET /documents/url?key=... cuando venza la actual.
+ * `key` es la ubicación del documento en el bucket de contratos, por convención
+ * {EMPRESA}/{TIPO}/{referenceId}/{uuid}.pdf (o {EMPRESA}/{PARTNER}/{CATEGORIA}/{referenceId}/{TIPO}/{uuid}.pdf),
+ * y es lo que se guarda para pedir una URL nueva con GET /documents/url?key=... cuando venza la actual.
  */
 export class PdfDocumentResponse {
     key!: string;