@fiado/type-kit 3.539.0 → 3.540.0

package/_test_/unit/retailCustomer/ensureCustomerByPhoneRequest.test.ts

@@ -0,0 +1,30 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { EnsureCustomerByPhoneRequest } from '../../../src/retailCustomer/dtos/requests/EnsureCustomerByPhoneRequest';
+import * as RetailCustomer from '../../../src/retailCustomer';
+
+function errorsOf(payload: Record<string, unknown>): string[] {
+  const dto = plainToInstance(EnsureCustomerByPhoneRequest, payload, { excludeExtraneousValues: true });
+  return validateSync(dto).map((e) => e.property);
+}
+
+describe('EnsureCustomerByPhoneRequest', () => {
+  it('acepta celular de 10 dígitos y tienda', () => {
+    expect(errorsOf({ phone: '5512345678', originStoreId: 'store-1' })).toEqual([]);
+  });
+
+  it('rechaza un celular con lada o separadores', () => {
+    expect(errorsOf({ phone: '+525512345678', originStoreId: 'store-1' })).toContain('phone');
+    expect(errorsOf({ phone: '55-1234-5678', originStoreId: 'store-1' })).toContain('phone');
+  });
+
+  it('exige la tienda de alta', () => {
+    expect(errorsOf({ phone: '5512345678' })).toContain('originStoreId');
+    expect(errorsOf({ phone: '5512345678', originStoreId: '' })).toContain('originStoreId');
+  });
+
+  it('se exporta en el barrel', () => {
+    expect(RetailCustomer.EnsureCustomerByPhoneRequest).toBe(EnsureCustomerByPhoneRequest);
+  });
+});

package/_test_/unit/retailWizard/accessorySaleRequests.test.ts

@@ -0,0 +1,108 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { SendAccessoryOtpRequest } from '../../../src/retailWizard/dtos/requests/SendAccessoryOtpRequest';
+import { VerifyAccessoryOtpRequest } from '../../../src/retailWizard/dtos/requests/VerifyAccessoryOtpRequest';
+import { CreateAccessorySaleRequest } from '../../../src/retailWizard/dtos/requests/CreateAccessorySaleRequest';
+import { SaleChannelEnum } from '../../../src/retailWizard/enums/SaleChannelEnum';
+import { SalePaymentMethodEnum } from '../../../src/retailWizard/enums/SalePaymentMethodEnum';
+import * as RetailWizard from '../../../src/retailWizard';
+
+function errorsOf<T extends object>(cls: new () => T, payload: Record<string, unknown>): string[] {
+  const dto = plainToInstance(cls, payload, { excludeExtraneousValues: true });
+  return validateSync(dto).map((e) => e.property);
+}
+
+const validSale = {
+  otpChallengeId: 'chl-1',
+  lines: [{ sku: 'ACC-1', qty: 2 }],
+  paymentMethod: SalePaymentMethodEnum.CASH,
+  amountCents: 39800,
+  paymentDetail: { cashConfirmedInRegister: true },
+  privacyNoticeAccepted: true,
+  privacyNoticeVersion: 'AVISO-2026-10',
+};
+
+describe('SendAccessoryOtpRequest', () => {
+  it('acepta un celular de 10 dígitos', () => {
+    expect(errorsOf(SendAccessoryOtpRequest, { phone: '5512345678' })).toEqual([]);
+  });
+
+  it.each(['+525512345678', '55 1234 5678', '551234567', ''])('rechaza %p', (phone) => {
+    expect(errorsOf(SendAccessoryOtpRequest, { phone })).toContain('phone');
+  });
+});
+
+describe('VerifyAccessoryOtpRequest', () => {
+  it('acepta el código de 4 dígitos de messages-business', () => {
+    expect(errorsOf(VerifyAccessoryOtpRequest, { code: '1234' })).toEqual([]);
+  });
+
+  it('rechaza un código de 3 dígitos', () => {
+    expect(errorsOf(VerifyAccessoryOtpRequest, { code: '123' })).toContain('code');
+  });
+
+  it('rechaza un código ausente', () => {
+    expect(errorsOf(VerifyAccessoryOtpRequest, {})).toContain('code');
+  });
+});
+
+describe('CreateAccessorySaleRequest', () => {
+  it('acepta una venta válida', () => {
+    expect(errorsOf(CreateAccessorySaleRequest, validSale)).toEqual([]);
+  });
+
+  it('acepta piezas con identificadores', () => {
+    const payload = { ...validSale, lines: [{ sku: 'ACC-1', qty: 1, identifiers: ['SER-1'] }] };
+    expect(errorsOf(CreateAccessorySaleRequest, payload)).toEqual([]);
+  });
+
+  it('rechaza un carrito vacío', () => {
+    expect(errorsOf(CreateAccessorySaleRequest, { ...validSale, lines: [] })).toContain('lines');
+  });
+
+  it('rechaza una línea con qty 0', () => {
+    expect(errorsOf(CreateAccessorySaleRequest, { ...validSale, lines: [{ sku: 'ACC-1', qty: 0 }] })).toContain('lines');
+  });
+
+  it('rechaza un medio de pago fuera del enum', () => {
+    expect(errorsOf(CreateAccessorySaleRequest, { ...validSale, paymentMethod: 'WALLET' })).toContain('paymentMethod');
+  });
+
+  it('rechaza un monto negativo o decimal', () => {
+    expect(errorsOf(CreateAccessorySaleRequest, { ...validSale, amountCents: -1 })).toContain('amountCents');
+    expect(errorsOf(CreateAccessorySaleRequest, { ...validSale, amountCents: 10.5 })).toContain('amountCents');
+  });
+
+  it('exige el comprobante del cobro', () => {
+    const { paymentDetail: _omit, ...rest } = validSale;
+    expect(errorsOf(CreateAccessorySaleRequest, rest)).toContain('paymentDetail');
+  });
+
+  it('exige la versión del aviso de privacidad', () => {
+    expect(errorsOf(CreateAccessorySaleRequest, { ...validSale, privacyNoticeVersion: '' })).toContain('privacyNoticeVersion');
+  });
+
+  it('privacyNoticeAccepted no booleano → error de formato', () => {
+    expect(errorsOf(CreateAccessorySaleRequest, { ...validSale, privacyNoticeAccepted: 'si' })).toContain('privacyNoticeAccepted');
+  });
+
+  it('el medio WIRE (SPEI) es válido', () => {
+    expect(errorsOf(CreateAccessorySaleRequest, { ...validSale, paymentMethod: SalePaymentMethodEnum.WIRE })).toEqual([]);
+  });
+
+  it('exige el reto OTP', () => {
+    expect(errorsOf(CreateAccessorySaleRequest, { ...validSale, otpChallengeId: '' })).toContain('otpChallengeId');
+  });
+});
+
+describe('barrel retailWizard', () => {
+  it('exporta los contratos del cobro de accesorios', () => {
+    expect(RetailWizard.SendAccessoryOtpRequest).toBeDefined();
+    expect(RetailWizard.VerifyAccessoryOtpRequest).toBeDefined();
+    expect(RetailWizard.CreateAccessorySaleRequest).toBeDefined();
+    expect(RetailWizard.AccessorySaleLine).toBeDefined();
+    expect(RetailWizard.SaleChannelEnum.ACCESSORY_COUNTER).toBe('ACCESSORY_COUNTER');
+    expect(SaleChannelEnum.WIZARD).toBe('WIZARD');
+  });
+});

package/_test_/unit/retailWizard/cancelSaleConditions.test.ts

@@ -2,7 +2,7 @@ import 'reflect-metadata';
 import { plainToInstance, type ClassConstructor } from 'class-transformer';
 import { validateSync, type ValidationError } from 'class-validator';
 import { ReturnPieceCondition } from '../../../src/retailCatalog';
-import { BackofficeCancelSaleRequest, CancelSaleRequest } from '../../../src/retailWizard';
+import { BackofficeCancelSaleRequest, CancelSaleRequest, PortalCancelSaleRequest } from '../../../src/retailWizard';
 
 function paths(errors: ValidationError[], prefix = ''): string[] {
   return errors.flatMap((e) => {
@@ -23,6 +23,7 @@ const conditions = [
 describe.each([
   ['CancelSaleRequest', CancelSaleRequest, { reason: 'Cliente se arrepintió' }],
   ['BackofficeCancelSaleRequest', BackofficeCancelSaleRequest, { reason: 'Cliente se arrepintió' }],
+  ['PortalCancelSaleRequest', PortalCancelSaleRequest, { reason: 'Cliente se arrepintió' }],
 ] as const)('%s con condición por pieza', (_name, cls, base) => {
   it('sin returnConditions sigue validando', () => expect(errorsOf(cls, base)).toEqual([]));
   it('acepta condiciones y las hidrata aun con excludeExtraneousValues', () => {

package/_test_/unit/retailWizard/portalCancelSaleRequest.test.ts

@@ -0,0 +1,34 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { PortalCancelSaleRequest } from '../../../src/retailWizard';
+
+function errorsOf(payload: object): string[] {
+  const dto = plainToInstance(PortalCancelSaleRequest, payload, { excludeExtraneousValues: true });
+  return validateSync(dto).map((e) => e.property);
+}
+
+describe('PortalCancelSaleRequest', () => {
+  it('acepta motivo de 10 a 200 caracteres con el equipo confirmado', () => {
+    expect(errorsOf({ reason: 'Cliente se arrepintió', equipmentVerified: true })).toEqual([]);
+  });
+
+  it('exige el motivo con la misma longitud que la cancelación del Admin VL', () => {
+    expect(errorsOf({})).toContain('reason');
+    expect(errorsOf({ reason: 'corto' })).toContain('reason');
+    expect(errorsOf({ reason: 'x'.repeat(201) })).toContain('reason');
+  });
+
+  it('rechaza el string "false" como equipmentVerified', () => {
+    expect(errorsOf({ reason: 'Cliente se arrepintió', equipmentVerified: 'false' })).toContain('equipmentVerified');
+  });
+
+  it('no expone la excepción de cancelación tardía', () => {
+    const dto = plainToInstance(
+      PortalCancelSaleRequest,
+      { reason: 'Cliente se arrepintió', outOfWindowExceptionId: 'EXC-1' },
+      { excludeExtraneousValues: true },
+    );
+    expect(dto).not.toHaveProperty('outOfWindowExceptionId');
+  });
+});

package/bin/retailCustomer/dtos/requests/EnsureCustomerByPhoneRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * POST /private/customers/ensure-by-phone — da de alta al cliente solo con su celular verificado,
+ * o devuelve el que ya existe con ese número.
+ */
+export declare class EnsureCustomerByPhoneRequest {
+    phone: string;
+    /** Tienda del primer contacto; no cambia si el cliente ya existía. */
+    originStoreId: string;
+}

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

@@ -0,0 +1,34 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnsureCustomerByPhoneRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const regex_1 = require("../../../helpers/constans/regex");
+/**
+ * POST /private/customers/ensure-by-phone — da de alta al cliente solo con su celular verificado,
+ * o devuelve el que ya existe con ese número.
+ */
+class EnsureCustomerByPhoneRequest {
+}
+exports.EnsureCustomerByPhoneRequest = EnsureCustomerByPhoneRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(regex_1.regexPhoneMx, { message: 'phone debe tener 10 dígitos' }),
+    __metadata("design:type", String)
+], EnsureCustomerByPhoneRequest.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], EnsureCustomerByPhoneRequest.prototype, "originStoreId", void 0);

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

@@ -0,0 +1,5 @@
+import { CustomerResponse } from './CustomerResponse';
+/** Cliente resuelto por celular; `created` dice si esta llamada lo dio de alta. */
+export interface EnsureCustomerByPhoneResponse extends CustomerResponse {
+    created: boolean;
+}

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

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

package/bin/retailCustomer/index.d.ts

@@ -19,11 +19,13 @@ export * from './dtos/requests/KycReviewRequest';
 export * from './dtos/requests/WelcomeAccreditationRequest';
 export * from './dtos/requests/WelcomeAccreditationResultRequest';
 export * from './dtos/requests/UpsertPromotionBonusRequest';
+export * from './dtos/requests/EnsureCustomerByPhoneRequest';
 export * from './dtos/responses/CustomerResponse';
 export * from './dtos/responses/Customer360Response';
 export * from './dtos/responses/WelcomeBonusResponse';
 export * from './dtos/responses/WelcomeAccreditationResponse';
 export * from './dtos/responses/PromotionBonusEntryResponse';
+export * from './dtos/responses/EnsureCustomerByPhoneResponse';
 export * from './events/CustomerCreatedV1';
 export * from './events/CustomerUpdatedV1';
 export * from './events/CustomerKycVerifiedV1';

package/bin/retailCustomer/index.js

@@ -38,12 +38,14 @@ __exportStar(require("./dtos/requests/KycReviewRequest"), exports);
 __exportStar(require("./dtos/requests/WelcomeAccreditationRequest"), exports);
 __exportStar(require("./dtos/requests/WelcomeAccreditationResultRequest"), exports);
 __exportStar(require("./dtos/requests/UpsertPromotionBonusRequest"), exports);
+__exportStar(require("./dtos/requests/EnsureCustomerByPhoneRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/CustomerResponse"), exports);
 __exportStar(require("./dtos/responses/Customer360Response"), exports);
 __exportStar(require("./dtos/responses/WelcomeBonusResponse"), exports);
 __exportStar(require("./dtos/responses/WelcomeAccreditationResponse"), exports);
 __exportStar(require("./dtos/responses/PromotionBonusEntryResponse"), exports);
+__exportStar(require("./dtos/responses/EnsureCustomerByPhoneResponse"), exports);
 // Contratos de eventos (PascalCase + sufijo V1)
 __exportStar(require("./events/CustomerCreatedV1"), exports);
 __exportStar(require("./events/CustomerUpdatedV1"), exports);

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

@@ -0,0 +1,7 @@
+/** Línea del carrito de accesorios; el precio lo pone el catálogo, no el request. */
+export declare class AccessorySaleLine {
+    sku: string;
+    qty: number;
+    /** Serie de cada pieza cuando el SKU se rastrea por pieza; ausente si se rastrea por cantidad. */
+    identifiers?: string[];
+}

package/bin/retailWizard/dtos/AccessorySaleLine.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.AccessorySaleLine = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Línea del carrito de accesorios; el precio lo pone el catálogo, no el request. */
+class AccessorySaleLine {
+}
+exports.AccessorySaleLine = AccessorySaleLine;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], AccessorySaleLine.prototype, "sku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], AccessorySaleLine.prototype, "qty", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(100),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], AccessorySaleLine.prototype, "identifiers", void 0);

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

@@ -1,6 +1,7 @@
 import type { SaleTypeEnum } from '../enums/SaleTypeEnum';
 import type { SaleStatusEnum } from '../enums/SaleStatusEnum';
 import type { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+import type { SaleChannelEnum } from '../enums/SaleChannelEnum';
 import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
 import type { CentralSyncStatusEnum } from '../enums/CentralSyncStatusEnum';
 import type { SalePaymentDetail } from './SalePaymentDetail';
@@ -17,7 +18,10 @@ export interface Sale {
     storeId: string;
     sellerRetailUserId: string;
     retailCustomerId: string;
-    wizardSessionId: string;
+    /** Sesión del wizard que cerró la venta; ausente en la venta de mostrador. */
+    wizardSessionId?: string;
+    /** Canal de la venta; ausente = `WIZARD` (ventas anteriores al campo). */
+    saleChannel?: SaleChannelEnum;
     type: SaleTypeEnum;
     externalProvider: ExternalProviderEnum | null;
     /** SKU del teléfono de la venta; `null` en la venta sin teléfono (en DDB se omite). */

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

@@ -0,0 +1,18 @@
+import { SalePaymentMethodEnum } from '../../enums/SalePaymentMethodEnum';
+import { SalePaymentDetail } from '../SalePaymentDetail';
+import { AccessorySaleLine } from '../AccessorySaleLine';
+/**
+ * POST /wizard/accessory-sales — cierra la venta de mostrador con el celular ya verificado.
+ * `amountCents` es lo cobrado en caja y debe igualar la suma del catálogo.
+ */
+export declare class CreateAccessorySaleRequest {
+    otpChallengeId: string;
+    lines: AccessorySaleLine[];
+    paymentMethod: SalePaymentMethodEnum;
+    amountCents: number;
+    paymentDetail: SalePaymentDetail;
+    /** El cliente aceptó el aviso de privacidad; sin `true` el back responde 400 PRIVACY_NOTICE_REQUIRED. */
+    privacyNoticeAccepted?: boolean;
+    /** Versión del aviso de privacidad que se mostró. */
+    privacyNoticeVersion: string;
+}

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

@@ -0,0 +1,69 @@
+"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.CreateAccessorySaleRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SalePaymentMethodEnum_1 = require("../../enums/SalePaymentMethodEnum");
+const SalePaymentDetail_1 = require("../SalePaymentDetail");
+const AccessorySaleLine_1 = require("../AccessorySaleLine");
+/**
+ * POST /wizard/accessory-sales — cierra la venta de mostrador con el celular ya verificado.
+ * `amountCents` es lo cobrado en caja y debe igualar la suma del catálogo.
+ */
+class CreateAccessorySaleRequest {
+}
+exports.CreateAccessorySaleRequest = CreateAccessorySaleRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], CreateAccessorySaleRequest.prototype, "otpChallengeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(50),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => AccessorySaleLine_1.AccessorySaleLine),
+    __metadata("design:type", Array)
+], CreateAccessorySaleRequest.prototype, "lines", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(SalePaymentMethodEnum_1.SalePaymentMethodEnum),
+    __metadata("design:type", String)
+], CreateAccessorySaleRequest.prototype, "paymentMethod", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], CreateAccessorySaleRequest.prototype, "amountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => SalePaymentDetail_1.SalePaymentDetail),
+    __metadata("design:type", SalePaymentDetail_1.SalePaymentDetail)
+], CreateAccessorySaleRequest.prototype, "paymentDetail", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CreateAccessorySaleRequest.prototype, "privacyNoticeAccepted", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], CreateAccessorySaleRequest.prototype, "privacyNoticeVersion", void 0);

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

@@ -0,0 +1,12 @@
+import { ReturnPieceCondition } from '../../../retailCatalog/dtos/requests/ReturnPieceCondition';
+/**
+ * POST /portal/sales/:saleId/cancel — el vendedor cancela una venta cerrada de su tienda, dentro de la
+ * ventana. Mismas validaciones que `BackofficeCancelSaleRequest`, sin la excepción de cancelación tardía.
+ */
+export declare class PortalCancelSaleRequest {
+    reason: string;
+    /** Equipo o piezas confirmados en tienda; ausente cuenta como no confirmado. */
+    equipmentVerified?: boolean;
+    /** Condición de cada pieza que regresa al inventario; las no listadas vuelven GOOD. */
+    returnConditions?: ReturnPieceCondition[];
+}

package/bin/retailWizard/dtos/requests/PortalCancelSaleRequest.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.PortalCancelSaleRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ReturnPieceCondition_1 = require("../../../retailCatalog/dtos/requests/ReturnPieceCondition");
+/**
+ * POST /portal/sales/:saleId/cancel — el vendedor cancela una venta cerrada de su tienda, dentro de la
+ * ventana. Mismas validaciones que `BackofficeCancelSaleRequest`, sin la excepción de cancelación tardía.
+ */
+class PortalCancelSaleRequest {
+}
+exports.PortalCancelSaleRequest = PortalCancelSaleRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(10),
+    (0, class_validator_1.MaxLength)(200),
+    __metadata("design:type", String)
+], PortalCancelSaleRequest.prototype, "reason", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], PortalCancelSaleRequest.prototype, "equipmentVerified", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ReturnPieceCondition_1.ReturnPieceCondition),
+    __metadata("design:type", Array)
+], PortalCancelSaleRequest.prototype, "returnConditions", void 0);

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

@@ -0,0 +1,4 @@
+/** POST /wizard/accessory-sales/otp — manda el OTP al celular del cliente del mostrador. */
+export declare class SendAccessoryOtpRequest {
+    phone: string;
+}

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

@@ -0,0 +1,25 @@
+"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.SendAccessoryOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const regex_1 = require("../../../helpers/constans/regex");
+/** POST /wizard/accessory-sales/otp — manda el OTP al celular del cliente del mostrador. */
+class SendAccessoryOtpRequest {
+}
+exports.SendAccessoryOtpRequest = SendAccessoryOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(regex_1.regexPhoneMx, { message: 'phone debe tener 10 dígitos' }),
+    __metadata("design:type", String)
+], SendAccessoryOtpRequest.prototype, "phone", void 0);

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

@@ -0,0 +1,4 @@
+/** POST /wizard/accessory-sales/otp/{otpChallengeId}/verify — código que dicta el cliente. */
+export declare class VerifyAccessoryOtpRequest {
+    code: string;
+}

package/bin/retailWizard/dtos/requests/VerifyAccessoryOtpRequest.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.VerifyAccessoryOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** POST /wizard/accessory-sales/otp/{otpChallengeId}/verify — código que dicta el cliente. */
+class VerifyAccessoryOtpRequest {
+}
+exports.VerifyAccessoryOtpRequest = VerifyAccessoryOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(4, 8),
+    __metadata("design:type", String)
+], VerifyAccessoryOtpRequest.prototype, "code", void 0);

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

@@ -0,0 +1,7 @@
+/** Reto OTP del mostrador de accesorios (send y resend). `phoneMasked` muestra solo los últimos 4 dígitos. */
+export interface AccessoryOtpChallenge {
+    otpChallengeId: string;
+    phoneMasked: string;
+    expiresAt: string;
+    resendAvailableAt: string;
+}

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

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

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

@@ -0,0 +1,7 @@
+/** Reto verificado: ampara una sola venta hasta `usableUntil`. */
+export interface VerifyAccessoryOtpResponse {
+    otpChallengeId: string;
+    verified: true;
+    verifiedAt: string;
+    usableUntil: string;
+}

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

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

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

@@ -0,0 +1,5 @@
+/** Canal por el que se cerró la venta: el wizard por sesión o el mostrador de accesorios. */
+export declare enum SaleChannelEnum {
+    WIZARD = "WIZARD",
+    ACCESSORY_COUNTER = "ACCESSORY_COUNTER"
+}

package/bin/retailWizard/enums/SaleChannelEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaleChannelEnum = void 0;
+/** Canal por el que se cerró la venta: el wizard por sesión o el mostrador de accesorios. */
+var SaleChannelEnum;
+(function (SaleChannelEnum) {
+    SaleChannelEnum["WIZARD"] = "WIZARD";
+    SaleChannelEnum["ACCESSORY_COUNTER"] = "ACCESSORY_COUNTER";
+})(SaleChannelEnum || (exports.SaleChannelEnum = SaleChannelEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -29,6 +29,7 @@ export * from './enums/WizardLineStatusEnum';
 export * from './enums/LinePaymentTypeEnum';
 export * from './enums/WizardLineRoleEnum';
 export * from './enums/EmailStateEnum';
+export * from './enums/SaleChannelEnum';
 export * from './dtos/WizardConsents';
 export * from './dtos/WizardPayment';
 export * from './dtos/WizardProduct';
@@ -52,6 +53,7 @@ export * from './dtos/WizardFinancingPreview';
 export * from './dtos/WizardReservedLine';
 export * from './dtos/WizardGiftLine';
 export * from './dtos/SaleLine';
+export * from './dtos/AccessorySaleLine';
 export * from './dtos/WizardSession';
 export * from './dtos/OtpVerification';
 export * from './dtos/Sale';
@@ -97,6 +99,9 @@ export * from './dtos/requests/CompleteSaleRequest';
 export * from './dtos/requests/SuggestIdentifiersQuery';
 export * from './dtos/requests/SendEmailOtpRequest';
 export * from './dtos/requests/VerifyEmailOtpRequest';
+export * from './dtos/requests/SendAccessoryOtpRequest';
+export * from './dtos/requests/VerifyAccessoryOtpRequest';
+export * from './dtos/requests/CreateAccessorySaleRequest';
 export * from './dtos/responses/KycPrepareResponse';
 export * from './dtos/responses/ProofOfAddressPrepareResponse';
 export * from './dtos/responses/SessionFinanciersResponse';
@@ -115,6 +120,8 @@ export * from './dtos/responses/ProspectResumeResponse';
 export * from './dtos/responses/CancelOtherStoreSaleResponse';
 export * from './dtos/responses/ProspectByPhoneResponse';
 export * from './dtos/responses/AppOnboardingResponse';
+export * from './dtos/responses/AccessoryOtpChallenge';
+export * from './dtos/responses/VerifyAccessoryOtpResponse';
 export * from './enums/SaleFinancierEnum';
 export * from './enums/SaleExceptionTypeEnum';
 export * from './enums/SaleExceptionStatusEnum';
@@ -138,6 +145,7 @@ export * from './dtos/requests/ApplySaleExceptionRequest';
 export * from './dtos/requests/AddSaleExceptionNoteRequest';
 export * from './dtos/requests/RunSalesReportRequest';
 export * from './dtos/requests/BackofficeCancelSaleRequest';
+export * from './dtos/requests/PortalCancelSaleRequest';
 export * from './dtos/responses/BackofficeSalesStatsResponse';
 export * from './dtos/responses/BackofficeSalesKpisResponse';
 export * from './dtos/responses/BackofficeReportsResponse';

package/bin/retailWizard/index.js

@@ -48,6 +48,7 @@ __exportStar(require("./enums/WizardLineStatusEnum"), exports);
 __exportStar(require("./enums/LinePaymentTypeEnum"), exports);
 __exportStar(require("./enums/WizardLineRoleEnum"), exports);
 __exportStar(require("./enums/EmailStateEnum"), exports);
+__exportStar(require("./enums/SaleChannelEnum"), exports);
 // DTOs anidados
 __exportStar(require("./dtos/WizardConsents"), exports);
 __exportStar(require("./dtos/WizardPayment"), exports);
@@ -74,6 +75,7 @@ __exportStar(require("./dtos/WizardFinancingPreview"), exports);
 __exportStar(require("./dtos/WizardReservedLine"), exports);
 __exportStar(require("./dtos/WizardGiftLine"), exports);
 __exportStar(require("./dtos/SaleLine"), exports);
+__exportStar(require("./dtos/AccessorySaleLine"), exports);
 // Entidades principales (shapes de estado/persistencia — planas)
 __exportStar(require("./dtos/WizardSession"), exports);
 __exportStar(require("./dtos/OtpVerification"), exports);
@@ -122,6 +124,9 @@ __exportStar(require("./dtos/requests/CompleteSaleRequest"), exports);
 __exportStar(require("./dtos/requests/SuggestIdentifiersQuery"), exports);
 __exportStar(require("./dtos/requests/SendEmailOtpRequest"), exports);
 __exportStar(require("./dtos/requests/VerifyEmailOtpRequest"), exports);
+__exportStar(require("./dtos/requests/SendAccessoryOtpRequest"), exports);
+__exportStar(require("./dtos/requests/VerifyAccessoryOtpRequest"), exports);
+__exportStar(require("./dtos/requests/CreateAccessorySaleRequest"), exports);
 // Response DTOs (output tipado por endpoint)
 __exportStar(require("./dtos/responses/KycPrepareResponse"), exports);
 __exportStar(require("./dtos/responses/ProofOfAddressPrepareResponse"), exports);
@@ -141,6 +146,8 @@ __exportStar(require("./dtos/responses/ProspectResumeResponse"), exports);
 __exportStar(require("./dtos/responses/CancelOtherStoreSaleResponse"), exports);
 __exportStar(require("./dtos/responses/ProspectByPhoneResponse"), exports);
 __exportStar(require("./dtos/responses/AppOnboardingResponse"), exports);
+__exportStar(require("./dtos/responses/AccessoryOtpChallenge"), exports);
+__exportStar(require("./dtos/responses/VerifyAccessoryOtpResponse"), exports);
 // ── F3 · Backoffice VentasLuga ────────────────────────────────────────────────
 // Enums
 __exportStar(require("./enums/SaleFinancierEnum"), exports);
@@ -169,6 +176,7 @@ __exportStar(require("./dtos/requests/ApplySaleExceptionRequest"), exports);
 __exportStar(require("./dtos/requests/AddSaleExceptionNoteRequest"), exports);
 __exportStar(require("./dtos/requests/RunSalesReportRequest"), exports);
 __exportStar(require("./dtos/requests/BackofficeCancelSaleRequest"), exports);
+__exportStar(require("./dtos/requests/PortalCancelSaleRequest"), exports);
 // Responses
 __exportStar(require("./dtos/responses/BackofficeSalesStatsResponse"), exports);
 __exportStar(require("./dtos/responses/BackofficeSalesKpisResponse"), exports);

package/package.json

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

package/src/retailCustomer/dtos/requests/EnsureCustomerByPhoneRequest.ts

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { IsString, Matches, MinLength } from 'class-validator';
+import { regexPhoneMx } from '../../../helpers/constans/regex';
+
+/**
+ * POST /private/customers/ensure-by-phone — da de alta al cliente solo con su celular verificado,
+ * o devuelve el que ya existe con ese número.
+ */
+export class EnsureCustomerByPhoneRequest {
+    @Expose()
+    @IsString()
+    @Matches(regexPhoneMx, { message: 'phone debe tener 10 dígitos' })
+    phone!: string;
+
+    /** Tienda del primer contacto; no cambia si el cliente ya existía. */
+    @Expose()
+    @IsString()
+    @MinLength(1)
+    originStoreId!: string;
+}

package/src/retailCustomer/dtos/responses/EnsureCustomerByPhoneResponse.ts

@@ -0,0 +1,6 @@
+import { CustomerResponse } from './CustomerResponse';
+
+/** Cliente resuelto por celular; `created` dice si esta llamada lo dio de alta. */
+export interface EnsureCustomerByPhoneResponse extends CustomerResponse {
+    created: boolean;
+}

package/src/retailCustomer/index.ts

@@ -24,6 +24,7 @@ export * from './dtos/requests/KycReviewRequest';
 export * from './dtos/requests/WelcomeAccreditationRequest';
 export * from './dtos/requests/WelcomeAccreditationResultRequest';
 export * from './dtos/requests/UpsertPromotionBonusRequest';
+export * from './dtos/requests/EnsureCustomerByPhoneRequest';
 
 // Response DTOs
 export * from './dtos/responses/CustomerResponse';
@@ -31,6 +32,7 @@ export * from './dtos/responses/Customer360Response';
 export * from './dtos/responses/WelcomeBonusResponse';
 export * from './dtos/responses/WelcomeAccreditationResponse';
 export * from './dtos/responses/PromotionBonusEntryResponse';
+export * from './dtos/responses/EnsureCustomerByPhoneResponse';
 
 // Contratos de eventos (PascalCase + sufijo V1)
 export * from './events/CustomerCreatedV1';

package/src/retailWizard/dtos/AccessorySaleLine.ts

@@ -0,0 +1,23 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsInt, IsOptional, IsString, Min, MinLength } from 'class-validator';
+
+/** Línea del carrito de accesorios; el precio lo pone el catálogo, no el request. */
+export class AccessorySaleLine {
+  @Expose()
+  @IsString()
+  @MinLength(1)
+  sku!: string;
+
+  @Expose()
+  @IsInt()
+  @Min(1)
+  qty!: number;
+
+  /** Serie de cada pieza cuando el SKU se rastrea por pieza; ausente si se rastrea por cantidad. */
+  @Expose()
+  @IsOptional()
+  @IsArray()
+  @ArrayMaxSize(100)
+  @IsString({ each: true })
+  identifiers?: string[];
+}

package/src/retailWizard/dtos/Sale.ts

@@ -1,6 +1,7 @@
 import type { SaleTypeEnum } from '../enums/SaleTypeEnum';
 import type { SaleStatusEnum } from '../enums/SaleStatusEnum';
 import type { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+import type { SaleChannelEnum } from '../enums/SaleChannelEnum';
 import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
 import type { CentralSyncStatusEnum } from '../enums/CentralSyncStatusEnum';
 import type { SalePaymentDetail } from './SalePaymentDetail';
@@ -18,7 +19,10 @@ export interface Sale {
   storeId: string;
   sellerRetailUserId: string;
   retailCustomerId: string;
-  wizardSessionId: string;
+  /** Sesión del wizard que cerró la venta; ausente en la venta de mostrador. */
+  wizardSessionId?: string;
+  /** Canal de la venta; ausente = `WIZARD` (ventas anteriores al campo). */
+  saleChannel?: SaleChannelEnum;
   type: SaleTypeEnum;
   externalProvider: ExternalProviderEnum | null;
   /** SKU del teléfono de la venta; `null` en la venta sin teléfono (en DDB se omite). */

package/src/retailWizard/dtos/requests/CreateAccessorySaleRequest.ts

@@ -0,0 +1,64 @@
+import { Expose, Type } from 'class-transformer';
+import {
+  ArrayMaxSize,
+  ArrayMinSize,
+  IsArray,
+  IsBoolean,
+  IsDefined,
+  IsEnum,
+  IsInt,
+  IsOptional,
+  IsString,
+  Min,
+  MinLength,
+  ValidateNested,
+} from 'class-validator';
+import { SalePaymentMethodEnum } from '../../enums/SalePaymentMethodEnum';
+import { SalePaymentDetail } from '../SalePaymentDetail';
+import { AccessorySaleLine } from '../AccessorySaleLine';
+
+/**
+ * POST /wizard/accessory-sales — cierra la venta de mostrador con el celular ya verificado.
+ * `amountCents` es lo cobrado en caja y debe igualar la suma del catálogo.
+ */
+export class CreateAccessorySaleRequest {
+  @Expose()
+  @IsString()
+  @MinLength(1)
+  otpChallengeId!: string;
+
+  @Expose()
+  @IsArray()
+  @ArrayMinSize(1)
+  @ArrayMaxSize(50)
+  @ValidateNested({ each: true })
+  @Type(() => AccessorySaleLine)
+  lines!: AccessorySaleLine[];
+
+  @Expose()
+  @IsEnum(SalePaymentMethodEnum)
+  paymentMethod!: SalePaymentMethodEnum;
+
+  @Expose()
+  @IsInt()
+  @Min(0)
+  amountCents!: number;
+
+  @Expose()
+  @IsDefined()
+  @ValidateNested()
+  @Type(() => SalePaymentDetail)
+  paymentDetail!: SalePaymentDetail;
+
+  /** El cliente aceptó el aviso de privacidad; sin `true` el back responde 400 PRIVACY_NOTICE_REQUIRED. */
+  @Expose()
+  @IsOptional()
+  @IsBoolean()
+  privacyNoticeAccepted?: boolean;
+
+  /** Versión del aviso de privacidad que se mostró. */
+  @Expose()
+  @IsString()
+  @MinLength(1)
+  privacyNoticeVersion!: string;
+}

package/src/retailWizard/dtos/requests/PortalCancelSaleRequest.ts

@@ -0,0 +1,29 @@
+import { Expose, Type } from 'class-transformer';
+import { IsArray, IsBoolean, IsOptional, IsString, MaxLength, MinLength, ValidateNested } from 'class-validator';
+import { ReturnPieceCondition } from '../../../retailCatalog/dtos/requests/ReturnPieceCondition';
+
+/**
+ * POST /portal/sales/:saleId/cancel — el vendedor cancela una venta cerrada de su tienda, dentro de la
+ * ventana. Mismas validaciones que `BackofficeCancelSaleRequest`, sin la excepción de cancelación tardía.
+ */
+export class PortalCancelSaleRequest {
+    @Expose()
+    @IsString()
+    @MinLength(10)
+    @MaxLength(200)
+    reason!: string;
+
+    /** Equipo o piezas confirmados en tienda; ausente cuenta como no confirmado. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    equipmentVerified?: boolean;
+
+    /** Condición de cada pieza que regresa al inventario; las no listadas vuelven GOOD. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => ReturnPieceCondition)
+    returnConditions?: ReturnPieceCondition[];
+}

package/src/retailWizard/dtos/requests/SendAccessoryOtpRequest.ts

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsString, Matches } from 'class-validator';
+import { regexPhoneMx } from '../../../helpers/constans/regex';
+
+/** POST /wizard/accessory-sales/otp — manda el OTP al celular del cliente del mostrador. */
+export class SendAccessoryOtpRequest {
+  @Expose()
+  @IsString()
+  @Matches(regexPhoneMx, { message: 'phone debe tener 10 dígitos' })
+  phone!: string;
+}

package/src/retailWizard/dtos/requests/VerifyAccessoryOtpRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsString, Length } from 'class-validator';
+
+/** POST /wizard/accessory-sales/otp/{otpChallengeId}/verify — código que dicta el cliente. */
+export class VerifyAccessoryOtpRequest {
+  @Expose()
+  @IsString()
+  @Length(4, 8)
+  code!: string;
+}

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

@@ -0,0 +1,7 @@
+/** Reto OTP del mostrador de accesorios (send y resend). `phoneMasked` muestra solo los últimos 4 dígitos. */
+export interface AccessoryOtpChallenge {
+  otpChallengeId: string;
+  phoneMasked: string;
+  expiresAt: string;
+  resendAvailableAt: string;
+}

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

@@ -0,0 +1,7 @@
+/** Reto verificado: ampara una sola venta hasta `usableUntil`. */
+export interface VerifyAccessoryOtpResponse {
+  otpChallengeId: string;
+  verified: true;
+  verifiedAt: string;
+  usableUntil: string;
+}

package/src/retailWizard/enums/SaleChannelEnum.ts

@@ -0,0 +1,5 @@
+/** Canal por el que se cerró la venta: el wizard por sesión o el mostrador de accesorios. */
+export enum SaleChannelEnum {
+    WIZARD = 'WIZARD',
+    ACCESSORY_COUNTER = 'ACCESSORY_COUNTER',
+}

package/src/retailWizard/index.ts

@@ -32,6 +32,7 @@ export * from './enums/WizardLineStatusEnum';
 export * from './enums/LinePaymentTypeEnum';
 export * from './enums/WizardLineRoleEnum';
 export * from './enums/EmailStateEnum';
+export * from './enums/SaleChannelEnum';
 
 // DTOs anidados
 export * from './dtos/WizardConsents';
@@ -57,6 +58,7 @@ export * from './dtos/WizardFinancingPreview';
 export * from './dtos/WizardReservedLine';
 export * from './dtos/WizardGiftLine';
 export * from './dtos/SaleLine';
+export * from './dtos/AccessorySaleLine';
 
 // Entidades principales (shapes de estado/persistencia — planas)
 export * from './dtos/WizardSession';
@@ -108,6 +110,9 @@ export * from './dtos/requests/CompleteSaleRequest';
 export * from './dtos/requests/SuggestIdentifiersQuery';
 export * from './dtos/requests/SendEmailOtpRequest';
 export * from './dtos/requests/VerifyEmailOtpRequest';
+export * from './dtos/requests/SendAccessoryOtpRequest';
+export * from './dtos/requests/VerifyAccessoryOtpRequest';
+export * from './dtos/requests/CreateAccessorySaleRequest';
 
 // Response DTOs (output tipado por endpoint)
 export * from './dtos/responses/KycPrepareResponse';
@@ -128,6 +133,8 @@ export * from './dtos/responses/ProspectResumeResponse';
 export * from './dtos/responses/CancelOtherStoreSaleResponse';
 export * from './dtos/responses/ProspectByPhoneResponse';
 export * from './dtos/responses/AppOnboardingResponse';
+export * from './dtos/responses/AccessoryOtpChallenge';
+export * from './dtos/responses/VerifyAccessoryOtpResponse';
 
 // ── F3 · Backoffice VentasLuga ────────────────────────────────────────────────
 // Enums
@@ -160,6 +167,7 @@ export * from './dtos/requests/ApplySaleExceptionRequest';
 export * from './dtos/requests/AddSaleExceptionNoteRequest';
 export * from './dtos/requests/RunSalesReportRequest';
 export * from './dtos/requests/BackofficeCancelSaleRequest';
+export * from './dtos/requests/PortalCancelSaleRequest';
 
 // Responses
 export * from './dtos/responses/BackofficeSalesStatsResponse';