@fiado/api-invoker 3.17.0 → 3.18.0

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

@@ -0,0 +1,46 @@
+import { ChangePasswordRequest, GetUserRequest, GetUserResponse, RefreshTokenRequest, RefreshTokenResponse, RespondToAuthChallengeRequest, SetPasswordRequest, SignInRequest, SignInResponse, SignUpConfirmRequest, SignUpRequest, SignUpResponse } from "@fiado/type-kit/bin/cognitoConnector";
+export interface ICognitoApi {
+    /**
+     * Healthcheck for the cognito-connector
+     */
+    healthcheck(): Promise<HealthcheckResponse>;
+    /**
+     * Create a new user in Cognito
+     */
+    signUp(request: SignUpRequest): Promise<SignUpResponse>;
+    /**
+     * Confirm sign-up for a user in Cognito
+     */
+    signUpConfirm(request: SignUpConfirmRequest): Promise<void>;
+    /**
+     * Sign in a user
+     */
+    signIn(request: SignInRequest): Promise<SignInResponse>;
+    /**
+     * Sign out a user
+     */
+    signOut(): Promise<void>;
+    /**
+     * Change a user's password
+     */
+    changePassword(request: ChangePasswordRequest): Promise<void>;
+    /**
+     * Retrieve user details
+     */
+    getUser(request: GetUserRequest): Promise<GetUserResponse>;
+    /**
+     * Refresh a user's tokens
+     */
+    refreshToken(request: RefreshTokenRequest): Promise<RefreshTokenResponse>;
+    /**
+     * Respond to an auth challenge
+     */
+    respondToAuthChallenge(request: RespondToAuthChallengeRequest): Promise<any>;
+    /**
+     * Reset a user's password
+     */
+    resetPassword(request: SetPasswordRequest): Promise<void>;
+}
+export interface HealthcheckResponse {
+    status: string;
+}

package/bin/cognitoConnector/interfaces/ICognitoConnectorApiV2.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/report-processor-business/api/IReportProcessorBusiness.d.ts

@@ -0,0 +1,3 @@
+export interface IReportProcessorBusiness {
+    processReports(key: string): Promise<void>;
+}

package/bin/report-processor-business/api/IReportProcessorBusiness.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/riskProfile/api/RiskProfileApi.d.ts

@@ -3,6 +3,8 @@ 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";
 export default class RiskProfileApi implements IRiskProfileApi {
     private httpRequest;
     private readonly baseUrl;
@@ -12,4 +14,7 @@ export default class RiskProfileApi implements IRiskProfileApi {
     updateAlarmProfile(request: UpdateAlarmProfileRequest): Promise<any>;
     getRiskProfileByDirectoryId(directoryId: string): Promise<any>;
     createAlarm(params: CreatePrivateAlarm): Promise<any>;
+    setManualRiskLevel(directoryId: string, request: SetManualRiskLevelRequest): Promise<ResponseOptions<SetManualRiskLevelResponse>>;
+    setCustomAlarm(directoryId: string, request: SetCustomAlarmRequest): Promise<ResponseOptions<SetCustomAlarmResponse>>;
+    setDeclaredIncome(directoryId: string, request: SetDeclaredIncomeRequest): Promise<ResponseOptions<SetDeclaredIncomeResponse>>;
 }

package/bin/riskProfile/api/RiskProfileApi.js

@@ -38,6 +38,18 @@ let RiskProfileApi = class RiskProfileApi {
         const url = `${this.baseUrl}/alarms/create`;
         return await this.httpRequest.post(url, params);
     }
+    async setManualRiskLevel(directoryId, request) {
+        const url = `${this.baseUrl}/profiles/${directoryId}/manual-risk`;
+        return await this.httpRequest.put(url, request);
+    }
+    async setCustomAlarm(directoryId, request) {
+        const url = `${this.baseUrl}/profiles/${directoryId}/custom-alarm`;
+        return await this.httpRequest.put(url, request);
+    }
+    async setDeclaredIncome(directoryId, request) {
+        const url = `${this.baseUrl}/profiles/${directoryId}/declared-income`;
+        return await this.httpRequest.put(url, request);
+    }
 };
 RiskProfileApi = __decorate([
     (0, inversify_1.injectable)(),

package/bin/riskProfile/api/TransactionAlertApi.d.ts

@@ -1,6 +1,6 @@
 import { ITransactionAlertApi } from "./interfaces/ITransactionAlertApi";
 import { IHttpRequest } from "@fiado/http-client";
-import { AlarmOperationType, TransactionAlertResponse } from "@fiado/type-kit/bin/riskProfile";
+import { AlarmOperationType, AppendAlertNoteRequest, AppendAlertNoteResponse, CreateBlockedListAlertRequest, CreateBlockedListAlertResponse, DictaminateAlertRequest, DictaminateAlertResponse, MarkAlertReportedRequest, MarkAlertReportedResponse, TransactionAlertResponse } from "@fiado/type-kit/bin/riskProfile";
 import { ResponseOptions } from "@fiado/gateway-adapter";
 export default class TransactionAlertApi implements ITransactionAlertApi {
     private httpRequest;
@@ -10,4 +10,8 @@ export default class TransactionAlertApi implements ITransactionAlertApi {
         items: TransactionAlertResponse[];
         lastKey: any;
     }>>;
+    dictaminateAlert(alertId: string, request: DictaminateAlertRequest): Promise<ResponseOptions<DictaminateAlertResponse>>;
+    appendAlertNote(alertId: string, request: AppendAlertNoteRequest): Promise<ResponseOptions<AppendAlertNoteResponse>>;
+    createBlockedListAlert(request: CreateBlockedListAlertRequest): Promise<ResponseOptions<CreateBlockedListAlertResponse>>;
+    markAlertReported(alertId: string, request: MarkAlertReportedRequest): Promise<ResponseOptions<MarkAlertReportedResponse>>;
 }

package/bin/riskProfile/api/TransactionAlertApi.js

@@ -22,6 +22,22 @@ let TransactionAlertApi = class TransactionAlertApi {
         const url = `${this.baseUrl}/alarms?status=${status}&reported=${reported}`;
         return await this.httpRequest.get(url);
     }
+    async dictaminateAlert(alertId, request) {
+        const url = `${this.baseUrl}/alerts/${alertId}/dictamen`;
+        return await this.httpRequest.post(url, request);
+    }
+    async appendAlertNote(alertId, request) {
+        const url = `${this.baseUrl}/alerts/${alertId}/notes`;
+        return await this.httpRequest.post(url, request);
+    }
+    async createBlockedListAlert(request) {
+        const url = `${this.baseUrl}/alerts/blocked-list`;
+        return await this.httpRequest.post(url, request);
+    }
+    async markAlertReported(alertId, request) {
+        const url = `${this.baseUrl}/alerts/${alertId}/reported`;
+        return await this.httpRequest.post(url, request);
+    }
 };
 TransactionAlertApi = __decorate([
     (0, inversify_1.injectable)(),

package/bin/riskProfile/api/interfaces/IRiskProfileApi.d.ts

@@ -1,10 +1,37 @@
 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>>;
 }

package/bin/riskProfile/api/interfaces/ITransactionAlertApi.d.ts

@@ -1,8 +1,56 @@
 import { ResponseOptions } from "@fiado/gateway-adapter";
-import { AlarmOperationType, TransactionAlertResponse } from "@fiado/type-kit/bin/riskProfile";
+import { AlarmOperationType, AppendAlertNoteRequest, AppendAlertNoteResponse, CreateBlockedListAlertRequest, CreateBlockedListAlertResponse, DictaminateAlertRequest, DictaminateAlertResponse, MarkAlertReportedRequest, MarkAlertReportedResponse, TransactionAlertResponse } from "@fiado/type-kit/bin/riskProfile";
+/**
+ * Cliente para invocar los endpoints privados de alertas del Lambda `risk-profile-business`.
+ *
+ * Los endpoints viven bajo `RISK_PROFILE_LAMBDA_URL` (API Gateway privado, VPC-only).
+ * Todos requieren `email` en el body como audit trail del autor del cambio.
+ */
 export interface ITransactionAlertApi {
+    /**
+     * Lista alertas filtradas por status y reported.
+     * Endpoint: `GET /alarms?status={status}&reported={reported}`
+     */
     getAlerts(status: AlarmOperationType, reported: 1 | 0): Promise<ResponseOptions<{
         items: TransactionAlertResponse[];
         lastKey: any;
     }>>;
+    /**
+     * Dictamina una alerta en estado NEW o PENDING.
+     * Endpoint: `POST /alerts/{alertId}/dictamen`
+     *
+     * Side effects:
+     * - Update de TransactionAlert_GT con nuevos campos de dictamen y dictamenSnapshotHash.
+     * - Crea Observation con tag ALARM_DICTAMEN.
+     * - Sube snapshot inmutable a S3.
+     *
+     * Errores:
+     * - 404 NOT_FOUND si la alerta no existe.
+     * - 409 ALREADY_DICTATED si la alerta no está en NEW/PENDING.
+     */
+    dictaminateAlert(alertId: string, request: DictaminateAlertRequest): Promise<ResponseOptions<DictaminateAlertResponse>>;
+    /**
+     * Agrega o reemplaza nota a una alerta sin dictaminar.
+     * Endpoint: `POST /alerts/{alertId}/notes`
+     */
+    appendAlertNote(alertId: string, request: AppendAlertNoteRequest): Promise<ResponseOptions<AppendAlertNoteResponse>>;
+    /**
+     * Crea una alerta BLOCKED_LIST manualmente.
+     * Endpoint: `POST /alerts/blocked-list`
+     *
+     * Errores:
+     * - 409 ALERT_ALREADY_EXISTS si ya existe una alerta BLOCKED_LIST abierta para el directoryId.
+     */
+    createBlockedListAlert(request: CreateBlockedListAlertRequest): Promise<ResponseOptions<CreateBlockedListAlertResponse>>;
+    /**
+     * Marca una alerta como reportada a SITI (ROI enviado).
+     * Endpoint: `POST /alerts/{alertId}/reported`
+     *
+     * Precondiciones:
+     * - Alerta en estado CLOSE_RULED y reported=0.
+     *
+     * Errores:
+     * - 409 ALERT_NOT_ELIGIBLE si no cumple precondiciones.
+     */
+    markAlertReported(alertId: string, request: MarkAlertReportedRequest): Promise<ResponseOptions<MarkAlertReportedResponse>>;
 }

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "3.17.0",
+  "version": "3.18.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",
   "scripts": {
     "test": "test",
-    "build": "tsc"
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
   },
   "keywords": [],
   "author": "Fiado Inc",
@@ -16,7 +17,7 @@
     "@fiado/gateway-adapter": "^1.1.50",
     "@fiado/http-client": "^1.0.7",
     "@fiado/logger": "^1.0.3",
-    "@fiado/type-kit": "^3.26.0",
+    "@fiado/type-kit": "^3.27.0",
     "dotenv": "^16.4.7",
     "i": "^0.3.7",
     "inversify": "^6.2.2",

package/src/riskProfile/api/RiskProfileApi.ts

@@ -4,6 +4,15 @@ 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 {
@@ -37,4 +46,19 @@ export default class RiskProfileApi implements IRiskProfileApi {
         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,23 +1,49 @@
 import { inject, injectable } from "inversify";
 import { ITransactionAlertApi } from "./interfaces/ITransactionAlertApi";
 import { IHttpRequest } from "@fiado/http-client";
-import { AlarmOperationType, TransactionAlertResponse } from "@fiado/type-kit/bin/riskProfile";
+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,6 +1,15 @@
 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>;
@@ -12,4 +21,32 @@ export interface IRiskProfileApi {
     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>>;
 }

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

@@ -1,8 +1,70 @@
 import { ResponseOptions } from "@fiado/gateway-adapter";
-import { AlarmOperationType, TransactionAlertResponse } from "@fiado/type-kit/bin/riskProfile";
+import {
+    AlarmOperationType,
+    AppendAlertNoteRequest,
+    AppendAlertNoteResponse,
+    CreateBlockedListAlertRequest,
+    CreateBlockedListAlertResponse,
+    DictaminateAlertRequest,
+    DictaminateAlertResponse,
+    MarkAlertReportedRequest,
+    MarkAlertReportedResponse,
+    TransactionAlertResponse,
+} from "@fiado/type-kit/bin/riskProfile";
 
+/**
+ * Cliente para invocar los endpoints privados de alertas del Lambda `risk-profile-business`.
+ *
+ * Los endpoints viven bajo `RISK_PROFILE_LAMBDA_URL` (API Gateway privado, VPC-only).
+ * Todos requieren `email` en el body como audit trail del autor del cambio.
+ */
 export interface ITransactionAlertApi {
 
-    getAlerts(status: AlarmOperationType, reported: 1 | 0): Promise<ResponseOptions<{ items: TransactionAlertResponse[], lastKey: any }>>
+    /**
+     * Lista alertas filtradas por status y reported.
+     * Endpoint: `GET /alarms?status={status}&reported={reported}`
+     */
+    getAlerts(status: AlarmOperationType, reported: 1 | 0): Promise<ResponseOptions<{ items: TransactionAlertResponse[], lastKey: any }>>;
 
-}
+    /**
+     * Dictamina una alerta en estado NEW o PENDING.
+     * Endpoint: `POST /alerts/{alertId}/dictamen`
+     *
+     * Side effects:
+     * - Update de TransactionAlert_GT con nuevos campos de dictamen y dictamenSnapshotHash.
+     * - Crea Observation con tag ALARM_DICTAMEN.
+     * - Sube snapshot inmutable a S3.
+     *
+     * Errores:
+     * - 404 NOT_FOUND si la alerta no existe.
+     * - 409 ALREADY_DICTATED si la alerta no está en NEW/PENDING.
+     */
+    dictaminateAlert(alertId: string, request: DictaminateAlertRequest): Promise<ResponseOptions<DictaminateAlertResponse>>;
+
+    /**
+     * Agrega o reemplaza nota a una alerta sin dictaminar.
+     * Endpoint: `POST /alerts/{alertId}/notes`
+     */
+    appendAlertNote(alertId: string, request: AppendAlertNoteRequest): Promise<ResponseOptions<AppendAlertNoteResponse>>;
+
+    /**
+     * Crea una alerta BLOCKED_LIST manualmente.
+     * Endpoint: `POST /alerts/blocked-list`
+     *
+     * Errores:
+     * - 409 ALERT_ALREADY_EXISTS si ya existe una alerta BLOCKED_LIST abierta para el directoryId.
+     */
+    createBlockedListAlert(request: CreateBlockedListAlertRequest): Promise<ResponseOptions<CreateBlockedListAlertResponse>>;
+
+    /**
+     * Marca una alerta como reportada a SITI (ROI enviado).
+     * Endpoint: `POST /alerts/{alertId}/reported`
+     *
+     * Precondiciones:
+     * - Alerta en estado CLOSE_RULED y reported=0.
+     *
+     * Errores:
+     * - 409 ALERT_NOT_ELIGIBLE si no cumple precondiciones.
+     */
+    markAlertReported(alertId: string, request: MarkAlertReportedRequest): Promise<ResponseOptions<MarkAlertReportedResponse>>;
+}