@fiado/type-kit 3.535.0 → 3.537.0

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/dtos/responses/ActiveSessionByPhoneResponse.d.ts

@@ -1,3 +1,4 @@
+import type { MoneyAtStakeKindEnum } from '../../enums/MoneyAtStakeKindEnum';
 import type { WizardStateEnum } from '../../enums/WizardStateEnum';
 import type { WizardStepEnum } from '../../enums/WizardStepEnum';
 import type { WizardBlockedSummary } from '../WizardBlocked';
@@ -32,4 +33,8 @@ export interface ActiveSessionByPhoneResponse {
     exactUntil?: string | null;
     /** La venta movió dinero u originó crédito: siempre se retoma la misma. */
     moneyAtStake?: boolean;
+    /** Qué dinero retiene: SALE (folio, cobro o venta) o CREDIT_QUOTED (solo crédito cotizado); `null` = ninguno. */
+    moneyAtStakeKind?: MoneyAtStakeKindEnum | null;
+    /** Venta solo de contado (el cliente tiene una venta con dinero en otra sucursal). */
+    cashOnly?: boolean;
 }

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

@@ -0,0 +1,7 @@
+/** Resultado de cancelar la venta de otra sucursal que retenía al cliente. SureKeep — pista Retail. */
+export interface CancelOtherStoreSaleResponse {
+    /** Venta cancelada. */
+    sessionId: string;
+    /** Enganche cobrado que queda por reembolsar; `null` si no hubo cobro. */
+    refundPendingCents: number | null;
+}

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

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

package/bin/retailWizard/enums/MoneyAtStakeKindEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Qué dinero retiene la venta, para el texto de la ficha.
+ * SALE: hay folio, cobro o venta cerrada.
+ * CREDIT_QUOTED: solo hay un crédito cotizado (sin cobro).
+ */
+export declare enum MoneyAtStakeKindEnum {
+    SALE = "SALE",
+    CREDIT_QUOTED = "CREDIT_QUOTED"
+}

package/bin/retailWizard/enums/MoneyAtStakeKindEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MoneyAtStakeKindEnum = void 0;
+/**
+ * Qué dinero retiene la venta, para el texto de la ficha.
+ * SALE: hay folio, cobro o venta cerrada.
+ * CREDIT_QUOTED: solo hay un crédito cotizado (sin cobro).
+ */
+var MoneyAtStakeKindEnum;
+(function (MoneyAtStakeKindEnum) {
+    MoneyAtStakeKindEnum["SALE"] = "SALE";
+    MoneyAtStakeKindEnum["CREDIT_QUOTED"] = "CREDIT_QUOTED";
+})(MoneyAtStakeKindEnum || (exports.MoneyAtStakeKindEnum = MoneyAtStakeKindEnum = {}));

package/bin/retailWizard/enums/SystemCancelReasonEnum.d.ts

@@ -1,4 +1,9 @@
-/** `cancelReason` que escribe el sistema (no el vendedor). La saga cierra la venta cuyo crédito se descartó. */
+/**
+ * `cancelReason` que escribe el sistema (no el vendedor).
+ * SWEEP_CREDIT_DISCARDED: la saga cierra la venta cuyo crédito se descartó.
+ * TAKEN_OVER_BY_OTHER_STORE: otra tienda tomó al cliente y la venta no tenía dinero en juego.
+ */
 export declare enum SystemCancelReasonEnum {
-    SWEEP_CREDIT_DISCARDED = "SWEEP_CREDIT_DISCARDED"
+    SWEEP_CREDIT_DISCARDED = "SWEEP_CREDIT_DISCARDED",
+    TAKEN_OVER_BY_OTHER_STORE = "TAKEN_OVER_BY_OTHER_STORE"
 }

package/bin/retailWizard/enums/SystemCancelReasonEnum.js

@@ -1,8 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SystemCancelReasonEnum = void 0;
-/** `cancelReason` que escribe el sistema (no el vendedor). La saga cierra la venta cuyo crédito se descartó. */
+/**
+ * `cancelReason` que escribe el sistema (no el vendedor).
+ * SWEEP_CREDIT_DISCARDED: la saga cierra la venta cuyo crédito se descartó.
+ * TAKEN_OVER_BY_OTHER_STORE: otra tienda tomó al cliente y la venta no tenía dinero en juego.
+ */
 var SystemCancelReasonEnum;
 (function (SystemCancelReasonEnum) {
     SystemCancelReasonEnum["SWEEP_CREDIT_DISCARDED"] = "SWEEP_CREDIT_DISCARDED";
+    SystemCancelReasonEnum["TAKEN_OVER_BY_OTHER_STORE"] = "TAKEN_OVER_BY_OTHER_STORE";
 })(SystemCancelReasonEnum || (exports.SystemCancelReasonEnum = SystemCancelReasonEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -19,6 +19,7 @@ export * from './enums/AccountStepStatusEnum';
 export * from './enums/ResumeReasonEnum';
 export * from './enums/ProspectResumeModeEnum';
 export * from './enums/SystemCancelReasonEnum';
+export * from './enums/MoneyAtStakeKindEnum';
 export * from './enums/AppOnboardingStepEnum';
 export * from './enums/AppOnboardingStepStatusEnum';
 export * from './enums/BlockedReasonEnum';
@@ -58,6 +59,7 @@ export * from './dtos/Prospect';
 export * from './dtos/PaginatedResult';
 export * from './dtos/requests/StartSessionRequest';
 export * from './dtos/requests/CancelSessionRequest';
+export * from './dtos/requests/CancelOtherStoreSaleRequest';
 export * from './dtos/requests/VerifyOtpRequest';
 export * from './dtos/requests/ResendOtpRequest';
 export * from './dtos/requests/SkipOtpRequest';
@@ -89,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';
@@ -109,6 +112,7 @@ export * from './dtos/responses/RegisterDeviceResponse';
 export * from './dtos/responses/AccountStatusResponse';
 export * from './dtos/responses/ActiveSessionByPhoneResponse';
 export * from './dtos/responses/ProspectResumeResponse';
+export * from './dtos/responses/CancelOtherStoreSaleResponse';
 export * from './dtos/responses/ProspectByPhoneResponse';
 export * from './dtos/responses/AppOnboardingResponse';
 export * from './enums/SaleFinancierEnum';

package/bin/retailWizard/index.js

@@ -38,6 +38,7 @@ __exportStar(require("./enums/AccountStepStatusEnum"), exports);
 __exportStar(require("./enums/ResumeReasonEnum"), exports);
 __exportStar(require("./enums/ProspectResumeModeEnum"), exports);
 __exportStar(require("./enums/SystemCancelReasonEnum"), exports);
+__exportStar(require("./enums/MoneyAtStakeKindEnum"), exports);
 __exportStar(require("./enums/AppOnboardingStepEnum"), exports);
 __exportStar(require("./enums/AppOnboardingStepStatusEnum"), exports);
 __exportStar(require("./enums/BlockedReasonEnum"), exports);
@@ -83,6 +84,7 @@ __exportStar(require("./dtos/PaginatedResult"), exports);
 // Request DTOs (input validado por endpoint)
 __exportStar(require("./dtos/requests/StartSessionRequest"), exports);
 __exportStar(require("./dtos/requests/CancelSessionRequest"), exports);
+__exportStar(require("./dtos/requests/CancelOtherStoreSaleRequest"), exports);
 __exportStar(require("./dtos/requests/VerifyOtpRequest"), exports);
 __exportStar(require("./dtos/requests/ResendOtpRequest"), exports);
 __exportStar(require("./dtos/requests/SkipOtpRequest"), exports);
@@ -114,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);
@@ -135,6 +138,7 @@ __exportStar(require("./dtos/responses/RegisterDeviceResponse"), exports);
 __exportStar(require("./dtos/responses/AccountStatusResponse"), exports);
 __exportStar(require("./dtos/responses/ActiveSessionByPhoneResponse"), exports);
 __exportStar(require("./dtos/responses/ProspectResumeResponse"), exports);
+__exportStar(require("./dtos/responses/CancelOtherStoreSaleResponse"), exports);
 __exportStar(require("./dtos/responses/ProspectByPhoneResponse"), exports);
 __exportStar(require("./dtos/responses/AppOnboardingResponse"), exports);
 // ── F3 · Backoffice VentasLuga ────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.535.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/WizardSession.ts

@@ -155,6 +155,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/src/retailWizard/dtos/requests/CancelOtherStoreSaleRequest.ts

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { IsString, MaxLength, MinLength } from '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.
+ */
+export class CancelOtherStoreSaleRequest {
+    /** Teléfono del cliente: la venta ajena no se expone, así que es la única llave. */
+    @Expose()
+    @IsString()
+    @MaxLength(20)
+    phone!: string;
+
+    @Expose()
+    @IsString()
+    @MinLength(10)
+    @MaxLength(200)
+    reason!: string;
+}

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/dtos/responses/ActiveSessionByPhoneResponse.ts

@@ -1,3 +1,4 @@
+import type { MoneyAtStakeKindEnum } from '../../enums/MoneyAtStakeKindEnum';
 import type { WizardStateEnum } from '../../enums/WizardStateEnum';
 import type { WizardStepEnum } from '../../enums/WizardStepEnum';
 import type { WizardBlockedSummary } from '../WizardBlocked';
@@ -33,4 +34,8 @@ export interface ActiveSessionByPhoneResponse {
     exactUntil?: string | null;
     /** La venta movió dinero u originó crédito: siempre se retoma la misma. */
     moneyAtStake?: boolean;
+    /** Qué dinero retiene: SALE (folio, cobro o venta) o CREDIT_QUOTED (solo crédito cotizado); `null` = ninguno. */
+    moneyAtStakeKind?: MoneyAtStakeKindEnum | null;
+    /** Venta solo de contado (el cliente tiene una venta con dinero en otra sucursal). */
+    cashOnly?: boolean;
 }

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

@@ -0,0 +1,7 @@
+/** Resultado de cancelar la venta de otra sucursal que retenía al cliente. SureKeep — pista Retail. */
+export interface CancelOtherStoreSaleResponse {
+    /** Venta cancelada. */
+    sessionId: string;
+    /** Enganche cobrado que queda por reembolsar; `null` si no hubo cobro. */
+    refundPendingCents: number | null;
+}

package/src/retailWizard/enums/MoneyAtStakeKindEnum.ts

@@ -0,0 +1,9 @@
+/**
+ * Qué dinero retiene la venta, para el texto de la ficha.
+ * SALE: hay folio, cobro o venta cerrada.
+ * CREDIT_QUOTED: solo hay un crédito cotizado (sin cobro).
+ */
+export enum MoneyAtStakeKindEnum {
+    SALE = 'SALE',
+    CREDIT_QUOTED = 'CREDIT_QUOTED',
+}

package/src/retailWizard/enums/SystemCancelReasonEnum.ts

@@ -1,4 +1,9 @@
-/** `cancelReason` que escribe el sistema (no el vendedor). La saga cierra la venta cuyo crédito se descartó. */
+/**
+ * `cancelReason` que escribe el sistema (no el vendedor).
+ * SWEEP_CREDIT_DISCARDED: la saga cierra la venta cuyo crédito se descartó.
+ * TAKEN_OVER_BY_OTHER_STORE: otra tienda tomó al cliente y la venta no tenía dinero en juego.
+ */
 export enum SystemCancelReasonEnum {
     SWEEP_CREDIT_DISCARDED = 'SWEEP_CREDIT_DISCARDED',
+    TAKEN_OVER_BY_OTHER_STORE = 'TAKEN_OVER_BY_OTHER_STORE',
 }

package/src/retailWizard/index.ts

@@ -22,6 +22,7 @@ export * from './enums/AccountStepStatusEnum';
 export * from './enums/ResumeReasonEnum';
 export * from './enums/ProspectResumeModeEnum';
 export * from './enums/SystemCancelReasonEnum';
+export * from './enums/MoneyAtStakeKindEnum';
 export * from './enums/AppOnboardingStepEnum';
 export * from './enums/AppOnboardingStepStatusEnum';
 export * from './enums/BlockedReasonEnum';
@@ -69,6 +70,7 @@ export * from './dtos/PaginatedResult';
 // Request DTOs (input validado por endpoint)
 export * from './dtos/requests/StartSessionRequest';
 export * from './dtos/requests/CancelSessionRequest';
+export * from './dtos/requests/CancelOtherStoreSaleRequest';
 export * from './dtos/requests/VerifyOtpRequest';
 export * from './dtos/requests/ResendOtpRequest';
 export * from './dtos/requests/SkipOtpRequest';
@@ -100,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';
@@ -122,6 +125,7 @@ export * from './dtos/responses/RegisterDeviceResponse';
 export * from './dtos/responses/AccountStatusResponse';
 export * from './dtos/responses/ActiveSessionByPhoneResponse';
 export * from './dtos/responses/ProspectResumeResponse';
+export * from './dtos/responses/CancelOtherStoreSaleResponse';
 export * from './dtos/responses/ProspectByPhoneResponse';
 export * from './dtos/responses/AppOnboardingResponse';