@fiado/api-invoker 5.123.0 → 5.125.0

package/bin/loanCredit/api/LoanCreditBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ActivationCheckRequest, ActivationCheckResponse, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, ActivationCheckResponse, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, PreviewLoanContractRequest, LoanContractPreview, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { CreditSummariesBatchRequest, CreditSummariesBatchResponse } from "./dtos/CreditSummariesBatch.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "./dtos/LoanCreditAnalyticsBatch.js";
 import { CustomerCreditHistoryResponse } from "./dtos/CustomerCreditHistory.js";
@@ -25,6 +25,7 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
     originate(input: OriginateLoanCreditRequest, tenantId: string): Promise<StandardResponse<OriginateLoanCreditResponse>>;
     quote(creditId: string, input: QuoteLoanCreditRequest, tenantId: string): Promise<StandardResponse<QuoteLoanCreditResponse>>;
     sign(creditId: string, input: SignLoanCreditRequest, tenantId: string): Promise<StandardResponse<SignLoanCreditResponse>>;
+    previewContract(creditId: string, input: PreviewLoanContractRequest, tenantId: string): Promise<StandardResponse<LoanContractPreview>>;
     applyPayment(creditId: string, input: CreditPaymentAppliedRequest, tenantId: string): Promise<StandardResponse<CreditPaymentAppliedResponse>>;
     settle(creditId: string, input: CreditSettledRequest, tenantId: string): Promise<StandardResponse<CreditSettledResponse>>;
     activateCheck(creditId: string, input: ActivationCheckRequest, tenantId: string): Promise<StandardResponse<ActivationCheckResponse>>;

package/bin/loanCredit/api/LoanCreditBusinessApi.js

@@ -47,6 +47,10 @@ let LoanCreditBusinessApi = class LoanCreditBusinessApi {
         const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/sign?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);
     }
+    async previewContract(creditId, input, tenantId) {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/contract/preview?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
     async applyPayment(creditId, input, tenantId) {
         const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/payment-applied?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);

package/bin/loanCredit/api/interfaces/ILoanCreditBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ActivationCheckRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, ActivationCheckResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, ActivationCheckResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, PreviewLoanContractRequest, LoanContractPreview, SignLoanCreditResponse, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { CreditSummariesBatchRequest, CreditSummariesBatchResponse } from "../dtos/CreditSummariesBatch.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "../dtos/LoanCreditAnalyticsBatch.js";
 import { CustomerCreditHistoryResponse } from "../dtos/CustomerCreditHistory.js";
@@ -40,6 +40,11 @@ export interface ILoanCreditBusinessApi {
      * `activationChecklist.contractSigned = true`).
      */
     sign(creditId: string, input: SignLoanCreditRequest, tenantId: string): Promise<StandardResponse<SignLoanCreditResponse>>;
+    /**
+     * Paso 08 — vista previa del contrato antes de enviar el código de firma: mismo contenido que el
+     * contrato que se firmará, sin iniciar la firma ni guardar evidencia. Devuelve un enlace temporal.
+     */
+    previewContract(creditId: string, input: PreviewLoanContractRequest, tenantId: string): Promise<StandardResponse<LoanContractPreview>>;
     /**
      * Marca condiciones del checklist de activación (M2 §5): `downPayment` (paso 07),
      * `imeiEnrolled`/`lockVerified` (paso 09, dispara el MDM vía abstracción). Con las 4 en `true`

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.125.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.533.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/loanCredit/api/LoanCreditBusinessApi.ts

@@ -18,6 +18,8 @@ import {
     QuoteLoanCreditResponse,
     SignLoanCreditRequest,
     SignLoanCreditResponse,
+    PreviewLoanContractRequest,
+    LoanContractPreview,
     UpdateLoanBorrowerSciRequest,
     UpsertLoanBorrowerRequest,
     LoanBorrowerCreditItem,
@@ -96,6 +98,15 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
         return await this.httpRequest.post(url, input);
     }
 
+    async previewContract(
+        creditId: string,
+        input: PreviewLoanContractRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanContractPreview>> {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/contract/preview?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
     async applyPayment(
         creditId: string,
         input: CreditPaymentAppliedRequest,

package/src/loanCredit/api/interfaces/ILoanCreditBusinessApi.ts

@@ -15,6 +15,8 @@ import {
     QuoteLoanCreditRequest,
     QuoteLoanCreditResponse,
     SignLoanCreditRequest,
+    PreviewLoanContractRequest,
+    LoanContractPreview,
     SignLoanCreditResponse,
     UpdateLoanBorrowerSciRequest,
     UpsertLoanBorrowerRequest,
@@ -92,6 +94,16 @@ export interface ILoanCreditBusinessApi {
         tenantId: string,
     ): Promise<StandardResponse<SignLoanCreditResponse>>;
 
+    /**
+     * Paso 08 — vista previa del contrato antes de enviar el código de firma: mismo contenido que el
+     * contrato que se firmará, sin iniciar la firma ni guardar evidencia. Devuelve un enlace temporal.
+     */
+    previewContract(
+        creditId: string,
+        input: PreviewLoanContractRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanContractPreview>>;
+
     /**
      * Marca condiciones del checklist de activación (M2 §5): `downPayment` (paso 07),
      * `imeiEnrolled`/`lockVerified` (paso 09, dispara el MDM vía abstracción). Con las 4 en `true`

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