@fiado/api-invoker 5.95.0 → 5.97.0

package/bin/directories/DirectoriesApi.d.ts

@@ -1,6 +1,7 @@
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { IDirectoriesApi } from "./interfaces/IDirectoriesApi.js";
 import { DirectoryBackofficeResponse, DirectoryBackofficeCreateRequest, DirectoryBackofficeUpdateRequest, TypeOfDirectoryId } from '@fiado/type-kit/bin/directory/index.js';
+import type { DirectoryAgentsBySponsorResponse } from '@fiado/type-kit/bin/directory/index.js';
 type FiadoApiResponse<T> = import('@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js').default<T>;
 export declare class DirectoriesApi implements IDirectoriesApi {
     private httpRequest;
@@ -24,5 +25,6 @@ export declare class DirectoriesApi implements IDirectoriesApi {
     updateBackofficeDirectory(directoryId: string, params: DirectoryBackofficeUpdateRequest & {
         typeOfDirectoryId?: TypeOfDirectoryId;
     }): Promise<FiadoApiResponse<DirectoryBackofficeResponse>>;
+    getAgentDirectoriesBySponsorDirectoryIds(sponsorDirectoryIds: string[]): Promise<DirectoryAgentsBySponsorResponse>;
 }
 export {};

package/bin/directories/DirectoriesApi.js

@@ -12,6 +12,9 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import dotenv from 'dotenv';
 import { inject, injectable } from "inversify";
+import { DIRECTORY_AGENTS_BY_SPONSOR_MAX_BATCH } from '@fiado/type-kit/bin/directory/index.js';
+import { joinUrl } from "../utils/joinUrl.js";
+import { postIdsInBatches } from "../utils/postIdsInBatches.js";
 dotenv.config();
 let DirectoriesApi = class DirectoriesApi {
     httpRequest;
@@ -60,6 +63,10 @@ let DirectoriesApi = class DirectoriesApi {
         const url = `${this.baseUrl}directories/backoffice/${directoryId}`;
         return await this.httpRequest.put(url, params);
     }
+    async getAgentDirectoriesBySponsorDirectoryIds(sponsorDirectoryIds) {
+        const url = joinUrl(this.baseUrl, "directories/search/by-sponsor-directory-ids");
+        return await postIdsInBatches(this.httpRequest, url, "sponsorDirectoryIds", sponsorDirectoryIds, DIRECTORY_AGENTS_BY_SPONSOR_MAX_BATCH);
+    }
 };
 DirectoriesApi = __decorate([
     injectable(),

package/bin/directories/interfaces/IDirectoriesApi.d.ts

@@ -1,5 +1,6 @@
 type FiadoApiResponse<T> = import('@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js').default<T>;
 import { DirectoryBackofficeCreateRequest, DirectoryBackofficeResponse, DirectoryBackofficeUpdateRequest, TypeOfDirectoryId } from "@fiado/type-kit/bin/directory/index.js";
+import type { DirectoryAgentsBySponsorResponse } from "@fiado/type-kit/bin/directory/index.js";
 /**
  * Interfaz para el servicio Directory que permite operaciones sobre directorios.
  */
@@ -28,5 +29,10 @@ export interface IDirectoriesApi {
      * Borra físicamente el directorio de agente (DirectoryAgents_GT) por su sponsorDirectoryId.
      */
     deleteAgentBySponsorDirectoryId(sponsorDirectoryId: string): Promise<FiadoApiResponse<any>>;
+    /**
+     * POST directories/search/by-sponsor-directory-ids: directorio AGENT ganador por sponsor, en lotes de 100.
+     * Devuelve el mapa ya desempaquetado de `.data`; lanza el error del http sin fallback.
+     */
+    getAgentDirectoriesBySponsorDirectoryIds(sponsorDirectoryIds: string[]): Promise<DirectoryAgentsBySponsorResponse>;
 }
 export {};

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/platformRbac/api/PlatformRbacBusinessApi.d.ts

@@ -1,6 +1,7 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { APIGatewayProxyResultBody, ApiGatewayResponse, ResolvedPermissions, ResolveInput } from "@fiado/gateway-adapter";
 import { DefineNextChallengeRequest, DefineNextChallengeResponse, PrepareChallengeRequest, PrepareChallengeResponse, VerifyChallengeRequest, VerifyChallengeResponse, AuthorizeRequest, AuthorizeResponse, EffectivePermissionsResponse, InjectableUserAttributesResponse, PermissionScope, CreateLevelEntityRequest, CreateLevelEntityResponse, CreateTenantUserRequest, CreateTenantUserResponse, UserProfileResponse, ListLevelEntitiesResponse, LevelEntityResponse, UpdateLevelEntityRequest, DeleteLevelEntityRequest, DeleteLevelEntityResponse, ListTenantUsersResponse, GetTenantUserResponse, TenantUserResponse, TenantUserAckResponse, UpdateTenantUserRequest, DeleteTenantUserRequest, DisableTenantUserRequest, EnableTenantUserRequest, ResetTenantUserPasswordRequest, ResetTenantUserPasswordResponse, ResetTenantUserMfaRequest, ListTenantRolesResponse, AssignTenantRoleRequest, AssignTenantRoleResponse, RevokeTenantRoleRequest, RevokeTenantRoleResponse } from "@fiado/type-kit/bin/platformRbac/index.js";
+import type { TenantUsersBySubsResponse } from "@fiado/type-kit/bin/platformRbac/index.js";
 import { IPlatformRbacBusinessApi } from "./interfaces/IPlatformRbacBusinessApi.js";
 /**
  * Publisher HTTP del lambda `platform-rbac-business` (componente 06 SureKeep Fase 0)
@@ -76,4 +77,6 @@ export default class PlatformRbacBusinessApi implements IPlatformRbacBusinessApi
      * El `cognitoSub` va en el cuerpo porque es parte de la llave de la tabla de asignaciones.
      */
     revokeTenantRole(tenantId: string, assignmentId: string, input: RevokeTenantRoleRequest): Promise<APIGatewayProxyResultBody<RevokeTenantRoleResponse>>;
+    /** POST /internal/tenants/{tenantId}/users/by-subs — usuarios del tenant por cognitoSub, en lotes de 100; devuelve el mapa de `.data`. */
+    getTenantUsersBySubs(tenantId: string, cognitoSubs: string[]): Promise<TenantUsersBySubsResponse>;
 }

package/bin/platformRbac/api/PlatformRbacBusinessApi.js

@@ -11,6 +11,10 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from "inversify";
+// TD-AI-003: el tipo de retorno de los métodos viejos no refleja el runtime. Ver docs/TECH_DEBT.md.
+import { TENANT_USERS_BY_SUBS_MAX_BATCH, } from "@fiado/type-kit/bin/platformRbac/index.js";
+import { joinUrl } from "../../utils/joinUrl.js";
+import { postIdsInBatches } from "../../utils/postIdsInBatches.js";
 /**
  * Publisher HTTP del lambda `platform-rbac-business` (componente 06 SureKeep Fase 0)
  * para los 3 endpoints internos del Custom Auth Challenge flow.
@@ -185,6 +189,11 @@ let PlatformRbacBusinessApi = class PlatformRbacBusinessApi {
         const url = `${this.baseUrl}/internal/tenants/${encodeURIComponent(tenantId)}/role-assignments/${encodeURIComponent(assignmentId)}/revoke`;
         return await this.httpRequest.post(url, input);
     }
+    /** POST /internal/tenants/{tenantId}/users/by-subs — usuarios del tenant por cognitoSub, en lotes de 100; devuelve el mapa de `.data`. */
+    async getTenantUsersBySubs(tenantId, cognitoSubs) {
+        const url = joinUrl(this.baseUrl, `internal/tenants/${encodeURIComponent(tenantId)}/users/by-subs`);
+        return await postIdsInBatches(this.httpRequest, url, "cognitoSubs", cognitoSubs, TENANT_USERS_BY_SUBS_MAX_BATCH);
+    }
 };
 PlatformRbacBusinessApi = __decorate([
     injectable(),

package/bin/platformRbac/api/interfaces/IPlatformRbacBusinessApi.d.ts

@@ -1,5 +1,6 @@
 import { APIGatewayProxyResultBody, ApiGatewayResponse, ResolvedPermissions, ResolveInput } from "@fiado/gateway-adapter";
 import { DefineNextChallengeRequest, DefineNextChallengeResponse, PrepareChallengeRequest, PrepareChallengeResponse, VerifyChallengeRequest, VerifyChallengeResponse, AuthorizeRequest, AuthorizeResponse, EffectivePermissionsResponse, InjectableUserAttributesResponse, PermissionScope, CreateLevelEntityRequest, CreateLevelEntityResponse, CreateTenantUserRequest, CreateTenantUserResponse, UserProfileResponse, ListLevelEntitiesResponse, LevelEntityResponse, UpdateLevelEntityRequest, DeleteLevelEntityRequest, DeleteLevelEntityResponse, ListTenantUsersResponse, GetTenantUserResponse, TenantUserResponse, TenantUserAckResponse, UpdateTenantUserRequest, DeleteTenantUserRequest, DisableTenantUserRequest, EnableTenantUserRequest, ResetTenantUserPasswordRequest, ResetTenantUserPasswordResponse, ResetTenantUserMfaRequest, ListTenantRolesResponse, AssignTenantRoleRequest, AssignTenantRoleResponse, RevokeTenantRoleRequest, RevokeTenantRoleResponse } from "@fiado/type-kit/bin/platformRbac/index.js";
+import type { TenantUsersBySubsResponse } from "@fiado/type-kit/bin/platformRbac/index.js";
 /**
  * Contrato del publisher HTTP del lambda `platform-rbac-business` (componente 06 SureKeep Fase 0)
  * para los 3 endpoints internos del Custom Auth Challenge flow (MFA).
@@ -120,4 +121,9 @@ export interface IPlatformRbacBusinessApi {
      * El `cognitoSub` va en el cuerpo porque es parte de la llave de la tabla de asignaciones.
      */
     revokeTenantRole(tenantId: string, assignmentId: string, input: RevokeTenantRoleRequest): Promise<APIGatewayProxyResultBody<RevokeTenantRoleResponse>>;
+    /**
+     * POST /internal/tenants/{tenantId}/users/by-subs — usuarios del tenant por cognitoSub, en lotes de 100.
+     * Devuelve el mapa ya desempaquetado de `.data`; lanza el error del http sin fallback.
+     */
+    getTenantUsersBySubs(tenantId: string, cognitoSubs: string[]): Promise<TenantUsersBySubsResponse>;
 }

package/bin/referral-business/ReferralBusinessApi.d.ts

@@ -1,7 +1,8 @@
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { IReferralBusinessApi } from "./interfaces/IReferralBusinessApi.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 import { Scope } from "@fiado/type-kit/bin/directory/enums/Scope.js";
+import type { AgentsByDirectoryIdsResponse } from "@fiado/type-kit/bin/referral-business/index.js";
 export declare class ReferralBusinessApi implements IReferralBusinessApi {
     private httpRequest;
     private readonly baseUrl;
@@ -22,5 +23,6 @@ export declare class ReferralBusinessApi implements IReferralBusinessApi {
     getByDirectoryId(directoryId: string): Promise<FiadoApiResponse<any>>;
     accountOpeningsBySponsor(newDirectoryId: string, scope: Scope): Promise<FiadoApiResponse<any>>;
     deleteAgent(directoryId: string): Promise<FiadoApiResponse<any>>;
+    getAgentsByDirectoryIds(directoryIds: string[]): Promise<AgentsByDirectoryIdsResponse>;
 }
 export {};

package/bin/referral-business/ReferralBusinessApi.js

@@ -12,6 +12,9 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { inject, injectable } from "inversify";
 import dotenv from 'dotenv';
+import { AGENTS_BY_DIRECTORY_IDS_MAX_BATCH } from "@fiado/type-kit/bin/referral-business/index.js";
+import { joinUrl } from "../utils/joinUrl.js";
+import { postIdsInBatches } from "../utils/postIdsInBatches.js";
 dotenv.config();
 let ReferralBusinessApi = class ReferralBusinessApi {
     httpRequest;
@@ -39,6 +42,10 @@ let ReferralBusinessApi = class ReferralBusinessApi {
         const url = `${this.baseUrl}backoffice/agents/directory/${directoryId}`;
         return await this.httpRequest.delete(url);
     }
+    async getAgentsByDirectoryIds(directoryIds) {
+        const url = joinUrl(this.baseUrl, "private/agents/by-directory-ids");
+        return await postIdsInBatches(this.httpRequest, url, "directoryIds", directoryIds, AGENTS_BY_DIRECTORY_IDS_MAX_BATCH);
+    }
 };
 ReferralBusinessApi = __decorate([
     injectable(),

package/bin/referral-business/interfaces/IReferralBusinessApi.d.ts

@@ -1,5 +1,6 @@
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 import { Scope } from "@fiado/type-kit/bin/directory/enums/Scope.js";
+import type { AgentsByDirectoryIdsResponse } from "@fiado/type-kit/bin/referral-business/index.js";
 /**
  * Interfaz para el servicio Payroll que permite operaciones sobre payroll.
  */
@@ -46,5 +47,10 @@ export interface IReferralBusinessApi {
      * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
      */
     deleteAgent(directoryId: string): Promise<FiadoApiResponse<any>>;
+    /**
+     * POST private/agents/by-directory-ids: fila ganadora de Agents_GT por directorio, en lotes de 100.
+     * Devuelve el mapa ya desempaquetado de `.data`; lanza el error del http sin fallback.
+     */
+    getAgentsByDirectoryIds(directoryIds: string[]): Promise<AgentsByDirectoryIdsResponse>;
 }
 export {};

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, 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,6 +32,7 @@ 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>>;

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);
     }

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, 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. */

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/bin/utils/postIdsInBatches.d.ts

@@ -0,0 +1,2 @@
+import type { IHttpRequest } from "@fiado/http-client";
+export declare function postIdsInBatches<TItem>(httpRequest: IHttpRequest, url: string, bodyKey: string, ids: string[], maxBatch: number): Promise<Record<string, TItem>>;

package/bin/utils/postIdsInBatches.js

@@ -0,0 +1,22 @@
+// Deduplica y descarta ids vacíos, hace un POST por lote de `maxBatch` y fusiona los mapas de `.data`.
+// Lista vacía devuelve {} sin llamar; un error del http se propaga sin fallback.
+export async function postIdsInBatches(httpRequest, url, bodyKey, ids, maxBatch) {
+    const uniqueIds = Array.from(new Set(ids.filter((id) => typeof id === "string" && id.length > 0)));
+    const merged = {};
+    for (let i = 0; i < uniqueIds.length; i += maxBatch) {
+        const batch = uniqueIds.slice(i, i + maxBatch);
+        const response = await httpRequest.post(url, { [bodyKey]: batch });
+        Object.assign(merged, unwrapBatchMap(response, url));
+    }
+    return merged;
+}
+// Sin `.data` es un lote sin resultados; un `.data` que no es mapa es un error del contrato.
+function unwrapBatchMap(response, url) {
+    const data = response?.data;
+    if (data === undefined || data === null)
+        return {};
+    if (typeof data !== "object" || Array.isArray(data)) {
+        throw new Error(`La respuesta batch de ${url} no trae un mapa en .data`);
+    }
+    return data;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.95.0",
+  "version": "5.97.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.466.0",
+    "@fiado/type-kit": "3.473.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/directories/DirectoriesApi.ts

@@ -1,8 +1,11 @@
 import dotenv from 'dotenv';
 import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { IDirectoriesApi } from "./interfaces/IDirectoriesApi.js";
-import { DirectoryBackofficeResponse, DirectoryBackofficeCreateRequest, DirectoryBackofficeUpdateRequest, TypeOfDirectoryId } from '@fiado/type-kit/bin/directory/index.js';
+import { DirectoryBackofficeResponse, DirectoryBackofficeCreateRequest, DirectoryBackofficeUpdateRequest, TypeOfDirectoryId, DIRECTORY_AGENTS_BY_SPONSOR_MAX_BATCH } from '@fiado/type-kit/bin/directory/index.js';
+import type { DirectoryAgentBySponsorItem, DirectoryAgentsBySponsorResponse } from '@fiado/type-kit/bin/directory/index.js';
+import { joinUrl } from "../utils/joinUrl.js";
+import { postIdsInBatches } from "../utils/postIdsInBatches.js";
 type FiadoApiResponse<T> = import('@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js').default<T>;
 dotenv.config();
 
@@ -65,4 +68,11 @@ export class DirectoriesApi implements IDirectoriesApi {
         const url: string = `${this.baseUrl}directories/backoffice/${directoryId}`;
         return await this.httpRequest.put(url, params);
     }
+
+    async getAgentDirectoriesBySponsorDirectoryIds(sponsorDirectoryIds: string[]): Promise<DirectoryAgentsBySponsorResponse> {
+        const url = joinUrl(this.baseUrl, "directories/search/by-sponsor-directory-ids");
+        return await postIdsInBatches<DirectoryAgentBySponsorItem>(
+            this.httpRequest, url, "sponsorDirectoryIds", sponsorDirectoryIds, DIRECTORY_AGENTS_BY_SPONSOR_MAX_BATCH,
+        );
+    }
 }

package/src/directories/interfaces/IDirectoriesApi.ts

@@ -1,5 +1,6 @@
 type FiadoApiResponse<T> = import('@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js').default<T>;
 import { DirectoryBackofficeCreateRequest, DirectoryBackofficeResponse, DirectoryBackofficeUpdateRequest, TypeOfDirectoryId } from "@fiado/type-kit/bin/directory/index.js";
+import type { DirectoryAgentsBySponsorResponse } from "@fiado/type-kit/bin/directory/index.js";
 
 /**
  * Interfaz para el servicio Directory que permite operaciones sobre directorios.
@@ -18,4 +19,9 @@ export interface IDirectoriesApi {
      * Borra físicamente el directorio de agente (DirectoryAgents_GT) por su sponsorDirectoryId.
      */
     deleteAgentBySponsorDirectoryId(sponsorDirectoryId: string): Promise<FiadoApiResponse<any>>;
+    /**
+     * POST directories/search/by-sponsor-directory-ids: directorio AGENT ganador por sponsor, en lotes de 100.
+     * Devuelve el mapa ya desempaquetado de `.data`; lanza el error del http sin fallback.
+     */
+    getAgentDirectoriesBySponsorDirectoryIds(sponsorDirectoryIds: string[]): Promise<DirectoryAgentsBySponsorResponse>;
 }

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/platformRbac/api/PlatformRbacBusinessApi.ts

@@ -45,8 +45,12 @@ import {
     AssignTenantRoleResponse,
     RevokeTenantRoleRequest,
     RevokeTenantRoleResponse,
+    TENANT_USERS_BY_SUBS_MAX_BATCH,
 } from "@fiado/type-kit/bin/platformRbac/index.js";
+import type { TenantUserBySubItem, TenantUsersBySubsResponse } from "@fiado/type-kit/bin/platformRbac/index.js";
 import { IPlatformRbacBusinessApi } from "./interfaces/IPlatformRbacBusinessApi.js";
+import { joinUrl } from "../../utils/joinUrl.js";
+import { postIdsInBatches } from "../../utils/postIdsInBatches.js";
 
 /**
  * Publisher HTTP del lambda `platform-rbac-business` (componente 06 SureKeep Fase 0)
@@ -333,4 +337,12 @@ export default class PlatformRbacBusinessApi implements IPlatformRbacBusinessApi
         const url = `${this.baseUrl}/internal/tenants/${encodeURIComponent(tenantId)}/role-assignments/${encodeURIComponent(assignmentId)}/revoke`;
         return await this.httpRequest.post(url, input);
     }
+
+    /** POST /internal/tenants/{tenantId}/users/by-subs — usuarios del tenant por cognitoSub, en lotes de 100; devuelve el mapa de `.data`. */
+    async getTenantUsersBySubs(tenantId: string, cognitoSubs: string[]): Promise<TenantUsersBySubsResponse> {
+        const url = joinUrl(this.baseUrl, `internal/tenants/${encodeURIComponent(tenantId)}/users/by-subs`);
+        return await postIdsInBatches<TenantUserBySubItem>(
+            this.httpRequest, url, "cognitoSubs", cognitoSubs, TENANT_USERS_BY_SUBS_MAX_BATCH,
+        );
+    }
 }

package/src/platformRbac/api/interfaces/IPlatformRbacBusinessApi.ts

@@ -43,6 +43,7 @@ import {
     RevokeTenantRoleRequest,
     RevokeTenantRoleResponse,
 } from "@fiado/type-kit/bin/platformRbac/index.js";
+import type { TenantUsersBySubsResponse } from "@fiado/type-kit/bin/platformRbac/index.js";
 
 /**
  * Contrato del publisher HTTP del lambda `platform-rbac-business` (componente 06 SureKeep Fase 0)
@@ -273,4 +274,10 @@ export interface IPlatformRbacBusinessApi {
         assignmentId: string,
         input: RevokeTenantRoleRequest,
     ): Promise<APIGatewayProxyResultBody<RevokeTenantRoleResponse>>;
+
+    /**
+     * POST /internal/tenants/{tenantId}/users/by-subs — usuarios del tenant por cognitoSub, en lotes de 100.
+     * Devuelve el mapa ya desempaquetado de `.data`; lanza el error del http sin fallback.
+     */
+    getTenantUsersBySubs(tenantId: string, cognitoSubs: string[]): Promise<TenantUsersBySubsResponse>;
 }

package/src/referral-business/ReferralBusinessApi.ts

@@ -1,9 +1,13 @@
 import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import dotenv from 'dotenv';
 import { IReferralBusinessApi } from "./interfaces/IReferralBusinessApi.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 import { Scope } from "@fiado/type-kit/bin/directory/enums/Scope.js";
+import { AGENTS_BY_DIRECTORY_IDS_MAX_BATCH } from "@fiado/type-kit/bin/referral-business/index.js";
+import type { AgentByDirectoryIdItem, AgentsByDirectoryIdsResponse } from "@fiado/type-kit/bin/referral-business/index.js";
+import { joinUrl } from "../utils/joinUrl.js";
+import { postIdsInBatches } from "../utils/postIdsInBatches.js";
 
 dotenv.config();
 
@@ -40,4 +44,11 @@ export class ReferralBusinessApi implements IReferralBusinessApi {
         const url = `${this.baseUrl}backoffice/agents/directory/${directoryId}`;
         return await this.httpRequest.delete(url);
     }
+
+    async getAgentsByDirectoryIds(directoryIds: string[]): Promise<AgentsByDirectoryIdsResponse> {
+        const url = joinUrl(this.baseUrl, "private/agents/by-directory-ids");
+        return await postIdsInBatches<AgentByDirectoryIdItem>(
+            this.httpRequest, url, "directoryIds", directoryIds, AGENTS_BY_DIRECTORY_IDS_MAX_BATCH,
+        );
+    }
 }

package/src/referral-business/interfaces/IReferralBusinessApi.ts

@@ -1,5 +1,6 @@
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 import { Scope } from "@fiado/type-kit/bin/directory/enums/Scope.js";
+import type { AgentsByDirectoryIdsResponse } from "@fiado/type-kit/bin/referral-business/index.js";
 
 /**
  * Interfaz para el servicio Payroll que permite operaciones sobre payroll.
@@ -42,4 +43,10 @@ export interface IReferralBusinessApi {
      * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
      */
     deleteAgent(directoryId: string): Promise<FiadoApiResponse<any>>;
+
+    /**
+     * POST private/agents/by-directory-ids: fila ganadora de Agents_GT por directorio, en lotes de 100.
+     * Devuelve el mapa ya desempaquetado de `.data`; lanza el error del http sin fallback.
+     */
+    getAgentsByDirectoryIds(directoryIds: string[]): Promise<AgentsByDirectoryIdsResponse>;
 }

package/src/retailCatalog/api/RetailCatalogBusinessApi.ts

@@ -3,6 +3,8 @@ import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import type {
     GetStoreStockCatalogResponse,
+    HoldStockRequest,
+    HoldStockResponse,
     ReleaseStockRequest,
     ReleaseStockResponse,
     RenewReservationsRequest,
@@ -142,10 +144,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,

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

@@ -1,6 +1,8 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import type {
     GetStoreStockCatalogResponse,
+    HoldStockRequest,
+    HoldStockResponse,
     MdmLockModeEnum,
     MdmProviderEnum,
     ReleaseStockRequest,
@@ -218,13 +220,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>>;
 

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>;
+}

package/src/utils/postIdsInBatches.ts

@@ -0,0 +1,40 @@
+import type { IHttpRequest } from "@fiado/http-client";
+
+// Envelope Fiado de las respuestas batch: el mapa viaja en `.data`.
+interface BatchMapEnvelope<TItem> {
+    data?: Record<string, TItem> | null;
+}
+
+// Deduplica y descarta ids vacíos, hace un POST por lote de `maxBatch` y fusiona los mapas de `.data`.
+// Lista vacía devuelve {} sin llamar; un error del http se propaga sin fallback.
+export async function postIdsInBatches<TItem>(
+    httpRequest: IHttpRequest,
+    url: string,
+    bodyKey: string,
+    ids: string[],
+    maxBatch: number,
+): Promise<Record<string, TItem>> {
+    const uniqueIds = Array.from(new Set(ids.filter((id) => typeof id === "string" && id.length > 0)));
+    const merged: Record<string, TItem> = {};
+
+    for (let i = 0; i < uniqueIds.length; i += maxBatch) {
+        const batch = uniqueIds.slice(i, i + maxBatch);
+        const response = await httpRequest.post<BatchMapEnvelope<TItem>>(url, { [bodyKey]: batch });
+        Object.assign(merged, unwrapBatchMap(response, url));
+    }
+
+    return merged;
+}
+
+// Sin `.data` es un lote sin resultados; un `.data` que no es mapa es un error del contrato.
+function unwrapBatchMap<TItem>(
+    response: BatchMapEnvelope<TItem> | null | undefined,
+    url: string,
+): Record<string, TItem> {
+    const data = response?.data;
+    if (data === undefined || data === null) return {};
+    if (typeof data !== "object" || Array.isArray(data)) {
+        throw new Error(`La respuesta batch de ${url} no trae un mapa en .data`);
+    }
+    return data;
+}