@fiado/api-invoker 5.108.0 → 5.109.0

package/bin/retailCustomer/api/RetailCustomerBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
+import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse, PromotionBonusEntryResponse, UpsertPromotionBonusRequest, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
 import { CustomersBatchRequest, CustomersBatchResponse } from "./dtos/CustomersBatch.js";
 import { CustomersPageQuery, PrivateCustomerListItem } from "./dtos/CustomersPage.js";
 import { PaginatedResult } from "@fiado/type-kit/bin/retailOrg/index.js";
@@ -29,6 +29,7 @@ export default class RetailCustomerBusinessApi implements IRetailCustomerBusines
     getCustomer(customerId: string, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
     markWelcomeAccredited(customerId: string, tenantId: string, payload?: WelcomeAccreditationRequest): Promise<StandardResponse<WelcomeAccreditationResponse>>;
     setWelcomeAccreditationResult(customerId: string, payload: WelcomeAccreditationResultRequest, tenantId: string): Promise<StandardResponse<WelcomeBonusResponse>>;
+    upsertPromotionBonus(customerId: string, payload: UpsertPromotionBonusRequest, tenantId: string): Promise<StandardResponse<PromotionBonusEntryResponse>>;
     getCustomersBatch(payload: CustomersBatchRequest, tenantId: string): Promise<StandardResponse<CustomersBatchResponse>>;
     listCustomersPage(query: CustomersPageQuery, tenantId: string): Promise<StandardResponse<PaginatedResult<PrivateCustomerListItem>>>;
 }

package/bin/retailCustomer/api/RetailCustomerBusinessApi.js

@@ -56,6 +56,11 @@ let RetailCustomerBusinessApi = class RetailCustomerBusinessApi {
         const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/welcome-accreditation/result?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.put(url, payload);
     }
+    async upsertPromotionBonus(customerId, payload, tenantId) {
+        const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/promotion-bonuses?tenantId=${encodeURIComponent(tenantId)}`;
+        // Firma de http-client: put(url, data, headers, basicAuth, enableTimeout).
+        return await this.httpRequest.put(url, payload, {}, undefined, true);
+    }
     async getCustomersBatch(payload, tenantId) {
         const url = `${this.baseUrl}/private/customers/batch?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, payload);

package/bin/retailCustomer/api/interfaces/IRetailCustomerBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
+import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse, PromotionBonusEntryResponse, UpsertPromotionBonusRequest, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
 import { CustomersBatchRequest, CustomersBatchResponse } from "../dtos/CustomersBatch.js";
 import { CustomersPageQuery, PrivateCustomerListItem } from "../dtos/CustomersPage.js";
 import { PaginatedResult } from "@fiado/type-kit/bin/retailOrg/index.js";
@@ -117,6 +117,15 @@ export interface IRetailCustomerBusinessApi {
      * @throws `400 WELCOME_BONUS_KEY_INVALID` si el `bonusKey` no decodifica (bug del caller).
      */
     setWelcomeAccreditationResult(customerId: string, payload: WelcomeAccreditationResultRequest, tenantId: string): Promise<StandardResponse<WelcomeBonusResponse>>;
+    /**
+     * PUT /private/customers/{customerId}/promotion-bonuses?tenantId= — asienta un bono de promoción
+     * en el libro de bonos. Matriz cerrada: reintentar el mismo estado es idempotente (200).
+     *
+     * @throws `409 PROMOTION_BONUS_INVALID_TRANSITION` si la transición no procede o el asiento es de otro cliente.
+     * @throws `404 CUSTOMER_NOT_FOUND` si el cliente no existe.
+     * @throws `400 VALIDATION_ERROR` si el body viene mal formado.
+     */
+    upsertPromotionBonus(customerId: string, payload: UpsertPromotionBonusRequest, tenantId: string): Promise<StandardResponse<PromotionBonusEntryResponse>>;
     /**
      * POST /private/customers/batch?tenantId= — resuelve NOMBRES de cliente EN LOTE por sus ids.
      * Pensado para pintar una lista sin caer en N+1 contra el privado de un cliente por vez.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.108.0",
+  "version": "5.109.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.488.0",
+    "@fiado/type-kit": "^3.490.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/retailCustomer/api/RetailCustomerBusinessApi.ts

@@ -5,6 +5,8 @@ import {
     UpsertCustomerFromKycRequest,
     AccountResultRequest,
     CustomerResponse,
+    PromotionBonusEntryResponse,
+    UpsertPromotionBonusRequest,
     WelcomeAccreditationRequest,
     WelcomeAccreditationResponse,
     WelcomeAccreditationResultRequest,
@@ -87,6 +89,16 @@ export default class RetailCustomerBusinessApi implements IRetailCustomerBusines
         return await this.httpRequest.put(url, payload);
     }
 
+    async upsertPromotionBonus(
+        customerId: string,
+        payload: UpsertPromotionBonusRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<PromotionBonusEntryResponse>> {
+        const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/promotion-bonuses?tenantId=${encodeURIComponent(tenantId)}`;
+        // Firma de http-client: put(url, data, headers, basicAuth, enableTimeout).
+        return await this.httpRequest.put(url, payload, {}, undefined, true);
+    }
+
     async getCustomersBatch(
         payload: CustomersBatchRequest,
         tenantId: string,

package/src/retailCustomer/api/interfaces/IRetailCustomerBusinessApi.ts

@@ -3,6 +3,8 @@ import {
     UpsertCustomerFromKycRequest,
     AccountResultRequest,
     CustomerResponse,
+    PromotionBonusEntryResponse,
+    UpsertPromotionBonusRequest,
     WelcomeAccreditationRequest,
     WelcomeAccreditationResponse,
     WelcomeAccreditationResultRequest,
@@ -153,6 +155,20 @@ export interface IRetailCustomerBusinessApi {
         tenantId: string,
     ): Promise<StandardResponse<WelcomeBonusResponse>>;
 
+    /**
+     * PUT /private/customers/{customerId}/promotion-bonuses?tenantId= — asienta un bono de promoción
+     * en el libro de bonos. Matriz cerrada: reintentar el mismo estado es idempotente (200).
+     *
+     * @throws `409 PROMOTION_BONUS_INVALID_TRANSITION` si la transición no procede o el asiento es de otro cliente.
+     * @throws `404 CUSTOMER_NOT_FOUND` si el cliente no existe.
+     * @throws `400 VALIDATION_ERROR` si el body viene mal formado.
+     */
+    upsertPromotionBonus(
+        customerId: string,
+        payload: UpsertPromotionBonusRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<PromotionBonusEntryResponse>>;
+
     /**
      * POST /private/customers/batch?tenantId= — resuelve NOMBRES de cliente EN LOTE por sus ids.
      * Pensado para pintar una lista sin caer en N+1 contra el privado de un cliente por vez.