@fiado/api-invoker 5.129.0 → 5.131.0

package/bin/loanCredit/api/dtos/CreditLifecycleFact.d.ts

@@ -12,7 +12,9 @@ export declare enum CreditLifecycleFactEnum {
     CREDIT_SETTLED = "CREDIT_SETTLED",
     DEVICE_UNLOCKED = "DEVICE_UNLOCKED",
     /** Bienvenida al cerrar la venta. Solo la pista de crédito: la de contado no tiene `creditId`. */
-    APP_WELCOME = "APP_WELCOME"
+    APP_WELCOME = "APP_WELCOME",
+    /** La venta se canceló y su crédito quedó descartado. Solo tras un descarte exitoso. */
+    SALE_CANCELLED_CREDIT_DISCARDED = "SALE_CANCELLED_CREDIT_DISCARDED"
 }
 /** Body de `POST /private/credits/{creditId}/lifecycle-facts`. */
 export interface CreditLifecycleFactRequest {

package/bin/loanCredit/api/dtos/CreditLifecycleFact.js

@@ -14,4 +14,6 @@ export var CreditLifecycleFactEnum;
     CreditLifecycleFactEnum["DEVICE_UNLOCKED"] = "DEVICE_UNLOCKED";
     /** Bienvenida al cerrar la venta. Solo la pista de crédito: la de contado no tiene `creditId`. */
     CreditLifecycleFactEnum["APP_WELCOME"] = "APP_WELCOME";
+    /** La venta se canceló y su crédito quedó descartado. Solo tras un descarte exitoso. */
+    CreditLifecycleFactEnum["SALE_CANCELLED_CREDIT_DISCARDED"] = "SALE_CANCELLED_CREDIT_DISCARDED";
 })(CreditLifecycleFactEnum || (CreditLifecycleFactEnum = {}));

package/bin/rules-business/api/RulesApi.d.ts

@@ -1,6 +1,6 @@
 import type { StandardResponse } from "@fiado/gateway-adapter";
 import type { IHttpRequest } from "@fiado/http-client";
-import type { EvaluateRulesRequest, EvaluateRulesResponse, GenerateRulesRequest, GenerateRulesResponse, RulesCatalogResponse, ValidateRulesRequest, ValidateRulesResponse } from "@fiado/type-kit/bin/rules/index.js";
+import type { EvaluateRulesRequest, EvaluateRulesResponse, GenerateRulesRequest, GenerateRulesResponse, PopulationCompileRequest, PopulationCompileResponse, PopulationExecutionPageResponse, PopulationExecutionRequest, PopulationExecutionResponse, PopulationTestRequest, PopulationTestResponse, RulesCatalogResponse, SegmentSchemaResponse, SegmentTableSchemaResponse, ValidateRulesRequest, ValidateRulesResponse } from "@fiado/type-kit/bin/rules/index.js";
 import type { IRulesApi } from "./interfaces/IRulesApi.js";
 /**
  * Contrato y semántica completos → `IRulesApi` (`StandardResponse` → leer `result.data`).
@@ -14,4 +14,11 @@ export declare class RulesApi implements IRulesApi {
     validate(request: ValidateRulesRequest): Promise<StandardResponse<ValidateRulesResponse>>;
     generate(request: GenerateRulesRequest): Promise<StandardResponse<GenerateRulesResponse>>;
     evaluate(request: EvaluateRulesRequest): Promise<StandardResponse<EvaluateRulesResponse>>;
+    populationSchema(consumer?: string): Promise<StandardResponse<SegmentSchemaResponse>>;
+    populationTableSchema(table: string, consumer?: string): Promise<StandardResponse<SegmentTableSchemaResponse>>;
+    populationCompile(request: PopulationCompileRequest): Promise<StandardResponse<PopulationCompileResponse>>;
+    populationTestStart(request: PopulationTestRequest): Promise<StandardResponse<PopulationTestResponse>>;
+    populationTestGet(testId: string, consumer?: string): Promise<StandardResponse<PopulationTestResponse>>;
+    populationExecutionStart(request: PopulationExecutionRequest): Promise<StandardResponse<PopulationExecutionResponse>>;
+    populationExecutionPage(executionId: string, nextToken?: string, consumer?: string): Promise<StandardResponse<PopulationExecutionPageResponse>>;
 }

package/bin/rules-business/api/RulesApi.js

@@ -11,6 +11,13 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from "inversify";
+// P2: el gateway de rewards corta a 29 s; el central corta la prueba a 12 s. Solo dispara ante falla real.
+const POPULATION_TEST_CLIENT_TIMEOUT_MS = 20000;
+const consumerQuery = (consumer) => consumer === undefined ? "" : `consumer=${encodeURIComponent(consumer)}`;
+const withQuery = (url, ...parts) => {
+    const query = parts.filter((part) => part !== "").join("&");
+    return query === "" ? url : `${url}?${query}`;
+};
 /**
  * Contrato y semántica completos → `IRulesApi` (`StandardResponse` → leer `result.data`).
  * Env: `RULES_BUSINESS_LAMBDA_URL` (SSM `fiado-rulesbusiness-lambda`).
@@ -36,6 +43,32 @@ let RulesApi = class RulesApi {
     async evaluate(request) {
         return await this.httpRequest.post(`${this.baseUrl}/evaluate`, request);
     }
+    async populationSchema(consumer) {
+        const url = withQuery(`${this.baseUrl}/population/schema`, consumerQuery(consumer));
+        return await this.httpRequest.get(url);
+    }
+    async populationTableSchema(table, consumer) {
+        const url = withQuery(`${this.baseUrl}/population/schema/${encodeURIComponent(table)}`, consumerQuery(consumer));
+        return await this.httpRequest.get(url);
+    }
+    async populationCompile(request) {
+        return await this.httpRequest.post(`${this.baseUrl}/population/compile`, request);
+    }
+    async populationTestStart(request) {
+        return await this.httpRequest.post(`${this.baseUrl}/population/tests`, request, undefined, undefined, undefined, { timeout: POPULATION_TEST_CLIENT_TIMEOUT_MS });
+    }
+    async populationTestGet(testId, consumer) {
+        const url = withQuery(`${this.baseUrl}/population/tests/${encodeURIComponent(testId)}`, consumerQuery(consumer));
+        return await this.httpRequest.get(url);
+    }
+    async populationExecutionStart(request) {
+        return await this.httpRequest.post(`${this.baseUrl}/population/executions`, request);
+    }
+    async populationExecutionPage(executionId, nextToken, consumer) {
+        const tokenQuery = nextToken === undefined ? "" : `nextToken=${encodeURIComponent(nextToken)}`;
+        const url = withQuery(`${this.baseUrl}/population/executions/${encodeURIComponent(executionId)}`, tokenQuery, consumerQuery(consumer));
+        return await this.httpRequest.get(url);
+    }
 };
 RulesApi = __decorate([
     injectable(),

package/bin/rules-business/api/interfaces/IRulesApi.d.ts

@@ -1,5 +1,5 @@
 import type { StandardResponse } from "@fiado/gateway-adapter";
-import type { EvaluateRulesRequest, EvaluateRulesResponse, GenerateRulesRequest, GenerateRulesResponse, RulesCatalogResponse, ValidateRulesRequest, ValidateRulesResponse } from "@fiado/type-kit/bin/rules/index.js";
+import type { EvaluateRulesRequest, EvaluateRulesResponse, GenerateRulesRequest, GenerateRulesResponse, PopulationCompileRequest, PopulationCompileResponse, PopulationExecutionPageResponse, PopulationExecutionRequest, PopulationExecutionResponse, PopulationTestRequest, PopulationTestResponse, RulesCatalogResponse, SegmentSchemaResponse, SegmentTableSchemaResponse, ValidateRulesRequest, ValidateRulesResponse } from "@fiado/type-kit/bin/rules/index.js";
 /**
  * Cliente del lambda central `rules-business` (catálogo, validación, generación con IA y evaluación de reglas).
  *
@@ -15,4 +15,21 @@ export interface IRulesApi {
     generate(request: GenerateRulesRequest): Promise<StandardResponse<GenerateRulesResponse>>;
     /** POST /evaluate — evalúa reglas sobre hasta 100 sujetos por llamada (400 `TOO_MANY_SUBJECTS`). */
     evaluate(request: EvaluateRulesRequest): Promise<StandardResponse<EvaluateRulesResponse>>;
+    /** GET /population/schema — tablas del datalake disponibles para segmentar población. */
+    populationSchema(consumer?: string): Promise<StandardResponse<SegmentSchemaResponse>>;
+    /** GET /population/schema/{table} — columnas de una tabla del datalake. */
+    populationTableSchema(table: string, consumer?: string): Promise<StandardResponse<SegmentTableSchemaResponse>>;
+    /** POST /population/compile — compila una `definition` a SQL parametrizado (no ejecuta nada). */
+    populationCompile(request: PopulationCompileRequest): Promise<StandardResponse<PopulationCompileResponse>>;
+    /**
+     * POST /population/tests — prueba sin estado. El central corta a 12 s y responde RUNNING + `testId`;
+     * el cliente usa un timeout explícito de 20000 ms (solo dispara ante falla real → 503).
+     */
+    populationTestStart(request: PopulationTestRequest): Promise<StandardResponse<PopulationTestResponse>>;
+    /** GET /population/tests/{testId} — sondeo de una prueba iniciada. */
+    populationTestGet(testId: string, consumer?: string): Promise<StandardResponse<PopulationTestResponse>>;
+    /** POST /population/executions — inicia la ejecución de una población. */
+    populationExecutionStart(request: PopulationExecutionRequest): Promise<StandardResponse<PopulationExecutionResponse>>;
+    /** GET /population/executions/{id} — página (≤1000 ids) de una ejecución; `nextToken` para continuar. */
+    populationExecutionPage(executionId: string, nextToken?: string, consumer?: string): Promise<StandardResponse<PopulationExecutionPageResponse>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.129.0",
+  "version": "5.131.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.540.0",
+    "@fiado/type-kit": "^3.541.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/loanCredit/api/dtos/CreditLifecycleFact.ts

@@ -13,6 +13,8 @@ export enum CreditLifecycleFactEnum {
     DEVICE_UNLOCKED = "DEVICE_UNLOCKED",
     /** Bienvenida al cerrar la venta. Solo la pista de crédito: la de contado no tiene `creditId`. */
     APP_WELCOME = "APP_WELCOME",
+    /** La venta se canceló y su crédito quedó descartado. Solo tras un descarte exitoso. */
+    SALE_CANCELLED_CREDIT_DISCARDED = "SALE_CANCELLED_CREDIT_DISCARDED",
 }
 
 /** Body de `POST /private/credits/{creditId}/lifecycle-facts`. */

package/src/rules-business/api/RulesApi.ts

@@ -6,12 +6,32 @@ import type {
     EvaluateRulesResponse,
     GenerateRulesRequest,
     GenerateRulesResponse,
+    PopulationCompileRequest,
+    PopulationCompileResponse,
+    PopulationExecutionPageResponse,
+    PopulationExecutionRequest,
+    PopulationExecutionResponse,
+    PopulationTestRequest,
+    PopulationTestResponse,
     RulesCatalogResponse,
+    SegmentSchemaResponse,
+    SegmentTableSchemaResponse,
     ValidateRulesRequest,
     ValidateRulesResponse,
 } from "@fiado/type-kit/bin/rules/index.js";
 import type { IRulesApi } from "./interfaces/IRulesApi.js";
 
+// P2: el gateway de rewards corta a 29 s; el central corta la prueba a 12 s. Solo dispara ante falla real.
+const POPULATION_TEST_CLIENT_TIMEOUT_MS = 20000;
+
+const consumerQuery = (consumer?: string): string =>
+    consumer === undefined ? "" : `consumer=${encodeURIComponent(consumer)}`;
+
+const withQuery = (url: string, ...parts: string[]): string => {
+    const query = parts.filter((part) => part !== "").join("&");
+    return query === "" ? url : `${url}?${query}`;
+};
+
 /**
  * Contrato y semántica completos → `IRulesApi` (`StandardResponse` → leer `result.data`).
  * Env: `RULES_BUSINESS_LAMBDA_URL` (SSM `fiado-rulesbusiness-lambda`).
@@ -41,4 +61,44 @@ export class RulesApi implements IRulesApi {
     async evaluate(request: EvaluateRulesRequest): Promise<StandardResponse<EvaluateRulesResponse>> {
         return await this.httpRequest.post<StandardResponse<EvaluateRulesResponse>>(`${this.baseUrl}/evaluate`, request);
     }
+
+    async populationSchema(consumer?: string): Promise<StandardResponse<SegmentSchemaResponse>> {
+        const url = withQuery(`${this.baseUrl}/population/schema`, consumerQuery(consumer));
+        return await this.httpRequest.get<StandardResponse<SegmentSchemaResponse>>(url);
+    }
+
+    async populationTableSchema(table: string, consumer?: string): Promise<StandardResponse<SegmentTableSchemaResponse>> {
+        const url = withQuery(`${this.baseUrl}/population/schema/${encodeURIComponent(table)}`, consumerQuery(consumer));
+        return await this.httpRequest.get<StandardResponse<SegmentTableSchemaResponse>>(url);
+    }
+
+    async populationCompile(request: PopulationCompileRequest): Promise<StandardResponse<PopulationCompileResponse>> {
+        return await this.httpRequest.post<StandardResponse<PopulationCompileResponse>>(`${this.baseUrl}/population/compile`, request);
+    }
+
+    async populationTestStart(request: PopulationTestRequest): Promise<StandardResponse<PopulationTestResponse>> {
+        return await this.httpRequest.post<StandardResponse<PopulationTestResponse>>(
+            `${this.baseUrl}/population/tests`,
+            request,
+            undefined,
+            undefined,
+            undefined,
+            { timeout: POPULATION_TEST_CLIENT_TIMEOUT_MS },
+        );
+    }
+
+    async populationTestGet(testId: string, consumer?: string): Promise<StandardResponse<PopulationTestResponse>> {
+        const url = withQuery(`${this.baseUrl}/population/tests/${encodeURIComponent(testId)}`, consumerQuery(consumer));
+        return await this.httpRequest.get<StandardResponse<PopulationTestResponse>>(url);
+    }
+
+    async populationExecutionStart(request: PopulationExecutionRequest): Promise<StandardResponse<PopulationExecutionResponse>> {
+        return await this.httpRequest.post<StandardResponse<PopulationExecutionResponse>>(`${this.baseUrl}/population/executions`, request);
+    }
+
+    async populationExecutionPage(executionId: string, nextToken?: string, consumer?: string): Promise<StandardResponse<PopulationExecutionPageResponse>> {
+        const tokenQuery = nextToken === undefined ? "" : `nextToken=${encodeURIComponent(nextToken)}`;
+        const url = withQuery(`${this.baseUrl}/population/executions/${encodeURIComponent(executionId)}`, tokenQuery, consumerQuery(consumer));
+        return await this.httpRequest.get<StandardResponse<PopulationExecutionPageResponse>>(url);
+    }
 }

package/src/rules-business/api/interfaces/IRulesApi.ts

@@ -4,7 +4,16 @@ import type {
     EvaluateRulesResponse,
     GenerateRulesRequest,
     GenerateRulesResponse,
+    PopulationCompileRequest,
+    PopulationCompileResponse,
+    PopulationExecutionPageResponse,
+    PopulationExecutionRequest,
+    PopulationExecutionResponse,
+    PopulationTestRequest,
+    PopulationTestResponse,
     RulesCatalogResponse,
+    SegmentSchemaResponse,
+    SegmentTableSchemaResponse,
     ValidateRulesRequest,
     ValidateRulesResponse,
 } from "@fiado/type-kit/bin/rules/index.js";
@@ -27,4 +36,28 @@ export interface IRulesApi {
 
     /** POST /evaluate — evalúa reglas sobre hasta 100 sujetos por llamada (400 `TOO_MANY_SUBJECTS`). */
     evaluate(request: EvaluateRulesRequest): Promise<StandardResponse<EvaluateRulesResponse>>;
+
+    /** GET /population/schema — tablas del datalake disponibles para segmentar población. */
+    populationSchema(consumer?: string): Promise<StandardResponse<SegmentSchemaResponse>>;
+
+    /** GET /population/schema/{table} — columnas de una tabla del datalake. */
+    populationTableSchema(table: string, consumer?: string): Promise<StandardResponse<SegmentTableSchemaResponse>>;
+
+    /** POST /population/compile — compila una `definition` a SQL parametrizado (no ejecuta nada). */
+    populationCompile(request: PopulationCompileRequest): Promise<StandardResponse<PopulationCompileResponse>>;
+
+    /**
+     * POST /population/tests — prueba sin estado. El central corta a 12 s y responde RUNNING + `testId`;
+     * el cliente usa un timeout explícito de 20000 ms (solo dispara ante falla real → 503).
+     */
+    populationTestStart(request: PopulationTestRequest): Promise<StandardResponse<PopulationTestResponse>>;
+
+    /** GET /population/tests/{testId} — sondeo de una prueba iniciada. */
+    populationTestGet(testId: string, consumer?: string): Promise<StandardResponse<PopulationTestResponse>>;
+
+    /** POST /population/executions — inicia la ejecución de una población. */
+    populationExecutionStart(request: PopulationExecutionRequest): Promise<StandardResponse<PopulationExecutionResponse>>;
+
+    /** GET /population/executions/{id} — página (≤1000 ids) de una ejecución; `nextToken` para continuar. */
+    populationExecutionPage(executionId: string, nextToken?: string, consumer?: string): Promise<StandardResponse<PopulationExecutionPageResponse>>;
 }