@fiado/type-kit 3.567.0 → 3.569.0

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

@@ -68,6 +68,11 @@ describe('SellStockRequest y ReturnStockRequest', () => {
     const bad = { ...saleLine, components: [{ sku: 'SIM-1', qty: 1, identifiers: [123] }] };
     expect(errorsOf(SellStockRequest, { sessionId: 's', retailerId: 'ret', lines: [bad] })).toContain('lines.0.components.0.identifiers');
   });
+  it('acepta saleId opcional', () => {
+    const base = { sessionId: 's', retailerId: 'ret', lines: [saleLine] };
+    expect(errorsOf(SellStockRequest, { ...base, saleId: 'sale-1' })).toEqual([]);
+    expect(errorsOf(SellStockRequest, { ...base, saleId: 123 })).toContain('saleId');
+  });
   it('devolución exige saleId y soldAt ISO', () => {
     const ok = { saleId: 'sale', retailerId: 'ret', soldAt: '2026-09-23T10:00:00.000Z', lines: [saleLine] };
     expect(errorsOf(ReturnStockRequest, ok)).toEqual([]);
@@ -153,4 +158,17 @@ describe('GetInventorySkuQuery', () => {
     expect(validateSync(dto)).toEqual([]);
   });
   it('rechaza limit fuera de rango', () => expect(errorsOf(GetInventorySkuQuery, { limit: '0' })).toContain('limit'));
+  it.each([
+    [true, true],
+    [false, false],
+    ['true', true],
+    ['false', false],
+  ])('convierte includeHolds %p a %p', (raw, expected) => {
+    const dto = plainToInstance(GetInventorySkuQuery, { includeHolds: raw });
+    expect(dto.includeHolds).toBe(expected);
+    expect(validateSync(dto)).toEqual([]);
+  });
+  it('rechaza includeHolds no booleano', () => {
+    expect(errorsOf(GetInventorySkuQuery, { includeHolds: 'x' })).toContain('includeHolds');
+  });
 });

package/_test_/unit/retailWizard/storePendingRefundsResponse.test.ts

@@ -0,0 +1,33 @@
+import 'reflect-metadata';
+import { RefundStatusEnum, SalePaymentMethodEnum } from '../../../src/retailWizard';
+import type { StorePendingRefundsResponse } from '../../../src/retailWizard';
+
+describe('StorePendingRefundsResponse', () => {
+  it('expone el estado del reembolso y el trail de la entrega', () => {
+    const response: StorePendingRefundsResponse = {
+      refunds: [
+        {
+          sessionId: 'S1',
+          storeId: 'ST-1',
+          sellerId: 'RU-1',
+          sellerName: 'Ana',
+          creditId: 'C-1',
+          folio: 'ENG-1',
+          refundPendingCents: 150000,
+          paymentMethod: SalePaymentMethodEnum.CASH,
+          status: RefundStatusEnum.DELIVERED,
+          deliverable: false,
+          cancelledAt: '2026-10-20T10:00:00.000Z',
+          cancelledBy: 'sub-cancel',
+          deliveredAt: '2026-10-21T10:00:00.000Z',
+          deliveredBy: 'sub-v',
+          deliveredByName: 'Ana',
+        },
+      ],
+      pendingCount: 0,
+      pendingTotalCents: 0,
+    };
+    expect(response.refunds[0].status).toBe('DELIVERED');
+    expect(Object.values(RefundStatusEnum)).toEqual(['PENDING', 'DELIVERED']);
+  });
+});

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

@@ -7,4 +7,6 @@ export declare class GetInventorySkuQuery {
     /** Tamaño de página del libro de movimientos. */
     limit?: number;
     nextToken?: string;
+    /** `true` incluye en el libro los movimientos RESERVATION y RELEASE. */
+    includeHolds?: boolean;
 }

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

@@ -40,3 +40,9 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], GetInventorySkuQuery.prototype, "nextToken", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => (value === 'true' ? true : value === 'false' ? false : value)),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], GetInventorySkuQuery.prototype, "includeHolds", void 0);

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

@@ -4,4 +4,6 @@ export declare class SellStockRequest {
     sessionId: string;
     retailerId: string;
     lines: StockLine[];
+    /** Venta a la que pertenece; liga los MOV# de la TX con ella. */
+    saleId?: string;
 }

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

@@ -32,3 +32,8 @@ __decorate([
     (0, class_transformer_1.Type)(() => StockLine_1.StockLine),
     __metadata("design:type", Array)
 ], SellStockRequest.prototype, "lines", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SellStockRequest.prototype, "saleId", void 0);

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

@@ -18,6 +18,15 @@ export interface InventoryMovementEntry {
     reason?: InventoryMovementReasonEnum;
     /** Id del MOV#, para ligar un ajuste con reversesMovementId. */
     movementId?: string;
+    /** Traspaso al que pertenece el movimiento, si es uno. */
+    transferId?: string;
+    /** Venta a la que pertenece el movimiento, si es una. */
+    saleId?: string;
+}
+/** Unidades apartadas (BALANCE#.reserved) del SKU en una tienda. */
+export interface InventoryStoreReserved {
+    storeId: string;
+    reserved: number;
 }
 /** Pieza de una tienda; status AVAILABLE, SOLD o DAMAGED. */
 export interface InventoryPieceEntry {
@@ -37,6 +46,7 @@ export interface GetInventorySkuResponse {
     nextToken: string | null;
     /** Vacío si el SKU se rastrea por cantidad. */
     piecesByStore: InventoryStorePieces[];
+    reservedByStore: InventoryStoreReserved[];
     currentPrice: SkuPriceEntry | null;
     /** Promos de venta vigentes del SKU; `null` si retail-promotions no respondió. */
     promotions?: ActiveSalePromotionSummary[] | null;

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

@@ -85,6 +85,8 @@ export interface InventoryLensStoreStock {
     storeId: string;
     stock: number;
     sold: number;
+    /** Unidades apartadas (BALANCE#.reserved). */
+    reserved: number;
 }
 /** Alertas de una fila del modo lista. */
 export interface InventoryLensAlerts {
@@ -110,6 +112,8 @@ export interface InventoryLensListItem {
     storesWithStock: number;
     storesTotal: number;
     byStore: InventoryLensStoreStock[];
+    /** Suma de `reserved` de todas las tiendas. */
+    reservedTotal: number;
     soldPeriod: number;
     coverage: InventoryLensCoverage;
     alerts: InventoryLensAlerts;

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

@@ -6,6 +6,7 @@ export declare class InventorySaleAppliedMessage extends SellStockRequest {
     /** La cola es compartida entre silos; el tenant elige las tablas. */
     tenantId: string;
     storeId: string;
+    /** El ValidateIf anula el @IsOptional que hereda de SellStockRequest: aquí saleId es obligatorio. */
     saleId: string;
     /** Fecha de la venta; fecha el DAY# y el MOV#. */
     soldAt: string;

package/bin/retailCatalog/events/InventorySaleAppliedMessage.js

@@ -32,6 +32,7 @@ __decorate([
     __metadata("design:type", String)
 ], InventorySaleAppliedMessage.prototype, "storeId", void 0);
 __decorate([
+    (0, class_validator_1.ValidateIf)(() => true),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)

package/bin/retailWizard/dtos/SellerPendingRefundItem.d.ts

@@ -0,0 +1,23 @@
+import { RefundStatusEnum } from '../enums/RefundStatusEnum';
+import { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+/** Un reembolso de enganche de la tienda en el Portal Vendedor (GET /portal/pending-refunds). */
+export interface SellerPendingRefundItem {
+    sessionId: string;
+    storeId: string;
+    sellerId: string | null;
+    sellerName: string | null;
+    creditId: string | null;
+    folio: string | null;
+    refundPendingCents: number;
+    /** `null` = el registro no guardó con qué se cobró el enganche; no se puede marcar entregado. */
+    paymentMethod: SalePaymentMethodEnum | null;
+    status: RefundStatusEnum;
+    /** `true` si el vendedor puede marcarlo entregado: efectivo y pendiente. */
+    deliverable: boolean;
+    cancelledAt: string;
+    /** Actor que canceló la venta (cognitoSub o nombre del lambda). */
+    cancelledBy: string;
+    deliveredAt: string | null;
+    deliveredBy: string | null;
+    deliveredByName: string | null;
+}

package/bin/retailWizard/dtos/SellerPendingRefundItem.js

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

package/bin/retailWizard/dtos/responses/StorePendingRefundsResponse.d.ts

@@ -0,0 +1,7 @@
+import { SellerPendingRefundItem } from '../SellerPendingRefundItem';
+/** Respuesta de GET /portal/pending-refunds: pendientes de la tienda y entregados de los últimos 30 días. */
+export interface StorePendingRefundsResponse {
+    refunds: SellerPendingRefundItem[];
+    pendingCount: number;
+    pendingTotalCents: number;
+}

package/bin/retailWizard/dtos/responses/StorePendingRefundsResponse.js

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

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

@@ -0,0 +1,5 @@
+/** Estado del reembolso de enganche de una venta a crédito cancelada. SureKeep — Portal Vendedor. */
+export declare enum RefundStatusEnum {
+    PENDING = "PENDING",
+    DELIVERED = "DELIVERED"
+}

package/bin/retailWizard/enums/RefundStatusEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefundStatusEnum = void 0;
+/** Estado del reembolso de enganche de una venta a crédito cancelada. SureKeep — Portal Vendedor. */
+var RefundStatusEnum;
+(function (RefundStatusEnum) {
+    RefundStatusEnum["PENDING"] = "PENDING";
+    RefundStatusEnum["DELIVERED"] = "DELIVERED";
+})(RefundStatusEnum || (exports.RefundStatusEnum = RefundStatusEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -7,6 +7,7 @@ export * from './enums/PaymentMethodEnum';
 export * from './enums/ExternalProviderEnum';
 export * from './enums/SaleTypeEnum';
 export * from './enums/SalePaymentMethodEnum';
+export * from './enums/RefundStatusEnum';
 export * from './enums/SaleStatusEnum';
 export * from './enums/CentralSyncStatusEnum';
 export * from './enums/ProspectStatusEnum';
@@ -102,6 +103,8 @@ export * from './dtos/requests/SuggestIdentifiersQuery';
 export * from './dtos/requests/SendEmailOtpRequest';
 export * from './dtos/requests/VerifyEmailOtpRequest';
 export * from './dtos/requests/CreateAccessorySaleRequest';
+export * from './dtos/SellerPendingRefundItem';
+export * from './dtos/responses/StorePendingRefundsResponse';
 export * from './dtos/responses/KycPrepareResponse';
 export * from './dtos/responses/ProofOfAddressPrepareResponse';
 export * from './dtos/responses/SessionFinanciersResponse';

package/bin/retailWizard/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./enums/PaymentMethodEnum"), exports);
 __exportStar(require("./enums/ExternalProviderEnum"), exports);
 __exportStar(require("./enums/SaleTypeEnum"), exports);
 __exportStar(require("./enums/SalePaymentMethodEnum"), exports);
+__exportStar(require("./enums/RefundStatusEnum"), exports);
 __exportStar(require("./enums/SaleStatusEnum"), exports);
 __exportStar(require("./enums/CentralSyncStatusEnum"), exports);
 __exportStar(require("./enums/ProspectStatusEnum"), exports);
@@ -128,6 +129,8 @@ __exportStar(require("./dtos/requests/SendEmailOtpRequest"), exports);
 __exportStar(require("./dtos/requests/VerifyEmailOtpRequest"), exports);
 __exportStar(require("./dtos/requests/CreateAccessorySaleRequest"), exports);
 // Response DTOs (output tipado por endpoint)
+__exportStar(require("./dtos/SellerPendingRefundItem"), exports);
+__exportStar(require("./dtos/responses/StorePendingRefundsResponse"), exports);
 __exportStar(require("./dtos/responses/KycPrepareResponse"), exports);
 __exportStar(require("./dtos/responses/ProofOfAddressPrepareResponse"), exports);
 __exportStar(require("./dtos/responses/SessionFinanciersResponse"), exports);

package/package.json

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

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

@@ -1,5 +1,5 @@
-import { Type } from 'class-transformer';
-import { IsEnum, IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+import { Transform, Type } from 'class-transformer';
+import { IsBoolean, 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. */
@@ -24,4 +24,10 @@ export class GetInventorySkuQuery {
     @IsOptional()
     @IsString()
     nextToken?: string;
+
+    /** `true` incluye en el libro los movimientos RESERVATION y RELEASE. */
+    @IsOptional()
+    @Transform(({ value }) => (value === 'true' ? true : value === 'false' ? false : value))
+    @IsBoolean()
+    includeHolds?: boolean;
 }

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

@@ -1,5 +1,5 @@
 import { Type } from 'class-transformer';
-import { ArrayMinSize, IsArray, IsString, ValidateNested } from 'class-validator';
+import { ArrayMinSize, IsArray, IsOptional, IsString, ValidateNested } from 'class-validator';
 import { StockLine } from './StockLine';
 
 /** Body de PUT /private/stores/{storeId}/sales (privateSellStock); una TX de venta. */
@@ -15,4 +15,9 @@ export class SellStockRequest {
     @ValidateNested({ each: true })
     @Type(() => StockLine)
     lines!: StockLine[];
+
+    /** Venta a la que pertenece; liga los MOV# de la TX con ella. */
+    @IsOptional()
+    @IsString()
+    saleId?: string;
 }

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

@@ -19,6 +19,16 @@ export interface InventoryMovementEntry {
     reason?: InventoryMovementReasonEnum;
     /** Id del MOV#, para ligar un ajuste con reversesMovementId. */
     movementId?: string;
+    /** Traspaso al que pertenece el movimiento, si es uno. */
+    transferId?: string;
+    /** Venta a la que pertenece el movimiento, si es una. */
+    saleId?: string;
+}
+
+/** Unidades apartadas (BALANCE#.reserved) del SKU en una tienda. */
+export interface InventoryStoreReserved {
+    storeId: string;
+    reserved: number;
 }
 
 /** Pieza de una tienda; status AVAILABLE, SOLD o DAMAGED. */
@@ -41,6 +51,7 @@ export interface GetInventorySkuResponse {
     nextToken: string | null;
     /** Vacío si el SKU se rastrea por cantidad. */
     piecesByStore: InventoryStorePieces[];
+    reservedByStore: InventoryStoreReserved[];
     currentPrice: SkuPriceEntry | null;
     /** Promos de venta vigentes del SKU; `null` si retail-promotions no respondió. */
     promotions?: ActiveSalePromotionSummary[] | null;

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

@@ -97,6 +97,8 @@ export interface InventoryLensStoreStock {
     storeId: string;
     stock: number;
     sold: number;
+    /** Unidades apartadas (BALANCE#.reserved). */
+    reserved: number;
 }
 
 /** Alertas de una fila del modo lista. */
@@ -125,6 +127,8 @@ export interface InventoryLensListItem {
     storesWithStock: number;
     storesTotal: number;
     byStore: InventoryLensStoreStock[];
+    /** Suma de `reserved` de todas las tiendas. */
+    reservedTotal: number;
     soldPeriod: number;
     coverage: InventoryLensCoverage;
     alerts: InventoryLensAlerts;

package/src/retailCatalog/events/InventorySaleAppliedMessage.ts

@@ -1,4 +1,4 @@
-import { Equals, IsISO8601, IsNotEmpty, IsString } from 'class-validator';
+import { Equals, IsISO8601, IsNotEmpty, IsString, ValidateIf } from 'class-validator';
 import { InventoryInboundMessageTypeEnum } from '../enums/InventoryInboundMessageTypeEnum';
 import { SellStockRequest } from '../dtos/requests/SellStockRequest';
 
@@ -16,6 +16,8 @@ export class InventorySaleAppliedMessage extends SellStockRequest {
     @IsNotEmpty()
     storeId!: string;
 
+    /** El ValidateIf anula el @IsOptional que hereda de SellStockRequest: aquí saleId es obligatorio. */
+    @ValidateIf(() => true)
     @IsString()
     @IsNotEmpty()
     saleId!: string;

package/src/retailWizard/dtos/SellerPendingRefundItem.ts

@@ -0,0 +1,24 @@
+import { RefundStatusEnum } from '../enums/RefundStatusEnum';
+import { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+
+/** Un reembolso de enganche de la tienda en el Portal Vendedor (GET /portal/pending-refunds). */
+export interface SellerPendingRefundItem {
+    sessionId: string;
+    storeId: string;
+    sellerId: string | null;
+    sellerName: string | null;
+    creditId: string | null;
+    folio: string | null;
+    refundPendingCents: number;
+    /** `null` = el registro no guardó con qué se cobró el enganche; no se puede marcar entregado. */
+    paymentMethod: SalePaymentMethodEnum | null;
+    status: RefundStatusEnum;
+    /** `true` si el vendedor puede marcarlo entregado: efectivo y pendiente. */
+    deliverable: boolean;
+    cancelledAt: string;
+    /** Actor que canceló la venta (cognitoSub o nombre del lambda). */
+    cancelledBy: string;
+    deliveredAt: string | null;
+    deliveredBy: string | null;
+    deliveredByName: string | null;
+}

package/src/retailWizard/dtos/responses/StorePendingRefundsResponse.ts

@@ -0,0 +1,8 @@
+import { SellerPendingRefundItem } from '../SellerPendingRefundItem';
+
+/** Respuesta de GET /portal/pending-refunds: pendientes de la tienda y entregados de los últimos 30 días. */
+export interface StorePendingRefundsResponse {
+    refunds: SellerPendingRefundItem[];
+    pendingCount: number;
+    pendingTotalCents: number;
+}

package/src/retailWizard/enums/RefundStatusEnum.ts

@@ -0,0 +1,5 @@
+/** Estado del reembolso de enganche de una venta a crédito cancelada. SureKeep — Portal Vendedor. */
+export enum RefundStatusEnum {
+    PENDING = 'PENDING',
+    DELIVERED = 'DELIVERED',
+}

package/src/retailWizard/index.ts

@@ -10,6 +10,7 @@ export * from './enums/PaymentMethodEnum';
 export * from './enums/ExternalProviderEnum';
 export * from './enums/SaleTypeEnum';
 export * from './enums/SalePaymentMethodEnum';
+export * from './enums/RefundStatusEnum';
 export * from './enums/SaleStatusEnum';
 export * from './enums/CentralSyncStatusEnum';
 export * from './enums/ProspectStatusEnum';
@@ -115,6 +116,8 @@ export * from './dtos/requests/VerifyEmailOtpRequest';
 export * from './dtos/requests/CreateAccessorySaleRequest';
 
 // Response DTOs (output tipado por endpoint)
+export * from './dtos/SellerPendingRefundItem';
+export * from './dtos/responses/StorePendingRefundsResponse';
 export * from './dtos/responses/KycPrepareResponse';
 export * from './dtos/responses/ProofOfAddressPrepareResponse';
 export * from './dtos/responses/SessionFinanciersResponse';