@fiado/api-invoker 4.77.0 → 4.78.0

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

@@ -3,7 +3,7 @@ import { StandardResponse } from "@fiado/gateway-adapter";
 import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse } 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 4
+ * Publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail) para sus 5
  * 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,4 +24,5 @@ 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>>;
 }

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 4
+ * Publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail) para sus 5
  * 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,6 +47,11 @@ 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) {
+        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, {});
+    }
 };
 RetailCustomerBusinessApi = __decorate([
     injectable(),

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

@@ -2,14 +2,14 @@ import { StandardResponse } from "@fiado/gateway-adapter";
 import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
 /**
  * Contrato del publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail)
- * para sus 4 endpoints privados de cliente (service-to-service, VPC-only).
+ * para sus 5 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 4 métodos — no es un detalle de firma.
+ * `tenantId` es OBLIGATORIO en los 5 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
@@ -73,4 +73,21 @@ export interface IRetailCustomerBusinessApi {
      * @throws si el cliente no existe (`404 CUSTOMER_NOT_FOUND`).
      */
     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.
+     *
+     * ⚠️ 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,
+     * ni una segunda venta la repite). La condición vive en la transacción DDB, así que dos requests
+     * 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.
+     *
+     * @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.
+     */
+    markWelcomeAccredited(customerId: string, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "4.77.0",
+  "version": "4.78.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",

package/src/retailCustomer/api/RetailCustomerBusinessApi.ts

@@ -9,7 +9,7 @@ import {
 import { IRetailCustomerBusinessApi } from "./interfaces/IRetailCustomerBusinessApi.js";
 
 /**
- * Publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail) para sus 4
+ * Publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail) para sus 5
  * 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
@@ -60,4 +60,13 @@ export default class RetailCustomerBusinessApi implements IRetailCustomerBusines
         const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.get(url);
     }
+
+    async markWelcomeAccredited(
+        customerId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<CustomerResponse>> {
+        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, {});
+    }
 }

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

@@ -7,14 +7,14 @@ import {
 
 /**
  * Contrato del publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail)
- * para sus 4 endpoints privados de cliente (service-to-service, VPC-only).
+ * para sus 5 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 4 métodos — no es un detalle de firma.
+ * `tenantId` es OBLIGATORIO en los 5 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
@@ -94,4 +94,25 @@ export interface IRetailCustomerBusinessApi {
         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.
+     *
+     * ⚠️ 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,
+     * ni una segunda venta la repite). La condición vive en la transacción DDB, así que dos requests
+     * 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.
+     *
+     * @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.
+     */
+    markWelcomeAccredited(
+        customerId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<CustomerResponse>>;
 }