@fiado/api-invoker 4.57.0 → 4.59.0

package/src/remittance-business/api/interfaces/IRemittanceBusinessApi.ts

@@ -1,12 +1,16 @@
-import { ApiGatewayResponse } from "@fiado/gateway-adapter";
-import {
-    PricingResolveRequest,
-    PricingResolveResponse,
-    RemittanceCountryCarouselItem,
-} from "@fiado/type-kit/bin/remittance/index.js";
-
-export interface IRemittanceBusinessApi {
-    pricingResolve(request: PricingResolveRequest): Promise<ApiGatewayResponse<PricingResolveResponse>>;
-    /** Carrusel de países (enabled-only, ya ordenado) para la app. GET /private/countries/carousel. */
-    getCountryCarousel(): Promise<ApiGatewayResponse<RemittanceCountryCarouselItem[]>>;
-}
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import {
+    PricingResolveRequest,
+    PricingResolveResponse,
+    PricingScheduleRequest,
+    PricingScheduleResponse,
+    RemittanceCountryCarouselItem,
+} from "@fiado/type-kit/bin/remittance/index.js";
+
+export interface IRemittanceBusinessApi {
+    pricingResolve(request: PricingResolveRequest): Promise<ApiGatewayResponse<PricingResolveResponse>>;
+    /** Schedule de tramos de service fee + promo automática por corredor (F2 app). POST /private/pricing/schedule. */
+    pricingSchedule(request: PricingScheduleRequest): Promise<ApiGatewayResponse<PricingScheduleResponse>>;
+    /** Carrusel de países (enabled-only, ya ordenado) para la app. GET /private/countries/carousel. */
+    getCountryCarousel(): Promise<ApiGatewayResponse<RemittanceCountryCarouselItem[]>>;
+}

package/src/remittance-business/index.ts

@@ -1,2 +1,2 @@
-export * from "./api/interfaces/IRemittanceBusinessApi.js";
-export { default as RemittanceBusinessApi } from "./api/RemittanceBusinessApi.js";
+export * from "./api/interfaces/IRemittanceBusinessApi.js";
+export { default as RemittanceBusinessApi } from "./api/RemittanceBusinessApi.js";

package/src/report-processor-business/api/IReportProcessorBusinessApi.ts

@@ -1,5 +1,5 @@
-
-
-export interface IReportProcessorBusinessApi {
-    processReports(key: string): Promise<{ url: string, expiresInSeconds: number }>;
+
+
+export interface IReportProcessorBusinessApi {
+    processReports(key: string): Promise<{ url: string, expiresInSeconds: number }>;
 }

package/src/report-processor-business/api/ReportProcessorBusinessApi.ts

@@ -1,18 +1,18 @@
-import { IHttpRequest } from "@fiado/http-client";
-import { inject, injectable } from "inversify";
-import { IReportProcessorBusinessApi } from "./IReportProcessorBusinessApi.js";
-
-@injectable()
-export default class ReportProcessorBusinessApi implements IReportProcessorBusinessApi {
-
-    private readonly baseUrl = process.env.REPORT_PROCESSOR_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
-    }
-    async processReports(key: string): Promise<{ url: string, expiresInSeconds: number }> {
-
-        const url = `${this.baseUrl}/report-link?key=${key}`;
-
-        return await this.httpRequest.get<{ url: string, expiresInSeconds: number }>(url);
-    }
+import { IHttpRequest } from "@fiado/http-client";
+import { inject, injectable } from "inversify";
+import { IReportProcessorBusinessApi } from "./IReportProcessorBusinessApi.js";
+
+@injectable()
+export default class ReportProcessorBusinessApi implements IReportProcessorBusinessApi {
+
+    private readonly baseUrl = process.env.REPORT_PROCESSOR_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+    async processReports(key: string): Promise<{ url: string, expiresInSeconds: number }> {
+
+        const url = `${this.baseUrl}/report-link?key=${key}`;
+
+        return await this.httpRequest.get<{ url: string, expiresInSeconds: number }>(url);
+    }
 }

package/src/report-processor-business/index.ts

@@ -1,5 +1,5 @@
-
-
-export * from './api/ReportProcessorBusinessApi.js';
-export * from './api/IReportProcessorBusinessApi.js';
-
+
+
+export * from './api/ReportProcessorBusinessApi.js';
+export * from './api/IReportProcessorBusinessApi.js';
+

package/src/riskProfile/api/RiskProfileApi.ts

@@ -1,89 +1,89 @@
-import {IRiskProfileApi} from "./interfaces/IRiskProfileApi.js";
-import {inject, injectable} from "inversify";
-import {IHttpRequest} from "@fiado/http-client";
-import {CreatePrivateAlarm, CreateRiskProfileRequest} from "@fiado/type-kit/bin/riskProfile/index.js";
-type UpdateRiskProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateRiskProfileRequest.js").default;
-type UpdateAlarmProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateAlarmProfileRequest.js").default;
-import { ResponseOptions } from "@fiado/gateway-adapter";
-import {
-    SetCustomAlarmRequest,
-    SetCustomAlarmResponse,
-    SetDeclaredIncomeRequest,
-    SetDeclaredIncomeResponse,
-    SetManualRiskLevelRequest,
-    SetManualRiskLevelResponse,
-    CreateClientFinancialHistoryRequest,
-    ClientFinancialHistoryResponse,
-    ListClientFinancialHistoryResponse,
-} from "@fiado/type-kit/bin/riskProfile/index.js";
-
-@injectable()
-export default class RiskProfileApi implements IRiskProfileApi {
-    private readonly baseUrl = process.env.RISK_PROFILE_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
-    }
-
-    async createRiskProfile(request: CreateRiskProfileRequest): Promise<any> {
-        const url = `${this.baseUrl}/profiles`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async updateRiskProfile(request: UpdateRiskProfileRequest): Promise<any> {
-        const url = `${this.baseUrl}/profiles`;
-        return await this.httpRequest.put(url, request);
-    }
-
-    async updateAlarmProfile(request: UpdateAlarmProfileRequest): Promise<any> {
-        const url = `${this.baseUrl}/alarms`;
-        return await this.httpRequest.put(url, request);
-    }
-
-    async getRiskProfileByDirectoryId(directoryId: string): Promise<any> {
-        const url = `${this.baseUrl}/profiles/directories/${directoryId}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async createAlarm(params: CreatePrivateAlarm): Promise<any> {
-        const url = `${this.baseUrl}/alarms/create`;
-        return await this.httpRequest.post(url,params);
-    }
-
-    async setManualRiskLevel(directoryId: string, request: SetManualRiskLevelRequest): Promise<ResponseOptions<SetManualRiskLevelResponse>> {
-        const url = `${this.baseUrl}/profiles/${directoryId}/manual-risk`;
-        return await this.httpRequest.put(url, request);
-    }
-
-    async setCustomAlarm(directoryId: string, request: SetCustomAlarmRequest): Promise<ResponseOptions<SetCustomAlarmResponse>> {
-        const url = `${this.baseUrl}/profiles/${directoryId}/custom-alarm`;
-        return await this.httpRequest.put(url, request);
-    }
-
-    async setDeclaredIncome(directoryId: string, request: SetDeclaredIncomeRequest): Promise<ResponseOptions<SetDeclaredIncomeResponse>> {
-        const url = `${this.baseUrl}/profiles/${directoryId}/declared-income`;
-        return await this.httpRequest.put(url, request);
-    }
-
-    /**
-     * Registra un cambio en el historial financiero del perfil (BO-03).
-     * Endpoint: `POST /profiles/{directoryId}/financial-history`
-     */
-    async createClientFinancialHistory(directoryId: string, request: CreateClientFinancialHistoryRequest): Promise<ResponseOptions<ClientFinancialHistoryResponse>> {
-        const url = `${this.baseUrl}/profiles/${directoryId}/financial-history`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    /**
-     * Lista el historial financiero del perfil, cronológico descendente, paginado.
-     * Endpoint: `GET /profiles/{directoryId}/financial-history?limit=&continuationToken=`
-     */
-    async listClientFinancialHistory(directoryId: string, params?: { limit?: number; continuationToken?: string }): Promise<ResponseOptions<ListClientFinancialHistoryResponse>> {
-        const query: string[] = [];
-        if (params?.limit !== undefined) query.push(`limit=${params.limit}`);
-        if (params?.continuationToken) query.push(`continuationToken=${encodeURIComponent(params.continuationToken)}`);
-        const qs = query.length ? `?${query.join("&")}` : "";
-        const url = `${this.baseUrl}/profiles/${directoryId}/financial-history${qs}`;
-        return await this.httpRequest.get(url);
-    }
-
+import {IRiskProfileApi} from "./interfaces/IRiskProfileApi.js";
+import {inject, injectable} from "inversify";
+import {IHttpRequest} from "@fiado/http-client";
+import {CreatePrivateAlarm, CreateRiskProfileRequest} from "@fiado/type-kit/bin/riskProfile/index.js";
+type UpdateRiskProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateRiskProfileRequest.js").default;
+type UpdateAlarmProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateAlarmProfileRequest.js").default;
+import { ResponseOptions } from "@fiado/gateway-adapter";
+import {
+    SetCustomAlarmRequest,
+    SetCustomAlarmResponse,
+    SetDeclaredIncomeRequest,
+    SetDeclaredIncomeResponse,
+    SetManualRiskLevelRequest,
+    SetManualRiskLevelResponse,
+    CreateClientFinancialHistoryRequest,
+    ClientFinancialHistoryResponse,
+    ListClientFinancialHistoryResponse,
+} from "@fiado/type-kit/bin/riskProfile/index.js";
+
+@injectable()
+export default class RiskProfileApi implements IRiskProfileApi {
+    private readonly baseUrl = process.env.RISK_PROFILE_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    async createRiskProfile(request: CreateRiskProfileRequest): Promise<any> {
+        const url = `${this.baseUrl}/profiles`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async updateRiskProfile(request: UpdateRiskProfileRequest): Promise<any> {
+        const url = `${this.baseUrl}/profiles`;
+        return await this.httpRequest.put(url, request);
+    }
+
+    async updateAlarmProfile(request: UpdateAlarmProfileRequest): Promise<any> {
+        const url = `${this.baseUrl}/alarms`;
+        return await this.httpRequest.put(url, request);
+    }
+
+    async getRiskProfileByDirectoryId(directoryId: string): Promise<any> {
+        const url = `${this.baseUrl}/profiles/directories/${directoryId}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async createAlarm(params: CreatePrivateAlarm): Promise<any> {
+        const url = `${this.baseUrl}/alarms/create`;
+        return await this.httpRequest.post(url,params);
+    }
+
+    async setManualRiskLevel(directoryId: string, request: SetManualRiskLevelRequest): Promise<ResponseOptions<SetManualRiskLevelResponse>> {
+        const url = `${this.baseUrl}/profiles/${directoryId}/manual-risk`;
+        return await this.httpRequest.put(url, request);
+    }
+
+    async setCustomAlarm(directoryId: string, request: SetCustomAlarmRequest): Promise<ResponseOptions<SetCustomAlarmResponse>> {
+        const url = `${this.baseUrl}/profiles/${directoryId}/custom-alarm`;
+        return await this.httpRequest.put(url, request);
+    }
+
+    async setDeclaredIncome(directoryId: string, request: SetDeclaredIncomeRequest): Promise<ResponseOptions<SetDeclaredIncomeResponse>> {
+        const url = `${this.baseUrl}/profiles/${directoryId}/declared-income`;
+        return await this.httpRequest.put(url, request);
+    }
+
+    /**
+     * Registra un cambio en el historial financiero del perfil (BO-03).
+     * Endpoint: `POST /profiles/{directoryId}/financial-history`
+     */
+    async createClientFinancialHistory(directoryId: string, request: CreateClientFinancialHistoryRequest): Promise<ResponseOptions<ClientFinancialHistoryResponse>> {
+        const url = `${this.baseUrl}/profiles/${directoryId}/financial-history`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    /**
+     * Lista el historial financiero del perfil, cronológico descendente, paginado.
+     * Endpoint: `GET /profiles/{directoryId}/financial-history?limit=&continuationToken=`
+     */
+    async listClientFinancialHistory(directoryId: string, params?: { limit?: number; continuationToken?: string }): Promise<ResponseOptions<ListClientFinancialHistoryResponse>> {
+        const query: string[] = [];
+        if (params?.limit !== undefined) query.push(`limit=${params.limit}`);
+        if (params?.continuationToken) query.push(`continuationToken=${encodeURIComponent(params.continuationToken)}`);
+        const qs = query.length ? `?${query.join("&")}` : "";
+        const url = `${this.baseUrl}/profiles/${directoryId}/financial-history${qs}`;
+        return await this.httpRequest.get(url);
+    }
+
 }

package/src/riskProfile/api/TransactionAlertApi.ts

@@ -1,49 +1,49 @@
-import { inject, injectable } from "inversify";
-import { ITransactionAlertApi } from "./interfaces/ITransactionAlertApi.js";
-import { IHttpRequest } from "@fiado/http-client";
-import {
-    AlarmOperationType,
-    AppendAlertNoteRequest,
-    AppendAlertNoteResponse,
-    CreateBlockedListAlertRequest,
-    CreateBlockedListAlertResponse,
-    DictaminateAlertRequest,
-    DictaminateAlertResponse,
-    MarkAlertReportedRequest,
-    MarkAlertReportedResponse,
-    TransactionAlertResponse,
-} from "@fiado/type-kit/bin/riskProfile/index.js";
-import { ResponseOptions } from "@fiado/gateway-adapter";
-
-@injectable()
-export default class TransactionAlertApi implements ITransactionAlertApi {
-    private readonly baseUrl = process.env.RISK_PROFILE_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
-    }
-
-    async getAlerts(status: AlarmOperationType, reported: 1 | 0): Promise<ResponseOptions<{ items: TransactionAlertResponse[], lastKey: any }>> {
-        const url = `${this.baseUrl}/alarms?status=${status}&reported=${reported}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async dictaminateAlert(alertId: string, request: DictaminateAlertRequest): Promise<ResponseOptions<DictaminateAlertResponse>> {
-        const url = `${this.baseUrl}/alerts/${alertId}/dictamen`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async appendAlertNote(alertId: string, request: AppendAlertNoteRequest): Promise<ResponseOptions<AppendAlertNoteResponse>> {
-        const url = `${this.baseUrl}/alerts/${alertId}/notes`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async createBlockedListAlert(request: CreateBlockedListAlertRequest): Promise<ResponseOptions<CreateBlockedListAlertResponse>> {
-        const url = `${this.baseUrl}/alerts/blocked-list`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async markAlertReported(alertId: string, request: MarkAlertReportedRequest): Promise<ResponseOptions<MarkAlertReportedResponse>> {
-        const url = `${this.baseUrl}/alerts/${alertId}/reported`;
-        return await this.httpRequest.post(url, request);
-    }
-}
+import { inject, injectable } from "inversify";
+import { ITransactionAlertApi } from "./interfaces/ITransactionAlertApi.js";
+import { IHttpRequest } from "@fiado/http-client";
+import {
+    AlarmOperationType,
+    AppendAlertNoteRequest,
+    AppendAlertNoteResponse,
+    CreateBlockedListAlertRequest,
+    CreateBlockedListAlertResponse,
+    DictaminateAlertRequest,
+    DictaminateAlertResponse,
+    MarkAlertReportedRequest,
+    MarkAlertReportedResponse,
+    TransactionAlertResponse,
+} from "@fiado/type-kit/bin/riskProfile/index.js";
+import { ResponseOptions } from "@fiado/gateway-adapter";
+
+@injectable()
+export default class TransactionAlertApi implements ITransactionAlertApi {
+    private readonly baseUrl = process.env.RISK_PROFILE_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    async getAlerts(status: AlarmOperationType, reported: 1 | 0): Promise<ResponseOptions<{ items: TransactionAlertResponse[], lastKey: any }>> {
+        const url = `${this.baseUrl}/alarms?status=${status}&reported=${reported}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async dictaminateAlert(alertId: string, request: DictaminateAlertRequest): Promise<ResponseOptions<DictaminateAlertResponse>> {
+        const url = `${this.baseUrl}/alerts/${alertId}/dictamen`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async appendAlertNote(alertId: string, request: AppendAlertNoteRequest): Promise<ResponseOptions<AppendAlertNoteResponse>> {
+        const url = `${this.baseUrl}/alerts/${alertId}/notes`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async createBlockedListAlert(request: CreateBlockedListAlertRequest): Promise<ResponseOptions<CreateBlockedListAlertResponse>> {
+        const url = `${this.baseUrl}/alerts/blocked-list`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async markAlertReported(alertId: string, request: MarkAlertReportedRequest): Promise<ResponseOptions<MarkAlertReportedResponse>> {
+        const url = `${this.baseUrl}/alerts/${alertId}/reported`;
+        return await this.httpRequest.post(url, request);
+    }
+}

package/src/riskProfile/api/interfaces/IRiskProfileApi.ts

@@ -1,70 +1,70 @@
-import {CreatePrivateAlarm, CreateRiskProfileRequest} from "@fiado/type-kit/bin/riskProfile/index.js";
-type UpdateAlarmProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateAlarmProfileRequest.js").default;
-type UpdateRiskProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateRiskProfileRequest.js").default;
-import { ResponseOptions } from "@fiado/gateway-adapter";
-import {
-    SetCustomAlarmRequest,
-    SetCustomAlarmResponse,
-    SetDeclaredIncomeRequest,
-    SetDeclaredIncomeResponse,
-    SetManualRiskLevelRequest,
-    SetManualRiskLevelResponse,
-    CreateClientFinancialHistoryRequest,
-    ClientFinancialHistoryResponse,
-    ListClientFinancialHistoryResponse,
-} from "@fiado/type-kit/bin/riskProfile/index.js";
-
-export interface IRiskProfileApi {
-    createRiskProfile(request: CreateRiskProfileRequest): Promise<any>;
-
-    updateRiskProfile(request: UpdateRiskProfileRequest): Promise<any>;
-
-    updateAlarmProfile(request: UpdateAlarmProfileRequest): Promise<any>;
-
-    getRiskProfileByDirectoryId(directoryId: string): Promise<any>
-
-    createAlarm(params: CreatePrivateAlarm): Promise<any>
-
-    /**
-     * Cambia el manualRiskLevel del perfil con recálculo de alarmas base y posible creación
-     * de alerta MANUAL_RISK_INCREASE si el nivel sube.
-     * Endpoint: `PUT /profiles/{directoryId}/manual-risk`
-     *
-     * Idempotencia: si previousLevel === newLevel, devuelve 200 con noop=true sin escribir.
-     *
-     * Errores:
-     * - 404 NOT_FOUND si el perfil no existe.
-     */
-    setManualRiskLevel(directoryId: string, request: SetManualRiskLevelRequest): Promise<ResponseOptions<SetManualRiskLevelResponse>>;
-
-    /**
-     * Cambia el umbral de una alarma custom (customHighAmount o customMonthlyIncrease).
-     * Endpoint: `PUT /profiles/{directoryId}/custom-alarm`
-     *
-     * Idempotencia: si previousValue === newValue, devuelve 200 con noop=true.
-     */
-    setCustomAlarm(directoryId: string, request: SetCustomAlarmRequest): Promise<ResponseOptions<SetCustomAlarmResponse>>;
-
-    /**
-     * Cambia el declaredMonthlyIncome del perfil y recalcula las 5 alarmas base.
-     * Endpoint: `PUT /profiles/{directoryId}/declared-income`
-     *
-     * Idempotencia: si previousIncome === newValue, devuelve 200 con noop=true.
-     */
-    setDeclaredIncome(directoryId: string, request: SetDeclaredIncomeRequest): Promise<ResponseOptions<SetDeclaredIncomeResponse>>;
-
-    /**
-     * Registra un cambio en el historial financiero del perfil (BO-03, audit log
-     * append-only `ClientFinancialHistory_GT`).
-     * Endpoint: `POST /profiles/{directoryId}/financial-history`
-     */
-    createClientFinancialHistory(directoryId: string, request: CreateClientFinancialHistoryRequest): Promise<ResponseOptions<ClientFinancialHistoryResponse>>;
-
-    /**
-     * Lista el historial financiero del perfil, cronológico descendente, paginado.
-     * Endpoint: `GET /profiles/{directoryId}/financial-history?limit=&continuationToken=`
-     *
-     * Paginación: pasar `continuationToken` de la respuesta previa; `null` = fin.
-     */
-    listClientFinancialHistory(directoryId: string, params?: { limit?: number; continuationToken?: string }): Promise<ResponseOptions<ListClientFinancialHistoryResponse>>;
+import {CreatePrivateAlarm, CreateRiskProfileRequest} from "@fiado/type-kit/bin/riskProfile/index.js";
+type UpdateAlarmProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateAlarmProfileRequest.js").default;
+type UpdateRiskProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateRiskProfileRequest.js").default;
+import { ResponseOptions } from "@fiado/gateway-adapter";
+import {
+    SetCustomAlarmRequest,
+    SetCustomAlarmResponse,
+    SetDeclaredIncomeRequest,
+    SetDeclaredIncomeResponse,
+    SetManualRiskLevelRequest,
+    SetManualRiskLevelResponse,
+    CreateClientFinancialHistoryRequest,
+    ClientFinancialHistoryResponse,
+    ListClientFinancialHistoryResponse,
+} from "@fiado/type-kit/bin/riskProfile/index.js";
+
+export interface IRiskProfileApi {
+    createRiskProfile(request: CreateRiskProfileRequest): Promise<any>;
+
+    updateRiskProfile(request: UpdateRiskProfileRequest): Promise<any>;
+
+    updateAlarmProfile(request: UpdateAlarmProfileRequest): Promise<any>;
+
+    getRiskProfileByDirectoryId(directoryId: string): Promise<any>
+
+    createAlarm(params: CreatePrivateAlarm): Promise<any>
+
+    /**
+     * Cambia el manualRiskLevel del perfil con recálculo de alarmas base y posible creación
+     * de alerta MANUAL_RISK_INCREASE si el nivel sube.
+     * Endpoint: `PUT /profiles/{directoryId}/manual-risk`
+     *
+     * Idempotencia: si previousLevel === newLevel, devuelve 200 con noop=true sin escribir.
+     *
+     * Errores:
+     * - 404 NOT_FOUND si el perfil no existe.
+     */
+    setManualRiskLevel(directoryId: string, request: SetManualRiskLevelRequest): Promise<ResponseOptions<SetManualRiskLevelResponse>>;
+
+    /**
+     * Cambia el umbral de una alarma custom (customHighAmount o customMonthlyIncrease).
+     * Endpoint: `PUT /profiles/{directoryId}/custom-alarm`
+     *
+     * Idempotencia: si previousValue === newValue, devuelve 200 con noop=true.
+     */
+    setCustomAlarm(directoryId: string, request: SetCustomAlarmRequest): Promise<ResponseOptions<SetCustomAlarmResponse>>;
+
+    /**
+     * Cambia el declaredMonthlyIncome del perfil y recalcula las 5 alarmas base.
+     * Endpoint: `PUT /profiles/{directoryId}/declared-income`
+     *
+     * Idempotencia: si previousIncome === newValue, devuelve 200 con noop=true.
+     */
+    setDeclaredIncome(directoryId: string, request: SetDeclaredIncomeRequest): Promise<ResponseOptions<SetDeclaredIncomeResponse>>;
+
+    /**
+     * Registra un cambio en el historial financiero del perfil (BO-03, audit log
+     * append-only `ClientFinancialHistory_GT`).
+     * Endpoint: `POST /profiles/{directoryId}/financial-history`
+     */
+    createClientFinancialHistory(directoryId: string, request: CreateClientFinancialHistoryRequest): Promise<ResponseOptions<ClientFinancialHistoryResponse>>;
+
+    /**
+     * Lista el historial financiero del perfil, cronológico descendente, paginado.
+     * Endpoint: `GET /profiles/{directoryId}/financial-history?limit=&continuationToken=`
+     *
+     * Paginación: pasar `continuationToken` de la respuesta previa; `null` = fin.
+     */
+    listClientFinancialHistory(directoryId: string, params?: { limit?: number; continuationToken?: string }): Promise<ResponseOptions<ListClientFinancialHistoryResponse>>;
 }