@fiado/type-kit 3.642.0 → 3.644.0

package/_test_/unit/loanCredit/creditLifecycleEnums.test.ts

@@ -37,7 +37,7 @@ describe.each([
     ['LoanSettlementStatusEnum', LoanSettlementStatusEnum, ['PENDING']],
     ['LoanAdHocChargeKindEnum', LoanAdHocChargeKindEnum, ['SETTLEMENT', 'RECOVERY', 'PREPAYMENT', 'ADVANCE']],
     ['WrittenOffRecoveryTypeEnum', WrittenOffRecoveryTypeEnum, ['OVERDUE', 'SETTLEMENT']],
-    ['LoanRestructureStatusEnum', LoanRestructureStatusEnum, ['PROPOSED', 'APPROVED', 'REJECTED', 'PENDING_REGISTRATION', 'EXECUTED']],
+    ['LoanRestructureStatusEnum', LoanRestructureStatusEnum, ['PROPOSED', 'APPROVED', 'REJECTED', 'PENDING_REGISTRATION', 'EXECUTED', 'CANCELLED']],
     ['LoanChargeKindEnum', LoanChargeKindEnum, ['INSTALLMENT', 'SETTLEMENT', 'RECOVERY', 'PREPAYMENT', 'ADVANCE']],
     [
         'PaymentReviewReasonEnum',

package/_test_/unit/loanCredit/dtos/creditLifecycleRequests.test.ts

@@ -3,6 +3,7 @@ import { plainToInstance } from 'class-transformer';
 import { validate } from 'class-validator';
 import {
     BackofficeAcceptRestructureRequest,
+    BackofficeCancelRestructureRequest,
     BackofficeApplyAdvanceRequest,
     BackofficeApplyPrepaymentRequest,
     BackofficeApproveRestructureRequest,
@@ -126,6 +127,14 @@ describe('BackofficeRejectRestructureRequest', () => {
     });
 });
 
+describe('BackofficeCancelRestructureRequest', () => {
+    it('exige el motivo, con el mismo tope que el rechazo', async () => {
+        expect(await errorPaths(BackofficeCancelRestructureRequest, {})).toContain('reason');
+        expect(await errorPaths(BackofficeCancelRestructureRequest, { reason: '' })).toContain('reason');
+        expect(await errorPaths(BackofficeCancelRestructureRequest, { reason: 'El cliente no la aceptó' })).toEqual([]);
+    });
+});
+
 describe('BackofficeAcceptRestructureRequest', () => {
     it('acepta un OTP de 4 dígitos', async () => {
         expect(await errorPaths(BackofficeAcceptRestructureRequest, { otpCode: '0427' })).toEqual([]);

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/loanCredit/dtos/requests/BackofficeCancelRestructureRequest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Body de `POST /backoffice/credits/:creditId/restructures/:restructureId/cancel` (loan-credit-business). Cierra
+ * una propuesta o una aprobada que el cliente todavía no acepta.
+ */
+export declare class BackofficeCancelRestructureRequest {
+    /** Motivo de la cancelación. Va a la auditoría y no se loguea. */
+    reason: string;
+}

package/bin/loanCredit/dtos/requests/BackofficeCancelRestructureRequest.js

@@ -0,0 +1,29 @@
+"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.BackofficeCancelRestructureRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const LoanInputLimits_1 = require("../../constants/LoanInputLimits");
+/**
+ * Body de `POST /backoffice/credits/:creditId/restructures/:restructureId/cancel` (loan-credit-business). Cierra
+ * una propuesta o una aprobada que el cliente todavía no acepta.
+ */
+class BackofficeCancelRestructureRequest {
+}
+exports.BackofficeCancelRestructureRequest = BackofficeCancelRestructureRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(LoanInputLimits_1.LOAN_FREE_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], BackofficeCancelRestructureRequest.prototype, "reason", void 0);

package/bin/loanCredit/enums/LoanRestructureStatusEnum.d.ts

@@ -1,5 +1,6 @@
 /**
  * Estado de la reestructura. `PENDING_REGISTRATION`: el plan nuevo está escrito y falta confirmar el alta de sus cargos.
+ * `CANCELLED`: la propuesta o la aprobada sin aceptar se cerró, a mano o porque el crédito se cerró; no gasta el cupo.
  * @enum {string}
  */
 export declare enum LoanRestructureStatusEnum {
@@ -7,5 +8,6 @@ export declare enum LoanRestructureStatusEnum {
     APPROVED = "APPROVED",
     REJECTED = "REJECTED",
     PENDING_REGISTRATION = "PENDING_REGISTRATION",
-    EXECUTED = "EXECUTED"
+    EXECUTED = "EXECUTED",
+    CANCELLED = "CANCELLED"
 }

package/bin/loanCredit/enums/LoanRestructureStatusEnum.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LoanRestructureStatusEnum = void 0;
 /**
  * Estado de la reestructura. `PENDING_REGISTRATION`: el plan nuevo está escrito y falta confirmar el alta de sus cargos.
+ * `CANCELLED`: la propuesta o la aprobada sin aceptar se cerró, a mano o porque el crédito se cerró; no gasta el cupo.
  * @enum {string}
  */
 var LoanRestructureStatusEnum;
@@ -12,4 +13,5 @@ var LoanRestructureStatusEnum;
     LoanRestructureStatusEnum["REJECTED"] = "REJECTED";
     LoanRestructureStatusEnum["PENDING_REGISTRATION"] = "PENDING_REGISTRATION";
     LoanRestructureStatusEnum["EXECUTED"] = "EXECUTED";
+    LoanRestructureStatusEnum["CANCELLED"] = "CANCELLED";
 })(LoanRestructureStatusEnum || (exports.LoanRestructureStatusEnum = LoanRestructureStatusEnum = {}));

package/bin/loanCredit/index.d.ts

@@ -126,6 +126,7 @@ export * from './dtos/requests/BackofficeCollectWrittenOffCreditRequest';
 export * from './dtos/requests/BackofficeProposeRestructureRequest';
 export * from './dtos/requests/BackofficeApproveRestructureRequest';
 export * from './dtos/requests/BackofficeRejectRestructureRequest';
+export * from './dtos/requests/BackofficeCancelRestructureRequest';
 export * from './dtos/requests/BackofficeAcceptRestructureRequest';
 export * from './dtos/requests/BackofficeApplyPrepaymentRequest';
 export * from './dtos/requests/BackofficeApplyAdvanceRequest';

package/bin/loanCredit/index.js

@@ -168,6 +168,7 @@ __exportStar(require("./dtos/requests/BackofficeCollectWrittenOffCreditRequest")
 __exportStar(require("./dtos/requests/BackofficeProposeRestructureRequest"), exports);
 __exportStar(require("./dtos/requests/BackofficeApproveRestructureRequest"), exports);
 __exportStar(require("./dtos/requests/BackofficeRejectRestructureRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeCancelRestructureRequest"), exports);
 __exportStar(require("./dtos/requests/BackofficeAcceptRestructureRequest"), exports);
 __exportStar(require("./dtos/requests/BackofficeApplyPrepaymentRequest"), exports);
 __exportStar(require("./dtos/requests/BackofficeApplyAdvanceRequest"), exports);

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.644.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/loanCredit/dtos/requests/BackofficeCancelRestructureRequest.ts

@@ -0,0 +1,16 @@
+import { Expose } from 'class-transformer';
+import { IsString, MaxLength, MinLength } from 'class-validator';
+import { LOAN_FREE_TEXT_MAX_LENGTH } from '../../constants/LoanInputLimits';
+
+/**
+ * Body de `POST /backoffice/credits/:creditId/restructures/:restructureId/cancel` (loan-credit-business). Cierra
+ * una propuesta o una aprobada que el cliente todavía no acepta.
+ */
+export class BackofficeCancelRestructureRequest {
+    /** Motivo de la cancelación. Va a la auditoría y no se loguea. */
+    @Expose()
+    @IsString()
+    @MinLength(1)
+    @MaxLength(LOAN_FREE_TEXT_MAX_LENGTH)
+    reason!: string;
+}

package/src/loanCredit/enums/LoanRestructureStatusEnum.ts

@@ -1,5 +1,6 @@
 /**
  * Estado de la reestructura. `PENDING_REGISTRATION`: el plan nuevo está escrito y falta confirmar el alta de sus cargos.
+ * `CANCELLED`: la propuesta o la aprobada sin aceptar se cerró, a mano o porque el crédito se cerró; no gasta el cupo.
  * @enum {string}
  */
 export enum LoanRestructureStatusEnum {
@@ -8,4 +9,5 @@ export enum LoanRestructureStatusEnum {
     REJECTED = 'REJECTED',
     PENDING_REGISTRATION = 'PENDING_REGISTRATION',
     EXECUTED = 'EXECUTED',
+    CANCELLED = 'CANCELLED',
 }

package/src/loanCredit/index.ts

@@ -150,6 +150,7 @@ export * from './dtos/requests/BackofficeCollectWrittenOffCreditRequest';
 export * from './dtos/requests/BackofficeProposeRestructureRequest';
 export * from './dtos/requests/BackofficeApproveRestructureRequest';
 export * from './dtos/requests/BackofficeRejectRestructureRequest';
+export * from './dtos/requests/BackofficeCancelRestructureRequest';
 export * from './dtos/requests/BackofficeAcceptRestructureRequest';
 export * from './dtos/requests/BackofficeApplyPrepaymentRequest';
 export * from './dtos/requests/BackofficeApplyAdvanceRequest';

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';