strapi-plugin-notifier 1.0.2 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+## [1.1.0] — 2026-06-11
+
+### Added
+- **Batch sending** — `notifier.sendBatch(items[])` sends multiple notifications in one call; settings fetched once and opt-out/merge applied per item.
+- **User opt-out** — new `notification-preference` content-type (`notifier_preferences` table). Each admin user can set `globalOptOut: true` to suppress all notifications, or `mutedTypes: ['info', ...]` to mute by type. Opt-out is applied at query time, covering broadcast and role-targeted notifications.
+  - New routes: `GET /notifier/preferences/me`, `PUT /notifier/preferences/me`
+- **Notification merging** — when `merge.enabled` is `true` in settings, sending a notification whose key fields match an existing one (within `windowMinutes`) updates that notification's `mergeCount` instead of creating a new row.
+  - New notification fields: `mergeKey` (string), `mergeCount` (integer, default 1)
+  - New settings block: `merge.{ enabled, windowMinutes, keyFields, countBadge, rewriteMessage }`
+  - Inbox shows a coloured `×N` count badge when `countBadge` is on
+  - Merge settings editable at runtime via **Settings → Notifier → Merge**
+- **Unit tests** — 61 tests covering `mergeWithDefaults`, preference service (isOptedOut, get, upsert), notification service (opt-out filtering, findMergeCandidate, mergeInto, createMany), and notifier service (send, sendBatch, merge paths, opt-out, convenience wrappers).
+
+### Migration notes
+- A new `notifier_preferences` table is created automatically on next Strapi start — no manual migration needed.
+- Two new columns (`mergeKey`, `mergeCount`) are added to the existing `notifier_notifications` table — existing rows are unaffected (columns are nullable / have defaults).
+- Existing stored settings in the plugin store are unaffected; the new `merge` config block defaults to `enabled: false`.
+
+---
+
+## [1.0.3] — 2026-06-11
+
+### Fixed
+- Settings link used `React.lazy()` wrapper — Strapi's `createSettingSection` validates `typeof Component === 'function'`; `lazy()` returns an object and fails that check. Changed to plain `() => import(...)`.
+- `@strapi/admin` moved to `peerDependencies` so `pack-up` marks it external; previously `useFetchClient` was bundled into the plugin chunk, causing a blank admin panel when using a linked copy of the plugin.
+- Admin route index exported an array instead of an object, preventing route registration.
+
+---
+
+## [1.0.2] — 2026-06-10
+
+### Added
+- Initial public release.
+- Live bell icon, notification inbox, targeting (broadcast / role / user), configurable retention, delivery settings, UI accent theme, and Settings panel.

package/README.md

@@ -7,7 +7,10 @@ A first-class notification system for Strapi v5 admin panels. Adds a live bell i
 - **Live bell icon** — badge count updated by polling the server (interval configurable)
 - **Notification inbox** — filter by type, mark as read, dismiss, load more, clear all
 - **Targeting** — broadcast to all admins, or target by user ID or role code
-- **Configurable** — poll interval, page size, retention policy, and UI accent colours
+- **Batch sending** — send multiple notifications in one call, settings fetched once
+- **Merge** — collapse repeated notifications into one item with a count badge (fully configurable)
+- **User opt-out** — each admin user can mute individual notification types or opt out entirely
+- **Configurable** — poll interval, page size, retention policy, UI accent colours, and merge rules
 - **Settings panel** — runtime configuration via Settings → Notifier (persisted in Strapi plugin store)
 - **Retention cron** — daily cleanup at 3 AM, respects maxDays and maxPerUser limits
 - **Strapi v5 only**
@@ -51,6 +54,13 @@ export default {
         pollIntervalMs: 30_000, // how often the Bell polls (ms)
         pageSize: 20,           // notifications per page in inbox
       },
+      merge: {
+        enabled: false,          // enable notification merging
+        windowMinutes: 60,       // look back this many minutes for a merge candidate
+        keyFields: ['title', 'type'], // fields that must match to merge
+        countBadge: true,        // show "×N" badge on merged items in the inbox
+        rewriteMessage: false,   // rewrite the message to "N× title" when merging
+      },
       ui: {
         theme: {
           accent: {
@@ -102,30 +112,125 @@ notifier.send({
 });
 ```
 
+### Batch sending
+
+Send multiple notifications in one call. Settings (including merge config) are fetched once and applied to all items — more efficient than looping over `send()`.
+
+```typescript
+await notifier.sendBatch([
+  { title: 'New job application', type: 'info', to: { role: 'strapi-editor' } },
+  { title: 'Export ready', type: 'success', to: { userId: 42 } },
+  { title: 'Low disk space', type: 'warning' }, // broadcast
+]);
+```
+
+Opt-out and merge rules are applied per item within the batch.
+
 ### Notification options
 
-| Field     | Type                                      | Required | Default     |
-|-----------|-------------------------------------------|----------|-------------|
-| `title`   | `string`                                  | Yes      | —           |
-| `message` | `string`                                  | No       | —           |
-| `type`    | `'info' \| 'success' \| 'warning' \| 'error'` | No  | `'info'`    |
-| `url`     | `string`                                  | No       | —           |
+| Field     | Type                                          | Required | Default   |
+|-----------|-----------------------------------------------|----------|-----------|
+| `title`   | `string`                                      | Yes      | —         |
+| `message` | `string`                                      | No       | —         |
+| `type`    | `'info' \| 'success' \| 'warning' \| 'error'` | No       | `'info'`  |
+| `url`     | `string`                                      | No       | —         |
+| `to`      | `{ userId?: number; role?: string }`          | No       | broadcast |
+
+## Notification merging
+
+When `merge.enabled` is `true`, sending a notification whose key fields match an existing notification (created within `windowMinutes`) updates that notification instead of creating a new one.
+
+**Example — a form that can be submitted many times:**
+
+```typescript
+// config/plugins.ts
+merge: { enabled: true, windowMinutes: 60, keyFields: ['title', 'type'], countBadge: true }
+
+// In your lifecycle / service:
+notifier.toRole('strapi-editor', {
+  title: 'New job application',
+  type: 'info',
+});
+```
+
+After five submissions the inbox shows a single item: **New job application ×5**.
+
+**Merge key fields** (`title`, `type`, `url`) — any combination. Two notifications are considered the same if all selected fields match AND the recipient matches AND the most recent one was created within the window.
+
+**Display options:**
+
+| Option           | Default | Effect                                           |
+|------------------|---------|--------------------------------------------------|
+| `countBadge`     | `true`  | Shows a coloured "×N" pill next to the title     |
+| `rewriteMessage` | `false` | Replaces the message with `"N× <title>"`         |
+
+Both can be toggled from the **Settings → Notifier → Merge** panel at runtime.
+
+## User opt-out
+
+Each admin user can control which notifications they receive. Opt-out is applied at query time so it covers broadcast and role-targeted notifications too.
+
+### Via the API
+
+```http
+GET  /notifier/preferences/me
+PUT  /notifier/preferences/me
+```
+
+**Get current preferences:**
+```http
+GET /notifier/preferences/me
+→ { "data": { "userId": 5, "globalOptOut": false, "mutedTypes": ["info"] } }
+```
+
+**Mute info and success notifications:**
+```http
+PUT /notifier/preferences/me
+Content-Type: application/json
+
+{ "mutedTypes": ["info", "success"] }
+```
+
+**Opt out entirely:**
+```http
+PUT /notifier/preferences/me
+Content-Type: application/json
+
+{ "globalOptOut": true }
+```
+
+**Re-enable:**
+```http
+PUT /notifier/preferences/me
+Content-Type: application/json
+
+{ "globalOptOut": false, "mutedTypes": [] }
+```
+
+### Preference fields
+
+| Field          | Type               | Default | Description                                    |
+|----------------|--------------------|---------|------------------------------------------------|
+| `globalOptOut` | `boolean`          | `false` | Suppress all notifications for this user       |
+| `mutedTypes`   | `NotificationType[]` | `[]`  | Suppress only these notification types        |
 
 ## API routes
 
 All routes require `admin::isAuthenticatedAdmin`. The plugin mounts under `/notifier/`.
 
-| Method | Path                            | Description                          |
-|--------|---------------------------------|--------------------------------------|
-| GET    | `/notifier/notifications`       | List notifications (paginated)       |
-| PUT    | `/notifier/notifications/read-all` | Mark all as read                  |
-| DELETE | `/notifier/notifications`       | Clear all notifications              |
-| PUT    | `/notifier/notifications/:id/read` | Mark one as read                 |
-| DELETE | `/notifier/notifications/:id`   | Clear one notification               |
-| GET    | `/notifier/config`              | Fetch UI config (safe for frontend)  |
-| GET    | `/notifier/settings`            | Get full settings (requires permission) |
-| PUT    | `/notifier/settings`            | Update settings (requires permission) |
-| DELETE | `/notifier/settings`            | Reset settings to defaults           |
+| Method | Path                               | Description                            |
+|--------|------------------------------------|----------------------------------------|
+| GET    | `/notifier/notifications`          | List notifications (paginated)         |
+| PUT    | `/notifier/notifications/read-all` | Mark all as read                       |
+| DELETE | `/notifier/notifications`          | Clear all notifications                |
+| PUT    | `/notifier/notifications/:id/read` | Mark one as read                       |
+| DELETE | `/notifier/notifications/:id`      | Clear one notification                 |
+| GET    | `/notifier/config`                 | Fetch UI config (safe for frontend)    |
+| GET    | `/notifier/settings`               | Get full settings                      |
+| PUT    | `/notifier/settings`               | Update settings                        |
+| DELETE | `/notifier/settings`               | Reset settings to defaults             |
+| GET    | `/notifier/preferences/me`         | Get current user's notification prefs  |
+| PUT    | `/notifier/preferences/me`         | Update current user's notification prefs |
 
 Query parameters for `GET /notifier/notifications`:
 
@@ -141,9 +246,14 @@ Two permissions are registered under the **Notifier** plugin section in **Settin
 - `plugin::notifier.settings.read` — view the settings panel
 - `plugin::notifier.settings.update` — save or reset settings
 
-## Content type
+## Content types
+
+| UID                                      | Collection                  | Description                          |
+|------------------------------------------|-----------------------------|--------------------------------------|
+| `plugin::notifier.notification`          | `notifier_notifications`    | Notification records                 |
+| `plugin::notifier.notification-preference` | `notifier_preferences`    | Per-user opt-out preferences         |
 
-Notifications are stored in `plugin::notifier.notification` (collection: `notifier_notifications`). The content type is hidden from Content Manager and Content-Type Builder by default.
+Both are hidden from Content Manager and Content-Type Builder by default.
 
 ## License
 

package/dist/_chunks/{Index-CiDBgkGf.js → Index-DVk2enQ2.js}

@@ -1,12 +1,11 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const jsxRuntime = require("react/jsx-runtime");
-const React = require("react");
+const react = require("react");
 const designSystem = require("@strapi/design-system");
-require("react-dom/client");
+const strapiAdmin = require("@strapi/admin/strapi-admin");
+const index = require("./index-CKh_iBP2.js");
 const icons = require("@strapi/icons");
-const index = require("./index-7WJGsVEY.js");
-require("@strapi/icons/symbols");
 const toStoreItem = (n) => ({
   id: String(n.id),
   title: n.title,
@@ -17,11 +16,11 @@ const toStoreItem = (n) => ({
   url: n.url
 });
 const useNotificationActions = () => {
-  const { get, put, del } = index.useFetchClient();
-  const [isLoading, setIsLoading] = React.useState(false);
-  const [pagination, setPagination] = React.useState(null);
-  const currentPage = React.useRef(1);
-  const fetchPage = React.useCallback(
+  const { get, put, del } = strapiAdmin.useFetchClient();
+  const [isLoading, setIsLoading] = react.useState(false);
+  const [pagination, setPagination] = react.useState(null);
+  const currentPage = react.useRef(1);
+  const fetchPage = react.useCallback(
     async (page, append = false) => {
       const { pageSize } = index.getConfig();
       setIsLoading(true);
@@ -45,12 +44,12 @@ const useNotificationActions = () => {
     },
     [get]
   );
-  const fetchAll = React.useCallback(() => fetchPage(1, false), [fetchPage]);
-  const loadMore = React.useCallback(() => {
+  const fetchAll = react.useCallback(() => fetchPage(1, false), [fetchPage]);
+  const loadMore = react.useCallback(() => {
     if (!pagination || currentPage.current >= pagination.pageCount) return;
     fetchPage(currentPage.current + 1, true);
   }, [fetchPage, pagination]);
-  const handleMarkAsRead = React.useCallback(
+  const handleMarkAsRead = react.useCallback(
     async (id) => {
       index.markAsRead(id);
       try {
@@ -60,14 +59,14 @@ const useNotificationActions = () => {
     },
     [put]
   );
-  const handleMarkAllAsRead = React.useCallback(async () => {
+  const handleMarkAllAsRead = react.useCallback(async () => {
     index.markAllAsRead();
     try {
       await put("/notifier/notifications/read-all");
     } catch {
     }
   }, [put]);
-  const handleClear = React.useCallback(
+  const handleClear = react.useCallback(
     async (id) => {
       index.clearNotification(id);
       try {
@@ -77,7 +76,7 @@ const useNotificationActions = () => {
     },
     [del]
   );
-  const handleClearAll = React.useCallback(async () => {
+  const handleClearAll = react.useCallback(async () => {
     index.clearAll();
     try {
       await del("/notifier/notifications");
@@ -150,8 +149,8 @@ function InboxHeader({
   ] });
 }
 const useNotifications = () => {
-  const [notifications, setNotifications] = React.useState(index.getNotifications);
-  React.useEffect(() => index.subscribeToNotifications(setNotifications), []);
+  const [notifications, setNotifications] = react.useState(index.getNotifications);
+  react.useEffect(() => index.subscribeToNotifications(setNotifications), []);
   return notifications;
 };
 const UNREAD_BG = {
@@ -205,6 +204,24 @@ function NotificationItem({
                 children: notification.title
               }
             ),
+            notification.mergeCount != null && notification.mergeCount > 1 && /* @__PURE__ */ jsxRuntime.jsxs(
+              designSystem.Typography,
+              {
+                variant: "pi",
+                style: {
+                  background: accent,
+                  color: "#fff",
+                  borderRadius: "10px",
+                  padding: "0 6px",
+                  flexShrink: 0,
+                  fontWeight: 600
+                },
+                children: [
+                  "×",
+                  notification.mergeCount
+                ]
+              }
+            ),
             notification.url && /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral500", children: "↗" })
           ] }),
           notification.message && /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral600", style: { marginTop: 2 }, children: notification.message }),
@@ -270,7 +287,7 @@ function NotificationList({
   ] });
 }
 function Index() {
-  const [filter, setFilter] = React.useState("all");
+  const [filter, setFilter] = react.useState("all");
   const {
     fetchAll,
     loadMore,
@@ -281,7 +298,7 @@ function Index() {
     isLoading,
     hasMore
   } = useNotificationActions();
-  React.useEffect(() => {
+  react.useEffect(() => {
     fetchAll();
   }, []);
   return /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Box, { padding: 8, style: { height: "100%" }, children: [

package/dist/_chunks/{Index-DI2t9tlH.mjs → Index-_PTtaZsz.mjs}

@@ -1,10 +1,9 @@
 import { jsxs, jsx } from "react/jsx-runtime";
 import { useState, useRef, useCallback, useEffect } from "react";
 import { Box, Flex, Typography, Button, IconButton, Loader } from "@strapi/design-system";
-import "react-dom/client";
+import { useFetchClient } from "@strapi/admin/strapi-admin";
+import { g as getConfig, s as setNotifications, a as getNotifications, m as markAsRead, b as markAllAsRead, c as clearNotification, d as clearAll, e as subscribeToNotifications, u as usePluginConfig } from "./index-BgPnE501.mjs";
 import { Cross } from "@strapi/icons";
-import { u as useFetchClient, g as getConfig, s as setNotifications, a as getNotifications, m as markAsRead, b as markAllAsRead, c as clearNotification, d as clearAll, e as subscribeToNotifications, f as usePluginConfig } from "./index-CNYabBMJ.mjs";
-import "@strapi/icons/symbols";
 const toStoreItem = (n) => ({
   id: String(n.id),
   title: n.title,
@@ -203,6 +202,24 @@ function NotificationItem({
                 children: notification.title
               }
             ),
+            notification.mergeCount != null && notification.mergeCount > 1 && /* @__PURE__ */ jsxs(
+              Typography,
+              {
+                variant: "pi",
+                style: {
+                  background: accent,
+                  color: "#fff",
+                  borderRadius: "10px",
+                  padding: "0 6px",
+                  flexShrink: 0,
+                  fontWeight: 600
+                },
+                children: [
+                  "×",
+                  notification.mergeCount
+                ]
+              }
+            ),
             notification.url && /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral500", children: "↗" })
           ] }),
           notification.message && /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral600", style: { marginTop: 2 }, children: notification.message }),

package/dist/_chunks/{SettingsPage-DIKfBfvo.mjs → SettingsPage-CuTIslG0.mjs}

@@ -1,15 +1,24 @@
-import { jsxs, jsx } from "react/jsx-runtime";
+import { jsxs, jsx, Fragment } from "react/jsx-runtime";
 import { useState, useEffect } from "react";
-import { Box, Flex, Typography, Button, NumberInput, Divider, TextInput } from "@strapi/design-system";
-import "react-dom/client";
-import "@strapi/icons";
-import { u as useFetchClient } from "./index-CNYabBMJ.mjs";
-import "@strapi/icons/symbols";
+import { Box, Flex, Typography, Button, NumberInput, Toggle, Divider, Checkbox, TextInput } from "@strapi/design-system";
+import { useFetchClient } from "@strapi/admin/strapi-admin";
 const DEFAULT = {
   retention: { maxDays: 90, maxPerUser: 500 },
   delivery: { pollIntervalMs: 3e4, pageSize: 20 },
+  merge: {
+    enabled: false,
+    windowMinutes: 60,
+    keyFields: ["title", "type"],
+    countBadge: true,
+    rewriteMessage: false
+  },
   ui: { theme: { accent: { info: "#4945ff", success: "#5cb85c", warning: "#f0ad4e", error: "#ee5e52" } } }
 };
+const MERGE_KEY_OPTIONS = [
+  { value: "title", label: "Title" },
+  { value: "type", label: "Type" },
+  { value: "url", label: "URL" }
+];
 function SettingsPage() {
   const { get, put, del } = useFetchClient();
   const [settings, setSettings] = useState(DEFAULT);
@@ -54,6 +63,13 @@ function SettingsPage() {
       return next;
     });
   };
+  const toggleMergeKeyField = (field) => {
+    setSettings((prev) => {
+      const current = prev.merge.keyFields;
+      const next = current.includes(field) ? current.filter((f) => f !== field) : [...current, field];
+      return { ...prev, merge: { ...prev.merge, keyFields: next } };
+    });
+  };
   return /* @__PURE__ */ jsxs(Box, { padding: 8, children: [
     /* @__PURE__ */ jsxs(Flex, { justifyContent: "space-between", alignItems: "center", paddingBottom: 6, children: [
       /* @__PURE__ */ jsx(Typography, { variant: "alpha", children: "Notifier Settings" }),
@@ -113,6 +129,79 @@ function SettingsPage() {
         )
       ] })
     ] }),
+    /* @__PURE__ */ jsxs(Box, { background: "neutral0", padding: 6, hasRadius: true, marginTop: 4, children: [
+      /* @__PURE__ */ jsxs(Flex, { justifyContent: "space-between", alignItems: "center", paddingBottom: 4, children: [
+        /* @__PURE__ */ jsxs(Box, { children: [
+          /* @__PURE__ */ jsx(Typography, { variant: "delta", as: "h2", children: "Merge" }),
+          /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral600", children: "Collapse repeated notifications into one, with a count badge." })
+        ] }),
+        /* @__PURE__ */ jsx(
+          Toggle,
+          {
+            label: "Enable merging",
+            offLabel: "Off",
+            onLabel: "On",
+            checked: settings.merge.enabled,
+            onChange: (e) => set("merge.enabled", e.target.checked)
+          }
+        )
+      ] }),
+      settings.merge.enabled && /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx(Divider, {}),
+        /* @__PURE__ */ jsxs(Box, { paddingTop: 4, children: [
+          /* @__PURE__ */ jsx(Flex, { gap: 4, wrap: "wrap", paddingBottom: 4, children: /* @__PURE__ */ jsx(
+            NumberInput,
+            {
+              label: "Window (minutes)",
+              hint: "How far back to look for a notification to merge into.",
+              value: settings.merge.windowMinutes,
+              onValueChange: (v) => set("merge.windowMinutes", v),
+              style: { flex: 1 }
+            }
+          ) }),
+          /* @__PURE__ */ jsx(Typography, { variant: "sigma", paddingBottom: 2, children: "Merge key fields" }),
+          /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral600", paddingBottom: 3, children: "Two notifications are considered the same if all selected fields match." }),
+          /* @__PURE__ */ jsx(Flex, { gap: 4, wrap: "wrap", paddingBottom: 4, children: MERGE_KEY_OPTIONS.map(({ value, label }) => /* @__PURE__ */ jsx(
+            Checkbox,
+            {
+              checked: settings.merge.keyFields.includes(value),
+              onCheckedChange: () => toggleMergeKeyField(value),
+              children: label
+            },
+            value
+          )) }),
+          /* @__PURE__ */ jsx(Typography, { variant: "sigma", paddingBottom: 2, children: "Display" }),
+          /* @__PURE__ */ jsxs(Flex, { gap: 6, wrap: "wrap", children: [
+            /* @__PURE__ */ jsxs(Flex, { gap: 2, alignItems: "center", children: [
+              /* @__PURE__ */ jsx(
+                Toggle,
+                {
+                  label: "Count badge",
+                  offLabel: "Off",
+                  onLabel: "On",
+                  checked: settings.merge.countBadge,
+                  onChange: (e) => set("merge.countBadge", e.target.checked)
+                }
+              ),
+              /* @__PURE__ */ jsx(Box, { paddingLeft: 2, children: /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral600", children: "Show ×N badge on merged items" }) })
+            ] }),
+            /* @__PURE__ */ jsxs(Flex, { gap: 2, alignItems: "center", children: [
+              /* @__PURE__ */ jsx(
+                Toggle,
+                {
+                  label: "Rewrite message",
+                  offLabel: "Off",
+                  onLabel: "On",
+                  checked: settings.merge.rewriteMessage,
+                  onChange: (e) => set("merge.rewriteMessage", e.target.checked)
+                }
+              ),
+              /* @__PURE__ */ jsx(Box, { paddingLeft: 2, children: /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral600", children: 'Replace message with "N× title"' }) })
+            ] })
+          ] })
+        ] })
+      ] })
+    ] }),
     /* @__PURE__ */ jsxs(Box, { background: "neutral0", padding: 6, hasRadius: true, marginTop: 4, children: [
       /* @__PURE__ */ jsx(Typography, { variant: "delta", paddingBottom: 4, as: "h2", children: "Theme" }),
       /* @__PURE__ */ jsx(Divider, {}),

package/dist/_chunks/{SettingsPage-BdBxZMqP.js → SettingsPage-DYxNBA3h.js}

@@ -1,24 +1,33 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const jsxRuntime = require("react/jsx-runtime");
-const React = require("react");
+const react = require("react");
 const designSystem = require("@strapi/design-system");
-require("react-dom/client");
-require("@strapi/icons");
-const index = require("./index-7WJGsVEY.js");
-require("@strapi/icons/symbols");
+const strapiAdmin = require("@strapi/admin/strapi-admin");
 const DEFAULT = {
   retention: { maxDays: 90, maxPerUser: 500 },
   delivery: { pollIntervalMs: 3e4, pageSize: 20 },
+  merge: {
+    enabled: false,
+    windowMinutes: 60,
+    keyFields: ["title", "type"],
+    countBadge: true,
+    rewriteMessage: false
+  },
   ui: { theme: { accent: { info: "#4945ff", success: "#5cb85c", warning: "#f0ad4e", error: "#ee5e52" } } }
 };
+const MERGE_KEY_OPTIONS = [
+  { value: "title", label: "Title" },
+  { value: "type", label: "Type" },
+  { value: "url", label: "URL" }
+];
 function SettingsPage() {
-  const { get, put, del } = index.useFetchClient();
-  const [settings, setSettings] = React.useState(DEFAULT);
-  const [isSaving, setIsSaving] = React.useState(false);
-  const [isResetting, setIsResetting] = React.useState(false);
-  const [saveError, setSaveError] = React.useState(null);
-  React.useEffect(() => {
+  const { get, put, del } = strapiAdmin.useFetchClient();
+  const [settings, setSettings] = react.useState(DEFAULT);
+  const [isSaving, setIsSaving] = react.useState(false);
+  const [isResetting, setIsResetting] = react.useState(false);
+  const [saveError, setSaveError] = react.useState(null);
+  react.useEffect(() => {
     get("/notifier/settings").then(({ data }) => {
       if (data) setSettings(data);
     }).catch(() => {
@@ -56,6 +65,13 @@ function SettingsPage() {
       return next;
     });
   };
+  const toggleMergeKeyField = (field) => {
+    setSettings((prev) => {
+      const current = prev.merge.keyFields;
+      const next = current.includes(field) ? current.filter((f) => f !== field) : [...current, field];
+      return { ...prev, merge: { ...prev.merge, keyFields: next } };
+    });
+  };
   return /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Box, { padding: 8, children: [
     /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { justifyContent: "space-between", alignItems: "center", paddingBottom: 6, children: [
       /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "alpha", children: "Notifier Settings" }),
@@ -115,6 +131,79 @@ function SettingsPage() {
         )
       ] })
     ] }),
+    /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Box, { background: "neutral0", padding: 6, hasRadius: true, marginTop: 4, children: [
+      /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { justifyContent: "space-between", alignItems: "center", paddingBottom: 4, children: [
+        /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Box, { children: [
+          /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "delta", as: "h2", children: "Merge" }),
+          /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral600", children: "Collapse repeated notifications into one, with a count badge." })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx(
+          designSystem.Toggle,
+          {
+            label: "Enable merging",
+            offLabel: "Off",
+            onLabel: "On",
+            checked: settings.merge.enabled,
+            onChange: (e) => set("merge.enabled", e.target.checked)
+          }
+        )
+      ] }),
+      settings.merge.enabled && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+        /* @__PURE__ */ jsxRuntime.jsx(designSystem.Divider, {}),
+        /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Box, { paddingTop: 4, children: [
+          /* @__PURE__ */ jsxRuntime.jsx(designSystem.Flex, { gap: 4, wrap: "wrap", paddingBottom: 4, children: /* @__PURE__ */ jsxRuntime.jsx(
+            designSystem.NumberInput,
+            {
+              label: "Window (minutes)",
+              hint: "How far back to look for a notification to merge into.",
+              value: settings.merge.windowMinutes,
+              onValueChange: (v) => set("merge.windowMinutes", v),
+              style: { flex: 1 }
+            }
+          ) }),
+          /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "sigma", paddingBottom: 2, children: "Merge key fields" }),
+          /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral600", paddingBottom: 3, children: "Two notifications are considered the same if all selected fields match." }),
+          /* @__PURE__ */ jsxRuntime.jsx(designSystem.Flex, { gap: 4, wrap: "wrap", paddingBottom: 4, children: MERGE_KEY_OPTIONS.map(({ value, label }) => /* @__PURE__ */ jsxRuntime.jsx(
+            designSystem.Checkbox,
+            {
+              checked: settings.merge.keyFields.includes(value),
+              onCheckedChange: () => toggleMergeKeyField(value),
+              children: label
+            },
+            value
+          )) }),
+          /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "sigma", paddingBottom: 2, children: "Display" }),
+          /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { gap: 6, wrap: "wrap", children: [
+            /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { gap: 2, alignItems: "center", children: [
+              /* @__PURE__ */ jsxRuntime.jsx(
+                designSystem.Toggle,
+                {
+                  label: "Count badge",
+                  offLabel: "Off",
+                  onLabel: "On",
+                  checked: settings.merge.countBadge,
+                  onChange: (e) => set("merge.countBadge", e.target.checked)
+                }
+              ),
+              /* @__PURE__ */ jsxRuntime.jsx(designSystem.Box, { paddingLeft: 2, children: /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral600", children: "Show ×N badge on merged items" }) })
+            ] }),
+            /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { gap: 2, alignItems: "center", children: [
+              /* @__PURE__ */ jsxRuntime.jsx(
+                designSystem.Toggle,
+                {
+                  label: "Rewrite message",
+                  offLabel: "Off",
+                  onLabel: "On",
+                  checked: settings.merge.rewriteMessage,
+                  onChange: (e) => set("merge.rewriteMessage", e.target.checked)
+                }
+              ),
+              /* @__PURE__ */ jsxRuntime.jsx(designSystem.Box, { paddingLeft: 2, children: /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral600", children: 'Replace message with "N× title"' }) })
+            ] })
+          ] })
+        ] })
+      ] })
+    ] }),
     /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Box, { background: "neutral0", padding: 6, hasRadius: true, marginTop: 4, children: [
       /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "delta", paddingBottom: 4, as: "h2", children: "Theme" }),
       /* @__PURE__ */ jsxRuntime.jsx(designSystem.Divider, {}),