@fiado/api-invoker 5.57.0 → 5.59.0

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

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanResponse, FinancierResponse, ReservePromotionBonusRequest, ReservePromotionBonusResponse, ResolveCustomerSegmentsRequest, ResolveCustomerSegmentsResponse, SkuPromotionsResponse, SettlePromotionBonusRequest, PromotionBonusResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
+import { ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanLevelEnum, CreditPlanResponse, FinancierResponse, ReservePromotionBonusRequest, ReservePromotionBonusResponse, ResolveCustomerSegmentsRequest, ResolveCustomerSegmentsResponse, ScopeWidePromotionsResponse, SkuPromotionsResponse, 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
@@ -28,4 +28,5 @@ export default class LoanOfferingsBusinessApi implements ILoanOfferingsBusinessA
     reservePromotionBonus(promotionId: string, input: ReservePromotionBonusRequest, tenantId: string): Promise<StandardResponse<ReservePromotionBonusResponse>>;
     settlePromotionBonus(promotionId: string, input: SettlePromotionBonusRequest, tenantId: string): Promise<StandardResponse<PromotionBonusResponse>>;
     listSkuPromotions(storeId: string, tenantId: string): Promise<StandardResponse<SkuPromotionsResponse>>;
+    listScopeWidePromotions(storeId: string, tenantId: string, level?: CreditPlanLevelEnum, segmentId?: string): Promise<StandardResponse<ScopeWidePromotionsResponse>>;
 }

package/bin/loanOfferings/api/LoanOfferingsBusinessApi.js

@@ -70,6 +70,14 @@ let LoanOfferingsBusinessApi = class LoanOfferingsBusinessApi {
         const url = `${this.baseUrl}/private/promotions/by-sku?storeId=${encodeURIComponent(storeId)}&tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.get(url);
     }
+    async listScopeWidePromotions(storeId, tenantId, level, segmentId) {
+        let url = `${this.baseUrl}/private/promotions/scope-wide?storeId=${encodeURIComponent(storeId)}&tenantId=${encodeURIComponent(tenantId)}`;
+        if (level)
+            url += `&level=${encodeURIComponent(level)}`;
+        if (segmentId)
+            url += `&segmentId=${encodeURIComponent(segmentId)}`;
+        return await this.httpRequest.get(url);
+    }
 };
 LoanOfferingsBusinessApi = __decorate([
     injectable(),

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

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanResponse, FinancierResponse, ReservePromotionBonusRequest, ReservePromotionBonusResponse, ResolveCustomerSegmentsRequest, ResolveCustomerSegmentsResponse, SkuPromotionsResponse, SettlePromotionBonusRequest, PromotionBonusResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
+import { ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanLevelEnum, CreditPlanResponse, FinancierResponse, ReservePromotionBonusRequest, ReservePromotionBonusResponse, ResolveCustomerSegmentsRequest, ResolveCustomerSegmentsResponse, ScopeWidePromotionsResponse, SkuPromotionsResponse, 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 endpoints privados service-to-service (VPC-only): LECTURAS del catálogo SOFOM y
@@ -117,4 +117,14 @@ export interface ILoanOfferingsBusinessApi {
      * Es el detalle del panel del paso 03; el badge lo resuelve {@link listPromotedSkus}.
      */
     listSkuPromotions(storeId: string, tenantId: string): Promise<StandardResponse<SkuPromotionsResponse>>;
+    /**
+     * `GET /private/promotions/scope-wide` — promociones que NO acotan por SKU (tienda, nivel,
+     * segmento o universales), para el banner de pantalla completa del paso 03 del wizard.
+     *
+     * `level`/`segmentId` son opcionales: si el score todavía no corrió o el segmento no se
+     * resolvió, se omiten y el lambda destino descarta las promociones que acotan por esa
+     * dimensión (mismo criterio que `listSkuPromotions`/`by-sku`). Devuelve `{ items: [] }` si no
+     * hay ninguna vigente; nunca 404.
+     */
+    listScopeWidePromotions(storeId: string, tenantId: string, level?: CreditPlanLevelEnum, segmentId?: string): Promise<StandardResponse<ScopeWidePromotionsResponse>>;
 }

package/bin/transactionProcessor/api/TransactionProcessorApi.d.ts

@@ -4,7 +4,7 @@ import { AuthorizeCollectorOrderRequest, AuthorizeCollectorOrderResponse, Author
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ValidateWalletFundingRequest, ValidateWalletFundingResponse, CreditWalletFundingRequest, CreditWalletFundingResponse, ReverseWalletFundingRequest, ReverseWalletFundingResponse, GetWalletFundingLimitRequest, GetWalletFundingLimitResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
 import { RemittanceCreditBackRequest, RemittanceCreditBackResponse } from "@fiado/type-kit/bin/remittance/index.js";
-import { AuthorizeCollectionMovementRequest, AuthorizeCollectionMovementResponse } from "@fiado/type-kit/bin/collection/index.js";
+import { AuthorizeCollectionMovementRequest, AuthorizeCollectionMovementResponse, CaptureCollectionHoldRequest, CaptureCollectionHoldResponse } from "@fiado/type-kit/bin/collection/index.js";
 type ProcessUpdateLevelRequest = import("@fiado/type-kit/bin/transactionProcessor/dtos/ProcessUpdateLevelRequest.js").default;
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 export default class TransactionProcessorApi implements ITransactionProcessorApi {
@@ -24,6 +24,7 @@ export default class TransactionProcessorApi implements ITransactionProcessorApi
     walletFundingGetLimit(request: GetWalletFundingLimitRequest): Promise<ApiGatewayResponse<GetWalletFundingLimitResponse>>;
     creditBack(request: RemittanceCreditBackRequest): Promise<FiadoApiResponse<RemittanceCreditBackResponse>>;
     authorizeCollectionMovement(request: AuthorizeCollectionMovementRequest): Promise<FiadoApiResponse<AuthorizeCollectionMovementResponse>>;
+    captureCollectionHold(request: CaptureCollectionHoldRequest): Promise<FiadoApiResponse<CaptureCollectionHoldResponse>>;
     authorizeWelcomeBonus(request: AuthorizeBonusRequest): Promise<FiadoApiResponse<TransactionProcessorResponse>>;
 }
 export {};

package/bin/transactionProcessor/api/TransactionProcessorApi.js

@@ -69,6 +69,10 @@ let TransactionProcessorApi = class TransactionProcessorApi {
         const url = `${this.baseUrl}collection/authorize`;
         return await this.httpRequest.post(url, request);
     }
+    async captureCollectionHold(request) {
+        const url = `${this.baseUrl}collection/capture`;
+        return await this.httpRequest.post(url, request);
+    }
     async authorizeWelcomeBonus(request) {
         const url = `${this.baseUrl}bonus/authorize`;
         return await this.httpRequest.post(url, request);

package/bin/transactionProcessor/api/interfaces/ITransactionProcessorApi.d.ts

@@ -3,7 +3,7 @@ import { AuthorizeCollectorOrderRequest, AuthorizeCollectorOrderResponse, Author
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ValidateWalletFundingRequest, ValidateWalletFundingResponse, CreditWalletFundingRequest, CreditWalletFundingResponse, ReverseWalletFundingRequest, ReverseWalletFundingResponse, GetWalletFundingLimitRequest, GetWalletFundingLimitResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
 import { RemittanceCreditBackRequest, RemittanceCreditBackResponse } from "@fiado/type-kit/bin/remittance/index.js";
-import { AuthorizeCollectionMovementRequest, AuthorizeCollectionMovementResponse } from "@fiado/type-kit/bin/collection/index.js";
+import { AuthorizeCollectionMovementRequest, AuthorizeCollectionMovementResponse, CaptureCollectionHoldRequest, CaptureCollectionHoldResponse } from "@fiado/type-kit/bin/collection/index.js";
 type ProcessUpdateLevelRequest = import("@fiado/type-kit/bin/transactionProcessor/dtos/ProcessUpdateLevelRequest.js").default;
 export interface ITransactionProcessorApi {
     authorizeTransaction(request: AuthorizeCreditCardPurchaseRequest): Promise<any>;
@@ -54,6 +54,16 @@ export interface ITransactionProcessorApi {
      * Idempotente por `executionId` (@IdempotencyController).
      */
     authorizeCollectionMovement(request: AuthorizeCollectionMovementRequest): Promise<FiadoApiResponse<AuthorizeCollectionMovementResponse>>;
+    /**
+     * Cierra una retención colocada por un mecanismo que reserva en vez de cobrar. Hasta que se
+     * captura, el importe sigue siendo del titular —sólo que inmovilizado— y el cobro no ha dejado
+     * asiento: es esta llamada la que saca el dinero de la cuenta y lo asienta.
+     *
+     * Una retención que el proveedor no confirma responde `NONE`: sigue en pie, no es un error.
+     * Backend: POST /transaction-processor/collection/capture (privado VPC).
+     * Idempotente por `executionId`.
+     */
+    captureCollectionHold(request: CaptureCollectionHoldRequest): Promise<FiadoApiResponse<CaptureCollectionHoldResponse>>;
     /**
      * Acredita el bono de bienvenida de SureKeep en la wallet PagoConfiado del comprador.
      * Backend: POST /transaction-processor/bonus/authorize (privado VPC).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.57.0",
+  "version": "5.59.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.386.0",
+    "@fiado/type-kit": "^3.390.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/loanOfferings/api/LoanOfferingsBusinessApi.ts

@@ -5,12 +5,14 @@ import {
     ConsumePromotionRequest,
     PromotedSkusResponse,
     ConsumePromotionResponse,
+    CreditPlanLevelEnum,
     CreditPlanResponse,
     FinancierResponse,
     ReservePromotionBonusRequest,
     ReservePromotionBonusResponse,
     ResolveCustomerSegmentsRequest,
     ResolveCustomerSegmentsResponse,
+    ScopeWidePromotionsResponse,
     SkuPromotionsResponse,
     SettlePromotionBonusRequest,
     PromotionBonusResponse,
@@ -120,4 +122,16 @@ export default class LoanOfferingsBusinessApi implements ILoanOfferingsBusinessA
         const url = `${this.baseUrl}/private/promotions/by-sku?storeId=${encodeURIComponent(storeId)}&tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.get(url);
     }
+
+    async listScopeWidePromotions(
+        storeId: string,
+        tenantId: string,
+        level?: CreditPlanLevelEnum,
+        segmentId?: string,
+    ): Promise<StandardResponse<ScopeWidePromotionsResponse>> {
+        let url = `${this.baseUrl}/private/promotions/scope-wide?storeId=${encodeURIComponent(storeId)}&tenantId=${encodeURIComponent(tenantId)}`;
+        if (level) url += `&level=${encodeURIComponent(level)}`;
+        if (segmentId) url += `&segmentId=${encodeURIComponent(segmentId)}`;
+        return await this.httpRequest.get(url);
+    }
 }

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

@@ -3,12 +3,14 @@ import {
     ConsumePromotionRequest,
     PromotedSkusResponse,
     ConsumePromotionResponse,
+    CreditPlanLevelEnum,
     CreditPlanResponse,
     FinancierResponse,
     ReservePromotionBonusRequest,
     ReservePromotionBonusResponse,
     ResolveCustomerSegmentsRequest,
     ResolveCustomerSegmentsResponse,
+    ScopeWidePromotionsResponse,
     SkuPromotionsResponse,
     SettlePromotionBonusRequest,
     PromotionBonusResponse,
@@ -175,4 +177,20 @@ export interface ILoanOfferingsBusinessApi {
         storeId: string,
         tenantId: string,
     ): Promise<StandardResponse<SkuPromotionsResponse>>;
+
+    /**
+     * `GET /private/promotions/scope-wide` — promociones que NO acotan por SKU (tienda, nivel,
+     * segmento o universales), para el banner de pantalla completa del paso 03 del wizard.
+     *
+     * `level`/`segmentId` son opcionales: si el score todavía no corrió o el segmento no se
+     * resolvió, se omiten y el lambda destino descarta las promociones que acotan por esa
+     * dimensión (mismo criterio que `listSkuPromotions`/`by-sku`). Devuelve `{ items: [] }` si no
+     * hay ninguna vigente; nunca 404.
+     */
+    listScopeWidePromotions(
+        storeId: string,
+        tenantId: string,
+        level?: CreditPlanLevelEnum,
+        segmentId?: string,
+    ): Promise<StandardResponse<ScopeWidePromotionsResponse>>;
 }

package/src/transactionProcessor/api/TransactionProcessorApi.ts

@@ -27,6 +27,8 @@ import { RemittanceCreditBackRequest, RemittanceCreditBackResponse } from "@fiad
 import {
     AuthorizeCollectionMovementRequest,
     AuthorizeCollectionMovementResponse,
+    CaptureCollectionHoldRequest,
+    CaptureCollectionHoldResponse,
 } from "@fiado/type-kit/bin/collection/index.js";
 type ProcessUpdateLevelRequest = import("@fiado/type-kit/bin/transactionProcessor/dtos/ProcessUpdateLevelRequest.js").default;
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
@@ -116,6 +118,13 @@ export default class TransactionProcessorApi implements ITransactionProcessorApi
         return await this.httpRequest.post(url, request);
     }
 
+    async captureCollectionHold(
+        request: CaptureCollectionHoldRequest,
+    ): Promise<FiadoApiResponse<CaptureCollectionHoldResponse>> {
+        const url = `${this.baseUrl}collection/capture`;
+        return await this.httpRequest.post(url, request);
+    }
+
     async authorizeWelcomeBonus(
         request: AuthorizeBonusRequest,
     ): Promise<FiadoApiResponse<TransactionProcessorResponse>> {

package/src/transactionProcessor/api/interfaces/ITransactionProcessorApi.ts

@@ -26,6 +26,8 @@ import { RemittanceCreditBackRequest, RemittanceCreditBackResponse } from "@fiad
 import {
     AuthorizeCollectionMovementRequest,
     AuthorizeCollectionMovementResponse,
+    CaptureCollectionHoldRequest,
+    CaptureCollectionHoldResponse,
 } from "@fiado/type-kit/bin/collection/index.js";
 type ProcessUpdateLevelRequest = import("@fiado/type-kit/bin/transactionProcessor/dtos/ProcessUpdateLevelRequest.js").default;
 
@@ -104,6 +106,19 @@ export interface ITransactionProcessorApi {
         request: AuthorizeCollectionMovementRequest,
     ): Promise<FiadoApiResponse<AuthorizeCollectionMovementResponse>>;
 
+    /**
+     * Cierra una retención colocada por un mecanismo que reserva en vez de cobrar. Hasta que se
+     * captura, el importe sigue siendo del titular —sólo que inmovilizado— y el cobro no ha dejado
+     * asiento: es esta llamada la que saca el dinero de la cuenta y lo asienta.
+     *
+     * Una retención que el proveedor no confirma responde `NONE`: sigue en pie, no es un error.
+     * Backend: POST /transaction-processor/collection/capture (privado VPC).
+     * Idempotente por `executionId`.
+     */
+    captureCollectionHold(
+        request: CaptureCollectionHoldRequest,
+    ): Promise<FiadoApiResponse<CaptureCollectionHoldResponse>>;
+
     /**
      * Acredita el bono de bienvenida de SureKeep en la wallet PagoConfiado del comprador.
      * Backend: POST /transaction-processor/bonus/authorize (privado VPC).