@fiado/type-kit 3.193.0 → 3.195.0

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;
+}

package/bin/retailWizard/dtos/SalePaymentDetail.js

@@ -0,0 +1,51 @@
+"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.SalePaymentDetail = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Detalle del pago según el medio (`Sale.paymentDetail`): efectivo `{cashConfirmedInRegister}` ·
+ * tarjeta `{cardLast4, authCode}` · SPEI `{speiTrackingKey, senderClabe?}`. SureKeep Fase 2 — pista Retail.
+ */
+class SalePaymentDetail {
+}
+exports.SalePaymentDetail = SalePaymentDetail;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], SalePaymentDetail.prototype, "cashConfirmedInRegister", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SalePaymentDetail.prototype, "cardLast4", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SalePaymentDetail.prototype, "authCode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SalePaymentDetail.prototype, "speiTrackingKey", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SalePaymentDetail.prototype, "senderClabe", void 0);

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

@@ -0,0 +1,13 @@
+import { BeneficiaryRelationEnum } from '../enums/BeneficiaryRelationEnum';
+/**
+ * Beneficiario capturado en el paso 10 (bienvenida N2). Se envía a `IAccountBeneficiaryApi.create`
+ * (expediente wallet Fiado). El cliente puede NO dar beneficiario (opcional en régimen simplificado N1).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare class WizardBeneficiary {
+    fullName: string;
+    relation: BeneficiaryRelationEnum;
+    /** Porcentaje de asignación (1-100). Si hay un solo beneficiario, típicamente 100. */
+    percentage?: number;
+    freeRelation?: string;
+}

package/bin/retailWizard/dtos/WizardBeneficiary.js

@@ -0,0 +1,47 @@
+"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.WizardBeneficiary = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const BeneficiaryRelationEnum_1 = require("../enums/BeneficiaryRelationEnum");
+/**
+ * Beneficiario capturado en el paso 10 (bienvenida N2). Se envía a `IAccountBeneficiaryApi.create`
+ * (expediente wallet Fiado). El cliente puede NO dar beneficiario (opcional en régimen simplificado N1).
+ * SureKeep Fase 2 — pista Retail.
+ */
+class WizardBeneficiary {
+}
+exports.WizardBeneficiary = WizardBeneficiary;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], WizardBeneficiary.prototype, "fullName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(BeneficiaryRelationEnum_1.BeneficiaryRelationEnum),
+    __metadata("design:type", String)
+], WizardBeneficiary.prototype, "relation", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], WizardBeneficiary.prototype, "percentage", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], WizardBeneficiary.prototype, "freeRelation", void 0);

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

@@ -0,0 +1,8 @@
+/** Consentimientos aceptados en el wizard (VL + contrato PCF). SureKeep Fase 2 — pista Retail. */
+export declare class WizardConsents {
+    vlTermsVersion: string;
+    pcfContractVersion: string;
+    acceptedAt: string;
+    ip?: string;
+    deviceFingerprint?: string;
+}

package/bin/retailWizard/dtos/WizardConsents.js

@@ -0,0 +1,47 @@
+"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.WizardConsents = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const regex_1 = require("../../helpers/constans/regex");
+/** Consentimientos aceptados en el wizard (VL + contrato PCF). SureKeep Fase 2 — pista Retail. */
+class WizardConsents {
+}
+exports.WizardConsents = WizardConsents;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], WizardConsents.prototype, "vlTermsVersion", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], WizardConsents.prototype, "pcfContractVersion", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(regex_1.regexIso8601, { message: 'acceptedAt debe ser una fecha ISO 8601' }),
+    __metadata("design:type", String)
+], WizardConsents.prototype, "acceptedAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], WizardConsents.prototype, "ip", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], WizardConsents.prototype, "deviceFingerprint", void 0);

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

@@ -0,0 +1,8 @@
+import { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+/** Registro del pago de contado dentro de la sesión (`WizardSession.payment`). SureKeep Fase 2 — pista Retail. */
+export declare class WizardPayment {
+    method: SalePaymentMethodEnum;
+    amountCents: number;
+    detail?: string;
+    paidAt: string;
+}

package/bin/retailWizard/dtos/WizardPayment.js

@@ -0,0 +1,43 @@
+"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.WizardPayment = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const regex_1 = require("../../helpers/constans/regex");
+const SalePaymentMethodEnum_1 = require("../enums/SalePaymentMethodEnum");
+/** Registro del pago de contado dentro de la sesión (`WizardSession.payment`). SureKeep Fase 2 — pista Retail. */
+class WizardPayment {
+}
+exports.WizardPayment = WizardPayment;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(SalePaymentMethodEnum_1.SalePaymentMethodEnum),
+    __metadata("design:type", String)
+], WizardPayment.prototype, "method", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], WizardPayment.prototype, "amountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], WizardPayment.prototype, "detail", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(regex_1.regexIso8601, { message: 'paidAt debe ser una fecha ISO 8601' }),
+    __metadata("design:type", String)
+], WizardPayment.prototype, "paidAt", void 0);

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

@@ -0,0 +1,65 @@
+import type { WizardStateEnum } from '../enums/WizardStateEnum';
+import type { WizardStepEnum } from '../enums/WizardStepEnum';
+import type { FiadoPhoneStatusEnum } from '../enums/FiadoPhoneStatusEnum';
+import type { PaymentMethodEnum } from '../enums/PaymentMethodEnum';
+import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
+import type { OccupationEnum } from '../enums/OccupationEnum';
+import type { WizardConsents } from './WizardConsents';
+import type { WizardPayment } from './WizardPayment';
+import type { WizardWelcome } from './WizardWelcome';
+/** Modalidad de captura del KYC (M1 §213-329). */
+export type KycModality = 'CUSTOMER_LINK' | 'STORE_DEVICE' | 'MANUAL';
+/** Estado de la apertura de cuenta async (D35) — espejo de `RetailCustomer.accountStatus`. */
+export type AccountStatus = 'OPENING' | 'OPEN' | 'FAILED';
+/**
+ * Estado de la SAGA del wizard (modelo-datos §1). ES la tabla de estado: cada paso persiste su
+ * avance; reanudable. pk `SESSION#<sessionId>` · sk `META` · GSIs `phone-state-index`,
+ * `customerId-pk-index`. Los ítems `OTP#` viven en la MISMA partición (ver OtpVerification).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface WizardSession {
+    sessionId: string;
+    retailerId: string;
+    storeId: string;
+    sellerRetailUserId: string;
+    /** Llave de la sesión; 1 ACTIVE por teléfono vía `UNIQ#ACTIVE-PHONE#<phone>`. */
+    phone: string;
+    retailCustomerId: string | null;
+    currentStep: WizardStepEnum;
+    state: WizardStateEnum;
+    otpVerified: boolean;
+    otpSkipped: boolean;
+    consents: WizardConsents | null;
+    /** Espejo del estado KYC (fuente = customer). */
+    kycStatus: string | null;
+    kycModality: KycModality | null;
+    metamapIdentityId: string | null;
+    occupation: OccupationEnum | null;
+    occupationOther: string | null;
+    /** Del gate `signInPhoneNumber` del 01a (D27). */
+    fiadoPhoneStatus: FiadoPhoneStatusEnum | null;
+    fiadoDirectoryId: string | null;
+    fiadoPeopleId: string | null;
+    pcfProvisioned: boolean;
+    accountOpened: boolean;
+    accountStatus: AccountStatus | null;
+    reservedSku: string | null;
+    reservedImei: string | null;
+    reservationExpiresAt: string | null;
+    paymentMethod: PaymentMethodEnum | null;
+    externalProvider: ExternalProviderEnum | null;
+    /** Folio de cobro server-side (D11), idempotente, sobrevive al volver atrás. */
+    folio: string | null;
+    payment: WizardPayment | null;
+    welcome: WizardWelcome | null;
+    saleId: string | null;
+    /** 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;
+    /** TTL DDB ~24h de inactividad (D14). */
+    ttlEpoch: number;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: number;
+    updatedAt: number;
+}

package/bin/retailWizard/dtos/WizardSession.js

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

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

@@ -0,0 +1,9 @@
+/** Estado del paso 10 (bienvenida N2) dentro de la sesión (`WizardSession.welcome`). SureKeep Fase 2 — pista Retail. */
+export declare class WizardWelcome {
+    addressConfirmed: boolean;
+    benefCaptured: boolean;
+    annexSigned: boolean;
+    annexVersion?: string;
+    topupApplied: boolean;
+    accountLevel?: 1 | 2;
+}

package/bin/retailWizard/dtos/WizardWelcome.js

@@ -0,0 +1,50 @@
+"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.WizardWelcome = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Estado del paso 10 (bienvenida N2) dentro de la sesión (`WizardSession.welcome`). SureKeep Fase 2 — pista Retail. */
+class WizardWelcome {
+}
+exports.WizardWelcome = WizardWelcome;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], WizardWelcome.prototype, "addressConfirmed", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], WizardWelcome.prototype, "benefCaptured", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], WizardWelcome.prototype, "annexSigned", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], WizardWelcome.prototype, "annexVersion", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], WizardWelcome.prototype, "topupApplied", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)([1, 2]),
+    __metadata("design:type", Number)
+], WizardWelcome.prototype, "accountLevel", void 0);

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

@@ -0,0 +1,10 @@
+/**
+ * POST /wizard/sessions/:id/product — reserva un equipo del catálogo (paso 03). Reserva 30 min en
+ * RetailInventory F1 (condición atómica H2). El `cashPriceCents` de la reserva ancla el cobro
+ * (regla dura: `amountCents == cashPrice`). SureKeep Fase 2 — pista Retail.
+ */
+export declare class AddProductRequest {
+    sku: string;
+    imei: string;
+    cashPriceCents: number;
+}

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

@@ -0,0 +1,38 @@
+"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.AddProductRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * POST /wizard/sessions/:id/product — reserva un equipo del catálogo (paso 03). Reserva 30 min en
+ * RetailInventory F1 (condición atómica H2). El `cashPriceCents` de la reserva ancla el cobro
+ * (regla dura: `amountCents == cashPrice`). SureKeep Fase 2 — pista Retail.
+ */
+class AddProductRequest {
+}
+exports.AddProductRequest = AddProductRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AddProductRequest.prototype, "sku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AddProductRequest.prototype, "imei", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], AddProductRequest.prototype, "cashPriceCents", void 0);

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

@@ -0,0 +1,4 @@
+/** POST /wizard/sessions/:id/app/install-link — genera el shortlink de instalación de la app (QR, D9). SureKeep Fase 2 — pista Retail. */
+export declare class AppInstallLinkRequest {
+    channel?: string;
+}

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

@@ -0,0 +1,24 @@
+"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.AppInstallLinkRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** POST /wizard/sessions/:id/app/install-link — genera el shortlink de instalación de la app (QR, D9). SureKeep Fase 2 — pista Retail. */
+class AppInstallLinkRequest {
+}
+exports.AppInstallLinkRequest = AppInstallLinkRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AppInstallLinkRequest.prototype, "channel", void 0);

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

@@ -0,0 +1,8 @@
+/**
+ * POST /sales/:saleId/cancel — cancela una venta (flujo C, solo BO dentro de ventana param). `reason`
+ * OBLIGATORIO (AuditTrail). Retorna el IMEI al silo (`SOLD → AVAILABLE`) y emite `SaleCancelledV1`.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare class CancelSaleRequest {
+    reason: string;
+}

package/bin/retailWizard/dtos/requests/CancelSaleRequest.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.CancelSaleRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * POST /sales/:saleId/cancel — cancela una venta (flujo C, solo BO dentro de ventana param). `reason`
+ * OBLIGATORIO (AuditTrail). Retorna el IMEI al silo (`SOLD → AVAILABLE`) y emite `SaleCancelledV1`.
+ * SureKeep Fase 2 — pista Retail.
+ */
+class CancelSaleRequest {
+}
+exports.CancelSaleRequest = CancelSaleRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(200),
+    __metadata("design:type", String)
+], CancelSaleRequest.prototype, "reason", void 0);

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

@@ -0,0 +1,4 @@
+/** POST /wizard/sessions/:id/cancel — cancela la sesión (libera reserva + UNIQ#ACTIVE-PHONE). SureKeep Fase 2 — pista Retail. */
+export declare class CancelSessionRequest {
+    reason: string;
+}

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

@@ -0,0 +1,24 @@
+"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.CancelSessionRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** POST /wizard/sessions/:id/cancel — cancela la sesión (libera reserva + UNIQ#ACTIVE-PHONE). SureKeep Fase 2 — pista Retail. */
+class CancelSessionRequest {
+}
+exports.CancelSessionRequest = CancelSessionRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(200),
+    __metadata("design:type", String)
+], CancelSessionRequest.prototype, "reason", void 0);