@fiado/type-kit 3.464.0 → 3.465.0

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

@@ -0,0 +1,11 @@
+import { ReturnConditionEnum } from '../../enums/ReturnConditionEnum';
+/** Condición de una pieza devuelta; ausente = GOOD. Un accesorio por cantidad se declara con sku + qty. */
+export declare class ReturnPieceCondition {
+    sku: string;
+    identifier?: string;
+    /** Unidades del SKU por cantidad con esta condición; las no declaradas vuelven GOOD. */
+    qty?: number;
+    condition: ReturnConditionEnum;
+    /** Motivo del daño; obligatorio con DAMAGED, opcional con GOOD. */
+    reason?: string;
+}

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

@@ -0,0 +1,57 @@
+"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.ReturnPieceCondition = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SkuPattern_1 = require("../../constants/SkuPattern");
+const ReturnConditionEnum_1 = require("../../enums/ReturnConditionEnum");
+const IsPieceRefConstraint_1 = require("../../validators/IsPieceRefConstraint");
+/** Condición de una pieza devuelta; ausente = GOOD. Un accesorio por cantidad se declara con sku + qty. */
+class ReturnPieceCondition {
+    constructor() {
+        this.condition = ReturnConditionEnum_1.ReturnConditionEnum.GOOD;
+    }
+}
+exports.ReturnPieceCondition = ReturnPieceCondition;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' }),
+    (0, class_validator_1.Length)(1, 64),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ReturnPieceCondition.prototype, "sku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Validate)(IsPieceRefConstraint_1.IsPieceRefConstraint),
+    __metadata("design:type", String)
+], ReturnPieceCondition.prototype, "identifier", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.qty !== undefined),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], ReturnPieceCondition.prototype, "qty", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ?? ReturnConditionEnum_1.ReturnConditionEnum.GOOD),
+    (0, class_validator_1.IsEnum)(ReturnConditionEnum_1.ReturnConditionEnum),
+    __metadata("design:type", String)
+], ReturnPieceCondition.prototype, "condition", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.condition === ReturnConditionEnum_1.ReturnConditionEnum.DAMAGED || o.reason != null),
+    (0, class_validator_1.MaxLength)(200),
+    (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ReturnPieceCondition.prototype, "reason", void 0);

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

@@ -0,0 +1,6 @@
+import { ReturnPieceCondition } from './ReturnPieceCondition';
+import { StockLine } from './StockLine';
+/** Línea de devolución: la línea vendida más la condición de sus piezas; las no listadas vuelven GOOD. */
+export declare class ReturnStockLine extends StockLine {
+    conditions?: ReturnPieceCondition[];
+}

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

@@ -0,0 +1,27 @@
+"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.ReturnStockLine = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ReturnPieceCondition_1 = require("./ReturnPieceCondition");
+const StockLine_1 = require("./StockLine");
+/** Línea de devolución: la línea vendida más la condición de sus piezas; las no listadas vuelven GOOD. */
+class ReturnStockLine extends StockLine_1.StockLine {
+}
+exports.ReturnStockLine = ReturnStockLine;
+__decorate([
+    (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)
+], ReturnStockLine.prototype, "conditions", void 0);

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

@@ -1,9 +1,9 @@
-import { StockLine } from './StockLine';
+import { ReturnStockLine } from './ReturnStockLine';
 /** Body de PUT /private/stores/{storeId}/returns (privateReturnStock); componentes guardados en la venta. */
 export declare class ReturnStockRequest {
     saleId: string;
     retailerId: string;
     /** Fecha de la venta; fija el día de negocio del contador DAY# que se descuenta. */
     soldAt: string;
-    lines: StockLine[];
+    lines: ReturnStockLine[];
 }

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

@@ -12,7 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReturnStockRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
-const StockLine_1 = require("./StockLine");
+const ReturnStockLine_1 = require("./ReturnStockLine");
 /** Body de PUT /private/stores/{storeId}/returns (privateReturnStock); componentes guardados en la venta. */
 class ReturnStockRequest {
 }
@@ -33,6 +33,6 @@ __decorate([
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayMinSize)(1),
     (0, class_validator_1.ValidateNested)({ each: true }),
-    (0, class_transformer_1.Type)(() => StockLine_1.StockLine),
+    (0, class_transformer_1.Type)(() => ReturnStockLine_1.ReturnStockLine),
     __metadata("design:type", Array)
 ], ReturnStockRequest.prototype, "lines", void 0);

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

@@ -1,4 +1,7 @@
-/** Body de PUT /retailers/:retailerId/inventory/:imei/transfer — mover IMEI a otro store. */
+/**
+ * Body de PUT /retailers/:retailerId/inventory/:imei/transfer — mover IMEI a otro store.
+ * @deprecated Modelo viejo por IMEI; usar BackofficeCreateTransferRequest. Se conserva porque otras ramas lo importan.
+ */
 export declare class TransferInventoryRequest {
     newStoreId: string;
 }

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

@@ -11,7 +11,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TransferInventoryRequest = void 0;
 const class_validator_1 = require("class-validator");
-/** Body de PUT /retailers/:retailerId/inventory/:imei/transfer — mover IMEI a otro store. */
+/**
+ * Body de PUT /retailers/:retailerId/inventory/:imei/transfer — mover IMEI a otro store.
+ * @deprecated Modelo viejo por IMEI; usar BackofficeCreateTransferRequest. Se conserva porque otras ramas lo importan.
+ */
 class TransferInventoryRequest {
 }
 exports.TransferInventoryRequest = TransferInventoryRequest;

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

@@ -1,7 +1,10 @@
 import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
 import { MdmProviderEnum } from '../../enums/MdmProviderEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
-/** Body de PUT /retailers/:retailerId/products/:sku — actualización parcial (sku y status son inmutables acá). */
+/**
+ * Body de PUT /retailers/:retailerId/products/:sku — actualización parcial (sku y status son inmutables acá).
+ * @deprecated Modelo viejo por IMEI; usar BackofficeUpdateProductRequest. Se conserva porque otras ramas lo importan.
+ */
 export declare class UpdateProductRequest {
     externalId?: string | null;
     brand?: string;

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

@@ -15,7 +15,10 @@ const MdmLockModeEnum_1 = require("../../enums/MdmLockModeEnum");
 const MdmProviderEnum_1 = require("../../enums/MdmProviderEnum");
 const ProductTierEnum_1 = require("../../enums/ProductTierEnum");
 const IsMdmCoherentConstraint_1 = require("../../validators/IsMdmCoherentConstraint");
-/** Body de PUT /retailers/:retailerId/products/:sku — actualización parcial (sku y status son inmutables acá). */
+/**
+ * Body de PUT /retailers/:retailerId/products/:sku — actualización parcial (sku y status son inmutables acá).
+ * @deprecated Modelo viejo por IMEI; usar BackofficeUpdateProductRequest. Se conserva porque otras ramas lo importan.
+ */
 class UpdateProductRequest {
 }
 exports.UpdateProductRequest = UpdateProductRequest;

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

@@ -1,5 +1,8 @@
 import { ProductStatusEnum } from '../../enums/ProductStatusEnum';
-/** Body de PUT /retailers/:retailerId/products/:sku/status — ACTIVE | DISCONTINUED. */
+/**
+ * Body de PUT /retailers/:retailerId/products/:sku/status — ACTIVE | DISCONTINUED.
+ * @deprecated Modelo viejo por IMEI; usar backofficeDeactivateProduct (sin body). Se conserva porque otras ramas lo importan.
+ */
 export declare class UpdateProductStatusRequest {
     status: ProductStatusEnum;
 }

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

@@ -12,7 +12,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateProductStatusRequest = void 0;
 const class_validator_1 = require("class-validator");
 const ProductStatusEnum_1 = require("../../enums/ProductStatusEnum");
-/** Body de PUT /retailers/:retailerId/products/:sku/status — ACTIVE | DISCONTINUED. */
+/**
+ * Body de PUT /retailers/:retailerId/products/:sku/status — ACTIVE | DISCONTINUED.
+ * @deprecated Modelo viejo por IMEI; usar backofficeDeactivateProduct (sin body). Se conserva porque otras ramas lo importan.
+ */
 class UpdateProductStatusRequest {
 }
 exports.UpdateProductStatusRequest = UpdateProductStatusRequest;

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

@@ -4,6 +4,7 @@ import type { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
 import type { ProductTierEnum } from '../../enums/ProductTierEnum';
 import type { InventoryLensUnavailableReasonEnum } from '../../enums/InventoryLensUnavailableReasonEnum';
 import type { InventoryTransferReasonEnum } from '../../enums/InventoryTransferReasonEnum';
+import type { ItemTypeEnum } from '../../enums/ItemTypeEnum';
 /**
  * Los contadores que la pantalla «Inventario» del Admin VL pinta arriba, siempre — los cuatro viajan
  * con cualquier `filter`, porque las tarjetas no cambian al cambiar de tab.
@@ -112,6 +113,8 @@ export interface InventoryLensListItem {
     coverage: InventoryLensCoverage;
     alerts: InventoryLensAlerts;
     sold30d: number;
+    /** Producto físico o servicio. Ausente = PRODUCT. */
+    itemType?: ItemTypeEnum;
 }
 /** Fila del lente — el tipo depende del tab pedido. */
 export type InventoryLensItem = InventoryLensSkuItem | InventoryLensTransferSuggestion | InventoryLensListItem;

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

@@ -0,0 +1,5 @@
+import type { TransferResponse } from './TransferResponse';
+/** Response de backofficeListTransfers. */
+export interface ListTransfersResponse {
+    items: TransferResponse[];
+}

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

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

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

@@ -7,6 +7,8 @@ export interface ReservedComponent {
     qty: number;
     category: ProductCategoryEnum;
     trackingMode: TrackingModeEnum;
+    /** Precio vigente del componente, para repartir el precio del kit. */
+    priceCents?: number;
 }
 /** Response de privateReserveStock; el precio de la línea es `basePriceCents`. */
 export interface ReserveStockResponse {

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

@@ -4,6 +4,8 @@ export interface SkuPriceEntry {
     effectiveFrom: string;
     listPriceCents: number | null;
     basePriceCents: number;
+    /** Precio del SKU dentro de un kit; informativo, no se aplica. */
+    comboPriceCents?: number;
     source: PriceSourceEnum;
     createdBy: string;
 }

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

@@ -3,6 +3,7 @@ import type { MdmProviderEnum } from '../../enums/MdmProviderEnum';
 import type { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
 import type { ProductTierEnum } from '../../enums/ProductTierEnum';
 import type { TrackingModeEnum } from '../../enums/TrackingModeEnum';
+import type { ItemTypeEnum } from '../../enums/ItemTypeEnum';
 import type { ProductComponent } from '../ProductComponent';
 /** Fila por SKU del catálogo de venta de una tienda (privateGetStoreStockCatalog). */
 export interface StoreCatalogItem {
@@ -24,6 +25,8 @@ export interface StoreCatalogItem {
     mdmLockMode: MdmLockModeEnum | null;
     /** Solo si es kit. */
     components?: ProductComponent[];
+    /** Producto físico o servicio. Ausente = PRODUCT. */
+    itemType?: ItemTypeEnum;
 }
 /** Response de privateGetStoreStockCatalog. */
 export type GetStoreStockCatalogResponse = StoreCatalogItem[];

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

@@ -0,0 +1,16 @@
+import type { TransferStateEnum } from '../../enums/TransferStateEnum';
+/** Un traspaso entre tiendas (TRF#); response de crear, recibir y cancelar. */
+export interface TransferResponse {
+    transferId: string;
+    fromStoreId: string;
+    toStoreId: string;
+    sku: string;
+    qty: number;
+    /** IMEI o serie de cada pieza; vacío si el SKU se rastrea por cantidad. */
+    identifiers: string[];
+    state: TransferStateEnum;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

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

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

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

@@ -8,11 +8,13 @@
  * @property {string} SOLD - Vendida.
  * @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.
  */
 export declare enum InventoryItemStatusEnum {
     AVAILABLE = "AVAILABLE",
     RESERVED = "RESERVED",
     SOLD = "SOLD",
     RETURNED = "RETURNED",
-    DAMAGED = "DAMAGED"
+    DAMAGED = "DAMAGED",
+    IN_TRANSIT = "IN_TRANSIT"
 }

package/bin/retailCatalog/enums/InventoryItemStatusEnum.js

@@ -11,6 +11,7 @@ exports.InventoryItemStatusEnum = void 0;
  * @property {string} SOLD - Vendida.
  * @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.
  */
 var InventoryItemStatusEnum;
 (function (InventoryItemStatusEnum) {
@@ -19,4 +20,5 @@ var InventoryItemStatusEnum;
     InventoryItemStatusEnum["SOLD"] = "SOLD";
     InventoryItemStatusEnum["RETURNED"] = "RETURNED";
     InventoryItemStatusEnum["DAMAGED"] = "DAMAGED";
+    InventoryItemStatusEnum["IN_TRANSIT"] = "IN_TRANSIT";
 })(InventoryItemStatusEnum || (exports.InventoryItemStatusEnum = InventoryItemStatusEnum = {}));

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

@@ -0,0 +1,7 @@
+/** Motivo de un movimiento manual de inventario (MOV#): merma, ajuste, garantía o devolución dañada. */
+export declare enum InventoryMovementReasonEnum {
+    SHRINKAGE = "SHRINKAGE",
+    ADJUSTMENT = "ADJUSTMENT",
+    WARRANTY = "WARRANTY",
+    DAMAGED_RETURN = "DAMAGED_RETURN"
+}

package/bin/retailCatalog/enums/InventoryMovementReasonEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InventoryMovementReasonEnum = void 0;
+/** Motivo de un movimiento manual de inventario (MOV#): merma, ajuste, garantía o devolución dañada. */
+var InventoryMovementReasonEnum;
+(function (InventoryMovementReasonEnum) {
+    InventoryMovementReasonEnum["SHRINKAGE"] = "SHRINKAGE";
+    InventoryMovementReasonEnum["ADJUSTMENT"] = "ADJUSTMENT";
+    InventoryMovementReasonEnum["WARRANTY"] = "WARRANTY";
+    InventoryMovementReasonEnum["DAMAGED_RETURN"] = "DAMAGED_RETURN";
+})(InventoryMovementReasonEnum || (exports.InventoryMovementReasonEnum = InventoryMovementReasonEnum = {}));

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

@@ -5,5 +5,8 @@ export declare enum InventoryMovementTypeEnum {
     RELEASE = "RELEASE",
     SALE = "SALE",
     RETURN = "RETURN",
-    ADJUSTMENT = "ADJUSTMENT"
+    ADJUSTMENT = "ADJUSTMENT",
+    TRANSFER_OUT = "TRANSFER_OUT",
+    TRANSFER_IN = "TRANSFER_IN",
+    TRANSFER_CANCEL = "TRANSFER_CANCEL"
 }

package/bin/retailCatalog/enums/InventoryMovementTypeEnum.js

@@ -10,4 +10,7 @@ var InventoryMovementTypeEnum;
     InventoryMovementTypeEnum["SALE"] = "SALE";
     InventoryMovementTypeEnum["RETURN"] = "RETURN";
     InventoryMovementTypeEnum["ADJUSTMENT"] = "ADJUSTMENT";
+    InventoryMovementTypeEnum["TRANSFER_OUT"] = "TRANSFER_OUT";
+    InventoryMovementTypeEnum["TRANSFER_IN"] = "TRANSFER_IN";
+    InventoryMovementTypeEnum["TRANSFER_CANCEL"] = "TRANSFER_CANCEL";
 })(InventoryMovementTypeEnum || (exports.InventoryMovementTypeEnum = InventoryMovementTypeEnum = {}));

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

@@ -0,0 +1,5 @@
+/** Tipo de ítem del catálogo: producto físico o servicio sin stock. Inmutable tras el alta. */
+export declare enum ItemTypeEnum {
+    PRODUCT = "PRODUCT",
+    SERVICE = "SERVICE"
+}

package/bin/retailCatalog/enums/ItemTypeEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ItemTypeEnum = void 0;
+/** Tipo de ítem del catálogo: producto físico o servicio sin stock. Inmutable tras el alta. */
+var ItemTypeEnum;
+(function (ItemTypeEnum) {
+    ItemTypeEnum["PRODUCT"] = "PRODUCT";
+    ItemTypeEnum["SERVICE"] = "SERVICE";
+})(ItemTypeEnum || (exports.ItemTypeEnum = ItemTypeEnum = {}));

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

@@ -1,4 +1,5 @@
-/** Origen de un registro del historial de precios (PRICE#). */
+/** Origen de un registro de catálogo (PRODUCT#, PRICE#, MOV#): la puerta de Zentral o el backoffice. */
 export declare enum PriceSourceEnum {
-    ZENTRAL_SYNC = "ZENTRAL_SYNC"
+    ZENTRAL_SYNC = "ZENTRAL_SYNC",
+    BACKOFFICE = "BACKOFFICE"
 }

package/bin/retailCatalog/enums/PriceSourceEnum.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PriceSourceEnum = void 0;
-/** Origen de un registro del historial de precios (PRICE#). */
+/** Origen de un registro de catálogo (PRODUCT#, PRICE#, MOV#): la puerta de Zentral o el backoffice. */
 var PriceSourceEnum;
 (function (PriceSourceEnum) {
     PriceSourceEnum["ZENTRAL_SYNC"] = "ZENTRAL_SYNC";
+    PriceSourceEnum["BACKOFFICE"] = "BACKOFFICE";
 })(PriceSourceEnum || (exports.PriceSourceEnum = PriceSourceEnum = {}));

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

@@ -0,0 +1,5 @@
+/** Condición de una pieza devuelta; DAMAGED no regresa al disponible. */
+export declare enum ReturnConditionEnum {
+    GOOD = "GOOD",
+    DAMAGED = "DAMAGED"
+}

package/bin/retailCatalog/enums/ReturnConditionEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReturnConditionEnum = void 0;
+/** Condición de una pieza devuelta; DAMAGED no regresa al disponible. */
+var ReturnConditionEnum;
+(function (ReturnConditionEnum) {
+    ReturnConditionEnum["GOOD"] = "GOOD";
+    ReturnConditionEnum["DAMAGED"] = "DAMAGED";
+})(ReturnConditionEnum || (exports.ReturnConditionEnum = ReturnConditionEnum = {}));

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

@@ -0,0 +1,6 @@
+/** Estado de un traspaso entre tiendas (TRF#); solo uno OPEN se recibe o cancela. */
+export declare enum TransferStateEnum {
+    OPEN = "OPEN",
+    RECEIVED = "RECEIVED",
+    CANCELLED = "CANCELLED"
+}

package/bin/retailCatalog/enums/TransferStateEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferStateEnum = void 0;
+/** Estado de un traspaso entre tiendas (TRF#); solo uno OPEN se recibe o cancela. */
+var TransferStateEnum;
+(function (TransferStateEnum) {
+    TransferStateEnum["OPEN"] = "OPEN";
+    TransferStateEnum["RECEIVED"] = "RECEIVED";
+    TransferStateEnum["CANCELLED"] = "CANCELLED";
+})(TransferStateEnum || (exports.TransferStateEnum = TransferStateEnum = {}));

package/bin/retailCatalog/index.d.ts

@@ -7,7 +7,10 @@ export * from './enums/InventoryLensFilterEnum';
 export * from './enums/InventoryLensUnavailableReasonEnum';
 export * from './enums/InventoryTransferReasonEnum';
 export * from './constants/SkuPattern';
+export * from './constants/NonBundleCategories';
+export * from './constants/AdjustmentReasons';
 export * from './validators/IsMdmCoherentConstraint';
+export * from './validators/IsPieceRefConstraint';
 export * from './dtos/Product';
 export * from './dtos/InventoryItem';
 export * from './dtos/requests/CreateProductRequest';
@@ -35,6 +38,8 @@ export * from './enums/InventoryLensPeriodEnum';
 export * from './dtos/ProductComponent';
 export * from './dtos/requests/ReservationLineRef';
 export * from './dtos/requests/StockLine';
+export * from './dtos/requests/ReturnPieceCondition';
+export * from './dtos/requests/ReturnStockLine';
 export * from './dtos/requests/ReserveStockRequest';
 export * from './dtos/requests/RenewReservationsRequest';
 export * from './dtos/requests/SuggestPiecesQuery';
@@ -54,3 +59,18 @@ export * from './dtos/responses/StoreCatalogItem';
 export * from './dtos/responses/SkuPriceEntry';
 export * from './dtos/responses/GetInventorySkuResponse';
 export * from './dtos/responses/ListSkuPricesResponse';
+export * from './enums/ItemTypeEnum';
+export * from './enums/ReturnConditionEnum';
+export * from './enums/TransferStateEnum';
+export * from './enums/InventoryMovementReasonEnum';
+export * from './dtos/requests/BackofficeCreateProductRequest';
+export * from './dtos/requests/BackofficeCreateKitRequest';
+export * from './dtos/requests/BackofficeCreateServiceRequest';
+export * from './dtos/requests/BackofficeUpdateProductRequest';
+export * from './dtos/requests/BackofficeCreateSkuPriceRequest';
+export * from './dtos/requests/BackofficeRegisterEntryRequest';
+export * from './dtos/requests/BackofficeRegisterAdjustmentRequest';
+export * from './dtos/requests/BackofficeCreateTransferRequest';
+export * from './dtos/requests/BackofficeListTransfersQuery';
+export * from './dtos/responses/TransferResponse';
+export * from './dtos/responses/ListTransfersResponse';

package/bin/retailCatalog/index.js

@@ -25,8 +25,11 @@ __exportStar(require("./enums/InventoryLensUnavailableReasonEnum"), exports);
 __exportStar(require("./enums/InventoryTransferReasonEnum"), exports);
 // Constantes del dominio
 __exportStar(require("./constants/SkuPattern"), exports);
+__exportStar(require("./constants/NonBundleCategories"), exports);
+__exportStar(require("./constants/AdjustmentReasons"), exports);
 // Validators custom
 __exportStar(require("./validators/IsMdmCoherentConstraint"), exports);
+__exportStar(require("./validators/IsPieceRefConstraint"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/Product"), exports);
 __exportStar(require("./dtos/InventoryItem"), exports);
@@ -59,6 +62,8 @@ __exportStar(require("./enums/InventoryLensPeriodEnum"), exports);
 __exportStar(require("./dtos/ProductComponent"), exports);
 __exportStar(require("./dtos/requests/ReservationLineRef"), exports);
 __exportStar(require("./dtos/requests/StockLine"), exports);
+__exportStar(require("./dtos/requests/ReturnPieceCondition"), exports);
+__exportStar(require("./dtos/requests/ReturnStockLine"), exports);
 __exportStar(require("./dtos/requests/ReserveStockRequest"), exports);
 __exportStar(require("./dtos/requests/RenewReservationsRequest"), exports);
 __exportStar(require("./dtos/requests/SuggestPiecesQuery"), exports);
@@ -78,3 +83,19 @@ __exportStar(require("./dtos/responses/StoreCatalogItem"), exports);
 __exportStar(require("./dtos/responses/SkuPriceEntry"), exports);
 __exportStar(require("./dtos/responses/GetInventorySkuResponse"), exports);
 __exportStar(require("./dtos/responses/ListSkuPricesResponse"), exports);
+// Operación independiente (ciclo 2)
+__exportStar(require("./enums/ItemTypeEnum"), exports);
+__exportStar(require("./enums/ReturnConditionEnum"), exports);
+__exportStar(require("./enums/TransferStateEnum"), exports);
+__exportStar(require("./enums/InventoryMovementReasonEnum"), exports);
+__exportStar(require("./dtos/requests/BackofficeCreateProductRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeCreateKitRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeCreateServiceRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeUpdateProductRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeCreateSkuPriceRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeRegisterEntryRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeRegisterAdjustmentRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeCreateTransferRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeListTransfersQuery"), exports);
+__exportStar(require("./dtos/responses/TransferResponse"), exports);
+__exportStar(require("./dtos/responses/ListTransfersResponse"), exports);

package/bin/retailCatalog/validators/IsPieceRefConstraint.d.ts

@@ -0,0 +1,6 @@
+import { type ValidationArguments, type ValidatorConstraintInterface } from 'class-validator';
+/** Exige identifier (pieza con IMEI o serie) o qty (SKU por cantidad), nunca los dos. */
+export declare class IsPieceRefConstraint implements ValidatorConstraintInterface {
+    validate(identifier: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}

package/bin/retailCatalog/validators/IsPieceRefConstraint.js

@@ -0,0 +1,26 @@
+"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.IsPieceRefConstraint = void 0;
+const class_validator_1 = require("class-validator");
+/** Exige identifier (pieza con IMEI o serie) o qty (SKU por cantidad), nunca los dos. */
+let IsPieceRefConstraint = class IsPieceRefConstraint {
+    validate(identifier, args) {
+        const { qty } = args.object;
+        if (qty !== undefined)
+            return identifier === undefined;
+        return typeof identifier === 'string' && /^\S+$/.test(identifier);
+    }
+    defaultMessage() {
+        return 'identifier (pieza con IMEI o serie) o qty (por cantidad), exactamente uno';
+    }
+};
+exports.IsPieceRefConstraint = IsPieceRefConstraint;
+exports.IsPieceRefConstraint = IsPieceRefConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isPieceRef', async: false })
+], IsPieceRefConstraint);

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

@@ -1,3 +1,4 @@
+import { ReturnPieceCondition } from '../../../retailCatalog/dtos/requests/ReturnPieceCondition';
 /**
  * POST /backoffice/sales/:saleId/cancel — cancelación del Admin VL. SureKeep Fase 3 — pista Retail.
  *
@@ -23,4 +24,6 @@ export declare class BackofficeCancelSaleRequest {
      * la venta YA está fuera de ventana; dentro de ventana se ignora.
      */
     outOfWindowExceptionId?: string;
+    /** Condición de cada pieza que regresa al inventario; las no listadas vuelven GOOD. */
+    returnConditions?: ReturnPieceCondition[];
 }

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

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BackofficeCancelSaleRequest = 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 /backoffice/sales/:saleId/cancel — cancelación del Admin VL. SureKeep Fase 3 — pista Retail.
  *
@@ -46,3 +47,11 @@ __decorate([
     (0, class_validator_1.MaxLength)(64),
     __metadata("design:type", String)
 ], BackofficeCancelSaleRequest.prototype, "outOfWindowExceptionId", 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)
+], BackofficeCancelSaleRequest.prototype, "returnConditions", void 0);

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

@@ -1,3 +1,4 @@
+import { ReturnPieceCondition } from '../../../retailCatalog/dtos/requests/ReturnPieceCondition';
 /**
  * POST /sales/:saleId/cancel — cancela una venta (flujo C, solo BO dentro de ventana param). `reason`
  * OBLIGATORIO (AuditTrail). Retorna el IMEI al silo (`SOLD → AVAILABLE`) y emite `SaleCancelledV1`.
@@ -19,4 +20,6 @@ export declare class CancelSaleRequest {
      * que el string `"false"` se rechaza en vez de colarse como truthy.
      */
     equipmentVerified?: boolean;
+    /** Condición de cada pieza que regresa al inventario; las no listadas vuelven GOOD. */
+    returnConditions?: ReturnPieceCondition[];
 }