Merge pull request #24338 from drodil/notifications_filter_users

feat: support to filter notification recipients after resolving

plugins/notifications-node/api-report.md

@@ -41,6 +41,7 @@ export type NotificationRecipients =
   | {
       type: 'entity';
       entityRef: string | string[];
+      excludeEntityRef?: string | string[];
     }
   | {
       type: 'broadcast';

plugins/notifications-node/src/service/DefaultNotificationService.ts

@@ -28,7 +28,16 @@ export type NotificationServiceOptions = {
 export type NotificationRecipients =
   | {
       type: 'entity';
+      /**
+       * Entity references to send the notifications to
+       */
       entityRef: string | string[];
+      /**
+       * Optional entity reference(s) to filter out of the resolved recipients.
+       * Usually the currently logged-in user for preventing sending notification
+       * of user action to him/herself.
+       */
+      excludeEntityRef?: string | string[];
     }
   | { type: 'broadcast' };