@fiado/api-invoker 5.48.0 → 5.49.0

package/bin/loanOfferings/api/LoanOfferingsBusinessApi.d.ts

@@ -1,10 +1,10 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { CreditPlanResponse, FinancierResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
+import { ConsumePromotionRequest, ConsumePromotionResponse, CreditPlanResponse, FinancierResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
 import { ILoanOfferingsBusinessApi } from "./interfaces/ILoanOfferingsBusinessApi.js";
 /**
- * Publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1) para sus 4
- * endpoints privados de lectura del catálogo. Contrato y semántica completos →
+ * Publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1) para sus 5
+ * endpoints privados. Contrato y semántica completos →
  * `ILoanOfferingsBusinessApi` (tenantId obligatorio, `StandardResponse` → leer `result.data`).
  *
  * Env var requerida en el consumer: `LOAN_OFFERINGS_BUSINESS_URL`.
@@ -22,4 +22,5 @@ export default class LoanOfferingsBusinessApi implements ILoanOfferingsBusinessA
     listActivePlansForRetailer(retailerId: string, tenantId: string): Promise<StandardResponse<CreditPlanResponse[]>>;
     listActiveFinanciers(tenantId: string): Promise<StandardResponse<FinancierResponse[]>>;
     simulate(planId: string, input: SimulateCreditPlanRequest, tenantId: string): Promise<StandardResponse<SimulationResultResponse>>;
+    consumePromotion(promotionId: string, input: ConsumePromotionRequest, tenantId: string): Promise<StandardResponse<ConsumePromotionResponse>>;
 }

package/bin/loanOfferings/api/LoanOfferingsBusinessApi.js

@@ -12,8 +12,8 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { inject, injectable } from "inversify";
 /**
- * Publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1) para sus 4
- * endpoints privados de lectura del catálogo. Contrato y semántica completos →
+ * Publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1) para sus 5
+ * endpoints privados. Contrato y semántica completos →
  * `ILoanOfferingsBusinessApi` (tenantId obligatorio, `StandardResponse` → leer `result.data`).
  *
  * Env var requerida en el consumer: `LOAN_OFFERINGS_BUSINESS_URL`.
@@ -46,6 +46,10 @@ let LoanOfferingsBusinessApi = class LoanOfferingsBusinessApi {
         const url = `${this.baseUrl}/private/credit-plans/${encodeURIComponent(planId)}/simulate?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);
     }
+    async consumePromotion(promotionId, input, tenantId) {
+        const url = `${this.baseUrl}/private/promotions/${encodeURIComponent(promotionId)}/consume?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
 };
 LoanOfferingsBusinessApi = __decorate([
     injectable(),

package/bin/loanOfferings/api/interfaces/ILoanOfferingsBusinessApi.d.ts

@@ -1,8 +1,9 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { CreditPlanResponse, FinancierResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
+import { ConsumePromotionRequest, ConsumePromotionResponse, CreditPlanResponse, FinancierResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
 /**
  * Contrato del publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1)
- * para sus 4 endpoints privados de LECTURA del catálogo SOFOM (service-to-service, VPC-only).
+ * para sus 5 endpoints privados service-to-service (VPC-only): 4 de LECTURA del catálogo SOFOM y
+ * 1 de ESCRITURA que registra el consumo de una promoción.
  *
  * loan-offerings es el catálogo comercial del SOFOM: planes de crédito + financieras + la relación
  * M:N retailer↔plan + el simulador de cuota. Consumidores previstos:
@@ -62,4 +63,15 @@ export interface ILoanOfferingsBusinessApi {
      *         (`400 INVALID_PLAN_PARAMETERS`, ej. plazo fuera de `termWeeksOptions`).
      */
     simulate(planId: string, input: SimulateCreditPlanRequest, tenantId: string): Promise<StandardResponse<SimulationResultResponse>>;
+    /**
+     * POST /private/promotions/{promotionId}/consume — cuenta un crédito activado bajo esta
+     * promoción y suma su bono PCF al presupuesto. Al alcanzar el tope la promoción queda `PAUSED`.
+     *
+     * Idempotente por `creditId`: reenviar el mismo crédito devuelve 200 con
+     * `alreadyCounted: true` y NO mueve los contadores. Se llama al ACTIVAR, nunca al cotizar —
+     * una promoción que se cotiza y no se vende no consume nada.
+     *
+     * @throws si la promoción no existe (`404 PROMOTION_NOT_FOUND`).
+     */
+    consumePromotion(promotionId: string, input: ConsumePromotionRequest, tenantId: string): Promise<StandardResponse<ConsumePromotionResponse>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.48.0",
+  "version": "5.49.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.9.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.368.0",
+    "@fiado/type-kit": "^3.370.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/loanOfferings/api/LoanOfferingsBusinessApi.ts

@@ -2,6 +2,8 @@ import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import {
+    ConsumePromotionRequest,
+    ConsumePromotionResponse,
     CreditPlanResponse,
     FinancierResponse,
     SimulateCreditPlanRequest,
@@ -10,8 +12,8 @@ import {
 import { ILoanOfferingsBusinessApi } from "./interfaces/ILoanOfferingsBusinessApi.js";
 
 /**
- * Publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1) para sus 4
- * endpoints privados de lectura del catálogo. Contrato y semántica completos →
+ * Publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1) para sus 5
+ * endpoints privados. Contrato y semántica completos →
  * `ILoanOfferingsBusinessApi` (tenantId obligatorio, `StandardResponse` → leer `result.data`).
  *
  * Env var requerida en el consumer: `LOAN_OFFERINGS_BUSINESS_URL`.
@@ -59,4 +61,13 @@ export default class LoanOfferingsBusinessApi implements ILoanOfferingsBusinessA
         const url = `${this.baseUrl}/private/credit-plans/${encodeURIComponent(planId)}/simulate?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);
     }
+
+    async consumePromotion(
+        promotionId: string,
+        input: ConsumePromotionRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ConsumePromotionResponse>> {
+        const url = `${this.baseUrl}/private/promotions/${encodeURIComponent(promotionId)}/consume?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
 }

package/src/loanOfferings/api/interfaces/ILoanOfferingsBusinessApi.ts

@@ -1,5 +1,7 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import {
+    ConsumePromotionRequest,
+    ConsumePromotionResponse,
     CreditPlanResponse,
     FinancierResponse,
     SimulateCreditPlanRequest,
@@ -8,7 +10,8 @@ import {
 
 /**
  * Contrato del publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1)
- * para sus 4 endpoints privados de LECTURA del catálogo SOFOM (service-to-service, VPC-only).
+ * para sus 5 endpoints privados service-to-service (VPC-only): 4 de LECTURA del catálogo SOFOM y
+ * 1 de ESCRITURA que registra el consumo de una promoción.
  *
  * loan-offerings es el catálogo comercial del SOFOM: planes de crédito + financieras + la relación
  * M:N retailer↔plan + el simulador de cuota. Consumidores previstos:
@@ -83,4 +86,20 @@ export interface ILoanOfferingsBusinessApi {
         input: SimulateCreditPlanRequest,
         tenantId: string,
     ): Promise<StandardResponse<SimulationResultResponse>>;
+
+    /**
+     * POST /private/promotions/{promotionId}/consume — cuenta un crédito activado bajo esta
+     * promoción y suma su bono PCF al presupuesto. Al alcanzar el tope la promoción queda `PAUSED`.
+     *
+     * Idempotente por `creditId`: reenviar el mismo crédito devuelve 200 con
+     * `alreadyCounted: true` y NO mueve los contadores. Se llama al ACTIVAR, nunca al cotizar —
+     * una promoción que se cotiza y no se vende no consume nada.
+     *
+     * @throws si la promoción no existe (`404 PROMOTION_NOT_FOUND`).
+     */
+    consumePromotion(
+        promotionId: string,
+        input: ConsumePromotionRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ConsumePromotionResponse>>;
 }