@fiado/api-invoker 4.8.2 → 4.10.0

package/src/referral-business/ReferralBusinessApi.ts

@@ -1,43 +1,43 @@
-import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
-import dotenv from 'dotenv';
-import { IReferralBusinessApi } from "./interfaces/IReferralBusinessApi";
-import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
-import { Scope } from "@fiado/type-kit/bin/directory/enums/Scope";
-
-dotenv.config();
-
-@injectable()
-export class ReferralBusinessApi implements IReferralBusinessApi {
-
-    private readonly baseUrl = process.env.REFERRAL_BUSINESS_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
-    
-    async isDescendant(params: { email: string; directoryId: string; }): Promise<FiadoApiResponse<{isDescendant: boolean}>> {
-        const url = `${this.baseUrl}private/agents/is-descendant?email=${params.email}&directoryId=${params.directoryId}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async createAgent(params: { directoryId: string; notes?: string; type?: string; category?: string; groupId?: string; }): Promise<FiadoApiResponse<any>> {
-        const url = `${this.baseUrl}private/agents`;
-        return await this.httpRequest.post(url, params);
-    }
-
-    async getByDirectoryId(directoryId: string): Promise<FiadoApiResponse<any>> {
-        const url = `${this.baseUrl}private/agents/directoryId/${directoryId}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async accountOpeningsBySponsor(newDirectoryId: string, scope: Scope): Promise<FiadoApiResponse<any>> {
-
-        const url = `${this.baseUrl}private/account-openings-by-sponsor/${newDirectoryId}`;
-
-        return await this.httpRequest.post(url, { directoryId: newDirectoryId, scope });
-    }
-
-    async deleteAgent(directoryId: string): Promise<FiadoApiResponse<any>> {
-        const url = `${this.baseUrl}backoffice/agents/directory/${directoryId}`;
-        return await this.httpRequest.delete(url);
-    }
+import { inject, injectable } from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import dotenv from 'dotenv';
+import { IReferralBusinessApi } from "./interfaces/IReferralBusinessApi";
+import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
+import { Scope } from "@fiado/type-kit/bin/directory/enums/Scope";
+
+dotenv.config();
+
+@injectable()
+export class ReferralBusinessApi implements IReferralBusinessApi {
+
+    private readonly baseUrl = process.env.REFERRAL_BUSINESS_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
+    
+    async isDescendant(params: { email: string; directoryId: string; }): Promise<FiadoApiResponse<{isDescendant: boolean}>> {
+        const url = `${this.baseUrl}private/agents/is-descendant?email=${params.email}&directoryId=${params.directoryId}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async createAgent(params: { directoryId: string; notes?: string; type?: string; category?: string; groupId?: string; }): Promise<FiadoApiResponse<any>> {
+        const url = `${this.baseUrl}private/agents`;
+        return await this.httpRequest.post(url, params);
+    }
+
+    async getByDirectoryId(directoryId: string): Promise<FiadoApiResponse<any>> {
+        const url = `${this.baseUrl}private/agents/directoryId/${directoryId}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async accountOpeningsBySponsor(newDirectoryId: string, scope: Scope): Promise<FiadoApiResponse<any>> {
+
+        const url = `${this.baseUrl}private/account-openings-by-sponsor/${newDirectoryId}`;
+
+        return await this.httpRequest.post(url, { directoryId: newDirectoryId, scope });
+    }
+
+    async deleteAgent(directoryId: string): Promise<FiadoApiResponse<any>> {
+        const url = `${this.baseUrl}backoffice/agents/directory/${directoryId}`;
+        return await this.httpRequest.delete(url);
+    }
 }

package/src/referral-business/index.ts

@@ -1,2 +1,2 @@
-export * from './interfaces/IReferralBusinessApi';
+export * from './interfaces/IReferralBusinessApi';
 export * from './ReferralBusinessApi';

package/src/referral-business/interfaces/IReferralBusinessApi.ts

@@ -1,45 +1,45 @@
-import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
-import { Scope } from "@fiado/type-kit/bin/directory/enums/Scope";
-
-/**
- * Interfaz para el servicio Payroll que permite operaciones sobre payroll.
- */
-export interface IReferralBusinessApi {
-    
-    /**
-     * Obtiene agentes por directorio.
-     * @param directoryId ID del directorio.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    getByDirectoryId(directoryId: string): Promise<FiadoApiResponse<any>>;
-
-
-    /**
-     * Crea un agente.
-     * @param directoryId ID del directorio.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    createAgent(params:{directoryId: string; notes?: string; type?: string; category?: string; groupId?: string}): Promise<FiadoApiResponse<any>>;
-
-    /**
-     * Registra aperturas de cuenta por patrocinador.
-     * @param newDirectoryId ID del nuevo directorio.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    accountOpeningsBySponsor(newDirectoryId: string, scope:Scope): Promise<FiadoApiResponse<void>>;
-
-    /**
-     * Verifica si un agente es descendiente de otro agente.
-     * @param email Email del agente padre.
-     * @param directoryId ID del directorio del agente hijo.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    isDescendant(params:{email: string; directoryId: string}): Promise<FiadoApiResponse<{isDescendant: boolean}>>;
-
-    /**
-     * Borra físicamente al agente (Agents_GT) asociado a un directoryId.
-     * @param directoryId ID del directorio del agente.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    deleteAgent(directoryId: string): Promise<FiadoApiResponse<any>>;
-}
+import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
+import { Scope } from "@fiado/type-kit/bin/directory/enums/Scope";
+
+/**
+ * Interfaz para el servicio Payroll que permite operaciones sobre payroll.
+ */
+export interface IReferralBusinessApi {
+    
+    /**
+     * Obtiene agentes por directorio.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    getByDirectoryId(directoryId: string): Promise<FiadoApiResponse<any>>;
+
+
+    /**
+     * Crea un agente.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    createAgent(params:{directoryId: string; notes?: string; type?: string; category?: string; groupId?: string}): Promise<FiadoApiResponse<any>>;
+
+    /**
+     * Registra aperturas de cuenta por patrocinador.
+     * @param newDirectoryId ID del nuevo directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    accountOpeningsBySponsor(newDirectoryId: string, scope:Scope): Promise<FiadoApiResponse<void>>;
+
+    /**
+     * Verifica si un agente es descendiente de otro agente.
+     * @param email Email del agente padre.
+     * @param directoryId ID del directorio del agente hijo.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    isDescendant(params:{email: string; directoryId: string}): Promise<FiadoApiResponse<{isDescendant: boolean}>>;
+
+    /**
+     * Borra físicamente al agente (Agents_GT) asociado a un directoryId.
+     * @param directoryId ID del directorio del agente.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    deleteAgent(directoryId: string): Promise<FiadoApiResponse<any>>;
+}

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";
-
-@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";
+
+@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';
-export * from './api/IReportProcessorBusinessApi';
-
+
+
+export * from './api/ReportProcessorBusinessApi';
+export * from './api/IReportProcessorBusinessApi';
+

package/src/riskProfile/api/RiskProfileApi.ts

@@ -1,64 +1,64 @@
-import {IRiskProfileApi} from "./interfaces/IRiskProfileApi";
-import {inject, injectable} from "inversify";
-import {IHttpRequest} from "@fiado/http-client";
-import {CreatePrivateAlarm, CreateRiskProfileRequest} from "@fiado/type-kit/bin/riskProfile";
-import UpdateRiskProfileRequest from "@fiado/type-kit/bin/riskProfile/dtos/UpdateRiskProfileRequest";
-import UpdateAlarmProfileRequest from "@fiado/type-kit/bin/riskProfile/dtos/UpdateAlarmProfileRequest";
-import { ResponseOptions } from "@fiado/gateway-adapter";
-import {
-    SetCustomAlarmRequest,
-    SetCustomAlarmResponse,
-    SetDeclaredIncomeRequest,
-    SetDeclaredIncomeResponse,
-    SetManualRiskLevelRequest,
-    SetManualRiskLevelResponse,
-} from "@fiado/type-kit/bin/riskProfile";
-
-@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);
-    }
-
+import {IRiskProfileApi} from "./interfaces/IRiskProfileApi";
+import {inject, injectable} from "inversify";
+import {IHttpRequest} from "@fiado/http-client";
+import {CreatePrivateAlarm, CreateRiskProfileRequest} from "@fiado/type-kit/bin/riskProfile";
+import UpdateRiskProfileRequest from "@fiado/type-kit/bin/riskProfile/dtos/UpdateRiskProfileRequest";
+import UpdateAlarmProfileRequest from "@fiado/type-kit/bin/riskProfile/dtos/UpdateAlarmProfileRequest";
+import { ResponseOptions } from "@fiado/gateway-adapter";
+import {
+    SetCustomAlarmRequest,
+    SetCustomAlarmResponse,
+    SetDeclaredIncomeRequest,
+    SetDeclaredIncomeResponse,
+    SetManualRiskLevelRequest,
+    SetManualRiskLevelResponse,
+} from "@fiado/type-kit/bin/riskProfile";
+
+@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);
+    }
+
 }

package/src/riskProfile/api/TransactionAlertApi.ts

@@ -1,49 +1,49 @@
-import { inject, injectable } from "inversify";
-import { ITransactionAlertApi } from "./interfaces/ITransactionAlertApi";
-import { IHttpRequest } from "@fiado/http-client";
-import {
-    AlarmOperationType,
-    AppendAlertNoteRequest,
-    AppendAlertNoteResponse,
-    CreateBlockedListAlertRequest,
-    CreateBlockedListAlertResponse,
-    DictaminateAlertRequest,
-    DictaminateAlertResponse,
-    MarkAlertReportedRequest,
-    MarkAlertReportedResponse,
-    TransactionAlertResponse,
-} from "@fiado/type-kit/bin/riskProfile";
-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";
+import { IHttpRequest } from "@fiado/http-client";
+import {
+    AlarmOperationType,
+    AppendAlertNoteRequest,
+    AppendAlertNoteResponse,
+    CreateBlockedListAlertRequest,
+    CreateBlockedListAlertResponse,
+    DictaminateAlertRequest,
+    DictaminateAlertResponse,
+    MarkAlertReportedRequest,
+    MarkAlertReportedResponse,
+    TransactionAlertResponse,
+} from "@fiado/type-kit/bin/riskProfile";
+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,52 +1,52 @@
-import {CreatePrivateAlarm, CreateRiskProfileRequest} from "@fiado/type-kit/bin/riskProfile";
-import UpdateAlarmProfileRequest from "@fiado/type-kit/bin/riskProfile/dtos/UpdateAlarmProfileRequest";
-import UpdateRiskProfileRequest from "@fiado/type-kit/bin/riskProfile/dtos/UpdateRiskProfileRequest";
-import { ResponseOptions } from "@fiado/gateway-adapter";
-import {
-    SetCustomAlarmRequest,
-    SetCustomAlarmResponse,
-    SetDeclaredIncomeRequest,
-    SetDeclaredIncomeResponse,
-    SetManualRiskLevelRequest,
-    SetManualRiskLevelResponse,
-} from "@fiado/type-kit/bin/riskProfile";
-
-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>>;
+import {CreatePrivateAlarm, CreateRiskProfileRequest} from "@fiado/type-kit/bin/riskProfile";
+import UpdateAlarmProfileRequest from "@fiado/type-kit/bin/riskProfile/dtos/UpdateAlarmProfileRequest";
+import UpdateRiskProfileRequest from "@fiado/type-kit/bin/riskProfile/dtos/UpdateRiskProfileRequest";
+import { ResponseOptions } from "@fiado/gateway-adapter";
+import {
+    SetCustomAlarmRequest,
+    SetCustomAlarmResponse,
+    SetDeclaredIncomeRequest,
+    SetDeclaredIncomeResponse,
+    SetManualRiskLevelRequest,
+    SetManualRiskLevelResponse,
+} from "@fiado/type-kit/bin/riskProfile";
+
+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>>;
 }