@fiado/api-invoker 5.17.0 → 5.19.0

package/bin/datalakeQuery/api/DatalakeQueryBusinessApi.d.ts

@@ -0,0 +1,22 @@
+import type { IHttpRequest } from "@fiado/http-client";
+import { StandardResponse } from "@fiado/gateway-adapter";
+import { AggregateRequestDto, ReportResultDto } from "@fiado/type-kit/bin/datalakeQuery/index.js";
+import { IDatalakeQueryBusinessApi } from "./interfaces/IDatalakeQueryBusinessApi.js";
+/**
+ * Publisher HTTP de `datalake-query-business` — el bibliotecario del data lake.
+ *
+ * Contrato y semántica completos → `IDatalakeQueryBusinessApi`.
+ *
+ * Env var requerida en el consumer: `DATALAKE_QUERY_BUSINESS_URL`, resuelta desde
+ * `{{resolve:ssm:datalake-query-business}}`.
+ *
+ * ⚠️ Los paths **no** están verificados contra dev: el lambda todavía no se ha desplegado, porque
+ * el data lake no tiene aún las tablas en estado consultable. Matchean su `openapi/private.yaml`.
+ */
+export default class DatalakeQueryBusinessApi implements IDatalakeQueryBusinessApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    aggregate(request: AggregateRequestDto): Promise<StandardResponse<ReportResultDto>>;
+    getJob(jobId: string, tenantId: string, nextToken?: string): Promise<StandardResponse<ReportResultDto>>;
+}

package/bin/datalakeQuery/api/DatalakeQueryBusinessApi.js

@@ -0,0 +1,50 @@
+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 `datalake-query-business` — el bibliotecario del data lake.
+ *
+ * Contrato y semántica completos → `IDatalakeQueryBusinessApi`.
+ *
+ * Env var requerida en el consumer: `DATALAKE_QUERY_BUSINESS_URL`, resuelta desde
+ * `{{resolve:ssm:datalake-query-business}}`.
+ *
+ * ⚠️ Los paths **no** están verificados contra dev: el lambda todavía no se ha desplegado, porque
+ * el data lake no tiene aún las tablas en estado consultable. Matchean su `openapi/private.yaml`.
+ */
+let DatalakeQueryBusinessApi = class DatalakeQueryBusinessApi {
+    httpRequest;
+    baseUrl = process.env.DATALAKE_QUERY_BUSINESS_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async aggregate(request) {
+        const url = `${this.baseUrl}/private/analytics/aggregate`;
+        // El tenant va en el CUERPO, en su propio campo — nunca mezclado con el reporte ni usado
+        // como valor dentro del SQL. El destino lo resuelve contra el registry.
+        return await this.httpRequest.post(url, request);
+    }
+    async getJob(jobId, tenantId, nextToken) {
+        const params = new URLSearchParams({ tenantId });
+        if (nextToken)
+            params.set("nextToken", nextToken);
+        const url = `${this.baseUrl}/private/analytics/jobs/${encodeURIComponent(jobId)}?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
+};
+DatalakeQueryBusinessApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], DatalakeQueryBusinessApi);
+export default DatalakeQueryBusinessApi;

package/bin/datalakeQuery/api/interfaces/IDatalakeQueryBusinessApi.d.ts

@@ -0,0 +1,61 @@
+import { StandardResponse } from "@fiado/gateway-adapter";
+import { AggregateRequestDto, ReportResultDto } from "@fiado/type-kit/bin/datalakeQuery/index.js";
+/**
+ * Contrato del publisher HTTP de `datalake-query-business` — **el único lambda que consulta el
+ * data lake**.
+ *
+ * Los demás no hablan con Athena: le hablan a él. Así el rol cross-account, el compilador de SQL y
+ * los predicados de aislamiento viven en UN solo lugar, y el día que cambie el modelo (rol por
+ * tenant, Lake Formation) se toca un repo, no cuatro.
+ *
+ * Consumidores previstos:
+ *   - `retail-org-business`    → KPIs de tiendas y vendedores (piezas, vendido, vs 7d)
+ *   - `retail-wizard-business` → agregados del portal y estadísticas de venta
+ *
+ * Env var requerida en el consumer: `DATALAKE_QUERY_BUSINESS_URL`.
+ * El template.yml del consumer la setea con:
+ *
+ *   DATALAKE_QUERY_BUSINESS_URL: '{{resolve:ssm:datalake-query-business}}'
+ *
+ * Convención CLAUDE.md global: SSM key = nombre del lambda owner de la URL.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * `tenantId` y `callerService` son OBLIGATORIOS — no son detalle de firma
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Los privados NO llevan token de usuario (`Feature.ANONIMUS`; la protección es la red VPC), así
+ * que el destino no tiene `issuer` y **no puede inferir el silo**. El caller lo declara y
+ * `@fiado/tenant-context` asume el rol de ESE silo. Sin `tenantId` → error; **nunca hay default**:
+ * caer a uno sería fail-OPEN y podría devolver datos de otra SOFOM.
+ *
+ * `callerService` queda registrado en el job. Con un privado M2M es lo único que después permite
+ * auditar quién pidió por cuál tenant.
+ *
+ * ⚠️ **Ser privado es aislamiento de red, no de identidad.** Cualquier lambda de la VPC puede decir
+ * de qué tenant es. Lo que acota el daño es que una mentira da **exactamente un** tenant — el que
+ * nombró — y que cada corrida queda registrada.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * ⚠️ Patrón de retorno: `StandardResponse<T>` — el consumer accede `result.data`, NO `result.body`.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+export interface IDatalakeQueryBusinessApi {
+    /**
+     * Corre un agregado sobre el data lake y devuelve el resultado.
+     *
+     * 🔴 **La respuesta es un `if`:** si `data.rows` viene, ya está. Si viene solo `data.jobId`, la
+     * consulta excedió la espera en línea (~20 s, por el corte duro de API Gateway a los 29) y hay
+     * que pollearla. El consumer tiene que manejar los dos casos — asumir que siempre habrá `rows`
+     * lo rompe justo con las consultas pesadas, que son las que más importan.
+     *
+     * El alcance de las filas NO lo decide este request: lo impone el destino a partir del `scope`
+     * y del `tenantId`, sobre **cada** tabla del `FROM` y de cada `JOIN`.
+     */
+    aggregate(request: AggregateRequestDto): Promise<StandardResponse<ReportResultDto>>;
+    /**
+     * Estado y filas de un reporte que quedó en polling.
+     *
+     * El `jobId` es el ULID que devolvió `aggregate`, no el id de Athena — ese no sale nunca del
+     * destino. Pedir el job de otro tenant devuelve 404, igual que uno inexistente.
+     */
+    getJob(jobId: string, tenantId: string, nextToken?: string): Promise<StandardResponse<ReportResultDto>>;
+}

package/bin/datalakeQuery/api/interfaces/IDatalakeQueryBusinessApi.js

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

package/bin/datalakeQuery/index.d.ts

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

package/bin/datalakeQuery/index.js

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

package/bin/index.d.ts

@@ -81,6 +81,7 @@ export * from "./milestone-business/index.js";
 export * from "./cognitoBackofficeConnector/index.js";
 export * from "./platformRbac/index.js";
 export * from "./retailOrg/index.js";
+export * from "./datalakeQuery/index.js";
 export * from "./retailCustomer/index.js";
 export * from "./retailCatalog/index.js";
 export * from "./retailCards/index.js";

package/bin/index.js

@@ -81,6 +81,7 @@ export * from "./milestone-business/index.js";
 export * from "./cognitoBackofficeConnector/index.js";
 export * from "./platformRbac/index.js";
 export * from "./retailOrg/index.js";
+export * from "./datalakeQuery/index.js";
 export * from "./retailCustomer/index.js";
 export * from "./retailCatalog/index.js";
 export * from "./retailCards/index.js";

package/bin/membership/MembershipApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { IMembershipApi } from "./interfaces/IMembershipApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export declare class MembershipApi implements IMembershipApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/membership/MembershipApi.js

@@ -0,0 +1,32 @@
+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";
+import dotenv from 'dotenv';
+dotenv.config();
+let MembershipApi = class MembershipApi {
+    httpRequest;
+    baseUrl = process.env.MEMBERSHIP_BUSINESS_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async deleteByDirectoryId(directoryId) {
+        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        return await this.httpRequest.delete(url);
+    }
+};
+MembershipApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], MembershipApi);
+export { MembershipApi };

package/bin/membership/index.d.ts

@@ -0,0 +1,2 @@
+export * from './interfaces/IMembershipApi.js';
+export * from './MembershipApi.js';

package/bin/membership/index.js

@@ -0,0 +1,2 @@
+export * from './interfaces/IMembershipApi.js';
+export * from './MembershipApi.js';

package/bin/membership/interfaces/IMembershipApi.d.ts

@@ -0,0 +1,15 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Interfaz para el servicio Membership (membership-business).
+ */
+export interface IMembershipApi {
+    /**
+     * Borra en cascada las membresías asociadas a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/membership/interfaces/IMembershipApi.js

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

package/bin/notificationWebsockets/NotificationWebsocketApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { INotificationWebsocketApi } from "./interfaces/INotificationWebsocketApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export declare class NotificationWebsocketApi implements INotificationWebsocketApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/notificationWebsockets/NotificationWebsocketApi.js

@@ -0,0 +1,32 @@
+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";
+import dotenv from 'dotenv';
+dotenv.config();
+let NotificationWebsocketApi = class NotificationWebsocketApi {
+    httpRequest;
+    baseUrl = process.env.NOTIFICATIONS_WEBSOCKET_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async deleteByDirectoryId(directoryId) {
+        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        return await this.httpRequest.delete(url);
+    }
+};
+NotificationWebsocketApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], NotificationWebsocketApi);
+export { NotificationWebsocketApi };

package/bin/notificationWebsockets/interfaces/INotificationWebsocketApi.d.ts

@@ -0,0 +1,15 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Interfaz para el servicio Notifications Websocket (notifications-websocket).
+ */
+export interface INotificationWebsocketApi {
+    /**
+     * Borra en cascada las conexiones/notificaciones WS asociadas a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/notificationWebsockets/interfaces/INotificationWebsocketApi.js

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

package/bin/performance-profile/PerformanceProfileApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { IPerformanceProfileApi } from "./interfaces/IPerformanceProfileApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export declare class PerformanceProfileApi implements IPerformanceProfileApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/performance-profile/PerformanceProfileApi.js

@@ -0,0 +1,32 @@
+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";
+import dotenv from 'dotenv';
+dotenv.config();
+let PerformanceProfileApi = class PerformanceProfileApi {
+    httpRequest;
+    baseUrl = process.env.PERFORMANCE_PROFILE_BUSINESS_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async deleteByDirectoryId(directoryId) {
+        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        return await this.httpRequest.delete(url);
+    }
+};
+PerformanceProfileApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], PerformanceProfileApi);
+export { PerformanceProfileApi };

package/bin/performance-profile/index.d.ts

@@ -0,0 +1,2 @@
+export * from './interfaces/IPerformanceProfileApi.js';
+export * from './PerformanceProfileApi.js';

package/bin/performance-profile/index.js

@@ -0,0 +1,2 @@
+export * from './interfaces/IPerformanceProfileApi.js';
+export * from './PerformanceProfileApi.js';

package/bin/performance-profile/interfaces/IPerformanceProfileApi.d.ts

@@ -0,0 +1,15 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Interfaz para el servicio Performance Profile (performance-profile-business).
+ */
+export interface IPerformanceProfileApi {
+    /**
+     * Borra en cascada los perfiles de desempeño asociados a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/performance-profile/interfaces/IPerformanceProfileApi.js

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

package/bin/presence-websocket/PresenceWebsocketApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { IPresenceWebsocketApi } from "./interfaces/IPresenceWebsocketApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export declare class PresenceWebsocketApi implements IPresenceWebsocketApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/presence-websocket/PresenceWebsocketApi.js

@@ -0,0 +1,32 @@
+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";
+import dotenv from 'dotenv';
+dotenv.config();
+let PresenceWebsocketApi = class PresenceWebsocketApi {
+    httpRequest;
+    baseUrl = process.env.PRESENCE_WEBSOCKET_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async deleteByDirectoryId(directoryId) {
+        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        return await this.httpRequest.delete(url);
+    }
+};
+PresenceWebsocketApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], PresenceWebsocketApi);
+export { PresenceWebsocketApi };

package/bin/presence-websocket/index.d.ts

@@ -0,0 +1,2 @@
+export * from './interfaces/IPresenceWebsocketApi.js';
+export * from './PresenceWebsocketApi.js';

package/bin/presence-websocket/index.js

@@ -0,0 +1,2 @@
+export * from './interfaces/IPresenceWebsocketApi.js';
+export * from './PresenceWebsocketApi.js';

package/bin/presence-websocket/interfaces/IPresenceWebsocketApi.d.ts

@@ -0,0 +1,15 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Interfaz para el servicio Presence Websocket (presence-websocket).
+ */
+export interface IPresenceWebsocketApi {
+    /**
+     * Borra en cascada los registros de presencia asociados a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/presence-websocket/interfaces/IPresenceWebsocketApi.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.17.0",
+  "version": "5.19.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.272.0",
+    "@fiado/type-kit": "^3.276.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/datalakeQuery/api/DatalakeQueryBusinessApi.ts

@@ -0,0 +1,46 @@
+import { inject, injectable } from "inversify";
+import type { IHttpRequest } from "@fiado/http-client";
+import { StandardResponse } from "@fiado/gateway-adapter";
+import {
+    AggregateRequestDto,
+    ReportResultDto,
+} from "@fiado/type-kit/bin/datalakeQuery/index.js";
+import { IDatalakeQueryBusinessApi } from "./interfaces/IDatalakeQueryBusinessApi.js";
+
+/**
+ * Publisher HTTP de `datalake-query-business` — el bibliotecario del data lake.
+ *
+ * Contrato y semántica completos → `IDatalakeQueryBusinessApi`.
+ *
+ * Env var requerida en el consumer: `DATALAKE_QUERY_BUSINESS_URL`, resuelta desde
+ * `{{resolve:ssm:datalake-query-business}}`.
+ *
+ * ⚠️ Los paths **no** están verificados contra dev: el lambda todavía no se ha desplegado, porque
+ * el data lake no tiene aún las tablas en estado consultable. Matchean su `openapi/private.yaml`.
+ */
+@injectable()
+export default class DatalakeQueryBusinessApi implements IDatalakeQueryBusinessApi {
+    private readonly baseUrl = process.env.DATALAKE_QUERY_BUSINESS_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async aggregate(
+        request: AggregateRequestDto,
+    ): Promise<StandardResponse<ReportResultDto>> {
+        const url = `${this.baseUrl}/private/analytics/aggregate`;
+        // El tenant va en el CUERPO, en su propio campo — nunca mezclado con el reporte ni usado
+        // como valor dentro del SQL. El destino lo resuelve contra el registry.
+        return await this.httpRequest.post(url, request);
+    }
+
+    async getJob(
+        jobId: string,
+        tenantId: string,
+        nextToken?: string,
+    ): Promise<StandardResponse<ReportResultDto>> {
+        const params = new URLSearchParams({ tenantId });
+        if (nextToken) params.set("nextToken", nextToken);
+        const url = `${this.baseUrl}/private/analytics/jobs/${encodeURIComponent(jobId)}?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
+}

package/src/datalakeQuery/api/interfaces/IDatalakeQueryBusinessApi.ts

@@ -0,0 +1,66 @@
+import { StandardResponse } from "@fiado/gateway-adapter";
+import {
+    AggregateRequestDto,
+    ReportResultDto,
+} from "@fiado/type-kit/bin/datalakeQuery/index.js";
+
+/**
+ * Contrato del publisher HTTP de `datalake-query-business` — **el único lambda que consulta el
+ * data lake**.
+ *
+ * Los demás no hablan con Athena: le hablan a él. Así el rol cross-account, el compilador de SQL y
+ * los predicados de aislamiento viven en UN solo lugar, y el día que cambie el modelo (rol por
+ * tenant, Lake Formation) se toca un repo, no cuatro.
+ *
+ * Consumidores previstos:
+ *   - `retail-org-business`    → KPIs de tiendas y vendedores (piezas, vendido, vs 7d)
+ *   - `retail-wizard-business` → agregados del portal y estadísticas de venta
+ *
+ * Env var requerida en el consumer: `DATALAKE_QUERY_BUSINESS_URL`.
+ * El template.yml del consumer la setea con:
+ *
+ *   DATALAKE_QUERY_BUSINESS_URL: '{{resolve:ssm:datalake-query-business}}'
+ *
+ * Convención CLAUDE.md global: SSM key = nombre del lambda owner de la URL.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * `tenantId` y `callerService` son OBLIGATORIOS — no son detalle de firma
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Los privados NO llevan token de usuario (`Feature.ANONIMUS`; la protección es la red VPC), así
+ * que el destino no tiene `issuer` y **no puede inferir el silo**. El caller lo declara y
+ * `@fiado/tenant-context` asume el rol de ESE silo. Sin `tenantId` → error; **nunca hay default**:
+ * caer a uno sería fail-OPEN y podría devolver datos de otra SOFOM.
+ *
+ * `callerService` queda registrado en el job. Con un privado M2M es lo único que después permite
+ * auditar quién pidió por cuál tenant.
+ *
+ * ⚠️ **Ser privado es aislamiento de red, no de identidad.** Cualquier lambda de la VPC puede decir
+ * de qué tenant es. Lo que acota el daño es que una mentira da **exactamente un** tenant — el que
+ * nombró — y que cada corrida queda registrada.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * ⚠️ Patrón de retorno: `StandardResponse<T>` — el consumer accede `result.data`, NO `result.body`.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+export interface IDatalakeQueryBusinessApi {
+    /**
+     * Corre un agregado sobre el data lake y devuelve el resultado.
+     *
+     * 🔴 **La respuesta es un `if`:** si `data.rows` viene, ya está. Si viene solo `data.jobId`, la
+     * consulta excedió la espera en línea (~20 s, por el corte duro de API Gateway a los 29) y hay
+     * que pollearla. El consumer tiene que manejar los dos casos — asumir que siempre habrá `rows`
+     * lo rompe justo con las consultas pesadas, que son las que más importan.
+     *
+     * El alcance de las filas NO lo decide este request: lo impone el destino a partir del `scope`
+     * y del `tenantId`, sobre **cada** tabla del `FROM` y de cada `JOIN`.
+     */
+    aggregate(request: AggregateRequestDto): Promise<StandardResponse<ReportResultDto>>;
+
+    /**
+     * Estado y filas de un reporte que quedó en polling.
+     *
+     * El `jobId` es el ULID que devolvió `aggregate`, no el id de Athena — ese no sale nunca del
+     * destino. Pedir el job de otro tenant devuelve 404, igual que uno inexistente.
+     */
+    getJob(jobId: string, tenantId: string, nextToken?: string): Promise<StandardResponse<ReportResultDto>>;
+}

package/src/datalakeQuery/index.ts

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

package/src/index.ts

@@ -81,6 +81,7 @@ export * from "./milestone-business/index.js";
 export * from "./cognitoBackofficeConnector/index.js";
 export * from "./platformRbac/index.js";
 export * from "./retailOrg/index.js";
+export * from "./datalakeQuery/index.js";
 export * from "./retailCustomer/index.js";
 export * from "./retailCatalog/index.js";
 export * from "./retailCards/index.js";