@fiado/api-invoker 5.32.1 → 5.33.0

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

@@ -1,9 +1,9 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
+import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
 import { IRetailCustomerBusinessApi } from "./interfaces/IRetailCustomerBusinessApi.js";
 /**
- * Publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail) para sus 5
+ * Publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail) para sus 6
  * endpoints privados de cliente. Contrato y semántica completos → `IRetailCustomerBusinessApi`.
  *
  * Los paths y el `?tenantId=` matchean `openapi/private.yaml` del lambda destino (mismo patrón que
@@ -24,5 +24,6 @@ export default class RetailCustomerBusinessApi implements IRetailCustomerBusines
     setAccountResult(customerId: string, payload: AccountResultRequest, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
     getCustomerByPhone(phone: string, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
     getCustomer(customerId: string, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
-    markWelcomeAccredited(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>>;
 }

package/bin/retailCustomer/api/RetailCustomerBusinessApi.js

@@ -12,7 +12,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { inject, injectable } from "inversify";
 /**
- * Publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail) para sus 5
+ * Publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail) para sus 6
  * endpoints privados de cliente. Contrato y semántica completos → `IRetailCustomerBusinessApi`.
  *
  * Los paths y el `?tenantId=` matchean `openapi/private.yaml` del lambda destino (mismo patrón que
@@ -47,10 +47,14 @@ let RetailCustomerBusinessApi = class RetailCustomerBusinessApi {
         const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.get(url);
     }
-    async markWelcomeAccredited(customerId, tenantId) {
+    async markWelcomeAccredited(customerId, tenantId, payload) {
         const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/welcome-accreditation?tenantId=${encodeURIComponent(tenantId)}`;
-        // Sin body: el cliente va en el path y el actor lo pone el destino desde el contexto privado.
-        return await this.httpRequest.post(url, {});
+        // Body opcional: el actor lo pone el destino desde el contexto privado, no viaja en el payload.
+        return await this.httpRequest.post(url, payload ?? {});
+    }
+    async setWelcomeAccreditationResult(customerId, payload, tenantId) {
+        const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/welcome-accreditation/result?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.put(url, payload);
     }
 };
 RetailCustomerBusinessApi = __decorate([

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

@@ -1,15 +1,15 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
+import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
 /**
  * Contrato del publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail)
- * para sus 5 endpoints privados de cliente (service-to-service, VPC-only).
+ * para sus 6 endpoints privados de cliente (service-to-service, VPC-only).
  *
  * Consumidor previsto:
  *   - `retail-wizard-business` → upsert del cliente post-KYC, aterrizaje del resultado de apertura
  *     de cuenta (D35), y lecturas del cliente por teléfono / id durante la saga de venta.
  *
  * ─────────────────────────────────────────────────────────────────────────────
- * `tenantId` es OBLIGATORIO en los 5 métodos — no es un detalle de firma.
+ * `tenantId` es OBLIGATORIO en los 6 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
@@ -75,7 +75,7 @@ export interface IRetailCustomerBusinessApi {
     getCustomer(customerId: string, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
     /**
      * POST /private/customers/{customerId}/welcome-accreditation?tenantId= — RESERVA la acreditación
-     * del bono de bienvenida (D33). Sin body: el cliente va en el path, el actor lo pone el destino.
+     * del bono de bienvenida (D33) y abre su asiento en el libro de bonos.
      *
      * ⚠️ Reserva, NO acredita. El lambda destino es dueño del flag `welcomeAccredited` y su transición
      * `false → true` es el candado de idempotencia PERMANENTE por cliente (una sola vez para siempre,
@@ -83,11 +83,35 @@ export interface IRetailCustomerBusinessApi {
      * concurrentes NO pueden ganar los dos.
      *
      * Orden obligatorio en el caller: reservar acá PRIMERO, mover plata en el processor DESPUÉS. Al
-     * revés, un doble click acredita dos veces plata real.
+     * revés, un doble click acredita dos veces plata real. Después de mover plata, CERRAR el asiento
+     * con `setWelcomeAccreditationResult` — si no, el bono queda `PENDING` para siempre.
+     *
+     * El `payload` con los datos de la venta es OPCIONAL: sin él el asiento nace incompleto (tienda
+     * `UNKNOWN`) pero nace. La respuesta trae `bonus.bonusKey`, que es lo que pide el cierre.
      *
      * @throws `409 WELCOME_ALREADY_ACCREDITED` si el bono ya se entregó. Para el caller NO es falla:
      *   es la señal de "no acredites" — la venta sigue su curso normal.
      * @throws `404 CUSTOMER_NOT_FOUND` si el cliente no existe.
+     * @throws `400 VALIDATION_ERROR` si el payload viene mal formado.
+     */
+    markWelcomeAccredited(customerId: string, tenantId: string, payload?: WelcomeAccreditationRequest): Promise<StandardResponse<WelcomeAccreditationResponse>>;
+    /**
+     * PUT /private/customers/{customerId}/welcome-accreditation/result?tenantId= — cierra el asiento
+     * con el resultado del processor (D33). El `bonusKey` sale de la respuesta de la reserva.
+     *
+     * `ACCREDITED` cierra con `processorTransactionId`. `FAILED` es un rechazo INEQUÍVOCO y libera el
+     * candado para que la venta se reintente. `UNVERIFIED` es un fallo AMBIGUO (timeout, 5xx) y lo
+     * deja tomado: el `walletFundingCredit` del processor no deduplica, así que liberarlo podría
+     * acreditar plata real dos veces. Un timeout se asienta `UNVERIFIED`, nunca `FAILED`.
+     *
+     * Reintentar el MISMO resultado es idempotente (200). Un asiento `UNVERIFIED` se cierra después
+     * con `ACCREDITED`/`FAILED` mandando además `reconciledBy` y `reconciliationReason`.
+     *
+     * @throws `409 WELCOME_BONUS_ALREADY_RESOLVED` si ya cerró con OTRO resultado: no reintentar,
+     *   escalar — pisarlo borraría lo que de verdad pasó con la plata.
+     * @throws `422 WELCOME_BONUS_RECONCILIATION_REQUIRED` si se cierra un `UNVERIFIED` sin actor ni motivo.
+     * @throws `404 WELCOME_BONUS_NOT_FOUND` si ese cliente no tiene ese asiento.
+     * @throws `400 WELCOME_BONUS_KEY_INVALID` si el `bonusKey` no decodifica (bug del caller).
      */
-    markWelcomeAccredited(customerId: string, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
+    setWelcomeAccreditationResult(customerId: string, payload: WelcomeAccreditationResultRequest, tenantId: string): Promise<StandardResponse<WelcomeBonusResponse>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.32.1",
+  "version": "5.33.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.316.0",
+    "@fiado/type-kit": "^3.319.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {
@@ -53,4 +53,4 @@
     "ts-jest": "^29.4.11",
     "typescript": "^6.0.3"
   }
-}
+}

package/src/retailCustomer/api/RetailCustomerBusinessApi.ts

@@ -5,11 +5,15 @@ import {
     UpsertCustomerFromKycRequest,
     AccountResultRequest,
     CustomerResponse,
+    WelcomeAccreditationRequest,
+    WelcomeAccreditationResponse,
+    WelcomeAccreditationResultRequest,
+    WelcomeBonusResponse,
 } from "@fiado/type-kit/bin/retailCustomer/index.js";
 import { IRetailCustomerBusinessApi } from "./interfaces/IRetailCustomerBusinessApi.js";
 
 /**
- * Publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail) para sus 5
+ * Publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail) para sus 6
  * endpoints privados de cliente. Contrato y semántica completos → `IRetailCustomerBusinessApi`.
  *
  * Los paths y el `?tenantId=` matchean `openapi/private.yaml` del lambda destino (mismo patrón que
@@ -64,9 +68,19 @@ export default class RetailCustomerBusinessApi implements IRetailCustomerBusines
     async markWelcomeAccredited(
         customerId: string,
         tenantId: string,
-    ): Promise<StandardResponse<CustomerResponse>> {
+        payload?: WelcomeAccreditationRequest,
+    ): Promise<StandardResponse<WelcomeAccreditationResponse>> {
         const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/welcome-accreditation?tenantId=${encodeURIComponent(tenantId)}`;
-        // Sin body: el cliente va en el path y el actor lo pone el destino desde el contexto privado.
-        return await this.httpRequest.post(url, {});
+        // Body opcional: el actor lo pone el destino desde el contexto privado, no viaja en el payload.
+        return await this.httpRequest.post(url, payload ?? {});
+    }
+
+    async setWelcomeAccreditationResult(
+        customerId: string,
+        payload: WelcomeAccreditationResultRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<WelcomeBonusResponse>> {
+        const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/welcome-accreditation/result?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.put(url, payload);
     }
 }

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

@@ -3,18 +3,22 @@ import {
     UpsertCustomerFromKycRequest,
     AccountResultRequest,
     CustomerResponse,
+    WelcomeAccreditationRequest,
+    WelcomeAccreditationResponse,
+    WelcomeAccreditationResultRequest,
+    WelcomeBonusResponse,
 } from "@fiado/type-kit/bin/retailCustomer/index.js";
 
 /**
  * Contrato del publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail)
- * para sus 5 endpoints privados de cliente (service-to-service, VPC-only).
+ * para sus 6 endpoints privados de cliente (service-to-service, VPC-only).
  *
  * Consumidor previsto:
  *   - `retail-wizard-business` → upsert del cliente post-KYC, aterrizaje del resultado de apertura
  *     de cuenta (D35), y lecturas del cliente por teléfono / id durante la saga de venta.
  *
  * ─────────────────────────────────────────────────────────────────────────────
- * `tenantId` es OBLIGATORIO en los 5 métodos — no es un detalle de firma.
+ * `tenantId` es OBLIGATORIO en los 6 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
@@ -97,7 +101,7 @@ export interface IRetailCustomerBusinessApi {
 
     /**
      * POST /private/customers/{customerId}/welcome-accreditation?tenantId= — RESERVA la acreditación
-     * del bono de bienvenida (D33). Sin body: el cliente va en el path, el actor lo pone el destino.
+     * del bono de bienvenida (D33) y abre su asiento en el libro de bonos.
      *
      * ⚠️ Reserva, NO acredita. El lambda destino es dueño del flag `welcomeAccredited` y su transición
      * `false → true` es el candado de idempotencia PERMANENTE por cliente (una sola vez para siempre,
@@ -105,14 +109,44 @@ export interface IRetailCustomerBusinessApi {
      * concurrentes NO pueden ganar los dos.
      *
      * Orden obligatorio en el caller: reservar acá PRIMERO, mover plata en el processor DESPUÉS. Al
-     * revés, un doble click acredita dos veces plata real.
+     * revés, un doble click acredita dos veces plata real. Después de mover plata, CERRAR el asiento
+     * con `setWelcomeAccreditationResult` — si no, el bono queda `PENDING` para siempre.
+     *
+     * El `payload` con los datos de la venta es OPCIONAL: sin él el asiento nace incompleto (tienda
+     * `UNKNOWN`) pero nace. La respuesta trae `bonus.bonusKey`, que es lo que pide el cierre.
      *
      * @throws `409 WELCOME_ALREADY_ACCREDITED` si el bono ya se entregó. Para el caller NO es falla:
      *   es la señal de "no acredites" — la venta sigue su curso normal.
      * @throws `404 CUSTOMER_NOT_FOUND` si el cliente no existe.
+     * @throws `400 VALIDATION_ERROR` si el payload viene mal formado.
      */
     markWelcomeAccredited(
         customerId: string,
         tenantId: string,
-    ): Promise<StandardResponse<CustomerResponse>>;
+        payload?: WelcomeAccreditationRequest,
+    ): Promise<StandardResponse<WelcomeAccreditationResponse>>;
+
+    /**
+     * PUT /private/customers/{customerId}/welcome-accreditation/result?tenantId= — cierra el asiento
+     * con el resultado del processor (D33). El `bonusKey` sale de la respuesta de la reserva.
+     *
+     * `ACCREDITED` cierra con `processorTransactionId`. `FAILED` es un rechazo INEQUÍVOCO y libera el
+     * candado para que la venta se reintente. `UNVERIFIED` es un fallo AMBIGUO (timeout, 5xx) y lo
+     * deja tomado: el `walletFundingCredit` del processor no deduplica, así que liberarlo podría
+     * acreditar plata real dos veces. Un timeout se asienta `UNVERIFIED`, nunca `FAILED`.
+     *
+     * Reintentar el MISMO resultado es idempotente (200). Un asiento `UNVERIFIED` se cierra después
+     * con `ACCREDITED`/`FAILED` mandando además `reconciledBy` y `reconciliationReason`.
+     *
+     * @throws `409 WELCOME_BONUS_ALREADY_RESOLVED` si ya cerró con OTRO resultado: no reintentar,
+     *   escalar — pisarlo borraría lo que de verdad pasó con la plata.
+     * @throws `422 WELCOME_BONUS_RECONCILIATION_REQUIRED` si se cierra un `UNVERIFIED` sin actor ni motivo.
+     * @throws `404 WELCOME_BONUS_NOT_FOUND` si ese cliente no tiene ese asiento.
+     * @throws `400 WELCOME_BONUS_KEY_INVALID` si el `bonusKey` no decodifica (bug del caller).
+     */
+    setWelcomeAccreditationResult(
+        customerId: string,
+        payload: WelcomeAccreditationResultRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<WelcomeBonusResponse>>;
 }