@fiado/api-invoker 5.90.0 → 5.91.0

package/bin/retailCatalog/api/RetailCatalogBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import type { ValidateProductResponse } from "@fiado/type-kit/bin/retailCatalog/index.js";
+import type { GetStoreStockCatalogResponse, ReleaseStockRequest, ReleaseStockResponse, RenewReservationsRequest, RenewReservationsResponse, ReserveStockRequest, ReserveStockResponse, ReturnStockRequest, ReturnStockResponse, SellStockRequest, SellStockResponse, SuggestPiecesQuery, SuggestPiecesResponse, SyncInventoryRequest, SyncInventoryResponse, ValidateProductResponse } from "@fiado/type-kit/bin/retailCatalog/index.js";
 import { IRetailCatalogBusinessApi, ProductsByRetailersResponse, ReleaseReservationBody, ReserveInventoryBody, ReserveInventoryResult, SellInventoryBody, StoreCatalogItem } from "./interfaces/IRetailCatalogBusinessApi.js";
 /**
  * Publisher HTTP del lambda `retail-catalog-business` (SureKeep Fase 1, pista Retail) para sus
@@ -27,4 +27,14 @@ export default class RetailCatalogBusinessApi implements IRetailCatalogBusinessA
     sellInventory(imei: string, body: SellInventoryBody, issuer: string): Promise<StandardResponse<void>>;
     releaseInventory(imei: string, body: ReleaseReservationBody, issuer: string): Promise<StandardResponse<void>>;
     returnInventory(imei: string, issuer: string): Promise<StandardResponse<void>>;
+    /** URL de una ruta de tienda con `tenantId` y los parámetros extra en query. */
+    private storeUrl;
+    reserveStock(storeId: string, body: ReserveStockRequest, tenantId: string): Promise<StandardResponse<ReserveStockResponse>>;
+    renewReservations(storeId: string, body: RenewReservationsRequest, tenantId: string): Promise<StandardResponse<RenewReservationsResponse>>;
+    suggestPieces(storeId: string, query: SuggestPiecesQuery, tenantId: string): Promise<StandardResponse<SuggestPiecesResponse>>;
+    sellStock(storeId: string, body: SellStockRequest, tenantId: string): Promise<StandardResponse<SellStockResponse>>;
+    releaseStock(storeId: string, body: ReleaseStockRequest, tenantId: string): Promise<StandardResponse<ReleaseStockResponse>>;
+    returnStock(storeId: string, body: ReturnStockRequest, tenantId: string): Promise<StandardResponse<ReturnStockResponse>>;
+    syncInventory(retailerId: string, body: SyncInventoryRequest, tenantId: string): Promise<StandardResponse<SyncInventoryResponse>>;
+    getStoreStockCatalog(storeId: string, tenantId: string): Promise<StandardResponse<GetStoreStockCatalogResponse>>;
 }

package/bin/retailCatalog/api/RetailCatalogBusinessApi.js

@@ -70,6 +70,38 @@ let RetailCatalogBusinessApi = class RetailCatalogBusinessApi {
         const url = `${this.baseUrl}/private/inventory/${encodeURIComponent(imei)}/return`;
         return await this.httpRequest.put(url, undefined, this.tenantHeader(issuer));
     }
+    /** URL de una ruta de tienda con `tenantId` y los parámetros extra en query. */
+    storeUrl(storeId, suffix, tenantId, extra = {}) {
+        const query = new URLSearchParams({ tenantId, ...extra });
+        return `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/${suffix}?${query.toString()}`;
+    }
+    async reserveStock(storeId, body, tenantId) {
+        return await this.httpRequest.put(this.storeUrl(storeId, "reservations", tenantId), body);
+    }
+    async renewReservations(storeId, body, tenantId) {
+        return await this.httpRequest.put(this.storeUrl(storeId, "reservations/renew", tenantId), body);
+    }
+    async suggestPieces(storeId, query, tenantId) {
+        const extra = { sku: query.sku, prefix: query.prefix };
+        return await this.httpRequest.get(this.storeUrl(storeId, "pieces", tenantId, extra));
+    }
+    async sellStock(storeId, body, tenantId) {
+        return await this.httpRequest.put(this.storeUrl(storeId, "sales", tenantId), body);
+    }
+    async releaseStock(storeId, body, tenantId) {
+        return await this.httpRequest.put(this.storeUrl(storeId, "reservations/release", tenantId), body);
+    }
+    async returnStock(storeId, body, tenantId) {
+        return await this.httpRequest.put(this.storeUrl(storeId, "returns", tenantId), body);
+    }
+    async syncInventory(retailerId, body, tenantId) {
+        const query = new URLSearchParams({ tenantId });
+        const url = `${this.baseUrl}/private/retailers/${encodeURIComponent(retailerId)}/inventory/sync?${query.toString()}`;
+        return await this.httpRequest.post(url, body);
+    }
+    async getStoreStockCatalog(storeId, tenantId) {
+        return await this.httpRequest.get(this.storeUrl(storeId, "stock-catalog", tenantId));
+    }
 };
 RetailCatalogBusinessApi = __decorate([
     injectable(),

package/bin/retailCatalog/api/interfaces/IRetailCatalogBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import type { MdmLockModeEnum, MdmProviderEnum, ValidateProductResponse } from "@fiado/type-kit/bin/retailCatalog/index.js";
+import type { GetStoreStockCatalogResponse, MdmLockModeEnum, MdmProviderEnum, ReleaseStockRequest, ReleaseStockResponse, RenewReservationsRequest, RenewReservationsResponse, ReserveStockRequest, ReserveStockResponse, ReturnStockRequest, ReturnStockResponse, SellStockRequest, SellStockResponse, SuggestPiecesQuery, SuggestPiecesResponse, SyncInventoryRequest, SyncInventoryResponse, ValidateProductResponse } from "@fiado/type-kit/bin/retailCatalog/index.js";
 /**
  * Contrato del publisher HTTP del lambda `retail-catalog-business` (SureKeep Fase 1, pista Retail)
  * para sus endpoints privados del ciclo de venta del IMEI, consumidos por el wizard F2.
@@ -152,4 +152,20 @@ export interface IRetailCatalogBusinessApi {
     releaseInventory(imei: string, body: ReleaseReservationBody, issuer: string): Promise<StandardResponse<void>>;
     /** PUT `/private/inventory/{imei}/return` — devuelve el IMEI vendido al stock (SOLD → AVAILABLE, sin body). */
     returnInventory(imei: string, issuer: string): Promise<StandardResponse<void>>;
+    /** PUT `/private/stores/{storeId}/reservations` — reserva una línea (kit completo) de forma idempotente. */
+    reserveStock(storeId: string, body: ReserveStockRequest, tenantId: string): Promise<StandardResponse<ReserveStockResponse>>;
+    /** PUT `/private/stores/{storeId}/reservations/renew` — extiende las reservas de las líneas. */
+    renewReservations(storeId: string, body: RenewReservationsRequest, tenantId: string): Promise<StandardResponse<RenewReservationsResponse>>;
+    /** GET `/private/stores/{storeId}/pieces` — piezas disponibles del SKU que empiezan con `prefix`. */
+    suggestPieces(storeId: string, query: SuggestPiecesQuery, tenantId: string): Promise<StandardResponse<SuggestPiecesResponse>>;
+    /** PUT `/private/stores/{storeId}/sales` — vende las líneas con sus identificadores en una transacción. */
+    sellStock(storeId: string, body: SellStockRequest, tenantId: string): Promise<StandardResponse<SellStockResponse>>;
+    /** PUT `/private/stores/{storeId}/reservations/release` — libera las reservas de las líneas. */
+    releaseStock(storeId: string, body: ReleaseStockRequest, tenantId: string): Promise<StandardResponse<ReleaseStockResponse>>;
+    /** PUT `/private/stores/{storeId}/returns` — regresa al stock las piezas de una venta cancelada. */
+    returnStock(storeId: string, body: ReturnStockRequest, tenantId: string): Promise<StandardResponse<ReturnStockResponse>>;
+    /** POST `/private/retailers/{retailerId}/inventory/sync` — puerta de entrada de productos, precios y stock. */
+    syncInventory(retailerId: string, body: SyncInventoryRequest, tenantId: string): Promise<StandardResponse<SyncInventoryResponse>>;
+    /** GET `/private/stores/{storeId}/stock-catalog` — catálogo vendible de la tienda, una fila por SKU. */
+    getStoreStockCatalog(storeId: string, tenantId: string): Promise<StandardResponse<GetStoreStockCatalogResponse>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.90.0",
+  "version": "5.91.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "type": "module",
   "main": "bin/index.js",
@@ -34,7 +34,7 @@
     "@fiado/gateway-adapter": "^3.9.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.458.0",
+    "@fiado/type-kit": "3.461.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/retailCatalog/api/RetailCatalogBusinessApi.ts

@@ -1,7 +1,24 @@
 import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import type { ValidateProductResponse } from "@fiado/type-kit/bin/retailCatalog/index.js";
+import type {
+    GetStoreStockCatalogResponse,
+    ReleaseStockRequest,
+    ReleaseStockResponse,
+    RenewReservationsRequest,
+    RenewReservationsResponse,
+    ReserveStockRequest,
+    ReserveStockResponse,
+    ReturnStockRequest,
+    ReturnStockResponse,
+    SellStockRequest,
+    SellStockResponse,
+    SuggestPiecesQuery,
+    SuggestPiecesResponse,
+    SyncInventoryRequest,
+    SyncInventoryResponse,
+    ValidateProductResponse,
+} from "@fiado/type-kit/bin/retailCatalog/index.js";
 import {
     IRetailCatalogBusinessApi,
     ProductsByRetailersBody,
@@ -97,4 +114,76 @@ export default class RetailCatalogBusinessApi implements IRetailCatalogBusinessA
         const url = `${this.baseUrl}/private/inventory/${encodeURIComponent(imei)}/return`;
         return await this.httpRequest.put(url, undefined, this.tenantHeader(issuer));
     }
+
+    /** URL de una ruta de tienda con `tenantId` y los parámetros extra en query. */
+    private storeUrl(storeId: string, suffix: string, tenantId: string, extra: Record<string, string> = {}): string {
+        const query = new URLSearchParams({ tenantId, ...extra });
+        return `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/${suffix}?${query.toString()}`;
+    }
+
+    async reserveStock(
+        storeId: string,
+        body: ReserveStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReserveStockResponse>> {
+        return await this.httpRequest.put(this.storeUrl(storeId, "reservations", tenantId), body);
+    }
+
+    async renewReservations(
+        storeId: string,
+        body: RenewReservationsRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<RenewReservationsResponse>> {
+        return await this.httpRequest.put(this.storeUrl(storeId, "reservations/renew", tenantId), body);
+    }
+
+    async suggestPieces(
+        storeId: string,
+        query: SuggestPiecesQuery,
+        tenantId: string,
+    ): Promise<StandardResponse<SuggestPiecesResponse>> {
+        const extra = { sku: query.sku, prefix: query.prefix };
+        return await this.httpRequest.get(this.storeUrl(storeId, "pieces", tenantId, extra));
+    }
+
+    async sellStock(
+        storeId: string,
+        body: SellStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SellStockResponse>> {
+        return await this.httpRequest.put(this.storeUrl(storeId, "sales", tenantId), body);
+    }
+
+    async releaseStock(
+        storeId: string,
+        body: ReleaseStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReleaseStockResponse>> {
+        return await this.httpRequest.put(this.storeUrl(storeId, "reservations/release", tenantId), body);
+    }
+
+    async returnStock(
+        storeId: string,
+        body: ReturnStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReturnStockResponse>> {
+        return await this.httpRequest.put(this.storeUrl(storeId, "returns", tenantId), body);
+    }
+
+    async syncInventory(
+        retailerId: string,
+        body: SyncInventoryRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SyncInventoryResponse>> {
+        const query = new URLSearchParams({ tenantId });
+        const url = `${this.baseUrl}/private/retailers/${encodeURIComponent(retailerId)}/inventory/sync?${query.toString()}`;
+        return await this.httpRequest.post(url, body);
+    }
+
+    async getStoreStockCatalog(
+        storeId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<GetStoreStockCatalogResponse>> {
+        return await this.httpRequest.get(this.storeUrl(storeId, "stock-catalog", tenantId));
+    }
 }

package/src/retailCatalog/api/interfaces/IRetailCatalogBusinessApi.ts

@@ -1,7 +1,22 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import type {
+    GetStoreStockCatalogResponse,
     MdmLockModeEnum,
     MdmProviderEnum,
+    ReleaseStockRequest,
+    ReleaseStockResponse,
+    RenewReservationsRequest,
+    RenewReservationsResponse,
+    ReserveStockRequest,
+    ReserveStockResponse,
+    ReturnStockRequest,
+    ReturnStockResponse,
+    SellStockRequest,
+    SellStockResponse,
+    SuggestPiecesQuery,
+    SuggestPiecesResponse,
+    SyncInventoryRequest,
+    SyncInventoryResponse,
     ValidateProductResponse,
 } from "@fiado/type-kit/bin/retailCatalog/index.js";
 
@@ -186,4 +201,54 @@ export interface IRetailCatalogBusinessApi {
 
     /** PUT `/private/inventory/{imei}/return` — devuelve el IMEI vendido al stock (SOLD → AVAILABLE, sin body). */
     returnInventory(imei: string, issuer: string): Promise<StandardResponse<void>>;
+
+    // Contrato de stock por SKU: el tenant va en `?tenantId=`; errores tipados del destino se propagan.
+
+    /** PUT `/private/stores/{storeId}/reservations` — reserva una línea (kit completo) de forma idempotente. */
+    reserveStock(
+        storeId: string,
+        body: ReserveStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReserveStockResponse>>;
+
+    /** PUT `/private/stores/{storeId}/reservations/renew` — extiende las reservas de las líneas. */
+    renewReservations(
+        storeId: string,
+        body: RenewReservationsRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<RenewReservationsResponse>>;
+
+    /** GET `/private/stores/{storeId}/pieces` — piezas disponibles del SKU que empiezan con `prefix`. */
+    suggestPieces(
+        storeId: string,
+        query: SuggestPiecesQuery,
+        tenantId: string,
+    ): Promise<StandardResponse<SuggestPiecesResponse>>;
+
+    /** PUT `/private/stores/{storeId}/sales` — vende las líneas con sus identificadores en una transacción. */
+    sellStock(storeId: string, body: SellStockRequest, tenantId: string): Promise<StandardResponse<SellStockResponse>>;
+
+    /** PUT `/private/stores/{storeId}/reservations/release` — libera las reservas de las líneas. */
+    releaseStock(
+        storeId: string,
+        body: ReleaseStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReleaseStockResponse>>;
+
+    /** PUT `/private/stores/{storeId}/returns` — regresa al stock las piezas de una venta cancelada. */
+    returnStock(
+        storeId: string,
+        body: ReturnStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReturnStockResponse>>;
+
+    /** POST `/private/retailers/{retailerId}/inventory/sync` — puerta de entrada de productos, precios y stock. */
+    syncInventory(
+        retailerId: string,
+        body: SyncInventoryRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SyncInventoryResponse>>;
+
+    /** GET `/private/stores/{storeId}/stock-catalog` — catálogo vendible de la tienda, una fila por SKU. */
+    getStoreStockCatalog(storeId: string, tenantId: string): Promise<StandardResponse<GetStoreStockCatalogResponse>>;
 }