feature: added messageProcessors parameter in HawkInitialSettings

Author: Reversean

packages/core/src/messages/message-processor.ts

@@ -44,11 +44,13 @@ export interface ErrorSnapshot {
  */
 export interface MessageProcessor<T extends CatcherMessageType = CatcherMessageType> {
   /**
-   * Handles input message. May mutate or replace it.
+   * Handles input message. May mutate, replace or drop it.
+   *
+   * Dropped message won't be sent.
    *
    * @param payload - processed event message payload with partially-built addons
    * @param snapshot - additional context with original error
-   * @returns modified payload, or `null` to drop event
+   * @returns modified payload, or `null` to drop message
    */
   apply(
     payload: ProcessingPayload<T>,

packages/javascript/src/catcher.ts

@@ -217,6 +217,10 @@ export default class Catcher {
       this.messageProcessors.push(new DebugAddonMessageProcessor());
     }
 
+    if (settings.messageProcessors) {
+      this.messageProcessors.push(...settings.messageProcessors);
+    }
+
     /**
      * Set global handlers
      */

packages/javascript/src/types/hawk-initial-settings.ts

@@ -1,6 +1,6 @@
 import type { AffectedUser, EventContext } from '@hawk.so/types';
 import type { HawkJavaScriptEvent } from './event';
-import type { Transport } from '@hawk.so/core';
+import type { MessageProcessor, Transport } from '@hawk.so/core';
 import type { BreadcrumbsOptions } from '../addons/breadcrumbs';
 
 /**
@@ -98,4 +98,11 @@ export interface HawkInitialSettings {
    * If not provided, default WebSocket transport is used.
    */
   transport?: Transport;
+
+  /**
+   * Custom message processors.
+   * Used to prepare event message before send.
+   * May modify original event payload or return null to drop it.
+   */
+  messageProcessors?: MessageProcessor<'errors/javascript'>[];
 }