@fiado/api-invoker 5.123.0 → 5.124.0

package/bin/rewards-eligibility-business/api/RewardsEligibilityBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { StandardResponse } from "@fiado/gateway-adapter";
 import type { IHttpRequest } from "@fiado/http-client";
-import type { GetRunResponse, PostEventRequest, PostEventResponse } from "@fiado/type-kit/bin/rewardsEligibility/index.js";
+import type { GetRunResponse, PostEventRequest, PostEventResponse, PrivateSegmentResponse, SegmentExecutionPageResponse, SegmentExecutionRequest, SegmentExecutionResponse } from "@fiado/type-kit/bin/rewardsEligibility/index.js";
 import type { IRewardsEligibilityBusinessApi } from "./interfaces/IRewardsEligibilityBusinessApi.js";
 /** Contrato y semántica completos → `IRewardsEligibilityBusinessApi` (`StandardResponse` → leer `result.data`). */
 export declare class RewardsEligibilityBusinessApi implements IRewardsEligibilityBusinessApi {
@@ -9,4 +9,7 @@ export declare class RewardsEligibilityBusinessApi implements IRewardsEligibilit
     constructor(httpRequest: IHttpRequest);
     postEvent(request: PostEventRequest): Promise<StandardResponse<PostEventResponse>>;
     getRun(runId: string): Promise<StandardResponse<GetRunResponse>>;
+    getSegment(segmentId: string, version?: number): Promise<StandardResponse<PrivateSegmentResponse>>;
+    startSegmentExecution(segmentId: string, request: SegmentExecutionRequest): Promise<StandardResponse<SegmentExecutionResponse>>;
+    getSegmentExecutionPage(executionId: string, nextToken?: string): Promise<StandardResponse<SegmentExecutionPageResponse>>;
 }

package/bin/rewards-eligibility-business/api/RewardsEligibilityBusinessApi.js

@@ -28,6 +28,17 @@ let RewardsEligibilityBusinessApi = class RewardsEligibilityBusinessApi {
         const url = `${this.baseUrl}/runs/${encodeURIComponent(runId)}`;
         return await this.httpRequest.get(url);
     }
+    async getSegment(segmentId, version) {
+        const query = version === undefined ? "" : `?version=${version}`;
+        return await this.httpRequest.get(`${this.baseUrl}/segments/${encodeURIComponent(segmentId)}${query}`);
+    }
+    async startSegmentExecution(segmentId, request) {
+        return await this.httpRequest.post(`${this.baseUrl}/segments/${encodeURIComponent(segmentId)}/executions`, request);
+    }
+    async getSegmentExecutionPage(executionId, nextToken) {
+        const query = nextToken === undefined ? "" : `?nextToken=${encodeURIComponent(nextToken)}`;
+        return await this.httpRequest.get(`${this.baseUrl}/segments/executions/${encodeURIComponent(executionId)}${query}`);
+    }
 };
 RewardsEligibilityBusinessApi = __decorate([
     injectable(),

package/bin/rewards-eligibility-business/api/interfaces/IRewardsEligibilityBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import type { StandardResponse } from "@fiado/gateway-adapter";
-import type { GetRunResponse, PostEventRequest, PostEventResponse } from "@fiado/type-kit/bin/rewardsEligibility/index.js";
+import type { GetRunResponse, PostEventRequest, PostEventResponse, PrivateSegmentResponse, SegmentExecutionPageResponse, SegmentExecutionRequest, SegmentExecutionResponse } from "@fiado/type-kit/bin/rewardsEligibility/index.js";
 /**
  * Cliente de la API privada de `rewards-eligibility-business` (spec 2026-10-06, §6).
  *
@@ -31,4 +31,26 @@ export interface IRewardsEligibilityBusinessApi {
      * @throws propaga el error del destino (404 `RUN_NOT_FOUND`); nunca devuelve fallback.
      */
     getRun(runId: string): Promise<StandardResponse<GetRunResponse>>;
+    /**
+     * Definición de un segmento de población (versión `ACTIVE` si no se indica `version`).
+     *
+     * @throws propaga el error del destino (404 `SEGMENT_NOT_FOUND`, 409 `SEGMENT_NOT_ACTIVE`).
+     */
+    getSegment(segmentId: string, version?: number): Promise<StandardResponse<PrivateSegmentResponse>>;
+    /**
+     * Inicia la consulta del segmento. `executionId` es el `QueryExecutionId` de Athena del workgroup
+     * dedicado. Reintentar con los mismos `segmentId+version+referenceAt` NO duplica la consulta
+     * (`ClientRequestToken` determinista).
+     *
+     * @throws propaga el error del destino (404 `SEGMENT_NOT_FOUND`, 409 `SEGMENT_NOT_ACTIVE` /
+     * `SEGMENT_BLOCKED_COLUMN` / `SEGMENT_SCHEMA_DRIFT`, 503 `SEGMENT_DATALAKE_UNAVAILABLE`).
+     */
+    startSegmentExecution(segmentId: string, request: SegmentExecutionRequest): Promise<StandardResponse<SegmentExecutionResponse>>;
+    /**
+     * Página de ids de una ejecución (hasta 1000 por página); `nextToken` pagina.
+     *
+     * @throws propaga el error del destino (409 `SEGMENT_BLOCKED_COLUMN` / `SEGMENT_SCHEMA_DRIFT`,
+     * 503 `SEGMENT_DATALAKE_UNAVAILABLE`).
+     */
+    getSegmentExecutionPage(executionId: string, nextToken?: string): Promise<StandardResponse<SegmentExecutionPageResponse>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.123.0",
+  "version": "5.124.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.14.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.526.0",
+    "@fiado/type-kit": "^3.530.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/rewards-eligibility-business/api/RewardsEligibilityBusinessApi.ts

@@ -1,7 +1,15 @@
 import { inject, injectable } from "inversify";
 import type { StandardResponse } from "@fiado/gateway-adapter";
 import type { IHttpRequest } from "@fiado/http-client";
-import type { GetRunResponse, PostEventRequest, PostEventResponse } from "@fiado/type-kit/bin/rewardsEligibility/index.js";
+import type {
+    GetRunResponse,
+    PostEventRequest,
+    PostEventResponse,
+    PrivateSegmentResponse,
+    SegmentExecutionPageResponse,
+    SegmentExecutionRequest,
+    SegmentExecutionResponse,
+} from "@fiado/type-kit/bin/rewardsEligibility/index.js";
 import type { IRewardsEligibilityBusinessApi } from "./interfaces/IRewardsEligibilityBusinessApi.js";
 
 /** Contrato y semántica completos → `IRewardsEligibilityBusinessApi` (`StandardResponse` → leer `result.data`). */
@@ -23,4 +31,18 @@ export class RewardsEligibilityBusinessApi implements IRewardsEligibilityBusines
         const url = `${this.baseUrl}/runs/${encodeURIComponent(runId)}`;
         return await this.httpRequest.get<StandardResponse<GetRunResponse>>(url);
     }
+
+    async getSegment(segmentId: string, version?: number): Promise<StandardResponse<PrivateSegmentResponse>> {
+        const query = version === undefined ? "" : `?version=${version}`;
+        return await this.httpRequest.get<StandardResponse<PrivateSegmentResponse>>(`${this.baseUrl}/segments/${encodeURIComponent(segmentId)}${query}`);
+    }
+
+    async startSegmentExecution(segmentId: string, request: SegmentExecutionRequest): Promise<StandardResponse<SegmentExecutionResponse>> {
+        return await this.httpRequest.post<StandardResponse<SegmentExecutionResponse>>(`${this.baseUrl}/segments/${encodeURIComponent(segmentId)}/executions`, request);
+    }
+
+    async getSegmentExecutionPage(executionId: string, nextToken?: string): Promise<StandardResponse<SegmentExecutionPageResponse>> {
+        const query = nextToken === undefined ? "" : `?nextToken=${encodeURIComponent(nextToken)}`;
+        return await this.httpRequest.get<StandardResponse<SegmentExecutionPageResponse>>(`${this.baseUrl}/segments/executions/${encodeURIComponent(executionId)}${query}`);
+    }
 }

package/src/rewards-eligibility-business/api/interfaces/IRewardsEligibilityBusinessApi.ts

@@ -1,5 +1,13 @@
 import type { StandardResponse } from "@fiado/gateway-adapter";
-import type { GetRunResponse, PostEventRequest, PostEventResponse } from "@fiado/type-kit/bin/rewardsEligibility/index.js";
+import type {
+    GetRunResponse,
+    PostEventRequest,
+    PostEventResponse,
+    PrivateSegmentResponse,
+    SegmentExecutionPageResponse,
+    SegmentExecutionRequest,
+    SegmentExecutionResponse,
+} from "@fiado/type-kit/bin/rewardsEligibility/index.js";
 
 /**
  * Cliente de la API privada de `rewards-eligibility-business` (spec 2026-10-06, §6).
@@ -33,4 +41,29 @@ export interface IRewardsEligibilityBusinessApi {
      * @throws propaga el error del destino (404 `RUN_NOT_FOUND`); nunca devuelve fallback.
      */
     getRun(runId: string): Promise<StandardResponse<GetRunResponse>>;
+
+    /**
+     * Definición de un segmento de población (versión `ACTIVE` si no se indica `version`).
+     *
+     * @throws propaga el error del destino (404 `SEGMENT_NOT_FOUND`, 409 `SEGMENT_NOT_ACTIVE`).
+     */
+    getSegment(segmentId: string, version?: number): Promise<StandardResponse<PrivateSegmentResponse>>;
+
+    /**
+     * Inicia la consulta del segmento. `executionId` es el `QueryExecutionId` de Athena del workgroup
+     * dedicado. Reintentar con los mismos `segmentId+version+referenceAt` NO duplica la consulta
+     * (`ClientRequestToken` determinista).
+     *
+     * @throws propaga el error del destino (404 `SEGMENT_NOT_FOUND`, 409 `SEGMENT_NOT_ACTIVE` /
+     * `SEGMENT_BLOCKED_COLUMN` / `SEGMENT_SCHEMA_DRIFT`, 503 `SEGMENT_DATALAKE_UNAVAILABLE`).
+     */
+    startSegmentExecution(segmentId: string, request: SegmentExecutionRequest): Promise<StandardResponse<SegmentExecutionResponse>>;
+
+    /**
+     * Página de ids de una ejecución (hasta 1000 por página); `nextToken` pagina.
+     *
+     * @throws propaga el error del destino (409 `SEGMENT_BLOCKED_COLUMN` / `SEGMENT_SCHEMA_DRIFT`,
+     * 503 `SEGMENT_DATALAKE_UNAVAILABLE`).
+     */
+    getSegmentExecutionPage(executionId: string, nextToken?: string): Promise<StandardResponse<SegmentExecutionPageResponse>>;
 }