@fiado/api-invoker 5.61.0 → 5.62.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 { ImeiProductLookupResponse, IRetailCatalogBusinessApi, ReleaseReservationBody, ReserveInventoryBody, ReserveInventoryResult, SellInventoryBody, StoreCatalogItem } from "./interfaces/IRetailCatalogBusinessApi.js";
+import { ImeiProductLookupResponse, 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
  * endpoints privados del ciclo de venta del IMEI. Contrato y semántica completos →
@@ -21,6 +21,7 @@ export default class RetailCatalogBusinessApi implements IRetailCatalogBusinessA
     private tenantHeader;
     getStoreCatalog(storeId: string, issuer: string): Promise<StandardResponse<StoreCatalogItem[]>>;
     getProductsByImei(imeis: string[], tenantId: string): Promise<StandardResponse<ImeiProductLookupResponse>>;
+    getProductsByRetailers(retailerIds: string[], tenantId: string): Promise<StandardResponse<ProductsByRetailersResponse>>;
     reserveInventory(imei: string, body: ReserveInventoryBody, issuer: string): Promise<StandardResponse<ReserveInventoryResult>>;
     sellInventory(imei: string, body: SellInventoryBody, issuer: string): Promise<StandardResponse<void>>;
     releaseInventory(imei: string, body: ReleaseReservationBody, issuer: string): Promise<StandardResponse<void>>;

package/bin/retailCatalog/api/RetailCatalogBusinessApi.js

@@ -11,7 +11,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from "inversify";
-import { IMEI_PRODUCT_BATCH_MAX, } from "./interfaces/IRetailCatalogBusinessApi.js";
+import { IMEI_PRODUCT_BATCH_MAX, RETAILER_PRODUCTS_BATCH_MAX, } from "./interfaces/IRetailCatalogBusinessApi.js";
 /** Header por el que el destino resuelve el silo (issuer Cognito forwardeado por el caller). */
 const TENANT_ISSUER_HEADER = "x-tenant-issuer";
 /**
@@ -51,6 +51,15 @@ let RetailCatalogBusinessApi = class RetailCatalogBusinessApi {
         const query = new URLSearchParams({ imeis: imeis.join(","), tenantId });
         return await this.httpRequest.get(`${this.baseUrl}/private/products/by-imei?${query.toString()}`);
     }
+    async getProductsByRetailers(retailerIds, tenantId) {
+        // Se corta aquí: mandar un lote que el destino va a rechazar solo gasta un round-trip.
+        if (retailerIds.length > RETAILER_PRODUCTS_BATCH_MAX) {
+            throw new Error(`El lote admite hasta ${RETAILER_PRODUCTS_BATCH_MAX} cadenas y llegaron ${retailerIds.length}`);
+        }
+        const query = new URLSearchParams({ tenantId });
+        const body = { retailerIds };
+        return await this.httpRequest.post(`${this.baseUrl}/private/products/by-retailers?${query.toString()}`, body);
+    }
     async reserveInventory(imei, body, issuer) {
         const url = `${this.baseUrl}/private/inventory/${encodeURIComponent(imei)}/reserve`;
         return await this.httpRequest.put(url, body, this.tenantHeader(issuer));

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

@@ -80,6 +80,30 @@ export interface ImeiProductLookupEntry {
 export interface ImeiProductLookupResponse {
     items: ImeiProductLookupEntry[];
 }
+/** Techo de cadenas por request del lote cadena->catálogo. Lo declara y lo honra el destino. */
+export declare const RETAILER_PRODUCTS_BATCH_MAX = 100;
+/** Body de POST `/private/products/by-retailers`. */
+export interface ProductsByRetailersBody {
+    retailerIds: string[];
+}
+/** Un producto vendible de una cadena (espeja `RetailerProductItem` del destino). */
+export interface RetailerProductItem {
+    /** Cadena a la que pertenece el producto; es la llave con la que el caller agrupa. */
+    retailerId: string;
+    sku: string;
+    /** Marca comercial (p. ej. "Samsung"). */
+    brand: string;
+    /** Modelo (p. ej. "A54"). */
+    model: string;
+}
+/** Respuesta del lote cadena->catálogo: los productos de TODAS las cadenas pedidas, en una lista plana. */
+export interface ProductsByRetailersResponse {
+    items: RetailerProductItem[];
+    /** Cuántos productos trae `items`. */
+    count: number;
+    /** `true` si el destino recortó el resultado; pide las cadenas en lotes más chicos. */
+    truncated: boolean;
+}
 /** Resultado de la reserva (espeja `ReserveInventoryResponse` del destino). */
 export interface ReserveInventoryResult {
     reservationExpiresAt: string;
@@ -125,6 +149,32 @@ export interface IRetailCatalogBusinessApi {
      *   `400 IMEI_BATCH_REQUIRED` si `imeis` viene vacío · `400 UNKNOWN_TENANT` sin `tenantId`.
      */
     getProductsByImei(imeis: string[], tenantId: string): Promise<StandardResponse<ImeiProductLookupResponse>>;
+    /**
+     * POST `/private/products/by-retailers?tenantId=` — catálogo de productos de VARIAS cadenas en
+     * una sola llamada, para el consumidor que arma su vista con N cadenas y no quiere N requests.
+     *
+     * ─────────────────────────────────────────────────────────────────────────────
+     * ⚠️ El tenant va por `?tenantId=`, NO por el header `x-tenant-issuer` del resto de este publisher.
+     * ─────────────────────────────────────────────────────────────────────────────
+     * Es obligatorio. El destino entra por `TenantContextService.withContextByTenantId`, igual que
+     * `getProductsByImei`.
+     *
+     * ── El contrato del lote ────────────────────────────────────────────────────────────────────
+     * `retailerIds` no puede venir vacío, sin repetidos y con un techo de
+     * `RETAILER_PRODUCTS_BATCH_MAX` cadenas; el caller parte los lotes mayores. La respuesta es una
+     * lista PLANA de productos con su `retailerId` — el caller agrupa. Una cadena sin catálogo
+     * simplemente no aporta ítems.
+     *
+     * O el lote sale completo o no sale: si falla la lectura de al menos una cadena el destino
+     * responde `INTERNAL_ERROR`. Nunca recibes una lista parcial.
+     *
+     * @throws Error si el lote supera el techo (se corta aquí, sin salir a la red) ·
+     *   `400 VALIDATION_ERROR` body vacío, con repetidos, con no-strings o de más de 100 ids ·
+     *   `400 UNKNOWN_TENANT` falta o no se reconoce el `tenantId` ·
+     *   `500 TENANT_ASSUME_ROLE_FAILED` fallo de infra del silo ·
+     *   `500 INTERNAL_ERROR` no se pudo leer alguna cadena.
+     */
+    getProductsByRetailers(retailerIds: string[], tenantId: string): Promise<StandardResponse<ProductsByRetailersResponse>>;
     /** PUT `/private/inventory/{imei}/reserve` — reserva atómica del IMEI para una sesión (AVAILABLE → RESERVED). */
     reserveInventory(imei: string, body: ReserveInventoryBody, issuer: string): Promise<StandardResponse<ReserveInventoryResult>>;
     /** PUT `/private/inventory/{imei}/sell` — vende el IMEI (RESERVED → SOLD). */

package/bin/retailCatalog/api/interfaces/IRetailCatalogBusinessApi.js

@@ -1,2 +1,4 @@
 /** Techo de IMEIs por request del lote IMEI->producto. Lo declara y lo honra el destino. */
 export const IMEI_PRODUCT_BATCH_MAX = 100;
+/** Techo de cadenas por request del lote cadena->catálogo. Lo declara y lo honra el destino. */
+export const RETAILER_PRODUCTS_BATCH_MAX = 100;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.61.0",
+  "version": "5.62.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",

package/src/retailCatalog/api/RetailCatalogBusinessApi.ts

@@ -5,9 +5,12 @@ import {
     IMEI_PRODUCT_BATCH_MAX,
     ImeiProductLookupResponse,
     IRetailCatalogBusinessApi,
+    ProductsByRetailersBody,
+    ProductsByRetailersResponse,
     ReleaseReservationBody,
     ReserveInventoryBody,
     ReserveInventoryResult,
+    RETAILER_PRODUCTS_BATCH_MAX,
     SellInventoryBody,
     StoreCatalogItem,
 } from "./interfaces/IRetailCatalogBusinessApi.js";
@@ -58,6 +61,21 @@ export default class RetailCatalogBusinessApi implements IRetailCatalogBusinessA
         return await this.httpRequest.get(`${this.baseUrl}/private/products/by-imei?${query.toString()}`);
     }
 
+    async getProductsByRetailers(
+        retailerIds: string[],
+        tenantId: string,
+    ): Promise<StandardResponse<ProductsByRetailersResponse>> {
+        // Se corta aquí: mandar un lote que el destino va a rechazar solo gasta un round-trip.
+        if (retailerIds.length > RETAILER_PRODUCTS_BATCH_MAX) {
+            throw new Error(
+                `El lote admite hasta ${RETAILER_PRODUCTS_BATCH_MAX} cadenas y llegaron ${retailerIds.length}`,
+            );
+        }
+        const query = new URLSearchParams({ tenantId });
+        const body: ProductsByRetailersBody = { retailerIds };
+        return await this.httpRequest.post(`${this.baseUrl}/private/products/by-retailers?${query.toString()}`, body);
+    }
+
     async reserveInventory(
         imei: string,
         body: ReserveInventoryBody,

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

@@ -93,6 +93,34 @@ export interface ImeiProductLookupResponse {
     items: ImeiProductLookupEntry[];
 }
 
+/** Techo de cadenas por request del lote cadena->catálogo. Lo declara y lo honra el destino. */
+export const RETAILER_PRODUCTS_BATCH_MAX = 100;
+
+/** Body de POST `/private/products/by-retailers`. */
+export interface ProductsByRetailersBody {
+    retailerIds: string[];
+}
+
+/** Un producto vendible de una cadena (espeja `RetailerProductItem` del destino). */
+export interface RetailerProductItem {
+    /** Cadena a la que pertenece el producto; es la llave con la que el caller agrupa. */
+    retailerId: string;
+    sku: string;
+    /** Marca comercial (p. ej. "Samsung"). */
+    brand: string;
+    /** Modelo (p. ej. "A54"). */
+    model: string;
+}
+
+/** Respuesta del lote cadena->catálogo: los productos de TODAS las cadenas pedidas, en una lista plana. */
+export interface ProductsByRetailersResponse {
+    items: RetailerProductItem[];
+    /** Cuántos productos trae `items`. */
+    count: number;
+    /** `true` si el destino recortó el resultado; pide las cadenas en lotes más chicos. */
+    truncated: boolean;
+}
+
 /** Resultado de la reserva (espeja `ReserveInventoryResponse` del destino). */
 export interface ReserveInventoryResult {
     reservationExpiresAt: string;
@@ -144,6 +172,36 @@ export interface IRetailCatalogBusinessApi {
      */
     getProductsByImei(imeis: string[], tenantId: string): Promise<StandardResponse<ImeiProductLookupResponse>>;
 
+    /**
+     * POST `/private/products/by-retailers?tenantId=` — catálogo de productos de VARIAS cadenas en
+     * una sola llamada, para el consumidor que arma su vista con N cadenas y no quiere N requests.
+     *
+     * ─────────────────────────────────────────────────────────────────────────────
+     * ⚠️ El tenant va por `?tenantId=`, NO por el header `x-tenant-issuer` del resto de este publisher.
+     * ─────────────────────────────────────────────────────────────────────────────
+     * Es obligatorio. El destino entra por `TenantContextService.withContextByTenantId`, igual que
+     * `getProductsByImei`.
+     *
+     * ── El contrato del lote ────────────────────────────────────────────────────────────────────
+     * `retailerIds` no puede venir vacío, sin repetidos y con un techo de
+     * `RETAILER_PRODUCTS_BATCH_MAX` cadenas; el caller parte los lotes mayores. La respuesta es una
+     * lista PLANA de productos con su `retailerId` — el caller agrupa. Una cadena sin catálogo
+     * simplemente no aporta ítems.
+     *
+     * O el lote sale completo o no sale: si falla la lectura de al menos una cadena el destino
+     * responde `INTERNAL_ERROR`. Nunca recibes una lista parcial.
+     *
+     * @throws Error si el lote supera el techo (se corta aquí, sin salir a la red) ·
+     *   `400 VALIDATION_ERROR` body vacío, con repetidos, con no-strings o de más de 100 ids ·
+     *   `400 UNKNOWN_TENANT` falta o no se reconoce el `tenantId` ·
+     *   `500 TENANT_ASSUME_ROLE_FAILED` fallo de infra del silo ·
+     *   `500 INTERNAL_ERROR` no se pudo leer alguna cadena.
+     */
+    getProductsByRetailers(
+        retailerIds: string[],
+        tenantId: string,
+    ): Promise<StandardResponse<ProductsByRetailersResponse>>;
+
     /** PUT `/private/inventory/{imei}/reserve` — reserva atómica del IMEI para una sesión (AVAILABLE → RESERVED). */
     reserveInventory(imei: string, body: ReserveInventoryBody, issuer: string): Promise<StandardResponse<ReserveInventoryResult>>;