@fiado/type-kit 3.472.0 → 3.474.0

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

@@ -0,0 +1,99 @@
+import 'reflect-metadata';
+import {
+  LinePaymentTypeEnum,
+  WizardLineRoleEnum,
+  WizardLineStatusEnum,
+  type Sale,
+  type SaleLine,
+  type WizardFinancingPreview,
+  type WizardLinePromotionFields,
+  type WizardReservedLine,
+  type WizardSession,
+} from '../../../src/retailWizard';
+
+const promoFields: WizardLinePromotionFields = {
+  role: WizardLineRoleEnum.GIFT,
+  promotionId: 'promo-1',
+  promotionVersion: 3,
+  linkedLineId: 'L1',
+  discountCode: 'VERANO',
+  discountCents: 50000,
+  originalPriceCents: 35000,
+};
+
+describe('WizardLineRoleEnum', () => {
+  it('solo trae GIFT; sin role es una línea normal', () => {
+    expect(Object.values(WizardLineRoleEnum)).toEqual(['GIFT']);
+  });
+});
+
+describe('línea de sesión con reparto y campos de Promociones', () => {
+  it('acepta financedCents y los 7 campos opcionales', () => {
+    const line: WizardReservedLine = {
+      lineId: 'L2',
+      sku: 'CASE-1',
+      qty: 1,
+      status: WizardLineStatusEnum.RESERVED,
+      reservationId: 'r-2',
+      expiresAt: '2026-09-28T20:30:00.000Z',
+      basePriceCents: 0,
+      listPriceCents: 35000,
+      priceSk: 'p',
+      eligibleFinanciers: [],
+      financeable: false,
+      paymentType: LinePaymentTypeEnum.CASH,
+      sellItemCost: 1,
+      financedCents: 0,
+      ...promoFields,
+    };
+    expect(line.role).toBe('GIFT');
+    expect(line.financedCents).toBe(0);
+  });
+});
+
+describe('línea de venta con reparto y campos de Promociones', () => {
+  it('acepta financedCents y los 7 campos opcionales', () => {
+    const line: SaleLine = {
+      lineId: 'L1',
+      sku: 'PHONE-1',
+      qty: 1,
+      basePriceCents: 349900,
+      listPriceCents: 349900,
+      priceSk: 'p',
+      paymentType: LinePaymentTypeEnum.CREDIT,
+      components: [{ sku: 'PHONE-1', qty: 1, identifiers: ['356938035643809'] }],
+      financedCents: 299900,
+      ...promoFields,
+      role: undefined,
+    };
+    expect(line.discountCents).toBe(50000);
+  });
+});
+
+describe('sesión de la saga', () => {
+  it('acepta piecesHeldAt, financingPreview, promo de venta y refundPendingCents', () => {
+    const preview: WizardFinancingPreview = { capCents: 89970, lines: [{ lineId: 'L2', financedCents: 35000 }] };
+    const session: Pick<
+      WizardSession,
+      'piecesHeldAt' | 'financingPreview' | 'salePromotionId' | 'salePromotionVersion' | 'refundPendingCents'
+    > = {
+      piecesHeldAt: '2026-09-28T20:00:00.000Z',
+      financingPreview: preview,
+      salePromotionId: null,
+      salePromotionVersion: null,
+      refundPendingCents: 150000,
+    };
+    expect(session.financingPreview?.lines[0].financedCents).toBe(35000);
+  });
+});
+
+describe('venta de la saga', () => {
+  it('acepta promo de venta e inventoryViaQueue', () => {
+    const sale: Pick<Sale, 'salePromotionId' | 'salePromotionVersion' | 'inventoryViaQueue'> = {
+      salePromotionId: 'sp-1',
+      salePromotionVersion: 2,
+      inventoryViaQueue: true,
+    };
+    expect(sale.inventoryViaQueue).toBe(true);
+  });
+});

package/bin/index.d.ts

@@ -97,6 +97,7 @@ export * as RetailCatalog from './retailCatalog';
 export * as RetailCards from './retailCards';
 export * as RetailCustomer from './retailCustomer';
 export * as RetailWizard from './retailWizard';
+export * as RetailPromotions from './retailPromotions';
 export * as DatalakeQuery from './datalakeQuery';
 export * as LoanConfig from './loanConfig';
 export * as Shortlink from './shortlink';

package/bin/index.js

@@ -37,8 +37,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IssuanceBusiness = 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.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.DatalakeQuery = exports.RetailWizard = 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.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 = void 0;
-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 = void 0;
+exports.RetailPromotions = exports.RetailWizard = 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.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 = void 0;
+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 = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -163,6 +163,9 @@ exports.RetailCustomer = __importStar(require("./retailCustomer"));
 // RetailWizard: DTOs/enums del lambda retail-wizard-business (comp 04 — wizard de venta de contado:
 // saga de sesión, OTP, KYC, venta y prospectos; SureKeep Fase 2 — pista Retail).
 exports.RetailWizard = __importStar(require("./retailWizard"));
+// RetailPromotions: DTOs/enums de retail-promotions-business (promos de venta, códigos de descuento y
+// cupones de VentasLuga). Porcentajes en puntos base, dinero en centavos.
+exports.RetailPromotions = __importStar(require("./retailPromotions"));
 exports.DatalakeQuery = __importStar(require("./datalakeQuery"));
 // LoanConfig: DTOs/enums del lambda loan-config-business (comp 09 — parámetros operativos del SOFOM).
 exports.LoanConfig = __importStar(require("./loanConfig"));

package/bin/retailCatalog/dtos/Product.d.ts

@@ -3,6 +3,7 @@ import { MdmProviderEnum } from '../enums/MdmProviderEnum';
 import { ProductStatusEnum } from '../enums/ProductStatusEnum';
 import { ProductTierEnum } from '../enums/ProductTierEnum';
 import { ProductCategoryEnum } from '../enums/ProductCategoryEnum';
+import { AccessorySubcategoryEnum } from '../enums/AccessorySubcategoryEnum';
 import { TrackingModeEnum } from '../enums/TrackingModeEnum';
 import { ItemTypeEnum } from '../enums/ItemTypeEnum';
 import { ProductComponent } from './ProductComponent';
@@ -37,6 +38,8 @@ export declare class Product {
     createdAt: string;
     updatedAt: string;
     category?: ProductCategoryEnum;
+    /** Solo en ACCESSORY. */
+    accessorySubcategory?: AccessorySubcategoryEnum;
     trackingMode?: TrackingModeEnum;
     /** Se puede vender suelto (fuera de un kit). */
     sellable?: boolean;
@@ -48,4 +51,10 @@ export declare class Product {
     currentPriceSk?: string | null;
     /** Producto físico o servicio; inmutable tras el alta. Ausente = PRODUCT. */
     itemType?: ItemTypeEnum;
+    /** Prioridad de venta 0–100; «Recomendados» ordena por ella. */
+    salePriority?: number;
+    highlights?: string[];
+    warrantyMonths?: number;
+    /** Fecha ISO 8601. */
+    launchDate?: string;
 }

package/bin/retailCatalog/dtos/requests/BackofficeCreateProductRequest.d.ts

@@ -1,4 +1,5 @@
 import { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import { AccessorySubcategoryEnum } from '../../enums/AccessorySubcategoryEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { TrackingModeEnum } from '../../enums/TrackingModeEnum';
 import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
@@ -8,6 +9,8 @@ export declare class BackofficeCreateProductRequest {
     sku: string;
     /** El kit (BUNDLE) se da de alta en backofficeCreateKit. */
     category: ProductCategoryEnum;
+    /** Solo en ACCESSORY. */
+    accessorySubcategory?: AccessorySubcategoryEnum;
     /** Inmutable tras el alta. */
     trackingMode: TrackingModeEnum;
     sellable: boolean;
@@ -27,4 +30,13 @@ export declare class BackofficeCreateProductRequest {
     mdmEnabled?: boolean;
     mdmProvider?: MdmProviderEnum | null;
     mdmLockMode?: MdmLockModeEnum | null;
+    /** Prioridad de venta: 100 sale primero en «Recomendados». */
+    salePriority?: number;
+    highlights?: string[];
+    /** 0 = sin garantía. */
+    warrantyMonths?: number;
+    /** Fecha ISO 8601. */
+    launchDate?: string;
+    /** Ficha técnica como mapa clave/valor, igual que Product.specs. */
+    specs?: Record<string, unknown>;
 }

package/bin/retailCatalog/dtos/requests/BackofficeCreateProductRequest.js

@@ -14,6 +14,7 @@ const class_validator_1 = require("class-validator");
 const SkuPattern_1 = require("../../constants/SkuPattern");
 const NonBundleCategories_1 = require("../../constants/NonBundleCategories");
 const ProductCategoryEnum_1 = require("../../enums/ProductCategoryEnum");
+const AccessorySubcategoryEnum_1 = require("../../enums/AccessorySubcategoryEnum");
 const ProductTierEnum_1 = require("../../enums/ProductTierEnum");
 const TrackingModeEnum_1 = require("../../enums/TrackingModeEnum");
 const MdmLockModeEnum_1 = require("../../enums/MdmLockModeEnum");
@@ -33,6 +34,11 @@ __decorate([
     (0, class_validator_1.IsIn)(NonBundleCategories_1.NON_BUNDLE_CATEGORIES),
     __metadata("design:type", String)
 ], BackofficeCreateProductRequest.prototype, "category", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(AccessorySubcategoryEnum_1.AccessorySubcategoryEnum),
+    __metadata("design:type", String)
+], BackofficeCreateProductRequest.prototype, "accessorySubcategory", void 0);
 __decorate([
     (0, class_validator_1.IsEnum)(TrackingModeEnum_1.TrackingModeEnum),
     __metadata("design:type", String)
@@ -115,3 +121,33 @@ __decorate([
     (0, class_validator_1.IsEnum)(MdmLockModeEnum_1.MdmLockModeEnum),
     __metadata("design:type", String)
 ], BackofficeCreateProductRequest.prototype, "mdmLockMode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], BackofficeCreateProductRequest.prototype, "salePriority", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.Matches)(/\S/, { each: true }),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], BackofficeCreateProductRequest.prototype, "highlights", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], BackofficeCreateProductRequest.prototype, "warrantyMonths", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], BackofficeCreateProductRequest.prototype, "launchDate", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], BackofficeCreateProductRequest.prototype, "specs", void 0);

package/bin/retailCatalog/dtos/requests/BackofficeRegisterAdjustmentRequest.d.ts

@@ -9,4 +9,6 @@ export declare class BackofficeRegisterAdjustmentRequest {
     reason: InventoryMovementReasonEnum;
     /** IMEI o serie de cada pieza; ausente si el SKU se rastrea por cantidad. */
     identifiers?: string[];
+    /** movementId del MOV# que este ajuste corrige; el catálogo responde 404 si no existe. */
+    reversesMovementId?: string;
 }

package/bin/retailCatalog/dtos/requests/BackofficeRegisterAdjustmentRequest.js

@@ -47,3 +47,9 @@ __decorate([
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
 ], BackofficeRegisterAdjustmentRequest.prototype, "identifiers", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Matches)(/^\S+$/),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], BackofficeRegisterAdjustmentRequest.prototype, "reversesMovementId", void 0);

package/bin/retailCatalog/dtos/requests/BackofficeUpdateProductRequest.d.ts

@@ -1,4 +1,5 @@
 import { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import { AccessorySubcategoryEnum } from '../../enums/AccessorySubcategoryEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { ProductComponent } from '../ProductComponent';
 import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
@@ -6,6 +7,8 @@ import { MdmProviderEnum } from '../../enums/MdmProviderEnum';
 /** Body de PATCH /backoffice/inventory/skus/{sku} (backofficeUpdateProduct); parcial, sin itemType ni trackingMode (inmutables) ni precio. */
 export declare class BackofficeUpdateProductRequest {
     category?: ProductCategoryEnum;
+    /** Solo en ACCESSORY. */
+    accessorySubcategory?: AccessorySubcategoryEnum;
     sellable?: boolean;
     showInSalesFlow?: boolean;
     /** Solo en kits; reemplaza la lista completa sin tocar los apartados vivos. */
@@ -24,4 +27,13 @@ export declare class BackofficeUpdateProductRequest {
     mdmEnabled?: boolean;
     mdmProvider?: MdmProviderEnum | null;
     mdmLockMode?: MdmLockModeEnum | null;
+    /** Prioridad de venta: 100 sale primero en «Recomendados». */
+    salePriority?: number;
+    highlights?: string[];
+    /** 0 = sin garantía. */
+    warrantyMonths?: number;
+    /** Fecha ISO 8601. */
+    launchDate?: string;
+    /** Ficha técnica como mapa clave/valor, igual que Product.specs. */
+    specs?: Record<string, unknown>;
 }

package/bin/retailCatalog/dtos/requests/BackofficeUpdateProductRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const NonBundleCategories_1 = require("../../constants/NonBundleCategories");
 const ProductCategoryEnum_1 = require("../../enums/ProductCategoryEnum");
+const AccessorySubcategoryEnum_1 = require("../../enums/AccessorySubcategoryEnum");
 const ProductTierEnum_1 = require("../../enums/ProductTierEnum");
 const ProductComponent_1 = require("../ProductComponent");
 const MdmLockModeEnum_1 = require("../../enums/MdmLockModeEnum");
@@ -28,6 +29,11 @@ __decorate([
     (0, class_validator_1.IsIn)(NonBundleCategories_1.NON_BUNDLE_CATEGORIES),
     __metadata("design:type", String)
 ], BackofficeUpdateProductRequest.prototype, "category", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(AccessorySubcategoryEnum_1.AccessorySubcategoryEnum),
+    __metadata("design:type", String)
+], BackofficeUpdateProductRequest.prototype, "accessorySubcategory", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsBoolean)(),
@@ -116,3 +122,33 @@ __decorate([
     (0, class_validator_1.IsEnum)(MdmLockModeEnum_1.MdmLockModeEnum),
     __metadata("design:type", String)
 ], BackofficeUpdateProductRequest.prototype, "mdmLockMode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], BackofficeUpdateProductRequest.prototype, "salePriority", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.Matches)(/\S/, { each: true }),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], BackofficeUpdateProductRequest.prototype, "highlights", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], BackofficeUpdateProductRequest.prototype, "warrantyMonths", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], BackofficeUpdateProductRequest.prototype, "launchDate", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], BackofficeUpdateProductRequest.prototype, "specs", void 0);

package/bin/retailCatalog/dtos/requests/HoldStockRequest.d.ts

@@ -0,0 +1,12 @@
+import { ReservationLineRef } from './ReservationLineRef';
+/** Componente de la línea con las piezas que quedan HELD de la sesión. */
+export declare class HoldStockComponent {
+    sku: string;
+    identifiers: string[];
+}
+/** Body de PUT /private/stores/{storeId}/holds (privateHoldStock); fija las piezas de una línea. */
+export declare class HoldStockRequest extends ReservationLineRef {
+    sessionId: string;
+    retailerId: string;
+    components: HoldStockComponent[];
+}

package/bin/retailCatalog/dtos/requests/HoldStockRequest.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.HoldStockRequest = exports.HoldStockComponent = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ReservationLineRef_1 = require("./ReservationLineRef");
+/** Componente de la línea con las piezas que quedan HELD de la sesión. */
+class HoldStockComponent {
+}
+exports.HoldStockComponent = HoldStockComponent;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], HoldStockComponent.prototype, "sku", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], HoldStockComponent.prototype, "identifiers", void 0);
+/** Body de PUT /private/stores/{storeId}/holds (privateHoldStock); fija las piezas de una línea. */
+class HoldStockRequest extends ReservationLineRef_1.ReservationLineRef {
+}
+exports.HoldStockRequest = HoldStockRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], HoldStockRequest.prototype, "sessionId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], HoldStockRequest.prototype, "retailerId", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => HoldStockComponent),
+    __metadata("design:type", Array)
+], HoldStockRequest.prototype, "components", void 0);

package/bin/retailCatalog/dtos/requests/ReserveStockRequest.d.ts

@@ -1,3 +1,4 @@
+import { ReservePurposeEnum } from '../../enums/ReservePurposeEnum';
 /** Body de PUT /private/stores/{storeId}/reservations (privateReserveStock); reserva una línea, kit completo. */
 export declare class ReserveStockRequest {
     sessionId: string;
@@ -7,4 +8,6 @@ export declare class ReserveStockRequest {
     retailerId: string;
     sku: string;
     qty: number;
+    /** GIFT aparta un regalo de Promociones; ausente = apartado normal de venta. */
+    purpose?: ReservePurposeEnum;
 }

package/bin/retailCatalog/dtos/requests/ReserveStockRequest.js

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReserveStockRequest = void 0;
 const class_validator_1 = require("class-validator");
+const ReservePurposeEnum_1 = require("../../enums/ReservePurposeEnum");
 /** Body de PUT /private/stores/{storeId}/reservations (privateReserveStock); reserva una línea, kit completo. */
 class ReserveStockRequest {
 }
@@ -40,3 +41,8 @@ __decorate([
     (0, class_validator_1.Min)(1),
     __metadata("design:type", Number)
 ], ReserveStockRequest.prototype, "qty", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ReservePurposeEnum_1.ReservePurposeEnum),
+    __metadata("design:type", String)
+], ReserveStockRequest.prototype, "purpose", void 0);

package/bin/retailCatalog/dtos/requests/SuggestPiecesQuery.d.ts

@@ -2,4 +2,6 @@
 export declare class SuggestPiecesQuery {
     sku: string;
     prefix: string;
+    /** Sesión que pide; incluye sus propias piezas HELD en las sugerencias. */
+    sessionId?: string;
 }

package/bin/retailCatalog/dtos/requests/SuggestPiecesQuery.js

@@ -24,3 +24,9 @@ __decorate([
     (0, class_validator_1.MinLength)(4),
     __metadata("design:type", String)
 ], SuggestPiecesQuery.prototype, "prefix", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SuggestPiecesQuery.prototype, "sessionId", void 0);

package/bin/retailCatalog/dtos/responses/GetInventorySkuResponse.d.ts

@@ -1,5 +1,6 @@
 import type { InventoryItemStatusEnum } from '../../enums/InventoryItemStatusEnum';
 import type { InventoryMovementTypeEnum } from '../../enums/InventoryMovementTypeEnum';
+import type { InventoryMovementReasonEnum } from '../../enums/InventoryMovementReasonEnum';
 import type { SkuPriceEntry } from './SkuPriceEntry';
 /** Un movimiento del libro de inventario. */
 export interface InventoryMovementEntry {
@@ -11,6 +12,8 @@ export interface InventoryMovementEntry {
     identifier: string | null;
     occurredAt: string;
     createdBy: string;
+    /** Motivo guardado en el MOV#; ausente en los tipos que no llevan motivo. */
+    reason?: InventoryMovementReasonEnum;
 }
 /** Pieza de una tienda; status AVAILABLE, SOLD o DAMAGED. */
 export interface InventoryPieceEntry {

package/bin/retailCatalog/dtos/responses/HoldStockResponse.d.ts

@@ -0,0 +1,8 @@
+import type { HoldStockComponent } from '../requests/HoldStockRequest';
+/** Response de privateHoldStock: la línea con las piezas que quedaron HELD. */
+export interface HoldStockResponse {
+    lineId: string;
+    reservationId: string;
+    sessionId: string;
+    components: HoldStockComponent[];
+}

package/bin/retailCatalog/dtos/responses/HoldStockResponse.js

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

package/bin/retailCatalog/dtos/responses/StoreCatalogItem.d.ts

@@ -1,10 +1,15 @@
 import type { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
 import type { MdmProviderEnum } from '../../enums/MdmProviderEnum';
 import type { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import type { AccessorySubcategoryEnum } from '../../enums/AccessorySubcategoryEnum';
 import type { ProductTierEnum } from '../../enums/ProductTierEnum';
 import type { TrackingModeEnum } from '../../enums/TrackingModeEnum';
 import type { ItemTypeEnum } from '../../enums/ItemTypeEnum';
 import type { ProductComponent } from '../ProductComponent';
+/** Componente de un kit en el catálogo de venta, con la categoría de su SKU. */
+export interface StoreCatalogComponent extends ProductComponent {
+    category?: ProductCategoryEnum;
+}
 /** Fila por SKU del catálogo de venta de una tienda (privateGetStoreStockCatalog). */
 export interface StoreCatalogItem {
     sku: string;
@@ -12,6 +17,8 @@ export interface StoreCatalogItem {
     available: number;
     basePriceCents: number;
     category: ProductCategoryEnum;
+    /** Solo en ACCESSORY. */
+    accessorySubcategory?: AccessorySubcategoryEnum;
     trackingMode: TrackingModeEnum;
     brand: string;
     model: string;
@@ -24,7 +31,7 @@ export interface StoreCatalogItem {
     mdmProvider: MdmProviderEnum | null;
     mdmLockMode: MdmLockModeEnum | null;
     /** Solo si es kit. */
-    components?: ProductComponent[];
+    components?: StoreCatalogComponent[];
     /** Producto físico o servicio. Ausente = PRODUCT. */
     itemType?: ItemTypeEnum;
     /** Nombre visible para kits y servicios, que no tienen marca/modelo. */

package/bin/retailCatalog/enums/AccessorySubcategoryEnum.d.ts

@@ -0,0 +1,9 @@
+/** Subcategoría de un producto ACCESSORY; sirve para regalar «por gama» en Promociones. */
+export declare enum AccessorySubcategoryEnum {
+    AUDIO = "AUDIO",
+    CHARGING = "CHARGING",
+    PROTECTION = "PROTECTION",
+    CABLES = "CABLES",
+    WEARABLES = "WEARABLES",
+    OTHER = "OTHER"
+}

package/bin/retailCatalog/enums/AccessorySubcategoryEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccessorySubcategoryEnum = void 0;
+/** Subcategoría de un producto ACCESSORY; sirve para regalar «por gama» en Promociones. */
+var AccessorySubcategoryEnum;
+(function (AccessorySubcategoryEnum) {
+    AccessorySubcategoryEnum["AUDIO"] = "AUDIO";
+    AccessorySubcategoryEnum["CHARGING"] = "CHARGING";
+    AccessorySubcategoryEnum["PROTECTION"] = "PROTECTION";
+    AccessorySubcategoryEnum["CABLES"] = "CABLES";
+    AccessorySubcategoryEnum["WEARABLES"] = "WEARABLES";
+    AccessorySubcategoryEnum["OTHER"] = "OTHER";
+})(AccessorySubcategoryEnum || (exports.AccessorySubcategoryEnum = AccessorySubcategoryEnum = {}));

package/bin/retailCatalog/enums/InventoryInboundMessageTypeEnum.d.ts

@@ -0,0 +1,5 @@
+/** Tipo de aviso que el wizard publica en la cola de inventario del catálogo. */
+export declare enum InventoryInboundMessageTypeEnum {
+    SALE_APPLIED = "SALE_APPLIED",
+    RETURN = "RETURN"
+}

package/bin/retailCatalog/enums/InventoryInboundMessageTypeEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InventoryInboundMessageTypeEnum = void 0;
+/** Tipo de aviso que el wizard publica en la cola de inventario del catálogo. */
+var InventoryInboundMessageTypeEnum;
+(function (InventoryInboundMessageTypeEnum) {
+    InventoryInboundMessageTypeEnum["SALE_APPLIED"] = "SALE_APPLIED";
+    InventoryInboundMessageTypeEnum["RETURN"] = "RETURN";
+})(InventoryInboundMessageTypeEnum || (exports.InventoryInboundMessageTypeEnum = InventoryInboundMessageTypeEnum = {}));

package/bin/retailCatalog/enums/InventoryItemStatusEnum.d.ts

@@ -1,6 +1,6 @@
 /**
  * Estado de una unidad física (IMEI) en inventario.
- * Transiciones: AVAILABLE → RESERVED → SOLD/AVAILABLE (release); RETURNED desde SOLD; DAMAGED.
+ * Transiciones: AVAILABLE → RESERVED → SOLD/AVAILABLE (release); AVAILABLE → HELD → SOLD/AVAILABLE; RETURNED desde SOLD; DAMAGED.
  * @enum {string}
  *
  * @property {string} AVAILABLE - Disponible en stock.
@@ -9,6 +9,7 @@
  * @property {string} RETURNED - Devuelta por el cliente.
  * @property {string} DAMAGED - Dañada, fuera de stock vendible.
  * @property {string} IN_TRANSIT - En traspaso entre tiendas, fuera de stock vendible.
+ * @property {string} HELD - Capturada por una sesión de venta; no vence hasta venderse o soltarse.
  */
 export declare enum InventoryItemStatusEnum {
     AVAILABLE = "AVAILABLE",
@@ -16,5 +17,6 @@ export declare enum InventoryItemStatusEnum {
     SOLD = "SOLD",
     RETURNED = "RETURNED",
     DAMAGED = "DAMAGED",
-    IN_TRANSIT = "IN_TRANSIT"
+    IN_TRANSIT = "IN_TRANSIT",
+    HELD = "HELD"
 }

package/bin/retailCatalog/enums/InventoryItemStatusEnum.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.InventoryItemStatusEnum = void 0;
 /**
  * Estado de una unidad física (IMEI) en inventario.
- * Transiciones: AVAILABLE → RESERVED → SOLD/AVAILABLE (release); RETURNED desde SOLD; DAMAGED.
+ * Transiciones: AVAILABLE → RESERVED → SOLD/AVAILABLE (release); AVAILABLE → HELD → SOLD/AVAILABLE; RETURNED desde SOLD; DAMAGED.
  * @enum {string}
  *
  * @property {string} AVAILABLE - Disponible en stock.
@@ -12,6 +12,7 @@ exports.InventoryItemStatusEnum = void 0;
  * @property {string} RETURNED - Devuelta por el cliente.
  * @property {string} DAMAGED - Dañada, fuera de stock vendible.
  * @property {string} IN_TRANSIT - En traspaso entre tiendas, fuera de stock vendible.
+ * @property {string} HELD - Capturada por una sesión de venta; no vence hasta venderse o soltarse.
  */
 var InventoryItemStatusEnum;
 (function (InventoryItemStatusEnum) {
@@ -21,4 +22,5 @@ var InventoryItemStatusEnum;
     InventoryItemStatusEnum["RETURNED"] = "RETURNED";
     InventoryItemStatusEnum["DAMAGED"] = "DAMAGED";
     InventoryItemStatusEnum["IN_TRANSIT"] = "IN_TRANSIT";
+    InventoryItemStatusEnum["HELD"] = "HELD";
 })(InventoryItemStatusEnum || (exports.InventoryItemStatusEnum = InventoryItemStatusEnum = {}));

package/bin/retailCatalog/enums/ReservePurposeEnum.d.ts

@@ -0,0 +1,4 @@
+/** Motivo de un apartado; sin valor es un apartado normal de venta. */
+export declare enum ReservePurposeEnum {
+    GIFT = "GIFT"
+}

package/bin/retailCatalog/enums/ReservePurposeEnum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReservePurposeEnum = void 0;
+/** Motivo de un apartado; sin valor es un apartado normal de venta. */
+var ReservePurposeEnum;
+(function (ReservePurposeEnum) {
+    ReservePurposeEnum["GIFT"] = "GIFT";
+})(ReservePurposeEnum || (exports.ReservePurposeEnum = ReservePurposeEnum = {}));

package/bin/retailCatalog/events/InventoryInboundMessage.d.ts

@@ -0,0 +1,4 @@
+import type { InventoryReturnMessage } from './InventoryReturnMessage';
+import type { InventorySaleAppliedMessage } from './InventorySaleAppliedMessage';
+/** Cualquier aviso de la cola de inventario; se discrimina por `type`. */
+export type InventoryInboundMessage = InventorySaleAppliedMessage | InventoryReturnMessage;

package/bin/retailCatalog/events/InventoryInboundMessage.js

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