@fiado/type-kit 3.322.0 → 3.324.0

package/bin/helpdesk/dtos/ZendeskInternalAlertRequest.d.ts

@@ -1,3 +1,4 @@
+import { AlertClassification } from "../enums/AlertClassificationEnum";
 import { InternalAlertChannel } from "../enums/InternalAlertChannelEnum";
 /**
  * Alerta interna sobre un usuario. Se publica en la cola de alertamiento y zendesk-business
@@ -21,4 +22,9 @@ export declare class ZendeskInternalAlertRequest {
     channels: InternalAlertChannel[];
     /** Id del evento origen, para rastrear la alerta de vuelta. */
     reference?: string;
+    /**
+     * Clasificación explícita del usuario. Si viene, zendesk-business la usa tal cual en el asunto;
+     * si no, la calcula a partir del scope del directorio.
+     */
+    classification?: AlertClassification;
 }

package/bin/helpdesk/dtos/ZendeskInternalAlertRequest.js

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZendeskInternalAlertRequest = void 0;
 const class_validator_1 = require("class-validator");
+const AlertClassificationEnum_1 = require("../enums/AlertClassificationEnum");
 const InternalAlertChannelEnum_1 = require("../enums/InternalAlertChannelEnum");
 /**
  * Alerta interna sobre un usuario. Se publica en la cola de alertamiento y zendesk-business
@@ -43,3 +44,8 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", String)
 ], ZendeskInternalAlertRequest.prototype, "reference", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(AlertClassificationEnum_1.AlertClassification),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], ZendeskInternalAlertRequest.prototype, "classification", void 0);

package/bin/helpdesk/enums/AlertClassificationEnum.d.ts

@@ -0,0 +1,9 @@
+/** Estado del usuario en su viaje, tal como se muestra en el asunto del ticket. */
+export declare enum AlertClassification {
+    /** Todavía no tiene cuenta abierta. */
+    ONBOARDING = "ONBOARDING",
+    /** El proveedor de KYC lo denegó. */
+    DENIED = "DENIED",
+    /** Tiene cuenta abierta. */
+    CLIENT = "CLIENT"
+}

package/bin/helpdesk/enums/AlertClassificationEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertClassification = void 0;
+/** Estado del usuario en su viaje, tal como se muestra en el asunto del ticket. */
+var AlertClassification;
+(function (AlertClassification) {
+    /** Todavía no tiene cuenta abierta. */
+    AlertClassification["ONBOARDING"] = "ONBOARDING";
+    /** El proveedor de KYC lo denegó. */
+    AlertClassification["DENIED"] = "DENIED";
+    /** Tiene cuenta abierta. */
+    AlertClassification["CLIENT"] = "CLIENT";
+})(AlertClassification || (exports.AlertClassification = AlertClassification = {}));

package/bin/helpdesk/index.d.ts

@@ -2,5 +2,6 @@ export * from './dtos/HelpdeskCreateUserRequest';
 export * from './dtos/HelpdeskCreateTicketRequest';
 export * from './dtos/ZendeskInternalAlertRequest';
 export * from './enums/InternalAlertChannelEnum';
+export * from './enums/AlertClassificationEnum';
 export * from './enums/ZendeskAlertKindEnum';
 export * from './interfaces/IZendeskAlertMessage';

package/bin/helpdesk/index.js

@@ -19,5 +19,6 @@ __exportStar(require("./dtos/HelpdeskCreateTicketRequest"), exports);
 // Alertamiento interno (cola de Zendesk)
 __exportStar(require("./dtos/ZendeskInternalAlertRequest"), exports);
 __exportStar(require("./enums/InternalAlertChannelEnum"), exports);
+__exportStar(require("./enums/AlertClassificationEnum"), exports);
 __exportStar(require("./enums/ZendeskAlertKindEnum"), exports);
 __exportStar(require("./interfaces/IZendeskAlertMessage"), exports);

package/bin/retailCards/dtos/requests/AssignCardRequest.d.ts

@@ -0,0 +1,6 @@
+/** Body de la asignación de una tarjeta física a un cliente. */
+export declare class AssignCardRequest {
+    assignedToCustomerId: string;
+    assignedByUserId: string;
+    creditId?: string;
+}

package/bin/retailCards/dtos/requests/AssignCardRequest.js

@@ -0,0 +1,30 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssignCardRequest = void 0;
+const class_validator_1 = require("class-validator");
+/** Body de la asignación de una tarjeta física a un cliente. */
+class AssignCardRequest {
+}
+exports.AssignCardRequest = AssignCardRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AssignCardRequest.prototype, "assignedToCustomerId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AssignCardRequest.prototype, "assignedByUserId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AssignCardRequest.prototype, "creditId", void 0);

package/bin/retailCards/dtos/requests/CancelCardRequest.d.ts

@@ -0,0 +1,5 @@
+import { CardCancelReasonEnum } from '../../enums/CardCancelReasonEnum';
+/** Body de la cancelación (anulación) de una tarjeta física. */
+export declare class CancelCardRequest {
+    reason: CardCancelReasonEnum;
+}

package/bin/retailCards/dtos/requests/CancelCardRequest.js

@@ -0,0 +1,22 @@
+"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.CancelCardRequest = void 0;
+const class_validator_1 = require("class-validator");
+const CardCancelReasonEnum_1 = require("../../enums/CardCancelReasonEnum");
+/** Body de la cancelación (anulación) de una tarjeta física. */
+class CancelCardRequest {
+}
+exports.CancelCardRequest = CancelCardRequest;
+__decorate([
+    (0, class_validator_1.IsEnum)(CardCancelReasonEnum_1.CardCancelReasonEnum),
+    __metadata("design:type", String)
+], CancelCardRequest.prototype, "reason", void 0);

package/bin/retailCards/dtos/responses/RetailCardResponse.d.ts

@@ -0,0 +1,12 @@
+import { RetailCardStatusEnum } from '../../enums/RetailCardStatusEnum';
+/** Representación de una tarjeta física hacia el cliente. */
+export interface RetailCardResponse {
+    cardNumber: string;
+    retailerId: string;
+    batchId: string;
+    storeId: string;
+    status: RetailCardStatusEnum;
+    assignedToCustomerId: string | null;
+    assignedAt: string | null;
+    assignedByUserId: string | null;
+}

package/bin/retailCards/dtos/responses/RetailCardResponse.js

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

package/bin/retailCards/enums/CardBatchStatusEnum.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Estado de un lote de tarjetas.
+ * @enum {string}
+ *
+ * @property {string} RECEIVING - Transitorio, carga en curso (DEC-004/DEC-008).
+ * @property {string} RECEIVED - Carga completada, lote atado a una tienda (happy-path F1).
+ * @property {string} FAILED - Terminal, la carga del lote falló (DEC-004/DEC-008).
+ * @property {string} DISTRIBUTED - Reservado F1 — lote centralizado repartido a varias tiendas (TD-008).
+ * @property {string} CLOSED - Reservado F1 — cierre manual del lote (TD-008).
+ */
+export declare enum CardBatchStatusEnum {
+    RECEIVING = "RECEIVING",
+    RECEIVED = "RECEIVED",
+    FAILED = "FAILED",
+    DISTRIBUTED = "DISTRIBUTED",
+    CLOSED = "CLOSED"
+}

package/bin/retailCards/enums/CardBatchStatusEnum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardBatchStatusEnum = void 0;
+/**
+ * Estado de un lote de tarjetas.
+ * @enum {string}
+ *
+ * @property {string} RECEIVING - Transitorio, carga en curso (DEC-004/DEC-008).
+ * @property {string} RECEIVED - Carga completada, lote atado a una tienda (happy-path F1).
+ * @property {string} FAILED - Terminal, la carga del lote falló (DEC-004/DEC-008).
+ * @property {string} DISTRIBUTED - Reservado F1 — lote centralizado repartido a varias tiendas (TD-008).
+ * @property {string} CLOSED - Reservado F1 — cierre manual del lote (TD-008).
+ */
+var CardBatchStatusEnum;
+(function (CardBatchStatusEnum) {
+    CardBatchStatusEnum["RECEIVING"] = "RECEIVING";
+    CardBatchStatusEnum["RECEIVED"] = "RECEIVED";
+    CardBatchStatusEnum["FAILED"] = "FAILED";
+    CardBatchStatusEnum["DISTRIBUTED"] = "DISTRIBUTED";
+    CardBatchStatusEnum["CLOSED"] = "CLOSED";
+})(CardBatchStatusEnum || (exports.CardBatchStatusEnum = CardBatchStatusEnum = {}));

package/bin/retailCards/enums/CardCancelReasonEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Motivo de cancelación de una tarjeta física.
+ * @enum {string}
+ *
+ * @property {string} PLASTIC_DAMAGED - Plástico dañado.
+ * @property {string} LOST - Tarjeta perdida.
+ * @property {string} THEFT_REPORTED - Robo reportado.
+ */
+export declare enum CardCancelReasonEnum {
+    PLASTIC_DAMAGED = "PLASTIC_DAMAGED",
+    LOST = "LOST",
+    THEFT_REPORTED = "THEFT_REPORTED"
+}

package/bin/retailCards/enums/CardCancelReasonEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardCancelReasonEnum = void 0;
+/**
+ * Motivo de cancelación de una tarjeta física.
+ * @enum {string}
+ *
+ * @property {string} PLASTIC_DAMAGED - Plástico dañado.
+ * @property {string} LOST - Tarjeta perdida.
+ * @property {string} THEFT_REPORTED - Robo reportado.
+ */
+var CardCancelReasonEnum;
+(function (CardCancelReasonEnum) {
+    CardCancelReasonEnum["PLASTIC_DAMAGED"] = "PLASTIC_DAMAGED";
+    CardCancelReasonEnum["LOST"] = "LOST";
+    CardCancelReasonEnum["THEFT_REPORTED"] = "THEFT_REPORTED";
+})(CardCancelReasonEnum || (exports.CardCancelReasonEnum = CardCancelReasonEnum = {}));

package/bin/retailCards/enums/RetailCardStatusEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Estado de una tarjeta física individual.
+ * @enum {string}
+ *
+ * @property {string} AVAILABLE - Cargada en stock, disponible para asignar.
+ * @property {string} ASSIGNED - Asignada a un cliente.
+ * @property {string} CANCELLED - Anulada (plástico dañado, pérdida o robo). Estado terminal.
+ */
+export declare enum RetailCardStatusEnum {
+    AVAILABLE = "AVAILABLE",
+    ASSIGNED = "ASSIGNED",
+    CANCELLED = "CANCELLED"
+}

package/bin/retailCards/enums/RetailCardStatusEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailCardStatusEnum = void 0;
+/**
+ * Estado de una tarjeta física individual.
+ * @enum {string}
+ *
+ * @property {string} AVAILABLE - Cargada en stock, disponible para asignar.
+ * @property {string} ASSIGNED - Asignada a un cliente.
+ * @property {string} CANCELLED - Anulada (plástico dañado, pérdida o robo). Estado terminal.
+ */
+var RetailCardStatusEnum;
+(function (RetailCardStatusEnum) {
+    RetailCardStatusEnum["AVAILABLE"] = "AVAILABLE";
+    RetailCardStatusEnum["ASSIGNED"] = "ASSIGNED";
+    RetailCardStatusEnum["CANCELLED"] = "CANCELLED";
+})(RetailCardStatusEnum || (exports.RetailCardStatusEnum = RetailCardStatusEnum = {}));

package/bin/retailCards/events/RetailCardAssignedV1.d.ts

@@ -0,0 +1,10 @@
+/** Emitido cuando una tarjeta se asigna a un cliente. */
+export interface RetailCardAssignedV1 {
+    cardNumber: string;
+    retailerId: string;
+    storeId: string;
+    assignedToCustomerId: string;
+    assignedByUserId: string;
+    creditId?: string;
+    occurredAt: string;
+}

package/bin/retailCards/events/RetailCardAssignedV1.js

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

package/bin/retailCards/events/RetailCardCancelledV1.d.ts

@@ -0,0 +1,9 @@
+import { CardCancelReasonEnum } from '../enums/CardCancelReasonEnum';
+/** Emitido cuando una tarjeta se cancela (anula). */
+export interface RetailCardCancelledV1 {
+    cardNumber: string;
+    retailerId: string;
+    storeId: string;
+    reason: CardCancelReasonEnum;
+    occurredAt: string;
+}

package/bin/retailCards/events/RetailCardCancelledV1.js

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

package/bin/retailCards/events/RetailCardReleasedV1.d.ts

@@ -0,0 +1,7 @@
+/** Emitido cuando una tarjeta se libera (vuelve a AVAILABLE). */
+export interface RetailCardReleasedV1 {
+    cardNumber: string;
+    retailerId: string;
+    storeId: string;
+    occurredAt: string;
+}

package/bin/retailCards/events/RetailCardReleasedV1.js

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

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

@@ -0,0 +1,9 @@
+/**
+ * POST /wizard/sessions/:id/complete-sale — cierra la venta (saga de 2 pasos, flujo 09). Exige
+ * payment registrado (regla dura). Consume el IMEI del silo (SOLD), asigna la tarjeta PCF, persiste
+ * la Sale con `UNIQ#FOLIO` y emite el outbox `SaleCompletedV1` en la MISMA tx. Cierra el prospecto
+ * vinculado si lo hay. `cardNumber` = tarjeta física entregada en tienda (S7). SureKeep Fase 2 — pista Retail.
+ */
+export declare class CompleteSaleRequest {
+    cardNumber?: string;
+}

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

@@ -0,0 +1,29 @@
+"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.CompleteSaleRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * POST /wizard/sessions/:id/complete-sale — cierra la venta (saga de 2 pasos, flujo 09). Exige
+ * payment registrado (regla dura). Consume el IMEI del silo (SOLD), asigna la tarjeta PCF, persiste
+ * la Sale con `UNIQ#FOLIO` y emite el outbox `SaleCompletedV1` en la MISMA tx. Cierra el prospecto
+ * vinculado si lo hay. `cardNumber` = tarjeta física entregada en tienda (S7). SureKeep Fase 2 — pista Retail.
+ */
+class CompleteSaleRequest {
+}
+exports.CompleteSaleRequest = CompleteSaleRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CompleteSaleRequest.prototype, "cardNumber", void 0);

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

@@ -0,0 +1,4 @@
+/** POST /wizard/sessions/:id/pcf-card/mark-delivered — marca la tarjeta física PCF como entregada (S7). SureKeep Fase 2 — pista Retail. */
+export declare class MarkPcfCardDeliveredRequest {
+    cardNumber: string;
+}

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

@@ -0,0 +1,23 @@
+"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.MarkPcfCardDeliveredRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** POST /wizard/sessions/:id/pcf-card/mark-delivered — marca la tarjeta física PCF como entregada (S7). SureKeep Fase 2 — pista Retail. */
+class MarkPcfCardDeliveredRequest {
+}
+exports.MarkPcfCardDeliveredRequest = MarkPcfCardDeliveredRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], MarkPcfCardDeliveredRequest.prototype, "cardNumber", void 0);

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

@@ -0,0 +1,31 @@
+import type { PendingReasonEnum } from '../../enums/PendingReasonEnum';
+/**
+ * GET /prospects/by-phone?phone=... — el prospecto VIGENTE de un telefono en la tienda del caller,
+ * para precargar el drawer «Guardar y salir» en vez de que el vendedor reescriba a ciegas.
+ *
+ * `found: false` es la respuesta NORMAL: la mayoria de los telefonos no tienen prospecto abierto. Un
+ * prospecto CLOSED/LOST, o de OTRA tienda (DEC-018), responden lo mismo que si no existiera.
+ *
+ * Solo los campos que el drawer rellena: el estado del prospecto (status, saleId, wizardSessionId,
+ * fechas, actores) no se publica — el contrato es donde ese limite se hace cumplir.
+ *
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface ProspectByPhoneResponse {
+    /** Unico campo con el que el front decide si precarga o deja el formulario en blanco. */
+    found: boolean;
+    /** Nombre capturado del cliente. `null` cuando `found` es `false` o el prospecto no lo trae. */
+    customerName: string | null;
+    /**
+     * Motivo guardado. Puede ser uno de `SYSTEM_PENDING_REASONS` (los que pone el sistema al trabarse
+     * la venta): el front tiene que poder pintarlo, o reenviarlo tal cual lo preserva. `null` cuando
+     * `found` es `false`.
+     */
+    pendingReason: PendingReasonEnum | null;
+    /** Texto libre del motivo. `null` cuando no hay o cuando `found` es `false`. */
+    freeReason: string | null;
+    /** Agenda del proximo contacto, ISO. `null` cuando `found` es `false`. */
+    nextContactAt: string | null;
+    /** Notas del vendedor. `null` cuando no hay o cuando `found` es `false`. */
+    notes: string | null;
+}

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

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

package/bin/retailWizard/index.d.ts

@@ -82,6 +82,7 @@ export * from './dtos/responses/SignatureSignResponse';
 export * from './dtos/responses/RegisterDeviceResponse';
 export * from './dtos/responses/AccountStatusResponse';
 export * from './dtos/responses/ActiveSessionByPhoneResponse';
+export * from './dtos/responses/ProspectByPhoneResponse';
 export * from './dtos/responses/AppOnboardingResponse';
 export * from './enums/SaleFinancierEnum';
 export * from './enums/SaleExceptionTypeEnum';

package/bin/retailWizard/index.js

@@ -105,6 +105,7 @@ __exportStar(require("./dtos/responses/SignatureSignResponse"), exports);
 __exportStar(require("./dtos/responses/RegisterDeviceResponse"), exports);
 __exportStar(require("./dtos/responses/AccountStatusResponse"), exports);
 __exportStar(require("./dtos/responses/ActiveSessionByPhoneResponse"), exports);
+__exportStar(require("./dtos/responses/ProspectByPhoneResponse"), exports);
 __exportStar(require("./dtos/responses/AppOnboardingResponse"), exports);
 // ── F3 · Backoffice VentasLuga ────────────────────────────────────────────────
 // Enums

package/package.json

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

package/src/helpdesk/dtos/ZendeskInternalAlertRequest.ts

@@ -1,4 +1,5 @@
 import { ArrayNotEmpty, IsArray, IsEnum, IsNotEmpty, IsOptional, IsString } from "class-validator";
+import { AlertClassification } from "../enums/AlertClassificationEnum";
 import { InternalAlertChannel } from "../enums/InternalAlertChannelEnum";
 
 /**
@@ -36,4 +37,12 @@ export class ZendeskInternalAlertRequest {
     @IsString()
     @IsOptional()
     reference?: string;
+
+    /**
+     * Clasificación explícita del usuario. Si viene, zendesk-business la usa tal cual en el asunto;
+     * si no, la calcula a partir del scope del directorio.
+     */
+    @IsEnum(AlertClassification)
+    @IsOptional()
+    classification?: AlertClassification;
 }

package/src/helpdesk/enums/AlertClassificationEnum.ts

@@ -0,0 +1,9 @@
+/** Estado del usuario en su viaje, tal como se muestra en el asunto del ticket. */
+export enum AlertClassification {
+    /** Todavía no tiene cuenta abierta. */
+    ONBOARDING = 'ONBOARDING',
+    /** El proveedor de KYC lo denegó. */
+    DENIED = 'DENIED',
+    /** Tiene cuenta abierta. */
+    CLIENT = 'CLIENT'
+}

package/src/helpdesk/index.ts

@@ -4,5 +4,6 @@ export * from './dtos/HelpdeskCreateTicketRequest';
 // Alertamiento interno (cola de Zendesk)
 export * from './dtos/ZendeskInternalAlertRequest';
 export * from './enums/InternalAlertChannelEnum';
+export * from './enums/AlertClassificationEnum';
 export * from './enums/ZendeskAlertKindEnum';
 export * from './interfaces/IZendeskAlertMessage';

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

@@ -0,0 +1,32 @@
+import type { PendingReasonEnum } from '../../enums/PendingReasonEnum';
+
+/**
+ * GET /prospects/by-phone?phone=... — el prospecto VIGENTE de un telefono en la tienda del caller,
+ * para precargar el drawer «Guardar y salir» en vez de que el vendedor reescriba a ciegas.
+ *
+ * `found: false` es la respuesta NORMAL: la mayoria de los telefonos no tienen prospecto abierto. Un
+ * prospecto CLOSED/LOST, o de OTRA tienda (DEC-018), responden lo mismo que si no existiera.
+ *
+ * Solo los campos que el drawer rellena: el estado del prospecto (status, saleId, wizardSessionId,
+ * fechas, actores) no se publica — el contrato es donde ese limite se hace cumplir.
+ *
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface ProspectByPhoneResponse {
+    /** Unico campo con el que el front decide si precarga o deja el formulario en blanco. */
+    found: boolean;
+    /** Nombre capturado del cliente. `null` cuando `found` es `false` o el prospecto no lo trae. */
+    customerName: string | null;
+    /**
+     * Motivo guardado. Puede ser uno de `SYSTEM_PENDING_REASONS` (los que pone el sistema al trabarse
+     * la venta): el front tiene que poder pintarlo, o reenviarlo tal cual lo preserva. `null` cuando
+     * `found` es `false`.
+     */
+    pendingReason: PendingReasonEnum | null;
+    /** Texto libre del motivo. `null` cuando no hay o cuando `found` es `false`. */
+    freeReason: string | null;
+    /** Agenda del proximo contacto, ISO. `null` cuando `found` es `false`. */
+    nextContactAt: string | null;
+    /** Notas del vendedor. `null` cuando no hay o cuando `found` es `false`. */
+    notes: string | null;
+}

package/src/retailWizard/index.ts

@@ -95,6 +95,7 @@ export * from './dtos/responses/SignatureSignResponse';
 export * from './dtos/responses/RegisterDeviceResponse';
 export * from './dtos/responses/AccountStatusResponse';
 export * from './dtos/responses/ActiveSessionByPhoneResponse';
+export * from './dtos/responses/ProspectByPhoneResponse';
 export * from './dtos/responses/AppOnboardingResponse';
 
 // ── F3 · Backoffice VentasLuga ────────────────────────────────────────────────