@fiado/type-kit 3.535.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/otherStoreSale.test.ts

@@ -0,0 +1,54 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+  CancelOtherStoreSaleRequest,
+  SystemCancelReasonEnum,
+  type ActiveSessionByPhoneResponse,
+  type CancelOtherStoreSaleResponse,
+  type WizardSession,
+} from '../../../src/retailWizard';
+
+async function errorsOf(body: Record<string, unknown>): Promise<string[]> {
+  const errors = await validate(plainToInstance(CancelOtherStoreSaleRequest, body));
+  return errors.map((e) => e.property);
+}
+
+describe('SystemCancelReasonEnum', () => {
+  it('names the cancel when another store takes the customer over', () => {
+    expect(SystemCancelReasonEnum.TAKEN_OVER_BY_OTHER_STORE).toBe('TAKEN_OVER_BY_OTHER_STORE');
+  });
+});
+
+describe('CancelOtherStoreSaleRequest', () => {
+  it('accepts a phone and a reason of at least 10 characters', async () => {
+    expect(await errorsOf({ phone: '5512345678', reason: 'El cliente compra aquí' })).toEqual([]);
+  });
+
+  it('the reason is mandatory and meaningful', async () => {
+    expect(await errorsOf({ phone: '5512345678' })).toContain('reason');
+    expect(await errorsOf({ phone: '5512345678', reason: 'corto' })).toContain('reason');
+  });
+
+  it('the phone is mandatory', async () => {
+    expect(await errorsOf({ reason: 'El cliente compra aquí' })).toContain('phone');
+  });
+});
+
+describe('cash-only sale', () => {
+  it('WizardSession and the sale by phone carry the cash-only mark', () => {
+    const session: Pick<WizardSession, 'cashOnly'> = { cashOnly: true };
+    const byPhone: Pick<ActiveSessionByPhoneResponse, 'cashOnly'> = { cashOnly: true };
+    const cancelled: CancelOtherStoreSaleResponse = { sessionId: 'S1', refundPendingCents: null };
+    expect([session.cashOnly, byPhone.cashOnly, cancelled.sessionId]).toEqual([true, true, 'S1']);
+  });
+});
+
+describe('MoneyAtStakeKindEnum', () => {
+  it('distinguishes a charged or closed sale from a quoted credit', async () => {
+    const { MoneyAtStakeKindEnum } = await import('../../../src/retailWizard');
+    expect(Object.values(MoneyAtStakeKindEnum)).toEqual(['SALE', 'CREDIT_QUOTED']);
+    const byPhone: Pick<ActiveSessionByPhoneResponse, 'moneyAtStakeKind'> = { moneyAtStakeKind: MoneyAtStakeKindEnum.CREDIT_QUOTED };
+    expect(byPhone.moneyAtStakeKind).toBe('CREDIT_QUOTED');
+  });
+});

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/WizardSession.d.ts

@@ -151,6 +151,11 @@ export interface WizardSession {
     /** Prospecto vinculado (si la sesión se reanudó desde un prospecto): se cierra al cerrar la venta (D-prospecto). */
     prospectId: string | null;
     cancelReason: string | null;
+    /**
+     * Venta solo de contado: el cliente tiene una venta con dinero en juego en otra sucursal.
+     * Crédito y derivación se rechazan con `CREDIT_IN_PROGRESS_OTHER_STORE`. Ausente = venta completa.
+     */
+    cashOnly?: boolean;
     /** TTL DDB ~24h de inactividad (D14). */
     ttlEpoch: number;
     createdBy: string;

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

@@ -0,0 +1,9 @@
+/**
+ * POST /wizard/phone-holder/cancel y /backoffice/phone-holder/cancel — el encargado de tienda o el
+ * Admin VL cancela la venta viva de otra sucursal que retiene al cliente. SureKeep — pista Retail.
+ */
+export declare class CancelOtherStoreSaleRequest {
+    /** Teléfono del cliente: la venta ajena no se expone, así que es la única llave. */
+    phone: string;
+    reason: string;
+}

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

@@ -0,0 +1,34 @@
+"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.CancelOtherStoreSaleRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * POST /wizard/phone-holder/cancel y /backoffice/phone-holder/cancel — el encargado de tienda o el
+ * Admin VL cancela la venta viva de otra sucursal que retiene al cliente. SureKeep — pista Retail.
+ */
+class CancelOtherStoreSaleRequest {
+}
+exports.CancelOtherStoreSaleRequest = CancelOtherStoreSaleRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(20),
+    __metadata("design:type", String)
+], CancelOtherStoreSaleRequest.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(10),
+    (0, class_validator_1.MaxLength)(200),
+    __metadata("design:type", String)
+], CancelOtherStoreSaleRequest.prototype, "reason", void 0);