@fiado/type-kit 3.460.0 → 3.461.0

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

@@ -13,14 +13,8 @@ exports.AddProductRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 /**
- * POST /wizard/sessions/:id/product — reserva un equipo del catálogo (paso 03). Reserva 30 min en
- * RetailInventory F1 (condición atómica H2).
- *
- * `imei` y `cashPriceCents` son OPCIONALES a propósito: la unidad física y el precio son AUTORIDAD DEL
- * SERVIDOR. Con solo el `sku`, el wizard elige una unidad disponible del catálogo y toma su precio (el
- * cliente NUNCA dicta el monto a cobrar — `cashPriceCents` ancla el cobro con `amountCents == cashPrice`).
- * Si el caller manda `imei`, el server puede honrar esa unidad, pero el precio SIEMPRE sale del catálogo.
- * SureKeep Fase 2 — pista Retail.
+ * POST /wizard/sessions/:id/product — agrega una línea a la venta y reserva sus piezas en el catálogo.
+ * `imei` y `cashPriceCents` son opcionales: la pieza y el precio los decide el servidor.
  */
 class AddProductRequest {
 }
@@ -43,3 +37,10 @@ __decorate([
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
 ], AddProductRequest.prototype, "cashPriceCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], AddProductRequest.prototype, "qty", void 0);

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

@@ -0,0 +1,16 @@
+/** Identificadores capturados en la entrega para un SKU de la línea (componente si es kit). */
+export declare class CompleteSaleLineComponent {
+    sku: string;
+    /** Vacío si el SKU se rastrea por cantidad. */
+    identifiers: string[];
+}
+/** Línea de la sesión con los identificadores de sus piezas. */
+export declare class CompleteSaleLine {
+    lineId: string;
+    components: CompleteSaleLineComponent[];
+}
+/** POST /wizard/sessions/:id/complete-sale — cierra la venta con los identificadores de cada línea. */
+export declare class CompleteSaleRequest {
+    /** Opcional: el front previo cierra sin body; el wizard exige los identificadores que falten. */
+    lines?: CompleteSaleLine[];
+}

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

@@ -0,0 +1,59 @@
+"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.CompleteSaleRequest = exports.CompleteSaleLine = exports.CompleteSaleLineComponent = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Identificadores capturados en la entrega para un SKU de la línea (componente si es kit). */
+class CompleteSaleLineComponent {
+}
+exports.CompleteSaleLineComponent = CompleteSaleLineComponent;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], CompleteSaleLineComponent.prototype, "sku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CompleteSaleLineComponent.prototype, "identifiers", void 0);
+/** Línea de la sesión con los identificadores de sus piezas. */
+class CompleteSaleLine {
+}
+exports.CompleteSaleLine = CompleteSaleLine;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], CompleteSaleLine.prototype, "lineId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => CompleteSaleLineComponent),
+    __metadata("design:type", Array)
+], CompleteSaleLine.prototype, "components", void 0);
+/** POST /wizard/sessions/:id/complete-sale — cierra la venta con los identificadores de cada línea. */
+class CompleteSaleRequest {
+}
+exports.CompleteSaleRequest = CompleteSaleRequest;
+__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)(() => CompleteSaleLine),
+    __metadata("design:type", Array)
+], CompleteSaleRequest.prototype, "lines", void 0);

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

@@ -1,5 +1,7 @@
-/** DELETE /wizard/sessions/:id/product — libera la reserva del equipo (vuelve al catálogo). SureKeep Fase 2 — pista Retail. */
+/** DELETE /wizard/sessions/:id/product — quita una línea de la venta y libera su reserva en el catálogo. */
 export declare class DeleteProductRequest {
     /** Opcional a propósito: exigirlo rompe a los callers que liberan la reserva sin mandar el imei. */
     imei?: string;
+    /** Línea a quitar de la venta. */
+    lineId?: string;
 }

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

@@ -12,7 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeleteProductRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
-/** DELETE /wizard/sessions/:id/product — libera la reserva del equipo (vuelve al catálogo). SureKeep Fase 2 — pista Retail. */
+/** DELETE /wizard/sessions/:id/product — quita una línea de la venta y libera su reserva en el catálogo. */
 class DeleteProductRequest {
 }
 exports.DeleteProductRequest = DeleteProductRequest;
@@ -22,3 +22,9 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], DeleteProductRequest.prototype, "imei", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], DeleteProductRequest.prototype, "lineId", void 0);

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

@@ -8,4 +8,6 @@
 export declare class QuoteRequest {
     downPaymentCents: number;
     termWeeks: number;
+    /** Línea que se financia; su precio fijado es el del crédito. */
+    financedLineId?: string;
 }

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

@@ -34,3 +34,10 @@ __decorate([
     (0, class_validator_1.Min)(1),
     __metadata("design:type", Number)
 ], QuoteRequest.prototype, "termWeeks", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], QuoteRequest.prototype, "financedLineId", void 0);

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

@@ -0,0 +1,5 @@
+/** Query de GET /wizard/sessions/:id/lines/:lineId/identifiers; sku es el componente si la línea es kit. */
+export declare class SuggestIdentifiersQuery {
+    sku: string;
+    prefix: string;
+}

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

@@ -0,0 +1,30 @@
+"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.SuggestIdentifiersQuery = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Query de GET /wizard/sessions/:id/lines/:lineId/identifiers; sku es el componente si la línea es kit. */
+class SuggestIdentifiersQuery {
+}
+exports.SuggestIdentifiersQuery = SuggestIdentifiersQuery;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], SuggestIdentifiersQuery.prototype, "sku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(4),
+    __metadata("design:type", String)
+], SuggestIdentifiersQuery.prototype, "prefix", void 0);

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

@@ -0,0 +1,7 @@
+/** Forma de pago de una línea de la venta. */
+export declare enum LinePaymentTypeEnum {
+    /** Financiada con crédito SureKeep. */
+    CREDIT = "CREDIT",
+    /** De contado (o con tarjeta), junto con el enganche. */
+    CASH = "CASH"
+}

package/bin/retailWizard/enums/LinePaymentTypeEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LinePaymentTypeEnum = void 0;
+/** Forma de pago de una línea de la venta. */
+var LinePaymentTypeEnum;
+(function (LinePaymentTypeEnum) {
+    /** Financiada con crédito SureKeep. */
+    LinePaymentTypeEnum["CREDIT"] = "CREDIT";
+    /** De contado (o con tarjeta), junto con el enganche. */
+    LinePaymentTypeEnum["CASH"] = "CASH";
+})(LinePaymentTypeEnum || (exports.LinePaymentTypeEnum = LinePaymentTypeEnum = {}));

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

@@ -0,0 +1,9 @@
+/** Estado de una línea reservada de la sesión. */
+export declare enum WizardLineStatusEnum {
+    /** Escrita con su reservationId, antes de que el catálogo confirme la reserva. */
+    PENDING = "PENDING",
+    /** El catálogo confirmó la reserva y fijó precio. */
+    RESERVED = "RESERVED",
+    /** Marcada para liberar; pago y enganche la rechazan. */
+    RELEASING = "RELEASING"
+}

package/bin/retailWizard/enums/WizardLineStatusEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WizardLineStatusEnum = void 0;
+/** Estado de una línea reservada de la sesión. */
+var WizardLineStatusEnum;
+(function (WizardLineStatusEnum) {
+    /** Escrita con su reservationId, antes de que el catálogo confirme la reserva. */
+    WizardLineStatusEnum["PENDING"] = "PENDING";
+    /** El catálogo confirmó la reserva y fijó precio. */
+    WizardLineStatusEnum["RESERVED"] = "RESERVED";
+    /** Marcada para liberar; pago y enganche la rechazan. */
+    WizardLineStatusEnum["RELEASING"] = "RELEASING";
+})(WizardLineStatusEnum || (exports.WizardLineStatusEnum = WizardLineStatusEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -21,6 +21,8 @@ export * from './enums/AppOnboardingStepEnum';
 export * from './enums/AppOnboardingStepStatusEnum';
 export * from './enums/BlockedReasonEnum';
 export * from './enums/BlockedCategoryEnum';
+export * from './enums/WizardLineStatusEnum';
+export * from './enums/LinePaymentTypeEnum';
 export * from './dtos/WizardConsents';
 export * from './dtos/WizardPayment';
 export * from './dtos/WizardProduct';
@@ -34,6 +36,10 @@ export * from './dtos/AccountStep';
 export * from './dtos/AppOnboardingStep';
 export * from './dtos/WizardResumeTarget';
 export * from './dtos/WizardBlocked';
+export * from './dtos/WizardLineProduct';
+export * from './dtos/WizardLineIdentifiers';
+export * from './dtos/WizardReservedLine';
+export * from './dtos/SaleLine';
 export * from './dtos/WizardSession';
 export * from './dtos/OtpVerification';
 export * from './dtos/Sale';
@@ -69,6 +75,8 @@ export * from './dtos/requests/QuoteRequest';
 export * from './dtos/requests/DownPaymentRequest';
 export * from './dtos/requests/SignatureSignRequest';
 export * from './dtos/requests/RegisterDeviceRequest';
+export * from './dtos/requests/CompleteSaleRequest';
+export * from './dtos/requests/SuggestIdentifiersQuery';
 export * from './dtos/responses/KycPrepareResponse';
 export * from './dtos/responses/ProofOfAddressPrepareResponse';
 export * from './dtos/responses/SessionFinanciersResponse';

package/bin/retailWizard/index.js

@@ -39,6 +39,8 @@ __exportStar(require("./enums/AppOnboardingStepEnum"), exports);
 __exportStar(require("./enums/AppOnboardingStepStatusEnum"), exports);
 __exportStar(require("./enums/BlockedReasonEnum"), exports);
 __exportStar(require("./enums/BlockedCategoryEnum"), exports);
+__exportStar(require("./enums/WizardLineStatusEnum"), exports);
+__exportStar(require("./enums/LinePaymentTypeEnum"), exports);
 // DTOs anidados
 __exportStar(require("./dtos/WizardConsents"), exports);
 __exportStar(require("./dtos/WizardPayment"), exports);
@@ -53,6 +55,10 @@ __exportStar(require("./dtos/AccountStep"), exports);
 __exportStar(require("./dtos/AppOnboardingStep"), exports);
 __exportStar(require("./dtos/WizardResumeTarget"), exports);
 __exportStar(require("./dtos/WizardBlocked"), exports);
+__exportStar(require("./dtos/WizardLineProduct"), exports);
+__exportStar(require("./dtos/WizardLineIdentifiers"), exports);
+__exportStar(require("./dtos/WizardReservedLine"), exports);
+__exportStar(require("./dtos/SaleLine"), exports);
 // Entidades principales (shapes de estado/persistencia — planas)
 __exportStar(require("./dtos/WizardSession"), exports);
 __exportStar(require("./dtos/OtpVerification"), exports);
@@ -91,6 +97,8 @@ __exportStar(require("./dtos/requests/QuoteRequest"), exports);
 __exportStar(require("./dtos/requests/DownPaymentRequest"), exports);
 __exportStar(require("./dtos/requests/SignatureSignRequest"), exports);
 __exportStar(require("./dtos/requests/RegisterDeviceRequest"), exports);
+__exportStar(require("./dtos/requests/CompleteSaleRequest"), exports);
+__exportStar(require("./dtos/requests/SuggestIdentifiersQuery"), exports);
 // Response DTOs (output tipado por endpoint)
 __exportStar(require("./dtos/responses/KycPrepareResponse"), exports);
 __exportStar(require("./dtos/responses/ProofOfAddressPrepareResponse"), exports);

package/package.json

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

package/src/retailCatalog/dtos/Product.ts

@@ -2,6 +2,9 @@ import { MdmLockModeEnum } from '../enums/MdmLockModeEnum';
 import { MdmProviderEnum } from '../enums/MdmProviderEnum';
 import { ProductStatusEnum } from '../enums/ProductStatusEnum';
 import { ProductTierEnum } from '../enums/ProductTierEnum';
+import { ProductCategoryEnum } from '../enums/ProductCategoryEnum';
+import { TrackingModeEnum } from '../enums/TrackingModeEnum';
+import { ProductComponent } from './ProductComponent';
 
 /**
  * Product — aggregate root del catálogo del dominio `retailCatalog`
@@ -20,7 +23,8 @@ export class Product {
     description!: string;
     specs!: Record<string, unknown> | null;
     imageUrl!: string | null;
-    tier!: ProductTierEnum;
+    /** `null` = Sin gama. */
+    tier!: ProductTierEnum | null;
     basePriceCents!: number;
     listPriceCents!: number | null;
     eligibleFinanciers!: string[];
@@ -32,4 +36,16 @@ export class Product {
     updatedBy!: string;
     createdAt!: string;
     updatedAt!: string;
+
+    // Campos del inventario multi-item; opcionales hasta que todo producto pase por la puerta de entrada.
+    category?: ProductCategoryEnum;
+    trackingMode?: TrackingModeEnum;
+    /** Se puede vender suelto (fuera de un kit). */
+    sellable?: boolean;
+    /** Aparece en el catálogo del flujo de venta. */
+    showInSalesFlow?: boolean;
+    /** Solo en BUNDLE. */
+    components?: ProductComponent[] | null;
+    /** Llave del registro PRICE# del que salen basePriceCents y listPriceCents. */
+    currentPriceSk?: string | null;
 }

package/src/retailCatalog/dtos/ProductComponent.ts

@@ -0,0 +1,14 @@
+import { IsInt, IsString, Length, Matches, Min } from 'class-validator';
+import { SKU_PATTERN } from '../constants/SkuPattern';
+
+/** Componente de un kit (BUNDLE): qué SKU consume y cuántas piezas por kit. */
+export class ProductComponent {
+    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Length(1, 64)
+    @IsString()
+    sku!: string;
+
+    @IsInt()
+    @Min(1)
+    qty!: number;
+}

package/src/retailCatalog/dtos/requests/GetInventorySkuQuery.ts

@@ -0,0 +1,27 @@
+import { Type } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+import { InventoryLensPeriodEnum } from '../../enums/InventoryLensPeriodEnum';
+
+/** Query de GET /backoffice/inventory/skus/{sku} (backofficeGetInventorySku); el retailer sale del token. */
+export class GetInventorySkuQuery {
+    @IsOptional()
+    @IsEnum(InventoryLensPeriodEnum)
+    period?: InventoryLensPeriodEnum;
+
+    /** Debe pertenecer al retailer del token. */
+    @IsOptional()
+    @IsString()
+    storeId?: string;
+
+    /** Tamaño de página del libro de movimientos. */
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @Min(1)
+    @Max(100)
+    limit?: number;
+
+    @IsOptional()
+    @IsString()
+    nextToken?: string;
+}

package/src/retailCatalog/dtos/requests/InventoryLensQuery.ts

@@ -1,5 +1,6 @@
-import { IsEnum } from 'class-validator';
+import { IsEnum, IsOptional, IsString } from 'class-validator';
 import { InventoryLensFilterEnum } from '../../enums/InventoryLensFilterEnum';
+import { InventoryLensPeriodEnum } from '../../enums/InventoryLensPeriodEnum';
 
 /**
  * Query string de `GET /backoffice/inventory/lens`. SureKeep Fase 3 — pista Retail.
@@ -13,4 +14,14 @@ import { InventoryLensFilterEnum } from '../../enums/InventoryLensFilterEnum';
 export class InventoryLensQuery {
     @IsEnum(InventoryLensFilterEnum)
     filter!: InventoryLensFilterEnum;
+
+    /** Solo `filter=list`: periodo de ventas y cobertura. */
+    @IsOptional()
+    @IsEnum(InventoryLensPeriodEnum)
+    period?: InventoryLensPeriodEnum;
+
+    /** Solo `filter=list`: una tienda del retailer del token; ausente = consolidado. */
+    @IsOptional()
+    @IsString()
+    storeId?: string;
 }

package/src/retailCatalog/dtos/requests/ReleaseStockRequest.ts

@@ -0,0 +1,19 @@
+import { Type } from 'class-transformer';
+import { ArrayMinSize, IsArray, IsBoolean, IsString, ValidateNested } from 'class-validator';
+import { ReservationLineRef } from './ReservationLineRef';
+
+/** Body de PUT /private/stores/{storeId}/reservations/release (privateReleaseStock). */
+export class ReleaseStockRequest {
+    @IsString()
+    sessionId!: string;
+
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => ReservationLineRef)
+    lines!: ReservationLineRef[];
+
+    /** `true` = solo libera las reservas ya vencidas (barrido). */
+    @IsBoolean()
+    onlyExpired!: boolean;
+}

package/src/retailCatalog/dtos/requests/RenewReservationsRequest.ts

@@ -0,0 +1,15 @@
+import { Type } from 'class-transformer';
+import { ArrayMinSize, IsArray, IsString, ValidateNested } from 'class-validator';
+import { ReservationLineRef } from './ReservationLineRef';
+
+/** Body de PUT /private/stores/{storeId}/reservations/renew (privateRenewReservations). */
+export class RenewReservationsRequest {
+    @IsString()
+    sessionId!: string;
+
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => ReservationLineRef)
+    lines!: ReservationLineRef[];
+}

package/src/retailCatalog/dtos/requests/ReservationLineRef.ts

@@ -0,0 +1,10 @@
+import { IsString } from 'class-validator';
+
+/** Una línea de la venta y la reserva que la respalda; la usan renew y release. */
+export class ReservationLineRef {
+    @IsString()
+    lineId!: string;
+
+    @IsString()
+    reservationId!: string;
+}

package/src/retailCatalog/dtos/requests/ReserveStockRequest.ts

@@ -0,0 +1,24 @@
+import { IsInt, IsString, Min } from 'class-validator';
+
+/** Body de PUT /private/stores/{storeId}/reservations (privateReserveStock); reserva una línea, kit completo. */
+export class ReserveStockRequest {
+    @IsString()
+    sessionId!: string;
+
+    @IsString()
+    lineId!: string;
+
+    /** Llave de idempotencia; un id nuevo por cada intento de reserva. */
+    @IsString()
+    reservationId!: string;
+
+    @IsString()
+    retailerId!: string;
+
+    @IsString()
+    sku!: string;
+
+    @IsInt()
+    @Min(1)
+    qty!: number;
+}

package/src/retailCatalog/dtos/requests/ReturnStockRequest.ts

@@ -0,0 +1,22 @@
+import { Type } from 'class-transformer';
+import { ArrayMinSize, IsArray, IsISO8601, IsString, ValidateNested } from 'class-validator';
+import { StockLine } from './StockLine';
+
+/** Body de PUT /private/stores/{storeId}/returns (privateReturnStock); componentes guardados en la venta. */
+export class ReturnStockRequest {
+    @IsString()
+    saleId!: string;
+
+    @IsString()
+    retailerId!: string;
+
+    /** Fecha de la venta; fija el día de negocio del contador DAY# que se descuenta. */
+    @IsISO8601()
+    soldAt!: string;
+
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => StockLine)
+    lines!: StockLine[];
+}

package/src/retailCatalog/dtos/requests/SellStockRequest.ts

@@ -0,0 +1,18 @@
+import { Type } from 'class-transformer';
+import { ArrayMinSize, IsArray, IsString, ValidateNested } from 'class-validator';
+import { StockLine } from './StockLine';
+
+/** Body de PUT /private/stores/{storeId}/sales (privateSellStock); una TX de venta. */
+export class SellStockRequest {
+    @IsString()
+    sessionId!: string;
+
+    @IsString()
+    retailerId!: string;
+
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => StockLine)
+    lines!: StockLine[];
+}

package/src/retailCatalog/dtos/requests/StockLine.ts

@@ -0,0 +1,36 @@
+import { Type } from 'class-transformer';
+import { ArrayMinSize, IsArray, IsInt, IsString, Min, ValidateNested } from 'class-validator';
+
+/** Componente de una línea con las piezas que se entregan; un producto suelto es un solo componente. */
+export class StockLineComponent {
+    @IsString()
+    sku!: string;
+
+    @IsInt()
+    @Min(1)
+    qty!: number;
+
+    /** IMEI o serie de cada pieza; vacío si el SKU se rastrea por cantidad. */
+    @IsArray()
+    @IsString({ each: true })
+    identifiers!: string[];
+}
+
+/** Línea de venta o devolución con sus componentes; la usan sell y return. */
+export class StockLine {
+    @IsString()
+    lineId!: string;
+
+    @IsString()
+    sku!: string;
+
+    @IsInt()
+    @Min(1)
+    qty!: number;
+
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => StockLineComponent)
+    components!: StockLineComponent[];
+}

package/src/retailCatalog/dtos/requests/SuggestPiecesQuery.ts

@@ -0,0 +1,11 @@
+import { IsString, MinLength } from 'class-validator';
+
+/** Query de GET /private/stores/{storeId}/pieces (privateSuggestPieces); sku es el componente si es kit. */
+export class SuggestPiecesQuery {
+    @IsString()
+    sku!: string;
+
+    @IsString()
+    @MinLength(4)
+    prefix!: string;
+}