@fiado/type-kit 3.532.0 → 3.534.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

@@ -71,8 +71,13 @@ describe('SignLoanCreditRequest', () => {
         expect(await errorsOf({ contractDetails: DETAILS })).toEqual([]);
     });
 
-    it('rechaza una CLABE que no tiene 18 dígitos', async () => {
+    it('acepta la CLABE tal como la tiene la cuenta, aunque no sean 18 dígitos', async () => {
         const details = { ...DETAILS, pcfAccount: { clabe: 'dummy' } };
+        expect(await errorsOf({ contractDetails: details })).toEqual([]);
+    });
+
+    it('rechaza una CLABE vacía', async () => {
+        const details = { ...DETAILS, pcfAccount: { clabe: '' } };
         expect(await errorsOf({ contractDetails: details })).toEqual(['contractDetails.pcfAccount.clabe']);
     });
 

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

@@ -31,6 +31,7 @@ export declare class LoanContractProviderDetails {
 }
 /** Cuenta Pago Confiado del acreditado, de la que se cobra el crédito (Secciones VI y VIII). */
 export declare class LoanContractPcfAccountDetails {
+    /** Tal como la tiene la cuenta; en dev puede no ser una CLABE de 18 dígitos. */
     clabe: string;
 }
 /**

package/bin/loanCredit/dtos/LoanContractDetails.js

@@ -18,8 +18,6 @@ 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 {
 }
@@ -165,7 +163,8 @@ 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' }),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(SHORT_TEXT),
     __metadata("design:type", String)
 ], LoanContractPcfAccountDetails.prototype, "clabe", 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.532.0",
+  "version": "3.534.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/loanCredit/dtos/LoanContractDetails.ts

@@ -7,8 +7,6 @@ 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 {
@@ -133,9 +131,11 @@ export class LoanContractProviderDetails {
 
 /** Cuenta Pago Confiado del acreditado, de la que se cobra el crédito (Secciones VI y VIII). */
 export class LoanContractPcfAccountDetails {
+    /** Tal como la tiene la cuenta; en dev puede no ser una CLABE de 18 dígitos. */
     @Expose()
     @IsString()
-    @Matches(CLABE_PATTERN, { message: 'clabe admite solo 18 dígitos' })
+    @IsNotEmpty()
+    @MaxLength(SHORT_TEXT)
     clabe: string;
 }
 

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';