@fiado/api-invoker 5.131.0 → 5.133.0

package/bin/index.d.ts

@@ -93,6 +93,7 @@ export * from "./retailCards/index.js";
 export * from "./retailNotifications/index.js";
 export * from "./retailWizard/index.js";
 export * from "./retailPromotions/index.js";
+export * from "./loanRetailAudit/index.js";
 export * from "./retailCommission/index.js";
 export * from "./retailIntegration/index.js";
 export * from "./shortlink/index.js";

package/bin/index.js

@@ -93,6 +93,7 @@ export * from "./retailCards/index.js";
 export * from "./retailNotifications/index.js";
 export * from "./retailWizard/index.js";
 export * from "./retailPromotions/index.js";
+export * from "./loanRetailAudit/index.js";
 export * from "./retailCommission/index.js";
 export * from "./retailIntegration/index.js";
 export * from "./shortlink/index.js";

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

@@ -1,8 +1,9 @@
 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, PreviewLoanContractRequest, LoanContractPreview, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, ActivationCheckResponse, CancelLoanCreditRequest, 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 type { GetCreditOptions } from "./dtos/GetCreditOptions.js";
 import { CustomerCreditHistoryResponse } from "./dtos/CustomerCreditHistory.js";
 import { CreditLifecycleFactRequest, CreditLifecycleFactResponse } from "./dtos/CreditLifecycleFact.js";
 import { ILoanCreditBusinessApi } from "./interfaces/ILoanCreditBusinessApi.js";
@@ -30,7 +31,8 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
     settle(creditId: string, input: CreditSettledRequest, tenantId: string): Promise<StandardResponse<CreditSettledResponse>>;
     activateCheck(creditId: string, input: ActivationCheckRequest, tenantId: string): Promise<StandardResponse<ActivationCheckResponse>>;
     discard(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
-    getCredit(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
+    cancel(creditId: string, input: CancelLoanCreditRequest, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
+    getCredit(creditId: string, tenantId: string, options?: GetCreditOptions): 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>>;

package/bin/loanCredit/api/LoanCreditBusinessApi.js

@@ -67,8 +67,13 @@ let LoanCreditBusinessApi = class LoanCreditBusinessApi {
         const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/discard?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, {});
     }
-    async getCredit(creditId, tenantId) {
-        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}?tenantId=${encodeURIComponent(tenantId)}`;
+    async cancel(creditId, input, tenantId) {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/cancel?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+    async getCredit(creditId, tenantId, options = {}) {
+        const include = options.includePaymentEvidence ? "&include=paymentEvidence" : "";
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}?tenantId=${encodeURIComponent(tenantId)}${include}`;
         return await this.httpRequest.get(url);
     }
     async getBorrowerByRetailCustomer(retailCustomerId, tenantId) {

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

@@ -0,0 +1,5 @@
+/** Opciones de la lectura privada del crédito. */
+export interface GetCreditOptions {
+    /** Pide `hasPayments` (`?include=paymentEvidence`); cuesta lecturas extra en loan-credit. */
+    includePaymentEvidence?: boolean;
+}

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

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

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

@@ -1,7 +1,8 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-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 { ActivationCheckRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, ActivationCheckResponse, CancelLoanCreditRequest, 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 type { GetCreditOptions } from "../dtos/GetCreditOptions.js";
 import { CustomerCreditHistoryResponse } from "../dtos/CustomerCreditHistory.js";
 import { CreditLifecycleFactRequest, CreditLifecycleFactResponse } from "../dtos/CreditLifecycleFact.js";
 /**
@@ -70,8 +71,14 @@ export interface ILoanCreditBusinessApi {
      * `404 CREDIT_NOT_FOUND`.
      */
     discard(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
-    /** Estado completo del crédito (checklist, status, términos). */
-    getCredit(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
+    /**
+     * Cancela el crédito de una venta cancelada: ACTIVE → CANCELLED (PENDING_ACTIVATION se descarta).
+     * Idempotente sobre CANCELLED. `404 CREDIT_NOT_FOUND` · `409 CREDIT_NOT_CANCELLABLE` ·
+     * `409 CREDIT_HAS_PAYMENTS` · `502 COLLECTION_DEREGISTER_FAILED`.
+     */
+    cancel(creditId: string, input: CancelLoanCreditRequest, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
+    /** Estado completo del crédito (checklist, status, términos); `hasPayments` solo si se pide. */
+    getCredit(creditId: string, tenantId: string, options?: GetCreditOptions): Promise<StandardResponse<LoanCreditResponse>>;
     /**
      * Busca el acreditado por su FK al cliente retail (lookup del wizard/scoring).
      * `404 BORROWER_NOT_FOUND` si el evento KYC aún no lo hidrató.

package/bin/loanCredit/index.d.ts

@@ -2,6 +2,7 @@ export * from "./api/dtos/CreditLifecycleFact.js";
 export * from "./api/dtos/CustomerCreditHistory.js";
 export * from "./api/dtos/CreditSummariesBatch.js";
 export * from "./api/dtos/LoanCreditAnalyticsBatch.js";
+export * from "./api/dtos/GetCreditOptions.js";
 export * from "./api/interfaces/ILoanCreditBusinessApi.js";
 export { default as LoanCreditBusinessApi } from "./api/LoanCreditBusinessApi.js";
 export * from "./api/interfaces/ILoanCreditDeviceApi.js";

package/bin/loanCredit/index.js

@@ -2,6 +2,7 @@ export * from "./api/dtos/CreditLifecycleFact.js";
 export * from "./api/dtos/CustomerCreditHistory.js";
 export * from "./api/dtos/CreditSummariesBatch.js";
 export * from "./api/dtos/LoanCreditAnalyticsBatch.js";
+export * from "./api/dtos/GetCreditOptions.js";
 export * from "./api/interfaces/ILoanCreditBusinessApi.js";
 export { default as LoanCreditBusinessApi } from "./api/LoanCreditBusinessApi.js";
 export * from "./api/interfaces/ILoanCreditDeviceApi.js";

package/bin/loanRetailAudit/api/LoanRetailAuditBusinessApi.d.ts

@@ -0,0 +1,12 @@
+import type { IHttpRequest } from "@fiado/http-client";
+import { StandardResponse } from "@fiado/gateway-adapter";
+import type { CreatePiiAccessLogRequest, CreatePiiAccessLogResponse, ListAuditTrailQuery, ListAuditTrailResponse } from "@fiado/type-kit/bin/loanRetailAudit/index.js";
+import { ILoanRetailAuditBusinessApi } from "./interfaces/ILoanRetailAuditBusinessApi.js";
+/** Publisher HTTP de los privados de `loan-retail-audit-business`. Contrato -> `ILoanRetailAuditBusinessApi`. */
+export default class LoanRetailAuditBusinessApi implements ILoanRetailAuditBusinessApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    createPiiAccessLog(request: CreatePiiAccessLogRequest, tenantId: string): Promise<StandardResponse<CreatePiiAccessLogResponse>>;
+    listAuditTrail(query: ListAuditTrailQuery, tenantId: string): Promise<StandardResponse<ListAuditTrailResponse>>;
+}

package/bin/loanRetailAudit/api/LoanRetailAuditBusinessApi.js

@@ -0,0 +1,44 @@
+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 los privados de `loan-retail-audit-business`. Contrato -> `ILoanRetailAuditBusinessApi`. */
+let LoanRetailAuditBusinessApi = class LoanRetailAuditBusinessApi {
+    httpRequest;
+    // El buildspec publica la URL en SSM con "/" final; se normaliza para no armar "//private".
+    baseUrl = (process.env.LOAN_RETAIL_AUDIT_BUSINESS_URL || "").replace(/\/+$/, "");
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async createPiiAccessLog(request, tenantId) {
+        const query = new URLSearchParams({ tenantId });
+        const url = `${this.baseUrl}/private/pii-access-logs?${query.toString()}`;
+        // Firma de http-client: post(url, data, headers, basicAuth, enableTimeout).
+        return await this.httpRequest.post(url, request, {}, undefined, true);
+    }
+    async listAuditTrail(query, tenantId) {
+        const params = new URLSearchParams({ tenantId, entityType: query.entityType, entityId: query.entityId });
+        if (query.order)
+            params.set("order", query.order);
+        if (query.limit !== undefined)
+            params.set("limit", String(query.limit));
+        if (query.nextToken)
+            params.set("nextToken", query.nextToken);
+        return await this.httpRequest.get(`${this.baseUrl}/private/audit-trail?${params.toString()}`);
+    }
+};
+LoanRetailAuditBusinessApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], LoanRetailAuditBusinessApi);
+export default LoanRetailAuditBusinessApi;

package/bin/loanRetailAudit/api/interfaces/ILoanRetailAuditBusinessApi.d.ts

@@ -0,0 +1,14 @@
+import { StandardResponse } from "@fiado/gateway-adapter";
+import type { CreatePiiAccessLogRequest, CreatePiiAccessLogResponse, ListAuditTrailQuery, ListAuditTrailResponse } from "@fiado/type-kit/bin/loanRetailAudit/index.js";
+export interface ILoanRetailAuditBusinessApi {
+    /**
+     * `POST /private/pii-access-logs`: registra un acceso a PII. Lleva timeout; si el central no
+     * responde, rechaza y el caller falla cerrado. El mismo `accessId` en un reintento no duplica.
+     */
+    createPiiAccessLog(request: CreatePiiAccessLogRequest, tenantId: string): Promise<StandardResponse<CreatePiiAccessLogResponse>>;
+    /**
+     * `GET /private/audit-trail`: una página de la bitácora de una entidad (`order` default `desc`).
+     * `nextToken` es opaco y viaja tal cual; `null` en la respuesta = última página.
+     */
+    listAuditTrail(query: ListAuditTrailQuery, tenantId: string): Promise<StandardResponse<ListAuditTrailResponse>>;
+}

package/bin/loanRetailAudit/api/interfaces/ILoanRetailAuditBusinessApi.js

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

package/bin/loanRetailAudit/index.d.ts

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

package/bin/loanRetailAudit/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.131.0",
+  "version": "5.133.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.541.0",
+    "@fiado/type-kit": "^3.550.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/index.ts

@@ -93,6 +93,7 @@ export * from "./retailCards/index.js";
 export * from "./retailNotifications/index.js";
 export * from "./retailWizard/index.js";
 export * from "./retailPromotions/index.js";
+export * from "./loanRetailAudit/index.js";
 export * from "./retailCommission/index.js";
 export * from "./retailIntegration/index.js";
 export * from "./shortlink/index.js";

package/src/loanCredit/api/LoanCreditBusinessApi.ts

@@ -4,6 +4,7 @@ import { StandardResponse } from "@fiado/gateway-adapter";
 import {
     ActivationCheckRequest,
     ActivationCheckResponse,
+    CancelLoanCreditRequest,
     CreditPaymentAppliedRequest,
     CreditPaymentAppliedResponse,
     CreditSettledRequest,
@@ -40,6 +41,7 @@ import {
     LoanCreditAnalyticsBatchRequest,
     LoanCreditAnalyticsBatchResponse,
 } from "./dtos/LoanCreditAnalyticsBatch.js";
+import type { GetCreditOptions } from "./dtos/GetCreditOptions.js";
 import { CustomerCreditHistoryResponse } from "./dtos/CustomerCreditHistory.js";
 import {
     CreditLifecycleFactRequest,
@@ -142,11 +144,22 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
         return await this.httpRequest.post(url, {});
     }
 
+    async cancel(
+        creditId: string,
+        input: CancelLoanCreditRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCreditResponse>> {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/cancel?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
     async getCredit(
         creditId: string,
         tenantId: string,
+        options: GetCreditOptions = {},
     ): Promise<StandardResponse<LoanCreditResponse>> {
-        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}?tenantId=${encodeURIComponent(tenantId)}`;
+        const include = options.includePaymentEvidence ? "&include=paymentEvidence" : "";
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}?tenantId=${encodeURIComponent(tenantId)}${include}`;
         return await this.httpRequest.get(url);
     }
 

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

@@ -0,0 +1,5 @@
+/** Opciones de la lectura privada del crédito. */
+export interface GetCreditOptions {
+    /** Pide `hasPayments` (`?include=paymentEvidence`); cuesta lecturas extra en loan-credit. */
+    includePaymentEvidence?: boolean;
+}

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

@@ -6,6 +6,7 @@ import {
     CreditSettledRequest,
     CreditSettledResponse,
     ActivationCheckResponse,
+    CancelLoanCreditRequest,
     LoanBorrowerResponse,
     ListMessagingCandidatesRequest,
     ListMessagingCandidatesResponse,
@@ -38,6 +39,7 @@ import {
     LoanCreditAnalyticsBatchRequest,
     LoanCreditAnalyticsBatchResponse,
 } from "../dtos/LoanCreditAnalyticsBatch.js";
+import type { GetCreditOptions } from "../dtos/GetCreditOptions.js";
 import { CustomerCreditHistoryResponse } from "../dtos/CustomerCreditHistory.js";
 import {
     CreditLifecycleFactRequest,
@@ -148,10 +150,22 @@ export interface ILoanCreditBusinessApi {
         tenantId: string,
     ): Promise<StandardResponse<LoanCreditResponse>>;
 
-    /** Estado completo del crédito (checklist, status, términos). */
+    /**
+     * Cancela el crédito de una venta cancelada: ACTIVE → CANCELLED (PENDING_ACTIVATION se descarta).
+     * Idempotente sobre CANCELLED. `404 CREDIT_NOT_FOUND` · `409 CREDIT_NOT_CANCELLABLE` ·
+     * `409 CREDIT_HAS_PAYMENTS` · `502 COLLECTION_DEREGISTER_FAILED`.
+     */
+    cancel(
+        creditId: string,
+        input: CancelLoanCreditRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCreditResponse>>;
+
+    /** Estado completo del crédito (checklist, status, términos); `hasPayments` solo si se pide. */
     getCredit(
         creditId: string,
         tenantId: string,
+        options?: GetCreditOptions,
     ): Promise<StandardResponse<LoanCreditResponse>>;
 
     /**

package/src/loanCredit/index.ts

@@ -2,6 +2,7 @@ export * from "./api/dtos/CreditLifecycleFact.js";
 export * from "./api/dtos/CustomerCreditHistory.js";
 export * from "./api/dtos/CreditSummariesBatch.js";
 export * from "./api/dtos/LoanCreditAnalyticsBatch.js";
+export * from "./api/dtos/GetCreditOptions.js";
 export * from "./api/interfaces/ILoanCreditBusinessApi.js";
 export { default as LoanCreditBusinessApi } from "./api/LoanCreditBusinessApi.js";
 

package/src/loanRetailAudit/api/LoanRetailAuditBusinessApi.ts

@@ -0,0 +1,40 @@
+import { inject, injectable } from "inversify";
+import type { IHttpRequest } from "@fiado/http-client";
+import { StandardResponse } from "@fiado/gateway-adapter";
+import type {
+    CreatePiiAccessLogRequest,
+    CreatePiiAccessLogResponse,
+    ListAuditTrailQuery,
+    ListAuditTrailResponse,
+} from "@fiado/type-kit/bin/loanRetailAudit/index.js";
+import { ILoanRetailAuditBusinessApi } from "./interfaces/ILoanRetailAuditBusinessApi.js";
+
+/** Publisher HTTP de los privados de `loan-retail-audit-business`. Contrato -> `ILoanRetailAuditBusinessApi`. */
+@injectable()
+export default class LoanRetailAuditBusinessApi implements ILoanRetailAuditBusinessApi {
+    // El buildspec publica la URL en SSM con "/" final; se normaliza para no armar "//private".
+    private readonly baseUrl = (process.env.LOAN_RETAIL_AUDIT_BUSINESS_URL || "").replace(/\/+$/, "");
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async createPiiAccessLog(
+        request: CreatePiiAccessLogRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<CreatePiiAccessLogResponse>> {
+        const query = new URLSearchParams({ tenantId });
+        const url = `${this.baseUrl}/private/pii-access-logs?${query.toString()}`;
+        // Firma de http-client: post(url, data, headers, basicAuth, enableTimeout).
+        return await this.httpRequest.post(url, request, {}, undefined, true);
+    }
+
+    async listAuditTrail(
+        query: ListAuditTrailQuery,
+        tenantId: string,
+    ): Promise<StandardResponse<ListAuditTrailResponse>> {
+        const params = new URLSearchParams({ tenantId, entityType: query.entityType, entityId: query.entityId });
+        if (query.order) params.set("order", query.order);
+        if (query.limit !== undefined) params.set("limit", String(query.limit));
+        if (query.nextToken) params.set("nextToken", query.nextToken);
+        return await this.httpRequest.get(`${this.baseUrl}/private/audit-trail?${params.toString()}`);
+    }
+}

package/src/loanRetailAudit/api/interfaces/ILoanRetailAuditBusinessApi.ts

@@ -0,0 +1,29 @@
+import { StandardResponse } from "@fiado/gateway-adapter";
+import type {
+    CreatePiiAccessLogRequest,
+    CreatePiiAccessLogResponse,
+    ListAuditTrailQuery,
+    ListAuditTrailResponse,
+} from "@fiado/type-kit/bin/loanRetailAudit/index.js";
+
+// Contrato de los privados de `loan-retail-audit-business`; el caller manda `tenantId` por query.
+// El consumer necesita `LOAN_RETAIL_AUDIT_BUSINESS_URL` = `{{resolve:ssm:loan-retail-audit-business}}`.
+export interface ILoanRetailAuditBusinessApi {
+    /**
+     * `POST /private/pii-access-logs`: registra un acceso a PII. Lleva timeout; si el central no
+     * responde, rechaza y el caller falla cerrado. El mismo `accessId` en un reintento no duplica.
+     */
+    createPiiAccessLog(
+        request: CreatePiiAccessLogRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<CreatePiiAccessLogResponse>>;
+
+    /**
+     * `GET /private/audit-trail`: una página de la bitácora de una entidad (`order` default `desc`).
+     * `nextToken` es opaco y viaja tal cual; `null` en la respuesta = última página.
+     */
+    listAuditTrail(
+        query: ListAuditTrailQuery,
+        tenantId: string,
+    ): Promise<StandardResponse<ListAuditTrailResponse>>;
+}

package/src/loanRetailAudit/index.ts

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