@fiado/type-kit 3.536.0 → 3.537.0

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

@@ -16,12 +16,13 @@ import {
 const sortedValues = (enumObject: Record<string, string>) => Object.values(enumObject).sort();
 
 describe('ContractTypeEnum', () => {
-    it('suma los documentos del ciclo de vida a los tres de la originación', () => {
+    it('suma la constancia de firma y los documentos del ciclo de vida a los tres de la originación', () => {
         expect(sortedValues(ContractTypeEnum)).toEqual(
             [
                 'CREDIT',
                 'PROMISSORY_NOTE',
                 'SIC_AUTHORIZATION',
+                'SIGNATURE_EVIDENCE',
                 'RESTRUCTURE_ADDENDUM',
                 'ADVANCE_AUTHORIZATION',
                 'SETTLEMENT_CERTIFICATE',

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

@@ -86,3 +86,40 @@ describe('SignLoanCreditRequest', () => {
         expect(await errorsOf({ contractDetails: details })).toEqual(['contractDetails.provider.legalName']);
     });
 });
+
+const CONTEXT = {
+    ip: '201.141.10.20',
+    userAgent: 'Mozilla/5.0',
+    termsAccepted: true,
+    sellerId: 'ru-1',
+    sellerActorId: 'sub-1',
+    sellerName: 'Ana López',
+    storeId: 'st-1',
+    storeName: 'Tienda Centro',
+    wizardSessionId: 'WZ-1',
+};
+
+describe('SignLoanCreditRequest.signatureContext', () => {
+    it('acepta el contexto completo', async () => {
+        expect(await errorsOf({ signatureContext: CONTEXT })).toEqual([]);
+    });
+
+    it('acepta el contexto sin nombres ni navegador', async () => {
+        const minimal = { ip: CONTEXT.ip, sellerId: 'ru-1', sellerActorId: 'sub-1', storeId: 'st-1', wizardSessionId: 'WZ-1' };
+        expect(await errorsOf({ signatureContext: minimal })).toEqual([]);
+    });
+
+    it('exige ip, vendedor, tienda y sesión', async () => {
+        expect(await errorsOf({ signatureContext: {} })).toEqual([
+            'signatureContext.ip',
+            'signatureContext.sellerActorId',
+            'signatureContext.sellerId',
+            'signatureContext.storeId',
+            'signatureContext.wizardSessionId',
+        ]);
+    });
+
+    it('rechaza una aceptación que no es booleana', async () => {
+        expect(await errorsOf({ signatureContext: { ...CONTEXT, termsAccepted: 'si' } })).toEqual(['signatureContext.termsAccepted']);
+    });
+});

package/_test_/unit/messagesConnector/otpBinding.test.ts

@@ -0,0 +1,43 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { SendMessageRequest, VerifyOtpRequest } from '../../../src/messagesConnector/index';
+import { DeliveryChannelEnum } from '../../../src/messaging';
+
+const HASH = 'a'.repeat(64);
+const SEND = {
+    channelType: DeliveryChannelEnum.SMS,
+    messageType: 'CONTRACT_SIGNATURE_OTP',
+    directoryId: 'd1',
+    typeOfDirectory: 'USER',
+    language: 'es',
+    country: 'MX',
+    destination: '+525512345678',
+    transactionNumber: 'c-1',
+};
+const VERIFY = { directoryId: 'd1', typeOfDirectoryId: 'USER', message: '1234' };
+
+const failing = async (cls: new () => object, body: Record<string, unknown>): Promise<string[]> =>
+    (await validate(plainToInstance(cls, body))).map((error) => error.property).sort();
+
+describe('amarre del código de firma', () => {
+    it('SendMessageRequest acepta la huella sha256 del documento', async () => {
+        expect(await failing(SendMessageRequest, { ...SEND, documentHash: HASH })).toEqual([]);
+    });
+
+    it('SendMessageRequest rechaza una huella que no es sha256 en hexadecimal', async () => {
+        expect(await failing(SendMessageRequest, { ...SEND, documentHash: 'ABC' })).toEqual(['documentHash']);
+    });
+
+    it('VerifyOtpRequest acepta el crédito y la huella', async () => {
+        expect(await failing(VerifyOtpRequest, { ...VERIFY, transactionNumber: 'c-1', documentHash: HASH })).toEqual([]);
+    });
+
+    it('VerifyOtpRequest sigue aceptando la verificación sin amarre', async () => {
+        expect(await failing(VerifyOtpRequest, VERIFY)).toEqual([]);
+    });
+
+    it('VerifyOtpRequest rechaza una huella inválida', async () => {
+        expect(await failing(VerifyOtpRequest, { ...VERIFY, documentHash: 'x' })).toEqual(['documentHash']);
+    });
+});

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

@@ -0,0 +1,25 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { SignatureSendOtpRequest } from '../../../src/retailWizard/index';
+
+const failing = async (body: Record<string, unknown>): Promise<string[]> =>
+    (await validate(plainToInstance(SignatureSendOtpRequest, body))).map((error) => error.property);
+
+describe('SignatureSendOtpRequest', () => {
+    it('acepta la aceptación de los términos', async () => {
+        expect(await failing({ termsAccepted: true })).toEqual([]);
+    });
+
+    it('rechaza el envío sin aceptación', async () => {
+        expect(await failing({})).toEqual(['termsAccepted']);
+    });
+
+    it('rechaza termsAccepted en false', async () => {
+        expect(await failing({ termsAccepted: false })).toEqual(['termsAccepted']);
+    });
+
+    it('rechaza "true" como texto', async () => {
+        expect(await failing({ termsAccepted: 'true' })).toEqual(['termsAccepted']);
+    });
+});

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

@@ -1,7 +1,9 @@
 import { ContractTypeEnum } from '../enums/ContractTypeEnum';
+import type { LoanContractSignatureEvidence } from './LoanContractSignatureEvidence';
 /**
  * LoanContract — documento del contrato de crédito con firma FES (modelo-datos §5b ·
- * `<T>LoanContract_GT` · M2 §4.3-§4.4). Un registro por documento (3 por crédito — C4).
+ * `<T>LoanContract_GT` · M2 §4.3-§4.4). Un registro por documento: los 3 de la originación (C4), más la
+ * constancia de firma al firmar.
  *
  * Nace DRAFT en la originación (sin PDF); la firma FES genera el PDF, calcula su `sha256`,
  * verifica el OTP y sella con NOM-151. Conservación documental: 10 años (NOM-151).
@@ -22,6 +24,8 @@ export declare class LoanContract {
     /** Sello de tiempo NOM-151 (TSA). Ausente hasta firmar (AS del TSA connector). */
     nom151Timestamp?: string;
     signedAt?: string;
+    /** Evidencia de la firma con código (solo en documentos firmados). */
+    signatureEvidence?: LoanContractSignatureEvidence;
     createdBy: string;
     updatedBy: string;
     createdAt: string;

package/bin/loanCredit/dtos/LoanContract.js

@@ -16,7 +16,8 @@ const regex_1 = require("../../helpers/constans/regex");
 const ContractTypeEnum_1 = require("../enums/ContractTypeEnum");
 /**
  * LoanContract — documento del contrato de crédito con firma FES (modelo-datos §5b ·
- * `<T>LoanContract_GT` · M2 §4.3-§4.4). Un registro por documento (3 por crédito — C4).
+ * `<T>LoanContract_GT` · M2 §4.3-§4.4). Un registro por documento: los 3 de la originación (C4), más la
+ * constancia de firma al firmar.
  *
  * Nace DRAFT en la originación (sin PDF); la firma FES genera el PDF, calcula su `sha256`,
  * verifica el OTP y sella con NOM-151. Conservación documental: 10 años (NOM-151).
@@ -75,6 +76,12 @@ __decorate([
     (0, class_validator_1.Matches)(regex_1.regexIso8601),
     __metadata("design:type", String)
 ], LoanContract.prototype, "signedAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], LoanContract.prototype, "signatureEvidence", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

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

@@ -0,0 +1,45 @@
+/** El código de firma tal como lo validó messages-business. */
+export interface SignatureEvidenceOtp {
+    /** Id del envío en messages-business (fila del log del código). */
+    messageLogId: string;
+    sentAt: string;
+    verifiedAt: string;
+    channel: 'SMS';
+    /** Teléfono destino enmascarado (`****1234`). */
+    destinationMasked?: string;
+}
+/** Envíos del código (con reenvíos) y validaciones fallidas antes de firmar. */
+export interface SignatureEvidenceAttempts {
+    sends: number;
+    failedVerifications: number;
+}
+/** Aceptación de términos del tiempo 1, amarrada a la huella del contrato generado en esa llamada. */
+export interface SignatureEvidenceAcceptance {
+    acceptedAt: string;
+    contractSha256: string;
+    ip: string;
+    userAgent?: string;
+}
+/** Desde dónde y quién envió el código al firmar (tiempo 2). */
+export interface SignatureEvidenceSigning {
+    ip: string;
+    userAgent?: string;
+    sellerActorId: string;
+}
+/** Quién facilitó la firma en la tienda. */
+export interface SignatureEvidenceFacilitator {
+    sellerId: string;
+    sellerActorId: string;
+    sellerName?: string;
+    storeId: string;
+    storeName?: string;
+    wizardSessionId: string;
+}
+/** Evidencia de la firma con código que queda en cada documento firmado. */
+export interface LoanContractSignatureEvidence {
+    otp: SignatureEvidenceOtp;
+    attempts: SignatureEvidenceAttempts;
+    acceptance: SignatureEvidenceAcceptance;
+    signing: SignatureEvidenceSigning;
+    facilitator: SignatureEvidenceFacilitator;
+}

package/bin/loanCredit/dtos/LoanContractSignatureEvidence.js

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

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

@@ -0,0 +1,20 @@
+/**
+ * Contexto de la firma que aporta el wizard en cada tiempo de `POST /private/credits/:creditId/sign`:
+ * quién facilita la firma (vendedor, tienda, sesión) y desde qué navegador. Es evidencia de la
+ * ceremonia: la IP y el navegador son del equipo de la tienda. Nunca se loguean.
+ */
+export declare class SignatureContext {
+    /** IP de origen de la llamada, como la ve el API Gateway del wizard. */
+    ip: string;
+    userAgent?: string;
+    /** Tiempo 1: el cliente marcó "Acepto los términos". El motor exige `true` para mandar el código. */
+    termsAccepted?: boolean;
+    /** Usuario retail del vendedor. */
+    sellerId: string;
+    /** Cognito sub del vendedor: queda como actor de la firma. */
+    sellerActorId: string;
+    sellerName?: string;
+    storeId: string;
+    storeName?: string;
+    wizardSessionId: string;
+}

package/bin/loanCredit/dtos/SignatureContext.js

@@ -0,0 +1,92 @@
+"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.SignatureContext = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Largo máximo de un id operacional (vendedor, tienda, sesión). */
+const ID_TEXT = 128;
+/** Largo máximo de un nombre para mostrar. */
+const NAME_TEXT = 300;
+/** Una IPv6 mide 39 caracteres; se deja margen para el formato mapeado. */
+const IP_TEXT = 64;
+/** Los navegadores mandan User-Agent de 150 a 300 caracteres. */
+const USER_AGENT_TEXT = 512;
+/**
+ * Contexto de la firma que aporta el wizard en cada tiempo de `POST /private/credits/:creditId/sign`:
+ * quién facilita la firma (vendedor, tienda, sesión) y desde qué navegador. Es evidencia de la
+ * ceremonia: la IP y el navegador son del equipo de la tienda. Nunca se loguean.
+ */
+class SignatureContext {
+}
+exports.SignatureContext = SignatureContext;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(IP_TEXT),
+    __metadata("design:type", String)
+], SignatureContext.prototype, "ip", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(USER_AGENT_TEXT),
+    __metadata("design:type", String)
+], SignatureContext.prototype, "userAgent", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], SignatureContext.prototype, "termsAccepted", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(ID_TEXT),
+    __metadata("design:type", String)
+], SignatureContext.prototype, "sellerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(ID_TEXT),
+    __metadata("design:type", String)
+], SignatureContext.prototype, "sellerActorId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(NAME_TEXT),
+    __metadata("design:type", String)
+], SignatureContext.prototype, "sellerName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(ID_TEXT),
+    __metadata("design:type", String)
+], SignatureContext.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(NAME_TEXT),
+    __metadata("design:type", String)
+], SignatureContext.prototype, "storeName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(ID_TEXT),
+    __metadata("design:type", String)
+], SignatureContext.prototype, "wizardSessionId", void 0);

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

@@ -1,4 +1,5 @@
 import { LoanContractDetails } from '../LoanContractDetails';
+import { SignatureContext } from '../SignatureContext';
 /**
  * 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:
@@ -40,4 +41,9 @@ export declare class SignLoanCreditRequest {
      * PII-zero — el teléfono vive en RetailCustomer).
      */
     otpDestination?: string;
+    /**
+     * Ambos tiempos: quién facilita la firma y desde qué navegador (evidencia de la ceremonia). En el
+     * tiempo 1 trae `termsAccepted: true`. El motor lo exige; la IP y el navegador nunca se loguean.
+     */
+    signatureContext?: SignatureContext;
 }

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

@@ -13,6 +13,7 @@ exports.SignLoanCreditRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const LoanContractDetails_1 = require("../LoanContractDetails");
+const SignatureContext_1 = require("../SignatureContext");
 /**
  * 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:
@@ -61,3 +62,10 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], SignLoanCreditRequest.prototype, "otpDestination", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => SignatureContext_1.SignatureContext),
+    __metadata("design:type", SignatureContext_1.SignatureContext)
+], SignLoanCreditRequest.prototype, "signatureContext", void 0);

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

@@ -1,4 +1,5 @@
 import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+import type { LoanContractSignatureEvidence } from '../LoanContractSignatureEvidence';
 /**
  * Response de un documento del contrato (loan-credit-business). `signedAt` ausente = draft.
  */
@@ -12,6 +13,8 @@ export interface LoanContractResponse {
     otpVerified: boolean;
     nom151Timestamp?: string;
     signedAt?: string;
+    /** Evidencia de la firma con código (solo en documentos firmados). */
+    signatureEvidence?: LoanContractSignatureEvidence;
     createdAt: string;
     updatedAt: string;
 }

package/bin/loanCredit/enums/ContractTypeEnum.d.ts

@@ -6,6 +6,8 @@ export declare enum ContractTypeEnum {
     CREDIT = "CREDIT",
     PROMISSORY_NOTE = "PROMISSORY_NOTE",
     SIC_AUTHORIZATION = "SIC_AUTHORIZATION",
+    /** Constancia de firma electrónica: la evidencia de la firma con código, en PDF. */
+    SIGNATURE_EVIDENCE = "SIGNATURE_EVIDENCE",
     RESTRUCTURE_ADDENDUM = "RESTRUCTURE_ADDENDUM",
     ADVANCE_AUTHORIZATION = "ADVANCE_AUTHORIZATION",
     SETTLEMENT_CERTIFICATE = "SETTLEMENT_CERTIFICATE",

package/bin/loanCredit/enums/ContractTypeEnum.js

@@ -10,6 +10,8 @@ var ContractTypeEnum;
     ContractTypeEnum["CREDIT"] = "CREDIT";
     ContractTypeEnum["PROMISSORY_NOTE"] = "PROMISSORY_NOTE";
     ContractTypeEnum["SIC_AUTHORIZATION"] = "SIC_AUTHORIZATION";
+    /** Constancia de firma electrónica: la evidencia de la firma con código, en PDF. */
+    ContractTypeEnum["SIGNATURE_EVIDENCE"] = "SIGNATURE_EVIDENCE";
     ContractTypeEnum["RESTRUCTURE_ADDENDUM"] = "RESTRUCTURE_ADDENDUM";
     ContractTypeEnum["ADVANCE_AUTHORIZATION"] = "ADVANCE_AUTHORIZATION";
     ContractTypeEnum["SETTLEMENT_CERTIFICATE"] = "SETTLEMENT_CERTIFICATE";

package/bin/loanCredit/index.d.ts

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

package/bin/loanCredit/index.js

@@ -30,6 +30,8 @@ __exportStar(require("./dtos/LoanInstallment"), exports);
 __exportStar(require("./dtos/InstallmentPaidEvent"), exports);
 __exportStar(require("./dtos/LoanContract"), exports);
 __exportStar(require("./dtos/LoanContractDetails"), exports);
+__exportStar(require("./dtos/SignatureContext"), exports);
+__exportStar(require("./dtos/LoanContractSignatureEvidence"), exports);
 __exportStar(require("./dtos/ActivationChecklist"), exports);
 __exportStar(require("./dtos/AppliedPromotionSnapshot"), exports);
 __exportStar(require("./dtos/AppliedStorePolicySnapshot"), exports);

package/bin/messagesConnector/constants/OtpBinding.d.ts

@@ -0,0 +1,2 @@
+/** Huella SHA-256 en hexadecimal, tal como la calcula pdf-render sobre el PDF. */
+export declare const OTP_DOCUMENT_HASH_PATTERN: RegExp;

package/bin/messagesConnector/constants/OtpBinding.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OTP_DOCUMENT_HASH_PATTERN = void 0;
+/** Huella SHA-256 en hexadecimal, tal como la calcula pdf-render sobre el PDF. */
+exports.OTP_DOCUMENT_HASH_PATTERN = /^[a-f0-9]{64}$/;

package/bin/messagesConnector/dtos/SendMessageRequest.d.ts

@@ -18,6 +18,7 @@ export declare class SendMessageRequest {
     options?: Record<string, unknown>;
     referenceMessageId?: string;
     transactionNumber?: string;
+    documentHash?: string;
     purpose?: OtpMessagePurposeEnum;
     tenantId?: string;
 }

package/bin/messagesConnector/dtos/SendMessageRequest.js

@@ -13,6 +13,7 @@ exports.SendMessageRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const messaging_1 = require("../../messaging");
+const OtpBinding_1 = require("../constants/OtpBinding");
 const OtpMessagePurposeEnum_1 = require("../enums/OtpMessagePurposeEnum");
 class SendMessageRequest {
 }
@@ -118,6 +119,12 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], SendMessageRequest.prototype, "transactionNumber", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Matches)(OtpBinding_1.OTP_DOCUMENT_HASH_PATTERN),
+    __metadata("design:type", String)
+], SendMessageRequest.prototype, "documentHash", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/messagesConnector/dtos/VerifyOtpRequest.d.ts

@@ -4,4 +4,6 @@ export declare class VerifyOtpRequest {
     typeOfDirectoryId: string;
     message: string;
     purpose?: OtpMessagePurposeEnum;
+    transactionNumber?: string;
+    documentHash?: string;
 }

package/bin/messagesConnector/dtos/VerifyOtpRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VerifyOtpRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const OtpBinding_1 = require("../constants/OtpBinding");
 const OtpMessagePurposeEnum_1 = require("../enums/OtpMessagePurposeEnum");
 class VerifyOtpRequest {
 }
@@ -40,3 +41,16 @@ __decorate([
     (0, class_validator_1.IsEnum)(OtpMessagePurposeEnum_1.OtpMessagePurposeEnum),
     __metadata("design:type", String)
 ], VerifyOtpRequest.prototype, "purpose", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], VerifyOtpRequest.prototype, "transactionNumber", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Matches)(OtpBinding_1.OTP_DOCUMENT_HASH_PATTERN),
+    __metadata("design:type", String)
+], VerifyOtpRequest.prototype, "documentHash", void 0);

package/bin/messagesConnector/dtos/VerifyOtpResponse.d.ts

@@ -2,4 +2,10 @@ export declare class VerifyOtpResponse {
     verified: boolean;
     directoryId: string;
     typeOfDirectoryId: string;
+    /** Id del envío (fila del log) que se validó. */
+    logId?: string;
+    /** Cuándo se mandó el código (ISO 8601). */
+    sentAt?: string;
+    /** Cuándo se validó (ISO 8601). */
+    verifiedAt?: string;
 }

package/bin/messagesConnector/index.d.ts

@@ -2,6 +2,7 @@ export * from './enums/DeliveryChannelExtendedEnum';
 export * from './enums/NotificationOriginEnum';
 export * from './enums/MessagingSlotEnum';
 export * from './enums/OtpMessagePurposeEnum';
+export * from './constants/OtpBinding';
 export * from './validators/IsStringValueRecord';
 export * from './dtos/NotificationQueueMessageRequestV2';
 export * from './dtos/SendMessageRequest';

package/bin/messagesConnector/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./enums/DeliveryChannelExtendedEnum"), exports);
 __exportStar(require("./enums/NotificationOriginEnum"), exports);
 __exportStar(require("./enums/MessagingSlotEnum"), exports);
 __exportStar(require("./enums/OtpMessagePurposeEnum"), exports);
+__exportStar(require("./constants/OtpBinding"), exports);
 __exportStar(require("./validators/IsStringValueRecord"), exports);
 __exportStar(require("./dtos/NotificationQueueMessageRequestV2"), exports);
 __exportStar(require("./dtos/SendMessageRequest"), exports);

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

@@ -0,0 +1,7 @@
+/**
+ * POST /wizard/sessions/:id/signature/send-otp — firma FES tiempo 1 (paso 08). El cliente marcó
+ * "Acepto los términos del contrato de crédito": sin esa aceptación el wizard no manda el código.
+ */
+export declare class SignatureSendOtpRequest {
+    termsAccepted: true;
+}

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

@@ -0,0 +1,26 @@
+"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.SignatureSendOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * POST /wizard/sessions/:id/signature/send-otp — firma FES tiempo 1 (paso 08). El cliente marcó
+ * "Acepto los términos del contrato de crédito": sin esa aceptación el wizard no manda el código.
+ */
+class SignatureSendOtpRequest {
+}
+exports.SignatureSendOtpRequest = SignatureSendOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Equals)(true, { message: 'termsAccepted debe ser true: el cliente tiene que aceptar los términos' }),
+    __metadata("design:type", Boolean)
+], SignatureSendOtpRequest.prototype, "termsAccepted", void 0);

package/bin/retailWizard/index.d.ts

@@ -91,6 +91,7 @@ export * from './dtos/requests/CancelSaleRequest';
 export * from './dtos/requests/QuoteRequest';
 export * from './dtos/requests/DownPaymentRequest';
 export * from './dtos/requests/SignatureSignRequest';
+export * from './dtos/requests/SignatureSendOtpRequest';
 export * from './dtos/requests/RegisterDeviceRequest';
 export * from './dtos/requests/CompleteSaleRequest';
 export * from './dtos/requests/SuggestIdentifiersQuery';

package/bin/retailWizard/index.js

@@ -116,6 +116,7 @@ __exportStar(require("./dtos/requests/CancelSaleRequest"), exports);
 __exportStar(require("./dtos/requests/QuoteRequest"), exports);
 __exportStar(require("./dtos/requests/DownPaymentRequest"), exports);
 __exportStar(require("./dtos/requests/SignatureSignRequest"), exports);
+__exportStar(require("./dtos/requests/SignatureSendOtpRequest"), exports);
 __exportStar(require("./dtos/requests/RegisterDeviceRequest"), exports);
 __exportStar(require("./dtos/requests/CompleteSaleRequest"), exports);
 __exportStar(require("./dtos/requests/SuggestIdentifiersQuery"), exports);

package/package.json

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

package/src/loanCredit/dtos/LoanContract.ts

@@ -1,11 +1,13 @@
 import { Expose } from 'class-transformer';
-import { IsBoolean, IsEnum, IsOptional, IsString, Matches } from 'class-validator';
+import { IsBoolean, IsEnum, IsObject, IsOptional, IsString, Matches } from 'class-validator';
 import { regexIso8601 } from '../../helpers/constans/regex';
 import { ContractTypeEnum } from '../enums/ContractTypeEnum';
+import type { LoanContractSignatureEvidence } from './LoanContractSignatureEvidence';
 
 /**
  * LoanContract — documento del contrato de crédito con firma FES (modelo-datos §5b ·
- * `<T>LoanContract_GT` · M2 §4.3-§4.4). Un registro por documento (3 por crédito — C4).
+ * `<T>LoanContract_GT` · M2 §4.3-§4.4). Un registro por documento: los 3 de la originación (C4), más la
+ * constancia de firma al firmar.
  *
  * Nace DRAFT en la originación (sin PDF); la firma FES genera el PDF, calcula su `sha256`,
  * verifica el OTP y sella con NOM-151. Conservación documental: 10 años (NOM-151).
@@ -58,6 +60,12 @@ export class LoanContract {
     @Matches(regexIso8601)
     signedAt?: string;
 
+    /** Evidencia de la firma con código (solo en documentos firmados). */
+    @Expose()
+    @IsOptional()
+    @IsObject()
+    signatureEvidence?: LoanContractSignatureEvidence;
+
     @Expose()
     @IsString()
     createdBy!: string;

package/src/loanCredit/dtos/LoanContractSignatureEvidence.ts

@@ -0,0 +1,50 @@
+/** El código de firma tal como lo validó messages-business. */
+export interface SignatureEvidenceOtp {
+    /** Id del envío en messages-business (fila del log del código). */
+    messageLogId: string;
+    sentAt: string;
+    verifiedAt: string;
+    channel: 'SMS';
+    /** Teléfono destino enmascarado (`****1234`). */
+    destinationMasked?: string;
+}
+
+/** Envíos del código (con reenvíos) y validaciones fallidas antes de firmar. */
+export interface SignatureEvidenceAttempts {
+    sends: number;
+    failedVerifications: number;
+}
+
+/** Aceptación de términos del tiempo 1, amarrada a la huella del contrato generado en esa llamada. */
+export interface SignatureEvidenceAcceptance {
+    acceptedAt: string;
+    contractSha256: string;
+    ip: string;
+    userAgent?: string;
+}
+
+/** Desde dónde y quién envió el código al firmar (tiempo 2). */
+export interface SignatureEvidenceSigning {
+    ip: string;
+    userAgent?: string;
+    sellerActorId: string;
+}
+
+/** Quién facilitó la firma en la tienda. */
+export interface SignatureEvidenceFacilitator {
+    sellerId: string;
+    sellerActorId: string;
+    sellerName?: string;
+    storeId: string;
+    storeName?: string;
+    wizardSessionId: string;
+}
+
+/** Evidencia de la firma con código que queda en cada documento firmado. */
+export interface LoanContractSignatureEvidence {
+    otp: SignatureEvidenceOtp;
+    attempts: SignatureEvidenceAttempts;
+    acceptance: SignatureEvidenceAcceptance;
+    signing: SignatureEvidenceSigning;
+    facilitator: SignatureEvidenceFacilitator;
+}

package/src/loanCredit/dtos/SignatureContext.ts

@@ -0,0 +1,75 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+
+/** Largo máximo de un id operacional (vendedor, tienda, sesión). */
+const ID_TEXT = 128;
+/** Largo máximo de un nombre para mostrar. */
+const NAME_TEXT = 300;
+/** Una IPv6 mide 39 caracteres; se deja margen para el formato mapeado. */
+const IP_TEXT = 64;
+/** Los navegadores mandan User-Agent de 150 a 300 caracteres. */
+const USER_AGENT_TEXT = 512;
+
+/**
+ * Contexto de la firma que aporta el wizard en cada tiempo de `POST /private/credits/:creditId/sign`:
+ * quién facilita la firma (vendedor, tienda, sesión) y desde qué navegador. Es evidencia de la
+ * ceremonia: la IP y el navegador son del equipo de la tienda. Nunca se loguean.
+ */
+export class SignatureContext {
+    /** IP de origen de la llamada, como la ve el API Gateway del wizard. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(IP_TEXT)
+    ip!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(USER_AGENT_TEXT)
+    userAgent?: string;
+
+    /** Tiempo 1: el cliente marcó "Acepto los términos". El motor exige `true` para mandar el código. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    termsAccepted?: boolean;
+
+    /** Usuario retail del vendedor. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(ID_TEXT)
+    sellerId!: string;
+
+    /** Cognito sub del vendedor: queda como actor de la firma. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(ID_TEXT)
+    sellerActorId!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(NAME_TEXT)
+    sellerName?: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(ID_TEXT)
+    storeId!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(NAME_TEXT)
+    storeName?: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(ID_TEXT)
+    wizardSessionId!: string;
+}

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

@@ -1,6 +1,7 @@
 import { Expose, Type } from 'class-transformer';
 import { IsObject, IsOptional, IsString, Length, ValidateNested } from 'class-validator';
 import { LoanContractDetails } from '../LoanContractDetails';
+import { SignatureContext } from '../SignatureContext';
 
 /**
  * Body de `POST /private/credits/:creditId/sign` (loan-credit-business — wizard paso 08, firma FES
@@ -64,4 +65,14 @@ export class SignLoanCreditRequest {
     @IsOptional()
     @IsString()
     otpDestination?: string;
+
+    /**
+     * Ambos tiempos: quién facilita la firma y desde qué navegador (evidencia de la ceremonia). En el
+     * tiempo 1 trae `termsAccepted: true`. El motor lo exige; la IP y el navegador nunca se loguean.
+     */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => SignatureContext)
+    signatureContext?: SignatureContext;
 }

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

@@ -1,4 +1,5 @@
 import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+import type { LoanContractSignatureEvidence } from '../LoanContractSignatureEvidence';
 
 /**
  * Response de un documento del contrato (loan-credit-business). `signedAt` ausente = draft.
@@ -13,6 +14,8 @@ export interface LoanContractResponse {
     otpVerified: boolean;
     nom151Timestamp?: string;
     signedAt?: string;
+    /** Evidencia de la firma con código (solo en documentos firmados). */
+    signatureEvidence?: LoanContractSignatureEvidence;
     createdAt: string;
     updatedAt: string;
 }

package/src/loanCredit/enums/ContractTypeEnum.ts

@@ -6,6 +6,8 @@ export enum ContractTypeEnum {
     CREDIT = 'CREDIT',
     PROMISSORY_NOTE = 'PROMISSORY_NOTE',
     SIC_AUTHORIZATION = 'SIC_AUTHORIZATION',
+    /** Constancia de firma electrónica: la evidencia de la firma con código, en PDF. */
+    SIGNATURE_EVIDENCE = 'SIGNATURE_EVIDENCE',
     RESTRUCTURE_ADDENDUM = 'RESTRUCTURE_ADDENDUM',
     ADVANCE_AUTHORIZATION = 'ADVANCE_AUTHORIZATION',
     SETTLEMENT_CERTIFICATE = 'SETTLEMENT_CERTIFICATE',

package/src/loanCredit/index.ts

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

package/src/messagesConnector/constants/OtpBinding.ts

@@ -0,0 +1,2 @@
+/** Huella SHA-256 en hexadecimal, tal como la calcula pdf-render sobre el PDF. */
+export const OTP_DOCUMENT_HASH_PATTERN = /^[a-f0-9]{64}$/;

package/src/messagesConnector/dtos/SendMessageRequest.ts

@@ -1,6 +1,7 @@
 import { Expose } from 'class-transformer';
-import { IsEnum, IsNotEmpty, IsObject, IsOptional, IsString, IsUUID } from 'class-validator';
+import { IsEnum, IsNotEmpty, IsObject, IsOptional, IsString, IsUUID, Matches } from 'class-validator';
 import { DeliveryChannelEnum } from '../../messaging';
+import { OTP_DOCUMENT_HASH_PATTERN } from '../constants/OtpBinding';
 import { OtpMessagePurposeEnum } from '../enums/OtpMessagePurposeEnum';
 
 export class SendMessageRequest {
@@ -28,6 +29,9 @@ export class SendMessageRequest {
     @Expose() @IsOptional() @IsObject() options?: Record<string, unknown>;
     @Expose() @IsOptional() @IsUUID() referenceMessageId?: string;
     @Expose() @IsOptional() @IsString() transactionNumber?: string;
+    // Huella del documento que firma el código (CONTRACT_SIGNATURE_OTP). Junto con `transactionNumber`
+    // amarra el código a ese documento: messages solo lo valida contra la misma pareja.
+    @Expose() @IsOptional() @Matches(OTP_DOCUMENT_HASH_PATTERN) documentHash?: string;
     @Expose() @IsOptional() @IsEnum(OtpMessagePurposeEnum) purpose?: OtpMessagePurposeEnum;
     // Tenant emisor: decide plantilla e identidad de envío. Sin él messages-business cae a FIADO.
     @Expose() @IsOptional() @IsString() @IsNotEmpty() tenantId?: string;

package/src/messagesConnector/dtos/VerifyOtpRequest.ts

@@ -1,5 +1,6 @@
 import { Expose } from 'class-transformer';
-import { IsEnum, IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { IsEnum, IsNotEmpty, IsOptional, IsString, Matches } from 'class-validator';
+import { OTP_DOCUMENT_HASH_PATTERN } from '../constants/OtpBinding';
 import { OtpMessagePurposeEnum } from '../enums/OtpMessagePurposeEnum';
 
 export class VerifyOtpRequest {
@@ -11,4 +12,7 @@ export class VerifyOtpRequest {
     @Expose() @IsString() @IsNotEmpty() typeOfDirectoryId!: string;
     @Expose() @IsString() @IsNotEmpty() message!: string;
     @Expose() @IsOptional() @IsEnum(OtpMessagePurposeEnum) purpose?: OtpMessagePurposeEnum;
+    // Amarre del código de firma: si vienen, la fila tiene que traer los mismos o el código no sirve.
+    @Expose() @IsOptional() @IsString() @IsNotEmpty() transactionNumber?: string;
+    @Expose() @IsOptional() @Matches(OTP_DOCUMENT_HASH_PATTERN) documentHash?: string;
 }

package/src/messagesConnector/dtos/VerifyOtpResponse.ts

@@ -2,4 +2,10 @@ export class VerifyOtpResponse {
     verified!: boolean;
     directoryId!: string;
     typeOfDirectoryId!: string;
+    /** Id del envío (fila del log) que se validó. */
+    logId?: string;
+    /** Cuándo se mandó el código (ISO 8601). */
+    sentAt?: string;
+    /** Cuándo se validó (ISO 8601). */
+    verifiedAt?: string;
 }

package/src/messagesConnector/index.ts

@@ -2,6 +2,7 @@ export * from './enums/DeliveryChannelExtendedEnum';
 export * from './enums/NotificationOriginEnum';
 export * from './enums/MessagingSlotEnum';
 export * from './enums/OtpMessagePurposeEnum';
+export * from './constants/OtpBinding';
 export * from './validators/IsStringValueRecord';
 export * from './dtos/NotificationQueueMessageRequestV2';
 export * from './dtos/SendMessageRequest';

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

@@ -0,0 +1,12 @@
+import { Expose } from 'class-transformer';
+import { Equals } from 'class-validator';
+
+/**
+ * POST /wizard/sessions/:id/signature/send-otp — firma FES tiempo 1 (paso 08). El cliente marcó
+ * "Acepto los términos del contrato de crédito": sin esa aceptación el wizard no manda el código.
+ */
+export class SignatureSendOtpRequest {
+    @Expose()
+    @Equals(true, { message: 'termsAccepted debe ser true: el cliente tiene que aceptar los términos' })
+    termsAccepted!: true;
+}

package/src/retailWizard/index.ts

@@ -102,6 +102,7 @@ export * from './dtos/requests/CancelSaleRequest';
 export * from './dtos/requests/QuoteRequest';
 export * from './dtos/requests/DownPaymentRequest';
 export * from './dtos/requests/SignatureSignRequest';
+export * from './dtos/requests/SignatureSendOtpRequest';
 export * from './dtos/requests/RegisterDeviceRequest';
 export * from './dtos/requests/CompleteSaleRequest';
 export * from './dtos/requests/SuggestIdentifiersQuery';