@fiado/api-invoker 5.70.0 → 5.72.0

package/bin/container.config.js

@@ -122,6 +122,8 @@ import { WalletFundingSettlementApi } from "./walletFundingSettlement/index.js";
 import { WalletFundingRulesApi } from "./wallet-funding-rules/index.js";
 // SNS/SES connector — envío SMS/MAIL síncrono (restaurado para RBAC — DEC-002 messages-business)
 import { SnsSesConnectorApi } from "./sns-ses-connector/index.js";
+// Twilio connector — envío WhatsApp/SMS por Twilio (lee TWILIO_CONNECTOR_LAMBDA_URL)
+import { TwilioConnectorApi } from "./twilio-connector/index.js";
 // Remittance business — pricingResolve (Dashboard Ops Fase B, puente de resolución de precio en send-time)
 import { RemittanceBusinessApi } from "./remittance-business/index.js";
 import { BeneficiaryApi } from "./beneficiary/index.js";
@@ -269,6 +271,9 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("IWalletFundingRulesApi").to(WalletFundingRulesApi);
     // SNS/SES connector — envío SMS/MAIL síncrono (restaurado para RBAC — DEC-002 messages-business)
     bind("ISnsSesConnectorApi").to(SnsSesConnectorApi);
+    // Twilio connector — envío WhatsApp/SMS por Twilio, elegido por el `provider` del senderConfig.
+    // El consumidor necesita TWILIO_CONNECTOR_LAMBDA_URL desde el SSM `fiado-twilio-connector`.
+    bind("ITwilioConnectorApi").to(TwilioConnectorApi);
     // Remittance business — pricingResolve (Dashboard Ops Fase B, puente de resolución de precio en send-time)
     bind("IRemittanceBusinessApi").to(RemittanceBusinessApi);
     // Borrado en cascada del directorio — deleteByDirectoryId por dominio

package/bin/index.d.ts

@@ -103,6 +103,7 @@ export * from "./uniteller-connector/index.js";
 export * from "./walletFundingSettlement/index.js";
 export * from "./wallet-funding-rules/index.js";
 export * from "./sns-ses-connector/index.js";
+export * from "./twilio-connector/index.js";
 export * from "./remittance-business/index.js";
 export * from "./modelias-connector/index.js";
 export * from "./beneficiary/index.js";

package/bin/index.js

@@ -103,6 +103,7 @@ export * from "./uniteller-connector/index.js";
 export * from "./walletFundingSettlement/index.js";
 export * from "./wallet-funding-rules/index.js";
 export * from "./sns-ses-connector/index.js";
+export * from "./twilio-connector/index.js";
 export * from "./remittance-business/index.js";
 export * from "./modelias-connector/index.js";
 export * from "./beneficiary/index.js";

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, LoanBorrowerResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, ActivationCheckResponse, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, 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";
@@ -23,6 +23,8 @@ 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>>;
+    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>>;
     discard(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
     getCredit(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;

package/bin/loanCredit/api/LoanCreditBusinessApi.js

@@ -42,6 +42,14 @@ let LoanCreditBusinessApi = class LoanCreditBusinessApi {
         const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/sign?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);
+    }
+    async settle(creditId, input, tenantId) {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/settled?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
     async activateCheck(creditId, input, tenantId) {
         const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/activate-check?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, ActivationCheckResponse, LoanBorrowerResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, 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";
 /**
@@ -43,6 +43,18 @@ export interface ILoanCreditBusinessApi {
      * `imeiEnrolled`/`lockVerified` (paso 09, dispara el MDM vía abstracción). Con las 4 en `true`
      * el crédito pasa a `ACTIVE` (vencimientos +7d, ventana de cancelación 7d).
      */
+    /**
+     * Pago aplicado: cura la mora del crédito y suelta el equipo si el candado era el de la mora.
+     * El body es opcional. Un candado por fraude o manual NO se suelta pagando, y un pago que no
+     * alcanza el umbral escalonado deja el equipo bloqueado — el `unlockDecision` dice cuál fue.
+     */
+    applyPayment(creditId: string, input: CreditPaymentAppliedRequest, tenantId: string): Promise<StandardResponse<CreditPaymentAppliedResponse>>;
+    /**
+     * Liquidación: VERIFICA que el crédito no deba nada, lo pasa a `SETTLED` y libera el equipo.
+     * No le cree al caller — un plan incompleto o una cuota viva lo rechazan. La liberación es
+     * IRREVERSIBLE: el equipo sale del enrolamiento, no queda desbloqueado.
+     */
+    settle(creditId: string, input: CreditSettledRequest, tenantId: string): Promise<StandardResponse<CreditSettledResponse>>;
     activateCheck(creditId: string, input: ActivationCheckRequest, tenantId: string): Promise<StandardResponse<ActivationCheckResponse>>;
     /**
      * Descarta un crédito PENDING_ACTIVATION → DISCARDED (compensación del wizard al cancelar la

package/bin/sns-ses-connector/api/SnsSesConnectorApi.js

@@ -11,6 +11,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from 'inversify';
+import { joinUrl } from '../../utils/joinUrl.js';
 let SnsSesConnectorApi = class SnsSesConnectorApi {
     httpRequest;
     baseUrl = process.env.SNS_SES_CONNECTOR_LAMBDA_URL || '';
@@ -18,7 +19,7 @@ let SnsSesConnectorApi = class SnsSesConnectorApi {
         this.httpRequest = httpRequest;
     }
     async send(request) {
-        const url = `${this.baseUrl}send`;
+        const url = joinUrl(this.baseUrl, 'send');
         return await this.httpRequest.post(url, request, { 'operationName': 'privateSend' });
     }
 };

package/bin/twilio-connector/api/TwilioConnectorApi.d.ts

@@ -1,4 +1,4 @@
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { ConnectorSendMessageRequest, ConnectorSendMessageResponse } from "@fiado/type-kit/bin/twilioConnector/index.js";
 import { ITwilioConnectorApi } from "./interfaces/ITwilioConnectorApi.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;

package/bin/twilio-connector/api/TwilioConnectorApi.js

@@ -11,6 +11,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from "inversify";
+import { joinUrl } from "../../utils/joinUrl.js";
 let TwilioConnectorApi = class TwilioConnectorApi {
     httpRequest;
     baseUrl = process.env.TWILIO_CONNECTOR_LAMBDA_URL || "";
@@ -18,7 +19,7 @@ let TwilioConnectorApi = class TwilioConnectorApi {
         this.httpRequest = httpRequest;
     }
     async send(request) {
-        const url = `${this.baseUrl}/messages/send`;
+        const url = joinUrl(this.baseUrl, "messages/send");
         return await this.httpRequest.post(url, request, { operationName: "privateSendMessage" });
     }
 };

package/bin/utils/joinUrl.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Une la URL base de un lambda con un path relativo dejando exactamente una barra
+ * entre ambos, venga o no la base con barra final desde SSM.
+ */
+export declare function joinUrl(baseUrl: string, path: string): string;

package/bin/utils/joinUrl.js

@@ -0,0 +1,9 @@
+/**
+ * Une la URL base de un lambda con un path relativo dejando exactamente una barra
+ * entre ambos, venga o no la base con barra final desde SSM.
+ */
+export function joinUrl(baseUrl, path) {
+    const base = baseUrl.replace(/\/+$/, '');
+    const relativePath = path.replace(/^\/+/, '');
+    return `${base}/${relativePath}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.70.0",
+  "version": "5.72.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/container.config.ts

@@ -187,6 +187,8 @@ import { IWalletFundingSettlementApi, WalletFundingSettlementApi } from "./walle
 import { IWalletFundingRulesApi, WalletFundingRulesApi } from "./wallet-funding-rules/index.js";
 // SNS/SES connector — envío SMS/MAIL síncrono (restaurado para RBAC — DEC-002 messages-business)
 import { ISnsSesConnectorApi, SnsSesConnectorApi } from "./sns-ses-connector/index.js";
+// Twilio connector — envío WhatsApp/SMS por Twilio (lee TWILIO_CONNECTOR_LAMBDA_URL)
+import { ITwilioConnectorApi, TwilioConnectorApi } from "./twilio-connector/index.js";
 // Remittance business — pricingResolve (Dashboard Ops Fase B, puente de resolución de precio en send-time)
 import { IRemittanceBusinessApi, RemittanceBusinessApi } from "./remittance-business/index.js";
 import { IBeneficiaryApi, BeneficiaryApi } from "./beneficiary/index.js";
@@ -360,6 +362,10 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // SNS/SES connector — envío SMS/MAIL síncrono (restaurado para RBAC — DEC-002 messages-business)
     bind<ISnsSesConnectorApi>("ISnsSesConnectorApi").to(SnsSesConnectorApi);
 
+    // Twilio connector — envío WhatsApp/SMS por Twilio, elegido por el `provider` del senderConfig.
+    // El consumidor necesita TWILIO_CONNECTOR_LAMBDA_URL desde el SSM `fiado-twilio-connector`.
+    bind<ITwilioConnectorApi>("ITwilioConnectorApi").to(TwilioConnectorApi);
+
     // Remittance business — pricingResolve (Dashboard Ops Fase B, puente de resolución de precio en send-time)
     bind<IRemittanceBusinessApi>("IRemittanceBusinessApi").to(RemittanceBusinessApi);
 

package/src/index.ts

@@ -103,6 +103,7 @@ export * from "./uniteller-connector/index.js";
 export * from "./walletFundingSettlement/index.js";
 export * from "./wallet-funding-rules/index.js";
 export * from "./sns-ses-connector/index.js";
+export * from "./twilio-connector/index.js";
 export * from "./remittance-business/index.js";
 export * from "./modelias-connector/index.js";
 export * from "./beneficiary/index.js";

package/src/loanCredit/api/LoanCreditBusinessApi.ts

@@ -4,6 +4,10 @@ import { StandardResponse } from "@fiado/gateway-adapter";
 import {
     ActivationCheckRequest,
     ActivationCheckResponse,
+    CreditPaymentAppliedRequest,
+    CreditPaymentAppliedResponse,
+    CreditSettledRequest,
+    CreditSettledResponse,
     LoanBorrowerResponse,
     LoanCreditResponse,
     OriginateLoanCreditRequest,
@@ -66,6 +70,24 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
         return await this.httpRequest.post(url, input);
     }
 
+    async applyPayment(
+        creditId: string,
+        input: CreditPaymentAppliedRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<CreditPaymentAppliedResponse>> {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/payment-applied?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
+    async settle(
+        creditId: string,
+        input: CreditSettledRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<CreditSettledResponse>> {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/settled?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
     async activateCheck(
         creditId: string,
         input: ActivationCheckRequest,

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

@@ -1,6 +1,10 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import {
     ActivationCheckRequest,
+    CreditPaymentAppliedRequest,
+    CreditPaymentAppliedResponse,
+    CreditSettledRequest,
+    CreditSettledResponse,
     ActivationCheckResponse,
     LoanBorrowerResponse,
     LoanCreditResponse,
@@ -73,6 +77,28 @@ export interface ILoanCreditBusinessApi {
      * `imeiEnrolled`/`lockVerified` (paso 09, dispara el MDM vía abstracción). Con las 4 en `true`
      * el crédito pasa a `ACTIVE` (vencimientos +7d, ventana de cancelación 7d).
      */
+    /**
+     * Pago aplicado: cura la mora del crédito y suelta el equipo si el candado era el de la mora.
+     * El body es opcional. Un candado por fraude o manual NO se suelta pagando, y un pago que no
+     * alcanza el umbral escalonado deja el equipo bloqueado — el `unlockDecision` dice cuál fue.
+     */
+    applyPayment(
+        creditId: string,
+        input: CreditPaymentAppliedRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<CreditPaymentAppliedResponse>>;
+
+    /**
+     * Liquidación: VERIFICA que el crédito no deba nada, lo pasa a `SETTLED` y libera el equipo.
+     * No le cree al caller — un plan incompleto o una cuota viva lo rechazan. La liberación es
+     * IRREVERSIBLE: el equipo sale del enrolamiento, no queda desbloqueado.
+     */
+    settle(
+        creditId: string,
+        input: CreditSettledRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<CreditSettledResponse>>;
+
     activateCheck(
         creditId: string,
         input: ActivationCheckRequest,

package/src/sns-ses-connector/api/SnsSesConnectorApi.ts

@@ -2,6 +2,7 @@ import { inject, injectable } from 'inversify';
 import type { IHttpRequest } from '@fiado/http-client';
 import { MessageDeliveryRequest, MessageDeliveryResponse } from '@fiado/type-kit/bin/messaging/index.js';
 import { ISnsSesConnectorApi } from './interfaces/ISnsSesConnectorApi.js';
+import { joinUrl } from '../../utils/joinUrl.js';
 
 type FiadoApiResponse<T> = import('@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js').default<T>;
 
@@ -12,7 +13,7 @@ export class SnsSesConnectorApi implements ISnsSesConnectorApi {
     constructor(@inject('IHttpRequest') private readonly httpRequest: IHttpRequest) {}
 
     async send(request: MessageDeliveryRequest): Promise<FiadoApiResponse<MessageDeliveryResponse>> {
-        const url = `${this.baseUrl}send`;
+        const url = joinUrl(this.baseUrl, 'send');
         return await this.httpRequest.post(url, request, { 'operationName': 'privateSend' });
     }
 }

package/src/twilio-connector/api/TwilioConnectorApi.ts

@@ -1,7 +1,8 @@
 import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { ConnectorSendMessageRequest, ConnectorSendMessageResponse } from "@fiado/type-kit/bin/twilioConnector/index.js";
 import { ITwilioConnectorApi } from "./interfaces/ITwilioConnectorApi.js";
+import { joinUrl } from "../../utils/joinUrl.js";
 
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 
@@ -12,7 +13,7 @@ export default class TwilioConnectorApi implements ITwilioConnectorApi {
     constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
 
     async send(request: ConnectorSendMessageRequest): Promise<FiadoApiResponse<ConnectorSendMessageResponse>> {
-        const url = `${this.baseUrl}/messages/send`;
+        const url = joinUrl(this.baseUrl, "messages/send");
         return await this.httpRequest.post(url, request, { operationName: "privateSendMessage" });
     }
 }

package/src/utils/joinUrl.ts

@@ -0,0 +1,9 @@
+/**
+ * Une la URL base de un lambda con un path relativo dejando exactamente una barra
+ * entre ambos, venga o no la base con barra final desde SSM.
+ */
+export function joinUrl(baseUrl: string, path: string): string {
+    const base = baseUrl.replace(/\/+$/, '');
+    const relativePath = path.replace(/^\/+/, '');
+    return `${base}/${relativePath}`;
+}