@fiado/type-kit 3.194.0 → 3.195.0

package/bin/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.js

@@ -0,0 +1,97 @@
+"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.UpsertCustomerFromKycRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const regex_1 = require("../../../helpers/constans/regex");
+const AddressBase_1 = require("../../../address/dtos/AddressBase");
+const KycModalityEnum_1 = require("../../enums/KycModalityEnum");
+const RetailKycStatusEnum_1 = require("../../enums/RetailKycStatusEnum");
+/**
+ * Upsert idempotente del cliente tras el KYC (paso 02f). UNIQ#PHONE + UNIQ#CURP en la misma TX.
+ * El endpoint setea `accountStatus=OPENING` server-side (la apertura corre en background, D35).
+ * SureKeep Fase 2 — pista Retail.
+ */
+class UpsertCustomerFromKycRequest {
+}
+exports.UpsertCustomerFromKycRequest = UpsertCustomerFromKycRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.replace(/[\s-]/g, '') : value)),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(regex_1.regexPhoneMx, { message: 'phone debe ser 10 dígitos MX' }),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.toUpperCase() : value)),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(regex_1.regexCurp, { message: 'curp con formato inválido' }),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "curp", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(regex_1.regexIso8601Date, { message: 'birthDate debe ser una fecha ISO 8601' }),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "birthDate", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "fiadoDirectoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "fiadoPeopleId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "pcfAccountId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "pcfClabe", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)([1, 2]),
+    __metadata("design:type", Number)
+], UpsertCustomerFromKycRequest.prototype, "pcfAccountLevel", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(RetailKycStatusEnum_1.RetailKycStatusEnum),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "kycStatus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(KycModalityEnum_1.KycModalityEnum),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "kycModality", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => AddressBase_1.AddressBase),
+    __metadata("design:type", AddressBase_1.AddressBase)
+], UpsertCustomerFromKycRequest.prototype, "address", void 0);

package/bin/retailCustomer/dtos/responses/Customer360Response.d.ts

@@ -0,0 +1,33 @@
+import { CustomerResponse } from './CustomerResponse';
+/** Resumen de wallet (nivel N1/N2 + saldo) para el Cliente 360. */
+export interface Customer360Wallet {
+    accountLevel: 1 | 2 | null;
+    clabe: string | null;
+    balanceCents: number;
+}
+/** Ítem de compra en el historial del Cliente 360 (del GSI customerId-soldAt). */
+export interface Customer360Purchase {
+    saleId: string;
+    sku: string;
+    amountCents: number;
+    folio: string;
+    soldAt: string;
+    status: string;
+}
+/** Ítem de prospecto vinculado al cliente en el Cliente 360. */
+export interface Customer360Prospect {
+    prospectId: string;
+    pendingReason: string;
+    status: string;
+    nextContactAt: string;
+}
+/**
+ * Ficha Cliente 360 (BO): compone KYC + wallet N1/N2 + compras + prospectos. Cada bloque se hidrata
+ * desde su owner (customer, transaction-processor, sale GSI, prospect GSI). SureKeep Fase 2 — pista Retail.
+ */
+export interface Customer360Response {
+    customer: CustomerResponse;
+    wallet: Customer360Wallet;
+    purchases: Customer360Purchase[];
+    prospects: Customer360Prospect[];
+}

package/bin/retailCustomer/dtos/responses/Customer360Response.js

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

package/bin/retailCustomer/dtos/responses/CustomerResponse.d.ts

@@ -0,0 +1,30 @@
+import { AddressBase } from '../../../address/dtos/AddressBase';
+import { AccountStatusEnum } from '../../enums/AccountStatusEnum';
+import { KycModalityEnum } from '../../enums/KycModalityEnum';
+import { RetailKycStatusEnum } from '../../enums/RetailKycStatusEnum';
+/**
+ * Vista de un cliente retail hacia el consumidor (BO / api-invoker). SureKeep Fase 2 — pista Retail.
+ * `address` reusa el `AddressBase` canónico de Fiado (ver TD en RetailCustomer.address).
+ */
+export interface CustomerResponse {
+    retailCustomerId: string;
+    retailerId: string;
+    name: string;
+    phone: string;
+    curp: string;
+    birthDate: string | null;
+    fiadoDirectoryId: string | null;
+    fiadoPeopleId: string | null;
+    pcfAccountId: string | null;
+    pcfClabe: string | null;
+    pcfAccountLevel: 1 | 2 | null;
+    accountStatus: AccountStatusEnum | null;
+    failReason: string | null;
+    welcomeAccredited: boolean;
+    address: AddressBase | null;
+    addressConfirmed: boolean;
+    kycStatus: RetailKycStatusEnum;
+    kycModality: KycModalityEnum | null;
+    createdAt: string;
+    updatedAt: string;
+}

package/bin/retailCustomer/dtos/responses/CustomerResponse.js

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

package/bin/retailCustomer/enums/AccountStatusEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Estado de la apertura async de la cuenta PagoConFiado (PCF) del cliente retail (D35).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare enum AccountStatusEnum {
+    OPENING = "OPENING",
+    OPEN = "OPEN",
+    FAILED = "FAILED"
+}

package/bin/retailCustomer/enums/AccountStatusEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountStatusEnum = void 0;
+/**
+ * Estado de la apertura async de la cuenta PagoConFiado (PCF) del cliente retail (D35).
+ * SureKeep Fase 2 — pista Retail.
+ */
+var AccountStatusEnum;
+(function (AccountStatusEnum) {
+    AccountStatusEnum["OPENING"] = "OPENING";
+    AccountStatusEnum["OPEN"] = "OPEN";
+    AccountStatusEnum["FAILED"] = "FAILED";
+})(AccountStatusEnum || (exports.AccountStatusEnum = AccountStatusEnum = {}));

package/bin/retailCustomer/enums/KycModalityEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Modalidad con la que el cliente ejecuta el KYC en el wizard (M1 §213-329).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare enum KycModalityEnum {
+    CUSTOMER_LINK = "CUSTOMER_LINK",
+    STORE_DEVICE = "STORE_DEVICE",
+    MANUAL = "MANUAL"
+}

package/bin/retailCustomer/enums/KycModalityEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KycModalityEnum = void 0;
+/**
+ * Modalidad con la que el cliente ejecuta el KYC en el wizard (M1 §213-329).
+ * SureKeep Fase 2 — pista Retail.
+ */
+var KycModalityEnum;
+(function (KycModalityEnum) {
+    KycModalityEnum["CUSTOMER_LINK"] = "CUSTOMER_LINK";
+    KycModalityEnum["STORE_DEVICE"] = "STORE_DEVICE";
+    KycModalityEnum["MANUAL"] = "MANUAL";
+})(KycModalityEnum || (exports.KycModalityEnum = KycModalityEnum = {}));

package/bin/retailCustomer/enums/KycReviewResultEnum.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resultado de la revisión manual del oficial de Cumplimiento (D21).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare enum KycReviewResultEnum {
+    APPROVED = "APPROVED",
+    REJECTED = "REJECTED"
+}

package/bin/retailCustomer/enums/KycReviewResultEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KycReviewResultEnum = void 0;
+/**
+ * Resultado de la revisión manual del oficial de Cumplimiento (D21).
+ * SureKeep Fase 2 — pista Retail.
+ */
+var KycReviewResultEnum;
+(function (KycReviewResultEnum) {
+    KycReviewResultEnum["APPROVED"] = "APPROVED";
+    KycReviewResultEnum["REJECTED"] = "REJECTED";
+})(KycReviewResultEnum || (exports.KycReviewResultEnum = KycReviewResultEnum = {}));

package/bin/retailCustomer/enums/RetailKycStatusEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Estado del KYC del cliente retail (vocabulario retail; espejo operativo del KYC de Fiado).
+ * PENDING (sin resultado) · VERIFIED (Metamap OK) · FAILED (incluye PLD) · MANUAL (captura manual,
+ * cae en cola de Cumplimiento) · REVIEW (esperando resolución de Cumplimiento).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare enum RetailKycStatusEnum {
+    PENDING = "PENDING",
+    VERIFIED = "VERIFIED",
+    FAILED = "FAILED",
+    MANUAL = "MANUAL",
+    REVIEW = "REVIEW"
+}

package/bin/retailCustomer/enums/RetailKycStatusEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailKycStatusEnum = void 0;
+/**
+ * Estado del KYC del cliente retail (vocabulario retail; espejo operativo del KYC de Fiado).
+ * PENDING (sin resultado) · VERIFIED (Metamap OK) · FAILED (incluye PLD) · MANUAL (captura manual,
+ * cae en cola de Cumplimiento) · REVIEW (esperando resolución de Cumplimiento).
+ * SureKeep Fase 2 — pista Retail.
+ */
+var RetailKycStatusEnum;
+(function (RetailKycStatusEnum) {
+    RetailKycStatusEnum["PENDING"] = "PENDING";
+    RetailKycStatusEnum["VERIFIED"] = "VERIFIED";
+    RetailKycStatusEnum["FAILED"] = "FAILED";
+    RetailKycStatusEnum["MANUAL"] = "MANUAL";
+    RetailKycStatusEnum["REVIEW"] = "REVIEW";
+})(RetailKycStatusEnum || (exports.RetailKycStatusEnum = RetailKycStatusEnum = {}));

package/bin/retailCustomer/events/CustomerCreatedV1.d.ts

@@ -0,0 +1,7 @@
+/** Emitido cuando se da de alta un cliente retail (→ cola Central). SureKeep Fase 2 — pista Retail. */
+export interface CustomerCreatedV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    phone: string;
+    occurredAt: string;
+}

package/bin/retailCustomer/events/CustomerCreatedV1.js

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

package/bin/retailCustomer/events/CustomerKycVerifiedV1.d.ts

@@ -0,0 +1,27 @@
+import { KycModalityEnum } from '../enums/KycModalityEnum';
+import { RetailKycStatusEnum } from '../enums/RetailKycStatusEnum';
+/**
+ * Puente retail↔sofom (D24/D35) — emitido en la MISMA TX del `upsert-from-kyc` con el payload OCR
+ * completo. Lo consume `loan-credit-business` (idempotente, hidrata `LoanBorrower_GT`) y dispara la
+ * apertura de cuenta async. También alimenta CDC→Iceberg (atomicidad efectiva por outbox).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface CustomerKycVerifiedV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    fiadoDirectoryId: string;
+    fiadoPeopleId: string;
+    phone: string;
+    curp: string;
+    firstName: string;
+    paternalLastName: string;
+    maternalLastName: string | null;
+    birthDate: string;
+    sex: string | null;
+    nationality: string | null;
+    documentValidUntil: string | null;
+    addressRaw: string | null;
+    kycStatus: RetailKycStatusEnum;
+    kycModality: KycModalityEnum;
+    occurredAt: string;
+}

package/bin/retailCustomer/events/CustomerKycVerifiedV1.js

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

package/bin/retailCustomer/events/CustomerUpdatedV1.d.ts

@@ -0,0 +1,9 @@
+/** Emitido cuando se editan datos de contacto/PII de un cliente retail. SureKeep Fase 2 — pista Retail. */
+export interface CustomerUpdatedV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    /** Nombres de los campos modificados (sin sus valores — PII zero-tolerance). */
+    updatedFields: string[];
+    updatedBy: string;
+    occurredAt: string;
+}

package/bin/retailCustomer/events/CustomerUpdatedV1.js

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

package/bin/retailCustomer/events/KycApprovedByComplianceV1.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Emitido cuando el oficial de Cumplimiento APRUEBA un KYC en revisión manual (D21). Dispara post-pasos
+ * idempotentes fuera de la TX (espejo a Fiado + apertura PCF N1 diferida). SureKeep Fase 2 — pista Retail.
+ */
+export interface KycApprovedByComplianceV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    reviewedBy: string;
+    justification: string;
+    metamapVerificationId: string;
+    occurredAt: string;
+}

package/bin/retailCustomer/events/KycApprovedByComplianceV1.js

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

package/bin/retailCustomer/events/KycRejectedByComplianceV1.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Emitido cuando el oficial de Cumplimiento RECHAZA un KYC en revisión manual (D21).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface KycRejectedByComplianceV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    reviewedBy: string;
+    justification: string;
+    metamapVerificationId: string;
+    occurredAt: string;
+}

package/bin/retailCustomer/events/KycRejectedByComplianceV1.js

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

package/bin/retailCustomer/index.d.ts

@@ -0,0 +1,18 @@
+export * from './enums/AccountStatusEnum';
+export * from './enums/RetailKycStatusEnum';
+export * from './enums/KycModalityEnum';
+export * from './enums/KycReviewResultEnum';
+export * from './dtos/KycReview';
+export * from './dtos/RetailCustomer';
+export * from './dtos/requests/CreateCustomerRequest';
+export * from './dtos/requests/UpsertCustomerFromKycRequest';
+export * from './dtos/requests/UpdateCustomerRequest';
+export * from './dtos/requests/AccountResultRequest';
+export * from './dtos/requests/KycReviewRequest';
+export * from './dtos/responses/CustomerResponse';
+export * from './dtos/responses/Customer360Response';
+export * from './events/CustomerCreatedV1';
+export * from './events/CustomerUpdatedV1';
+export * from './events/CustomerKycVerifiedV1';
+export * from './events/KycApprovedByComplianceV1';
+export * from './events/KycRejectedByComplianceV1';

package/bin/retailCustomer/index.js

@@ -0,0 +1,39 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Enums
+__exportStar(require("./enums/AccountStatusEnum"), exports);
+__exportStar(require("./enums/RetailKycStatusEnum"), exports);
+__exportStar(require("./enums/KycModalityEnum"), exports);
+__exportStar(require("./enums/KycReviewResultEnum"), exports);
+// Entidades (planas, con class-validator + @Expose)
+__exportStar(require("./dtos/KycReview"), exports);
+__exportStar(require("./dtos/RetailCustomer"), exports);
+// Request DTOs (input validado por endpoint)
+__exportStar(require("./dtos/requests/CreateCustomerRequest"), exports);
+__exportStar(require("./dtos/requests/UpsertCustomerFromKycRequest"), exports);
+__exportStar(require("./dtos/requests/UpdateCustomerRequest"), exports);
+__exportStar(require("./dtos/requests/AccountResultRequest"), exports);
+__exportStar(require("./dtos/requests/KycReviewRequest"), exports);
+// Response DTOs
+__exportStar(require("./dtos/responses/CustomerResponse"), exports);
+__exportStar(require("./dtos/responses/Customer360Response"), exports);
+// Contratos de eventos (PascalCase + sufijo V1)
+__exportStar(require("./events/CustomerCreatedV1"), exports);
+__exportStar(require("./events/CustomerUpdatedV1"), exports);
+__exportStar(require("./events/CustomerKycVerifiedV1"), exports);
+__exportStar(require("./events/KycApprovedByComplianceV1"), exports);
+__exportStar(require("./events/KycRejectedByComplianceV1"), exports);

package/bin/retailWizard/dtos/OtpVerification.d.ts

@@ -0,0 +1,24 @@
+import type { OtpPurposeEnum } from '../enums/OtpPurposeEnum';
+/**
+ * Verificación OTP (modelo-datos §2). NO es tabla aparte: vive como ítem en
+ * `<T>RetailWizardSession_GT` (pk `SESSION#<sessionId>` · sk `OTP#<ulid>`) — misma partición de la
+ * sesión → 1 Query trae sesión + OTPs. El código lo genera/valida `messages-business` (D5); aquí
+ * solo trackeamos el `messagesLogId`, nunca el código. SureKeep Fase 2 — pista Retail.
+ */
+export interface OtpVerification {
+    otpId: string;
+    sessionId: string;
+    purpose: OtpPurposeEnum;
+    /** Sustituye al `code_hash` de v0.1 (D5): tracking del envío en messages-business. */
+    messagesLogId: string;
+    channelsDispatched: string[];
+    /** Máx 3 → 423 OTP_MAX_TRIES. */
+    attempts: number;
+    /** 5 min. */
+    expiresAt: string;
+    verifiedAt: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: number;
+    updatedAt: number;
+}

package/bin/retailWizard/dtos/OtpVerification.js

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

package/bin/retailWizard/dtos/PaginatedResult.d.ts

@@ -0,0 +1,6 @@
+/** Resultado paginado genérico (cursor opaco `nextToken`). SureKeep Fase 2 — pista Retail. */
+export interface PaginatedResult<T> {
+    items: T[];
+    count: number;
+    nextToken?: string;
+}

package/bin/retailWizard/dtos/PaginatedResult.js

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

package/bin/retailWizard/dtos/Prospect.d.ts

@@ -0,0 +1,32 @@
+import type { ProspectStatusEnum } from '../enums/ProspectStatusEnum';
+import type { PendingReasonEnum } from '../enums/PendingReasonEnum';
+import type { ProspectNewCustomer } from './ProspectNewCustomer';
+/**
+ * Prospecto (modelo-datos §4). pk `PROSPECT#<prospectId>` · sk `META` · GSIs
+ * `storeId-nextContactAt-index`, `seller-nextContactAt-index`. La reanudación lee la WizardSession
+ * real (no se duplica el snapshot del wizard). SureKeep Fase 2 — pista Retail.
+ */
+export interface Prospect {
+    prospectId: string;
+    retailerId: string;
+    storeId: string;
+    sellerRetailUserId: string;
+    /** Identificado vs captura manual (uno de los dos). */
+    retailCustomerId: string | null;
+    newCustomer: ProspectNewCustomer | null;
+    productSku: string | null;
+    pendingReason: PendingReasonEnum;
+    /** Obligatorio si `pendingReason=OTHER`; ≤200. */
+    freeReason: string | null;
+    /** Agenda (default mañana); urgencia derivada OVERDUE/TODAY/UPCOMING. */
+    nextContactAt: string;
+    notes: string | null;
+    status: ProspectStatusEnum;
+    wizardSessionId: string | null;
+    saleId: string | null;
+    lastContactAt: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: number;
+    updatedAt: number;
+}

package/bin/retailWizard/dtos/Prospect.js

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

package/bin/retailWizard/dtos/ProspectNewCustomer.d.ts

@@ -0,0 +1,5 @@
+/** Captura manual de un cliente no identificado en un prospecto (`Prospect.newCustomer`). SureKeep Fase 2 — pista Retail. */
+export declare class ProspectNewCustomer {
+    name: string;
+    phone: string;
+}

package/bin/retailWizard/dtos/ProspectNewCustomer.js

@@ -0,0 +1,28 @@
+"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.ProspectNewCustomer = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Captura manual de un cliente no identificado en un prospecto (`Prospect.newCustomer`). SureKeep Fase 2 — pista Retail. */
+class ProspectNewCustomer {
+}
+exports.ProspectNewCustomer = ProspectNewCustomer;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProspectNewCustomer.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProspectNewCustomer.prototype, "phone", void 0);

package/bin/retailWizard/dtos/Sale.d.ts

@@ -0,0 +1,42 @@
+import type { SaleTypeEnum } from '../enums/SaleTypeEnum';
+import type { SaleStatusEnum } from '../enums/SaleStatusEnum';
+import type { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
+import type { CentralSyncStatusEnum } from '../enums/CentralSyncStatusEnum';
+import type { SalePaymentDetail } from './SalePaymentDetail';
+/**
+ * Venta (modelo-datos §3). pk `SALE#<saleId>` · sk `META` · 4 GSIs (`retailerId-soldAt-index`,
+ * `storeId-soldAt-index`, `seller-soldAt-index`, `customerId-soldAt-index`). Unicidad de folio vía
+ * `UNIQ#FOLIO#<folio>` en la MISMA TransactWriteItems del cierre. SureKeep Fase 2 — pista Retail.
+ */
+export interface Sale {
+    saleId: string;
+    retailerId: string;
+    storeId: string;
+    sellerRetailUserId: string;
+    retailCustomerId: string;
+    wizardSessionId: string;
+    type: SaleTypeEnum;
+    externalProvider: ExternalProviderEnum | null;
+    sku: string;
+    /** IMEI consumido del silo también en contado (local-first); null en EXTERNAL_REFERRAL (D15). */
+    imei: string | null;
+    /** 0 en EXTERNAL_REFERRAL. */
+    amountCents: number;
+    paymentMethod: SalePaymentMethodEnum | null;
+    /** `LG-T{storeCode}-VTA-{5hex}-{YYYY}W{ww}` (D11) — único vía `UNIQ#FOLIO`. */
+    folio: string;
+    paymentDetail: SalePaymentDetail | null;
+    soldAt: string;
+    cardNumberDelivered: string | null;
+    centralSyncStatus: CentralSyncStatusEnum;
+    centralTag: string | null;
+    status: SaleStatusEnum;
+    cancelledAt: string | null;
+    /** Reason OBLIGATORIO en cancelación (AuditTrail) — flujo C. */
+    cancelReason: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: number;
+    updatedAt: number;
+}

package/bin/retailWizard/dtos/Sale.js

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

package/bin/retailWizard/dtos/SalePaymentDetail.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Detalle del pago según el medio (`Sale.paymentDetail`): efectivo `{cashConfirmedInRegister}` ·
+ * tarjeta `{cardLast4, authCode}` · SPEI `{speiTrackingKey, senderClabe?}`. SureKeep Fase 2 — pista Retail.
+ */
+export declare class SalePaymentDetail {
+    cashConfirmedInRegister?: boolean;
+    cardLast4?: string;
+    authCode?: string;
+    speiTrackingKey?: string;
+    senderClabe?: string;
+}