@fiado/api-invoker 5.107.0 → 5.109.0

package/bin/cognitoConnector/CognitoConnectorApi.d.ts

@@ -1,6 +1,6 @@
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { GetUserRequest, GetUserResponse, RefreshTokenRequest, RefreshTokenResponse, RespondToAuthChallengeRequest, SetPasswordRequest, SignInRequest, SignInResponse, SignUpConfirmRequest, SignUpRequest, SignUpResponse } from "@fiado/type-kit/bin/cognitoConnector/index.js";
-import { ICognitoConnectorApi } from "./interfaces/ICognitoConnectorApi.js";
+import type { CognitoUpdatePhoneNumberRequest, ICognitoConnectorApi } from "./interfaces/ICognitoConnectorApi.js";
 import { TypeOfDirectoryId } from "@fiado/type-kit/bin/directory/index.js";
 export default class CognitoConnectorApi implements ICognitoConnectorApi {
     private httpRequest;
@@ -15,4 +15,10 @@ export default class CognitoConnectorApi implements ICognitoConnectorApi {
     changePassword(input: SetPasswordRequest): Promise<void>;
     respondToNewPasswordChallenge(input: RespondToAuthChallengeRequest): Promise<SignInResponse>;
     resetPassword(username: string, typeOfDirectoryId: string): Promise<void>;
+    /**
+     * Cambia el phone_number de un usuario (PUT cognito/user del conector). Mismo contrato que
+     * CognitoAdapter.updateAttribute de fiado-directory-lambda: `username` es el identityId del usuario
+     * o, si no lo tiene, su teléfono actual.
+     */
+    updatePhoneNumber(input: CognitoUpdatePhoneNumberRequest): Promise<void>;
 }

package/bin/cognitoConnector/CognitoConnectorApi.js

@@ -84,6 +84,14 @@ let CognitoConnectorApi = class CognitoConnectorApi {
         const url = `${this.baseUrl}cognito/resetPassword`;
         return await this.httpRequest.post(url, { username, typeOfDirectoryId }, { operationName: "postConnectorCognitoResetPassword" });
     }
+    /**
+     * Cambia el phone_number de un usuario (PUT cognito/user del conector). Mismo contrato que
+     * CognitoAdapter.updateAttribute de fiado-directory-lambda: `username` es el identityId del usuario
+     * o, si no lo tiene, su teléfono actual.
+     */
+    async updatePhoneNumber(input) {
+        await this.httpRequest.put(`${this.baseUrl}cognito/user`, input);
+    }
 };
 CognitoConnectorApi = __decorate([
     injectable(),

package/bin/cognitoConnector/interfaces/ICognitoConnectorApi.d.ts

@@ -1,5 +1,11 @@
 import { GetUserRequest, GetUserResponse, RefreshTokenRequest, RefreshTokenResponse, RespondToAuthChallengeRequest, SetPasswordRequest, SignInRequest, SignInResponse, SignUpConfirmRequest, SignUpRequest, SignUpResponse } from "@fiado/type-kit/bin/cognitoConnector/index.js";
 import { TypeOfDirectoryId } from "@fiado/type-kit/bin/directory/index.js";
+/** Body de PUT cognito/user: `username` es el identityId o, si no hay, el teléfono actual. */
+export interface CognitoUpdatePhoneNumberRequest {
+    username: string;
+    phoneNumber: string;
+    typeOfDirectoryId: TypeOfDirectoryId;
+}
 export interface ICognitoConnectorApi {
     signUp(input: SignUpRequest): Promise<SignUpResponse>;
     signIn(input: SignInRequest): Promise<SignInResponse>;
@@ -10,4 +16,5 @@ export interface ICognitoConnectorApi {
     respondToNewPasswordChallenge(input: RespondToAuthChallengeRequest): Promise<SignInResponse>;
     resetPassword(username: string, typeOfDirectoryId: TypeOfDirectoryId): Promise<void>;
     deleteCognitoUser(identityId: string, typeOfDirectoryId?: TypeOfDirectoryId): Promise<void>;
+    updatePhoneNumber(input: CognitoUpdatePhoneNumberRequest): Promise<void>;
 }

package/bin/fiadoMessages/api/FiadoMessagesApi.d.ts

@@ -1,8 +1,10 @@
-import { IHttpRequest } from "@fiado/http-client";
-import { IFiadoMessagesApi } from "./interfaces/IFiadoMessagesApi.js";
+import type { IHttpRequest } from "@fiado/http-client";
+import type { IFiadoMessagesApi, SendMessageRequest } from "./interfaces/IFiadoMessagesApi.js";
 export declare class FiadoMessagesApi implements IFiadoMessagesApi {
     private httpRequest;
     private readonly baseUrl;
     constructor(httpRequest: IHttpRequest);
     getValidatedOtpByDirectoryIdAndOtpCode(directoryId: string, otpCode: string): Promise<any>;
+    /** Envía un mensaje (SMS, etc.) por fiado-messages-lambda. Mismo contrato que MessageAdapter.sendSMS de fiado-directory-lambda. */
+    sendMessage(message: SendMessageRequest): Promise<any>;
 }

package/bin/fiadoMessages/api/FiadoMessagesApi.js

@@ -26,6 +26,10 @@ let FiadoMessagesApi = class FiadoMessagesApi {
         };
         return await this.httpRequest.post(`${url}`, request, { 'operationName': operationName });
     }
+    /** Envía un mensaje (SMS, etc.) por fiado-messages-lambda. Mismo contrato que MessageAdapter.sendSMS de fiado-directory-lambda. */
+    async sendMessage(message) {
+        return await this.httpRequest.post(this.baseUrl, message, { operationName: "postSendMessage", app: "USERS_APP" });
+    }
 };
 FiadoMessagesApi = __decorate([
     injectable(),

package/bin/fiadoMessages/api/interfaces/IFiadoMessagesApi.d.ts

@@ -1,3 +1,24 @@
+/** Body de postSendMessage en fiado-messages-lambda (NotificationPush de los lambdas legacy). */
+export interface SendMessageRequest {
+    messageType: string;
+    channelType: string;
+    directoryId: string | null;
+    typeOfDirectory: string | null;
+    destination: string;
+    language: string;
+    referenceMessageId: string | null;
+    country: string;
+    beneficiaryDirectoryId: string | null;
+    beneficiaryTypeOfDirectoryId: string | null;
+    status: string;
+    transactionNumber: string;
+    var1: unknown;
+    var2: unknown;
+    var3: unknown;
+    var4: unknown;
+    options: unknown;
+}
 export interface IFiadoMessagesApi {
     getValidatedOtpByDirectoryIdAndOtpCode(directoryId: string, otpCode: string): Promise<any>;
+    sendMessage(message: SendMessageRequest): Promise<any>;
 }

package/bin/file-storage/FileStorageApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import type { UserDocumentItem } from "@fiado/type-kit/bin/fileStorage/index.js";
-import type { IFileStorageApi } from "./interfaces/IFileStorageApi.js";
+import type { IFileStorageApi, SaveFilesRequest } from "./interfaces/IFileStorageApi.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 export declare class FileStorageApi implements IFileStorageApi {
     private readonly httpRequest;
@@ -11,5 +11,6 @@ export declare class FileStorageApi implements IFileStorageApi {
     getUserDocumentSignUrl(key: string): Promise<FiadoApiResponse<{
         url: string;
     }>>;
+    saveFiles(request: SaveFilesRequest): Promise<FiadoApiResponse<unknown>>;
 }
 export {};

package/bin/file-storage/FileStorageApi.js

@@ -37,6 +37,12 @@ let FileStorageApi = class FileStorageApi {
         }
         return await this.httpRequest.post(this.baseUrl, { key }, { operationName: "getUserDocumentSignUrl" });
     }
+    async saveFiles(request) {
+        if (!request?.path || !request.files?.length) {
+            throw new Error("path and at least one file are required.");
+        }
+        return await this.httpRequest.post(this.baseUrl, request, { operationName: "postDocumentCheck" });
+    }
 };
 FileStorageApi = __decorate([
     injectable(),

package/bin/file-storage/interfaces/IFileStorageApi.d.ts

@@ -4,6 +4,14 @@ type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApi
  * Cliente de fiado-s3-lambda (documentos de usuario en S3). Una sola ruta POST; la operación viaja en el
  * header `operationName`. Mismo contrato que consumía el S3Adapter de fiado-identity-lambda.
  */
+/** Archivos en base64 (sin el prefijo `data:...;base64,`) a guardar bajo `path`, p. ej. `USER/{directoryId}`. */
+export interface SaveFilesRequest {
+    path: string;
+    files: Array<{
+        fileName: string;
+        content: string;
+    }>;
+}
 export interface IFileStorageApi {
     /** Lista los objetos bajo un prefijo, p. ej. `USER/{directoryId}`. Devuelve key completa, lastModified, sizeKb y url firmada. */
     listDirectoryDocuments(directory: string): Promise<FiadoApiResponse<UserDocumentItem[]>>;
@@ -13,5 +21,7 @@ export interface IFileStorageApi {
     getUserDocumentSignUrl(key: string): Promise<FiadoApiResponse<{
         url: string;
     }>>;
+    /** Guarda archivos (operación postDocumentCheck). Mismo contrato que DocumentAdapter.saveFileToS3 de fiado-directory-lambda. */
+    saveFiles(request: SaveFilesRequest): Promise<FiadoApiResponse<unknown>>;
 }
 export {};

package/bin/onboarding/api/OnboardingApi.d.ts

@@ -9,4 +9,6 @@ export default class OnboardingApi implements IOnboardingApi {
     getOnboardingSteps(directoryId: string, countryId: string): Promise<OnboardingStepsEnvelope>;
     /** Onboardings por lote de fiado-onboarding-lambda (GET ids?directoryId=...). Lo usa la actividad diaria del backoffice. */
     getByIds(directoryIds: string[]): Promise<any>;
+    /** Cambia el teléfono del onboarding (PUT raíz de fiado-onboarding-lambda). Lo usa el cambio de teléfono del backoffice. */
+    updatePhoneNumber(directoryId: string, phoneNumber: string): Promise<any>;
 }

package/bin/onboarding/api/OnboardingApi.js

@@ -37,6 +37,10 @@ let OnboardingApi = class OnboardingApi {
         const query = directoryIds.map((id) => `directoryId=${encodeURIComponent(id)}`).join("&");
         return await this.httpRequest.get(`${this.baseUrl}ids?${query}`);
     }
+    /** Cambia el teléfono del onboarding (PUT raíz de fiado-onboarding-lambda). Lo usa el cambio de teléfono del backoffice. */
+    async updatePhoneNumber(directoryId, phoneNumber) {
+        return await this.httpRequest.put(this.baseUrl, { directoryId, phoneNumber });
+    }
 };
 OnboardingApi = __decorate([
     injectable(),

package/bin/onboarding/api/interfaces/IOnboardingApi.d.ts

@@ -12,4 +12,6 @@ export interface IOnboardingApi {
     getOnboardingSteps(directoryId: string, countryId: string): Promise<OnboardingStepsEnvelope>;
     /** Onboardings por lote (envelope con data: onboarding[] con id = directoryId y referralCode). */
     getByIds(directoryIds: string[]): Promise<any>;
+    /** PUT raíz de fiado-onboarding-lambda con {directoryId, phoneNumber}. */
+    updatePhoneNumber(directoryId: string, phoneNumber: string): Promise<any>;
 }

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.107.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/cognitoConnector/CognitoConnectorApi.ts

@@ -1,7 +1,7 @@
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { GetUserRequest, GetUserResponse, RefreshTokenRequest, RefreshTokenResponse, RespondToAuthChallengeRequest, SetPasswordRequest, SignInRequest, SignInResponse, SignUpConfirmRequest, SignUpRequest, SignUpResponse } from "@fiado/type-kit/bin/cognitoConnector/index.js";
 import { inject, injectable } from "inversify";
-import { ICognitoConnectorApi } from "./interfaces/ICognitoConnectorApi.js";
+import type { CognitoUpdatePhoneNumberRequest, ICognitoConnectorApi } from "./interfaces/ICognitoConnectorApi.js";
 import { TypeOfDirectoryId } from "@fiado/type-kit/bin/directory/index.js";
 
 @injectable()
@@ -107,6 +107,13 @@ export default class CognitoConnectorApi implements ICognitoConnectorApi {
         const url = `${this.baseUrl}cognito/resetPassword`;
         return await this.httpRequest.post(url, { username, typeOfDirectoryId }, { operationName: "postConnectorCognitoResetPassword" });
     }
-}
-
 
+    /**
+     * Cambia el phone_number de un usuario (PUT cognito/user del conector). Mismo contrato que
+     * CognitoAdapter.updateAttribute de fiado-directory-lambda: `username` es el identityId del usuario
+     * o, si no lo tiene, su teléfono actual.
+     */
+    async updatePhoneNumber(input: CognitoUpdatePhoneNumberRequest): Promise<void> {
+        await this.httpRequest.put(`${this.baseUrl}cognito/user`, input);
+    }
+}

package/src/cognitoConnector/interfaces/ICognitoConnectorApi.ts

@@ -3,6 +3,13 @@ import { TypeOfDirectoryId } from "@fiado/type-kit/bin/directory/index.js";
 
 
 
+/** Body de PUT cognito/user: `username` es el identityId o, si no hay, el teléfono actual. */
+export interface CognitoUpdatePhoneNumberRequest {
+    username: string;
+    phoneNumber: string;
+    typeOfDirectoryId: TypeOfDirectoryId;
+}
+
 export interface ICognitoConnectorApi {
 
     signUp(input: SignUpRequest): Promise<SignUpResponse>;
@@ -14,4 +21,5 @@ export interface ICognitoConnectorApi {
     respondToNewPasswordChallenge(input: RespondToAuthChallengeRequest): Promise<SignInResponse>;
     resetPassword(username: string, typeOfDirectoryId: TypeOfDirectoryId): Promise<void>;
     deleteCognitoUser(identityId: string, typeOfDirectoryId?: TypeOfDirectoryId): Promise<void>;
+    updatePhoneNumber(input: CognitoUpdatePhoneNumberRequest): Promise<void>;
 }

package/src/fiadoMessages/api/FiadoMessagesApi.ts

@@ -1,6 +1,6 @@
 import {inject, injectable} from "inversify";
-import {IHttpRequest} from "@fiado/http-client";
-import {IFiadoMessagesApi} from "./interfaces/IFiadoMessagesApi.js";
+import type {IHttpRequest} from "@fiado/http-client";
+import type {IFiadoMessagesApi, SendMessageRequest} from "./interfaces/IFiadoMessagesApi.js";
 
 @injectable()
 export class FiadoMessagesApi implements IFiadoMessagesApi {
@@ -18,4 +18,9 @@ export class FiadoMessagesApi implements IFiadoMessagesApi {
         };
         return await this.httpRequest.post(`${url}`, request, {'operationName': operationName});
     }
-}
+
+    /** Envía un mensaje (SMS, etc.) por fiado-messages-lambda. Mismo contrato que MessageAdapter.sendSMS de fiado-directory-lambda. */
+    async sendMessage(message: SendMessageRequest): Promise<any> {
+        return await this.httpRequest.post(this.baseUrl, message, { operationName: "postSendMessage", app: "USERS_APP" });
+    }
+}

package/src/fiadoMessages/api/interfaces/IFiadoMessagesApi.ts

@@ -1,3 +1,25 @@
+/** Body de postSendMessage en fiado-messages-lambda (NotificationPush de los lambdas legacy). */
+export interface SendMessageRequest {
+    messageType: string;
+    channelType: string;
+    directoryId: string | null;
+    typeOfDirectory: string | null;
+    destination: string;
+    language: string;
+    referenceMessageId: string | null;
+    country: string;
+    beneficiaryDirectoryId: string | null;
+    beneficiaryTypeOfDirectoryId: string | null;
+    status: string;
+    transactionNumber: string;
+    var1: unknown;
+    var2: unknown;
+    var3: unknown;
+    var4: unknown;
+    options: unknown;
+}
+
 export interface IFiadoMessagesApi {
     getValidatedOtpByDirectoryIdAndOtpCode(directoryId: string, otpCode: string): Promise<any>;
-}
+    sendMessage(message: SendMessageRequest): Promise<any>;
+}

package/src/file-storage/FileStorageApi.ts

@@ -2,7 +2,7 @@ import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
 import dotenv from "dotenv";
 import type { UserDocumentItem } from "@fiado/type-kit/bin/fileStorage/index.js";
-import type { IFileStorageApi } from "./interfaces/IFileStorageApi.js";
+import type { IFileStorageApi, SaveFilesRequest } from "./interfaces/IFileStorageApi.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 
 dotenv.config();
@@ -40,4 +40,13 @@ export class FileStorageApi implements IFileStorageApi {
             this.baseUrl, { key }, { operationName: "getUserDocumentSignUrl" },
         );
     }
+
+    async saveFiles(request: SaveFilesRequest): Promise<FiadoApiResponse<unknown>> {
+        if (!request?.path || !request.files?.length) {
+            throw new Error("path and at least one file are required.");
+        }
+        return await this.httpRequest.post<FiadoApiResponse<unknown>>(
+            this.baseUrl, request, { operationName: "postDocumentCheck" },
+        );
+    }
 }

package/src/file-storage/interfaces/IFileStorageApi.ts

@@ -5,6 +5,12 @@ type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApi
  * Cliente de fiado-s3-lambda (documentos de usuario en S3). Una sola ruta POST; la operación viaja en el
  * header `operationName`. Mismo contrato que consumía el S3Adapter de fiado-identity-lambda.
  */
+/** Archivos en base64 (sin el prefijo `data:...;base64,`) a guardar bajo `path`, p. ej. `USER/{directoryId}`. */
+export interface SaveFilesRequest {
+    path: string;
+    files: Array<{ fileName: string; content: string }>;
+}
+
 export interface IFileStorageApi {
     /** Lista los objetos bajo un prefijo, p. ej. `USER/{directoryId}`. Devuelve key completa, lastModified, sizeKb y url firmada. */
     listDirectoryDocuments(directory: string): Promise<FiadoApiResponse<UserDocumentItem[]>>;
@@ -12,4 +18,6 @@ export interface IFileStorageApi {
     deleteUserDocument(fileName: string): Promise<FiadoApiResponse<void>>;
     /** URL firmada de lectura para una key completa. */
     getUserDocumentSignUrl(key: string): Promise<FiadoApiResponse<{ url: string }>>;
+    /** Guarda archivos (operación postDocumentCheck). Mismo contrato que DocumentAdapter.saveFileToS3 de fiado-directory-lambda. */
+    saveFiles(request: SaveFilesRequest): Promise<FiadoApiResponse<unknown>>;
 }

package/src/onboarding/api/OnboardingApi.ts

@@ -33,4 +33,9 @@ export default class OnboardingApi implements IOnboardingApi {
         const query = directoryIds.map((id) => `directoryId=${encodeURIComponent(id)}`).join("&");
         return await this.httpRequest.get(`${this.baseUrl}ids?${query}`);
     }
+
+    /** Cambia el teléfono del onboarding (PUT raíz de fiado-onboarding-lambda). Lo usa el cambio de teléfono del backoffice. */
+    async updatePhoneNumber(directoryId: string, phoneNumber: string): Promise<any> {
+        return await this.httpRequest.put(this.baseUrl, { directoryId, phoneNumber });
+    }
 }

package/src/onboarding/api/interfaces/IOnboardingApi.ts

@@ -14,5 +14,7 @@ export interface IOnboardingApi {
 
     /** Onboardings por lote (envelope con data: onboarding[] con id = directoryId y referralCode). */
     getByIds(directoryIds: string[]): Promise<any>;
+    /** PUT raíz de fiado-onboarding-lambda con {directoryId, phoneNumber}. */
+    updatePhoneNumber(directoryId: string, phoneNumber: string): Promise<any>;
 
 }

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.