@fiado/api-invoker 5.51.0 → 5.53.0

package/bin/collection-engine/api/CollectionEngineApi.d.ts

@@ -1,5 +1,5 @@
 import type { IHttpRequest } from "@fiado/http-client";
-import { CollectRequest, CollectResponse, DeregisterChargeResponse } from "@fiado/type-kit/bin/collection/index.js";
+import { CollectRequest, CollectResponse, DeregisterChargeResponse, RegisterCollectibleRequest, RegisterCollectibleResponse } from "@fiado/type-kit/bin/collection/index.js";
 import { ICollectionEngineApi } from "./interfaces/ICollectionEngineApi.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 /**
@@ -10,6 +10,7 @@ export default class CollectionEngineApi implements ICollectionEngineApi {
     private httpRequest;
     private readonly baseUrl;
     constructor(httpRequest: IHttpRequest);
+    registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<RegisterCollectibleResponse>>;
     collect(request: CollectRequest): Promise<FiadoApiResponse<CollectResponse>>;
     deregister(domain: string, chargeId: string): Promise<FiadoApiResponse<DeregisterChargeResponse>>;
 }

package/bin/collection-engine/api/CollectionEngineApi.js

@@ -21,6 +21,10 @@ let CollectionEngineApi = class CollectionEngineApi {
     constructor(httpRequest) {
         this.httpRequest = httpRequest;
     }
+    async registerCollectible(request) {
+        const url = `${this.baseUrl}collection/register`;
+        return await this.httpRequest.post(url, request);
+    }
     async collect(request) {
         const url = `${this.baseUrl}collection/collect`;
         return await this.httpRequest.post(url, request);

package/bin/collection-engine/api/interfaces/ICollectionEngineApi.d.ts

@@ -1,4 +1,4 @@
-import { CollectRequest, CollectResponse, DeregisterChargeResponse } from "@fiado/type-kit/bin/collection/index.js";
+import { CollectRequest, CollectResponse, DeregisterChargeResponse, RegisterCollectibleRequest, RegisterCollectibleResponse } from "@fiado/type-kit/bin/collection/index.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 /**
  * Cliente para invocar los endpoints privados del lambda `collection-engine-business`.
@@ -6,12 +6,22 @@ type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApi
  * Los endpoints viven bajo `COLLECTION_ENGINE_LAMBDA_URL` (API Gateway privado / VPC).
  * El motor es agnóstico de proveedores y cuentas: el dominio dice QUÉ se debe y el motor
  * decide de dónde cobrarlo según la config del producto.
- *
- * El alta explícita de un cargo cobrable (`registerCollectible`) todavía no existe en el
- * motor: hoy `collect` crea el intent si no lo había, derivando su identidad de
- * `domain#chargeId`. El método se reincorporará cuando el motor exponga la ruta.
  */
 export interface ICollectionEngineApi {
+    /**
+     * Alta de un cargo cobrable: el dominio avisa de que hay algo que cobrar, sin decir cuánto.
+     * El importe se le pregunta después, al ir a cobrarlo (`/collection/resolve-charges`), porque
+     * entre el alta y el cobro puede haber cambiado —por mora, o porque el cliente pagó por otra vía.
+     *
+     * A partir del alta, el cargo entra en los reintentos del motor: se cobra en cuanto el titular
+     * tiene saldo, sin que el dominio tenga que volver a pedirlo.
+     *
+     * Idempotente por `domain#chargeId`: repetir el alta devuelve `ALREADY_REGISTERED` con el mismo
+     * `intentId`, sin duplicar nada.
+     *
+     * Backend: POST /collection/register (privado VPC).
+     */
+    registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<RegisterCollectibleResponse>>;
     /**
      * Cobro on-demand síncrono. El dominio manda el cargo ya resuelto y el motor recorre la
      * cascada de fuentes configurada para el producto. Idempotente por `domain#chargeId`:

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, ConsumePromotionResponse, CreditPlanResponse, FinancierResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
+import { ConsumePromotionRequest, PromotedSkusResponse, 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 5
@@ -23,4 +23,5 @@ export default class LoanOfferingsBusinessApi implements ILoanOfferingsBusinessA
     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>>;
+    listPromotedSkus(storeId: string, tenantId: string): Promise<StandardResponse<PromotedSkusResponse>>;
 }

package/bin/loanOfferings/api/LoanOfferingsBusinessApi.js

@@ -50,6 +50,10 @@ let LoanOfferingsBusinessApi = class LoanOfferingsBusinessApi {
         const url = `${this.baseUrl}/private/promotions/${encodeURIComponent(promotionId)}/consume?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);
     }
+    async listPromotedSkus(storeId, tenantId) {
+        const url = `${this.baseUrl}/private/promotions/promoted-skus?storeId=${encodeURIComponent(storeId)}&tenantId=${encodeURIComponent(tenantId)}`;
+        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, ConsumePromotionResponse, CreditPlanResponse, FinancierResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
+import { ConsumePromotionRequest, PromotedSkusResponse, 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 5 endpoints privados service-to-service (VPC-only): 4 de LECTURA del catálogo SOFOM y
@@ -74,4 +74,13 @@ export interface ILoanOfferingsBusinessApi {
      * @throws si la promoción no existe (`404 PROMOTION_NOT_FOUND`).
      */
     consumePromotion(promotionId: string, input: ConsumePromotionRequest, tenantId: string): Promise<StandardResponse<ConsumePromotionResponse>>;
+    /**
+     * GET /private/promotions/promoted-skus — los SKUs con promoción viva en una tienda, para el
+     * badge del catálogo del wizard. Devuelve `{ skus: [] }` si no hay ninguna; nunca 404.
+     *
+     * El filtrado vive en el lambda, no acá: solo entran las promociones que alcanzan a CUALQUIER
+     * nivel (el catálogo se pinta antes del score) y las que ACOTAN por SKU (una general marcaría
+     * el catálogo entero). El caller no puede aflojar ese criterio.
+     */
+    listPromotedSkus(storeId: string, tenantId: string): Promise<StandardResponse<PromotedSkusResponse>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.51.0",
+  "version": "5.53.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.373.0",
+    "@fiado/type-kit": "^3.381.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/collection-engine/api/CollectionEngineApi.ts

@@ -4,6 +4,8 @@ import {
     CollectRequest,
     CollectResponse,
     DeregisterChargeResponse,
+    RegisterCollectibleRequest,
+    RegisterCollectibleResponse,
 } from "@fiado/type-kit/bin/collection/index.js";
 import { ICollectionEngineApi } from "./interfaces/ICollectionEngineApi.js";
 
@@ -21,6 +23,11 @@ export default class CollectionEngineApi implements ICollectionEngineApi {
     constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
     }
 
+    async registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<RegisterCollectibleResponse>> {
+        const url = `${this.baseUrl}collection/register`;
+        return await this.httpRequest.post(url, request);
+    }
+
     async collect(request: CollectRequest): Promise<FiadoApiResponse<CollectResponse>> {
         const url = `${this.baseUrl}collection/collect`;
         return await this.httpRequest.post(url, request);

package/src/collection-engine/api/interfaces/ICollectionEngineApi.ts

@@ -2,6 +2,8 @@ import {
     CollectRequest,
     CollectResponse,
     DeregisterChargeResponse,
+    RegisterCollectibleRequest,
+    RegisterCollectibleResponse,
 } from "@fiado/type-kit/bin/collection/index.js";
 
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
@@ -12,13 +14,24 @@ type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApi
  * Los endpoints viven bajo `COLLECTION_ENGINE_LAMBDA_URL` (API Gateway privado / VPC).
  * El motor es agnóstico de proveedores y cuentas: el dominio dice QUÉ se debe y el motor
  * decide de dónde cobrarlo según la config del producto.
- *
- * El alta explícita de un cargo cobrable (`registerCollectible`) todavía no existe en el
- * motor: hoy `collect` crea el intent si no lo había, derivando su identidad de
- * `domain#chargeId`. El método se reincorporará cuando el motor exponga la ruta.
  */
 export interface ICollectionEngineApi {
 
+    /**
+     * Alta de un cargo cobrable: el dominio avisa de que hay algo que cobrar, sin decir cuánto.
+     * El importe se le pregunta después, al ir a cobrarlo (`/collection/resolve-charges`), porque
+     * entre el alta y el cobro puede haber cambiado —por mora, o porque el cliente pagó por otra vía.
+     *
+     * A partir del alta, el cargo entra en los reintentos del motor: se cobra en cuanto el titular
+     * tiene saldo, sin que el dominio tenga que volver a pedirlo.
+     *
+     * Idempotente por `domain#chargeId`: repetir el alta devuelve `ALREADY_REGISTERED` con el mismo
+     * `intentId`, sin duplicar nada.
+     *
+     * Backend: POST /collection/register (privado VPC).
+     */
+    registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<RegisterCollectibleResponse>>;
+
     /**
      * Cobro on-demand síncrono. El dominio manda el cargo ya resuelto y el motor recorre la
      * cascada de fuentes configurada para el producto. Idempotente por `domain#chargeId`:

package/src/loanOfferings/api/LoanOfferingsBusinessApi.ts

@@ -3,6 +3,7 @@ import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import {
     ConsumePromotionRequest,
+    PromotedSkusResponse,
     ConsumePromotionResponse,
     CreditPlanResponse,
     FinancierResponse,
@@ -70,4 +71,12 @@ export default class LoanOfferingsBusinessApi implements ILoanOfferingsBusinessA
         const url = `${this.baseUrl}/private/promotions/${encodeURIComponent(promotionId)}/consume?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);
     }
+
+    async listPromotedSkus(
+        storeId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<PromotedSkusResponse>> {
+        const url = `${this.baseUrl}/private/promotions/promoted-skus?storeId=${encodeURIComponent(storeId)}&tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
 }

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

@@ -1,6 +1,7 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import {
     ConsumePromotionRequest,
+    PromotedSkusResponse,
     ConsumePromotionResponse,
     CreditPlanResponse,
     FinancierResponse,
@@ -102,4 +103,17 @@ export interface ILoanOfferingsBusinessApi {
         input: ConsumePromotionRequest,
         tenantId: string,
     ): Promise<StandardResponse<ConsumePromotionResponse>>;
+
+    /**
+     * GET /private/promotions/promoted-skus — los SKUs con promoción viva en una tienda, para el
+     * badge del catálogo del wizard. Devuelve `{ skus: [] }` si no hay ninguna; nunca 404.
+     *
+     * El filtrado vive en el lambda, no acá: solo entran las promociones que alcanzan a CUALQUIER
+     * nivel (el catálogo se pinta antes del score) y las que ACOTAN por SKU (una general marcaría
+     * el catálogo entero). El caller no puede aflojar ese criterio.
+     */
+    listPromotedSkus(
+        storeId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<PromotedSkusResponse>>;
 }