@fiado/api-invoker 5.54.0 → 5.56.0

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

@@ -1,9 +1,9 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanResponse, FinancierResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
+import { ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanResponse, FinancierResponse, ReservePromotionBonusRequest, ReservePromotionBonusResponse, ResolveCustomerSegmentsRequest, ResolveCustomerSegmentsResponse, SettlePromotionBonusRequest, PromotionBonusResponse, 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 5
+ * Publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1) para sus
  * endpoints privados. Contrato y semántica completos →
  * `ILoanOfferingsBusinessApi` (tenantId obligatorio, `StandardResponse` → leer `result.data`).
  *
@@ -24,4 +24,7 @@ export default class LoanOfferingsBusinessApi implements ILoanOfferingsBusinessA
     simulate(planId: string, input: SimulateCreditPlanRequest, tenantId: string): Promise<StandardResponse<SimulationResultResponse>>;
     consumePromotion(promotionId: string, input: ConsumePromotionRequest, tenantId: string): Promise<StandardResponse<ConsumePromotionResponse>>;
     listPromotedSkus(storeId: string, tenantId: string): Promise<StandardResponse<PromotedSkusResponse>>;
+    resolveCustomerSegments(input: ResolveCustomerSegmentsRequest, tenantId: string): Promise<StandardResponse<ResolveCustomerSegmentsResponse>>;
+    reservePromotionBonus(promotionId: string, input: ReservePromotionBonusRequest, tenantId: string): Promise<StandardResponse<ReservePromotionBonusResponse>>;
+    settlePromotionBonus(promotionId: string, input: SettlePromotionBonusRequest, tenantId: string): Promise<StandardResponse<PromotionBonusResponse>>;
 }

package/bin/loanOfferings/api/LoanOfferingsBusinessApi.js

@@ -12,7 +12,7 @@ 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 5
+ * Publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1) para sus
  * endpoints privados. Contrato y semántica completos →
  * `ILoanOfferingsBusinessApi` (tenantId obligatorio, `StandardResponse` → leer `result.data`).
  *
@@ -54,6 +54,18 @@ let LoanOfferingsBusinessApi = class LoanOfferingsBusinessApi {
         const url = `${this.baseUrl}/private/promotions/promoted-skus?storeId=${encodeURIComponent(storeId)}&tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.get(url);
     }
+    async resolveCustomerSegments(input, tenantId) {
+        const url = `${this.baseUrl}/private/segments/resolve?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+    async reservePromotionBonus(promotionId, input, tenantId) {
+        const url = `${this.baseUrl}/private/promotions/${encodeURIComponent(promotionId)}/bonus-payment?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+    async settlePromotionBonus(promotionId, input, tenantId) {
+        const url = `${this.baseUrl}/private/promotions/${encodeURIComponent(promotionId)}/bonus-payment/result?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.put(url, input);
+    }
 };
 LoanOfferingsBusinessApi = __decorate([
     injectable(),

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

@@ -1,8 +1,8 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanResponse, FinancierResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
+import { ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanResponse, FinancierResponse, ReservePromotionBonusRequest, ReservePromotionBonusResponse, ResolveCustomerSegmentsRequest, ResolveCustomerSegmentsResponse, SettlePromotionBonusRequest, PromotionBonusResponse, 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 5 endpoints privados service-to-service (VPC-only): 4 de LECTURA del catálogo SOFOM y
+ * para sus endpoints privados service-to-service (VPC-only): LECTURAS 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
@@ -11,7 +11,7 @@ import { ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse
  *   - motor de crédito (F3)      → leer un plan · simular la cuota (amortización + IVA + CAT)
  *
  * ─────────────────────────────────────────────────────────────────────────────
- * `tenantId` es OBLIGATORIO en los 4 métodos — no es un detalle de firma.
+ * `tenantId` es OBLIGATORIO en todos los métodos — no es un detalle de firma.
  * ─────────────────────────────────────────────────────────────────────────────
  * Los privados NO llevan token de usuario (`Feature.ANONIMUS`; la protección es la red VPC), así que
  * el lambda destino no tiene `AuthContext.issuer` y NO puede inferir el silo. El caller declara el
@@ -83,4 +83,33 @@ export interface ILoanOfferingsBusinessApi {
      * el catálogo entero). El caller no puede aflojar ese criterio.
      */
     listPromotedSkus(storeId: string, tenantId: string): Promise<StandardResponse<PromotedSkusResponse>>;
+    /**
+     * POST /private/segments/resolve — los segmentos a los que pertenece el cliente HOY, evaluados
+     * en línea contra los hechos que manda el caller. No hay segmento persistido en el cliente.
+     *
+     * Los hechos los junta quien ya tiene al cliente delante; este lambda no sale a buscarlos a
+     * otro silo. Un hecho AUSENTE hace que su filtro NO se cumpla: sin el dato no se puede afirmar
+     * que el cliente califica, y de las dos salidas la segura es dejarlo fuera.
+     *
+     * `segmentIds` puede venir VACÍO y eso no es un error: significa que el cliente está en
+     * Estándar, el catch-all, que nunca se devuelve aquí.
+     *
+     * El resultado alimenta `customerSegmentIds` de {@link simulate}: sin él, las políticas de
+     * tienda acotadas a un segmento no aplican, y las que tienen compuerta encendida rechazan la
+     * venta con `422 STORE_POLICY_SCOPE_UNKNOWN`.
+     *
+     * @throws si el body no trae `retailCustomerId` o un hecho tiene el tipo equivocado
+     *         (`400`), o si falta el tenant (`400 UNKNOWN_TENANT`).
+     */
+    resolveCustomerSegments(input: ResolveCustomerSegmentsRequest, tenantId: string): Promise<StandardResponse<ResolveCustomerSegmentsResponse>>;
+    /**
+     * `POST /private/promotions/{promotionId}/bonus-payment` — reserva el bono PCF de un crédito
+     * recién activado. El candado es el `creditId`: reenviarlo devuelve `reserved: false`.
+     */
+    reservePromotionBonus(promotionId: string, input: ReservePromotionBonusRequest, tenantId: string): Promise<StandardResponse<ReservePromotionBonusResponse>>;
+    /**
+     * `PUT /private/promotions/{promotionId}/bonus-payment/result` — cierra el asiento con lo que
+     * contestó el processor. Se llama SIEMPRE, haya pagado o no.
+     */
+    settlePromotionBonus(promotionId: string, input: SettlePromotionBonusRequest, tenantId: string): Promise<StandardResponse<PromotionBonusResponse>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.54.0",
+  "version": "5.56.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.382.0",
+    "@fiado/type-kit": "^3.385.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/loanOfferings/api/LoanOfferingsBusinessApi.ts

@@ -7,13 +7,19 @@ import {
     ConsumePromotionResponse,
     CreditPlanResponse,
     FinancierResponse,
+    ReservePromotionBonusRequest,
+    ReservePromotionBonusResponse,
+    ResolveCustomerSegmentsRequest,
+    ResolveCustomerSegmentsResponse,
+    SettlePromotionBonusRequest,
+    PromotionBonusResponse,
     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 5
+ * Publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1) para sus
  * endpoints privados. Contrato y semántica completos →
  * `ILoanOfferingsBusinessApi` (tenantId obligatorio, `StandardResponse` → leer `result.data`).
  *
@@ -79,4 +85,30 @@ export default class LoanOfferingsBusinessApi implements ILoanOfferingsBusinessA
         const url = `${this.baseUrl}/private/promotions/promoted-skus?storeId=${encodeURIComponent(storeId)}&tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.get(url);
     }
+
+    async resolveCustomerSegments(
+        input: ResolveCustomerSegmentsRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ResolveCustomerSegmentsResponse>> {
+        const url = `${this.baseUrl}/private/segments/resolve?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
+    async reservePromotionBonus(
+        promotionId: string,
+        input: ReservePromotionBonusRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReservePromotionBonusResponse>> {
+        const url = `${this.baseUrl}/private/promotions/${encodeURIComponent(promotionId)}/bonus-payment?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
+    async settlePromotionBonus(
+        promotionId: string,
+        input: SettlePromotionBonusRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<PromotionBonusResponse>> {
+        const url = `${this.baseUrl}/private/promotions/${encodeURIComponent(promotionId)}/bonus-payment/result?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.put(url, input);
+    }
 }

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

@@ -5,13 +5,19 @@ import {
     ConsumePromotionResponse,
     CreditPlanResponse,
     FinancierResponse,
+    ReservePromotionBonusRequest,
+    ReservePromotionBonusResponse,
+    ResolveCustomerSegmentsRequest,
+    ResolveCustomerSegmentsResponse,
+    SettlePromotionBonusRequest,
+    PromotionBonusResponse,
     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 5 endpoints privados service-to-service (VPC-only): 4 de LECTURA del catálogo SOFOM y
+ * para sus endpoints privados service-to-service (VPC-only): LECTURAS 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
@@ -20,7 +26,7 @@ import {
  *   - motor de crédito (F3)      → leer un plan · simular la cuota (amortización + IVA + CAT)
  *
  * ─────────────────────────────────────────────────────────────────────────────
- * `tenantId` es OBLIGATORIO en los 4 métodos — no es un detalle de firma.
+ * `tenantId` es OBLIGATORIO en todos los métodos — no es un detalle de firma.
  * ─────────────────────────────────────────────────────────────────────────────
  * Los privados NO llevan token de usuario (`Feature.ANONIMUS`; la protección es la red VPC), así que
  * el lambda destino no tiene `AuthContext.issuer` y NO puede inferir el silo. El caller declara el
@@ -116,4 +122,47 @@ export interface ILoanOfferingsBusinessApi {
         storeId: string,
         tenantId: string,
     ): Promise<StandardResponse<PromotedSkusResponse>>;
+
+    /**
+     * POST /private/segments/resolve — los segmentos a los que pertenece el cliente HOY, evaluados
+     * en línea contra los hechos que manda el caller. No hay segmento persistido en el cliente.
+     *
+     * Los hechos los junta quien ya tiene al cliente delante; este lambda no sale a buscarlos a
+     * otro silo. Un hecho AUSENTE hace que su filtro NO se cumpla: sin el dato no se puede afirmar
+     * que el cliente califica, y de las dos salidas la segura es dejarlo fuera.
+     *
+     * `segmentIds` puede venir VACÍO y eso no es un error: significa que el cliente está en
+     * Estándar, el catch-all, que nunca se devuelve aquí.
+     *
+     * El resultado alimenta `customerSegmentIds` de {@link simulate}: sin él, las políticas de
+     * tienda acotadas a un segmento no aplican, y las que tienen compuerta encendida rechazan la
+     * venta con `422 STORE_POLICY_SCOPE_UNKNOWN`.
+     *
+     * @throws si el body no trae `retailCustomerId` o un hecho tiene el tipo equivocado
+     *         (`400`), o si falta el tenant (`400 UNKNOWN_TENANT`).
+     */
+    resolveCustomerSegments(
+        input: ResolveCustomerSegmentsRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ResolveCustomerSegmentsResponse>>;
+
+    /**
+     * `POST /private/promotions/{promotionId}/bonus-payment` — reserva el bono PCF de un crédito
+     * recién activado. El candado es el `creditId`: reenviarlo devuelve `reserved: false`.
+     */
+    reservePromotionBonus(
+        promotionId: string,
+        input: ReservePromotionBonusRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReservePromotionBonusResponse>>;
+
+    /**
+     * `PUT /private/promotions/{promotionId}/bonus-payment/result` — cierra el asiento con lo que
+     * contestó el processor. Se llama SIEMPRE, haya pagado o no.
+     */
+    settlePromotionBonus(
+        promotionId: string,
+        input: SettlePromotionBonusRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<PromotionBonusResponse>>;
 }