@ttt-productions/notification-core 0.4.2 → 0.4.4

package/README.md

@@ -13,10 +13,27 @@ Backend/Functions code should avoid the `/react` subpath.
 
 ## Model
 
-There is **no `isRead` flag** — existence in the active collection means unread.
-Archiving moves a notification from the active collection to history (carrying an
-`ArchivalInfo` audit trail). Duplicate triggers for the same `dedupKey`
-increment a single active doc's `count` and append the actor.
+A two-tier **active → history** model. There is **no `isRead` flag**; instead,
+active docs carry a `seenAt` field (`0` = unseen). Opening the tray marks items
+seen (the consuming app stamps `seenAt` via the `markSeenHelper`), which clears
+the unread badge **without** archiving — so "seen" and "dismissed" are distinct
+states. Archiving is the explicit dismiss: it moves a notification from the
+active collection to history (carrying an `ArchivalInfo` audit trail, and an
+app-supplied `expireAt` on the history doc to back native TTL). History docs
+extend the active shape with `expireAt`.
+
+Duplicate triggers for the same `dedupKey` increment a single active doc's
+`count`, append the actor, and reset `seenAt` to `0` so new activity re-lights
+the badge.
+
+**Notifications are Cloud-Functions-only — clients never write notification
+docs.** The archive React hooks (`useArchiveNotification` /
+`useArchiveAllNotifications`) perform **no Firestore writes**; they take an
+app-supplied `archiveFn` / `archiveAllFn` adapter wired to the app's callable
+(e.g. `httpsCallable(functions, 'archiveNotification')`) and invalidate the
+read keys on success. Server helpers (`archiveNotificationHelper` /
+`archiveAllNotificationsHelper`) verify ownership before the move (personal:
+`targetUserId === callerUid`; shared: caller must be admin).
 
 ### Identity is id-only
 

package/dist/react/components/NotificationList.d.ts

@@ -2,5 +2,5 @@ import type { NotificationListProps } from '../../types.js';
 /**
  * Scrollable list of active notifications with click-to-archive and clear-all.
  */
-export declare function NotificationList({ config, userId, category, onNotificationClick, onClearAll, refetchInterval, device, emptyText, }: NotificationListProps): import("react/jsx-runtime").JSX.Element;
+export declare function NotificationList({ config, userId, category, onNotificationClick, archiveFn, archiveAllFn, onClearAll, refetchInterval, emptyText, }: NotificationListProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=NotificationList.d.ts.map

package/dist/react/components/NotificationList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NotificationList.d.ts","sourceRoot":"","sources":["../../../src/react/components/NotificationList.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAmB,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE7E;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,MAAM,EACN,QAAQ,EACR,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,MAAc,EACd,SAAS,GACV,EAAE,qBAAqB,2CA2IvB"}
+{"version":3,"file":"NotificationList.d.ts","sourceRoot":"","sources":["../../../src/react/components/NotificationList.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAmB,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE7E;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,MAAM,EACN,QAAQ,EACR,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,UAAU,EACV,eAAe,EACf,SAAS,GACV,EAAE,qBAAqB,2CA8HvB"}

package/dist/react/components/NotificationList.js

@@ -11,7 +11,7 @@ import { formatRelativeTime } from './relative-time.js';
 /**
  * Scrollable list of active notifications with click-to-archive and clear-all.
  */
-export function NotificationList({ config, userId, category, onNotificationClick, onClearAll, refetchInterval, device = 'web', emptyText, }) {
+export function NotificationList({ config, userId, category, onNotificationClick, archiveFn, archiveAllFn, onClearAll, refetchInterval, emptyText, }) {
     const { data: notifications, isLoading, hasNextPage, nextPage, } = useActiveNotifications({
         config,
         userId,
@@ -25,46 +25,33 @@ export function NotificationList({ config, userId, category, onNotificationClick
         refetchInterval,
     });
     const archiveMutation = useArchiveNotification({
-        config,
         userId,
         category,
+        archiveFn,
     });
     const archiveAllMutation = useArchiveAllNotifications({
-        config,
         userId,
         category,
+        archiveAllFn,
     });
     const handleNotificationClick = useCallback(async (notification) => {
         try {
-            await archiveMutation.mutateAsync({
-                notificationId: notification.id,
-                archivalInfo: {
-                    archivedBy: userId,
-                    archivedAt: Date.now(),
-                    device,
-                },
-            });
+            await archiveMutation.mutateAsync(notification.id);
         }
         catch {
             // Still navigate even if archive fails
         }
         onNotificationClick(notification);
-    }, [archiveMutation, userId, device, onNotificationClick]);
+    }, [archiveMutation, onNotificationClick]);
     const handleClearAll = useCallback(async () => {
         try {
-            await archiveAllMutation.mutateAsync({
-                archivalInfo: {
-                    archivedBy: userId,
-                    archivedAt: Date.now(),
-                    device,
-                },
-            });
+            await archiveAllMutation.mutateAsync();
         }
         catch {
             // Silently fail
         }
         onClearAll?.();
-    }, [archiveAllMutation, userId, device, onClearAll]);
+    }, [archiveAllMutation, onClearAll]);
     const getTypeIcon = useCallback((type) => {
         const typeConfig = config.types[type];
         return typeConfig?.icon ?? '🔔';

package/dist/react/components/NotificationList.js.map

@@ -1 +1 @@
-{"version":3,"file":"NotificationList.js","sourceRoot":"","sources":["../../../src/react/components/NotificationList.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"NotificationList.js","sourceRoot":"","sources":["../../../src/react/components/NotificationList.tsx"],"names":[],"mappings":"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"}

package/dist/react/hooks/useArchiveAllNotifications.d.ts

@@ -1,24 +1,22 @@
-import type { ArchivalInfo, UseArchiveAllNotificationsOptions } from '../../types.js';
+import type { UseArchiveAllNotificationsOptions } from '../../types.js';
 /**
- * Archive all active notifications in batches.
- * Reads active docs in batches of 50, archives each batch, repeats until empty.
+ * Archive the caller's whole category through an app-supplied callable adapter.
+ *
+ * Like {@link useArchiveNotification}, this performs no client Firestore writes
+ * — paging + ownership-checked deletion happen server-side via the callable the
+ * app wires into `archiveAllFn`. On success it invalidates the read keys.
  *
  * @example
  * ```tsx
+ * const archiveNotification = httpsCallable(functions, 'archiveNotification');
  * const archiveAll = useArchiveAllNotifications({
- *   config: TTT_NOTIFICATION_CONFIG,
  *   userId: user.uid,
  *   category: 'user',
+ *   archiveAllFn: () => archiveNotification({ category: 'user', scope: { kind: 'all' } }),
  * });
  *
- * archiveAll.mutate({
- *   archivalInfo: { archivedBy: user.uid, archivedAt: Date.now(), device: 'web' },
- * });
+ * archiveAll.mutate();
  * ```
  */
-export declare function useArchiveAllNotifications({ config, userId, category, invalidateKeys, }: UseArchiveAllNotificationsOptions): import("@tanstack/react-query").UseMutationResult<{
-    totalArchived: number;
-}, Error, {
-    archivalInfo: ArchivalInfo;
-}, unknown>;
+export declare function useArchiveAllNotifications({ userId, category, archiveAllFn, invalidateKeys, }: UseArchiveAllNotificationsOptions): import("@tanstack/react-query").UseMutationResult<unknown, Error, void, unknown>;
 //# sourceMappingURL=useArchiveAllNotifications.d.ts.map

package/dist/react/hooks/useArchiveAllNotifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useArchiveAllNotifications.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useArchiveAllNotifications.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAEV,YAAY,EACZ,iCAAiC,EAClC,MAAM,gBAAgB,CAAC;AAIxB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,MAAM,EACN,MAAM,EACN,QAAQ,EACR,cAAc,GACf,EAAE,iCAAiC;;;kBAehB,YAAY;YAkE/B"}
+{"version":3,"file":"useArchiveAllNotifications.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useArchiveAllNotifications.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,gBAAgB,CAAC;AAExE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,cAAc,GACf,EAAE,iCAAiC,oFAkBnC"}

package/dist/react/hooks/useArchiveAllNotifications.js

@@ -1,81 +1,33 @@
 'use client';
 import { useMutation, useQueryClient } from '@tanstack/react-query';
-import { collection, query, where, orderBy, limit, getDocs, doc, writeBatch, } from 'firebase/firestore';
-import { useFirestoreDb } from '@ttt-productions/query-core/react';
-const BATCH_SIZE = 50;
 /**
- * Archive all active notifications in batches.
- * Reads active docs in batches of 50, archives each batch, repeats until empty.
+ * Archive the caller's whole category through an app-supplied callable adapter.
+ *
+ * Like {@link useArchiveNotification}, this performs no client Firestore writes
+ * — paging + ownership-checked deletion happen server-side via the callable the
+ * app wires into `archiveAllFn`. On success it invalidates the read keys.
  *
  * @example
  * ```tsx
+ * const archiveNotification = httpsCallable(functions, 'archiveNotification');
  * const archiveAll = useArchiveAllNotifications({
- *   config: TTT_NOTIFICATION_CONFIG,
  *   userId: user.uid,
  *   category: 'user',
+ *   archiveAllFn: () => archiveNotification({ category: 'user', scope: { kind: 'all' } }),
  * });
  *
- * archiveAll.mutate({
- *   archivalInfo: { archivedBy: user.uid, archivedAt: Date.now(), device: 'web' },
- * });
+ * archiveAll.mutate();
  * ```
  */
-export function useArchiveAllNotifications({ config, userId, category, invalidateKeys, }) {
-    const db = useFirestoreDb();
+export function useArchiveAllNotifications({ userId, category, archiveAllFn, invalidateKeys, }) {
     const queryClient = useQueryClient();
-    const categoryConfig = config.categories[category];
     const defaultInvalidateKeys = [
         ['notifications', 'active', category, userId],
         ['notifications', 'unread-count', category, userId],
         ['notifications', 'history', category, userId],
     ];
     return useMutation({
-        mutationFn: async ({ archivalInfo, }) => {
-            if (!categoryConfig) {
-                throw new Error(`[notification-core] Unknown category: ${category}`);
-            }
-            const activePath = categoryConfig.activePath;
-            const historyPath = categoryConfig.historyPath(userId);
-            const isPersonal = categoryConfig.audienceType === 'personal';
-            let totalArchived = 0;
-            let hasMore = true;
-            while (hasMore) {
-                const constraints = [
-                    ...(isPersonal ? [where('targetUserId', '==', userId)] : []),
-                    orderBy('updatedAt', 'desc'),
-                    limit(BATCH_SIZE),
-                ];
-                const q = query(collection(db, activePath), ...constraints);
-                const snapshot = await getDocs(q);
-                if (snapshot.empty) {
-                    hasMore = false;
-                    break;
-                }
-                const batch = writeBatch(db);
-                snapshot.docs.forEach((docSnap) => {
-                    const data = docSnap.data();
-                    // Write to history
-                    const historyRef = doc(db, historyPath, docSnap.id);
-                    batch.set(historyRef, {
-                        ...data,
-                        id: docSnap.id,
-                        archival: archivalInfo,
-                        ...(categoryConfig.audienceType === 'shared'
-                            ? { handledBy: archivalInfo.archivedBy }
-                            : {}),
-                    });
-                    // Delete from active
-                    const activeRef = doc(db, activePath, docSnap.id);
-                    batch.delete(activeRef);
-                });
-                await batch.commit();
-                totalArchived += snapshot.docs.length;
-                if (snapshot.docs.length < BATCH_SIZE) {
-                    hasMore = false;
-                }
-            }
-            return { totalArchived };
-        },
+        mutationFn: async () => archiveAllFn(),
         onSuccess: () => {
             const keysToInvalidate = invalidateKeys ?? defaultInvalidateKeys;
             keysToInvalidate.forEach((key) => {

package/dist/react/hooks/useArchiveAllNotifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"useArchiveAllNotifications.js","sourceRoot":"","sources":["../../../src/react/hooks/useArchiveAllNotifications.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useArchiveAllNotifications.js","sourceRoot":"","sources":["../../../src/react/hooks/useArchiveAllNotifications.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,0BAA0B,CAAC,EACzC,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,cAAc,GACoB;IAClC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,qBAAqB,GAAG;QAC5B,CAAC,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC;QAC7C,CAAC,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC;QACnD,CAAC,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC;KAC/C,CAAC;IAEF,OAAO,WAAW,CAAC;QACjB,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,YAAY,EAAE;QACtC,SAAS,EAAE,GAAG,EAAE;YACd,MAAM,gBAAgB,GAAG,cAAc,IAAI,qBAAqB,CAAC;YACjE,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC/B,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/react/hooks/useArchiveNotification.d.ts

@@ -1,23 +1,24 @@
-import type { ArchivalInfo, UseArchiveNotificationOptions } from '../../types.js';
+import type { UseArchiveNotificationOptions } from '../../types.js';
 /**
- * Archive a single notification: read from active → write to history → delete from active.
+ * Archive a single notification through an app-supplied callable adapter.
+ *
+ * The notification system is Cloud-Functions-only: clients never write
+ * notification docs. This hook performs no Firestore writes — it delegates to
+ * `archiveFn` (wired by the app to `httpsCallable(functions, 'archiveNotification')`)
+ * and invalidates the read keys on success.
  *
  * @example
  * ```tsx
+ * const archiveNotification = httpsCallable(functions, 'archiveNotification');
  * const archive = useArchiveNotification({
- *   config: TTT_NOTIFICATION_CONFIG,
  *   userId: user.uid,
  *   category: 'user',
+ *   archiveFn: (notificationId) =>
+ *     archiveNotification({ category: 'user', scope: { kind: 'single', notificationId } }),
  * });
  *
- * archive.mutate({
- *   notificationId: 'abc123',
- *   archivalInfo: { archivedBy: user.uid, archivedAt: Date.now(), device: 'web' },
- * });
+ * archive.mutate('abc123');
  * ```
  */
-export declare function useArchiveNotification({ config, userId, category, invalidateKeys, }: UseArchiveNotificationOptions): import("@tanstack/react-query").UseMutationResult<void, Error, {
-    notificationId: string;
-    archivalInfo: ArchivalInfo;
-}, unknown>;
+export declare function useArchiveNotification({ userId, category, archiveFn, invalidateKeys, }: UseArchiveNotificationOptions): import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
 //# sourceMappingURL=useArchiveNotification.d.ts.map

package/dist/react/hooks/useArchiveNotification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useArchiveNotification.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useArchiveNotification.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,YAAY,EACZ,6BAA6B,EAC9B,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,MAAM,EACN,QAAQ,EACR,cAAc,GACf,EAAE,6BAA6B;oBAgBV,MAAM;kBACR,YAAY;YA2C/B"}
+{"version":3,"file":"useArchiveNotification.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useArchiveNotification.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,QAAQ,EACR,SAAS,EACT,cAAc,GACf,EAAE,6BAA6B,sFAkB/B"}

package/dist/react/hooks/useArchiveNotification.js

@@ -1,62 +1,35 @@
 'use client';
 import { useMutation, useQueryClient } from '@tanstack/react-query';
-import { doc, getDoc, setDoc, deleteDoc } from 'firebase/firestore';
-import { useFirestoreDb } from '@ttt-productions/query-core/react';
 /**
- * Archive a single notification: read from active → write to history → delete from active.
+ * Archive a single notification through an app-supplied callable adapter.
+ *
+ * The notification system is Cloud-Functions-only: clients never write
+ * notification docs. This hook performs no Firestore writes — it delegates to
+ * `archiveFn` (wired by the app to `httpsCallable(functions, 'archiveNotification')`)
+ * and invalidates the read keys on success.
  *
  * @example
  * ```tsx
+ * const archiveNotification = httpsCallable(functions, 'archiveNotification');
  * const archive = useArchiveNotification({
- *   config: TTT_NOTIFICATION_CONFIG,
  *   userId: user.uid,
  *   category: 'user',
+ *   archiveFn: (notificationId) =>
+ *     archiveNotification({ category: 'user', scope: { kind: 'single', notificationId } }),
  * });
  *
- * archive.mutate({
- *   notificationId: 'abc123',
- *   archivalInfo: { archivedBy: user.uid, archivedAt: Date.now(), device: 'web' },
- * });
+ * archive.mutate('abc123');
  * ```
  */
-export function useArchiveNotification({ config, userId, category, invalidateKeys, }) {
-    const db = useFirestoreDb();
+export function useArchiveNotification({ userId, category, archiveFn, invalidateKeys, }) {
     const queryClient = useQueryClient();
-    const categoryConfig = config.categories[category];
     const defaultInvalidateKeys = [
         ['notifications', 'active', category, userId],
         ['notifications', 'unread-count', category, userId],
         ['notifications', 'history', category, userId],
     ];
     return useMutation({
-        mutationFn: async ({ notificationId, archivalInfo, }) => {
-            if (!categoryConfig) {
-                throw new Error(`[notification-core] Unknown category: ${category}`);
-            }
-            const activePath = categoryConfig.activePath;
-            const historyPath = categoryConfig.historyPath(userId);
-            // Read active doc
-            const activeRef = doc(db, activePath, notificationId);
-            const activeSnap = await getDoc(activeRef);
-            if (!activeSnap.exists()) {
-                // Already archived or deleted — no-op
-                return;
-            }
-            const activeData = { id: activeSnap.id, ...activeSnap.data() };
-            // Build history doc
-            const historyDoc = {
-                ...activeData,
-                archival: archivalInfo,
-                ...(categoryConfig.audienceType === 'shared'
-                    ? { handledBy: archivalInfo.archivedBy }
-                    : {}),
-            };
-            // Write to history
-            const historyRef = doc(db, historyPath, notificationId);
-            await setDoc(historyRef, historyDoc);
-            // Delete from active
-            await deleteDoc(activeRef);
-        },
+        mutationFn: async (notificationId) => archiveFn(notificationId),
         onSuccess: () => {
             const keysToInvalidate = invalidateKeys ?? defaultInvalidateKeys;
             keysToInvalidate.forEach((key) => {

package/dist/react/hooks/useArchiveNotification.js.map

@@ -1 +1 @@
-{"version":3,"file":"useArchiveNotification.js","sourceRoot":"","sources":["../../../src/react/hooks/useArchiveNotification.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAQnE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,MAAM,EACN,MAAM,EACN,QAAQ,EACR,cAAc,GACgB;IAC9B,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEnD,MAAM,qBAAqB,GAAG;QAC5B,CAAC,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC;QAC7C,CAAC,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC;QACnD,CAAC,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC;KAC/C,CAAC;IAEF,OAAO,WAAW,CAAC;QACjB,UAAU,EAAE,KAAK,EAAE,EACjB,cAAc,EACd,YAAY,GAIb,EAAE,EAAE;YACH,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,yCAAyC,QAAQ,EAAE,CAAC,CAAC;YACvE,CAAC;YAED,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC;YAC7C,MAAM,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAEvD,kBAAkB;YAClB,MAAM,SAAS,GAAG,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;YACtD,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YAE3C,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;gBACzB,sCAAsC;gBACtC,OAAO;YACT,CAAC;YAED,MAAM,UAAU,GAAG,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,EAAqB,CAAC;YAElF,oBAAoB;YACpB,MAAM,UAAU,GAAuC;gBACrD,GAAG,UAAU;gBACb,QAAQ,EAAE,YAAY;gBACtB,GAAG,CAAC,cAAc,CAAC,YAAY,KAAK,QAAQ;oBAC1C,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,CAAC,UAAU,EAAE;oBACxC,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;YAEF,mBAAmB;YACnB,MAAM,UAAU,GAAG,GAAG,CAAC,EAAE,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;YACxD,MAAM,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAErC,qBAAqB;YACrB,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;QACD,SAAS,EAAE,GAAG,EAAE;YACd,MAAM,gBAAgB,GAAG,cAAc,IAAI,qBAAqB,CAAC;YACjE,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC/B,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"useArchiveNotification.js","sourceRoot":"","sources":["../../../src/react/hooks/useArchiveNotification.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGpE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,MAAM,EACN,QAAQ,EACR,SAAS,EACT,cAAc,GACgB;IAC9B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,qBAAqB,GAAG;QAC5B,CAAC,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC;QAC7C,CAAC,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC;QACnD,CAAC,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC;KAC/C,CAAC;IAEF,OAAO,WAAW,CAAC;QACjB,UAAU,EAAE,KAAK,EAAE,cAAsB,EAAE,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC;QACvE,SAAS,EAAE,GAAG,EAAE;YACd,MAAM,gBAAgB,GAAG,cAAc,IAAI,qBAAqB,CAAC;YACjE,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC/B,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/react/hooks/useUnreadCount.d.ts

@@ -1,7 +1,16 @@
-import type { NotificationDoc, UseUnreadCountOptions } from '../../types.js';
+import type { UseUnreadCountOptions } from '../../types.js';
 /**
- * Lightweight unread count query. Fetches up to `countLimit` docs to determine count.
- * Uses polling for cost control.
+ * Unread-count badge backed by a Firestore `count()` aggregation (a server-side
+ * count, not a doc fetch). Polls for cost control; displays capped
+ * (`hasMore` → `99+`).
+ *
+ * - **personal** categories count **unseen** active items (`seenAt == 0`),
+ *   scoped to the caller (`targetUserId == uid`);
+ * - **shared** categories have no per-admin seen state, so the indicator is
+ *   existence-based — a count of all active items, with no `seenAt` predicate.
+ *
+ * The personal `seenAt == 0` predicate needs a composite index, captured as an
+ * app-side index step.
  *
  * @example
  * ```tsx
@@ -35,9 +44,9 @@ export declare function useUnreadCount({ config, userId, category, enabled, refe
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("@ttt-productions/query-core/types").WithId<NotificationDoc>[], Error>>;
-    fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<import("@ttt-productions/query-core/types").WithId<NotificationDoc>[]>;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<number, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<number>;
     count: number;
     hasMore: boolean;
 } | {
@@ -63,9 +72,9 @@ export declare function useUnreadCount({ config, userId, category, enabled, refe
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("@ttt-productions/query-core/types").WithId<NotificationDoc>[], Error>>;
-    fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<import("@ttt-productions/query-core/types").WithId<NotificationDoc>[]>;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<number, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<number>;
     count: number;
     hasMore: boolean;
 } | {
@@ -91,9 +100,9 @@ export declare function useUnreadCount({ config, userId, category, enabled, refe
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("@ttt-productions/query-core/types").WithId<NotificationDoc>[], Error>>;
-    fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<import("@ttt-productions/query-core/types").WithId<NotificationDoc>[]>;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<number, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<number>;
     count: number;
     hasMore: boolean;
 } | {
@@ -119,9 +128,9 @@ export declare function useUnreadCount({ config, userId, category, enabled, refe
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("@ttt-productions/query-core/types").WithId<NotificationDoc>[], Error>>;
-    fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<import("@ttt-productions/query-core/types").WithId<NotificationDoc>[]>;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<number, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<number>;
     count: number;
     hasMore: boolean;
 } | {
@@ -147,9 +156,9 @@ export declare function useUnreadCount({ config, userId, category, enabled, refe
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("@ttt-productions/query-core/types").WithId<NotificationDoc>[], Error>>;
-    fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<import("@ttt-productions/query-core/types").WithId<NotificationDoc>[]>;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<number, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<number>;
     count: number;
     hasMore: boolean;
 } | {
@@ -175,9 +184,9 @@ export declare function useUnreadCount({ config, userId, category, enabled, refe
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("@ttt-productions/query-core/types").WithId<NotificationDoc>[], Error>>;
-    fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<import("@ttt-productions/query-core/types").WithId<NotificationDoc>[]>;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<number, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<number>;
     count: number;
     hasMore: boolean;
 };

package/dist/react/hooks/useUnreadCount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useUnreadCount.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useUnreadCount.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAK7E;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAc,EACd,eAA0C,EAC1C,UAAgC,GACjC,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BvB"}
+{"version":3,"file":"useUnreadCount.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useUnreadCount.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAK5D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAc,EACd,eAA0C,EAC1C,UAAgC,GACjC,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCvB"}

package/dist/react/hooks/useUnreadCount.js

@@ -1,11 +1,21 @@
 'use client';
-import { useFirestoreCollection } from '@ttt-productions/query-core/react';
-import { where, orderBy, limit } from 'firebase/firestore';
+import { useQuery } from '@tanstack/react-query';
+import { collection, query, where, getCountFromServer, } from 'firebase/firestore';
+import { useFirestoreDb } from '@ttt-productions/query-core/react';
 const DEFAULT_REFETCH_INTERVAL = 30_000;
 const DEFAULT_COUNT_LIMIT = 99;
 /**
- * Lightweight unread count query. Fetches up to `countLimit` docs to determine count.
- * Uses polling for cost control.
+ * Unread-count badge backed by a Firestore `count()` aggregation (a server-side
+ * count, not a doc fetch). Polls for cost control; displays capped
+ * (`hasMore` → `99+`).
+ *
+ * - **personal** categories count **unseen** active items (`seenAt == 0`),
+ *   scoped to the caller (`targetUserId == uid`);
+ * - **shared** categories have no per-admin seen state, so the indicator is
+ *   existence-based — a count of all active items, with no `seenAt` predicate.
+ *
+ * The personal `seenAt == 0` predicate needs a composite index, captured as an
+ * app-side index step.
  *
  * @example
  * ```tsx
@@ -17,28 +27,32 @@ const DEFAULT_COUNT_LIMIT = 99;
  * ```
  */
 export function useUnreadCount({ config, userId, category, enabled = true, refetchInterval = DEFAULT_REFETCH_INTERVAL, countLimit = DEFAULT_COUNT_LIMIT, }) {
+    const db = useFirestoreDb();
     const categoryConfig = config.categories[category];
     if (!categoryConfig) {
         throw new Error(`[notification-core] Unknown category: ${category}`);
     }
     const collectionPath = categoryConfig.activePath;
     const isPersonal = categoryConfig.audienceType === 'personal';
-    const constraints = [
-        ...(isPersonal ? [where('targetUserId', '==', userId)] : []),
-        orderBy('updatedAt', 'desc'),
-        limit(countLimit),
-    ];
-    const { data: notifications, ...rest } = useFirestoreCollection({
-        collectionPath,
+    const { data, ...rest } = useQuery({
         queryKey: ['notifications', 'unread-count', category, userId],
-        constraints,
+        queryFn: async () => {
+            const collectionRef = collection(db, collectionPath);
+            const constraints = isPersonal
+                ? [where('targetUserId', '==', userId), where('seenAt', '==', 0)]
+                : [];
+            const q = constraints.length > 0 ? query(collectionRef, ...constraints) : collectionRef;
+            const snapshot = await getCountFromServer(q);
+            return snapshot.data().count;
+        },
         enabled: enabled && !!userId,
-        subscribe: false,
         staleTime: refetchInterval,
+        refetchInterval,
     });
+    const count = data ?? 0;
     return {
-        count: notifications?.length ?? 0,
-        hasMore: (notifications?.length ?? 0) >= countLimit,
+        count,
+        hasMore: count > countLimit,
         ...rest,
     };
 }

package/dist/react/hooks/useUnreadCount.js.map

@@ -1 +1 @@
-{"version":3,"file":"useUnreadCount.js","sourceRoot":"","sources":["../../../src/react/hooks/useUnreadCount.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAwB,MAAM,oBAAoB,CAAC;AAGjF,MAAM,wBAAwB,GAAG,MAAM,CAAC;AACxC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAO,GAAG,IAAI,EACd,eAAe,GAAG,wBAAwB,EAC1C,UAAU,GAAG,mBAAmB,GACV;IACtB,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,yCAAyC,QAAQ,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,cAAc,GAAG,cAAc,CAAC,UAAU,CAAC;IACjD,MAAM,UAAU,GAAG,cAAc,CAAC,YAAY,KAAK,UAAU,CAAC;IAE9D,MAAM,WAAW,GAAsB;QACrC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC;QAC5B,KAAK,CAAC,UAAU,CAAC;KAClB,CAAC;IAEF,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,sBAAsB,CAAkB;QAC/E,cAAc;QACd,QAAQ,EAAE,CAAC,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC;QAC7D,WAAW;QACX,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,MAAM;QAC5B,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,eAAe;KAC3B,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;QACjC,OAAO,EAAE,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC,CAAC,IAAI,UAAU;QACnD,GAAG,IAAI;KACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useUnreadCount.js","sourceRoot":"","sources":["../../../src/react/hooks/useUnreadCount.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EACL,UAAU,EACV,KAAK,EACL,KAAK,EACL,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGnE,MAAM,wBAAwB,GAAG,MAAM,CAAC;AACxC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAO,GAAG,IAAI,EACd,eAAe,GAAG,wBAAwB,EAC1C,UAAU,GAAG,mBAAmB,GACV;IACtB,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IAE5B,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,yCAAyC,QAAQ,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,cAAc,GAAG,cAAc,CAAC,UAAU,CAAC;IACjD,MAAM,UAAU,GAAG,cAAc,CAAC,YAAY,KAAK,UAAU,CAAC;IAE9D,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC;QACjC,QAAQ,EAAE,CAAC,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC;QAC7D,OAAO,EAAE,KAAK,IAAqB,EAAE;YACnC,MAAM,aAAa,GAAG,UAAU,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;YACrD,MAAM,WAAW,GAAsB,UAAU;gBAC/C,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACjE,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YACxF,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,CAAC,CAAC,CAAC;YAC7C,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAC/B,CAAC;QACD,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,MAAM;QAC5B,SAAS,EAAE,eAAe;QAC1B,eAAe;KAChB,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC;IAExB,OAAO;QACL,KAAK;QACL,OAAO,EAAE,KAAK,GAAG,UAAU;QAC3B,GAAG,IAAI;KACR,CAAC;AACJ,CAAC"}

package/dist/server/archiveNotificationHelper.d.ts

@@ -7,20 +7,31 @@ import type { ServerFirestore } from './types.js';
 interface ArchiveInput {
     notificationId: string;
     category: string;
-    userId: string;
+    /** uid of the caller requesting the archive (ownership is verified against it). */
+    callerUid: string;
+    /** Whether the caller holds an admin/jrAdmin claim (required for shared notifications). */
+    callerIsAdmin: boolean;
     archivalInfo: ArchivalInfo;
+    /**
+     * App-supplied epoch ms persisted on the history doc to back native TTL.
+     * The retention window is app policy; the helper just writes the value.
+     */
+    expireAt?: number;
 }
 interface ArchiveAllInput {
     category: string;
-    userId: string;
+    callerUid: string;
+    callerIsAdmin: boolean;
     archivalInfo: ArchivalInfo;
+    expireAt?: number;
 }
 interface ArchiveResult {
     success: boolean;
     archived: number;
 }
 /**
- * Archive a single notification on the server side.
+ * Archive a single notification on the server side. Verifies ownership before
+ * the active → history move and persists the app-supplied `expireAt`.
  */
 export declare function archiveNotificationHelper(db: ServerFirestore, config: NotificationSystemConfig, input: ArchiveInput): Promise<ArchiveResult>;
 /**