@fiado/api-invoker 5.63.0 → 5.64.0

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

@@ -2,6 +2,7 @@ import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import { ActivationCheckRequest, ActivationCheckResponse, LoanBorrowerResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "./dtos/LoanCreditAnalyticsBatch.js";
+import { CustomerCreditHistoryResponse } from "./dtos/CustomerCreditHistory.js";
 import { ILoanCreditBusinessApi } from "./interfaces/ILoanCreditBusinessApi.js";
 /**
  * Publisher HTTP del lambda `loan-credit-business` (componente 09 SureKeep F2 — motor de crédito).
@@ -26,6 +27,7 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
     discard(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
     getCredit(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
     getBorrowerByRetailCustomer(retailCustomerId: string, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
+    getCustomerCreditHistory(retailCustomerId: string, tenantId: string): Promise<StandardResponse<CustomerCreditHistoryResponse>>;
     batchGetCreditAnalytics(input: LoanCreditAnalyticsBatchRequest, tenantId: string): Promise<StandardResponse<LoanCreditAnalyticsBatchResponse>>;
     upsertBorrower(input: UpsertLoanBorrowerRequest, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
 }

package/bin/loanCredit/api/LoanCreditBusinessApi.js

@@ -58,6 +58,10 @@ let LoanCreditBusinessApi = class LoanCreditBusinessApi {
         const url = `${this.baseUrl}/private/borrowers/by-retail-customer/${encodeURIComponent(retailCustomerId)}?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.get(url);
     }
+    async getCustomerCreditHistory(retailCustomerId, tenantId) {
+        const url = `${this.baseUrl}/private/borrowers/by-retail-customer/${encodeURIComponent(retailCustomerId)}/credit-history?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
     async batchGetCreditAnalytics(input, tenantId) {
         const url = `${this.baseUrl}/private/credits/analytics?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);

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

@@ -0,0 +1,13 @@
+/**
+ * Respuesta de `GET /private/borrowers/by-retail-customer/{retailCustomerId}/credit-history`.
+ * Historial crediticio agregado del acreditado. CERO PII — solo la FK al cliente retail y cifras.
+ */
+export interface CustomerCreditHistoryResponse {
+    retailCustomerId: string;
+    /**
+     * Peor atraso VIGENTE, en días, entre las cuotas vencidas en los últimos 180 días.
+     * `null` = el acreditado no tiene ninguna cuota fechada en la ventana (hecho ausente);
+     * `0` = tiene cuotas en la ventana y ninguna vencida impaga. NO son lo mismo.
+     */
+    delinquencyDaysLast6M: number | null;
+}

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

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

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

@@ -1,6 +1,7 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import { ActivationCheckRequest, ActivationCheckResponse, LoanBorrowerResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "../dtos/LoanCreditAnalyticsBatch.js";
+import { CustomerCreditHistoryResponse } from "../dtos/CustomerCreditHistory.js";
 /**
  * Contrato del publisher de `loan-credit-business` (componente 09 SureKeep F2 — motor de crédito
  * SOFOM, pista Loan). Endpoints PRIVADOS (VPC) consumidos por `retail-wizard-business` (pasos
@@ -57,6 +58,14 @@ export interface ILoanCreditBusinessApi {
      * `404 BORROWER_NOT_FOUND` si el evento KYC aún no lo hidrató.
      */
     getBorrowerByRetailCustomer(retailCustomerId: string, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
+    /**
+     * Historial crediticio agregado del acreditado, resuelto por su FK al cliente retail. Hoy
+     * devuelve el peor atraso VIGENTE en la ventana de 180 días — `null` cuando el acreditado no
+     * tiene ninguna cuota fechada en esa ventana, `0` cuando las tiene y ninguna está vencida
+     * impaga. Ese `null` es «hecho ausente», nunca se colapsa a `0`.
+     * `404 BORROWER_NOT_FOUND` si el evento KYC aún no hidrató al acreditado.
+     */
+    getCustomerCreditHistory(retailCustomerId: string, tenantId: string): Promise<StandardResponse<CustomerCreditHistoryResponse>>;
     /**
      * Lee créditos EN LOTE por su id y devuelve solo lo que se cuenta: el eje de riesgo congelado
      * al originar, el plan, las cifras del enganche, el estado, las fechas de originación y

package/bin/loanCredit/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./api/dtos/CustomerCreditHistory.js";
 export * from "./api/dtos/LoanCreditAnalyticsBatch.js";
 export * from "./api/interfaces/ILoanCreditBusinessApi.js";
 export { default as LoanCreditBusinessApi } from "./api/LoanCreditBusinessApi.js";

package/bin/loanCredit/index.js

@@ -1,3 +1,4 @@
+export * from "./api/dtos/CustomerCreditHistory.js";
 export * from "./api/dtos/LoanCreditAnalyticsBatch.js";
 export * from "./api/interfaces/ILoanCreditBusinessApi.js";
 export { default as LoanCreditBusinessApi } from "./api/LoanCreditBusinessApi.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.63.0",
+  "version": "5.64.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",

package/src/loanCredit/api/LoanCreditBusinessApi.ts

@@ -18,6 +18,7 @@ import {
     LoanCreditAnalyticsBatchRequest,
     LoanCreditAnalyticsBatchResponse,
 } from "./dtos/LoanCreditAnalyticsBatch.js";
+import { CustomerCreditHistoryResponse } from "./dtos/CustomerCreditHistory.js";
 import { ILoanCreditBusinessApi } from "./interfaces/ILoanCreditBusinessApi.js";
 
 /**
@@ -98,6 +99,14 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
         return await this.httpRequest.get(url);
     }
 
+    async getCustomerCreditHistory(
+        retailCustomerId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<CustomerCreditHistoryResponse>> {
+        const url = `${this.baseUrl}/private/borrowers/by-retail-customer/${encodeURIComponent(retailCustomerId)}/credit-history?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
+
     async batchGetCreditAnalytics(
         input: LoanCreditAnalyticsBatchRequest,
         tenantId: string,

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

@@ -0,0 +1,13 @@
+/**
+ * Respuesta de `GET /private/borrowers/by-retail-customer/{retailCustomerId}/credit-history`.
+ * Historial crediticio agregado del acreditado. CERO PII — solo la FK al cliente retail y cifras.
+ */
+export interface CustomerCreditHistoryResponse {
+    retailCustomerId: string;
+    /**
+     * Peor atraso VIGENTE, en días, entre las cuotas vencidas en los últimos 180 días.
+     * `null` = el acreditado no tiene ninguna cuota fechada en la ventana (hecho ausente);
+     * `0` = tiene cuotas en la ventana y ninguna vencida impaga. NO son lo mismo.
+     */
+    delinquencyDaysLast6M: number | null;
+}

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

@@ -16,6 +16,7 @@ import {
     LoanCreditAnalyticsBatchRequest,
     LoanCreditAnalyticsBatchResponse,
 } from "../dtos/LoanCreditAnalyticsBatch.js";
+import { CustomerCreditHistoryResponse } from "../dtos/CustomerCreditHistory.js";
 
 /**
  * Contrato del publisher de `loan-credit-business` (componente 09 SureKeep F2 — motor de crédito
@@ -104,6 +105,18 @@ export interface ILoanCreditBusinessApi {
         tenantId: string,
     ): Promise<StandardResponse<LoanBorrowerResponse>>;
 
+    /**
+     * Historial crediticio agregado del acreditado, resuelto por su FK al cliente retail. Hoy
+     * devuelve el peor atraso VIGENTE en la ventana de 180 días — `null` cuando el acreditado no
+     * tiene ninguna cuota fechada en esa ventana, `0` cuando las tiene y ninguna está vencida
+     * impaga. Ese `null` es «hecho ausente», nunca se colapsa a `0`.
+     * `404 BORROWER_NOT_FOUND` si el evento KYC aún no hidrató al acreditado.
+     */
+    getCustomerCreditHistory(
+        retailCustomerId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<CustomerCreditHistoryResponse>>;
+
     /**
      * Lee créditos EN LOTE por su id y devuelve solo lo que se cuenta: el eje de riesgo congelado
      * al originar, el plan, las cifras del enganche, el estado, las fechas de originación y

package/src/loanCredit/index.ts

@@ -1,3 +1,4 @@
+export * from "./api/dtos/CustomerCreditHistory.js";
 export * from "./api/dtos/LoanCreditAnalyticsBatch.js";
 export * from "./api/interfaces/ILoanCreditBusinessApi.js";
 export { default as LoanCreditBusinessApi } from "./api/LoanCreditBusinessApi.js";