@fiado/type-kit 3.642.0 → 3.643.0

package/_test_/unit/retailCatalog/reserveStockCarry.test.ts

@@ -0,0 +1,42 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync, type ValidationError } from 'class-validator';
+import {
+  ReserveStockErrorCodeEnum,
+  ReserveStockRequest,
+  type ReserveStockResponse,
+  type StoreCatalogItem,
+} from '../../../src/retailCatalog';
+
+function paths(errors: ValidationError[], prefix = ''): string[] {
+  return errors.flatMap((e) => {
+    const p = prefix ? `${prefix}.${e.property}` : e.property;
+    return e.children && e.children.length > 0 ? paths(e.children, p) : [p];
+  });
+}
+
+const errorsOf = (payload: object): string[] => paths(validateSync(plainToInstance(ReserveStockRequest, payload) as object));
+
+describe('ReserveStockRequest.carry', () => {
+  const ok = { sessionId: 's', lineId: 'L2', reservationId: 'r2', retailerId: 'ret', sku: 'KIT-1', qty: 1 };
+  const carry = { lineId: 'L1', reservationId: 'r1', sku: 'PHONE-1', qty: 1 };
+
+  it('es opcional', () => expect(errorsOf(ok)).toEqual([]));
+  it('acepta reservas a traspasar', () => expect(errorsOf({ ...ok, carry: [carry] })).toEqual([]));
+  it('valida cada reserva anidada', () => {
+    expect(errorsOf({ ...ok, carry: [{ ...carry, qty: 0 }] })).toContain('carry.0.qty');
+    expect(errorsOf({ ...ok, carry: [{ ...carry, reservationId: undefined }] })).toContain('carry.0.reservationId');
+  });
+  it('rechaza carry que no es lista', () => expect(errorsOf({ ...ok, carry: carry })).toContain('carry'));
+});
+
+describe('contrato del traspaso', () => {
+  it('expone el código CARRY_UNAVAILABLE', () => {
+    expect(ReserveStockErrorCodeEnum.CARRY_UNAVAILABLE).toBe('CARRY_UNAVAILABLE');
+  });
+  it('la respuesta lleva lo traspasado y el catálogo el disponible por sesión', () => {
+    const carried: ReserveStockResponse['carried'] = [{ sku: 'PHONE-1', qty: 1 }];
+    const forSession: StoreCatalogItem['availableForSession'] = 1;
+    expect([carried, forSession]).toEqual([[{ sku: 'PHONE-1', qty: 1 }], 1]);
+  });
+});

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

@@ -0,0 +1,7 @@
+/** Reserva de la misma sesión que se traspasa a la línea nueva sin apartar otra pieza. */
+export declare class ReserveStockCarry {
+    lineId: string;
+    reservationId: string;
+    sku: string;
+    qty: number;
+}

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

@@ -0,0 +1,34 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReserveStockCarry = void 0;
+const class_validator_1 = require("class-validator");
+/** Reserva de la misma sesión que se traspasa a la línea nueva sin apartar otra pieza. */
+class ReserveStockCarry {
+}
+exports.ReserveStockCarry = ReserveStockCarry;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ReserveStockCarry.prototype, "lineId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ReserveStockCarry.prototype, "reservationId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ReserveStockCarry.prototype, "sku", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], ReserveStockCarry.prototype, "qty", void 0);

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

@@ -1,4 +1,5 @@
 import { ReservePurposeEnum } from '../../enums/ReservePurposeEnum';
+import { ReserveStockCarry } from './ReserveStockCarry';
 /** Body de PUT /private/stores/{storeId}/reservations (privateReserveStock); reserva una línea, kit completo. */
 export declare class ReserveStockRequest {
     sessionId: string;
@@ -10,4 +11,6 @@ export declare class ReserveStockRequest {
     qty: number;
     /** GIFT aparta un regalo de Promociones; ausente = apartado normal de venta. */
     purpose?: ReservePurposeEnum;
+    /** Reservas de la misma sesión que pasan a esta línea en la misma TX, sin tocar el saldo. */
+    carry?: ReserveStockCarry[];
 }

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

@@ -10,8 +10,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReserveStockRequest = void 0;
+const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const ReservePurposeEnum_1 = require("../../enums/ReservePurposeEnum");
+const ReserveStockCarry_1 = require("./ReserveStockCarry");
 /** Body de PUT /private/stores/{storeId}/reservations (privateReserveStock); reserva una línea, kit completo. */
 class ReserveStockRequest {
 }
@@ -46,3 +48,10 @@ __decorate([
     (0, class_validator_1.IsEnum)(ReservePurposeEnum_1.ReservePurposeEnum),
     __metadata("design:type", String)
 ], ReserveStockRequest.prototype, "purpose", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ReserveStockCarry_1.ReserveStockCarry),
+    __metadata("design:type", Array)
+], ReserveStockRequest.prototype, "carry", void 0);

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

@@ -10,6 +10,11 @@ export interface ReservedComponent {
     /** Precio vigente del componente, para repartir el precio del kit. */
     priceCents?: number;
 }
+/** Piezas que la línea recibió traspasadas de otra reserva de la sesión. */
+export interface CarriedStock {
+    sku: string;
+    qty: number;
+}
 /** Response de privateReserveStock; el precio de la línea es `basePriceCents`. */
 export interface ReserveStockResponse {
     expiresAt: string;
@@ -27,4 +32,6 @@ export interface ReserveStockResponse {
     mdmProvider: MdmProviderEnum | null;
     /** Solo si la línea es un kit. */
     components?: ReservedComponent[];
+    /** Solo si el request trajo `carry`: lo que se traspasó por SKU. */
+    carried?: CarriedStock[];
 }

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

@@ -15,6 +15,8 @@ export interface StoreCatalogItem {
     sku: string;
     /** Piezas disponibles; en un kit, el mínimo que alcanzan sus componentes. */
     available: number;
+    /** Solo en kits y con `sessionId`: kits que alcanzan sumando lo que la sesión ya tiene apartado. */
+    availableForSession?: number;
     basePriceCents: number;
     category: ProductCategoryEnum;
     /** Solo en ACCESSORY. */

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

@@ -0,0 +1,5 @@
+/** Códigos de error de privateReserveStock que el llamador resuelve por su cuenta. */
+export declare enum ReserveStockErrorCodeEnum {
+    /** La reserva a traspasar ya no está, cambió de qty, tiene piezas HELD o ya se soltó: reserva normal. */
+    CARRY_UNAVAILABLE = "CARRY_UNAVAILABLE"
+}

package/bin/retailCatalog/enums/ReserveStockErrorCodeEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReserveStockErrorCodeEnum = void 0;
+/** Códigos de error de privateReserveStock que el llamador resuelve por su cuenta. */
+var ReserveStockErrorCodeEnum;
+(function (ReserveStockErrorCodeEnum) {
+    /** La reserva a traspasar ya no está, cambió de qty, tiene piezas HELD o ya se soltó: reserva normal. */
+    ReserveStockErrorCodeEnum["CARRY_UNAVAILABLE"] = "CARRY_UNAVAILABLE";
+})(ReserveStockErrorCodeEnum || (exports.ReserveStockErrorCodeEnum = ReserveStockErrorCodeEnum = {}));

package/bin/retailCatalog/index.d.ts

@@ -42,6 +42,7 @@ export * from './dtos/requests/ReservationLineRef';
 export * from './dtos/requests/StockLine';
 export * from './dtos/requests/ReturnPieceCondition';
 export * from './dtos/requests/ReturnStockLine';
+export * from './dtos/requests/ReserveStockCarry';
 export * from './dtos/requests/ReserveStockRequest';
 export * from './dtos/requests/RenewReservationsRequest';
 export * from './dtos/requests/SuggestPiecesQuery';
@@ -78,6 +79,7 @@ export * from './dtos/requests/BackofficeListTransfersQuery';
 export * from './dtos/responses/TransferResponse';
 export * from './dtos/responses/ListTransfersResponse';
 export * from './enums/ReservePurposeEnum';
+export * from './enums/ReserveStockErrorCodeEnum';
 export * from './enums/InventoryInboundMessageTypeEnum';
 export * from './dtos/requests/HoldStockRequest';
 export * from './dtos/responses/HoldStockResponse';

package/bin/retailCatalog/index.js

@@ -66,6 +66,7 @@ __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/ReserveStockCarry"), exports);
 __exportStar(require("./dtos/requests/ReserveStockRequest"), exports);
 __exportStar(require("./dtos/requests/RenewReservationsRequest"), exports);
 __exportStar(require("./dtos/requests/SuggestPiecesQuery"), exports);
@@ -104,6 +105,7 @@ __exportStar(require("./dtos/responses/TransferResponse"), exports);
 __exportStar(require("./dtos/responses/ListTransfersResponse"), exports);
 // Saga de venta: hold y avisos de la cola
 __exportStar(require("./enums/ReservePurposeEnum"), exports);
+__exportStar(require("./enums/ReserveStockErrorCodeEnum"), exports);
 __exportStar(require("./enums/InventoryInboundMessageTypeEnum"), exports);
 __exportStar(require("./dtos/requests/HoldStockRequest"), exports);
 __exportStar(require("./dtos/responses/HoldStockResponse"), exports);

package/package.json

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

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

@@ -0,0 +1,17 @@
+import { IsInt, IsString, Min } from 'class-validator';
+
+/** Reserva de la misma sesión que se traspasa a la línea nueva sin apartar otra pieza. */
+export class ReserveStockCarry {
+    @IsString()
+    lineId!: string;
+
+    @IsString()
+    reservationId!: string;
+
+    @IsString()
+    sku!: string;
+
+    @IsInt()
+    @Min(1)
+    qty!: number;
+}

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

@@ -1,5 +1,7 @@
-import { IsEnum, IsInt, IsOptional, IsString, Min } from 'class-validator';
+import { Type } from 'class-transformer';
+import { IsArray, IsEnum, IsInt, IsOptional, IsString, Min, ValidateNested } from 'class-validator';
 import { ReservePurposeEnum } from '../../enums/ReservePurposeEnum';
+import { ReserveStockCarry } from './ReserveStockCarry';
 
 /** Body de PUT /private/stores/{storeId}/reservations (privateReserveStock); reserva una línea, kit completo. */
 export class ReserveStockRequest {
@@ -27,4 +29,11 @@ export class ReserveStockRequest {
     @IsOptional()
     @IsEnum(ReservePurposeEnum)
     purpose?: ReservePurposeEnum;
+
+    /** Reservas de la misma sesión que pasan a esta línea en la misma TX, sin tocar el saldo. */
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => ReserveStockCarry)
+    carry?: ReserveStockCarry[];
 }

package/src/retailCatalog/dtos/responses/ReserveStockResponse.ts

@@ -12,6 +12,12 @@ export interface ReservedComponent {
     priceCents?: number;
 }
 
+/** Piezas que la línea recibió traspasadas de otra reserva de la sesión. */
+export interface CarriedStock {
+    sku: string;
+    qty: number;
+}
+
 /** Response de privateReserveStock; el precio de la línea es `basePriceCents`. */
 export interface ReserveStockResponse {
     expiresAt: string;
@@ -29,4 +35,6 @@ export interface ReserveStockResponse {
     mdmProvider: MdmProviderEnum | null;
     /** Solo si la línea es un kit. */
     components?: ReservedComponent[];
+    /** Solo si el request trajo `carry`: lo que se traspasó por SKU. */
+    carried?: CarriedStock[];
 }

package/src/retailCatalog/dtos/responses/StoreCatalogItem.ts

@@ -17,6 +17,8 @@ export interface StoreCatalogItem {
     sku: string;
     /** Piezas disponibles; en un kit, el mínimo que alcanzan sus componentes. */
     available: number;
+    /** Solo en kits y con `sessionId`: kits que alcanzan sumando lo que la sesión ya tiene apartado. */
+    availableForSession?: number;
     basePriceCents: number;
     category: ProductCategoryEnum;
     /** Solo en ACCESSORY. */

package/src/retailCatalog/enums/ReserveStockErrorCodeEnum.ts

@@ -0,0 +1,5 @@
+/** Códigos de error de privateReserveStock que el llamador resuelve por su cuenta. */
+export enum ReserveStockErrorCodeEnum {
+    /** La reserva a traspasar ya no está, cambió de qty, tiene piezas HELD o ya se soltó: reserva normal. */
+    CARRY_UNAVAILABLE = 'CARRY_UNAVAILABLE',
+}

package/src/retailCatalog/index.ts

@@ -58,6 +58,7 @@ export * from './dtos/requests/ReservationLineRef';
 export * from './dtos/requests/StockLine';
 export * from './dtos/requests/ReturnPieceCondition';
 export * from './dtos/requests/ReturnStockLine';
+export * from './dtos/requests/ReserveStockCarry';
 export * from './dtos/requests/ReserveStockRequest';
 export * from './dtos/requests/RenewReservationsRequest';
 export * from './dtos/requests/SuggestPiecesQuery';
@@ -98,6 +99,7 @@ export * from './dtos/responses/ListTransfersResponse';
 
 // Saga de venta: hold y avisos de la cola
 export * from './enums/ReservePurposeEnum';
+export * from './enums/ReserveStockErrorCodeEnum';
 export * from './enums/InventoryInboundMessageTypeEnum';
 export * from './dtos/requests/HoldStockRequest';
 export * from './dtos/responses/HoldStockResponse';