@fiado/api-invoker 5.96.0 → 5.98.0

package/bin/index.d.ts

@@ -88,6 +88,7 @@ export * from "./retailCatalog/index.js";
 export * from "./retailCards/index.js";
 export * from "./retailNotifications/index.js";
 export * from "./retailWizard/index.js";
+export * from "./retailPromotions/index.js";
 export * from "./shortlink/index.js";
 export * from "./loanConfig/index.js";
 export * from "./loanOfferings/index.js";

package/bin/index.js

@@ -88,6 +88,7 @@ export * from "./retailCatalog/index.js";
 export * from "./retailCards/index.js";
 export * from "./retailNotifications/index.js";
 export * from "./retailWizard/index.js";
+export * from "./retailPromotions/index.js";
 export * from "./shortlink/index.js";
 export * from "./loanConfig/index.js";
 export * from "./loanOfferings/index.js";

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 { 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 type { GetStoreStockCatalogResponse, HoldStockRequest, HoldStockResponse, InventoryLensQuery, InventoryLensResponse, 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
@@ -32,9 +32,11 @@ export default class RetailCatalogBusinessApi implements IRetailCatalogBusinessA
     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>>;
+    holdStock(storeId: string, body: HoldStockRequest, tenantId: string): Promise<StandardResponse<HoldStockResponse>>;
     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>>;
+    getInventoryLens(tenantId: string, retailerId: string, query: InventoryLensQuery): Promise<StandardResponse<InventoryLensResponse>>;
 }

package/bin/retailCatalog/api/RetailCatalogBusinessApi.js

@@ -83,8 +83,13 @@ let RetailCatalogBusinessApi = class RetailCatalogBusinessApi {
     }
     async suggestPieces(storeId, query, tenantId) {
         const extra = { sku: query.sku, prefix: query.prefix };
+        if (query.sessionId)
+            extra.sessionId = query.sessionId;
         return await this.httpRequest.get(this.storeUrl(storeId, "pieces", tenantId, extra));
     }
+    async holdStock(storeId, body, tenantId) {
+        return await this.httpRequest.put(this.storeUrl(storeId, "holds", tenantId), body);
+    }
     async sellStock(storeId, body, tenantId) {
         return await this.httpRequest.put(this.storeUrl(storeId, "sales", tenantId), body);
     }
@@ -102,6 +107,14 @@ let RetailCatalogBusinessApi = class RetailCatalogBusinessApi {
     async getStoreStockCatalog(storeId, tenantId) {
         return await this.httpRequest.get(this.storeUrl(storeId, "stock-catalog", tenantId));
     }
+    async getInventoryLens(tenantId, retailerId, query) {
+        const params = new URLSearchParams({ tenantId, retailerId, filter: query.filter });
+        if (query.period)
+            params.set("period", query.period);
+        if (query.storeId)
+            params.set("storeId", query.storeId);
+        return await this.httpRequest.get(`${this.baseUrl}/private/inventory/lens?${params.toString()}`);
+    }
 };
 RetailCatalogBusinessApi = __decorate([
     injectable(),

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

@@ -1,5 +1,5 @@
 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";
+import type { GetStoreStockCatalogResponse, HoldStockRequest, HoldStockResponse, InventoryLensQuery, InventoryLensResponse, 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.
@@ -156,8 +156,13 @@ export interface IRetailCatalogBusinessApi {
     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`. */
+    /**
+     * GET `/private/stores/{storeId}/pieces` — piezas disponibles del SKU que empiezan con `prefix`;
+     * con `sessionId` también trae las HELD de esa sesión.
+     */
     suggestPieces(storeId: string, query: SuggestPiecesQuery, tenantId: string): Promise<StandardResponse<SuggestPiecesResponse>>;
+    /** PUT `/private/stores/{storeId}/holds` — fija como HELD de la sesión las piezas de una línea (idempotente). */
+    holdStock(storeId: string, body: HoldStockRequest, tenantId: string): Promise<StandardResponse<HoldStockResponse>>;
     /** 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. */
@@ -168,4 +173,6 @@ export interface IRetailCatalogBusinessApi {
     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>>;
+    /** GET `/private/inventory/lens` — lente de inventario del retailer; `period` y `storeId` solo aplican a `filter=list`. */
+    getInventoryLens(tenantId: string, retailerId: string, query: InventoryLensQuery): Promise<StandardResponse<InventoryLensResponse>>;
 }

package/bin/retailCatalog/index.d.ts

@@ -1,2 +1,4 @@
 export * from "./api/interfaces/IRetailCatalogBusinessApi.js";
 export { default as RetailCatalogBusinessApi } from "./api/RetailCatalogBusinessApi.js";
+export * from "./queue/interfaces/IRetailInventoryInboundPublisher.js";
+export * from "./queue/RetailInventoryInboundPublisher.js";

package/bin/retailCatalog/index.js

@@ -1,2 +1,4 @@
 export * from "./api/interfaces/IRetailCatalogBusinessApi.js";
 export { default as RetailCatalogBusinessApi } from "./api/RetailCatalogBusinessApi.js";
+export * from "./queue/interfaces/IRetailInventoryInboundPublisher.js";
+export * from "./queue/RetailInventoryInboundPublisher.js";

package/bin/retailCatalog/queue/RetailInventoryInboundPublisher.d.ts

@@ -0,0 +1,6 @@
+import type { InventoryInboundMessage } from "@fiado/type-kit/bin/retailCatalog/index.js";
+import { IRetailInventoryInboundPublisher } from "./interfaces/IRetailInventoryInboundPublisher.js";
+export declare class RetailInventoryInboundPublisher implements IRetailInventoryInboundPublisher {
+    private readonly RETAIL_INVENTORY_INBOUND_QUEUE_URL;
+    publish(message: InventoryInboundMessage): Promise<void>;
+}

package/bin/retailCatalog/queue/RetailInventoryInboundPublisher.js

@@ -0,0 +1,31 @@
+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;
+};
+import { SendMessageCommand, SQSClient } from "@aws-sdk/client-sqs";
+import { injectable } from "inversify";
+let RetailInventoryInboundPublisher = class RetailInventoryInboundPublisher {
+    RETAIL_INVENTORY_INBOUND_QUEUE_URL = process.env.RETAIL_INVENTORY_INBOUND_QUEUE_URL;
+    async publish(message) {
+        try {
+            const client = new SQSClient();
+            // Cola estándar: sin MessageGroupId; el consumidor deduplica por sesión y venta.
+            const sendMessageRequest = {
+                QueueUrl: this.RETAIL_INVENTORY_INBOUND_QUEUE_URL,
+                MessageBody: JSON.stringify(message),
+            };
+            const command = new SendMessageCommand(sendMessageRequest);
+            await client.send(command);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error publishing message to RetailInventoryInboundQueue: ${errorMessage}`);
+        }
+    }
+};
+RetailInventoryInboundPublisher = __decorate([
+    injectable()
+], RetailInventoryInboundPublisher);
+export { RetailInventoryInboundPublisher };

package/bin/retailCatalog/queue/interfaces/IRetailInventoryInboundPublisher.d.ts

@@ -0,0 +1,8 @@
+import type { InventoryInboundMessage } from "@fiado/type-kit/bin/retailCatalog/index.js";
+/**
+ * Publisher hacia `RetailInventoryInboundQueue` (SALE_APPLIED | RETURN), que consume `retail-catalog-business`.
+ * Env var requerida en el productor: `RETAIL_INVENTORY_INBOUND_QUEUE_URL`.
+ */
+export interface IRetailInventoryInboundPublisher {
+    publish(message: InventoryInboundMessage): Promise<void>;
+}

package/bin/retailCatalog/queue/interfaces/IRetailInventoryInboundPublisher.js

@@ -0,0 +1 @@
+export {};

package/bin/retailPromotions/api/RetailPromotionsBusinessApi.d.ts

@@ -0,0 +1,11 @@
+import type { IHttpRequest } from "@fiado/http-client";
+import { StandardResponse } from "@fiado/gateway-adapter";
+import type { PrivateReleaseSalePromotionResponse } from "@fiado/type-kit/bin/retailPromotions/index.js";
+import { IRetailPromotionsBusinessApi } from "./interfaces/IRetailPromotionsBusinessApi.js";
+/** Publisher HTTP de los privados de `retail-promotions-business`. Contrato -> `IRetailPromotionsBusinessApi`. */
+export default class RetailPromotionsBusinessApi implements IRetailPromotionsBusinessApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    releaseSalePromotion(tenantId: string, sessionId: string): Promise<StandardResponse<PrivateReleaseSalePromotionResponse>>;
+}

package/bin/retailPromotions/api/RetailPromotionsBusinessApi.js

@@ -0,0 +1,33 @@
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+/** Publisher HTTP de los privados de `retail-promotions-business`. Contrato -> `IRetailPromotionsBusinessApi`. */
+let RetailPromotionsBusinessApi = class RetailPromotionsBusinessApi {
+    httpRequest;
+    // El buildspec publica la URL en SSM con "/" final; se normaliza para no armar "//private".
+    baseUrl = (process.env.RETAIL_PROMOTIONS_BUSINESS_URL || "").replace(/\/+$/, "");
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async releaseSalePromotion(tenantId, sessionId) {
+        const query = new URLSearchParams({ tenantId });
+        const url = `${this.baseUrl}/private/sessions/${encodeURIComponent(sessionId)}/sale-promotion?${query.toString()}`;
+        return await this.httpRequest.delete(url);
+    }
+};
+RetailPromotionsBusinessApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], RetailPromotionsBusinessApi);
+export default RetailPromotionsBusinessApi;

package/bin/retailPromotions/api/interfaces/IRetailPromotionsBusinessApi.d.ts

@@ -0,0 +1,9 @@
+import { StandardResponse } from "@fiado/gateway-adapter";
+import type { PrivateReleaseSalePromotionResponse } from "@fiado/type-kit/bin/retailPromotions/index.js";
+export interface IRetailPromotionsBusinessApi {
+    /**
+     * `DELETE /private/sessions/{sessionId}/sale-promotion`: suelta el apartado de la promo de venta.
+     * Lo llama el wizard al cancelar. Es idempotente: `released: false` si no había apartado.
+     */
+    releaseSalePromotion(tenantId: string, sessionId: string): Promise<StandardResponse<PrivateReleaseSalePromotionResponse>>;
+}

package/bin/retailPromotions/api/interfaces/IRetailPromotionsBusinessApi.js

@@ -0,0 +1 @@
+export {};

package/bin/retailPromotions/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./api/interfaces/IRetailPromotionsBusinessApi.js";
+export { default as RetailPromotionsBusinessApi } from "./api/RetailPromotionsBusinessApi.js";

package/bin/retailPromotions/index.js

@@ -0,0 +1,2 @@
+export * from "./api/interfaces/IRetailPromotionsBusinessApi.js";
+export { default as RetailPromotionsBusinessApi } from "./api/RetailPromotionsBusinessApi.js";

package/bin/retailWizard/api/RetailWizardBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { WizardSessionLookupResponse } from "@fiado/type-kit/bin/retailWizard/index.js";
+import type { ApplyLinePromotionRequest, ApplySalePromotionRequest, PrivateWizardSessionResponse, SetAnchorGiftsRequest, SetAnchorGiftsResponse, WizardSessionLookupResponse } from "@fiado/type-kit/bin/retailWizard/index.js";
 import { IRetailWizardBusinessApi } from "./interfaces/IRetailWizardBusinessApi.js";
 /**
  * Publisher HTTP del lambda `retail-wizard-business` (componente 05 SureKeep Fase 2) para sus
@@ -20,4 +20,10 @@ export default class RetailWizardBusinessApi implements IRetailWizardBusinessApi
      * estados, el techo de 100 y lo que NO devuelve) -> `IRetailWizardBusinessApi`.
      */
     getWizardSessionsByIds(wizardSessionIds: string[], tenantId: string): Promise<StandardResponse<WizardSessionLookupResponse>>;
+    applyLinePromotion(sessionId: string, lineId: string, body: ApplyLinePromotionRequest, tenantId: string): Promise<void>;
+    setAnchorGifts(sessionId: string, anchorLineId: string, body: SetAnchorGiftsRequest, tenantId: string): Promise<StandardResponse<SetAnchorGiftsResponse>>;
+    applySalePromotion(sessionId: string, body: ApplySalePromotionRequest, tenantId: string): Promise<void>;
+    getPrivateWizardSession(sessionId: string, tenantId: string): Promise<StandardResponse<PrivateWizardSessionResponse>>;
+    /** URL de `/private/wizard/sessions/{id}[/subPath]` con `tenantId` en query. */
+    private sessionUrl;
 }

package/bin/retailWizard/api/RetailWizardBusinessApi.js

@@ -22,7 +22,8 @@ import { inject, injectable } from "inversify";
  */
 let RetailWizardBusinessApi = class RetailWizardBusinessApi {
     httpRequest;
-    baseUrl = process.env.RETAIL_WIZARD_BUSINESS_URL || "";
+    // El buildspec publica la URL en SSM con "/" final; se normaliza para no armar "//private".
+    baseUrl = (process.env.RETAIL_WIZARD_BUSINESS_URL || "").replace(/\/+$/, "");
     constructor(httpRequest) {
         this.httpRequest = httpRequest;
     }
@@ -36,6 +37,27 @@ let RetailWizardBusinessApi = class RetailWizardBusinessApi {
         const query = new URLSearchParams({ ids: wizardSessionIds.join(","), tenantId });
         return await this.httpRequest.get(`${this.baseUrl}/private/wizard-sessions/batch?${query.toString()}`);
     }
+    async applyLinePromotion(sessionId, lineId, body, tenantId) {
+        // El 204 no trae cuerpo (http-client devuelve ""); los errores se propagan tal cual.
+        const path = `lines/${encodeURIComponent(lineId)}/promotion`;
+        await this.httpRequest.put(this.sessionUrl(sessionId, tenantId, path), body);
+    }
+    async setAnchorGifts(sessionId, anchorLineId, body, tenantId) {
+        const path = `lines/${encodeURIComponent(anchorLineId)}/gifts`;
+        return await this.httpRequest.put(this.sessionUrl(sessionId, tenantId, path), body);
+    }
+    async applySalePromotion(sessionId, body, tenantId) {
+        await this.httpRequest.put(this.sessionUrl(sessionId, tenantId, "sale-promotion"), body);
+    }
+    async getPrivateWizardSession(sessionId, tenantId) {
+        return await this.httpRequest.get(this.sessionUrl(sessionId, tenantId));
+    }
+    /** URL de `/private/wizard/sessions/{id}[/subPath]` con `tenantId` en query. */
+    sessionUrl(sessionId, tenantId, subPath) {
+        const base = `${this.baseUrl}/private/wizard/sessions/${encodeURIComponent(sessionId)}`;
+        const query = new URLSearchParams({ tenantId });
+        return `${subPath ? `${base}/${subPath}` : base}?${query.toString()}`;
+    }
 };
 RetailWizardBusinessApi = __decorate([
     injectable(),

package/bin/retailWizard/api/interfaces/IRetailWizardBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { WizardSessionLookupResponse } from "@fiado/type-kit/bin/retailWizard/index.js";
+import type { ApplyLinePromotionRequest, ApplySalePromotionRequest, PrivateWizardSessionResponse, SetAnchorGiftsRequest, SetAnchorGiftsResponse, WizardSessionLookupResponse } from "@fiado/type-kit/bin/retailWizard/index.js";
 /**
  * Contrato del publisher HTTP del lambda `retail-wizard-business` (componente 05 SureKeep Fase 2)
  * para sus endpoints privados (service-to-service, VPC-only).
@@ -55,4 +55,21 @@ export interface IRetailWizardBusinessApi {
      *   `400 UNKNOWN_TENANT` sin `tenantId`.
      */
     getWizardSessionsByIds(wizardSessionIds: string[], tenantId: string): Promise<StandardResponse<WizardSessionLookupResponse>>;
+    /**
+     * `PUT /private/wizard/sessions/{id}/lines/{lineId}/promotion` (M2M de Promociones). Reemplaza la
+     * promo de la línea por valor. Responde 204 sin body.
+     */
+    applyLinePromotion(sessionId: string, lineId: string, body: ApplyLinePromotionRequest, tenantId: string): Promise<void>;
+    /**
+     * `PUT /private/wizard/sessions/{id}/lines/{anchorLineId}/gifts` (M2M de Promociones). Deja
+     * exactamente esos regalos en el ancla; `items: []` suelta todos.
+     */
+    setAnchorGifts(sessionId: string, anchorLineId: string, body: SetAnchorGiftsRequest, tenantId: string): Promise<StandardResponse<SetAnchorGiftsResponse>>;
+    /**
+     * `PUT /private/wizard/sessions/{id}/sale-promotion` (M2M de Promociones). Ambos campos en `null`
+     * es «Ninguna». Responde 204 sin body.
+     */
+    applySalePromotion(sessionId: string, body: ApplySalePromotionRequest, tenantId: string): Promise<void>;
+    /** `GET /private/wizard/sessions/{id}`: la sesión como la lee Promociones (líneas, ancla, promo de venta). */
+    getPrivateWizardSession(sessionId: string, tenantId: string): Promise<StandardResponse<PrivateWizardSessionResponse>>;
 }

package/bin/retailWizard/index.d.ts

@@ -1,2 +1,4 @@
 export * from "./api/interfaces/IRetailWizardBusinessApi.js";
 export { default as RetailWizardBusinessApi } from "./api/RetailWizardBusinessApi.js";
+export * from "./queue/interfaces/IRetailPromotionInboundPublisher.js";
+export * from "./queue/RetailPromotionInboundPublisher.js";

package/bin/retailWizard/index.js

@@ -1,2 +1,4 @@
 export * from "./api/interfaces/IRetailWizardBusinessApi.js";
 export { default as RetailWizardBusinessApi } from "./api/RetailWizardBusinessApi.js";
+export * from "./queue/interfaces/IRetailPromotionInboundPublisher.js";
+export * from "./queue/RetailPromotionInboundPublisher.js";

package/bin/retailWizard/queue/RetailPromotionInboundPublisher.d.ts

@@ -0,0 +1,6 @@
+import type { RetailPromotionInboundMessage } from "@fiado/type-kit/bin/retailWizard/index.js";
+import { IRetailPromotionInboundPublisher } from "./interfaces/IRetailPromotionInboundPublisher.js";
+export declare class RetailPromotionInboundPublisher implements IRetailPromotionInboundPublisher {
+    private readonly RETAIL_PROMOTION_INBOUND_QUEUE_URL;
+    publish(message: RetailPromotionInboundMessage): Promise<void>;
+}

package/bin/retailWizard/queue/RetailPromotionInboundPublisher.js

@@ -0,0 +1,31 @@
+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;
+};
+import { SendMessageCommand, SQSClient } from "@aws-sdk/client-sqs";
+import { injectable } from "inversify";
+let RetailPromotionInboundPublisher = class RetailPromotionInboundPublisher {
+    RETAIL_PROMOTION_INBOUND_QUEUE_URL = process.env.RETAIL_PROMOTION_INBOUND_QUEUE_URL;
+    async publish(message) {
+        try {
+            const client = new SQSClient();
+            // Cola estándar: sin MessageGroupId; el consumidor deduplica por venta.
+            const sendMessageRequest = {
+                QueueUrl: this.RETAIL_PROMOTION_INBOUND_QUEUE_URL,
+                MessageBody: JSON.stringify(message),
+            };
+            const command = new SendMessageCommand(sendMessageRequest);
+            await client.send(command);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error publishing message to RetailPromotionInboundQueue: ${errorMessage}`);
+        }
+    }
+};
+RetailPromotionInboundPublisher = __decorate([
+    injectable()
+], RetailPromotionInboundPublisher);
+export { RetailPromotionInboundPublisher };

package/bin/retailWizard/queue/interfaces/IRetailPromotionInboundPublisher.d.ts

@@ -0,0 +1,8 @@
+import type { RetailPromotionInboundMessage } from "@fiado/type-kit/bin/retailWizard/index.js";
+/**
+ * Publisher hacia `RetailPromotionInboundQueue` (SALE_CONFIRMED | SALE_CANCELLED), que consume `retail-promotions`.
+ * Env var requerida en el productor: `RETAIL_PROMOTION_INBOUND_QUEUE_URL`.
+ */
+export interface IRetailPromotionInboundPublisher {
+    publish(message: RetailPromotionInboundMessage): Promise<void>;
+}

package/bin/retailWizard/queue/interfaces/IRetailPromotionInboundPublisher.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.96.0",
+  "version": "5.98.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.468.0",
+    "@fiado/type-kit": "3.478.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/index.ts

@@ -88,6 +88,7 @@ export * from "./retailCatalog/index.js";
 export * from "./retailCards/index.js";
 export * from "./retailNotifications/index.js";
 export * from "./retailWizard/index.js";
+export * from "./retailPromotions/index.js";
 export * from "./shortlink/index.js";
 export * from "./loanConfig/index.js";
 export * from "./loanOfferings/index.js";

package/src/retailCatalog/api/RetailCatalogBusinessApi.ts

@@ -3,6 +3,10 @@ import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import type {
     GetStoreStockCatalogResponse,
+    HoldStockRequest,
+    HoldStockResponse,
+    InventoryLensQuery,
+    InventoryLensResponse,
     ReleaseStockRequest,
     ReleaseStockResponse,
     RenewReservationsRequest,
@@ -142,10 +146,19 @@ export default class RetailCatalogBusinessApi implements IRetailCatalogBusinessA
         query: SuggestPiecesQuery,
         tenantId: string,
     ): Promise<StandardResponse<SuggestPiecesResponse>> {
-        const extra = { sku: query.sku, prefix: query.prefix };
+        const extra: Record<string, string> = { sku: query.sku, prefix: query.prefix };
+        if (query.sessionId) extra.sessionId = query.sessionId;
         return await this.httpRequest.get(this.storeUrl(storeId, "pieces", tenantId, extra));
     }
 
+    async holdStock(
+        storeId: string,
+        body: HoldStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<HoldStockResponse>> {
+        return await this.httpRequest.put(this.storeUrl(storeId, "holds", tenantId), body);
+    }
+
     async sellStock(
         storeId: string,
         body: SellStockRequest,
@@ -186,4 +199,15 @@ export default class RetailCatalogBusinessApi implements IRetailCatalogBusinessA
     ): Promise<StandardResponse<GetStoreStockCatalogResponse>> {
         return await this.httpRequest.get(this.storeUrl(storeId, "stock-catalog", tenantId));
     }
+
+    async getInventoryLens(
+        tenantId: string,
+        retailerId: string,
+        query: InventoryLensQuery,
+    ): Promise<StandardResponse<InventoryLensResponse>> {
+        const params = new URLSearchParams({ tenantId, retailerId, filter: query.filter });
+        if (query.period) params.set("period", query.period);
+        if (query.storeId) params.set("storeId", query.storeId);
+        return await this.httpRequest.get(`${this.baseUrl}/private/inventory/lens?${params.toString()}`);
+    }
 }

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

@@ -1,6 +1,10 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import type {
     GetStoreStockCatalogResponse,
+    HoldStockRequest,
+    HoldStockResponse,
+    InventoryLensQuery,
+    InventoryLensResponse,
     MdmLockModeEnum,
     MdmProviderEnum,
     ReleaseStockRequest,
@@ -218,13 +222,19 @@ export interface IRetailCatalogBusinessApi {
         tenantId: string,
     ): Promise<StandardResponse<RenewReservationsResponse>>;
 
-    /** GET `/private/stores/{storeId}/pieces` — piezas disponibles del SKU que empiezan con `prefix`. */
+    /**
+     * GET `/private/stores/{storeId}/pieces` — piezas disponibles del SKU que empiezan con `prefix`;
+     * con `sessionId` también trae las HELD de esa sesión.
+     */
     suggestPieces(
         storeId: string,
         query: SuggestPiecesQuery,
         tenantId: string,
     ): Promise<StandardResponse<SuggestPiecesResponse>>;
 
+    /** PUT `/private/stores/{storeId}/holds` — fija como HELD de la sesión las piezas de una línea (idempotente). */
+    holdStock(storeId: string, body: HoldStockRequest, tenantId: string): Promise<StandardResponse<HoldStockResponse>>;
+
     /** 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>>;
 
@@ -251,4 +261,11 @@ export interface IRetailCatalogBusinessApi {
 
     /** GET `/private/stores/{storeId}/stock-catalog` — catálogo vendible de la tienda, una fila por SKU. */
     getStoreStockCatalog(storeId: string, tenantId: string): Promise<StandardResponse<GetStoreStockCatalogResponse>>;
+
+    /** GET `/private/inventory/lens` — lente de inventario del retailer; `period` y `storeId` solo aplican a `filter=list`. */
+    getInventoryLens(
+        tenantId: string,
+        retailerId: string,
+        query: InventoryLensQuery,
+    ): Promise<StandardResponse<InventoryLensResponse>>;
 }

package/src/retailCatalog/index.ts

@@ -1,2 +1,4 @@
 export * from "./api/interfaces/IRetailCatalogBusinessApi.js";
 export { default as RetailCatalogBusinessApi } from "./api/RetailCatalogBusinessApi.js";
+export * from "./queue/interfaces/IRetailInventoryInboundPublisher.js";
+export * from "./queue/RetailInventoryInboundPublisher.js";

package/src/retailCatalog/queue/RetailInventoryInboundPublisher.ts

@@ -0,0 +1,25 @@
+import { SendMessageCommand, SendMessageRequest, SQSClient } from "@aws-sdk/client-sqs";
+import { injectable } from "inversify";
+import type { InventoryInboundMessage } from "@fiado/type-kit/bin/retailCatalog/index.js";
+import { IRetailInventoryInboundPublisher } from "./interfaces/IRetailInventoryInboundPublisher.js";
+
+@injectable()
+export class RetailInventoryInboundPublisher implements IRetailInventoryInboundPublisher {
+    private readonly RETAIL_INVENTORY_INBOUND_QUEUE_URL = process.env.RETAIL_INVENTORY_INBOUND_QUEUE_URL;
+
+    async publish(message: InventoryInboundMessage): Promise<void> {
+        try {
+            const client: SQSClient = new SQSClient();
+            // Cola estándar: sin MessageGroupId; el consumidor deduplica por sesión y venta.
+            const sendMessageRequest: SendMessageRequest = {
+                QueueUrl: this.RETAIL_INVENTORY_INBOUND_QUEUE_URL,
+                MessageBody: JSON.stringify(message),
+            };
+            const command: SendMessageCommand = new SendMessageCommand(sendMessageRequest);
+            await client.send(command);
+        } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error publishing message to RetailInventoryInboundQueue: ${errorMessage}`);
+        }
+    }
+}

package/src/retailCatalog/queue/interfaces/IRetailInventoryInboundPublisher.ts

@@ -0,0 +1,9 @@
+import type { InventoryInboundMessage } from "@fiado/type-kit/bin/retailCatalog/index.js";
+
+/**
+ * Publisher hacia `RetailInventoryInboundQueue` (SALE_APPLIED | RETURN), que consume `retail-catalog-business`.
+ * Env var requerida en el productor: `RETAIL_INVENTORY_INBOUND_QUEUE_URL`.
+ */
+export interface IRetailInventoryInboundPublisher {
+    publish(message: InventoryInboundMessage): Promise<void>;
+}

package/src/retailPromotions/api/RetailPromotionsBusinessApi.ts

@@ -0,0 +1,23 @@
+import { inject, injectable } from "inversify";
+import type { IHttpRequest } from "@fiado/http-client";
+import { StandardResponse } from "@fiado/gateway-adapter";
+import type { PrivateReleaseSalePromotionResponse } from "@fiado/type-kit/bin/retailPromotions/index.js";
+import { IRetailPromotionsBusinessApi } from "./interfaces/IRetailPromotionsBusinessApi.js";
+
+/** Publisher HTTP de los privados de `retail-promotions-business`. Contrato -> `IRetailPromotionsBusinessApi`. */
+@injectable()
+export default class RetailPromotionsBusinessApi implements IRetailPromotionsBusinessApi {
+    // El buildspec publica la URL en SSM con "/" final; se normaliza para no armar "//private".
+    private readonly baseUrl = (process.env.RETAIL_PROMOTIONS_BUSINESS_URL || "").replace(/\/+$/, "");
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async releaseSalePromotion(
+        tenantId: string,
+        sessionId: string,
+    ): Promise<StandardResponse<PrivateReleaseSalePromotionResponse>> {
+        const query = new URLSearchParams({ tenantId });
+        const url = `${this.baseUrl}/private/sessions/${encodeURIComponent(sessionId)}/sale-promotion?${query.toString()}`;
+        return await this.httpRequest.delete(url);
+    }
+}

package/src/retailPromotions/api/interfaces/IRetailPromotionsBusinessApi.ts

@@ -0,0 +1,15 @@
+import { StandardResponse } from "@fiado/gateway-adapter";
+import type { PrivateReleaseSalePromotionResponse } from "@fiado/type-kit/bin/retailPromotions/index.js";
+
+// Contrato de los privados de `retail-promotions-business`; el caller manda `tenantId` por query.
+// El consumer necesita `RETAIL_PROMOTIONS_BUSINESS_URL` = `{{resolve:ssm:retail-promotions-business}}`.
+export interface IRetailPromotionsBusinessApi {
+    /**
+     * `DELETE /private/sessions/{sessionId}/sale-promotion`: suelta el apartado de la promo de venta.
+     * Lo llama el wizard al cancelar. Es idempotente: `released: false` si no había apartado.
+     */
+    releaseSalePromotion(
+        tenantId: string,
+        sessionId: string,
+    ): Promise<StandardResponse<PrivateReleaseSalePromotionResponse>>;
+}

package/src/retailPromotions/index.ts

@@ -0,0 +1,2 @@
+export * from "./api/interfaces/IRetailPromotionsBusinessApi.js";
+export { default as RetailPromotionsBusinessApi } from "./api/RetailPromotionsBusinessApi.js";

package/src/retailWizard/api/RetailWizardBusinessApi.ts

@@ -1,7 +1,14 @@
 import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { WizardSessionLookupResponse } from "@fiado/type-kit/bin/retailWizard/index.js";
+import type {
+    ApplyLinePromotionRequest,
+    ApplySalePromotionRequest,
+    PrivateWizardSessionResponse,
+    SetAnchorGiftsRequest,
+    SetAnchorGiftsResponse,
+    WizardSessionLookupResponse,
+} from "@fiado/type-kit/bin/retailWizard/index.js";
 import { IRetailWizardBusinessApi } from "./interfaces/IRetailWizardBusinessApi.js";
 
 /**
@@ -15,7 +22,8 @@ import { IRetailWizardBusinessApi } from "./interfaces/IRetailWizardBusinessApi.
  */
 @injectable()
 export default class RetailWizardBusinessApi implements IRetailWizardBusinessApi {
-    private readonly baseUrl = process.env.RETAIL_WIZARD_BUSINESS_URL || "";
+    // El buildspec publica la URL en SSM con "/" final; se normaliza para no armar "//private".
+    private readonly baseUrl = (process.env.RETAIL_WIZARD_BUSINESS_URL || "").replace(/\/+$/, "");
 
     constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
 
@@ -32,4 +40,47 @@ export default class RetailWizardBusinessApi implements IRetailWizardBusinessApi
         const query = new URLSearchParams({ ids: wizardSessionIds.join(","), tenantId });
         return await this.httpRequest.get(`${this.baseUrl}/private/wizard-sessions/batch?${query.toString()}`);
     }
+
+    async applyLinePromotion(
+        sessionId: string,
+        lineId: string,
+        body: ApplyLinePromotionRequest,
+        tenantId: string,
+    ): Promise<void> {
+        // El 204 no trae cuerpo (http-client devuelve ""); los errores se propagan tal cual.
+        const path = `lines/${encodeURIComponent(lineId)}/promotion`;
+        await this.httpRequest.put(this.sessionUrl(sessionId, tenantId, path), body);
+    }
+
+    async setAnchorGifts(
+        sessionId: string,
+        anchorLineId: string,
+        body: SetAnchorGiftsRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SetAnchorGiftsResponse>> {
+        const path = `lines/${encodeURIComponent(anchorLineId)}/gifts`;
+        return await this.httpRequest.put(this.sessionUrl(sessionId, tenantId, path), body);
+    }
+
+    async applySalePromotion(
+        sessionId: string,
+        body: ApplySalePromotionRequest,
+        tenantId: string,
+    ): Promise<void> {
+        await this.httpRequest.put(this.sessionUrl(sessionId, tenantId, "sale-promotion"), body);
+    }
+
+    async getPrivateWizardSession(
+        sessionId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<PrivateWizardSessionResponse>> {
+        return await this.httpRequest.get(this.sessionUrl(sessionId, tenantId));
+    }
+
+    /** URL de `/private/wizard/sessions/{id}[/subPath]` con `tenantId` en query. */
+    private sessionUrl(sessionId: string, tenantId: string, subPath?: string): string {
+        const base = `${this.baseUrl}/private/wizard/sessions/${encodeURIComponent(sessionId)}`;
+        const query = new URLSearchParams({ tenantId });
+        return `${subPath ? `${base}/${subPath}` : base}?${query.toString()}`;
+    }
 }

package/src/retailWizard/api/interfaces/IRetailWizardBusinessApi.ts

@@ -1,5 +1,12 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { WizardSessionLookupResponse } from "@fiado/type-kit/bin/retailWizard/index.js";
+import type {
+    ApplyLinePromotionRequest,
+    ApplySalePromotionRequest,
+    PrivateWizardSessionResponse,
+    SetAnchorGiftsRequest,
+    SetAnchorGiftsResponse,
+    WizardSessionLookupResponse,
+} from "@fiado/type-kit/bin/retailWizard/index.js";
 
 /**
  * Contrato del publisher HTTP del lambda `retail-wizard-business` (componente 05 SureKeep Fase 2)
@@ -59,4 +66,42 @@ export interface IRetailWizardBusinessApi {
         wizardSessionIds: string[],
         tenantId: string,
     ): Promise<StandardResponse<WizardSessionLookupResponse>>;
+
+    /**
+     * `PUT /private/wizard/sessions/{id}/lines/{lineId}/promotion` (M2M de Promociones). Reemplaza la
+     * promo de la línea por valor. Responde 204 sin body.
+     */
+    applyLinePromotion(
+        sessionId: string,
+        lineId: string,
+        body: ApplyLinePromotionRequest,
+        tenantId: string,
+    ): Promise<void>;
+
+    /**
+     * `PUT /private/wizard/sessions/{id}/lines/{anchorLineId}/gifts` (M2M de Promociones). Deja
+     * exactamente esos regalos en el ancla; `items: []` suelta todos.
+     */
+    setAnchorGifts(
+        sessionId: string,
+        anchorLineId: string,
+        body: SetAnchorGiftsRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SetAnchorGiftsResponse>>;
+
+    /**
+     * `PUT /private/wizard/sessions/{id}/sale-promotion` (M2M de Promociones). Ambos campos en `null`
+     * es «Ninguna». Responde 204 sin body.
+     */
+    applySalePromotion(
+        sessionId: string,
+        body: ApplySalePromotionRequest,
+        tenantId: string,
+    ): Promise<void>;
+
+    /** `GET /private/wizard/sessions/{id}`: la sesión como la lee Promociones (líneas, ancla, promo de venta). */
+    getPrivateWizardSession(
+        sessionId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<PrivateWizardSessionResponse>>;
 }

package/src/retailWizard/index.ts

@@ -1,2 +1,4 @@
 export * from "./api/interfaces/IRetailWizardBusinessApi.js";
 export { default as RetailWizardBusinessApi } from "./api/RetailWizardBusinessApi.js";
+export * from "./queue/interfaces/IRetailPromotionInboundPublisher.js";
+export * from "./queue/RetailPromotionInboundPublisher.js";

package/src/retailWizard/queue/RetailPromotionInboundPublisher.ts

@@ -0,0 +1,25 @@
+import { SendMessageCommand, SendMessageRequest, SQSClient } from "@aws-sdk/client-sqs";
+import { injectable } from "inversify";
+import type { RetailPromotionInboundMessage } from "@fiado/type-kit/bin/retailWizard/index.js";
+import { IRetailPromotionInboundPublisher } from "./interfaces/IRetailPromotionInboundPublisher.js";
+
+@injectable()
+export class RetailPromotionInboundPublisher implements IRetailPromotionInboundPublisher {
+    private readonly RETAIL_PROMOTION_INBOUND_QUEUE_URL = process.env.RETAIL_PROMOTION_INBOUND_QUEUE_URL;
+
+    async publish(message: RetailPromotionInboundMessage): Promise<void> {
+        try {
+            const client: SQSClient = new SQSClient();
+            // Cola estándar: sin MessageGroupId; el consumidor deduplica por venta.
+            const sendMessageRequest: SendMessageRequest = {
+                QueueUrl: this.RETAIL_PROMOTION_INBOUND_QUEUE_URL,
+                MessageBody: JSON.stringify(message),
+            };
+            const command: SendMessageCommand = new SendMessageCommand(sendMessageRequest);
+            await client.send(command);
+        } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error publishing message to RetailPromotionInboundQueue: ${errorMessage}`);
+        }
+    }
+}

package/src/retailWizard/queue/interfaces/IRetailPromotionInboundPublisher.ts

@@ -0,0 +1,9 @@
+import type { RetailPromotionInboundMessage } from "@fiado/type-kit/bin/retailWizard/index.js";
+
+/**
+ * Publisher hacia `RetailPromotionInboundQueue` (SALE_CONFIRMED | SALE_CANCELLED), que consume `retail-promotions`.
+ * Env var requerida en el productor: `RETAIL_PROMOTION_INBOUND_QUEUE_URL`.
+ */
+export interface IRetailPromotionInboundPublisher {
+    publish(message: RetailPromotionInboundMessage): Promise<void>;
+}