@fiado/type-kit 3.531.0 → 3.533.0

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

@@ -0,0 +1,33 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { ValidationError, validate } from 'class-validator';
+import { PreviewLoanContractRequest } from '../../../src/loanCredit/index';
+
+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(PreviewLoanContractRequest, body))).sort();
+
+const DETAILS = {
+    borrower: { fullName: 'María López', curp: 'LOHM900215MMCPRR09', address: 'Av. Ejemplo 123, Toluca' },
+    device: { brand: 'Samsung', model: 'Galaxy A15' },
+};
+
+describe('PreviewLoanContractRequest', () => {
+    it('acepta los datos del contrato', async () => {
+        expect(await errorsOf({ contractDetails: DETAILS })).toEqual([]);
+    });
+
+    it('sin datos del contrato no hay vista previa que armar', async () => {
+        expect(await errorsOf({})).toEqual(['contractDetails']);
+    });
+
+    it('valida los datos anidados igual que la firma', async () => {
+        const details = { ...DETAILS, device: { brand: 'Samsung' } };
+        expect(await errorsOf({ contractDetails: details })).toEqual(['contractDetails.device.model']);
+    });
+});

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

@@ -61,6 +61,21 @@ describe('SignLoanCreditRequest', () => {
         expect(await errorsOf({ contractDetails: details })).toEqual(['contractDetails.device.imei']);
     });
 
+    it('acepta la cuenta Pago Confiado con su CLABE de 18 dígitos', async () => {
+        const details = { ...DETAILS, pcfAccount: { clabe: '646180157000000004' } };
+        expect(await errorsOf({ contractDetails: details })).toEqual([]);
+    });
+
+    it('la cuenta Pago Confiado es opcional', async () => {
+        expect(DETAILS).not.toHaveProperty('pcfAccount');
+        expect(await errorsOf({ contractDetails: DETAILS })).toEqual([]);
+    });
+
+    it('rechaza una CLABE que no tiene 18 dígitos', async () => {
+        const details = { ...DETAILS, pcfAccount: { clabe: 'dummy' } };
+        expect(await errorsOf({ contractDetails: details })).toEqual(['contractDetails.pcfAccount.clabe']);
+    });
+
     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/bin/loanCredit/dtos/LoanContractDetails.d.ts

@@ -29,6 +29,10 @@ export declare class LoanContractDeviceDetails {
 export declare class LoanContractProviderDetails {
     legalName: string;
 }
+/** Cuenta Pago Confiado del acreditado, de la que se cobra el crédito (Secciones VI y VIII). */
+export declare class LoanContractPcfAccountDetails {
+    clabe: 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
@@ -39,4 +43,6 @@ export declare class LoanContractDetails {
     device: LoanContractDeviceDetails;
     /** Si falta, el motor lo resuelve con la tienda del crédito. */
     provider?: LoanContractProviderDetails;
+    /** Si falta, el contrato deja la cuenta en blanco. */
+    pcfAccount?: LoanContractPcfAccountDetails;
 }

package/bin/loanCredit/dtos/LoanContractDetails.js

@@ -9,7 +9,7 @@ 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;
+exports.LoanContractDetails = exports.LoanContractPcfAccountDetails = 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…). */
@@ -18,6 +18,8 @@ const SHORT_TEXT = 120;
 const LONG_TEXT = 300;
 /** IMEI: exactamente 15 dígitos. */
 const IMEI_PATTERN = /^\d{15}$/;
+/** CLABE: exactamente 18 dígitos. */
+const CLABE_PATTERN = /^\d{18}$/;
 /** Datos del acreditado tal como se imprimen en el contrato (Sección II.1). */
 class LoanContractBorrowerDetails {
 }
@@ -156,6 +158,16 @@ __decorate([
     (0, class_validator_1.MaxLength)(LONG_TEXT),
     __metadata("design:type", String)
 ], LoanContractProviderDetails.prototype, "legalName", void 0);
+/** Cuenta Pago Confiado del acreditado, de la que se cobra el crédito (Secciones VI y VIII). */
+class LoanContractPcfAccountDetails {
+}
+exports.LoanContractPcfAccountDetails = LoanContractPcfAccountDetails;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(CLABE_PATTERN, { message: 'clabe admite solo 18 dígitos' }),
+    __metadata("design:type", String)
+], LoanContractPcfAccountDetails.prototype, "clabe", 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
@@ -185,3 +197,10 @@ __decorate([
     (0, class_transformer_1.Type)(() => LoanContractProviderDetails),
     __metadata("design:type", LoanContractProviderDetails)
 ], LoanContractDetails.prototype, "provider", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => LoanContractPcfAccountDetails),
+    __metadata("design:type", LoanContractPcfAccountDetails)
+], LoanContractDetails.prototype, "pcfAccount", void 0);

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

@@ -0,0 +1,9 @@
+import { LoanContractDetails } from '../LoanContractDetails';
+/**
+ * POST /private/credits/{creditId}/contract/preview — vista previa del contrato antes de enviar el
+ * código de firma. Lleva los mismos datos del acreditado y del equipo que el inicio de la firma; los
+ * términos salen del crédito guardado. PII transitoria: no se persiste ni se loguea.
+ */
+export declare class PreviewLoanContractRequest {
+    contractDetails: LoanContractDetails;
+}

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

@@ -0,0 +1,30 @@
+"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.PreviewLoanContractRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const LoanContractDetails_1 = require("../LoanContractDetails");
+/**
+ * POST /private/credits/{creditId}/contract/preview — vista previa del contrato antes de enviar el
+ * código de firma. Lleva los mismos datos del acreditado y del equipo que el inicio de la firma; los
+ * términos salen del crédito guardado. PII transitoria: no se persiste ni se loguea.
+ */
+class PreviewLoanContractRequest {
+}
+exports.PreviewLoanContractRequest = PreviewLoanContractRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => LoanContractDetails_1.LoanContractDetails),
+    __metadata("design:type", LoanContractDetails_1.LoanContractDetails)
+], PreviewLoanContractRequest.prototype, "contractDetails", void 0);

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

@@ -0,0 +1,5 @@
+/** Enlace prefirmado y temporal a la vista previa del contrato. `expiresAt` en ISO-8601. */
+export interface LoanContractPreview {
+    url: string;
+    expiresAt: string;
+}

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

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

package/bin/loanCredit/index.d.ts

@@ -19,6 +19,7 @@ export * from './dtos/requests/UpdateLoanBorrowerSciRequest';
 export * from './dtos/requests/OriginateLoanCreditRequest';
 export * from './dtos/requests/QuoteLoanCreditRequest';
 export * from './dtos/requests/SignLoanCreditRequest';
+export * from './dtos/requests/PreviewLoanContractRequest';
 export * from './dtos/requests/ActivationCheckRequest';
 export * from './dtos/requests/CreditPaymentAppliedRequest';
 export * from './dtos/requests/CreditSettledRequest';
@@ -37,6 +38,7 @@ export * from './dtos/responses/LoanBorrowerCreditItem';
 export * from './dtos/responses/LoanCreditDetail';
 export * from './dtos/responses/LoanPaymentListItem';
 export * from './dtos/responses/LoanContractDownloadUrl';
+export * from './dtos/responses/LoanContractPreview';
 export * from './dtos/responses/LoanContractResponse';
 export * from './dtos/responses/OriginateLoanCreditResponse';
 export * from './dtos/responses/QuoteLoanCreditResponse';

package/bin/loanCredit/index.js

@@ -41,6 +41,7 @@ __exportStar(require("./dtos/requests/UpdateLoanBorrowerSciRequest"), exports);
 __exportStar(require("./dtos/requests/OriginateLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/QuoteLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/SignLoanCreditRequest"), exports);
+__exportStar(require("./dtos/requests/PreviewLoanContractRequest"), exports);
 __exportStar(require("./dtos/requests/ActivationCheckRequest"), exports);
 __exportStar(require("./dtos/requests/CreditPaymentAppliedRequest"), exports);
 __exportStar(require("./dtos/requests/CreditSettledRequest"), exports);
@@ -61,6 +62,7 @@ __exportStar(require("./dtos/responses/LoanBorrowerCreditItem"), exports);
 __exportStar(require("./dtos/responses/LoanCreditDetail"), exports);
 __exportStar(require("./dtos/responses/LoanPaymentListItem"), exports);
 __exportStar(require("./dtos/responses/LoanContractDownloadUrl"), exports);
+__exportStar(require("./dtos/responses/LoanContractPreview"), exports);
 __exportStar(require("./dtos/responses/LoanContractResponse"), exports);
 __exportStar(require("./dtos/responses/OriginateLoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/QuoteLoanCreditResponse"), exports);

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

@@ -0,0 +1,10 @@
+/**
+ * GET /wizard/sessions/:id/contract/document — enlace prefirmado y temporal al PDF del contrato del
+ * paso 08. Antes de enviar el código es una vista previa (`preview: true`) con el mismo contenido;
+ * desde el envío del código es el contrato que se firma.
+ */
+export interface ContractDocumentResponse {
+    url: string;
+    expiresAt: string;
+    preview: boolean;
+}

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

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

package/bin/retailWizard/index.d.ts

@@ -101,6 +101,7 @@ export * from './dtos/responses/ScoreResultResponse';
 export * from './dtos/responses/QuoteResponse';
 export * from './dtos/responses/DownPaymentResponse';
 export * from './dtos/responses/ContractPreviewResponse';
+export * from './dtos/responses/ContractDocumentResponse';
 export * from './dtos/responses/SignatureSendOtpResponse';
 export * from './dtos/responses/SignatureSignResponse';
 export * from './dtos/responses/RegisterDeviceResponse';

package/bin/retailWizard/index.js

@@ -127,6 +127,7 @@ __exportStar(require("./dtos/responses/ScoreResultResponse"), exports);
 __exportStar(require("./dtos/responses/QuoteResponse"), exports);
 __exportStar(require("./dtos/responses/DownPaymentResponse"), exports);
 __exportStar(require("./dtos/responses/ContractPreviewResponse"), exports);
+__exportStar(require("./dtos/responses/ContractDocumentResponse"), exports);
 __exportStar(require("./dtos/responses/SignatureSendOtpResponse"), exports);
 __exportStar(require("./dtos/responses/SignatureSignResponse"), exports);
 __exportStar(require("./dtos/responses/RegisterDeviceResponse"), exports);

package/package.json

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

package/src/loanCredit/dtos/LoanContractDetails.ts

@@ -7,6 +7,8 @@ const SHORT_TEXT = 120;
 const LONG_TEXT = 300;
 /** IMEI: exactamente 15 dígitos. */
 const IMEI_PATTERN = /^\d{15}$/;
+/** CLABE: exactamente 18 dígitos. */
+const CLABE_PATTERN = /^\d{18}$/;
 
 /** Datos del acreditado tal como se imprimen en el contrato (Sección II.1). */
 export class LoanContractBorrowerDetails {
@@ -129,6 +131,14 @@ export class LoanContractProviderDetails {
     legalName: string;
 }
 
+/** Cuenta Pago Confiado del acreditado, de la que se cobra el crédito (Secciones VI y VIII). */
+export class LoanContractPcfAccountDetails {
+    @Expose()
+    @IsString()
+    @Matches(CLABE_PATTERN, { message: 'clabe admite solo 18 dígitos' })
+    clabe: 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
@@ -153,4 +163,11 @@ export class LoanContractDetails {
     @ValidateNested()
     @Type(() => LoanContractProviderDetails)
     provider?: LoanContractProviderDetails;
+
+    /** Si falta, el contrato deja la cuenta en blanco. */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => LoanContractPcfAccountDetails)
+    pcfAccount?: LoanContractPcfAccountDetails;
 }

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

@@ -0,0 +1,16 @@
+import { Expose, Type } from 'class-transformer';
+import { IsDefined, ValidateNested } from 'class-validator';
+import { LoanContractDetails } from '../LoanContractDetails';
+
+/**
+ * POST /private/credits/{creditId}/contract/preview — vista previa del contrato antes de enviar el
+ * código de firma. Lleva los mismos datos del acreditado y del equipo que el inicio de la firma; los
+ * términos salen del crédito guardado. PII transitoria: no se persiste ni se loguea.
+ */
+export class PreviewLoanContractRequest {
+    @Expose()
+    @IsDefined()
+    @ValidateNested()
+    @Type(() => LoanContractDetails)
+    contractDetails: LoanContractDetails;
+}

package/src/loanCredit/dtos/responses/LoanContractPreview.ts

@@ -0,0 +1,5 @@
+/** Enlace prefirmado y temporal a la vista previa del contrato. `expiresAt` en ISO-8601. */
+export interface LoanContractPreview {
+    url: string;
+    expiresAt: string;
+}

package/src/loanCredit/index.ts

@@ -25,6 +25,7 @@ export * from './dtos/requests/UpdateLoanBorrowerSciRequest';
 export * from './dtos/requests/OriginateLoanCreditRequest';
 export * from './dtos/requests/QuoteLoanCreditRequest';
 export * from './dtos/requests/SignLoanCreditRequest';
+export * from './dtos/requests/PreviewLoanContractRequest';
 export * from './dtos/requests/ActivationCheckRequest';
 export * from './dtos/requests/CreditPaymentAppliedRequest';
 export * from './dtos/requests/CreditSettledRequest';
@@ -46,6 +47,7 @@ export * from './dtos/responses/LoanBorrowerCreditItem';
 export * from './dtos/responses/LoanCreditDetail';
 export * from './dtos/responses/LoanPaymentListItem';
 export * from './dtos/responses/LoanContractDownloadUrl';
+export * from './dtos/responses/LoanContractPreview';
 export * from './dtos/responses/LoanContractResponse';
 export * from './dtos/responses/OriginateLoanCreditResponse';
 export * from './dtos/responses/QuoteLoanCreditResponse';

package/src/retailWizard/dtos/responses/ContractDocumentResponse.ts

@@ -0,0 +1,10 @@
+/**
+ * GET /wizard/sessions/:id/contract/document — enlace prefirmado y temporal al PDF del contrato del
+ * paso 08. Antes de enviar el código es una vista previa (`preview: true`) con el mismo contenido;
+ * desde el envío del código es el contrato que se firma.
+ */
+export interface ContractDocumentResponse {
+    url: string;
+    expiresAt: string;
+    preview: boolean;
+}

package/src/retailWizard/index.ts

@@ -114,6 +114,7 @@ export * from './dtos/responses/ScoreResultResponse';
 export * from './dtos/responses/QuoteResponse';
 export * from './dtos/responses/DownPaymentResponse';
 export * from './dtos/responses/ContractPreviewResponse';
+export * from './dtos/responses/ContractDocumentResponse';
 export * from './dtos/responses/SignatureSendOtpResponse';
 export * from './dtos/responses/SignatureSignResponse';
 export * from './dtos/responses/RegisterDeviceResponse';