@fiado/type-kit 3.538.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/index.d.ts

@@ -127,3 +127,4 @@ export * as Rewards from './rewards';
 export * as RewardsEligibility from './rewardsEligibility';
 export * as DatalakeReports from './datalakeReports';
 export * as PdfRender from './pdfRender';
+export * as Rules from './rules';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.MessageMoments = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
 exports.RetailCustomer = exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.WhatsappConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.UsMarketGrowthBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = void 0;
-exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = void 0;
+exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -249,3 +249,5 @@ exports.RewardsEligibility = __importStar(require("./rewardsEligibility"));
 exports.DatalakeReports = __importStar(require("./datalakeReports"));
 // PdfRender: DTOs del lambda pdf-render-business (plantilla HTML → PDF multitenant y su backoffice).
 exports.PdfRender = __importStar(require("./pdfRender"));
+// Rules: DTOs del lambda central rules-business (catálogo, validación, generación con IA y evaluación de reglas).
+exports.Rules = __importStar(require("./rules"));

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 = {}));