@fiado/type-kit 3.471.0 → 3.473.0

package/bin/common/validators/IsStringValueRecord.d.ts

@@ -0,0 +1,5 @@
+import { ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
+export declare class IsStringValueRecord implements ValidatorConstraintInterface {
+    validate(value: unknown, _args: ValidationArguments): boolean;
+    defaultMessage(_args: ValidationArguments): string;
+}

package/bin/common/validators/IsStringValueRecord.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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsStringValueRecord = void 0;
+const class_validator_1 = require("class-validator");
+// Valida que un objeto sea un mapa clave → string.
+let IsStringValueRecord = class IsStringValueRecord {
+    validate(value, _args) {
+        if (!value || typeof value !== 'object')
+            return false;
+        return Object.values(value).every(v => typeof v === 'string');
+    }
+    defaultMessage(_args) {
+        return 'All values in variables must be strings';
+    }
+};
+exports.IsStringValueRecord = IsStringValueRecord;
+exports.IsStringValueRecord = IsStringValueRecord = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'IsStringValueRecord', async: false })
+], IsStringValueRecord);

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/messagesConnector/validators/IsStringValueRecord.d.ts

@@ -1,5 +1 @@
-import { ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
-export declare class IsStringValueRecord implements ValidatorConstraintInterface {
-    validate(value: unknown, _args: ValidationArguments): boolean;
-    defaultMessage(_args: ValidationArguments): string;
-}
+export { IsStringValueRecord } from '../../common/validators/IsStringValueRecord';

package/bin/messagesConnector/validators/IsStringValueRecord.js

@@ -1,24 +1,6 @@
 "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;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IsStringValueRecord = void 0;
-const class_validator_1 = require("class-validator");
-let IsStringValueRecord = class IsStringValueRecord {
-    validate(value, _args) {
-        if (!value || typeof value !== 'object')
-            return false;
-        return Object.values(value).every(v => typeof v === 'string');
-    }
-    defaultMessage(_args) {
-        return 'All values in variables must be strings';
-    }
-};
-exports.IsStringValueRecord = IsStringValueRecord;
-exports.IsStringValueRecord = IsStringValueRecord = __decorate([
-    (0, class_validator_1.ValidatorConstraint)({ name: 'IsStringValueRecord', async: false })
-], IsStringValueRecord);
+// Movido a common: se reexporta para no romper a quien importa desde messagesConnector.
+var IsStringValueRecord_1 = require("../../common/validators/IsStringValueRecord");
+Object.defineProperty(exports, "IsStringValueRecord", { enumerable: true, get: function () { return IsStringValueRecord_1.IsStringValueRecord; } });

package/bin/platformRbac/dtos/CreateTenantUserRequest.d.ts

@@ -8,6 +8,7 @@ import { PermissionScope } from '../enums/PermissionScope';
  * - Idempotente por identidad Cognito.
  * - `scope`/`scopeRef` = grant del rol (ej. LEVEL_3 + storeId para un vendedor de tienda).
  * - `createdBy` = cognitoSub del admin real (audit + grantedBy del assignment).
+ * - `customFields` = valores de los campos personalizados del tenant; si el correo ya tiene usuario, se fusionan.
  */
 export declare class CreateTenantUserRequest {
     email: string;
@@ -16,4 +17,7 @@ export declare class CreateTenantUserRequest {
     scope: PermissionScope;
     scopeRef: string;
     createdBy: string;
+    customFields?: {
+        [key: string]: string;
+    };
 }

package/bin/platformRbac/dtos/CreateTenantUserRequest.js

@@ -13,6 +13,7 @@ exports.CreateTenantUserRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const PermissionScope_1 = require("../enums/PermissionScope");
+const IsStringValueRecord_1 = require("../../common/validators/IsStringValueRecord");
 /**
  * Body del POST /internal/tenants/{tenantId}/users (endpoint privado, VPC/ANONIMUS). `tenantId` viaja en el path.
  * Provisiona Cognito + SharedUser + RoleAssignment (rol + scopeRef) en RBAC — reusa UserProvisioningService.
@@ -22,6 +23,7 @@ const PermissionScope_1 = require("../enums/PermissionScope");
  * - Idempotente por identidad Cognito.
  * - `scope`/`scopeRef` = grant del rol (ej. LEVEL_3 + storeId para un vendedor de tienda).
  * - `createdBy` = cognitoSub del admin real (audit + grantedBy del assignment).
+ * - `customFields` = valores de los campos personalizados del tenant; si el correo ya tiene usuario, se fusionan.
  */
 class CreateTenantUserRequest {
 }
@@ -61,3 +63,10 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], CreateTenantUserRequest.prototype, "createdBy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.Validate)(IsStringValueRecord_1.IsStringValueRecord, { message: 'customFields: todos los valores deben ser string' }),
+    __metadata("design:type", Object)
+], CreateTenantUserRequest.prototype, "customFields", void 0);

package/bin/platformRbac/dtos/UpdateTenantUserRequest.d.ts

@@ -1,8 +1,11 @@
 /**
- * Body del PUT que renombra a un usuario. El correo es inmutable en el rbac y el grupo se mueve
- * reasignando el rol, así que aquí no viaja ninguno de los dos.
+ * Body del PUT que edita a un usuario: nombre y campos personalizados. `customFields` se fusiona con los
+ * actuales (solo cambian las claves enviadas; "" borra una). Correo y grupo no viajan aquí.
  */
 export declare class UpdateTenantUserRequest {
     displayName?: string;
+    customFields?: {
+        [key: string]: string;
+    };
     actedBy: string;
 }

package/bin/platformRbac/dtos/UpdateTenantUserRequest.js

@@ -12,9 +12,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateTenantUserRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const IsStringValueRecord_1 = require("../../common/validators/IsStringValueRecord");
 /**
- * Body del PUT que renombra a un usuario. El correo es inmutable en el rbac y el grupo se mueve
- * reasignando el rol, así que aquí no viaja ninguno de los dos.
+ * Body del PUT que edita a un usuario: nombre y campos personalizados. `customFields` se fusiona con los
+ * actuales (solo cambian las claves enviadas; "" borra una). Correo y grupo no viajan aquí.
  */
 class UpdateTenantUserRequest {
 }
@@ -27,6 +28,13 @@ __decorate([
     (0, class_validator_1.MaxLength)(120),
     __metadata("design:type", String)
 ], UpdateTenantUserRequest.prototype, "displayName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.Validate)(IsStringValueRecord_1.IsStringValueRecord, { message: 'customFields: todos los valores deben ser string' }),
+    __metadata("design:type", Object)
+], UpdateTenantUserRequest.prototype, "customFields", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

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

@@ -48,4 +48,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

@@ -27,4 +27,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

@@ -115,3 +115,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

@@ -24,4 +24,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

@@ -116,3 +116,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,47 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.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)(),
+    __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)(),
+    __metadata("design:type", String)
+], HoldStockRequest.prototype, "sessionId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __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

@@ -5,6 +5,10 @@ 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;
@@ -24,7 +28,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/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 });

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

@@ -0,0 +1,12 @@
+import { InventoryInboundMessageTypeEnum } from '../enums/InventoryInboundMessageTypeEnum';
+import { ReturnStockRequest } from '../dtos/requests/ReturnStockRequest';
+/** Aviso de devolución de una venta de la saga en la cola de inventario. */
+export declare class InventoryReturnMessage extends ReturnStockRequest {
+    type: InventoryInboundMessageTypeEnum.RETURN;
+    tenantId: string;
+    storeId: string;
+    /** Sesión de la venta; ubica su marcador IDEMP#SELL. */
+    sessionId: string;
+    /** Fecha de la devolución; es el occurredAt del MOV#. */
+    returnedAt: string;
+}